Disbursements and income tax withholding in TicketBAI

Income tax withholding goes in especial.retencion_soportada; it is not subtracted from importe_total, which is still the sum of bases and tax amounts. Disbursements are not part of the taxable base: they are not reported.

FieldValue
APITicketBAI API
Invoice type or keyespecial.retencion_soportada
Endpoint/ticketbai/create
When to use itInvoices from professionals with income tax withholding.

What changes in this case

An invoice with income tax (IRPF) withholding applies a percentage on the taxable base that the customer deducts from the payment and pays to the tax authority on the professional's behalf. In the TicketBAI API, the withheld amount goes in especial.retencion_soportada (€30 in the example, 15% of €200).

importe_total does not change: it must match the sum of the lines and the sum of bases and tax amounts in desglose_iva, so the withholding is not subtracted.

Disbursements (suplidos) are expenses paid on the customer's behalf and passed on to them later. They are not part of the taxable base (art. 78.Tres.3.º of each territory’s Foral VAT Law), so they are not reported: do not include them in lineas or desglose_iva.

JSON request

Factura con retención de IRPF
{
  "serie": "Ejemplos",
  "numero": "1",
  "fecha_expedicion": "19-11-2026",
  "descripcion": "Factura con retención de IRPF",
  "nif": "A15022510",
  "nombre": "Nombre destinatario",
  "cp": "48001",
  "direccion": "Calle Ejemplo 1, Bilbao",
  "lineas": [
    {
      "descripcion": "Servicios profesionales",
      "cantidad": "1",
      "importe_unitario": "200.00",
      "importe_total": "242.00"
    }
  ],
  "desglose_iva": [
    {
      "base_imponible": "200.00",
      "tipo_impositivo": "21",
      "cuota_impuesto": "42.00"
    }
  ],
  "especial": {
    "retencion_soportada": "30.00"
  },
  "importe_total": "242.00"
}

Try this case in the test environment

Create your free account and ask soporte@verifacti.com for a TicketBAI test NIF; then copy the request and send it with its test API key.

Test environment and test NIF includedRead the documentation