Suplidos y retención de IRPF en TicketBAI

La retención de IRPF se informa en especial.retencion_soportada; no se resta de importe_total, que sigue siendo la suma de bases y cuotas. Los suplidos no forman parte de la base imponible: no se informan.

CampoValor
APIAPI TicketBAI
Tipo de factura o claveespecial.retencion_soportada
Endpoint/ticketbai/create
Cuándo se usaFacturas de profesionales con retención de IRPF.

Qué cambia en este caso

Una factura con retención de IRPF aplica un porcentaje sobre la base imponible que el cliente descuenta del pago e ingresa en Hacienda en nombre del profesional. En la API TicketBAI, el importe retenido va en especial.retencion_soportada (30 € en el ejemplo, un 15 % de 200 €).

importe_total no cambia: tiene que cuadrar con la suma de las líneas y con la suma de bases y cuotas de desglose_iva, así que la retención no se resta.

Los suplidos son gastos que se pagan en nombre del cliente y se le repercuten después. No forman parte de la base imponible (art. 78.Tres.3.º de la Norma Foral del IVA de cada territorio), así que no se informan: no los incluyas en lineas ni en desglose_iva.

Petición JSON

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

Prueba este caso en el entorno de test

Crea tu cuenta gratuita y pide a soporte@verifacti.com el NIF de test de TicketBAI; después copia la petición y envíala con su API key de test.

Entorno de test y NIF de prueba incluidosLee la documentación