Fix an invoice in TicketBAI: example
In Álava and Gipuzkoa, an invoice that was rejected or accepted with errors is fixed with PUT /ticketbai/modify: the same fields as when creating it plus accion, SUBSANAR if it was rejected or MODIFICAR if it was accepted with errors. It is not available in Bizkaia.
| Field | Value |
|---|---|
| API | TicketBAI API |
| Invoice type or key | PUT /ticketbai/modify con accion SUBSANAR o MODIFICAR |
| Endpoint | PUT /ticketbai/modify |
| When to use it | Fixing in Álava and Gipuzkoa an invoice that was rejected or accepted with errors. |
What changes in this case
The Álava and Gipuzkoa treasuries offer the Zuzendu service to resend the information of a TicketBAI file that was rejected or received with error warnings. In the TicketBAI API it is the /ticketbai/modify endpoint, with the PUT method.
The request carries exactly the same fields as creating the invoice, with the corrected data, plus accion:
SUBSANAR: the treasury never received the invoice because it was rejected for an error.MODIFICAR: the treasury received it, but with error warnings (statusAceptado con errores).
Identify the invoice with the same serie, numero and fecha_expedicion as the original submission; here the date does not have to be today's.
If the error is in the invoice itself, what you need is a corrective invoice. This endpoint is not available in Bizkaia.
JSON requests
Fix a rejected invoice
{
"accion": "SUBSANAR",
"serie": "Ejemplos",
"numero": "1",
"fecha_expedicion": "19-11-2026",
"descripcion": "Factura completa (datos corregidos)",
"nif": "A15022510",
"nombre": "Nombre destinatario",
"cp": "48001",
"direccion": "Calle Ejemplo 1, Bilbao",
"lineas": [
{
"descripcion": "Servicio de consultoría",
"cantidad": "2",
"importe_unitario": "100.00",
"importe_total": "242.00"
}
],
"desglose_iva": [
{
"base_imponible": "200.00",
"tipo_impositivo": "21",
"cuota_impuesto": "42.00"
}
],
"importe_total": "242.00"
}Amend an invoice accepted with errors
{
"accion": "MODIFICAR",
"serie": "Ejemplos",
"numero": "1",
"fecha_expedicion": "19-11-2026",
"descripcion": "Factura completa (datos corregidos)",
"nif": "A15022510",
"nombre": "Nombre destinatario",
"cp": "48001",
"direccion": "Calle Ejemplo 1, Bilbao",
"lineas": [
{
"descripcion": "Servicio de consultoría",
"cantidad": "2",
"importe_unitario": "100.00",
"importe_total": "242.00"
}
],
"desglose_iva": [
{
"base_imponible": "200.00",
"tipo_impositivo": "21",
"cuota_impuesto": "42.00"
}
],
"importe_total": "242.00"
}Common errors
The API rejects /ticketbai/modify for Bizkaia NIFs. To cancel a rejected invoice in Álava or Gipuzkoa, use cancellation with rechazo_previo.
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.