Codes de type de document Peppol et CII

Vue d’ensemble

Lors de l’envoi de factures via les réseaux PEPPOL ou de la génération de documents au format CII/Factur-X, vous pouvez spécifier le type de document à l’aide du champ type_document. Ce champ correspond à l’Invoice Type Code défini dans la liste de codes UN/CEFACT 1001 (UNCL1001).

Les codes sont utilisés dans :

• PEPPOL BIS Billing 3.0/Chorus (format UBL) : élément InvoiceTypeCode
• Cross Industry Invoice (CII) (Factur-X, ZUGFeRD, EN16931) : élément TypeCode

Utilisation

Le champ type_document est optionnel et sert d’indication pour le code de type de document. B2Brouter utilisera cette valeur lorsqu’elle est valide pour le format d’export ; sinon, il reviendra à une attribution automatique basée sur la logique métier :

• 380 : facture commerciale standard (par défaut)
• 381 : avoir
• 389 : auto-facture
• 480 : facture non taxable / autoliquidation

Important : lors de l’export des documents :

• Si type_document est valide pour le format cible (PEPPOL, CII ou FatturaPA), il sera utilisé dans le XML exporté
• Si type_document n’est pas valide pour le format cible, le système utilise automatiquement un code par défaut approprié selon le type de facture
• Cela vous permet d’importer des documents dans un format (par ex. FatturaPA) et de les exporter dans un autre (par ex. PEPPOL) de manière fluide

Définir type_document via l’API

{
  "invoice": {
    "type_document": "380",
    "number": "INV-2025-001",
    "date": "2025-01-26",
    "contact_id": 12345,
    "invoice_lines_attributes": [...]
  }
}

Codes de type de document PEPPOL/UBL valides

Les codes UN/CEFACT suivants seront utilisés lors de l’export vers des factures au format PEPPOL et UBL :

Codes de facture standard

Code	Description
71	Demande de paiement
80	Note de débit liée à des biens ou services
82	Facture de services mesurés
84	Note de débit liée à des ajustements financiers
102	Notification fiscale
218	Demande de paiement final basée sur l’achèvement des travaux
219	Demande de paiement pour unités achevées
326	Facture partielle
331	Facture commerciale incluant une liste de colisage
380	Facture commerciale
382	Note de commission
383	Note de débit
384	Facture corrigée
386	Facture d’acompte
388	Facture fiscale
393	Facture cédée
395	Facture de consignation
553	Rapport d’écart sur facture de transitaire
575	Facture d’assureur
623	Facture de transitaire
780	Facture de fret
817	Notification de réclamation
870	Facture consulaire
875	Facture partielle de construction
876	Facture finale partielle de construction
877	Facture finale de construction

Remarque : les codes 326 et 384 ne peuvent être utilisés que lorsque les deux parties (fournisseur et client) ont le pays DE.

Codes d’avoir (pour PEPPOL)

Ces codes ne sont valides que lorsque la facture est un avoir (is_credit_note: true) :

Code	Description
81	Avoir lié à des biens ou services
83	Avoir lié à des ajustements financiers
381	Avoir
396	Avoir cédé
532	Avoir de transitaire

Codes d’auto-facture (pour PEPPOL)

Code	Description
389	Auto-facture
527	Note de débit auto-facturée

Code d’avoir d’auto-facturation (pour PEPPOL)

Code	Description
261	Avoir auto-facturé

Remarque : ce code ne peut être utilisé que lorsque type: IssuedSelfInvoice et is_credit_note: true

Codes de type de document CII/Factur-X valides

Les codes suivants seront utilisés lors de l’export de documents au format Cross Industry Invoice (CII) :

Codes de facture standard

Code	Description
326	Facture partielle
380	Facture commerciale
384	Facture corrigée
875	Facture partielle de construction
876	Facture finale partielle de construction
877	Facture finale de construction

Code d’avoir (pour CII)

Code	Description
381	Avoir

Code d’auto-facturation (pour CII)

Code	Description
389	Auto-facture

Remarque : les codes 326 et 384 ne peuvent être utilisés que lorsque les deux parties (fournisseur et client) ont le pays DE.

Exemples

Exemple 1 : facture PEPPOL standard

{
  "send_after_import": true,
  "invoice": {
    "type": "IssuedInvoice",
    "type_document": "380",
    "number": "INV-2025-001",
    "date": "2025-01-26",
    "due_date": "2025-02-26",
    "contact_id": 12345,
    "invoice_lines_attributes": [
      {
        "quantity": 10,
        "price": 50.0,
        "description": "Professional services",
        "taxes_attributes": [
          {
            "name": "VAT",
            "percent": 21
          }
        ]
      }
    ]
  }
}

Exemple 2 : avoir PEPPOL

{
  "send_after_import": true,
  "invoice": {
    "type": "IssuedInvoice",
    "type_document": "381",
    "is_credit_note": true,
    "number": "CN-2025-001",
    "date": "2025-01-26",
    "amended_number": "INV-2025-001",
    "contact_id": 12345,
    "invoice_lines_attributes": [...]
  }
}

Exemple 3 : facture d’acompte

{
  "send_after_import": true,
  "invoice": {
    "type": "IssuedInvoice",
    "type_document": "386",
    "number": "PREP-2025-001",
    "date": "2025-01-26",
    "contact_id": 12345,
    "invoice_lines_attributes": [...]
  }
}

Exemple 4 : auto-facture

{
  "send_after_import": true,
  "invoice": {
    "type": "ReceivedInvoice",
    "type_document": "389",
    "number": "SELF-2025-001",
    "date": "2025-01-26",
    "contact_id": 12345,
    "invoice_lines_attributes": [...]
  }
}

Sortie XML

PEPPOL BIS 3.0 (UBL)

<Invoice>
  <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
  ...
</Invoice>

CII (Factur-X/EN16931)

<rsm:CrossIndustryInvoice>
  <rsm:ExchangedDocument>
    <ram:TypeCode>380</ram:TypeCode>
  </rsm:ExchangedDocument>
  ...
</rsm:CrossIndustryInvoice>

Références normatives

• PEPPOL BIS Billing 3.0 - Invoice Type Code
• EN 16931 - norme européenne de facturation électronique