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.

Quan es pot emetre una factura simplificada a Espanya

A Espanya, el Reglament de facturació (Reial decret 1619/2012) permet emetre una factura simplificada en lloc d’una factura completa en aquests casos:

Quan l’import de l’operació no supera els 400 € (IVA inclòs).
Quan l’import no supera els 3.000 € (IVA inclòs) en determinades activitats, com ara el comerç minorista, l’hostaleria i la restauració o el transport de persones.
En factures rectificatives.

Una factura simplificada ha d’incloure, com a mínim: número i sèrie, data d’expedició, NIF i nom de l’emissor, descripció dels béns o serveis, tipus impositiu (o la menció «IVA inclòs») i import total. Si el destinatari és un empresari o professional que vol deduir l’IVA, cal indicar-hi també el seu NIF i domicili, i la quota d’IVA per separat.

Per a altres països, consulta la guia corresponent; per exemple, a Itàlia hi ha la Fattura Semplificata.

Crear la factura simplificada

Exemple de petició

curl --request POST \
  --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