Red Peppol - Enviar con payload JSON

Cuando tu conexión Peppol está activada, puedes transmitir documentos a través de esta red de forma fluida. A continuación se explica cómo crear una factura usando un payload JSON.

Crear una factura emitida

En el ejemplo siguiente verás cómo generar una factura emitida con el método de entrega configurado como peppol.

Para enviar una factura a través de Peppol, asegúrate de que el Contact tenga transport_type_code establecido en peppol y proporciona el pin_scheme y el pin_value.

Ejemplo de solicitud

curl --request GET \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/invoices \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json' \
  --data '{
     "send_after_import": false,
      "invoice": {
        "type": "IssuedInvoice",
        "number": "1",
        "date": "2024-01-21",
        "due_date": "2024-03-01",
        "terms": "custom",
        "buyer_reference": "071110000000-001-50",
        "payment_method": 58,
        "iban": "ES9815013231061668117743",
        "contact": {
            "name": "Voorbeeld B.V.",
            "address": "Kerkstraat 12", "postalcode": "1017 GM", "city": "Amsterdam",
            "country": "nl",
            "transport_type_code": "peppol",
            "pin_scheme": "{PIN_SCHEME}",   "pin_value": "{PIN_VALUE}"
          },
        "invoice_lines_attributes": [
          {
            "unit": 1,
            "quantity": 1,
            "price": 1,
            "description": "Descripción de línea",
            "taxes_attributes": [
              {
                "category": "S",
                "name": "VAT",
                "percent": 19
              }
            ]
          }
        ]
    }
  }'

Normalmente, estos atributos son los requisitos mínimos para que Peppol envíe el documento. Sin embargo, algunos destinatarios pueden requerir campos adicionales como buyer_reference, como ocurre con ciertos ayuntamientos alemanes.

Al generar la factura, B2Brouter asignará automáticamente el tipo de documento más adecuado para el destinatario, si este tiene capacidad para recibir facturas.

Crear una factura de autofacturación

Para crear una factura de autofacturación (donde el comprador emite la factura en nombre del proveedor), establece "type": "IssuedSelfInvoice" en el payload de la factura. Consulta la guía de autofacturación para más detalles.

Crear una nota de crédito

Para crear una nota de crédito, usa los campos de enmienda ("is_credit_note": true, "amended_number", "amended_date", etc.) para hacer referencia a la factura original.

Para notas de crédito de autofacturación, combina "type": "IssuedSelfInvoice" con los campos de enmienda.

Enviar la factura

El siguiente paso es enviar la factura. Antes del envío, como Proveedor de Servicios Certificado de Peppol, verificamos meticulosamente la presencia de todos los datos requeridos y la validez del documento usando los schematrons oficiales antes de la transmisión.

Si el documento generado es válido, se transmite a través de nuestro access point.

Enlace a la Referencia de la API.

Ejemplo de solicitud:

curl --request POST \
  --url https://api-staging.b2brouter.net/invoices/send_invoice/{invoice-id} \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json'

Rastrear la factura

Por último, puedes comprobar los eventos relacionados con la factura:

Ejemplo de solicitud:

curl --request GET \
  --url 'https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/events?invoice_id={INVOICE_ID}' \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json'