Xarxa Peppol - Enviar amb payload JSON

Quan la connexió Peppol està activada, podeu transmetre documents a través d’aquesta xarxa. A continuació s’explica com crear una factura usant un payload JSON.

Crear una factura emesa

A l’exemple següent veureu com generar una factura emesa amb el mètode de lliurament configurat com a peppol.

Per enviar una factura per Peppol, assegureu-vos que el Contact tingui transport_type_code configurat a peppol i proporcioneu els camps pin_scheme i pin_value.

Exemple de petició

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": "Description line",
            "taxes_attributes": [
              {
                "category": "S",
                "name": "VAT",
                "percent": 19
              }
            ]
          }
        ]
    }
  }'

Normalment, aquests atributs són els requisits mínims perquè Peppol enviï el document. No obstant això, alguns destinataris poden requerir camps addicionals com buyer_reference, com és el cas de determinats ajuntaments d’Alemanya.

En generar la factura, B2Brouter assignarà automàticament el tipus de document més adequat per al destinatari, si el destinatari té capacitat per rebre factures.

Crear una autofactura

Per crear una autofactura (on el comprador emet la factura en nom del proveïdor), configureu "type": "IssuedSelfInvoice" al payload de la factura. Consulteu la guia d’autofacturació per a més detalls.

Crear una nota de crèdit

Per crear una nota de crèdit, useu els camps d’esmena ("is_credit_note": true, "amended_number", "amended_date", etc.) per referenciar la factura original.

Per a notes de crèdit d’autofacturació, combineu "type": "IssuedSelfInvoice" amb els camps d’esmena.

Enviar la factura

El pas següent és enviar la factura. Abans d’enviar, com a Proveïdor de Serveis Certificat Peppol, verifiquem minuciosament la presència de totes les dades necessàries i la validesa del document usant schematrons oficials abans de la transmissió.

Si el document generat és vàlid, es transmet a través del nostre punt d’accés.

Enllaç a la Referència de l’API.

Exemple de petició:

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'

Traçar la factura

Finalment, podeu comprovar els esdeveniments relacionats amb la factura:

Exemple de petició:

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'