Códigos de tipo de documento Peppol y CII

Descripción general

Al enviar facturas a través de redes PEPPOL o al generar documentos en formato CII/Factur-X, puedes especificar el tipo de documento mediante el campo type_document. Este campo corresponde al Código de Tipo de Factura tal como se define en la lista de códigos UN/CEFACT 1001 (UNCL1001).

Los códigos se utilizan en:

• PEPPOL BIS Billing 3.0/Chorus (formato UBL): elemento InvoiceTypeCode
• Cross Industry Invoice (CII) (Factur-X, ZUGFeRD, EN16931): elemento TypeCode

Uso

El campo type_document es opcional y actúa como indicación del código de tipo de documento. B2Brouter utilizará este valor cuando sea válido para el formato de exportación; en caso contrario, recurrirá a la asignación automática basada en la lógica de negocio:

• 380: Factura comercial estándar (por defecto)
• 381: Nota de crédito
• 389: Autofactura
• 480: Factura no sujeta / inversión del sujeto pasivo

Importante: Al exportar documentos:

• Si type_document es válido para el formato de destino (PEPPOL, CII o FatturaPA), se usará en el XML exportado
• Si type_document no es válido para el formato de destino, el sistema usará automáticamente un código predeterminado adecuado según el tipo de factura
• Esto permite importar documentos en un formato (p. ej., FatturaPA) y exportarlos en otro (p. ej., PEPPOL) de forma transparente

Configurar type_document mediante la API

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

Códigos de tipo de documento PEPPOL/UBL válidos

Los siguientes códigos UN/CEFACT se utilizarán al exportar facturas en formato PEPPOL y UBL:

Códigos de factura estándar

Código	Descripción
71	Solicitud de pago
80	Nota de débito relacionada con bienes o servicios
82	Factura de servicios medidos
84	Nota de débito relacionada con ajustes financieros
102	Notificación fiscal
218	Solicitud de pago final por finalización de obra
219	Solicitud de pago por unidades completadas
326	Factura parcial
331	Factura comercial que incluye lista de embalaje
380	Factura comercial
382	Nota de comisión
383	Nota de débito
384	Factura rectificada
386	Factura de prepago
388	Factura fiscal
393	Factura cedida
395	Factura de consignación
553	Informe de discrepancia del transitario
575	Factura del asegurador
623	Factura del transitario
780	Factura de flete
817	Notificación de reclamación
870	Factura consular
875	Factura parcial de construcción
876	Factura final parcial de construcción
877	Factura final de construcción

Nota: Los códigos 326 y 384 solo pueden usarse cuando ambas partes (proveedor y cliente) tienen país ‘DE’.

Códigos de nota de crédito (para PEPPOL)

Estos códigos solo son válidos cuando la factura es una nota de crédito (is_credit_note: true):

Código	Descripción
81	Nota de crédito relacionada con bienes o servicios
83	Nota de crédito relacionada con ajustes financieros
381	Nota de crédito
396	Nota de crédito cedida
532	Nota de crédito del transitario

Códigos de autofactura (para PEPPOL)

Código	Descripción
389	Autofactura
527	Nota de débito de autofactura

Código de nota de crédito de autofactura (para PEPPOL)

Código	Descripción
261	Nota de crédito de autofactura

Nota: Este código solo puede usarse cuando type: IssuedSelfInvoice e is_credit_note: true

Códigos de tipo de documento CII/Factur-X válidos

Los siguientes códigos se utilizarán al exportar documentos en formato Cross Industry Invoice (CII):

Códigos de factura estándar

Código	Descripción
326	Factura parcial
380	Factura comercial
384	Factura rectificada
875	Factura parcial de construcción
876	Factura final parcial de construcción
877	Factura final de construcción

Código de nota de crédito (para CII)

Código	Descripción
381	Nota de crédito

Código de autofactura (para CII)

Código	Descripción
389	Autofactura

Nota: Los códigos 326 y 384 solo pueden usarse cuando ambas partes (proveedor y cliente) tienen país ‘DE’.

Ejemplos

Ejemplo 1: Factura PEPPOL estándar

{
  "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
          }
        ]
      }
    ]
  }
}

Ejemplo 2: Nota de crédito 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": [...]
  }
}

Ejemplo 3: Factura de prepago

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

Ejemplo 4: Autofactura

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

Salida 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>

Referencias de estándares

• PEPPOL BIS Billing 3.0 - Código de tipo de factura
• EN 16931 - Estándar europeo de facturación electrónica