Articles sur : Suivis des achats

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)
→ Télécharger un fichier d'exemple (avec SIRET)

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 ?

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

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"

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.

Mis à jour le : 08/07/2026

Cet article a-t-il répondu à vos questions ?

Merci !