Présentation du périmètre technique Kit d intégration des fonctions de réservation Open System au sein d un site d information Alliance Réseaux v09012014 1
KIT D INTEGRATION DES FONCTIONS DE RESERVATION OPEN SYSTEM AU SEIN D UN SITE D INFORMATION Kit d intégration des fonctions de réservation Open System au sein d un site d information... 2 1, Présentation... 3 2, Contenu du Kit... 4 1) Module (Service) d'interrogation des disponibilités temps réel... 4 2) Module (Widget) de Réservation... 4 3) Module (Widget) Panier... 4 4) Tunnel (Pages) de finalisation de la commande... 5 3, Présentation en images... 6 4, Spécifications techniques... 11 1) Module (Service) d'interrogation des disponibilités temps réel... 11 2) Module (Widget) de Réservation... 12 3) Module (Widget) Panier... 13 4) Tunnel (Pages) de finalisation de la commande... 14 2
1, Présentation Le Kit d intégration des fonctions de réservation Open System au sein d un site d information a pour objectif de fournir à un site d information touristique une solution complète d intégration des données temps réel de réservation: - Recherche de disponibilités Open System - Réservation en ligne Open System Ce kit est à destination d une agence web en charge du site Internet d information. La solution s'inscrit dans une logique: d'apport de nouveaux services riches pour les utilisateurs du site d information o Disponibilités temps réel des offres o Immersion de réservation en ligne pour les internautes au sein du site d information Ce kit permet à la structure propriétaire du site d information de proposer à tous ses internautes, sans rupture, des données plus riches de réserver ce qui auparavant ne pouvait être que consulté. Ce kit technique comprend tous les outils nécessaires pour l agence web en charge du site Internet d information permettant d'enrichir le niveau de service proposé aux internautes et de proposer une expérience utilisateur optimale. Grâce à l'intégration du kit, il n'est plus demandé à l'internaute d'aller chercher les informations riches "ailleurs" (disponibilités, réservation en ligne,...). Grâce à l'intégration du kit, les informations riches sont amenées à l'internaute au cœur de son parcours au sein même du site d information. 3
2, Contenu du Kit Le kit se compose : 1) Module (Service) d'interrogation des disponibilités temps réel API permettant d'interroger les disponibilités temps réel depuis le site d information. Grâce à ce service, l agence web peut rajouter des critères de recherche de dates de disponibilité aux moteurs de recherche informatifs existants sur le site d information. Note : L API d interrogation des disponibilités s interroge avec les identifiants uniques des objets Open System (CodeUI) 2) Module (Widget) de Réservation Widget Direct permettant d insérer les fonctionnalités de réservation en ligne Open System directement au sein des pages de détail des offres du site d information : o Disponibilités et réservation Le Widget Direct affiche: Moteurs de recherche de disponibilités / prix sur un objet Résultats de la recherche de disponibilités sur une fiche d'un objet Choix des suppléments Ajout au panier Widget livré avec un thème graphique neutre et dont la charte graphique peut être librement surchargée par l'agence web en charge du site d information. Note : Le Widget Direct se génère grâce aux identifiants uniques des objets Open System (CodeUI) 3) Module (Widget) Panier Widget permettant d insérer le panier d achats de l'internaute sur le site d information. Widget Panier permettant à l'internaute acheteur de rester dans le site d information lors de son ajout au panier et de poursuivre sa navigation sur le site d information avec un panier d'achat accessible en permanence. Widget Panier permettant à l'internaute de basculer à tout moment dans le tunnel de commande pour finaliser sa réservation. (module 4) Note : Depuis une fiche de détail d une offre sur le site d information, lorsque l internaute ajoute une prestation réservable au panier (depuis le module 2), cette prestation s ajoute automatiquement au panier. Widget livré avec un thème graphique neutre et dont la charte graphique peut être librement 4
surchargée par l'agence web en charge du site d information. 4) Tunnel (Pages) de finalisation de la commande Pages de finalisation de la commande hébergées par Alliance Réseaux o Page de visualisation du panier détaillé o Page de saisie des coordonnées o Page d'accès au paiement / réservation des prestations Les pages du tunnel de finalisation de commande sont fournies en langues française et anglaise dans un habillage neutre ou habillé (sous réserve de fourniture des flux compatibles d'entêtes et pieds de pages fournis par l'agence web en charge du site d information concerné) Note : L internaute accède au tunnel de finalisation de la commande : - lors de l ajout au panier, s il clique sur «passer ma commande» ou - à tout moment depuis le Widget Panier (cf. module 3) 5
3, Présentation en images Schéma de maillage SIT > Open System Sur chaque objet de la base de données qui sert à alimenter les objets touristiques affichés sur le site d information, l administrateur du SIT renseigne le CodeUI Open System correspondant SIT - Identifiant SIT : 119671 > CodeUI: CF-HRIT-30812 - Identifiant SIT : 119729 > CodeUI: CF-OSHO-34839 - Identifiant SIT : 119781> CodeUI: CF-HRIT-11670-6
Utilisation du Module n 1 : API d obtention des disponibilités Ajout de dates de recherche de disponibilités dans les moteurs de recherche du site d information Liste de résultats des fiches du SIT qui sont réservables aux dates recherchées. Le moteur de l agence web a interrogé le Module 1 pour vérifier la disponibilité des objets Open System 7
Utilisation du Module n 2 : Widget Direct Le Widget Direct génère le module de réservation au sein de chaque fiche de détail du site d information. Le contenu du module de réservation affiché à l internaute peut différer d un produit à un autre. C est le Widget Direct qui gère automatiquement chaque spécificité sans nécessité d intervention de l agence web Utilisation du Module n 2 : Widget Direct Ajout au panier depuis le Widget Direct sur le site d information 8
Utilisation du Module n 3 : Widget Panier Affichage du Widget Panier sur toutes les pages du site d information. Le Widget Panier permet à tout moment à l internaute de : - Visualiser / modifier le contenu de son panier en cours - Finaliser sa réservation Utilisation du Module n 3 : Widget Panier 9
Module n 4 : Tunnel de finalisation de la commande Les pages du tunnel de finalisation de la commande sont les seules pages hébergées par Alliance Réseaux. Ces pages sont affichées quand l internaute choisit de passer sa commande depuis le site d information Les pages du tunnel de finalisation de la commande peuvent respecter strictement la même charte graphique que celle du site d information. Il n y a ainsi aucune rupture visuelle dans le parcours client. Les modifications que l administrateur du site d information fait sur son site (menus, liens, etc.) sont automatiquem ent reportées sur ces pages grâce à un système d inclusion automatisé Module n 4 : Tunnel de finalisation de la commande 10
4, Spécifications techniques 1) Module (Service) d'interrogation des disponibilités temps réel Service web POST XML permettant la récupération temps réel au format XML ou JSON des disponibilités des objets. Paramètres minimum transmis au service : - Collection de CodeUI Open System - Date de début du séjour - Durée du séjour Exemple de réponse du service : { Reponse : { ConversationId : e2091865-dd9c-47a1-8d78-0df4c164bf7b, Page : 0, Dispo : { PageFin : true, Nb : 6, Dispos : 6, NonDispos : 3, NonRecherches : 0 }, Items : [ { "ui": OSMB-34840-1, prix: 500 }, { "ui": OSMB-34840-2, prix: 500 }, { "ui": OSMB-34840-3, prix: 500 }, { "ui": OSMB-34840-4, prix: 400, prixbarre: 500 }, { "ui": OSMB-34840-5 }, { "ui": OSMB-34840-7, prix: 500 } ] } } Documentation technique détaillée du «Module (Service) d'interrogation des disponibilités temps réel» disponible ici : http://documentation.open-system.fr/api/apidispo/alliancereseaux_opensystem_wsavail.pdf 11
2) Module (Widget) de Réservation Module JavaScript permettant de générer le module de réservation complet d un objet au sein des pages du site d information. Le Widget affiche le module de réservation correspondant au CodeUI de l objet qui lui est transmis. Format du code : <script type="text/javascript" src="http://gadget.open-system.fr/widgets-libs/rel/noyau-1.0.min.js"></script> <script type="text/javascript" > ( function() { var widgetproduit = AllianceReseaux.Widget.Instance( "Produit", { idpanier:"votreidpanier", idintegration:votreidintegration, langue:"xxx", ui:"codeui" } ); widgetproduit.initialise(); })(); </script> <div id="widget-produit-ddd-eee"></div> Quelques exemples: Documentation technique détaillée du «Module (Widget) de Réservation» disponible ici : http://documentation.opensystem.fr/api/widgetdirect/alliancereseaux_opensystem_widgetdirect.pdf 12
3) Module (Widget) Panier Module JavaScript permettant d afficher le panier en cours de l internaute au sein des pages du site d information. Code à intégrer : <!--DEBUT librairie--> <script type="text/javascript" src="http://gadget.open-system.fr/widgets-libs/rel/noyau-1.0.min.js"></script> <!--FIN librairie--> <!--DEBUT script Widget panier. Pour langue anglaise, mettre langue:"uk" --> <script type="text/javascript" > ( function() { var widgetpanier = AllianceReseaux.Widget.Instance( "Panier", { idpanier:"votreidpanier", idintegration:votreidintegration, langue:"fr" } ); widgetpanier.initialise(); })(); </script> <!--FIN script Widget panier--> <!--DEBUT conteneur widget panier--> <div id="widget-panier"></div> <!--FIN conteneur widget panier--> Exemple :. 13
4) Tunnel (Pages) de finalisation de la commande Pour que les pages du tunnel de finalisation de la commande respectent la charte graphique du site d information et soient automatiquement tenues à jour, Alliance Réseaux peut intégrer dynamiquement des inclusions de blocs HTML d entêtes et de pieds de pages sur les pages du tunnel de commande. Voici les préconisations pour le format à transmettre à Alliance Réseaux par l agence web en charge du site d information : 1 - L'Agence Web fournit une url qui retourne l'intérieur des informations contenues dans le <head> mais sans les balises <head></head> Ce flux contient balises styles et éventuelles balises script strictement nécessaires à l'affichage / fonctionnement du header 2 - Pour le header, L'Agence Web fournit une url qui retourne l'intérieur des informations contenues dans le body (sans la balise body ouvrante) Ce flux contient le contenu html du header nécessaire à son affichage 3 - Pour le footer, L'Agence Web fournit une url qui retourne l'intérieur des informations contenues dans le body (sans la balise body fermante) Ce flux contient le contenu html du footer nécessaire à son affichage Note : 1 jeu d urls pour la version française & 1 jeu d urls pour la version anglaise. Important: Toutes les urls d'accès aux ressources (css, images, scripts, etc.) doivent nécessairement être en urls absolues (par d'urls relatives). Une fois inclues, ces ressources ne pourront pas être accessibles en local sur les pages du tunnel. Il faut donc bien veiller à n'utiliser que des urls absolues. Retirer les déclarations de bibliothèques Jquery dans ces flux. Le flux va être intégré sur des pages dans lesquelles les bibliothèques Jquery seront intégrées. De manière globale, si les ressources Javascript inclues ou ressources css ne sont pas strictement utiles au bon fonctionnement des éléments fournis (header, footer) merci de ne pas les intégrer dans les flux. Le contenu renvoyé par les urls fournies est mis en cache par Alliance Réseaux et renouvelé automatiquement afin : o o D optimiser les performances De limiter le nombre d'appels inutiles à des ressources de l agence sur des données semi-statiques 14