Emetre una factura simplificada (tiquet)

Una factura simplificada (tiquet) és un document de venda lleuger que normalment es lliura com a PDF. No hi ha un estàndard XML universal per als tiquets, de manera que per a integracions l’enfocament recomanat és treballar amb JSON i deixar que B2Brouter generi el PDF.

Useu "type": "IssuedSimplifiedInvoice" per crear una factura simplificada.

Crear la factura simplificada

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": "IssuedSimplifiedInvoice",
      "number": "T-2026-0001",
      "date": "2026-01-21",
      "currency": "EUR",
      "file_reference": "POS-ORDER-12345",
      "contact": {
        "name": "Final consumer",
        "country": "es"
      },
      "invoice_lines_attributes": [
        {
          "quantity": 1,
          "price": 10,
          "description": "Coffee",
          "taxes_attributes": [
            {
              "name": "VAT",
              "percent": 21,
              "category": "S"
            }
          ]
        }
      ]
    }
  }'

Resposta d’exemple (extracte)

{
  "invoice": {
    "id": 123456,
    "type": "IssuedSimplifiedInvoice",
    "number": "T-2026-0001",
    "state": "new",
    "file_reference": "POS-ORDER-12345",
    "document_type_code": "pdf.invoice"
  }
}

Enviar la factura simplificada (generar el PDF)

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}'

Descarregar el PDF

curl --request GET \
  --url 'https://api-staging.b2brouter.net/invoices/{INVOICE_ID}/as/pdf.invoice?download=true' \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}'

Notes

• Useu file_reference per emmagatzemar la vostra referència interna (ID de comanda, ID de tiquet, ID de transacció TPV, etc.) i facilitar la conciliació.
• Si voleu que B2Brouter enviï el PDF per correu electrònic, definiu contact_email_override a la factura abans de crear-la o cridar POST /invoices/send_invoice/{INVOICE_ID}.
• Per llistar factures simplificades: GET /accounts/{ACCOUNT_ID}/invoices?type=IssuedSimplifiedInvoice