---
title: "Intégration — API REST et outils MCP pour la conformité des factures"
description: "Une requête POST pour contrôler une facture avant dépôt : schéma JSON canonique, codes d'anomalie stables, paquet de preuves. Les mêmes opérations disponibles comme outils MCP."
canonical: https://validationfacture.fr/integration
---

# Intégration

Une API REST, et les mêmes opérations exposées comme outils MCP pour les agents. Un seul format d'entrée : le JSON canonique, sous-ensemble strict du modèle sémantique EN 16931, où chaque champ porte son terme métier (BT-/BG-).

## Contrôler une facture

```bash
curl -s https://api.validationfacture.fr/v1/validate \
  -H "Authorization: Bearer $CLE_API" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: F2026-0142" \
  -d '{"invoice": { … }}'
```

La réponse contient le verdict, la liste des anomalies et un paquet de preuves : empreinte de l'entrée, empreintes des sorties, version du référentiel et signature. Branchez votre traitement sur `code`, jamais sur `message` : un code ne change pas de signification.

## Boucle d'intégration recommandée

1. Appelez `validate_invoice` d'abord.
2. Si toutes les anomalies sont réparables, appelez `repair_invoice`.
3. Sinon, remontez-les à un humain : le service refuse de deviner une donnée absente.
4. Appelez `convert_invoice` pour produire Factur-X, UBL ou CII.
5. En cas de rejet, appelez `explain_rejection` avec le code et la facture.

## Les mêmes opérations en MCP

Un verdict obtenu en MCP est identique à un verdict REST et porte le même paquet de preuves : c'est le même moteur, exposé sur deux transports.