Fournir un fichier prêt à importer dans ma cantine

Si vous développez un logiciel de GPAO, distribuez des produits alimentaires en restauration collective, et/ou accompagnez des établissements de restauration collective, vous pouvez faciliter la télédéclaration de vos clients en leur fournissant un fichier directement importable dans ma cantine.
Cette solution constitue un premier niveau d'interopérabilité. Elle permet aux gestionnaires de gagner du temps et de limiter les ressaisies, sans nécessiter d'intégration avec l'API.

Avant de commencer

Les informations demandées dans les fichiers d'import correspondent aux données attendues lors de la télédéclaration.
Avant de construire un fichier, il est recommandé de consulter la matrice de télédéclaration. Elle constitue la référence pour connaître les données demandées aux établissements et leur mode de calcul.
Les fichiers d’import fournit l’année N sont compatible avec l’année N+1 mais pas N+2.

Comment fonctionne l'import ?

Lorsqu'un fichier est importé dans ma cantine, plusieurs contrôles sont effectués automatiquement.
L'application vérifie d'abord la structure du fichier (format, nom et ordre des colonnes), puis contrôle la validité des données contenues dans chaque ligne avant de lancer l'import.

Règles à respecter

Le fichier d'import doit respecter les règles suivantes :

• utiliser l'un des formats acceptés :
• • Excel (.xlsx)
  • CSV (.csv)
  • TSV (.tsv)
• comporter une ligne d'en-tête ;
• respecter exactement les noms de colonnes indiqués dans la documentation ;
• respecter l'ordre des colonnes indiqué dans la documentation ;
• contenir les informations d'une seule cantine par ligne ;
• pour modifier les données d'une cantine existante, l'utilisateur qui importe le fichier doit disposer d'un compte associé à cette cantine.

Si l'une de ces règles n'est pas respectée, le fichier est rejeté avant l'import.

Choisir l'identifiant de la cantine

Deux variantes du fichier sont disponibles selon l'identifiant que vous utilisez.

Utiliser l'ID Cantine (recommandé) : L'ID Cantine est un identifiant unique généré par ma cantine pour chaque établissement ou groupe de restaurants satellites.
C'est l'identifiant recommandé pour les nouveaux développements. Il est stable, propre à ma cantine et ne dépend pas des informations administratives de l'établissement.

Utiliser le SIRET : Il est également possible d'identifier les établissements à l'aide de leur numéro SIRET. Cette variante est proposée pour assurer la compatibilité avec les intégrations existantes.

Pour tout nouveau développement, il est toutefois recommandé d'utiliser l'ID Cantine.

Choisir le bon type de fichier

Selon les données que vous souhaitez transmettre, trois types de fichiers sont disponibles.

Fichier d'achats

À utiliser lorsque vous fournissez des données d'achats (par exemple en tant que fournisseur, distributeur ou éditeur) et que le gestionnaire doit éventuellement les compléter avec celles d'autres sources.

Fichier de bilan

À utiliser lorsque vous êtes en mesure de produire directement le bilan annuel d'une cantine, par exemple parce que votre logiciel centralise l'ensemble de ses achats.

Mis à jour le : 08/07/2026