Skip to main content

Service FTP : Format de données attendues

Le point FTP contient deux sous-dossier afin de permettre à notre service de traiter les données reçues :

  • work : Dossier dans le quel les ZIP réceptionné seront décompressés afin d'être traité
  • histo : Dossier contenant l'ensemble des ZIP réceptionné et traité
    • format des ZIP : {yyyy-MM-dd} {HH}h{mm}m{ss}s.zip
      • Exemple : 2022-09-26 16h56m03s.zip

Le service scanne automatiquement les racine du point FTP afin de détecter et traiter tout nouveau ZIP.


Format des données envoyés en FTP

Toutes données envoyés via FTP, quelque soit leur type, doivent être compressées en ZIP au préalable.

Le ZIP n'a pas besoin d'avoir un nommage spécifique, il juste être compressé en ZIP "classique" (Extension ".zip" et niveau de compression "normale").

Une fois généré, le ZIP doit être déposé à la racine du point FTP afin que notre service puisse le détecter.

Une fois la réception du ZIP terminé, celui-ci sera alors décompressé afin d'être traité.


Structure du ZIP attendu

Le ZIP peut contenir les éléments suivants :

  • Un fichier contenant les données des clients
  • Un fichier contenant les données des articles
  • Un dossier contenant les fiches technique des articles*
  • Un dossier contenant les fiches de sécurité des articles*
  • Un dossier contenant les photos des articles*
  • Un dossier contenant les photos des clients**

* : Le fichier de données articles doit être inclus dans le zip pour que ce dossier soit traité
** : Le fichier de données clients doit être inclus dans le zip pour que ce dossier soit traité

Exemple de contenu de fichier ZIP
  • clients.csv
  • produits.csv
  • /FT
    • 00012.pdf
    • 00245.pdf
  • /FDS
    • 00012.pdf
  • /photo
    • 00012.jpg
    • 00245.jpg
  • /client
    • 8054.jpg

Télécharger l'exemple : TODO


Fichier de données client

Nommage du fichier client

Le service FTP accepte les données dans les formats suivants :

  • JSON
  • CSV


Le fichier d'import des données clients doit être nommé comme suivant (l'extension du fichier n'est pas prise en compte) :

  • cli
  • client
  • clients
Exemple de nom pour le fichier clients
  • cli.csv
  • clients.json


Format du fichier client en JSON

Le fichier JSON doit contenir une liste de clients.


Liste des propriétés d'un client :

Nom Description Exemple d'utilisation
Reference Référence du client "Reference": "*8054"
Designation Nom du client "Designation": "Mairie de Perpignan"
OffreDePrix Liste les références des produits dans l'offre de prix du client "OffreDePrix": 
["00000001", "*aaa1"]
Historique Liste les références des produits dans l'historique du client "Historique": 
["00000001"]
Exemple complet avec 2 clients au format JSON 
[
	{
		"Reference": "*8054",
		"Designation": "Mairie de Perpignan",
		"OffreDePrix": ["00000001", "*aaa1"],
		"Historique": ["00000001"]
	},
	{
		"Reference": "84513",
		"Designation": "EPHAD de Perpignan",
		"Historique": ["*aaa1"]
	}
]

Télécharger l'exemple : TODO


Format du fichier de données article

Le fichier d'import des données articles doit être nommé comme suivant (l'extension du fichier n'est pas prise en compte) :

  • art
  • article
  • articles
  • produits
  • produits
  • product
  • products

Exemple de fichier articles:

  • art.csv
  • articles.json


Back to top