Importation XML
Importez les données relatives aux produits, aux catégories, aux clients et aux commandes dans votre boutique via une requête HTTP. L'interface d'importation XML traite les données côté serveur et renvoie une réponse structurée au format JSON, comprenant un récapitulatif des résultats et les messages d'erreur.
Importations disponibles
Produits
Importation et mise à jour des données produits, y compris les descriptions, les prix, les images et les attributs.
Documentation →Stocks et statuts
Mise à jour rapide des stocks et du statut des produits – optimisée pour des mises à jour fréquentes avec un volume de données minimal.
Documentation →Catégories
Importation des structures de catégories, y compris la hiérarchie, les descriptions et les données SEO.
Documentation →Mettre à jour les commandes
Mise à jour du statut des commandes, des numéros de suivi et des informations d'expédition des commandes existantes.
Documentation →Clients
Importation des données clients, y compris les adresses, les groupes de clients, les abonnements à la newsletter et les numéros de client externes.
Documentation →Fonctionnalités
Traitement par lots
Traitez plusieurs enregistrements en une seule requête – idéal pour les importations en masse et les mises à jour régulières.
Réponse JSON
Réponse structurée avec indication du statut de chaque enregistrement – lisible par machine pour une intégration transparente.
Validation
Vérification automatique de toutes les données transmises avec des messages d'erreur détaillés en cas d'entrées non valides.
Clés API
Accès via des clés API configurables avec des autorisations individuelles pour un transfert de données sécurisé.
Cryptage HTTPS
Toutes les données sont transmises de manière chiffrée – communication sécurisée entre la boutique en ligne et les systèmes externes.
Gestion des erreurs
Des messages d'erreur détaillés en cas de données non valides permettent un diagnostic et une correction rapides.
Réponses et cas d'erreur
Chaque importation renvoie un objet JSON. Depuis la version 2.115.0 de l'API xoPort (Shop 4.9.65), celui-ci contient en outre :
outcome:ok(aucun fichier rejeté),partial(fichiers individuels rejetés, les autres traités) oufailed(fichiers rejetés, aucun traité)files.failed: fichiers rejetés avec leur nombre, leur nom, le message d’erreur (ligne correspondante) et leur emplacementwarnings.invalid_xml_chars_removed: nombre de caractères supprimés, non autorisés par XML 1.0
Les caractères interdits par XML 1.0 (par exemple, les caractères de contrôle dans les textes descriptifs) sont supprimés par l’importation avant le traitement du fichier. Si un fichier ne peut malgré tout pas être lu au format XML, il n’est pas archivé, mais déplacé vers xoport/xml/import/error/ où il sera supprimé, tout comme l’archive, à l’issue de la période de conservation (14 jours par défaut). Les fichiers rejetés ne sont pas disponibles sur files.processed.filenames.
"state": "error" et le code HTTP 422. Les fichiers rejetés individuellement ne modifient pas le statut HTTP – pour cela, consultez outcome ou files.failed.count. "state": "success" ne prouve pas à lui seul qu’une importation a eu lieu.
