> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.ma-cantine.agriculture.gouv.fr/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Créer un fichier d'import d'achats

Le fichier d'import d'achats permet d'importer directement sur *ma cantine* le détail des achats d'un ou de plusieurs établissements, en un clic. Cela permet au gestionnaire, dès l'ouverture de la campagne de télédéclaration, d'avoir l'ensemble des champs de son bilan pré complétés automatiquement.

L'import d'achat est adapté pour deux usages principaux :
* **la mutualisation par un gestionnaire de plusieurs données fournisseurs.** 
Dans ce cas, le gestionnaire peut agréger les différents fichiers transmis par ses fournisseurs et importer le tout dans *ma cantine.* Il peut aussi ajouter à la main quelques achats complémentaires si besoin, via le formulaire.
données avec celles provenant d'autres fournisseurs ou logiciels avant de réaliser sa télédéclaration.
* **le suivi "hors ligne" de ses achats via un tableur en local** (pour les gestionnaires moins habitués au formulaire en ligne). 
Le gestionnaire peut ainsi importer son fichier de suivi par exemple une fois par mois, ou a minima en fin d'année.

→ [Télécharger un fichier d'exemple (avec ID Cantine)](https://fichiers.numerique.gouv.fr/explorer/items/files/72694a33-0de1-4743-9d8f-d82981f34551)
→ [Télécharger un fichier d'exemple (avec SIRET)](https://fichiers.numerique.gouv.fr/explorer/items/files/bf2c36a2-fa60-4026-8bff-25fb0f74f0a0)

## Vous êtes distributeur et souhaitez renseigner directement sur la plateforme les achats de vos clients ?
C’est une excellente initiative qui sera appréciée par vos clients. Il vous suffit de créer un compte sur *ma cantine* et de vous assurer que vous êtes co-gestionnaire des établissements de vos clients.
| Consultez l’article : [Comment ajouter un nouveau gestionnaire à mon établissement ?](https://ma-cantine.crisp.help/fr/article/comment-ajouter-un-nouveau-gestionnaire-a-mon-etablissement-1uewp7g/)

Vous pourrez ensuite importer, pour vos clients, des fichiers d’achats concernant un ou plusieurs établissements en une seule opération.

| Pour en savoir plus : [Interopérabilité avec *ma cantine* : de la facture à l’API](https://ma-cantine.crisp.help/fr/article/interoperabilite-avec-ma-cantine-de-la-facture-a-lapi-1ja2g3i/)
## Structure du fichier
Chaque ligne correspond à un achat réalisé par une cantine.
Les colonnes doivent respecter exactement les noms, l'ordre et les formats indiqués ci-dessous.
| Colonne | Description | Obligatoire |
| ---- |
| `cantine_id` *(ou `siret` selon la variante choisie)* | Identifiant de la cantine | Oui |
| `description` | Description de l'achat | Oui |
| `fournisseur` | Nom du fournisseur | Oui |
| `date` | Date de l'achat au format `AAAA-MM-JJ` | Oui |
| `prix_ht` | Montant HT de l'achat. Utiliser le point (`.`) comme séparateur décimal. | Oui |
| `famille_produits` | Famille de produits achetés | Oui |
| `caracteristiques` | Labels et caractéristiques de l'achat | Non |
| `definition_local` | Définition du caractère local lorsque la caractéristique `LOCAL` est renseignée | Non |
## Valeurs autorisées
### Famille de produits
La colonne `famille_produits` accepte une seule des valeurs suivantes :
* `VIANDES_VOLAILLES`
* `CHARCUTERIE`
* `PRODUITS_DE_LA_MER`
* `FRUITS_ET_LEGUMES`
* `PRODUITS_LAITIERS`
* `BOULANGERIE`
* `BOISSONS`
* `AUTRES`
### Caractéristiques
La colonne `caracteristiques` peut contenir plusieurs valeurs, séparées par une virgule.
Exemple :
```
BIO,IGP
```
Les valeurs acceptées sont :
* `BIO`
* `LABEL_ROUGE`
* `AOCAOP`
* `IGP`
* `STG`
* `HVE`
* `PECHE_DURABLE`
* `RUP`
* `COMMERCE_EQUITABLE`
* `FERMIER`
* `EXTERNALITES`
* `PERFORMANCE`
* `EUROPE`
* `FRANCE`
* `CIRCUIT_COURT`
* `LOCAL`
### Définition du local
Si la caractéristique `LOCAL` est renseignée, la colonne `definition_local` peut doit également être complétée avec l'une des valeurs suivantes :
* `AUTOUR_SERVICE`
* `DEPARTEMENT`
* `REGION`
* `PAT`
* `AUTRE`
→ Voir l’article comprendre les catégories EGalim et leur calcul

## Tester votre fichier
Pour tester votre fichier, créez-vous un compte sur l’espace de démonstration demonstration de *ma cantine.*
Vous pouvez y créer n’importe quel établissement via un numéro SIRETSiret ou SIREN sans aucune conséquence. Ensuite suivez la documentation à destination des gestionnaires pour tester votre import.
→ [Explorer la plateforme de démonstration *ma cantine*](https://ma-cantine.crisp.help/fr/article/explorer-la-plateforme-de-demonstration-ma-cantine-9yk276/)

## Avant d'importer votre fichier
Avant de transmettre un fichier à vos clients, vérifiez que :
* les colonnes sont présentes et dans le bon ordre ;
* les noms des colonnes sont strictement identiques à ceux attendus ;
* les dates utilisent le format `AAAA-MM-JJ` ;
* les montants utilisent un point (`.`) comme séparateur décimal ;
* les valeurs des colonnes à choix correspondent exactement aux valeurs autorisées.
Un fichier qui ne respecte pas ces règles sera rejeté lors de l'import.