Passer au contenu principal

Prague Boats : backend opérateur

Connectez Prague Boats à Ventrata pour revendre les produits des opérateurs Prague Boats avec des disponibilités, des prix et des réservations en temps réel.

Prague Boats logo

 

Prague Boats est un opérateur de croisières fluviales sur la Vltava, à Prague, qui propose depuis 1993 des croisières touristiques, des croisières déjeuner et des croisières dîner à bord d'une flotte comprenant des bateaux à toit vitré et des catamarans entièrement électriques. Il s'adresse aux visiteurs de loisirs à Prague et propose aussi à bord des privatisations pour entreprises, des conférences, des mariages et des fêtes privées, ainsi que des croisières saisonnières de l'Avent, de Noël et du Nouvel An.

 

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

 

Pour en savoir plus sur Prague Boats, consultez prague-boats.cz.

 

📗 ASTUCE

Effectuez une réservation test après le mappage, et demandez à Prague Boats de confirmer qu'elle est bien arrivée dans son système.

 

Site web principal

Tags

Custom / Proprietary Operator System

Fonctionnalités de la connexion

Availability Sync · Pricing Sync · Bookings Sync

Développé par

Ventrata (via l'API OCTO de Prague Boats)

 

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

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

  • Pricing Sync – les prix proviennent de Prague Boats, ou vous les définissez dans Ventrata.

  • Bookings Sync – les réservations, modifications et annulations sont transmises de Ventrata à Prague Boats, et Prague Boats émet les billets ou les bons.

 

Créer la connexion Prague Boats

🔐 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 OCTO (OCTO API Key) pour l'opérateur. Consultez les étapes ci-dessous.

  • Un accord commercial avec Prague Boats pour revendre ses produits.

  • 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

Contactez Prague Boats et demandez la clé API OCTO (OCTO API Key).

 

  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 Prague Boats et saisissez la clé API OCTO.

  3. Cliquez sur Modifier ce(tte) Opérateur (Update Operator).

 

 

 

📒 REMARQUE – Chaque clé API OCTO vous connecte à un seul opérateur. Configurez chaque opérateur Prague Boats séparément.

 

É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 de Prague Boats, et Tarification backend (Backend Pricing) pour utiliser les prix de Prague Boats.

  3. Cliquez sur Modifier ce(tte) Produit (Update Product).

📒 REMARQUE

Prague Boats envoie à la fois les prix publics et les prix nets. Lorsque l'option Tarification backend (Backend Pricing) est cochée, Ventrata enregistre le prix public comme prix de vente et le prix net comme prix de revient, quel que soit le pourcentage de coût défini sur l'opérateur.

 

Cochez Disponibilité du backend (Backend Availability) pour récupérer les disponibilités et Tarification backend (Backend Pricing) pour récupérer les prix.

 

Sans ces options, le produit utilise les disponibilités et les prix définis dans Ventrata, mais transmet toujours les réservations à Prague Boats.

 

 

Mapper les produits vers Prague Boats

‼️ IMPORTANT

Le mappage indique à Ventrata pour quels produit, option et unités Prague Boats 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 Prague Boats correspondants dans les listes déroulantes, que Ventrata charge depuis Prague Boats. Ne laissez aucun champ vide.

  4. Cliquez sur 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 Prague Boats.

 

Gérer la connexion Prague Boats

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

  • Remplacez la clé sur l'opérateur si Prague Boats 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 à Prague Boats.

 

Fonctionnalités de la connexion en détail

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

 

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

 

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

 

Product Mapping

✅

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

Le fonctionnement est le suivant :

  • Get Products (GET /products) – Ventrata lit les produits, options et unités Prague Boats 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 Prague Boats. Demandez-lui de le faire.

Content Sync

❌

Ventrata n'importe pas le contenu des produits depuis Prague Boats.

Ventrata n'importe pas le contenu des produits depuis Prague Boats. 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 Prague Boats.

Le fonctionnement est le suivant :

  • Availability Check (POST /availability) – lorsque quelqu'un utilise le calendrier des disponibilités dans Ventrata, par exemple dans le Dashboard, votre Web Checkout ou un terminal, Ventrata interroge Prague Boats en temps réel pour les dates affichées.

  • Synchronise les disponibilités depuis le système de Prague Boats.

 

Ce que cela signifie pour vous : les clients réservent sur la base des disponibilités Prague Boats 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

✅

Lorsque l'option Tarification backend (Backend Pricing) est activée, Ventrata reprend les prix de Prague Boats.

Le fonctionnement est le suivant :

  • Availability Check avec la capacité octo/pricing – Ventrata demande les prix à Prague Boats à chaque requête de disponibilité.

  • Synchronise les prix depuis le système de Prague Boats.

  • Lorsque l'option Tarification backend (Backend Pricing) est désactivée, le produit utilise les prix que vous définissez dans Ventrata, et les réservations sont toujours transmises à Prague Boats.

Prague Boats envoie à la fois les prix publics et les prix nets. Lorsque l'option Tarification backend (Backend Pricing) est cochée, Ventrata enregistre le prix public comme prix de vente et le prix net comme prix de revient, quel que soit le pourcentage de coût défini sur l'opérateur.

Promotions Sync

❌

Les promotions ne sont pas transmises à Prague Boats.

Les promotions ne sont pas transmises à Prague Boats. 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 Prague Boats de l'opérateur.

Le fonctionnement est le suivant :

  1. Blocage : Booking Reservation (POST /bookings) – lorsque le produit est ajouté au panier dans Ventrata, Ventrata réserve les places dans Prague Boats.

  2. Confirmation : Booking Confirmation (POST /bookings/{uuid}/confirm) – après le paiement, Ventrata confirme la réservation dans Prague Boats avec les coordonnées du client, et le billet ou le bon renvoyé par Prague Boats devient le billet ou le bon Ventrata.

  3. Modification : Booking Update (PATCH /bookings/{uuid}) – les modifications effectuées dans Ventrata sont transmises à Prague Boats.

  4. Annulation : Booking Cancellation (POST /bookings/{uuid}/cancel) – les annulations effectuées dans Ventrata sont transmises à Prague Boats.

Transmet les réservations, modifications et annulations de Ventrata à Prague Boats.

 

‼️ IMPORTANT – Les réservations sont synchronisées dans un seul sens, de Ventrata vers Prague Boats. Si l'opérateur modifie ou annule une réservation dans Prague Boats, 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 à Prague Boats.

Les informations de prise en charge et de dépose ne sont pas transmises à Prague Boats. 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 à Prague Boats.

Les réponses à vos questions de réservation ne sont pas transmises à Prague Boats. 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 Prague Boats.

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

Redemption Sync

❌

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

Les validations et autres changements de statut dans Prague Boats 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 Prague Boats.

Le scan des pass sur place (walk-up) n'est pas disponible avec Prague Boats.

Gift Card Sync

❌

Les cartes cadeaux Ventrata ne sont pas transmises à Prague Boats.

Les cartes cadeaux Ventrata ne sont pas transmises à Prague Boats. Les paiements par carte cadeau restent dans Ventrata.

✅ pris en charge · ❌ non pris en charge

 

Bon à savoir : limites et détails de la connexion Prague Boats

  • Disponibilités en temps réel : les disponibilités proviennent de Prague Boats pendant que les clients consultent l'offre.

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

 

FAQ

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

La clé API OCTO (OCTO API Key) 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 Prague Boats. 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 Prague Boats. Si le problème persiste, contactez notre support technique.

J'obtiens une erreur lors de l'enregistrement de la configuration du backend de l'opérateur.

Les identifiants sont très probablement incorrects. Vérifiez-les auprès de Prague Boats. Si le problème persiste, contactez le support technique.

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

L'opérateur sélectionné sur le produit n'a très probablement pas de backend configuré. Vérifiez la configuration du backend de l'opérateur et réessayez.

 

Ressources utiles

 

 

Informations sur le partenaire

Prague Boats

Nad Vavruskou 696/19

181 00 Prague 8, Czech Republic

 

ID partenaire Ventrata : 64caef6d-3295-4558-905a-868e53e1607c

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