Vue d’ensemble

Pour le comparateur de prix sur idealo.fr, vous transmettez les données de vos offres soit via un fichier/flux export (par ex. CSV), soit via l’API pour la gestion des offres d’idealo (en temps réel).

Vendre à l’international : vous pouvez égalemet vendre vos produits en Allemagne, directement sur la plate-forme idealo, via le Direktkauf (achat direct). Relevez les commandes idealo Direktkauf via l’API pour les données des commandes (idealo REST Order API). Cette interface permet également d'informer idealo quant à l’envoi de vos commandes, et le cas échéant de signaler d'éventuelles annulations de commande.

Résumé  :

• Un fichier/flux export (par ex. CSV) ou une API pour la gestion des offres (en temps réel) pour le comparateur de prix idealo.fr
• Pour vendre à l’international en Direktkauf (achat direct) : API pour les données des commandes (idealo REST Order API)

La transmission des informations des offres à idealo se fait via un fichier export (CSV, TXT, XML) ou via l’API pour la gestion des offres d'idealo.

Nous récupérons et actualisons les fichiers export (CSV, TXT, XML) en règle générale toutes les 30 minutes. Dans le cas de l’API pour la gestion des offres, vous actualisez le prix et la disponibilité des offres en temps réel.

De nombreuses solutions e-commerce proposent une intégration pour le comparateur de prix idealo, et il est souvent possible d’implémenter facilement une telle fonction via un module complémentaire.

Variante I : fichier export (CSV, TXT, XML)

Déposez-nous simplement sur un serveur FTP ou un serveur internet (HTTP) un fichier export provenant de votre solution e-commerce.

Pour réduire les temps et les frais liés aux téléchargements vous pouvez transmettre votre fichier sous forme comprimée, au format ZIP ou gZIP. Nous pouvons également travailler avec des répertoires protégés par mot de passe .

• Télécharger des informations au sujet de la constitution d’un fichier export

À quelle fréquence devez-vous mettre à jour le fichier export ?

Veuillez mettre à jour le fichier export plusieurs fois par jour. Ce n'est qu'ainsi que l'utilisateur idealo verra les prix et les disponibilités actuelles de vos offres. Vous évitez ainsi les surventes éventuelles et les déceptions des utilisateurs lorsque les prix affichés sur idealo ne correspondent pas à ceux qui le sont sur votre boutique en ligne.

Variante II : API pour la gestion des offres

idealo met à votre disposition un service web qui vous permet de mettre à jour vos produits et d'offrir des données actualiées en temps réel. Ce service web est adressé via HTTPS et peut être implémenté avec presque tous les langages de programmation.

• Télécharger les spécifications de l'API pour la gestion des offres (PDF, Anglais)

Les informations suivantes ne sont pertinentes que si vous souhaitez commercialiser vos offres directement sur la plate-forme idealo en Allemagne:

Conditions préalables : Vous transmettez individuellement les offres destinées à la plateforme allemande Direktkauf (achat direct) soit via le fichier export, soit via l’API pour les données des commandes. Les stocks et les les options de livraison alternatives (livraison des produits par une entreprise de transport, par ex.) peuvent également être renseignés. Si ces informatinons ne sont pas renseignées toutes les offres du fichier son proposées sur idealo Direktkauf en Allemagne.

Vous pouvez récupérer les commandes passées sur idealo Direktkauf via l’API pour les données des commandes (idealo Merchant Order API v2). C’est également cette API qui permet d'informer idealo de l'état de la commande et de la livraison des produits.

Cette API fonctionne via HTTPS et utilise JSON comme format d’échange. Toutes les opérations sont implémentées de sorte qu’elles puissent être relancées en cas d’erreur.

• Télécharger les spécifications de Merchant Order API v2 Documentation

La récupération des commandes idealo Direktkauf (achat direct) :

Vous obtenez, via Merchant Order API v2, les commandes nouvellement passées, et confirmez la réception des informations en retournant les numéros de commande délivrés par votre solution e-commerce. Seules les nouvelles commandes peuvent être récupérées. La récupération de commandes plus anciennes, déjà prises en compte par votre système, est par conséquent impossible.

Pour chaque commande, idealo communique le panier avec le prix en vigueur au moment de la commande. Idealo transmet également les adresses de facturation et de livraison, les coordonnées de contact supplémentaires, le mode de livraison et de règlement, l’engagement de livraison et les options de livraison.

Vous devez réaliser vous-même la configuration de la TVA dans vos systèmes.
idealo n’a pas une connaissance complète de vos obligations fiscales respectives.

Est-ce que l’état du paiement est également transmis ?

L'état du paiement se fait via les interfaces fournies par les fournisseurs respectifs des services de paiement et n’est pas une composante de l'API. Pour permettre l'affectation des différents paiements à vos commandes, l'ID des transactions provenant des prestataires des services de paiement est cependant communiquée via l’API.

Communiquer l’état de livraison à idealo:

Vous nous transmettez de manière individuelle, via l'API et après avoir remis la commande à l'entreprise de transport, la validation de l'envoi ainsi que la référence du prestataire de transport et que le numéro de suivi de la commande.

Communiquer des annulations/des retours à idealo:

Vous pouvez également utiliser l'API pour signaler à idealo des annulations, des annulations partielles et des retours.

Exemple PHP : Software Development Kit (SDK, kit de développement logiciel) pour connexion API:

Pour faciliter la connexion des systèmes PHP au Direktkauf d'idealo Allemagne nous mettons à disposition un SDK idealo pour PHP. Le SDK contient une bibliothèque pour l’appel des fonctions API mentionnées ci-dessus ainsi qu'une application de test utilisable immédiatement et avec laquelle vous pouvez tester toutes les opérations API dans votre sandbox personnelle. Les données de la sandbox ainsi que les commandes test sont disponibles sur demande après avoir réalisé l'inscription au Direktkauf (achat direct).

• Accéder au SDK PHP sur GitHub

Si vous avez d'autres questions, veuillez nous envoyer un e-mail à tam@idealo.fr