Aperçu des fichiers JSON

Le schéma ioCanto se compose de différents types de données. Il est recommandé de préparer les fichiers JSON selon les types de données et de les nommer en conséquence.

Lorsque des données sont importées et que les fichiers sont fournis de manière séquentielle, c’est-à-dire à différents moments, il faut respecter l’ordre suivant des types de données :

Position	Type de données (base pour le nom de fichier)	Obligatoire
1	product_abstract	Oui
2	product_concrete	Oui
3	product_price	Oui
4	order_deadline	Oui
5	delivery_calendar	Oui
6	handling_calendar	Oui
7	customer_invitation	Oui
8	merchant_relationship	Oui
9	product_restrictions	Non
10	product_promotion	Non
11	product_media	Non
12	on_demand_storage	Non
13	shopping_list	Non
14	sales_order_amendment	Non
15	sales_order (Remarque : uniquement pour l’export !)	Non

Les fichiers de données peuvent également être transmis simultanément. Dans ce cas, le système vérifie quels fichiers sont prêts à être récupérés. Ils sont ensuite automatiquement traités dans le bon ordre. Cela s’applique aussi bien à l’import initial qu’aux imports ultérieurs (Delta).

Il est recommandé de créer un fichier distinct pour chaque type de données. Toutefois, il peut être pratique de regrouper les types de données customer_invitation et merchant_relationship dans un seul fichier.

Convention de nommage

Sont applicables :

Le nom de fichier doit se terminer par .json.
Le nom de fichier doit idéalement commencer par le type de données spécifique (peu importe l’usage de majuscules ou minuscules).
Le nom de fichier ne doit contenir aucun espace.
Le nom de fichier ne doit comporter que des lettres latines (a-z A-Z), des chiffres (0-9), des tirets (-) et des underscores (_).
Il est recommandé d’ajouter au moins une classification supplémentaire spécifique au client au nom du fichier, par exemple la date de préparation éventuellement avec l’heure, ou – si un fichier doit être spécifique au client – le numéro ou le nom du client. Le type de données est alors séparé de la classification supplémentaire par un tiret.

Exemple d’un nom de fichier correct et préféré :

product_abstract-15072024-170103.json Contient, en plus du nom de fichier, la date et l’heure de la préparation.

Exemples d’un nom de fichier non autorisé :

`abstract!15072024$.json`	Contient des espaces et des caractères spéciaux non autorisés.
`27012023.xls`	Mauvaise extension, `.xls` au lieu de `.json`.

Exemples d’un nom de fichier sous-optimal :

`27012023.json`	Ne contient pas le type de données spécifique — on ne sait pas ce que contient le fichier.
`product.json`	Contient trop peu d’informations sur le type de données spécifique ; cela pourrait être un fichier `product_abstract`, `product_concrete`, `product_price` ou une combinaison de ceux-ci. Il manque également la date de préparation recommandée avec l’heure.
`import.json`	Ne contient pas le type de données spécifique — on ne sait pas ce que contient le fichier. Il manque également la date de préparation recommandée avec l’heure.