API Open Billet

A qui est-elle destinée ?

​Cette API est destinée aux éditeurs de solution de vente en ligne spécialisés dans la commercialisation d’activités/loisirs en ligne, et caisses de billetterie qui souhaitent s’interfacer avec l’Open System.

Exemples de cas d’utilisation :

• ​Outil de caisse

Une structure touristique dispose d’un outil de caisse pour vendre des billets de spectacle.
La salle a une limite de places, et la structure souhaite commercialiser les produits depuis sa place de marché et son outil de caisse.
En utilisant l’API Open Billet, l’Outil de caisse peut synchroniser ses stocks avec Open Billet.

• ​Contrôle d’accès

L’éditeur peut récupérer les URLs qui font “clé unique” sur les billets pdf qui ont été réservés, depuis leur QR Code.
La clé unique du billet peut ainsi être stockée pour déterminer si un client a déjà été contrôlé.
Il est également possible en utilisant l’API d’implémenter toutes les fonctions de contrôle d’accès propres à Open-Billet.
Cette possibilité permet notamment à la structure d’utiliser différents mode de contrôle (leur propre borne ou matériel, et l’application de lecture de QrCode synchronisée avec Open Billet).

• ​Editeur de billet/activités qui souhaite s’interfacer avec une place de marché touristique

Un prestataire utilise déjà un outil pour vendre en ligne ses prestations touristiques sur son propre site, mais il souhaite également les commercialiser sur une place de marché. Son éditeur peut utiliser l’API Open Billet.

​Quelles sont ses fonctionnalités ?

• • Récupération des tarifs saisis dans Open Billet
  • Gestion du stock (récupération du stock Open Billet/outil éditeur, modification du stock Open Billet/outil éditeur, ajout de contingences dans Open Billet)
  • Gestion des réservations :
    • Nouvelle réservation réalisée sur une place de marché (réservation locale ou en ligne) : mise à jour du stock dans l’outil éditeur.
    • Nouvelle réservation réalisée par le biais de l’outil éditeur : mise à jour du stock dans Open Billet.
    • Récupération par l’éditeur des informations liées à une réservation (contact, produits, etc) réalisée sur une place de marché

• Gestion centralisée du contrôle d’accès : récupération des informations contenues dans le QrCode
• Gestion des Webhooks* (obtention de la liste des webhooks, ajout d’un webhook, suppression d’un webhook)
• Récupération les notifications de modifications de stock dans le planning Open Billet (par le biais des webhooks)

​*Qu’est-ce-qu’un webhook ? Un webhook (parfois appelé callback) est un message transmis sur une URL fournie par l’éditeur le notifiant d’un événement.

​Quelle saisie doit être effectuée dans Open Billet ?

• ​Billets
  L’éditeur récupère ensuite les produits, identifiants et nom créés, et effectue une correspondance avec les billets déjà créés dans leur outil.
• Descriptions froides (photos, description, etc)
• Tarifs (catégorie, formules et type tarifaire)
• L’éditeur pourra si besoin les récupérer.
• Conditions générales de vente
• Organisateur
• Salle/Lieux

L’éditeur choisit d’utiliser tout ou partie des fonctionnalités de l’API Open Billet en fonction de ses besoins.

Veillez à communiquer directement le lien de l’API Open Billet à votre partenaire.