Service FTP : Format de données attendu

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

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

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

Format des donnédonnées envoyéenvoyés en FTP

Toutes les donnédonnées envoyéenvoyées via FTP, quelles que soient leurs types, doivent êêtre compressécompressées en ZIP au prépréalable.

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

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

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

TéléTélécharger l'exemple de ZIP avec les donnédonnées au format JSON : TODO

TéléTélécharger l'exemple de ZIP avec les donnédonnées au format CSV : TODO

Structure du ZIP attendu

Le ZIP peut contenir les élééléments suivants :

• Un fichier de donnédonnées des clients (voir dédétails)
• Un fichier de donnédonnées des articles (voir dédétails)
• Un dossier contenant les fiches techniques des articles* (voir dédétails)
• Un dossier contenant les fiches de donnédonnées de sécuritésécurité des articles* (voir dédétails)
• Un dossier contenant les photos des articles* (voir dédétails)
• Un dossier contenant les photos des clients** (voir dédétails)

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

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

TéléTélécharger l'exemple : TODO

Fichier de donnédonnées clients

Nommage

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

• JSON
• CSV

Le fichier d'import des donnédonnées clients peut êêtre nomménommé comme ci-aprèaprès (l'extension du fichier n'est pas prise en compte) :

• cli
• client
• clients

Format JSON

Le fichier JSON doit contenir une liste de clients.

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

Les propriétépropriétés reference et designation sont obligatoires afin que le client en question soit traitétraité.

[
	{
		"Reference": "8054",
		"Designation": "Mairie de Perpignan",
		"OffreDePrix": ["00000001", "aaa1"],
		"Historique": ["00000001"]
	},
	{
		"Reference": "84513",
		"Designation": "EPHAD de Perpignan",
		"Historique": ["aaa1"]
	}
]

TéléTélécharger l'exemple : exemple_complet_2_clients.json

Format CSV

Le fichier CSV doit contenir une liste de clients.

L'ensemble des entêentêtes peuvent êêtre dédéfini sous diffédifférent nommage (ex: "ref" ou "référéférence") et l'ordre n'importe pas.

Chaque entêentête / valeur doivent êêtre séparéséparé par un ";" (point virgule) ou "," (virgule).

Liste des entêentêtes du fichier CSV / propriétépropriétés d'un client :

Les entêentêtes reference et designation sont obligatoires afin que le fichier CSV soit traitétraité

Reference;Designation;offreDePrix;Historique
dédésignation;référéférence;offre de prix;historique
nom;ref.;offre;histo
titre;réréf

RéféRéférence :
	^\s*((cli|client|organn?isation|soci[éée]t[éée])?[s]?\s*(r(e|éé)f[.]?|r(e|éé)f(e|éé)rence)[s]?|(r(e|éé)f[.]?|r(e|éé)f(e|éé)rence)[s]?\s*(du|de|l[']?)?\s*(cli|client|organn?isation|soci[éée]t[éée])?[s]?)\s*$
  
DéDésignation :
	^\s*((cli|client|organn?isation|soci[éée]t[éée])[s]?\s*(d(e|éé)signation|titre|nom|libell(e|éé))[s]?|(d(e|éé)signation|titre|nom|libell(e|éé))[s]?\s*(du|de|l[']?)?\s*(cli|client|organn?isation|soci[éée]t[éée])?[s]?)\s*$

Offre de prix :
	^\s*((cli|client|organn?isation|soci[éée]t[éée])?[s]?\s*(offre)[s]?\s*(du|de|l[']?)?\s*(prix)?|(offre)[s]?\s*(du|de|l[']?)?\s*(prix)?\s*(du|de|l[']?)?\s*(cli|client|organn?isation|soci[éée]t[éée])?[s]?)\s*$
    
Historique :
	^\s*((cli|client|organn?isation|soci[éée]t[éée])?[s]?\s*(histo[.]?|historique)[s]?|(histo[.]?|historique)[s]?\s*(du|de|l[']?)?\s*(cli|client|organn?isation|soci[éée]t[éée])?[s]?)\s*$

Designation;Reference;offreDePrix;Historique
8054;Mairie de Perpignan;00000001,aaa1;00000001
84513;EPHAD de Perpignan;;aaa1

TéléTélécharger l'exemple : exemple_complet_2_clients.csv

Fichier de donnédonnées articles

Nommage

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

• JSON
• CSV

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

• art
• article
• produits

Format JSON

Le fichier JSON doit contenir une liste d'articles.

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

Les propriétépropriétés reference et designation sont obligatoires afin que l'article en question soit traitétraité.

[
	{
		"Reference": "00000001",
		"ReferenceGroupe": "00000001A",
		"Designation": "DéDégraissant spray",
		"Description": "DéDégraissant en spray de 500ml...",
		"Dosage": "PrêPrêt àà l'emploi",
		"Temperature": "TempéTempérature ambiante"
	},
	{
		"Reference": "aaa1",
		"Designation": "DéDésinfectant 5L",
		"Description": "Bidon de 5L de dédésinfectant...",
		"Dosage": "0,2 àà 1 %",
		"Temperature": "àà l'eau chaude"
	},
]

TéléTélécharger l'exemple : exemple_complet_2_articles.json

Format CSV

Le fichier CSV doit contenir une liste d'articles.

L'ensemble des entêentêtes peutpeuvent êêtre dédéfini sous diffédifférent nommage (ex: "ref" ou "référéférence") et l'ordre n'importe pas.

Chaque entêentête / valeur doitdoivent êêtre séparéséparé par un ";" (point virgule) ou "," (virgule).

Liste des entêentêtes du fichier CSV / propriétépropriétés d'un article:

Les entêentêtes reference et designation sont obligatoires afin que le fichier CSV soit traitétraité

Reference;ReferenceGroupe;Designation;Description;Dosage;Temperature
dédésignation;référéférence;référéférence groupe;dosage;tempétempérature
nom;ref.;dosage;temp
titre;réréf

RéféRéférence :
	^\s*((produit|art|article)?[s]?\s*(r(e|éé)f[.]?|r(e|éé)f(e|éé)rence)[s]?|(r(e|éé)f[.]?|r(e|éé)f(e|éé)rence)[s]?\s*(du|de|l[']?)?\s*(produit|art|article)?[s]?)\s*$

RéféRéférence groupe :
	^\s*((produit|art|article)?[s]?\s*(r(e|éé)f[.]?|r(e|éé)f(e|éé)rence)[s]?\s*(grp[.]|groupe)[s]?|(r(e|éé)f[.]?|r(e|éé)f(e|éé)rence)[s]?\s*\s*(grp[.]|groupe)[s]?\s*(du|de|l[']?)?\s*(produit|art|article)?[s]?)\s*$
  
DéDésignation :
	^\s*((produit|art|article)[s]?\s*(d(e|éé)signation|titre|nom|libell(e|éé))[s]?|(d(e|éé)signation|titre|nom|libell(e|éé))[s]?\s*(du|de|l[']?)?\s*(produit|art|article)?[s]?)\s*$

Description :
	^\s*((produit|art|article)[s]?\s*(description|d(e|éé)tail)[s]?|(d(e|éé)signation|titre|nom)[s]?\s*(du|de|l[']?)?\s*(produit|art|article)?[s]?)\s*$

Dosage :
	^\s*((produit|art|article)?[s]?\s*(dosage)[s]?|(dosage)[s]?\s*(du|de|l[']?)?\s*(produit|art|article)?[s]?)\s*$
    
TempéTempérature :
	^\s*((produit|art|article)?[s]?\s*(temp[.]?|temp(e|éé)rature)[s]?|(temp[.]?|temp(e|éé)rature)[s]?\s*(du|de|l[']?)?\s*(produit|art|article)?[s]?)\s*$

Reference;ReferenceGroupe;Designation;Description;Dosage;Temperature
00000001;00000001A;DéDégraissant spray;DéDégraissant en spray 500ml...;PrêPrêt àà l'emploi;TempéTempérature ambiante
aaa1;DéDésinfectant 5L;Bidon de 5L de dédésinfectant...;0,2 àà 1 %;àà l'eau chaude

TéléTélécharger l'exemple : exemple_complet_2_articles.csv

Dossiers des documents des articles

Dossier fiches technique

Ce dossier permet de stocker les fiches techniques au format PDF des articles ajoutéajoutés / modifiémodifiés dans le fichier de donnédonnées article.

Les PDF doivent êêtre nomménommés avec la référéférence de l'article concernéconcerné.

TéléTélécharger l'exemple : TODO

Le dossier peut êêtre dédéfini sous diffédifférents nommage (ex: "ft" ou "fiches techniques")

^(ft|fiches?(\s*|-)?tech(nique)?)$

Dossier fiches de donnédonnées de sécuritésécurité

Ce dossier permet de stocker les fiches de donnédonnées de sécuritésécurité au format PDF des articles ajoutéajoutés / modifiémodifiés dans le fichier de donnédonnées article.

Les PDF doivent êêtre nomménommés avec la référéférence de l'article concernéconcerné.

TéléTélécharger l'exemple : TODO

Le dossier peut êêtre dédéfini sous diffédifférents nommages (ex: "fds" ou "fiches de sécuritésécurité")

^(fds|fiches?(\s*|-)?(de)?(\s*|-)?s['éée]cu(rit['éée]e?)?)$

Dossier photo

Ce dossier permet de stocker les photos au format JPG des articles ajoutéajoutés / modifiémodifiés dans le fichier de donnédonnées article.

Les photos doivent êêtre nomménommées avec la référéférence de l'article concernéconcerné.

TéléTélécharger l'exemple : TODO

Le dossier peut êêtre dédéfini sous diffédifférents nommages (ex: "img" ou "photos")

^(photo|img|image|picture)s?$

Dossiers des documents des clients

Dossier client

Ce dossier permet de stocker les photos au format JPG des articles ajoutéajoutés / modifiémodifiés dans le fichier de donnédonnées client.

Les photos doivent êêtre nomménommées avec la référéférence du client concernéconcerné.

TéléTélécharger l'exemple : TODO

Le dossier peut êêtre dédéfini sous diffédifférents nommages (ex: "cli" ou "clients")

^cli(ent?s)?$