Red Peppol - Enviar autofacturación

Disponible a partir de la versión 2025-10-13

La autofacturación permite a los compradores emitir facturas en nombre de los proveedores. B2Brouter representa la autofacturación como:

Saliente: IssuedSelfInvoice a través de Peppol BIS3 Self-Billing. Entrante: ReceivedSelfInvoice recibido a través de Peppol con la recepción habilitada en la cuenta del proveedor.

1. Preparación

Consulta la guía principal Enviar una factura a través de Peppol para una descripción general y detalles de configuración del transporte.

2. Crear una factura de autofacturación (IssuedSelfInvoice)

Para emitir una factura de autofacturación a través de la API:

1. Usa POST /accounts/{account}/invoices.
2. Establece invoice.type en IssuedSelfInvoice.
3. Asegúrate de que el Contact tenga transport_type_code establecido en peppol y proporciona el pin_scheme y el pin_value.

Comportamiento:

• B2Brouter crea un IssuedSelfInvoice.
• Al enviar a través de Peppol, B2Brouter genera una factura UBL BIS3 de autofacturación (xml.ubl.invoice.bis3.selfbilling):
  • El proveedor en el UBL es tu contact.
  • El cliente en el UBL es tu empresa (account).
• La respuesta JSON incluye:
  • "type": "IssuedSelfInvoice"
  • "document_type_code": "xml.ubl.invoice.bis3.selfbilling" (campo de solo lectura que muestra el formato utilizado)

También puedes enviar facturas de autofacturación a través de otros transportes (por ejemplo, B2Brouter interno). Sin embargo, si la configuración del contact y del país admite la autofacturación Peppol, recomendamos usar Peppol porque proporciona mejor interoperabilidad y trazabilidad.

3. Listar y obtener facturas de autofacturación

Usa los endpoints estándar de facturas con el filtro type:

• type=IssuedSelfInvoice – Lista las facturas de autofacturación que has emitido
• type=ReceivedSelfInvoice – Lista las facturas de autofacturación que has recibido

Listar facturas: GET /accounts/{ACCOUNT_ID}/invoices?type=IssuedSelfInvoice

Obtener factura: GET /invoices/{INVOICE_ID}

4. Informes fiscales

Las facturas de autofacturación se incluyen en los informes fiscales (Verifactu, etc.) bajo las mismas reglas que las facturas ordinarias:

• Si un informe fiscal está habilitado para la empresa (p. ej., Verifactu en España), las facturas de autofacturación se reportan automáticamente cuando corresponde.
• En Verifactu, la autofacturación se reporta en nombre de la empresa emisora (Buyer).
• Puede aplicarse comportamiento adicional de informes fiscales (p. ej., Verifactu en España) a las facturas de autofacturación según la configuración de informes fiscales de la cuenta emisora.
• Las facturas de autofacturación de vendedores no sujetos a Verifactu quedan excluidas del reporte.

5. Restricciones y limitaciones conocidas

• Tipo de factura vs tipo de documento

  • La autofacturación siempre usa invoice.type = IssuedSelfInvoice para los documentos salientes.
  • Intentar enviar un IssuedInvoice ordinario usando un tipo de documento de autofacturación (p. ej., a través de un contact mal configurado) fallará con un error 4xx:
    • "The self-billing document type cannot be used for ordinary invoices."

• Selección del tipo de documento

  • document_type_code en la factura es de solo lectura.
  • El tipo de documento efectivo está determinado por:
    • La configuración del contact (transport_type_code, document_type_code), y/o
    • Las capacidades del SMP de Peppol del proveedor.

Recomendaciones para uso en producción:

• Prueba de extremo a extremo en sandbox entre dos cuentas de prueba (usa staging para flujos grandes o entre sistemas).
• Verifica tanto las respuestas JSON de la API como los archivos UBL enviados.
• Monitoriza los registros de integración (solicitudes de la API) para ver payloads, respuestas y detalles de errores.