Interfaces et gestion des stocks

Non couvert par ce guide : les fichiers CSV et Excel avec Porter (guide Importation et exportation (CSV)), les places de marché (guides « Connexion à eBay » et « Connexion à Kaufland »), le flux de produits pour Google (guide « Google Merchant Center et flux de produits ») et les prestataires de services d'expédition tels que DHL ou GLS (guide « Expédition et livraison »).

Vous trouverez toutes les intégrations avec les systèmes de gestion des stocks et de comptabilité sous Paramètres → Interfaces → Gestion des stocks/ERP/Comptabilité. Cliquez pour agrandir.

Le module complémentaire pour l'interface de donnéesXONIC Premium: xoPort Datenschnittstelle

L’API REST, l’interface XML, le connecteur JTL, Billbee (Sync) et la connexion Tricoma ne fonctionnent que si l’interface de données est activée. Sans celle-ci, l’API REST renvoie l’erreur « LICENSE_REQUIRED », et la rubrique Outils → Clients xoPort OAuth2 affiche un message d’avertissement en rouge.

La boutique synchronise ses licences avec le serveur de licences de XONIC. Si cette synchronisation échoue pendant 30 jours, elle désactive l’interface de données et affiche le message « a été désactivée car aucune connexion au serveur d’authentification n’a pu être établie depuis 30 jours ». Dans ce cas, veuillez nous contacter.

Créer un accès

1. Ouvrez Outils → Clients OAuth2 xoPort et cliquez sur « Créer un nouveau client ».
2. Saisissez un « Nom du client », par exemple le nom du programme ou du prestataire de services.
3. Sous « Autorisations », sélectionnez « Lecture », « Écriture » ou « Suppression » pour chaque domaine. Au moins une autorisation est obligatoire.
4. Facultatif : « Limite de débit (requêtes/heure) » et « Notes », par exemple pour indiquer qui utilise cet accès.
5. Créez le client en cliquant sur « Créer un nouveau client ». La boutique affiche l’« ID client » et le « secret client ». Le secret n’apparaît qu’une seule fois : copiez-le immédiatement dans le programme qui doit se connecter.

Un accès destiné à un outil d’analyse des prix ne nécessite que « Produits : lecture » ; tous les autres domaines restent verrouillés. Cliquez pour agrandir.

Choisir les autorisations adaptées

Les autorisations sont classées par rubrique, par exemple Produits, Catégories, Clients, Commandes, Fabricants, Fournisseurs, Médias, Actualités, FAQ, Pages CMS, Contrats, Tickets et Lettres d'information. Elles peuvent être modifiées ultérieurement via « Modifier les autorisations » dans le menu d'actions de l'accès.

Une modification prend effet à partir du prochain jeton. Un jeton contient les autorisations en vigueur au moment de son émission. Un domaine nouvellement débloqué n’est donc accessible au programme qu’une fois qu’il a récupéré un nouveau jeton, au plus tard au bout d’une heure. Une zone retirée reste accessible pour un jeton déjà émis jusqu’à son expiration. Si vous souhaitez y mettre fin immédiatement, sélectionnez ensuite « Révoquer les jetons », voir Retirer immédiatement les autorisations.

Un accès destiné à la synchronisation des articles permet de lire et d'écrire des produits, des catégories et des fabricants, mais ne permet ni de supprimer quoi que ce soit, ni de consulter les données clients. Cliquez pour agrandir.

N'attribuez l'action « Supprimer » que si un programme doit réellement supprimer des enregistrements.

Adresse et inscription

Le programme récupère un jeton d'accès à l'aide de l'ID client et de la clé secrète client. Le jeton est valable une heure, après quoi le programme en demande un nouveau. L'adresse du jeton de votre boutique se trouve dans l'encadré d'informations sous Outils → Clients xoPort OAuth2.

curl -X POST https://ihr-shop.example/xpanel/xoport/oauth/token \
  -d "grant_type=client_credentials" \
  -d "client_id=<CLIENT_ID>" \
  -d "client_secret=<CLIENT_SECRET>"

curl -H "Authorization: Bearer <TOKEN>" \
  https://ihr-shop.example/xpanel/xoport/export/json/products?limit=250&offset=0

Chaque adresse se compose de l'/xpanel/xoport/, de la tâche (export, import ou delete), du format json et de la zone. Si le format est différent, l'API renvoie la réponse « Unknown route ». La suppression n'est possible qu'avec la méthode DELETE.

Récupérer toutes les données page par page : avec ?limit= (valeur par défaut 50, maximum 250) et ?offset=, vous pouvez parcourir de grands ensembles de données. La réponse indique le nombre total via stats et, via has_more, précise s’il y a d’autres pages.

Limites

• Limite de requêtes : chaque compte est autorisé à effectuer 5 000 requêtes par heure par défaut ; ce sont les requêtes des 60 dernières minutes qui sont comptabilisées. Dans le champ « Rate Limit (requêtes/heure) » sous « Modifier le client », vous pouvez saisir une valeur inférieure ; celle-ci s'applique immédiatement, y compris pour les jetons en cours. Seul XONIC peut saisir une valeur supérieure à 5 000 après vérification. En cas de dépassement de la limite, le message « 429 » s’affiche avec « RATE_LIMIT_EXCEEDED » ; la mention « Retry-After » dans la réponse indique le temps d’attente en secondes. 4.9.17
  Si XONIC a attribué une limite de requêtes illimitée à un compte, celle-ci est conservée lors des mises à jour et des contrôles HealthCheck ; les versions antérieures la réinitialisaient à 5 000.ab 4.9.168 Dans « Modifier le client », le champ correspondant à un tel accès est vide, avec la mention « Illimité (défini par XONIC) ». Si vous enregistrez avec ce champ vide, l’accès reste illimité, même si vous modifiez le nom ou les notes ; une valeur inférieure ou égale à 5 000 le limite, et seul XONIC peut alors le rétablir à « illimité ».à partir de la version 4.9.174 Jusqu’à la version 4.9.173, le masque affichait 5 000 pour une telle entrée, et chaque enregistrement fixait la limite à 5 000, même si vous n’aviez modifié que le nom ou les remarques. C’est donc à ces niveaux que XONIC prend en compte les modifications apportées à cette entrée.
• Enregistrements par importation : au maximum autant que le permettent les paramètres → Interfaces → Gestion des stocks/ERP/Comptabilité → Interface de données xoPort → xoPort API : limite d’importation en masse, 50 par défaut.
• La création et la modification sont distinctes : POST ne crée que de nouveaux enregistrements et renvoie le message « already exists. Use PUT to update. » si un numéro d’article existe déjà. PUT ne modifie que les enregistrements existants.

Vous pouvez modifier la limite de requêtes pour une entrée sous « Modifier le client » ; le masque n'accepte pas les valeurs supérieures à 5 000. Cliquez pour agrandir.

Sous Paramètres → Interfaces → Gestion des stocks/ERP/Comptabilité → Interface de données xoPort → xoPort : valider les paramètres de l’interface, vous pouvez valider les paramètres spécifiques à la boutique pour l’API. Sans saisie, l’API n’en détecte aucune. Les identifiants d’accès, les paramètres de licence et de connexion restent toujours verrouillés.ab 4.9.54

« Afficher l'utilisation » répertorie chaque requête d'un accès ; le code 403 indique une consultation en dehors des zones autorisées. Cliquez pour agrandir.

Ne figurent pas dans le journal les requêtes que la boutique rejette en raison de la limite de requêtes (429), ni les consultations qu’elle refuse avant même la requête avec un code 400, par exemple en raison d’une valeur de filtre non valide ou d’une indication de page erronée. Ces codes 400 sont néanmoins pris en compte dans le décompte de la limite de requêtes. Si vous recherchez une telle erreur, demandez au programme d’afficher la réponse de l’interface.

Retirer immédiatement les autorisations : révoquer les jetons

Un programme se connecte à l’aide d’un ID client et d’un secret client et reçoit en échange un jeton valable une heure. Si vous modifiez les autorisations d’un accès, un jeton déjà émis conserve les anciennes autorisations jusqu’à son expiration. Voici comment retirer immédiatement un droit :

1. Sous « Modifier les autorisations », désactivez la section concernée et enregistrez.
2. Dans le menu d’actions de l’accès (flèche à côté de « Modifier le client »), sélectionnez « Révoquer les jetons » et confirmez. Tous les jetons actifs de cet accès sont immédiatement invalidés ; l’ID client et le secret restentinchangés. 4.9.168
3. Lors de la prochaine connexion, le programme récupérera automatiquement un nouveau jeton, désormais avec les autorisations modifiées. Vous n’avez rien à modifier dans le programme.

La fonction « Révoquer les jetons » met fin aux sessions en cours d'un accès sans que vous ayez à attribuer un nouveau secret. Cliquez pour agrandir.

• Cette entrée est visible par les collaborateurs autorisés à supprimer des éléments sur cette page, et uniquement pour les accès actifs. La fonction « Désactiver » nécessite le même droit.
• Si cette option n’apparaît pas parce que votre boutique est antérieure à la version 4.9.168, sélectionnez « Désactiver », puis immédiatement après « Activer ». Cela révoque également tous les jetons, tandis que la clé secrète reste inchangée.
• « Renouveler le secret » révoque également les jetons, mais le programme aura alors besoin du nouveau secret. Utilisez cette option si le secret a pu tomber entre de mauvaises mains.

Limiter l’accès aux adresses IP fixes

Sous Paramètres → Interfaces → Gestion des stocks/ERP/Comptabilité → Interface de données xoPort → API xoPort : restriction IP (JSON/REST), saisissez les adresses d’où proviennent vos programmes. Chaque requête devra alors comporter à la fois l’une de ces adresses et un jeton valide. Si ce champ reste vide, l’API REST restera accessible à toute requête accompagnée d’un jeton valide.ab 4.9.83

• Une seule adresse ou plusieurs, séparées par des virgules. Une plage telle que 203.0.113.0/24 ne correspond jamais ici et bloque tous les programmes.
• Si la boutique se trouve derrière un proxy ou Cloudflare, c’est l’adresse que la boutique voit qui fait foi. Si elle refuse un accès, la réponse IP_NOT_ALLOWED indique cette adresse, et le tableau de bord affiche le message « xoPort REST : connexion bloquée ».
• La liste de l’interface XML (« xoPort : filtre IP ») ne donne pas accès à l’API REST. L’API REST exige toujours un jeton.ab 4.9.83

N'enregistrez que des adresses fixes. Si une adresse change, supprimez immédiatement l'ancienne de la liste : le fournisseur la réattribue, et son prochain détenteur pourrait sinon y avoir accès.

Activation et accès

Les paramètres de cette section se trouvent sous Paramètres → Interfaces → Gestion des stocks/ERP/Comptabilité → Interface de données xoPort.

• Paramètres → Interfaces → Systèmes de gestion des stocks/ERP/Comptabilité → Interface de données xoPort → xoPort : ancienne interface XML disponible active les adresses sous /xpanel/xoport/. Les nouvelles boutiques démarrent avec false, les boutiques existantes conservent true. Sur false, les adresses renvoient un code 403 à chaque requête, y compris celles de la connexion Tricoma.ab 4.9.78
• Justification : le système de gestion des stocks ajoute la clé issue de « xoPort : AppKey-Filter » à l’adresse sous la forme ?key=, ou bien il effectue une requête à partir d’une adresse via « xoPort : IP-Filter ». Si votre adresse Internet change, la clé constitue la méthode la plus fiable. Accédez aux adresses uniquement via https://.
• Ne videz pas le « xoPort : AppKey-Filter » tant que l’exportation des commandes au format XML est en cours : l’exportation accède à l’interface de votre propre boutique à l’aide de cette clé.
• Le message « xoPort API : authentification requise » reste affiché sur true. Sur false, l’interface XML répond à chaque requête sans vérification, et le tableau de bord signale « L’interface de données xoPort n’est pas protégée ».

Sous Paramètres → Interfaces → Gestion des stocks/ERP/Comptabilité → Interface de données xoPort, vous trouverez les paramètres d’accès, de filtrage et d’importation de l’interface ; les nouvelles boutiques démarrent sans l’ancienne interface XML. Cliquez pour agrandir.

Fichiers et adresses

Le système de gestion des stocks place ses fichiers via FTP ou SFTP dans le dossier xoport/xml/import/. Ce n’est qu’après l’appel de l’adresse correspondante qu’ils sont lus. Le nom du fichier doit commencer exactement comme indiqué dans le tableau, en respectant la casse, et se terminer par .xml, par exemple Products_2026-10-04.xml.

La boutique déplace les fichiers importés dans le sous-dossier archiv/. Après « xoPort : durée d'archivage en jours » (réglage d'usine : 14), l'importation des produits ou des commandes les supprime de cet emplacement.

Les fichiers qui ne peuvent pas être lus sont déplacés vers xoport/xml/import/error/ et la réponse indique la ligne concernée ainsi que la raison. La boutique supprime elle-même les caractères de contrôle non autorisés et importe ensuite le fichier.ab 4.9.65

Le fichier XML des produits

Un fichier produit contient, pour chaque article, un élément <product> sous <products>. La boutique identifie l’article via model, le numéro d’article. Les éléments les plus importants :

L'importation transfère les prix tels quels dans les champs de prix de la boutique ; ceux-ci indiquent les prix nets. Si un fichier fournit des caractéristiques, l'importation remplace toutes les caractéristiques de l'article par celles fournies. S'il n'en contient aucune, les caractéristiques existantes sont conservées. 4.9.21

Vous définissez les champs et nœuds pris en charge par l’importation dans Paramètres → Interfaces → Gestion des stocks/ERP/Comptabilité → Interface de données xoPort → xoPort : paramètres d’importation des produits, voir Blocages d’importation. Si votre système de gestion des stocks fournit son propre format, un modèle propre à la boutique (« xoPort : modèle XSL personnalisé ») le convertit au format de la boutique. Il est conservé lors des mises à jour.ab 4.9.21

Tous les éléments, y compris ceux relatifs aux catégories, aux fabricants, aux clients et aux commandes, sont décrits dans la documentation de l’API.

1. Le système de gestion des stocks ou une tâche Cron appelle https://ihr-shop.example/xpanel/xoport/export_orders.php?key=<AppKey>.
2. Pour chaque commande dont le numéro est supérieur à « xoPort : dernier numéro de commande exporté », la boutique crée un fichier order-<Bestellnummer>.xml dans le dossier xoport/xml/export/. Elle définit ensuite cette valeur sur la dernière commande dont le fichier a été créé avec succès. Une commande ayant échoué sera traitée lors de la prochaine exécution.
3. Le système de gestion des stocks récupère les fichiers via FTP ou SFTP. Les fichiers de commande sont verrouillés sur le Web. En règle générale, il déplace les fichiers récupérés vers xoport/xml/export/archiv/.
4. Elle renvoie le statut, le commentaire et les numéros d’expédition via une réponse Orders…xml, voir Fichiers et adresses.

Dans les archives, la boutique supprime les fichiers après « xoPort : durée d’archivage en jours ». La valeur 0 signifie : ne jamais supprimer. Les fichiers contiennent des données clients ; fixez donc un délai. 4.9.116

Confirmation avec statut et numéro d'expédition

• La boutique reconnaît le statut à partir de son nom, dans sa désignation en allemand. Si elle ne reconnaît pas le nom indiqué, elle crée un nouveau statut de commande portant ce nom. Utilisez donc dans le système de gestion des stocks exactement les noms de statut en allemand de la boutique.
• C’est le champ « customer_notified » du fichier qui détermine si le client reçoit un e-mail : « 1 » signifie « notifier ».
• Si le système de gestion des stocks envoie le même message une deuxième fois sans qu’un autre statut ne se soit intercalé, la boutique le rejette. Si vous souhaitez signaler délibérément plusieurs fois un statut en cas de livraisons partielles, saisissez son ID sous Paramètres → Général → Paramètres de base → Importation de statuts xoPort : statuts à notifier même en cas de répétition. 4.9.66

Porter exporte les commandes en deux étapes : un fichier Porter pour les données de commande, un second pour les lignes de commande. Pour savoir comment ces deux fichiers sont liés et comment réexporter des commandes, consultez la section « Exporter les commandes et les clients ».

Configuration

Les paramètres se trouvent sous Paramètres → Interfaces → Gestion des stocks/ERP/Comptabilité → JTL:

Ce qui est synchronisé

Le connecteur ne reprend pas les numéros d'expédition ni les encaissements enregistrés provenant de JTL-Wawi. Vous gérez alors le suivi des expéditions dans la boutique, voir Suivi des expéditions. Le connecteur JTL n'évalue pas les blocages d'importation au niveau des articles.

Deux boutiques : un connecteur est associé à une seule installation de boutique, avec sa propre adresse et son propre « jeton JTL ». Deux boutiques correspondent donc à deux connexions. En revanche, plusieurs domaines d’une même installation partagent la base de données et le connecteur.

OpenXE

La page Paramètres → Interfaces → Systèmes de gestion des stocks/ERP/Comptabilité → OpenXE connecte la boutique via le « Chemin d’accès à l’API OpenXE » et le « Jeton API OpenXE ». Sans ces deux éléments, aucune importation n’est effectuée.ab 4.9.106

• Onglet « Importation de données » : « Produits, niveaux de stock et catégories », « Niveaux de stock », « Clients et représentants » et « Données de suivi ». Chaque processus démarre en arrière-plan et affiche sa progression sous la ligne. Vous pouvez fermer la page, le processus se poursuit.
• Onglet « Exportation de données » : les commandes dont le « statut de commande pour l’exportation vers le système de gestion commerciale » est défini sur « Exporter les commandes » sont enregistrées sous forme de fichier dans le « répertoire de stockage des fichiers d’exportation ». Vous obtenez ensuite le « statut de commande après l’exportation ». Pour effectuer une nouvelle exportation, remettez la commande en statut « À exporter ».
• La synchronisation des catégories crée de nouvelles catégories et déplace celles qui ont été modifiées. Elle conserve le statut, l’image, le tri etl’option « Catégorie comme onglet d’en-tête » d’une catégorie existante. 4.9.135
• Si la page affiche le message « Les tâches en arrière-plan ne sont pas possibles sur ce serveur », cela signifie que la fonction PHP nécessaire fait défaut sur le serveur. Nous clarifierons cela avec votre hébergeur.

Autres intégrations

Si votre système de gestion des stocks n’est pas répertorié, l’API REST est généralement la solution adaptée : de nombreux programmes et prestataires y accèdent via leur propre connexion ou un outil tel que n8n.

Les guides « Statistiques et rapports » et « Traitement des commandes » décrivent l’exportation du chiffre d’affaires au format CSV et l’impression groupée des factures.

n8n

La page Paramètres → Interfaces → Intelligence artificielle → n8n comporte les onglets « Aperçu », « Paramètres » et « Événements » :

1. Saisissez l’« URL de l’instance n8n », le « Type d’instance » (n8n Cloud ou auto-hébergée) et la « Clé API n8n », puis cliquez sur « Tester la connexion ».
2. Créez un nœud Webhook dans n8n et saisissez son adresse comme « URL du Webhook ». Un « secret Webhook » signe chaque message dans l'en-tête X-Webhook-Signature afin que n8n puisse reconnaître les messages authentiques.
3. Activez l’option « Activer les webhooks » et, dans le même onglet « Paramètres », sous « Configuration des événements », sélectionnez les événements souhaités, puis cliquez sur « Enregistrer ». Par défaut, aucun n'est actif. L'onglet « Événements » affiche ensuite le statut, un exemple de charge utile et les derniers appels de webhook.
4. « Envoyer un événement test » permet de vérifier le fonctionnement, tandis que « Derniers appels de webhook » affiche les résultats.

La signature ne correspond qu’au corps non modifié du message. C’est pourquoi vous devez activer l’option « Raw Body » dans le nœud Webhook sous « Options », puis calculer la signature à l’aide d’un nœud Code ou du nœud Crypto à partir de ces octets précis, et non à partir de la charge utile déjà lue. La boutique signale chaque événement immédiatement et une seule fois au maximum : elle attend généralement n8n pendant deux secondes au maximum et ne répète pas un message si n8n n’est pas accessible à ce moment-là.

Vous configurez l’URL du webhook, la clé secrète et les événements signalés dans l’onglet « Paramètres » de la page n8n, puis vous validez en cliquant sur « Enregistrer ». Cliquez pour agrandir.

La notification ne contient que quelques informations, telles que le numéro de commande, le montant et le mode de paiement ou, pour un nouveau client, le nom et l’adresse e-mail. Le workflow récupère les données supplémentaires via un accès dédié à l’API REST, voir API REST.

Variante la plus simple sans programmation : une exportation des commandes via Porter et l’importation des numéros d’expédition via CSV, voir Exporter les commandes et les clients.

Au niveau de l’article : l’onglet de l’interface de données

Chaque article enregistré dispose d’un onglet nommé d’après les interfaces qui gèrent ses verrouillages, par exemple « Interface de données xoPort / CSV xoPort ». C’est là que vous définissez quels champs de cet article peuvent être écrasés lors de l’importation. Si un bouton est désactivé, l’importation laisse le champ tel quel. Le chiffre associé à un groupe indique le nombre de ses champs verrouillés ; celui figurant sur l’onglet indique le nombre de groupes dans lesquels un élément est verrouillé. L’importation reprend toujours intégralement les articles nouvellement créés.

Avec la connexion plusH ou winline, d’autres onglets s’ajoutent en fonction de leurs paramètres, par exemple « Mettre à jour le prix de base par unité », le groupe « Stock et logistique » (profil de feux tricolores, niveau de stock, quantité minimale, unité d’emballage) ainsi que l’affectation par catégorie, marque et label. Sans interface XML, plusH ni winline, l’onglet s’intitule « xoPort CSV » et ne contient que le nom et la description.ab 4.9.155

Un article à prix fixe en magasin : le prix principal, le prix de vente conseillé et la classe fiscale restent inchangés lors de l'importation ; le système de gestion des stocks continue de synchroniser les textes, les images et les stocks. Cliquez pour agrandir.

• Vous pouvez verrouillerles articles à prix réglementé, tels que les livres, en utilisant conjointement les options « Mettre à jour le prix principal » et « Mettre à jour la classe fiscale ». Sinon, une nouvelle classe fiscale modifie le prix brut malgré le prix net verrouillé.ab 4.9.26 Si le système de gestion des stocks fournit un prix de vente conseillé, verrouillez également « Mettre à jour le prix de vente conseillé » : si le prix de vente conseillé est supérieur au prix de vente, la boutique l’affiche sous forme de prix barré avec indication de l’économie réalisée.Source : 4.9.168 L’option « Mettre à jour le prix catalogue » protège également le prix de vente conseillé lors de l’importation XML.
• Le CSV-Porter tient compte des options « Mettre à jour le nom » et « Mettre à jour la description » ; voir « Protéger les champs ».
• L’API REST active et désactive les verrous, voir ci-dessous. Elle enregistre ce qu’elle envoie elle-même malgré le verrou ; seule l’option « Mettre à jour le bonus/cadeau » offre également une protection contre celui-ci.ab 4.9.169
• JTL-Connector, OpenXE/Xentral et Bechlem ne prennent pas en compte les verrous.

Définir des verrous via l’API REST

Votre système de gestion des stocks ou votre prestataire de services peut définir les verrous sur l’article à l’aide du champ « import_blocks ». À partir de la version 4.9.168 de Shop, l’API reconnaît tous les boutons de l’onglet, et le champ « import_blocks_mode » définit ce qu’il advient des verrous qui ne figurent pas dans la liste.ab 4.9.168

Veillez à toujours faire envoyer un mode par le programme : merge pour verrouiller, remove pour déverrouiller. La réponse indique, pour chaque article, si chaque verrouillage a bien été reçu. Les noms de champs et les exemples figurent dans la documentation de l’API.

Après la mise à jour vers la version 4.9.168 : les restrictions plus anciennes s’appliquent

À partir de la version 4.9.168 de la boutique, l’importation de produits au format XML prend en compte les restrictions qu’elle ignorait auparavant : prix de vente conseillé, prix catalogue, remises, statut du produit, images du produit et GTIN. Ces restrictions peuvent figurer depuis longtemps sur les articles, par exemple issues d’une ancienne connexion à plusH. Après la mise à jour, l’importation ne met plus à jour ces champs pour les articles bloqués, sans le signaler. Si le prix de vente conseillé, une image ou le statut de certains articles ne change plus, consultez d’abord l’onglet correspondant.

• Statut du produit avec plusH et winline : un verrouillage de statut s’applique désormais sans exception. Même la vérification des prix (prix de vente inférieur au prix d’achat), la masquage des articles qui ne sont plus livrés et la désactivation des articles principaux laissent un article verrouillé tel quel. La suppression d’articles qui ne sont plus livrés n’empêche pas le verrouillage.
• winline désactive les articles principaux sans variante active : à partir de la version 4.9.168, ils sont mis hors ligne à la fin du cycle ; auparavant, ils restaient actifs. Si vous souhaitez qu’un tel article reste visible, activez une variante ou désactivez l’option « Mettre à jour le statut du produit ».
• GTIN avec winline : un GTIN verrouillé reste en place, et l’exportation des commandes signale l’article portant ce numéro au système de gestion des stocks. Ne verrouillez le GTIN que si le système de gestion des stocks reconnaît l’article sous ce numéro.

Pour tous les articles : paramètres d’importation des produits

Sous Paramètres → Interfaces → Systèmes de gestion des stocks/ERP/Comptabilité → Interface de données xoPort → xoPort : paramètres d’importation des produits, chaque champ de l’article est répertorié avec son nom technique et chaque nœud du fichier (node_…) est accompagné d’un bouton « Oui/Non ». Les champs réglés sur « Non » ne sont pris en compte par l’importation XML des produits pour aucun article. Le numéro d’article et l’ID sont toujours lus.

• Si le système de gestion des stocks fournit par exemple une majoration que vous souhaitez gérer dans la boutique, désactivez le champ correspondant ici, par exemple shipping_surcharge.
• L’importation ne crée de nouveaux articles que si les options « node_categories » et « node_languages » sont activées. Elles le sont par défaut.

Catégories

Dans le masque des catégories, l’onglet « Interface de données xoPort » comporte les boutons « Mettre à jour le nom », « Mettre à jour la description », « Mettre à jour les champs SEO » et « Mettre à jour l’image de la catégorie ». Ils s’appliquent à l’importation de catégories au format XML ; lors de la création d’une nouvelle catégorie, le système reprend toutes les données du fichier.

Le champ « Filtre xoPort »

Dans l’onglet « Divers » de l’article se trouve le champ « Filtre xoPort ». Il ne sert pas à protéger quoi que ce soit, mais à affecter l’article à des exportations : saisissez un ou plusieurs mots-clés, séparés par des points-virgules. Un « Porter » doté du même « filtre d’exportation » n’exportera alors que les articles correspondant à ce mot-clé, ce qui permet de limiter les flux de produits à certains articles ou d’en exclure d’autres.

• Où : dans la fiche client, onglet « Données client », champ « Numéro client individuel (externe) », jusqu’à 64 caractères. L’interface XML et l’API REST renseignent ce champ lors de l’importation de clients ; l’importation de clients via XML identifie les comptes grâce à ce numéro.
• Sur les documents : avec Paramètres → Paiement → Détails client → Utiliser le numéro de client externe comme numéro de client propre sur true (par défaut), la facture et les autres documents affichent ce numéro à la place de l’identifiant client. L’affichage du numéro de client sur les documents est géré via Paramètres → Design → Documents → Numéro de client. Les commandes d’invités ne comportent pas de numéro de client.
• Modifier l’affectation : saisissez le nouveau numéro dans le compte client. Lors de l’enregistrement, la boutique vérifie qu’aucun autre compte ne porte déjà ce numéro et, le cas échéant, affiche le message « Le client… possède déjà ce numéro de client ! ». Les documents récupèrent le numéro du compte lors de leur création ; un document nouvellement créé affiche donc le numéro modifié.

Pour en savoir plus sur l’identifiant client et le numéro propre, consultez le guide « Gérer les clients ».

Après une mise à jour du système de gestion des stocks, la cause réside généralement dans des noms de fichiers, des noms de statuts ou des champs modifiés, ou encore dans une nouvelle adresse Internet. Vérifiez les messages du tableau de bord, la rubrique « Afficher l'utilisation » lors de la connexion et la réponse de l'interface. Si le problème persiste, envoyez-nous l'heure et la réponse.