Emitir una factura simplificada (ticket)

Una factura simplificada (ticket) es un documento de venta ligero que generalmente se entrega como PDF. No existe un estándar XML universal para los tickets, por lo que para las integraciones el enfoque recomendado es trabajar con JSON y dejar que B2Brouter genere el PDF.

Usa "type": "IssuedSimplifiedInvoice" para crear una factura simplificada.

Crear la factura simplificada

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

Ejemplo de respuesta (extracto)

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

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

Notas

Usa file_reference para guardar tu propia referencia interna (ID de pedido, ID de ticket, ID de transacción TPV, etc.) y facilitar la reconciliación.
Si quieres que B2Brouter envíe el PDF por email, establece contact_email_override en la factura antes de crearla o al llamar a POST /invoices/send_invoice/{INVOICE_ID}.
Para listar facturas simplificadas: GET /accounts/{ACCOUNT_ID}/invoices?type=IssuedSimplifiedInvoice