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.

Cuándo se puede emitir una factura simplificada en España

En España, el Reglamento de facturación (Real Decreto 1619/2012) permite emitir una factura simplificada en lugar de una factura completa en estos casos:

Cuando el importe de la operación no supera los 400 € (IVA incluido).
Cuando el importe no supera los 3.000 € (IVA incluido) en determinadas actividades, como el comercio minorista, la hostelería y la restauración o el transporte de personas.
En facturas rectificativas.

Una factura simplificada debe incluir, como mínimo: número y serie, fecha de expedición, NIF y nombre del emisor, descripción de los bienes o servicios, tipo impositivo (o la mención «IVA incluido») e importe total. Si el destinatario es un empresario o profesional que quiere deducir el IVA, debe constar también su NIF y domicilio, y la cuota de IVA por separado.

Para otros países, consulta la guía correspondiente; por ejemplo, en Italia existe la Fattura Semplificata.

Crear la factura simplificada

Ejemplo de solicitud

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": "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