Passer au contenu principal

Opera Romana Pellegrinaggi : backend opérateur

Connectez Opera Romana Pellegrinaggi à Ventrata pour revendre les produits des opérateurs Opera Romana Pellegrinaggi avec des disponibilités et des réservations en temps réel.

Opera Romana Pellegrinaggi logo

 

Opera Romana Pellegrinaggi est l'organisation de pèlerinages du Vicariat de Rome, au service des pèlerins depuis 1933 avec des itinéraires à Rome et au Vatican, des voyages en Terre sainte, à Lourdes, Fatima et Saint-Jacques-de-Compostelle, ainsi que la carte OMNIA Vatican and Rome. Elle attire des voyageurs croyants italiens et internationaux, des groupes paroissiaux et des écoles qui réservent des programmes religieux et culturels guidés à Rome et au Vatican, en italien, anglais, espagnol, français et allemand.

 

Connecter Opera Romana Pellegrinaggi à Ventrata vous permet de revendre les produits d'opérateurs qui utilisent Opera Romana Pellegrinaggi comme système de réservation. Ventrata lit leurs disponibilités en temps réel dans Opera Romana Pellegrinaggi, et chaque réservation que vous prenez est créée directement dans le compte Opera Romana Pellegrinaggi de l'opérateur.

 

Pour en savoir plus sur Opera Romana Pellegrinaggi, consultez operaromanapellegrinaggi.org.

 

Site web principal

Tags

Custom / Proprietary Operator System

Fonctionnalités de la connexion

Availability Sync · Bookings Sync

Développé par

Ventrata (via Opera Romana Pellegrinaggi API)

 

Cette connexion opérateur (aussi appelée backend) vous permet de revendre les produits d'opérateurs qui utilisent Opera Romana Pellegrinaggi comme système de réservation principal, chaque réservation étant créée directement dans Opera Romana Pellegrinaggi. Fonctionnalités de cette connexion :

  • Availability Sync – les disponibilités en temps réel proviennent du compte Opera Romana Pellegrinaggi de l'opérateur.

  • Bookings Sync – les réservations sont transmises de Ventrata à Opera Romana Pellegrinaggi, et Opera Romana Pellegrinaggi émet les billets ou les bons.

 

L'API externe d'Opera Romana Pellegrinaggi utilisée pour cette connexion est une API personnalisée qui ne suit pas le standard d'API OCTO, ce qui peut limiter certaines fonctionnalités et capacités.

 

Créer la connexion Opera Romana Pellegrinaggi

🔐 Autorisations de rôle requises : See Operators, Modify Operators, See Products, Modify Products

Avant de commencer :

  • Vous devez disposer d'un accord commercial avec l'opérateur définissant ses tarifs et ses conditions.

  • Vous devez disposer de la clé API pour l'opérateur. Consultez les étapes ci-dessous.

  • Vous devez recréer les produits de l'opérateur dans Ventrata. Découvrez comment créer des produits. La connexion synchronise les disponibilités, les prix et les réservations, mais ne crée pas les produits dans Ventrata.

 

Étape 1 : configurer l'opérateur dans Ventrata

Demandez à l'opérateur la clé API de votre compte.

 

  1. Dans le Ventrata Dashboard, accédez à Produits → Les opérateurs (Products → Operators) et ouvrez l'opérateur. S'il n'existe pas encore, créez-le d'abord en tant qu'opérateur.

  2. Dans la section Partenaire backend (Backend Partner), sélectionnez Opera Romana Pellegrinaggi et saisissez la clé API.

  3. Press Update Operator.

 

 

Étape 2 : connectez chaque produit

  1. Ouvrez le produit de l'opérateur dans Produits → Produits (Products → Products) et modifiez-le. Vérifiez que le champ Opérateur (Operator) est bien défini sur cet opérateur.

  2. Cochez Backend connecté (Backend Connected). Cochez Disponibilité du backend (Backend Availability) pour utiliser les disponibilités d'Opera Romana Pellegrinaggi.

  3. Press Update Product.

 

Mapper les produits vers Opera Romana Pellegrinaggi

‼️ IMPORTANT

Le mappage indique à Ventrata pour quels produit, option et unités Opera Romana Pellegrinaggi il doit vérifier les disponibilités et réserver. Si un produit connecté au backend n'est pas correctement mappé, ses réservations échouent. Une ligne de produit surlignée en rouge signale un produit mal mappé.

 

  1. Dans le Ventrata Dashboard, accédez à Produits → Produits (Products → Products) et ouvrez le produit.

  2. Ouvrez l'onglet Mappages (Mappings). Il apparaît dès que le produit est défini sur Backend connecté (Backend Connected).

  3. Pour chaque option et unité Ventrata, sélectionnez le produit, l'option et les unités Opera Romana Pellegrinaggi correspondants dans les listes déroulantes, que Ventrata charge depuis Opera Romana Pellegrinaggi. Ne laissez aucun champ vide.

  4. Press Save Changes.

 

📗 ASTUCE

Effectuez une réservation test après le mappage, et demandez à l'opérateur de confirmer qu'elle est bien arrivée dans son compte Opera Romana Pellegrinaggi.

 

Gérer la connexion Opera Romana Pellegrinaggi

  • Mettez à jour le mappage lorsque l'opérateur modifie des produits, options ou unités dans Opera Romana Pellegrinaggi.

  • Remplacez la clé sur l'opérateur si Opera Romana Pellegrinaggi ou l'opérateur en émet une nouvelle.

  • Désactivez l'option Disponibilité du backend (Backend Availability) ou Tarification backend (Backend Pricing) sur un produit pour utiliser à la place les disponibilités ou les prix de Ventrata. Les réservations sont toujours transmises à Opera Romana Pellegrinaggi.

 

Fonctionnalités de la connexion en détail

Cette section s'adresse à toute personne qui souhaite savoir précisément comment fonctionne la connexion Opera Romana Pellegrinaggi. Ici, le sens est l'inverse de celui d'une connexion revendeur : Ventrata appelle Opera Romana Pellegrinaggi, via l'API d'Opera Romana Pellegrinaggi. Pour chaque fonctionnalité, cette section explique quels appels Ventrata effectue, à quel moment, et ce que cela signifie pour vous.

 

En bref : Ventrata demande à Opera Romana Pellegrinaggi les disponibilités chaque fois que quelqu'un consulte un produit connecté au backend, et crée chaque réservation dans le compte Opera Romana Pellegrinaggi de l'opérateur. Opera Romana Pellegrinaggi ne renvoie pas les modifications à Ventrata.

 

Les délais indiqués sont ceux généralement observés avec Opera Romana Pellegrinaggi ; ils sont arrondis et peuvent évoluer.

 

Product Mapping

✅

Vous mappez chaque produit, option et unité Ventrata au produit Opera Romana Pellegrinaggi de l'opérateur dans le Ventrata Dashboard.

Le fonctionnement est le suivant :

  • Produits – Ventrata lit les produits, options et unités Opera Romana Pellegrinaggi de l'opérateur pour remplir les listes déroulantes de l'onglet Mappages (Mappings).

 

Ce que cela signifie pour vous : si un élément manque dans la liste déroulante, c'est que l'opérateur ne l'a pas mis à votre disposition dans Opera Romana Pellegrinaggi. Demandez-lui de le faire.

Content Sync

❌

Ventrata n'importe pas le contenu des produits depuis Opera Romana Pellegrinaggi.

Ventrata n'importe pas le contenu des produits depuis Opera Romana Pellegrinaggi. Vous créez et décrivez vous-même les produits dans Ventrata.

Availability Sync

✅

Lorsque l'option Disponibilité du backend (Backend Availability) est activée, Ventrata vérifie les disponibilités en temps réel de l'opérateur dans Opera Romana Pellegrinaggi.

Le fonctionnement est le suivant :

  • Disponibilités – lorsque quelqu'un utilise le calendrier des disponibilités dans Ventrata, par exemple dans le Dashboard, votre Web Checkout ou un terminal, Ventrata interroge Opera Romana Pellegrinaggi en temps réel pour les dates affichées.

 

Ce que cela signifie pour vous : les clients réservent sur la base des disponibilités Opera Romana Pellegrinaggi en temps réel de l'opérateur : vous ne pouvez donc pas survendre un créneau que l'opérateur a déjà vendu ailleurs.

Pricing Sync

❌

Ventrata ne lit pas les prix dans Opera Romana Pellegrinaggi.

Ventrata ne lit pas les prix dans Opera Romana Pellegrinaggi. Les produits utilisent les prix que vous définissez dans Ventrata, et les réservations sont toujours transmises à Opera Romana Pellegrinaggi.

Promotions Sync

❌

Les promotions ne sont pas transmises à Opera Romana Pellegrinaggi.

Les promotions ne sont pas transmises à Opera Romana Pellegrinaggi. Vos promotions Ventrata s'appliquent toujours au prix que votre client paie dans Ventrata.

Bookings Sync

✅

Les réservations effectuées dans Ventrata pour un produit connecté au backend sont créées dans le compte Opera Romana Pellegrinaggi de l'opérateur.

Le fonctionnement est le suivant :

  1. Blocage et confirmation : lorsque le produit est ajouté au panier, Ventrata vérifie la réservation auprès d'Opera Romana Pellegrinaggi, puis, après le paiement, crée la réservation dans le compte Opera Romana Pellegrinaggi de l'opérateur avec les coordonnées du client.

  2. Billets : la référence ou les billets renvoyés par Opera Romana Pellegrinaggi sont enregistrés sur la réservation Ventrata.

 

‼️ IMPORTANT – Les réservations sont synchronisées dans un seul sens, de Ventrata vers Opera Romana Pellegrinaggi. Si l'opérateur modifie ou annule une réservation dans Opera Romana Pellegrinaggi, Ventrata n'en est pas informé. Demandez à l'opérateur de vous signaler toute modification qu'il effectue.

Pickups/Dropoff Sync

❌

Les informations de prise en charge et de dépose ne sont pas transmises à Opera Romana Pellegrinaggi.

Les informations de prise en charge et de dépose ne sont pas transmises à Opera Romana Pellegrinaggi. Communiquez-les à l'opérateur par un autre moyen si un produit en a besoin.

Custom Questions Sync

❌

Les réponses à vos questions de réservation ne sont pas transmises à Opera Romana Pellegrinaggi.

Les réponses à vos questions de réservation ne sont pas transmises à Opera Romana Pellegrinaggi. Communiquez-les à l'opérateur par un autre moyen s'il en a besoin.

Extras Sync

❌

Les extras et options supplémentaires ne sont pas réservés dans Opera Romana Pellegrinaggi.

Les extras et options supplémentaires ne sont pas réservés dans Opera Romana Pellegrinaggi. Seuls le produit principal, l'option et les unités le sont.

Redemption Sync

❌

Les validations et autres changements de statut dans Opera Romana Pellegrinaggi ne sont pas renvoyés à Ventrata une fois la réservation confirmée.

Les validations et autres changements de statut dans Opera Romana Pellegrinaggi ne sont pas renvoyés à Ventrata une fois la réservation confirmée.

Pass Walkup Scanning Sync

❌

Le scan des pass sur place (walk-up) n'est pas disponible avec Opera Romana Pellegrinaggi.

Le scan des pass sur place (walk-up) n'est pas disponible avec Opera Romana Pellegrinaggi.

Gift Card Sync

❌

Les cartes cadeaux Ventrata ne sont pas transmises à Opera Romana Pellegrinaggi.

Les cartes cadeaux Ventrata ne sont pas transmises à Opera Romana Pellegrinaggi. Les paiements par carte cadeau restent dans Ventrata.

✅ pris en charge · ❌ non pris en charge

 

Bon à savoir : limites et détails de la connexion Opera Romana Pellegrinaggi

  • Disponibilités en temps réel : les disponibilités proviennent d'Opera Romana Pellegrinaggi pendant que les clients consultent l'offre.

  • Réservations à sens unique : les modifications que l'opérateur effectue dans Opera Romana Pellegrinaggi ne parviennent pas à Ventrata.

  • API personnalisée : l'API d'Opera Romana Pellegrinaggi n'est pas une API OCTO : certaines fonctionnalités peuvent donc être limitées par rapport aux backends OCTO.

 

FAQ

J'obtiens une erreur lorsque j'enregistre la configuration du backend de l'opérateur.

La clé API ou le point de terminaison sont très probablement incorrects. Vérifiez-les avec votre opérateur. Si le problème persiste, contactez notre support technique.

Il n'y a pas de case Backend connecté (Backend Connected) dans les paramètres du produit.

L'opérateur défini sur le produit n'a très probablement pas de backend configuré. Vérifiez les paramètres Partenaire backend (Backend Partner) de l'opérateur et réessayez. Si le problème persiste, contactez notre support technique.

Le produit, l'option ou l'unité que je veux mapper n'apparaît pas dans la liste déroulante.

Les listes déroulantes affichent ce que l'opérateur a mis à votre disposition dans Opera Romana Pellegrinaggi. Adressez-vous à l'opérateur. Si le problème persiste, contactez notre support technique.

Les réservations échouent pour un produit connecté au backend.

Vérifiez d'abord le mappage du produit : chaque option et chaque unité doivent être mappées. Vérifiez ensuite que le créneau est toujours disponible dans Opera Romana Pellegrinaggi. Si le problème persiste, contactez notre support technique.

 

 

Informations sur le partenaire

Opera Romana Pellegrinaggi

Via della Pigna

13/a, 00186 Roma (RM), Italie

 

ID partenaire Ventrata : 71406b6f-be42-4a0e-82bf-8ff5d63c156a

Avez-vous trouvé la réponse à votre question ?