---
title: "Aperçu des fichiers JSON"
url: "https://wiki.merchant.mercanto.ch/fr/article/apercu-des-fichiers-json"
language: "fr"
last_updated: "2026-01-20T13:42:05.554Z"
---

# 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. |