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

# Interopérabilité avec « ma cantine » : de la facture à l’API

**Qu'est-ce que l'interopérabilité ?**
L'interopérabilité, c'est la capacité de deux logiciels différents à échanger des données automatiquement, **sans qu'un humain ait besoin de ressaisir l'information à la main**.

La télédéclaration peut être alimentée de plusieurs façons selon les fonctionnalités proposées par votre solution.
# Les différents niveaux d'interopérabilité
### Niveau 0 : Rendre les informations visibles
Votre solution met à disposition les informations nécessaires à la télédéclaration, sans échange de données avec *ma cantine*.
Exemples :
* affichage des labels EGalim ;
* affichage de l'origine des produits ;
* affichage du caractère local ou circuit court ;
* export des informations sur les factures ou dans un tableau de bord.
Cette première étape facilite la préparation de la télédéclaration.
| → [Consulter la matrice des champs de télédéclaration](https://ma-cantine.crisp.help/fr/article/matrice-de-teledeclaration-2027-2hulq9/)


### Niveau 1 : Produire les données attendues
Votre solution calcule directement les montants attendus dans la télédéclaration.
Par exemple :
* total des achats Bio ;
* total des achats EGalim ;
* montants par famille de produits ;
* achats Origine France.
Le gestionnaire peut ensuite reporter ces données dans le tunnel de télédéclaration de la plateforme *ma cantine*.
| → [Consulter la matrice des champs de télédéclaration](https://ma-cantine.crisp.help/fr/article/matrice-de-teledeclaration-2027-2hulq9/)

### Niveau 2 : Générer un fichier d'import
Votre solution génère un fichier compatible avec *ma cantine*.
Deux formats sont disponibles :
* **Import Bilan**, lorsque les données sont déjà agrégées ;
* **Import Achats**, lorsque les achats sont transmis de manière détaillée.
Le gestionnaire importe ensuite ce fichier dans *ma cantine*.
| → [Fournir un fichier pret a importer dans *ma cantine*](https://ma-cantine.crisp.help/fr/article/fournir-un-fichier-pret-a-importer-dans-ma-cantine-bn14yj/)

### Niveau 3 : Utiliser les API *ma cantine* (aussi appelé "transmission automatique de donnée")
**Qu'est-ce qu'une API ?**
L'API, c'est l'outil technique qui permet d'atteindre le niveau le plus abouti d'interopérabilité : un branchement direct entre le logiciel et *ma cantine.* Une fois la connexion faite, les données peuvent circuler sur demande sans fichier à envoyer, sans ressaisie, sans intervention manuelle si ce n'est un peu de configuration initiale et la demande d'envoi. Le plus souvent la demande d'envoi s'effectue en cliquant sur un bouton directement intégrer dans l'interface destinée au gestionnaire, le logiciel de gestion ou le compte client sur le site d'un distributeur.

Deux API sont disponibles :
* **API Achats**, pour transmettre les achats détaillés ;
* **API Bilan**, pour alimenter directement la télédéclaration.
Cette intégration supprime les imports manuels et permet de préremplir automatiquement les données de télédéclaration.
| → [Consulter la documentation des API](https://ma-cantine.agriculture.gouv.fr/swagger-ui/)