Interface Import

Où puis-je trouver la spécification de l'interface d'importation ?

21. octobre 2020

Interface Import| XML | Json

L'interface d'importation vous offre la possibilité de transférer le contenu souhaité de votre système sous forme d'enregistrements de données vers le guide :

Format/Structure
Vous fournissez les données sous forme de XML dans la structure de l'interface d'importation standard du guide. Sous "Download", vous trouverez la description de l'interface, le fichier de schéma et un fichier d'exemple

Mode
L'interface d'importation fonctionne en mode PLEIN. Vous nous fournissez toujours un ensemble complet de données. Le processus d'importation des guides s'occupe de la création et de la mise à jour correcte des annonces.
Dans des cas exceptionnels, l'interface d'importation prend en charge un mode DELTA. Toutefois, il ne peut être utilisé qu'en concertation avec Guidle. Pour cela, veuillez contacter le service d'assistance des guides.

Field guidle:sourceOfferId
Ce champ est utilisé pour identifier une annonce de manière unique au cours du processus d'importation et doit être unique dans l'ensemble du flux de données. Après que l'événement a été transmis à guidle, cette identification ne doit pas changer pour une annonce. Idéalement, un identifiant d'événement de la base de données interne est utilisé à cette fin.

Champs guidle:sourceOfferId et guidle:bpId
Ces champs sont individuels pour chaque interface d'importation. Veuillez demander l'assistance d'un guide pour l'utilisation de la carte d'identité.

Transmission d'annonces de différentes institutions
Si votre interface d'importation transmet des annonces de différentes institutions à guidle, le conteneur "guidle:customBusinessPartner" doit être utilisé. Vous y indiquez pour chaque annonce à quelle institution elle appartient. Idéalement, les quatre champs suivants devraient nous être transmis :

> guidle:ownerReferenceId
> guidle:ownerReferenceName
> guidle:ownerReferenceZip
> guidle:ownerReferenceCity

Cependant, le champ guidle:ownerReferenceId est également suffisant. Il est important de noter que la combinaison des champs permet une identification unique d'une institution.
Si le conteneur "guidle:customBusinessPartner" est utilisé, le champ "guidle:bpId" (voir section ci-dessus) doit être supprimé du flux de données.

Catégorisation
En utilisant guidle:customClassification, vous pouvez nous envoyer la catégorisation appropriée de votre système source pour chaque contenu. guidle transfère cette catégorisation à la catégorie guidle appropriée pendant le processus d'importation en utilisant le mappage des catégories.

Fourniture de données
Fournissez-nous le XML via l'URL. En concertation avec vous, guidle définit quand et à quelle fréquence les données sont récupérées à partir de ce lien.


Téléchargements

• Spécification de l'interface Interface d'importation standard
• Fichier de schéma
• Exemple de fichier

Note : Ce texte a été traduit par un logiciel de traduction automatique et non par un traducteur humain. Il peut contenir des erreurs de traduction.