Votre logiciel connaît la facture. La plateforme agréée attend un fichier Factur-X qu’elle peut router et contrôler. Entre les deux, un appel : vous envoyez les données en JSON, FacturX API renvoie un PDF Factur-X (PDF/A-3 avec son XML CII EN 16931), et vous le déposez chez SUPER PDP.
Cette page montre l’appel, ce que FacturX contrôle avant de vous rendre le fichier, et ce que SUPER PDP a fait des fichiers que nous lui avons déposés dans son bac à sable. Ce guide n’engage que FacturX API. SUPER PDP ne relit pas les documentations de tiers et ne recommande aucune offre ; nous citons ce que nous avons mesuré dans son bac à sable.
En bref
- Un appel
POST /api/v1/convertavecinvoice_data,output=facturx_pdfa3etvalidation_target=france_2026. - Avant de rendre le fichier, FacturX contrôle la norme EN 16931 puis les règles françaises. La réponse dit, règle par règle, ce qui bloque.
- Dans le bac à sable de SUPER PDP, lors de notre essai du 07/11/2026 sur 10 fichiers publics, la plateforme a rendu le même verdict que nous sur les 10, et cité les mêmes règles sur 9.
- Deux écarts connus, écrits plus bas : les codes devise (BR-CL-03/04) sur le XML CII, et le dépôt d’un XML CII brut à profil Factur-X.
1. Les champs que la plateforme lit pour router et contrôler
| Ce que contrôle la plateforme | Champ invoice_data | Terme EN 16931 |
|---|---|---|
| Identifiant légal du vendeur et de l’acheteur (SIREN, schéma 0002) | seller.siret, buyer.siret : FacturX en tire le SIREN | BT-30, BT-47 |
| Adresse électronique de routage (schéma 0225) | seller.electronic_address, buyer.electronic_address | BT-34, BT-49 |
| Mentions de paiement obligatoires en France (règle BR-FR-05) | document_notes avec subject_code PMT, PMD et AAB | BT-21, BT-22 |
| Cadre de facturation (règle BR-FR-08) | business_process, par exemple S1 | BT-23 |
| Préfixe pays du numéro de TVA vendeur (règle BR-CO-09) | seller.vat_id, par exemple FR09999991235 | BT-31 |
| Bloc livraison | delivery.same_as_buyer: true quand on livre à l’adresse de l’acheteur, avec delivery.date | BG-13, BT-72 |
Les adresses de routage de l’exemple ci-dessous sont illustratives : pour un vrai dépôt, ce sont celles de l’annuaire de la facturation électronique.
2. L’appel
FACTURX_OUTPUT='facturx_pdfa3'
FACTURX_VALIDATION_TARGET='france_2026'
FACTURX_INVOICE_DATA='{"invoice_number":"FA-2026-0117","issue_date":"2026-11-17","invoice_type":"380","currency":"EUR","business_process":"S1","document_notes":[{"subject_code":"PMT","content":"Indemnité forfaitaire pour frais de recouvrement : 40 euros."},{"subject_code":"PMD","content":"Pénalités de retard : trois fois le taux d'intérêt légal."},{"subject_code":"AAB","content":"Aucun escompte pour paiement anticipé."}],"seller":{"name":"Demo Editeur SAS","address":{"street":"10 rue de la Paix","city":"Paris","postal_code":"75002","country":"FR"},"vat_id":"FR09999991235","siret":"99999123500014","electronic_address":{"value":"FRROUTESELLER001","scheme_id":"0225"}},"buyer":{"name":"Demo Client SARL","address":{"street":"5 avenue des Champs","city":"Lyon","postal_code":"69002","country":"FR"},"vat_id":"FR83999992456","siret":"99999245600015","electronic_address":{"value":"FRROUTEBUYER001","scheme_id":"0225"}},"delivery":{"same_as_buyer":true,"date":"2026-11-17"},"totals":{"net":"1000.00","tax":"200.00","gross":"1200.00"},"tax_breakdown":[{"rate":"20","category":"S","base":"1000.00","amount":"200.00"}],"line_items":[{"number":"1","description":"Prestation logicielle","quantity":"1","unit":"C62","unit_price":"1000.00","net_amount":"1000.00","vat_rate":"20","vat_category":"S"}],"payment":{"due_date":"2026-12-17","terms":"Paiement à 30 jours"}}'
FACTURX_OPERATION_IDENTITY=$(printf '%s\0%s\0%s' \
"$FACTURX_OUTPUT" "$FACTURX_VALIDATION_TARGET" "$FACTURX_INVOICE_DATA" \
| openssl dgst -sha256 -r | awk '{print $1}')
curl -X POST https://api.facturxapi.com/api/v1/convert \
-H "X-API-Key: $FACTURX_API_KEY" \
-H "Accept-Language: fr" \
-H "Idempotency-Key: convert-$FACTURX_OPERATION_IDENTITY" \
-F "output=$FACTURX_OUTPUT" \
-F "validation_target=$FACTURX_VALIDATION_TARGET" \
-F "invoice_data=$FACTURX_INVOICE_DATA"
Cet exemple a été rejoué le 17/11/2026 sur l’API de test (build 4e746a02). Réponse :
- HTTP 200,
success: true; target.status: "verified"pour la ciblefrance_2026, profil produit EN 16931 ;- validation du fichier généré : 0 erreur, 0 avertissement. Avec le bloc livraison rempli, l’avertissement PEPPOL-EN16931-R008 (livraison vide) n’apparaît pas ;
- le même PDF, déposé sur un validateur public indépendant, y est déclaré « PDF Conforme » (profil EN 16931).
Le PDF Factur-X se trouve dans la réponse, prêt à être déposé.
3. Ce que FacturX contrôle avant de vous rendre le fichier
- EN 16931 : la sémantique européenne de la facture, contrôlée sur le XML CII par le schematron Factur-X.
- Les règles françaises (BR-FR) quand la cible est
france_2026: mentions PMT, PMD et AAB, cadre de facturation, identifiants et adresses de routage. - Si une règle bloque, la réponse le dit avec la règle et le champ en cause : vous corrigez la donnée avant de déposer.
4. Ce que SUPER PDP fait de son côté
Lors de nos essais dans son bac à sable, le 07/11/2026 :
- Un fichier généré par FacturX a été déposé. Statuts :
fr:200Déposée (validée), puisfr:203Mise à disposition ; lors de cet essai, ce dernier statut est arrivé 6 secondes après l’envoi. - Un fichier public que FacturX refuse a été rejeté : statut
fr:213, motifREJ_SEMAN, avec exactement nos 5 règles (BR-CO-09, BR-FR-05 ×3, BR-FR-08), chacune avec son chemin XPath. - 10 fichiers publics (exemples officiels FNFE et corpus CC0) : même verdict 10 fois sur 10, mêmes règles 9 fois sur 10.
Limites de cette mesure : bac à sable, une seule plateforme, 10 fichiers ; seuls les identifiants de routage ont été posés sur chaque fichier. Ce n’est pas une mesure en production.
5. Les écarts connus
Codes devise (BR-CL-03 et BR-CL-04). Dans son bac à sable, le 07/11/2026, SUPER PDP a rejeté le fichier public cii-r01-currency-stn.xml (devise « STN ») en citant BR-CL-03 et BR-CL-04. Sur un XML CII, FacturX ne remonte pas ces deux règles : vérifié en production le 17/11/2026 sur le même fichier, notre réponse ne les cite pas. Utilisez un code devise de la liste ISO 4217 en vigueur, par exemple EUR.
XML CII brut à profil Factur-X. Dans son bac à sable, le 07/11/2026, un XML CII déposé seul avec un profil Factur-X (EXTENDED, BASIC, BASIC WL) a été refusé par SUPER PDP avant tout contrôle : HTTP 400 « unknown profile for CII ». Déposez le PDF Factur-X que FacturX renvoie, ou un XML CII au profil EN 16931. Nous n’avons pas mesuré le dépôt d’un PDF Factur-X à un autre profil que EN 16931.
6. Rejets connus et correction
Les règles ci-dessous ont été citées par SUPER PDP dans son bac à sable lors de nos essais du 07/11/2026.
| Règle citée par la plateforme | Ce qui manque | Correction dans invoice_data |
|---|---|---|
| BR-CO-09 | Le numéro de TVA vendeur ne commence pas par un code pays ISO | seller.vat_id au format FR + clé + SIREN |
| BR-FR-05 (PMT, PMD, AAB) | Les mentions de paiement obligatoires | Trois document_notes avec subject_code PMT, PMD et AAB |
| BR-FR-08 | Le cadre de facturation | business_process, par exemple S1 |
| BR-FR-09 | Un SIRET (BT-29) qui ne correspond pas au SIREN de l’entreprise | Un seller.siret dont les 9 premiers chiffres sont le SIREN du vendeur |
Bloc livraison (PEPPOL-EN16931-R008). FacturX signale un bloc livraison vide en avertissement. Dans le bac à sable de SUPER PDP, lors de deux dépôts, le 07/11/2026 et le 17/11/2026, un fichier qui portait cet avertissement a été accepté ; lors du dépôt du 17/11/2026, l’avertissement était affiché. D’autres validateurs comptent R008 comme une erreur : pour n’avoir aucun avertissement, remplissez le bloc livraison, avec delivery.same_as_buyer: true et delivery.date quand vous livrez à l’adresse de l’acheteur, ou delivery.address.
Étape suivante recommandée
Vous préparez des factures à déposer chez SUPER PDP.
Voici ce que vous allez obtenir :
- Tester un fichier existant sur /scan
- Repérer la règle en cause et le champ à corriger
- Rejouer l'appel avec votre propre JSON