Intégration

Générer un Factur-X pour SUPER PDP : appel API et rejets connus

5 min de lecture Par FacturX API

Un appel JSON produit le PDF Factur-X à déposer chez SUPER PDP : champs de routage, contrôles avant envoi, rejets mesurés dans son bac à sable, écarts connus.

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/convert avec invoice_data, output=facturx_pdfa3 et validation_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 plateformeChamp invoice_dataTerme EN 16931
Identifiant légal du vendeur et de l’acheteur (SIREN, schéma 0002)seller.siret, buyer.siret : FacturX en tire le SIRENBT-30, BT-47
Adresse électronique de routage (schéma 0225)seller.electronic_address, buyer.electronic_addressBT-34, BT-49
Mentions de paiement obligatoires en France (règle BR-FR-05)document_notes avec subject_code PMT, PMD et AABBT-21, BT-22
Cadre de facturation (règle BR-FR-08)business_process, par exemple S1BT-23
Préfixe pays du numéro de TVA vendeur (règle BR-CO-09)seller.vat_id, par exemple FR09999991235BT-31
Bloc livraisondelivery.same_as_buyer: true quand on livre à l’adresse de l’acheteur, avec delivery.dateBG-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 cible france_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:200 Déposée (validée), puis fr:203 Mise à 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, motif REJ_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 plateformeCe qui manqueCorrection dans invoice_data
BR-CO-09Le numéro de TVA vendeur ne commence pas par un code pays ISOseller.vat_id au format FR + clé + SIREN
BR-FR-05 (PMT, PMD, AAB)Les mentions de paiement obligatoiresTrois document_notes avec subject_code PMT, PMD et AAB
BR-FR-08Le cadre de facturationbusiness_process, par exemple S1
BR-FR-09Un SIRET (BT-29) qui ne correspond pas au SIREN de l’entrepriseUn 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
#SUPER PDP #plateforme agréée #factur-x #EN16931 #BR-FR #routage #API