Echanges par fichiers CSV
Fonctionnement
Vous devez toujours préferer l'API XML aux fichiers CSV quand c'est possible. Si et seulement si votre ERP ne peut pas fonctionner ainsi, vous pouvez remplacer l'envoi de messages XML par le dépôt via FTP de fichiers au format CSV. Notre serveur les convertira ensuite en messages XML qui reste le format natif de l'API.
- Les fichiers sont déposés dans l'espace FTP de votre serveur PMS. Vous trouverez l'adresse et les codes d'accès dans PMS, dans Réglages.
- Les fichiers sont déposés par votre ERP dans le dossier /edi/inbox.
- Les fichiers créés par PMS et mis à la disposition de votre ERP sont disponibles dans le dossier /edi/outbox.
- Les fichiers sont de type standard CSV, utilisant le point virgule comme séparateur. Les guillements d'encadrement sont facultatifs. L'encodage est obligatoirement UTF8.
- Une fois récupérés et traités par PMS, les fichiers sont déplacés par PMS dans le sous dossier inbox/archives. et outbox/archives
- Une fois récupérés et traités par votre ERP, les fichiers doivent être supprimés ou déplacés par votre ERP dans le sous dossier outbox/archives
- PMS traite les fichiers à importer toutes les 10 minutes (fréquence à convenir lors de la mise en place).
Structure
La structure des données des fichiers CSV consiste à mettre "à plat" les données structurées des messages XML, dans le même ordre, avec une ligne par type de données. Vous devrez donc vous référer à la documentation de l'API XML pour connaître les champs de données et leur signification.
Exemple pour le message Order (transmission des commandes client à PMS) :
- Une ligne pour les informations d'entête, correspondant à la balise XML <order>, avec en première colonne la lettre O
- Une ligne par produit, correspondant aux balises XML <product>, avec en première colonne la lettre P
- Une ligne pour les informations correspondant à la balise <DeliveryOptions> avec en première colonne la lettre D
Exemple de fichier CSV
"O";"myshop";"Create";"OL19975514";"122573";"2019-07-23";"1-070884";"";"";"";"";"";"";"";"";"";"Colissimo Mon domicile";"32";"Maude";"DUPOND";"";"999 impasse des pervenches";"";"";"13270";"FOS-SUR-MER";"";"FR";"061000999";"maudedupond@xxx.com";"";"";"";"";"";"";"";"";"";"";"";""
"P";"63433-969-5";1.0;97.48;"1";"1";0;"";"";"";""
"P";"63433-969-5,5";1.0;97.48;"1";"1";0;"";"";"";""
Liste des fichiers
Les fichiers sont nommés comme suit :
Catalogue articles
- sens : ERP -> PMS
- dans /edi/inbox ou URL à renseigner dans Réglages
- nom : catalogue.csv
- documentation
- télécharger un modèle commenté : csv_template_catalogue.xlsx
Commandes clients (et transferts internes)
- sens : ERP -> PMS
- dans /edi/inbox
- format : order_{order_ref}_datetime.csv
- exemple : order_F245816_20180705180754.csv
- explication des champs dans la documentation de la version xml
- télécharger un modèle commenté : csv_template_order.xlsx
Commandes fournisseurs (= "attendus de réception", "annonces de réception")
- sens : ERP -> PMS
- dans /edi/inbox
- format : purchase_order_{order_ref}_datetime.csv
- exemple : purchase_order_C261716_20180705180754.csv
- explication des champs dans la documentation de la version xml
- télécharger un modèle commenté : csv_template_purchase_order.xlsx
Commandes clients expédiées
- sens : PMS -> ERP
- dans /edi/outbox
- format : shipment_{order_ref}_datetime.csv
- exemple : shipment_F245816_20180705180754.csv
- explication des champs dans la documentation de la version xml
- télécharger un modèle commenté : csv_template_shipment.xlsx
Réceptions fournisseurs
- sens : PMS -> ERP
- dans /edi/outbox
- format : receipt_{receipt_id}_datetime.csv
- exemple : receipt_1234_20180705180754.csv
- explication des champs dans la documentation de la version xml
- télécharger un modèle commenté : csv_template_receipt.xlsx
Stock physique
- sens : PMS -> ERP
- dans /edi/outbox
- format : stock_warehouse_{warehouse_ref}.csv
- exemple : stock_warehouse_DEP0001.csv
- documentation
Mouvements exceptionnels
- sens : PMS -> ERP
- dans /edi/outbox
- format : movements_warehouse_{warehouse_ref}.csv
- exemple : movements_warehouse_DEP0001.csv
Pour toute question sur les fichiers CSV, contactez-nous.