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.
| Field | Value |
|---|---|
| API | TicketBAI API |
| Invoice type or key | especial.retencion_soportada |
| Endpoint | /ticketbai/create |
| When to use it | Invoices 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
{
"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.