Lire une facture reçue en JSON

POST /v1/parse prend un PDF Factur-X, un XML CII ou un XML UBL 2.1. La réponse donne la facture selon le modèle sémantique EN 16931 et le résultat de sa validation.

Ce que fait `/v1/parse`

Il détecte le format et le profil, puis valide le fichier avec les mêmes règles que /v1/validate. Le champ source résume ce résultat.
Chaque champ correspond à un terme (BT) ou à un groupe (BG) de la norme. La lecture suit les correspondances syntaxiques officielles : CII, UBL et PDF Factur-X donnent la même structure.
Tous les champs sont présents : null ou [] quand la facture ne les porte pas.
Montants, quantités et taux sont des chaînes décimales recopiées telles qu'écrites. Les dates sont en ISO 8601.
Les documents justificatifs (BG-24) et les fichiers joints au PDF arrivent dans attachments, contenu en base64.
Une clé d'API est requise. Chaque lecture compte dans le quota du mois : la clé gratuite donne 100 appels par mois.

Recepto ne transmet ni ne reçoit de factures : il lit le fichier envoyé dans la requête, puis l'oublie.

Modèle de sortie, version 1.0

Schéma JSON publié : /v1/schemas/invoice-1.0.json. Une version 1.x n'ajoute que des champs ; renommer, retirer ou retyper un champ donne une version 2. Après schema_version, la réponse contient les groupes ci-dessous. Chaque description est celle du schéma.

`source`

Champ	Description
`format`	Format du fichier lu.
`profile`	Profil reconnu.
`profile_id`	BT-24 Identifiant de spécification lu.
`valid`	Résultat de POST /v1/validate sur le même fichier.
`errors`	Nombre de règles officielles en erreur.
`warnings`	Nombre d'avertissements.

`invoice`

Champ	Description
`number`	BT-1 Numéro de facture.
`type_code`	BT-3 Type de facture (UNTDID 1001, ex. 380 facture, 381 avoir).
`issue_date`	BT-2 Date d'émission.
`due_date`	BT-9 Date d'échéance.
`tax_point_date`	BT-7 Date d'exigibilité de la TVA.
`vat_point_date_code`	BT-8 Exigibilité de la TVA en code, tel qu'écrit : UNTDID 2005 en CII, 2475 en UBL.
`currency`	BT-5 Devise de la facture (ISO 4217).
`tax_currency`	BT-6 Devise de comptabilisation de la TVA.
`buyer_reference`	BT-10 Référence de l'acheteur.
`buyer_accounting_reference`	BT-19 Référence comptable de l'acheteur.
`payment_terms`	BT-20 Conditions de paiement.
`process_id`	BT-23 Type de processus métier.
`specification_id`	BT-24 Identifiant de spécification (profil).
`notes`	BG-1 Notes.
`billing_period`	BG-14 Période de facturation (BT-73, BT-74).
`references`	Références.
`seller`	BG-4 Vendeur.
`buyer`	BG-7 Acheteur.
`payee`	BG-10 Bénéficiaire du paiement.
`tax_representative`	BG-11 Représentant fiscal du vendeur.
`delivery`	BG-13 Livraison.
`payment`	BG-16 Instructions de paiement.
`allowances`	BG-20 Remises au niveau du document.
`charges`	BG-21 Frais au niveau du document.
`totals`	BG-22 Totaux.
`vat_breakdown`	BG-23 Ventilation de la TVA par catégorie et taux.
`lines`	BG-25 Lignes.

`attachments[]`

Champ	Description
`source`	invoice : document justificatif BG-24 du XML ; pdf : fichier joint au PDF.
`id`	BT-122 Référence du document justificatif.
`description`	BT-123 Description.
`external_uri`	BT-124 Adresse externe du document.
`filename`	BT-125-2 Nom du fichier.
`mime_type`	BT-125-1 Type MIME.
`size`	Taille du contenu décodé, en octets.
`content_base64`	BT-125 Contenu, encodé en base64.

Exemple complet

Entrée : la facture UC1 des exemples officiels de la réforme française (FNFE-MPE, France_RFE 1.4.0.04, licence Apache 2.0), en CII, profil EN 16931. Sortie : la réponse de l'API pour ce fichier, calculée au démarrage du service par le code qui répond à /v1/parse.

Entrée : XML CII de l'exemple UC1 de la FNFE-MPE, profil EN 16931

<?xml version='1.0' encoding='UTF-8'?>
<rsm:CrossIndustryInvoice xmlns:qdt="urn:un:unece:uncefact:data:standard:QualifiedDataType:100"
xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100"
xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100"
xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
     <rsm:ExchangedDocumentContext>
          <ram:BusinessProcessSpecifiedDocumentContextParameter>
               <ram:ID>S1</ram:ID>  <!-- BT-23 (Identifiant de type de processus métier) : S1 -->
          </ram:BusinessProcessSpecifiedDocumentContextParameter>
          <ram:GuidelineSpecifiedDocumentContextParameter>
               <ram:ID>urn:cen.eu:en16931:2017</ram:ID>  <!-- BT-24 (Identification de spécification) : urn:cen.eu:en16931:2017 -->
          </ram:GuidelineSpecifiedDocumentContextParameter>
     </rsm:ExchangedDocumentContext>
     <rsm:ExchangedDocument>
          <ram:ID>F202500003</ram:ID>  <!-- BT-1 (Numéro de facture) : F202500003 -->
          <ram:TypeCode>380</ram:TypeCode>  <!-- BT-3 (Type de facture en code) : 380 -->
          <ram:IssueDateTime>
               <udt:DateTimeString format="102">20250701</udt:DateTimeString>  <!-- BT-2 (Date d'émission de la facture) : 20250701 -->
          </ram:IssueDateTime>
          <ram:IncludedNote>
               <ram:Content>VENDEUR SARL au capital de 50 000 EUR</ram:Content>  <!-- BT-22 (Note de facture) : VENDEUR SARL au capital de 50 000 EUR -->
               <ram:SubjectCode>REG</ram:SubjectCode>  <!-- BT-21 (Sujet de la note de facture en code) : REG -->
          </ram:IncludedNote>
          <ram:IncludedNote>
               <ram:Content>RCS MAVILLE 100 000 009</ram:Content>  <!-- BT-22 (Note de facture) : RCS MAVILLE 100 000 009 -->
               <ram:SubjectCode>ABL</ram:SubjectCode>  <!-- BT-21 (Sujet de la note de facture en code) : ABL -->
          </ram:IncludedNote>
          <ram:IncludedNote>
               <ram:Content>35 ma rue a moi,75018 PARIS, FR – contact@vendeur.fr - www.levendeur.fr  – N° TVA : FR88 100 000 009</ram:Content>  <!-- BT-22 (Note de facture) : 35 ma rue a moi,75018 PARIS, FR – contact@vendeur.fr - www.levendeur.fr  – N° TVA : FR88 100 000 009 -->
               <ram:SubjectCode>AAI</ram:SubjectCode>  <!-- BT-21 (Sujet de la note de facture en code) : AAI -->
          </ram:IncludedNote>
          <ram:IncludedNote>
               <ram:Content>Tout retard de paiement engendre une pénalité exigible à compter de la date d'échéance, calculée sur la base de trois fois le taux d'intérêt légal. </ram:Content>  <!-- BT-22 (Note de facture) : Tout retard de paiement engendre une pénalité exigible à compter de la date d'échéance, calculée sur la base de trois fois le taux d'intérêt légal.  -->
               <ram:SubjectCode>PMD</ram:SubjectCode>  <!-- BT-21 (Sujet de la note de facture en code) : PMD -->
          </ram:IncludedNote>
          <ram:IncludedNote>
               <ram:Content>Indemnité forfaitaire pour frais de recouvrement en cas de retard de paiement : 40 €.</ram:Content>  <!-- BT-22 (Note de facture) : Indemnité forfaitaire pour frais de recouvrement en cas de retard de paiement : 40 €. -->
               <ram:SubjectCode>PMT</ram:SubjectCode>  <!-- BT-21 (Sujet de la note de facture en code) : PMT -->
          </ram:IncludedNote>
          <ram:IncludedNote>
               <ram:Content>Les réglements reçus avant la date d'échéance ne donneront pas lieu à escompte.</ram:Content>  <!-- BT-22 (Note de facture) : Les réglements reçus avant la date d'échéance ne donneront pas lieu à escompte. -->
               <ram:SubjectCode>AAB</ram:SubjectCode>  <!-- BT-21 (Sujet de la note de facture en code) : AAB -->
          </ram:IncludedNote>
     </rsm:ExchangedDocument>
     <rsm:SupplyChainTradeTransaction>
          <ram:IncludedSupplyChainTradeLineItem>
               <ram:AssociatedDocumentLineDocument>
                    <ram:LineID>1</ram:LineID>  <!-- BT-126 (Identifiant de ligne de facture) : 1 -->
               </ram:AssociatedDocumentLineDocument>
               <ram:SpecifiedTradeProduct>
                    <ram:Name>SERVICE_FOURNI1</ram:Name>  <!-- BT-153 (Nom de l'article) : SERVICE_FOURNI1 -->
                    <ram:Description>Description</ram:Description>  <!-- BT-154 (Description de l'article) : Description -->
               </ram:SpecifiedTradeProduct>
               <ram:SpecifiedLineTradeAgreement>
                     <ram:GrossPriceProductTradePrice>
                         <ram:ChargeAmount>40.0000</ram:ChargeAmount>  <!-- BT-148 (Prix brut de l'article) : 40.0000 -->
                         <ram:BasisQuantity unitCode="HUR">1.0000</ram:BasisQuantity>  <!-- BT-149 (Quantité de base du prix de l'article) : 1.0000 -->
                     </ram:GrossPriceProductTradePrice>
                    <ram:NetPriceProductTradePrice>
                         <ram:ChargeAmount>40.0000</ram:ChargeAmount>  <!-- BT-146 (Prix net de l'article) : 40.0000 -->
                         <ram:BasisQuantity unitCode="HUR">1.0000</ram:BasisQuantity>  <!-- BT-149 (Quantité de base du prix de l'article) : 1.0000 -->
                    </ram:NetPriceProductTradePrice>
               </ram:SpecifiedLineTradeAgreement>
               <ram:SpecifiedLineTradeDelivery>
                    <ram:BilledQuantity unitCode="HUR">200.0000</ram:BilledQuantity>  <!-- BT-129 (Quantité facturée) : 200.0000 -->
               </ram:SpecifiedLineTradeDelivery>
               <ram:SpecifiedLineTradeSettlement>
                    <ram:ApplicableTradeTax>
                         <ram:TypeCode>VAT</ram:TypeCode>  <!-- BT-151-0 (Type Taxe en code) : VAT -->
                         <ram:CategoryCode>S</ram:CategoryCode>  <!-- BT-151 (Code de type de TVA de l'article facturé) : S -->
                         <ram:RateApplicablePercent>20.00</ram:RateApplicablePercent>  <!-- BT-152 (Taux de TVA de l'article facturé) : 20.00 -->
                    </ram:ApplicableTradeTax>
                    <ram:SpecifiedTradeSettlementLineMonetarySummation>
                         <ram:LineTotalAmount>8000.00</ram:LineTotalAmount>  <!-- BT-131 (Montant net de ligne de facture) : 8000.00 -->
                    </ram:SpecifiedTradeSettlementLineMonetarySummation>
               </ram:SpecifiedLineTradeSettlement>
          </ram:IncludedSupplyChainTradeLineItem>
          <ram:IncludedSupplyChainTradeLineItem>
               <ram:AssociatedDocumentLineDocument>
                    <ram:LineID>2</ram:LineID>  <!-- BT-126 (Identifiant de ligne de facture) : 2 -->
               </ram:AssociatedDocumentLineDocument>
               <ram:SpecifiedTradeProduct>
                    <ram:Name>SERVICE_FOURNI2</ram:Name>  <!-- BT-153 (Nom de l'article) : SERVICE_FOURNI2 -->
                    <ram:Description>Description</ram:Description>  <!-- BT-154 (Description de l'article) : Description -->
               </ram:SpecifiedTradeProduct>
               <ram:SpecifiedLineTradeAgreement>
                     <ram:GrossPriceProductTradePrice>
                         <ram:ChargeAmount>400.0000</ram:ChargeAmount>  <!-- BT-148 (Prix brut de l'article) : 400.0000 -->
                         <ram:BasisQuantity unitCode="DAY">1.0000</ram:BasisQuantity>  <!-- BT-149 (Quantité de base du prix de l'article) : 1.0000 -->
                     </ram:GrossPriceProductTradePrice>
                    <ram:NetPriceProductTradePrice>
                         <ram:ChargeAmount>400.0000</ram:ChargeAmount>  <!-- BT-146 (Prix net de l'article) : 400.0000 -->
                         <ram:BasisQuantity unitCode="DAY">1.0000</ram:BasisQuantity>  <!-- BT-149 (Quantité de base du prix de l'article) : 1.0000 -->
                    </ram:NetPriceProductTradePrice>
               </ram:SpecifiedLineTradeAgreement>
               <ram:SpecifiedLineTradeDelivery>
                    <ram:BilledQuantity unitCode="DAY">5.0000</ram:BilledQuantity>  <!-- BT-129 (Quantité facturée) : 5.0000 -->
               </ram:SpecifiedLineTradeDelivery>
               <ram:SpecifiedLineTradeSettlement>
                    <ram:ApplicableTradeTax>
                         <ram:TypeCode>VAT</ram:TypeCode>  <!-- BT-151-0 (Type Taxe en code) : VAT -->
                         <ram:CategoryCode>S</ram:CategoryCode>  <!-- BT-151 (Code de type de TVA de l'article facturé) : S -->
                         <ram:RateApplicablePercent>20.00</ram:RateApplicablePercent>  <!-- BT-152 (Taux de TVA de l'article facturé) : 20.00 -->
                    </ram:ApplicableTradeTax>
                    <ram:SpecifiedTradeSettlementLineMonetarySummation>
                         <ram:LineTotalAmount>2000.00</ram:LineTotalAmount>  <!-- BT-131 (Montant net de ligne de facture) : 2000.00 -->
                    </ram:SpecifiedTradeSettlementLineMonetarySummation>
               </ram:SpecifiedLineTradeSettlement>
          </ram:IncludedSupplyChainTradeLineItem>
          <ram:ApplicableHeaderTradeAgreement>
               <ram:BuyerReference>BU_2516</ram:BuyerReference>  <!-- BT-10 (Référence de l’acheteur) : BU_2516 -->
               <ram:SellerTradeParty>
                    <ram:GlobalID schemeID="0088">587451236587</ram:GlobalID>  <!-- BT-29-0 (Identifiant du vendeur (Global ID)) : 587451236587 -->
                    <ram:Name>LE VENDEUR</ram:Name>  <!-- BT-27 (Raison sociale du vendeur) : LE VENDEUR -->
                    <ram:Description>SARL AU CAPITAL DE 50 000 EUROS</ram:Description>  <!-- BT-33 (Informations juridiques additionnelles sur le vendeur) : SARL AU CAPITAL DE 50 000 EUROS -->
                    <ram:SpecifiedLegalOrganization>
                         <ram:ID schemeID="0002">100000009</ram:ID>  <!-- BT-30 (Identifiant d’enregistrement légal du vendeur) : 100000009 -->
                         <ram:TradingBusinessName>VENDEUR NOM COMMERCIAL</ram:TradingBusinessName>  <!-- BT-28 (Appellation commerciale du vendeur) : VENDEUR NOM COMMERCIAL -->
                    </ram:SpecifiedLegalOrganization>
                    <ram:DefinedTradeContact>
                         <ram:DepartmentName>DEP ADV</ram:DepartmentName>  <!-- BT-41-0 (Point de contact vendeur) : DEP ADV -->
                         <ram:TelephoneUniversalCommunication>
                              <ram:CompleteNumber>01 02 03 54 87</ram:CompleteNumber>  <!-- BT-42 (Numéro de téléphone du contact vendeur) : 01 02 03 54 87 -->
                         </ram:TelephoneUniversalCommunication>
                         <ram:EmailURIUniversalCommunication>
                              <ram:URIID>contact@vendeur.fr</ram:URIID>  <!-- BT-43 (Adresse électronique du contact vendeur) : contact@vendeur.fr -->
                         </ram:EmailURIUniversalCommunication>
                    </ram:DefinedTradeContact>
                    <ram:PostalTradeAddress>
                         <ram:PostcodeCode>75018</ram:PostcodeCode>  <!-- BT-38 (Code postal du vendeur) : 75018 -->
                         <ram:LineOne>35 rue d'ici</ram:LineOne>  <!-- BT-35 (Adresse du vendeur - Ligne 1) : 35 rue d'ici -->
                         <ram:LineTwo>ligne 2 vendeur</ram:LineTwo>  <!-- BT-36 (Adresse du vendeur - Ligne 2) : ligne 2 vendeur -->
                         <ram:CityName>PARIS</ram:CityName>  <!-- BT-37 (Localité du vendeur) : PARIS -->
                         <ram:CountryID>FR</ram:CountryID>  <!-- BT-40 (Code de pays du vendeur) : FR -->
                    </ram:PostalTradeAddress>
                    <ram:URIUniversalCommunication>
                         <ram:URIID schemeID="0225">100000009_STATUTS</ram:URIID>  <!-- BT-34 (Adresse électronique du vendeur ) : 100000009_STATUTS -->
                    </ram:URIUniversalCommunication>
                    <ram:SpecifiedTaxRegistration>
                         <ram:ID schemeID="VA">FR88100000009</ram:ID>  <!-- BT-31 (Identifiant à la TVA du vendeur) : FR88100000009 -->
                    </ram:SpecifiedTaxRegistration>
               </ram:SellerTradeParty>
               <ram:BuyerTradeParty>
                    <ram:GlobalID schemeID="0088">3654789851</ram:GlobalID>  <!-- BT-46-0 (Identifiant de l'acheteur (GlobalID)) : 3654789851 -->
                    <ram:Name>LE CLIENT</ram:Name>  <!-- BT-44 (Raison sociale de l'acheteur) : LE CLIENT -->
                    <ram:SpecifiedLegalOrganization>
                         <ram:ID schemeID="0002">200000008</ram:ID>  <!-- BT-47 (Identifiant d’enregistrement  légal de l'acheteur) : 200000008 -->
                    </ram:SpecifiedLegalOrganization>
                    <ram:DefinedTradeContact>
                         <ram:DepartmentName>DEP COMPTAFOUR</ram:DepartmentName>  <!-- BT-56-0 (0) : DEP COMPTAFOUR -->
                         <ram:TelephoneUniversalCommunication>
                              <ram:CompleteNumber>01 01 25 45 87</ram:CompleteNumber>  <!-- BT-57 (Numéro de téléphone du contact acheteur) : 01 01 25 45 87 -->
                         </ram:TelephoneUniversalCommunication>
                         <ram:EmailURIUniversalCommunication>
                              <ram:URIID>contact@acheteur.fr</ram:URIID>  <!-- BT-58 (Adresse électronique du contact acheteur) : contact@acheteur.fr -->
                         </ram:EmailURIUniversalCommunication>
                    </ram:DefinedTradeContact>
                    <ram:PostalTradeAddress>
                         <ram:PostcodeCode>06000</ram:PostcodeCode>  <!-- BT-53 (Code postal de l'acheteur) : 06000 -->
                         <ram:LineOne>55 avenue de là-bas</ram:LineOne>  <!-- BT-50 (Adresse de l'acheteur - Ligne 1) : 55 avenue de là-bas -->
                         <ram:LineTwo>acheteur ligne 2</ram:LineTwo>  <!-- BT-51 (Adresse de l'acheteur - Ligne 2) : acheteur ligne 2 -->
                         <ram:CityName>MA VILLE</ram:CityName>  <!-- BT-52 (Localité de l'acheteur) : MA VILLE -->
                         <ram:CountryID>FR</ram:CountryID>  <!-- BT-55 (Code de pays de l'acheteur) : FR -->
                    </ram:PostalTradeAddress>
                    <ram:URIUniversalCommunication>
                         <ram:URIID schemeID="0225">200000008</ram:URIID>  <!-- BT-49 (Adresse électronique de l'acheteur) : 200000008 -->
                    </ram:URIUniversalCommunication>
                    <ram:SpecifiedTaxRegistration>
                         <ram:ID schemeID="VA">FR37200000008</ram:ID>  <!-- BT-48 (Identifiant à la TVA de l'acheteur) : FR37200000008 -->
                    </ram:SpecifiedTaxRegistration>
               </ram:BuyerTradeParty>
               <ram:SellerOrderReferencedDocument>
                    <ram:IssuerAssignedID>SO20255874</ram:IssuerAssignedID>  <!-- BT-14 (Identifiant d'un bon de commande de vente) : SO20255874 -->
               </ram:SellerOrderReferencedDocument>
               <ram:BuyerOrderReferencedDocument>
                    <ram:IssuerAssignedID>PO202525478</ram:IssuerAssignedID>  <!-- BT-13 (Identifiant de bon de commande) : PO202525478 -->
               </ram:BuyerOrderReferencedDocument>
               <ram:AdditionalReferencedDocument>
                    <ram:IssuerAssignedID>REF_CLIENT2514</ram:IssuerAssignedID>  <!-- BT-18 (Identifiant d'objet facturé) : REF_CLIENT2514 -->
                    <ram:TypeCode>130</ram:TypeCode>  <!-- BT-18-0 (Code type (130)) : 130 -->
                    <ram:ReferenceTypeCode>IT</ram:ReferenceTypeCode>  <!-- BT-18-1 (Identifiant du schéma) : IT -->
               </ram:AdditionalReferencedDocument>
          </ram:ApplicableHeaderTradeAgreement>
          <ram:ApplicableHeaderTradeDelivery>
               <ram:ShipToTradeParty>
                    <ram:Name>NOUS AUSSI</ram:Name>  <!-- BT-70 (Nom de l’intervenant à livrer) : NOUS AUSSI -->
                    <ram:PostalTradeAddress>
                         <ram:PostcodeCode>06000</ram:PostcodeCode>  <!-- BT-78 (Code postal de livraison) : 06000 -->
                         <ram:LineOne>12 impasse plus loin</ram:LineOne>  <!-- BT-75 (Adresse de livraison - Ligne 1) : 12 impasse plus loin -->
                         <ram:LineTwo>livré à ligne 2</ram:LineTwo>  <!-- BT-76 (Adresse de livraison - Ligne 2) : livré à ligne 2 -->
                         <ram:CityName>MA VILLE</ram:CityName>  <!-- BT-77 (Localité de livraison) : MA VILLE -->
                         <ram:CountryID>FR</ram:CountryID>  <!-- BT-80 (Code du pays de livraison) : FR -->
                    </ram:PostalTradeAddress>
               </ram:ShipToTradeParty>
          </ram:ApplicableHeaderTradeDelivery>
          <ram:ApplicableHeaderTradeSettlement>
               <ram:PaymentReference>F202500003_200000008</ram:PaymentReference>  <!-- BT-83 (Référence End to End de paiement) : F202500003_200000008 -->
               <ram:InvoiceCurrencyCode>EUR</ram:InvoiceCurrencyCode>  <!-- BT-5 (Code de devise de facturation) : EUR -->
               <ram:SpecifiedTradeSettlementPaymentMeans>
                    <ram:TypeCode>30</ram:TypeCode>  <!-- BT-81 (Code de type de moyen de paiement) : 30 -->
                    <ram:Information>Virement</ram:Information>  <!-- BT-82 (Libellé du moyen de paiement) : Virement -->
                    <ram:PayeePartyCreditorFinancialAccount>
                         <ram:IBANID>FR20 1254 2547 2569 8542 5874 698</ram:IBANID>  <!-- BT-84 (Identifiant (IBAN) du compte bancaire du bénéficiaire) : FR20 1254 2547 2569 8542 5874 698 -->
                         <ram:AccountName>MON COMPTE BANCAIRE</ram:AccountName>  <!-- BT-85 (Nom du compte bancaire du bénéficiaire) : MON COMPTE BANCAIRE -->
                    </ram:PayeePartyCreditorFinancialAccount>
                    <ram:PayeeSpecifiedCreditorFinancialInstitution>
                         <ram:BICID>BIC_MONCOMPTE</ram:BICID>  <!-- BT-86 (Identifiant d'établissement financier du compte bénéficiaire) : BIC_MONCOMPTE -->
                    </ram:PayeeSpecifiedCreditorFinancialInstitution>
               </ram:SpecifiedTradeSettlementPaymentMeans>
               <ram:ApplicableTradeTax>
                    <ram:CalculatedAmount>2000.00</ram:CalculatedAmount>  <!-- BT-117 (Montant de la taxe pour le type de TVA) : 2000.00 -->
                    <ram:TypeCode>VAT</ram:TypeCode>  <!-- BT-118-0 (Code de type de TVACode type de Taxe (VAT)) : VAT -->
                    <ram:BasisAmount>10000.00</ram:BasisAmount>  <!-- BT-116 (Base d'imposition du type de TVA) : 10000.00 -->
                    <ram:CategoryCode>S</ram:CategoryCode>  <!-- BT-118 (Code de type de TVA) : S -->
                    <ram:DueDateTypeCode>72</ram:DueDateTypeCode>  <!-- BT-8 (Date d'exigibilité de la taxe sur la valeur ajoutée en code) : 72 -->
                    <ram:RateApplicablePercent>20.00</ram:RateApplicablePercent>  <!-- BT-119 (Taux de type de TVA) : 20.00 -->
               </ram:ApplicableTradeTax>
               <ram:BillingSpecifiedPeriod>
                    <ram:StartDateTime>
                         <udt:DateTimeString format="102">20250601</udt:DateTimeString>  <!-- BT-73 (Date de début de période de facturation) : 20250601 -->
                    </ram:StartDateTime>
                    <ram:EndDateTime>
                         <udt:DateTimeString format="102">20250630</udt:DateTimeString>  <!-- BT-74 (Date de fin de période de facturation) : 20250630 -->
                    </ram:EndDateTime>
               </ram:BillingSpecifiedPeriod>
               <ram:SpecifiedTradePaymentTerms>
                    <ram:Description>PAIEMENT 30 JOURS NET</ram:Description>  <!-- BT-20 (Conditions de paiement) : PAIEMENT 30 JOURS NET -->
                    <ram:DueDateDateTime>
                         <udt:DateTimeString format="102">20250731</udt:DateTimeString>  <!-- BT-9 (Date d'échéance) : 20250731 -->
                    </ram:DueDateDateTime>
               </ram:SpecifiedTradePaymentTerms>
               <ram:SpecifiedTradeSettlementHeaderMonetarySummation>
                    <ram:LineTotalAmount>10000.00</ram:LineTotalAmount>  <!-- BT-106 (Somme du montant net des lignes de facture) : 10000.00 -->
                    <ram:ChargeTotalAmount>0.00</ram:ChargeTotalAmount>  <!-- BT-108 (Somme des charges ou frais au niveau du document) : 0.00 -->
                    <ram:AllowanceTotalAmount>0.00</ram:AllowanceTotalAmount>  <!-- BT-107 (Somme des remises au niveau du document) : 0.00 -->
                    <ram:TaxBasisTotalAmount>10000.00</ram:TaxBasisTotalAmount>  <!-- BT-109 (Montant total de la facture hors TVA) : 10000.00 -->
                    <ram:TaxTotalAmount currencyID="EUR">2000.00</ram:TaxTotalAmount>  <!-- BT-110 (Montant total de TVA) : 2000.00 -->
                    <ram:GrandTotalAmount>12000.00</ram:GrandTotalAmount>  <!-- BT-112 (Montant total de la facture avec TVA comprise) : 12000.00 -->
                    <ram:TotalPrepaidAmount>0.00</ram:TotalPrepaidAmount>  <!-- BT-113 (Montant payé) : 0.00 -->
                    <ram:DuePayableAmount>12000.00</ram:DuePayableAmount>  <!-- BT-115 (Montant à payer) : 12000.00 -->
               </ram:SpecifiedTradeSettlementHeaderMonetarySummation>
               <ram:ReceivableSpecifiedTradeAccountingAccount>
                    <ram:ID>REF COMPTABLE ACHETEUR</ram:ID>  <!-- BT-19 (Référence comptable de l'acheteur) : REF COMPTABLE ACHETEUR -->
               </ram:ReceivableSpecifiedTradeAccountingAccount>
          </ram:ApplicableHeaderTradeSettlement>
     </rsm:SupplyChainTradeTransaction>
</rsm:CrossIndustryInvoice>

Sortie : réponse de POST /v1/parse

{
  "schema_version": "1.0",
  "source": {
    "format": "cii",
    "profile": "EN 16931",
    "profile_id": "urn:cen.eu:en16931:2017",
    "valid": true,
    "errors": 0,
    "warnings": 0
  },
  "invoice": {
    "number": "F202500003",
    "type_code": "380",
    "issue_date": "2025-07-01",
    "due_date": "2025-07-31",
    "tax_point_date": null,
    "vat_point_date_code": "72",
    "currency": "EUR",
    "tax_currency": null,
    "buyer_reference": "BU_2516",
    "buyer_accounting_reference": "REF COMPTABLE ACHETEUR",
    "payment_terms": "PAIEMENT 30 JOURS NET",
    "process_id": "S1",
    "specification_id": "urn:cen.eu:en16931:2017",
    "notes": [
      {
        "subject_code": "REG",
        "text": "VENDEUR SARL au capital de 50 000 EUR"
      },
      {
        "subject_code": "ABL",
        "text": "RCS MAVILLE 100 000 009"
      },
      {
        "subject_code": "AAI",
        "text": "35 ma rue a moi,75018 PARIS, FR – contact@vendeur.fr - www.levendeur.fr  – N° TVA : FR88 100 000 009"
      },
      {
        "subject_code": "PMD",
        "text": "Tout retard de paiement engendre une pénalité exigible à compter de la date d'échéance, calculée sur la base de trois fois le taux d'intérêt légal."
      },
      {
        "subject_code": "PMT",
        "text": "Indemnité forfaitaire pour frais de recouvrement en cas de retard de paiement : 40 €."
      },
      {
        "subject_code": "AAB",
        "text": "Les réglements reçus avant la date d'échéance ne donneront pas lieu à escompte."
      }
    ],
    "billing_period": {
      "start": "2025-06-01",
      "end": "2025-06-30"
    },
    "references": {
      "project": null,
      "contract": null,
      "purchase_order": "PO202525478",
      "sales_order": "SO20255874",
      "receiving_advice": null,
      "despatch_advice": null,
      "tender": null,
      "invoiced_object": {
        "value": "REF_CLIENT2514",
        "scheme": "IT"
      },
      "preceding_invoices": []
    },
    "seller": {
      "name": "LE VENDEUR",
      "trading_name": "VENDEUR NOM COMMERCIAL",
      "identifiers": [
        {
          "value": "587451236587",
          "scheme": "0088"
        }
      ],
      "legal_registration": {
        "value": "100000009",
        "scheme": "0002"
      },
      "vat_id": "FR88100000009",
      "tax_registration": null,
      "additional_legal_info": "SARL AU CAPITAL DE 50 000 EUROS",
      "electronic_address": {
        "value": "100000009_STATUTS",
        "scheme": "0225"
      },
      "address": {
        "line1": "35 rue d'ici",
        "line2": "ligne 2 vendeur",
        "line3": null,
        "city": "PARIS",
        "postal_code": "75018",
        "subdivision": null,
        "country": "FR"
      },
      "contact": {
        "name": null,
        "department": "DEP ADV",
        "phone": "01 02 03 54 87",
        "email": "contact@vendeur.fr"
      }
    },
    "buyer": {
      "name": "LE CLIENT",
      "trading_name": null,
      "identifiers": [
        {
          "value": "3654789851",
          "scheme": "0088"
        }
      ],
      "legal_registration": {
        "value": "200000008",
        "scheme": "0002"
      },
      "vat_id": "FR37200000008",
      "tax_registration": null,
      "additional_legal_info": null,
      "electronic_address": {
        "value": "200000008",
        "scheme": "0225"
      },
      "address": {
        "line1": "55 avenue de là-bas",
        "line2": "acheteur ligne 2",
        "line3": null,
        "city": "MA VILLE",
        "postal_code": "06000",
        "subdivision": null,
        "country": "FR"
      },
      "contact": {
        "name": null,
        "department": "DEP COMPTAFOUR",
        "phone": "01 01 25 45 87",
        "email": "contact@acheteur.fr"
      }
    },
    "payee": null,
    "tax_representative": null,
    "delivery": {
      "party_name": "NOUS AUSSI",
      "location_id": null,
      "date": null,
      "address": {
        "line1": "12 impasse plus loin",
        "line2": "livré à ligne 2",
        "line3": null,
        "city": "MA VILLE",
        "postal_code": "06000",
        "subdivision": null,
        "country": "FR"
      }
    },
    "payment": {
      "means_code": "30",
      "means_text": "Virement",
      "remittance_information": "F202500003_200000008",
      "credit_transfers": [
        {
          "account_id": "FR20 1254 2547 2569 8542 5874 698",
          "account_name": "MON COMPTE BANCAIRE",
          "service_provider_id": "BIC_MONCOMPTE"
        }
      ],
      "card": null,
      "direct_debit": null
    },
    "allowances": [],
    "charges": [],
    "totals": {
      "line_net": "10000.00",
      "allowances": "0.00",
      "charges": "0.00",
      "tax_exclusive": "10000.00",
      "vat": "2000.00",
      "vat_in_tax_currency": null,
      "tax_inclusive": "12000.00",
      "prepaid": "0.00",
      "rounding": null,
      "due": "12000.00"
    },
    "vat_breakdown": [
      {
        "taxable_amount": "10000.00",
        "tax_amount": "2000.00",
        "category": "S",
        "rate": "20.00",
        "exemption_reason": null,
        "exemption_reason_code": null
      }
    ],
    "lines": [
      {
        "id": "1",
        "parent_line_id": null,
        "line_status": null,
        "note": null,
        "object_id": null,
        "quantity": "200.0000",
        "unit_code": "HUR",
        "net_amount": "8000.00",
        "purchase_order_line": null,
        "accounting_reference": null,
        "period": null,
        "allowances": [],
        "charges": [],
        "price": {
          "net": "40.0000",
          "discount": null,
          "gross": "40.0000",
          "base_quantity": "1.0000",
          "base_quantity_unit": "HUR"
        },
        "vat": {
          "category": "S",
          "rate": "20.00"
        },
        "item": {
          "name": "SERVICE_FOURNI1",
          "description": "Description",
          "seller_id": null,
          "buyer_id": null,
          "standard_id": null,
          "classifications": [],
          "origin_country": null,
          "attributes": []
        }
      },
      {
        "id": "2",
        "parent_line_id": null,
        "line_status": null,
        "note": null,
        "object_id": null,
        "quantity": "5.0000",
        "unit_code": "DAY",
        "net_amount": "2000.00",
        "purchase_order_line": null,
        "accounting_reference": null,
        "period": null,
        "allowances": [],
        "charges": [],
        "price": {
          "net": "400.0000",
          "discount": null,
          "gross": "400.0000",
          "base_quantity": "1.0000",
          "base_quantity_unit": "DAY"
        },
        "vat": {
          "category": "S",
          "rate": "20.00"
        },
        "item": {
          "name": "SERVICE_FOURNI2",
          "description": "Description",
          "seller_id": null,
          "buyer_id": null,
          "standard_id": null,
          "classifications": [],
          "origin_country": null,
          "attributes": []
        }
      }
    ]
  },
  "attachments": []
}

Appel

curl -H "Authorization: Bearer $RECEPTO_API_KEY" -F file=@facture.pdf https://recepto.fr/v1/parse

Scripts complets : Python, Node.js, PHP. Clé gratuite et plans : tarifs.

Lire une facture reçue en JSON

Ce que fait /v1/parse