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 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 clients :

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 :

Les champs reference et designation sont obligatoire afin que le client en question soit correctement traité.

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