Importation et exportation de données

L’échange de données avec Mercanto s’effectue de manière asynchrone. Cela signifie que les données téléchargées par les fournisseurs ne sont pas immédiatement visibles dans la boutique Mercanto pour les clients. L’importation des données se fait soit via le Merchant Portal (MercantoXLSX, MercantoCSV), soit directement via le serveur (MercantoXLSX, MercantoCSV, JSON).

Les règles suivantes s’appliquent :

• Les données d’accès au Merchant Portal et/ou au serveur sont fournies par Mercanto.
• Les nouveaux fichiers importés par les fournisseurs sont “récupérés” et traités par le système toutes les 5 minutes.
• Si d’autres fichiers arrivent sur le serveur dans le même laps de temps, le minuteur est réinitialisé et il faudra de nouveau 5 minutes avant que le traitement des fichiers ne commence.
• Remarque : après l’importation initiale complète (Full Import), Mercanto privilégie les imports différentiels (Delta Imports). Importer des données inchangées — comme c’est le cas pour la majorité des données dans un Full Import — entraîne une charge et des coûts inutiles pour les systèmes.

Importation via le Merchant Portal

Dans le Merchant Portal, il existe la section “Importation”, où les modèles pour les différents types de données peuvent être téléchargés et les fichiers complétés peuvent être acceptable.

Importation via le serveur

Les données sont déposées dans un bucket AWS S3. Chaque fournisseur reçoit les données de connexion nécessaires ainsi qu’une clé d’accès personnelle. Pour pouvoir déposer manuellement des fichiers de données ou des fichiers média sur S3, un logiciel client compatible S3 est requis. Le fournisseur (et/ou éventuellement son partenaire informatique) est responsable de l’intégration automatisée du bucket S3 dans son ERP.

Exemples de logiciels clients S3 possibles :

• WinSCP
• Cyberduck
• Filezilla (Pro Version)

Structure des dossiers sur le serveur

Le bucket S3 présente la structure de dossiers suivante :

root/
├── in/
│   ├── data/
│   └── product_media/
│       ├── image/
│       └── pdf/
└── out/
    └── orders/

Le dossier in contient les sous-dossiers data et product_media.
Les fichiers JSON contenant les données clients et les données articles doivent être déposés dans le dossier data.
Les images d’articles doivent être déposées dans le dossier image.
D’autres fichiers liés aux articles doivent être déposés dans le dossier pdf dans le format correspondant.

Remarque : Les fichiers acceptable via le Merchant Portal sont également placés sur ce serveur. Le système se charge automatiquement de distribuer correctement les fichiers dans les dossiers appropriés.

Exportation de données

Les seuls fichiers exportés par Mercanto sont les fichiers de commandes.
Ils sont déposés dans le sous-dossier orders du dossier out dans le bucket S3, où ils peuvent être récupérés par le fournisseur pour un traitement ultérieur dans son système ERP.

Le format de fichier de la commande dépend du format d’import choisi (xlsx, csv ou json) :

La structure du nom de fichier est définie comme suit :

<Numéro de commande Mercanto>.<Date de la commande>–<Heure de la commande>.<Format du fichier>

Examples:

• JSON: M474421.20240419-171701.json
• CSV: M474421.20240419-171701.csv