Hellenic Heritage Tickets est la plateforme de billetterie officielle du ministère grec de la Culture et de l'ODAP. Elle couvre un réseau de plus de 350 sites archéologiques, musées et monuments en Grèce, dont vingt sites inscrits au patrimoine mondial de l'UNESCO. Son billet électronique unifié réunit 108 sites dans un même système, avec entrée à horaire fixe, accès par QR code sur mobile et pass régionaux et thématiques.
Connecter Hellenic Heritage à Ventrata vous permet de revendre les produits d'opérateurs qui utilisent Hellenic Heritage comme système de réservation. Ventrata lit leurs disponibilités en temps réel dans Hellenic Heritage, et chaque réservation que vous prenez est créée directement dans le compte Hellenic Heritage de l'opérateur.
Pour en savoir plus sur Hellenic Heritage, consultez tickets.hh.gr.
📗 ASTUCE
Effectuez une réservation test après le mappage, et demandez à Hellenic Heritage Tickets de confirmer qu'elle est bien arrivée dans son système.
Site web principal | |
Tags | Booking / Ticketing System |
Fonctionnalités de la connexion | Availability Sync · Bookings Sync |
Développé par | Ventrata (via Hellenic Heritage Tickets API) |
Cette connexion opérateur (aussi appelée backend) vous permet de revendre les produits d'opérateurs qui utilisent Hellenic Heritage comme système de réservation principal, chaque réservation étant créée directement dans Hellenic Heritage. Fonctionnalités de cette connexion :
Availability Sync – les disponibilités en temps réel proviennent du compte Hellenic Heritage de l'opérateur.
Bookings Sync – les réservations sont transmises de Ventrata à Hellenic Heritage, et Hellenic Heritage émet les billets ou les bons.
L'API externe de Hellenic Heritage 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 Hellenic Heritage
🔐 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 des identifiants API de Hellenic Heritage Tickets (l'article ne précise pas les différents champs) 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 : demander les identifiants API
Contactez Hellenic Heritage Tickets et demandez les identifiants API qui vous permettront de revendre ses produits via Ventrata.
Étape 2 : configurer l'opérateur dans Ventrata
Contactez Hellenic Heritage Tickets et demandez les identifiants API afin de pouvoir revendre ses produits via Ventrata.
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.
Dans la section Partenaire backend (Backend Partner), sélectionnez Hellenic Heritage et saisissez les identifiants API de Hellenic Heritage Tickets (l'article ne précise pas les différents champs).
Cliquez sur Modifier ce(tte) Opérateur (Update Operator).
Étape 3 : connectez chaque produit
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.
Cochez Backend connecté (Backend Connected). Cochez Disponibilité du backend (Backend Availability) pour utiliser les disponibilités de Hellenic Heritage.
Cliquez sur Modifier ce(tte) Produit (Update Product).
Vérifiez que l'opérateur du produit est bien défini sur Hellenic Heritage Tickets.
Cochez Backend connecté (Backend Connected). Pour récupérer les disponibilités depuis Hellenic Heritage Tickets, cochez aussi Disponibilité du backend (Backend Availability) ; pour récupérer les prix, cochez Tarification backend (Backend Pricing).
Sans les options Disponibilité du backend (Backend Availability) et Tarification backend (Backend Pricing), le produit utilise les disponibilités et les prix configurés dans Ventrata, mais transmet toujours les réservations à Hellenic Heritage Tickets.
Mapper les produits vers Hellenic Heritage
‼️ IMPORTANT
Le mappage indique à Ventrata pour quels produit, option et unités Hellenic Heritage 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é.
Dans le Ventrata Dashboard, accédez à Produits → Produits (Products → Products) et ouvrez le produit.
Ouvrez l'onglet Mappages (Mappings). Il apparaît dès que le produit est défini sur Backend connecté (Backend Connected).
Pour chaque option et unité Ventrata, sélectionnez le produit, l'option et les unités Hellenic Heritage correspondants dans les listes déroulantes, que Ventrata charge depuis Hellenic Heritage. Ne laissez aucun champ vide.
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 Hellenic Heritage.
Gérer la connexion Hellenic Heritage
Mettez à jour le mappage lorsque l'opérateur modifie des produits, options ou unités dans Hellenic Heritage.
Remplacez la clé sur l'opérateur si Hellenic Heritage 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 à Hellenic Heritage.
Fonctionnalités de la connexion en détail
Cette section s'adresse à toute personne qui souhaite savoir précisément comment fonctionne la connexion Hellenic Heritage. Ici, le sens est l'inverse de celui d'une connexion revendeur : Ventrata appelle Hellenic Heritage, via l'API de Hellenic Heritage Tickets. Pour chaque fonctionnalité, cette section explique quels appels Ventrata effectue, à quel moment, et ce que cela signifie pour vous.
En bref : Ventrata demande à Hellenic Heritage les disponibilités chaque fois que quelqu'un consulte un produit connecté au backend, et crée chaque réservation dans le compte Hellenic Heritage de l'opérateur. Hellenic Heritage ne renvoie pas les modifications à Ventrata.
Les délais indiqués sont ceux généralement observés avec Hellenic Heritage ; ils sont arrondis et peuvent évoluer.
Product Mapping | ✅ |
Vous mappez chaque produit, option et unité Ventrata au produit Hellenic Heritage de l'opérateur dans le Ventrata Dashboard. Le fonctionnement est le suivant :
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 Hellenic Heritage. Demandez-lui de le faire. |
Content Sync | ❌ |
Ventrata n'importe pas le contenu des produits depuis Hellenic Heritage. Ventrata n'importe pas le contenu des produits depuis Hellenic Heritage. 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 Hellenic Heritage. Le fonctionnement est le suivant :
Ce que cela signifie pour vous : les clients réservent sur la base des disponibilités Hellenic Heritage 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 Hellenic Heritage. Ventrata ne lit pas les prix dans Hellenic Heritage. Les produits utilisent les prix que vous définissez dans Ventrata, et les réservations sont toujours transmises à Hellenic Heritage. |
Promotions Sync | ❌ |
Les promotions ne sont pas transmises à Hellenic Heritage. Les promotions ne sont pas transmises à Hellenic Heritage. 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 Hellenic Heritage de l'opérateur. Le fonctionnement est le suivant :
Transmet les réservations, modifications et annulations de Ventrata à Hellenic Heritage Tickets.
‼️ IMPORTANT – Les réservations sont synchronisées dans un seul sens, de Ventrata vers Hellenic Heritage. Si l'opérateur modifie ou annule une réservation dans Hellenic Heritage, 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 à Hellenic Heritage. Les informations de prise en charge et de dépose ne sont pas transmises à Hellenic Heritage. 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 à Hellenic Heritage. Les réponses à vos questions de réservation ne sont pas transmises à Hellenic Heritage. 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 Hellenic Heritage. Les extras et options supplémentaires ne sont pas réservés dans Hellenic Heritage. Seuls le produit principal, l'option et les unités le sont. |
Redemption Sync | ❌ |
Les validations et autres changements de statut dans Hellenic Heritage ne sont pas renvoyés à Ventrata une fois la réservation confirmée. Les validations et autres changements de statut dans Hellenic Heritage 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 Hellenic Heritage. Le scan des pass sur place (walk-up) n'est pas disponible avec Hellenic Heritage. |
Gift Card Sync | ❌ |
Les cartes cadeaux Ventrata ne sont pas transmises à Hellenic Heritage. Les cartes cadeaux Ventrata ne sont pas transmises à Hellenic Heritage. Les paiements par carte cadeau restent dans Ventrata. |
✅ pris en charge · ❌ non pris en charge
Bon à savoir : limites et détails de la connexion Hellenic Heritage
Bon à savoir : limites et détails de la connexion Hellenic Heritage
Disponibilités en temps réel : les disponibilités proviennent de Hellenic Heritage pendant que les clients consultent l'offre.
Réservations à sens unique : les modifications que l'opérateur effectue dans Hellenic Heritage ne parviennent pas à Ventrata.
API personnalisée : l'API de Hellenic Heritage n'est pas une API OCTO : certaines fonctionnalités peuvent donc être limitées par rapport aux backends OCTO.
La connexion ne crée pas les produits automatiquement : recréez-les d'abord dans Ventrata.
À propos du partenaire (d'après l'introduction de l'article) : plateforme de billetterie officielle du ministère grec de la Culture et de l'ODAP, couvrant plus de 350 sites archéologiques, musées et monuments, dont vingt sites inscrits au patrimoine mondial de l'UNESCO. Le déploiement en 2026 d'un billet électronique unifié a réuni 108 sites dans un même système, avec entrée à horaire fixe, accès par QR code sur mobile et pass régionaux et thématiques.
FAQ
J'obtiens une erreur lorsque j'enregistre la configuration du backend de l'opérateur.
J'obtiens une erreur lorsque j'enregistre la configuration du backend de l'opérateur.
Les identifiants API de Hellenic Heritage Tickets (l'article ne précise pas les différents champs) 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.
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.
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 Hellenic Heritage. Adressez-vous à l'opérateur. Si le problème persiste, contactez notre support technique.
Les réservations échouent pour un produit connecté au backend.
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 Hellenic Heritage. 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.
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 Hellenic Heritage Tickets. 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.
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
📚 En savoir plus sur les connexions Ventrata
Informations sur le partenaire
Hellenic Heritage Tickets
Eleftheriou Venizelou 57
105 64 Athens, Greece
ID partenaire Ventrata : 086db963-6786-4ca6-b86f-e01408d945c4