Retención de IRPF

Cuando un profesional factura a una empresa, el cliente suele retener una parte a cuenta del IRPF y la ingresa en Hacienda en su nombre. La factura no cambia de importe: cambia lo que el cliente paga.

{
  "comprador": { "identificacion": "B87654321", "razon_social": "CLIENTE EJEMPLO S.L." },
  "items": [
    {
      "descripcion": "Servicios profesionales",
      "cantidad": 1,
      "precio_unitario": 1000.00,
      "impuestos": [{ "codigo_impuesto": "ES_IVA_21" }]
    }
  ],
  "retencion": 15
}

Cómo queda

{
  "totales": {
    "total_sin_impuestos": 1000.0,
    "iva": 210.0,
    "importe_total": 1210.0,
    "retencion": 150.0,
    "a_pagar": 1060.0
  }
}

Campo	Qué es
importe_total	El importe de la factura: base + IVA. Es lo que se declara a la AEAT
retencion	Lo que el cliente retiene: 15 % de la base, no del total
a_pagar	Lo que el cliente transfiere: importe_total − retencion

La retención no cambia lo que se declara

El registro que va a la AEAT lleva 1210,00, no 1060,00. La retención es un asunto entre el cliente y Hacienda: no reduce la base imponible ni la cuota de IVA.

Si tu sistema contabiliza a_pagar como importe de la factura, tendrás descuadres. El importe es importe_total.

Tipos admitidos

Tipo	Caso habitual
15 %	Profesionales, régimen general
7 %	Profesionales en sus tres primeros años de actividad
19 %	Arrendamiento de inmuebles urbanos
2 %	Actividades agrícolas y ganaderas
1 %	Actividades ganaderas de engorde y otras

Cualquier otro valor se rechaza:

{
  "error": {
    "code": "validation_error",
    "message": "La retención del 13 % no es un tipo de IRPF válido.",
    "details": { "campo": "retencion", "tipos": [1.0, 2.0, 7.0, 15.0, 19.0] }
  }
}

El cliente tiene que estar identificado

Solo se retiene a quien tiene NIF: una factura simplificada no puede llevar retención.

{
  "error": {
    "code": "validation_error",
    "message": "Solo se puede practicar retención a un cliente identificado con NIF.",
    "details": { "campo": "retencion" }
  }
}

El tipo del cliente, guardado en Olympus

Si el cliente ya existe como contacto en Olympus con su tipo de retención, la web lo propone sola al facturarle. Por la API no se aplica solo: si quieres retención, mándala explícitamente. Así una integración nunca retiene por sorpresa.

Cómo se calcula

retencion = total_sin_impuestos × tipo ÷ 100
a_pagar   = importe_total − retencion

Sobre la base imponible, nunca sobre el total con IVA.

Con varias líneas, sobre la suma de las bases:

Consultoría     600,00
Manual técnico   30,00
─────────────────────
base            630,00
IVA (21% y 4%)  127,20
total           757,20
retención 15%    94,50   ← 630,00 × 0,15
a pagar         662,70

En la factura impresa

El PDF muestra la retención como una línea negativa y destaca el importe a pagar, que es lo que el cliente necesita ver para hacer la transferencia.