Passer au contenu principal

APIDAE : mise en place d'un connecteur entrant

Mis à jour il y a plus de 3 mois

Dans le cadre du déploiement d'une Tête de réseau principale (TDR) il est possible de mettre en place un connecteur avec le SIT APIDAE.

Ce qui permet ensuite de transformer les fiches "froides" importées dans la TDR en comptes elloha selon ce fonctionnement : Transformer une fiche en compte elloha

Le prestataire prend alors en main son compte elloha avec l'essentiel des infos descriptives déjà renseignées et çà lui permet de se concentrer sur la mise à jour et la tarification de ses offres et la diffusion de ses disponibilités.

Important:

Un connecteur SIT n'a pas vocation à récupérer l'exhaustivité des données que vous avez dans votre SIT mais les informations utiles pour le compte elloha. Il ne s'agit pas de migrer votre SIT vers elloha. Certaines infos sont écartées car non utiles dans elloha. D'autres ne sont pas importées car non essentielles ou trop spécifiques à certains bordereaux (types de produits) et le pro peut toujours mettre à jour son compte directement dans elloha.

De sorte que l'on puisse synchroniser vos fiches APIDAE dans votre Tête de réseau vous devez créer un projet de type Export/API dans APIDAE.

Ça peut être le même projet que vous avez mis en place avec votre agence web pour alimenter le site Internet.

Type de Projet APIDAE

Voilà la configuration technique du projet à paramétrer :

Technologies utilisées : API , Exports
Fréquence de génération : Quotidien
Inclure les objets masqués : Non
Format : JSON
Version du format de sortie : V2
Grouper les objets exportés : Non

Exporter les dates d'ouverture : Oui
Inclure source : Non

Un exemple de projet :

mceclip0.png

Le projet doit être partagé avec elloha de sorte que l'on puisse accéder et importer vos fiches SIT :

mceclip2.png

Une ou plusieurs Sélections peuvent être synchronisées. Vous devez créer des Sélections dédiées au connecteur avec elloha.

Vous pouvez en créer une pour les Hébergement et une autre pour les Activités selon les besoins de votre place de marché elloha :

mceclip3.png

Il n'est pas utile de placer dans ces sélection toutes les fiches de votre SIT mais simplement celles que vous voudrez transformer en comptes elloha pour ensuite donner la main à votre prestataire :

Les Sélection sont importées chaque jour de la semaine (du lundi au vendredi). Cette fréquence suppose de venir placer votre fiche SIT dans une des Sélections synchronisées la veille et vous la trouverez disponible pour transformation le lendemain dans votre Tête de réseau elloha.

Si ce n'est pas le cas vérifiez bien qu'elle figure dans la Sélection avant de nous contacter via l'espace de projet Teamwork.

Si vous avez besoin d'aide pour le paramétrage des Sélections contactez votre référent APIDAE.

Une fois le projet paramétré, pour le déploiement du connecteur vous devez nous transmettre :

L'iD du projet

La Clé d'API

mceclip4.png

L'ID ou les ID des sélections à synchroniser

mceclip5.png

Une fois ces éléments en notre possession nous vous confirmerons la mise en place du connecteur.

A noter que, tant qu'une fiche n'est pas transformée en compte elloha, elle est réimportée quotidiennement. De sorte de garder à jour les fiches SIT côté elloha. Si vous mettez à jour cette fiche dans elloha vos modifications risquent d'être écrasées par l'import suivant.

Pour éviter la perte de saisie vous avez deux possibilités :

- transformer la fiche en compte elloha :

-retirer la fiche APIDAE de la Sélection APIDAE dédiée à elloha de sorte qu'elle ne soit plus synchronisée

Le connecteur SIT APIDAE permet de renvoyer automatiquement l'idOI des comptes elloha issus de vos fiches SIT transformées directement dans les métadonnées dans APIDAE.

Ce fonctionnement est détaillé dans cet article.

Dans cet article vous trouverez des schémas d'interactions entre la place de marché elloha, votre SIT et les sites web réalisés par vos agences web :

Règles de mapping d'import des fiches SIT :

Type de fiche SIT APIDAE

Type de fiche elloha TDR

HOTELLERIE

HOTEL

HOTELLERIE_PLEIN_AIR

CAMPING

ACTIVITE (Activités sportives ou autre)*

LOISIR SPORTIF

ACTIVITE (Activités culturelles)*

LOISIR CULTUREL

DEGUSTATION

DEGUSTATION

HEBERGEMENT_COLLECTIF

LOCATIF

HEBERGEMENT_LOCATIF**

LOCATIF

PATRIMOINE_CULTUREL

PATRIMOINE CULTUREL

PATRIMOINE_NATUREL

PATRIMOINE NATUREL

RESTAURATION

RESTAURANT

COMMERCE_ET_SERVICE

non pris en compte

DOMAINE_SKIABLE

non pris en compte

EQUIPEMENT

non pris en compte

FETE_ET_MANIFESTATION

non pris en compte

SEJOUR_PACKAGE

non pris en compte

STRUCTURE

non pris en compte

TERRITOIRE

non pris en compte


*Sous-types ACTIVITE:
Activités sportives (activiteType.id=1789 ou autre) : elloha LOISIR_SPORTIF;

Activités culturelles (activiteType.id=1790) : elloha LOISIR_CULTUREL;


**Sous-types LOCATIFS:
Chambre d'hôtes (hebergementLocatifType.id=2619) : elloha LOCATIF_SSTYPE_CHAMBRE_HOTES
Meublés et Gîtes (hebergementLocatifType.id=2620) : elloha LOCATIF_SSTYPE_MEUBLES_ET_GITES
Appartement (hebergementLocatifType.id=2621) : elloha LOCATIF_SSTYPE_MEUBLES_ET_GITES
Chalet (hebergementLocatifType.id=2622) : elloha LOCATIF_SSTYPE_CHALET
Châteaux et demeures de prestige (hebergementLocatifType.id=2623) : elloha LOCATIF_SSTYPE_RESIDENCES
Maison (hebergementLocatifType.id=2624) : elloha LOCATIF_RESIDENCE_TOURISME
HLL-chalet de loisirs, bungalow...(hebergementLocatifType.id=2625) : elloha LOCATIF_SSTYPE_CHALET
Hébergement insolite (hebergementLocatifType.id=2626) : elloha LOCATIF_SSTYPE_MEUBLES_ET_GITES

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