Ir al contenido

Verifactu Direct API · tipos de operación ​

El desglose lo aportas ya clasificado en cada línea. El cuerpo completo de un alta está en Empezar; aquí solo cambian las lineas (y el destinatario id_otro en las internacionales). Datos de ejemplo ficticios.

Varios tipos de IVA ​

json
"lineas": [
  { "base_imponible": "350", "tipo_impositivo": "21", "cuota_repercutida": "73.50" },
  { "base_imponible": "180", "tipo_impositivo": "10", "cuota_repercutida": "18" }
]

Exenta de IVA (art. 20: sanidad, educación, seguros…) ​

json
{ "serie": "FV", "numero": "1050", "fecha_expedicion": "2026-04-01",
  "tipo_factura": "F1", "descripcion": "Servicios sanitarios (exentos)",
  "nif": "B66912043", "nombre": "Clínica Vallehermoso SL",
  "lineas": [ { "base_imponible": "500", "operacion_exenta": "E1" } ],
  "importe_total": "500" }

No sujeta ​

json
"lineas": [ { "base_imponible": "500", "calificacion_operacion": "N1" } ]

Inversión del sujeto pasivo (ISP) ​

El destinatario autoliquida el IVA: calificacion_operacion S2, con tipo y cuota a 0.

json
{ "tipo_factura": "F1", "descripcion": "Ejecución de obra (ISP)",
  "nif": "B85447761", "nombre": "Comercial Aldealta SL",
  "lineas": [ { "base_imponible": "1200", "tipo_impositivo": "0", "cuota_repercutida": "0",
               "calificacion_operacion": "S2" } ],
  "importe_total": "1200" }

Intracomunitaria — venta de bienes (exenta, art. 25) ​

Destinatario UE con su VAT-IES (id_otro con id_type 02); operación exenta E5.

json
{ "tipo_factura": "F1", "descripcion": "Venta de bienes a empresa UE",
  "id_otro": { "codigo_pais": "FR", "id_type": "02", "id": "FR47812904563" },
  "nombre": "Atelier Vionnet SARL",
  "lineas": [ { "base_imponible": "800", "operacion_exenta": "E5" } ],
  "importe_total": "800" }

Intracomunitaria — prestación de servicios (no sujeta por localización) ​

json
{ "tipo_factura": "F1", "descripcion": "Servicios B2B a empresa UE",
  "id_otro": { "codigo_pais": "DE", "id_type": "02", "id": "DE293847561" },
  "nombre": "Brückner Logistik GmbH",
  "lineas": [ { "base_imponible": "800", "calificacion_operacion": "N2" } ],
  "importe_total": "800" }

B2C intracomunitaria — por debajo del umbral (IVA español) ​

Particular UE (sin VAT-IES): identifícalo con pasaporte (id_type 03). Tributa en origen, con IVA español.

json
{ "tipo_factura": "F1", "descripcion": "Venta a particular UE",
  "id_otro": { "codigo_pais": "IT", "id_type": "03", "id": "YA1846723" },
  "nombre": "Giulia Ferraro",
  "lineas": [ { "base_imponible": "250", "tipo_impositivo": "21", "cuota_repercutida": "52.50" } ],
  "importe_total": "302.50" }

B2C intracomunitaria — por encima del umbral (régimen OSS) ​

IVA del país de destino vía Ventanilla Única: clave_regimen 17 y calificacion_operacionN2, sin tipo_impositivo/cuota_repercutida (el desglose español no aplica).

json
{ "tipo_factura": "F1", "descripcion": "Venta a particular UE (OSS)",
  "id_otro": { "codigo_pais": "PT", "id_type": "03", "id": "K9920841" },
  "nombre": "Tiago Sousa",
  "lineas": [ { "base_imponible": "250", "clave_regimen": "17", "calificacion_operacion": "N2" } ],
  "importe_total": "250" }

Exportación de bienes (fuera de la UE, exenta art. 21) ​

json
{ "tipo_factura": "F1", "descripcion": "Exportación de bienes",
  "id_otro": { "codigo_pais": "US", "id_type": "03", "id": "P472019583" },
  "nombre": "Northbridge Trading LLC",
  "lineas": [ { "base_imponible": "900", "clave_regimen": "02", "operacion_exenta": "E2" } ],
  "importe_total": "900" }

Exportación de servicios (no sujeta por localización) ​

json
{ "tipo_factura": "F1", "descripcion": "Servicios a cliente extracomunitario",
  "id_otro": { "codigo_pais": "US", "id_type": "03", "id": "P472019583" },
  "nombre": "Northbridge Trading LLC",
  "lineas": [ { "base_imponible": "900", "calificacion_operacion": "N2" } ],
  "importe_total": "900" }

Recargo de equivalencia ​

Marca la línea con clave_regimen 18 y aporta el tipo y la cuota del recargo. Tipos: 5,2 % (IVA 21) · 1,4 % (IVA 10) · 0,5 % (IVA 4) · 1,75 % (tabaco).

json
"lineas": [
  { "base_imponible": "200", "tipo_impositivo": "21", "cuota_repercutida": "42",
    "clave_regimen": "18",
    "tipo_recargo_equivalencia": "5.2", "cuota_recargo_equivalencia": "10.4" }
]
// importe_total: "252.40"

IGIC (Canarias) ​

json
"lineas": [ { "impuesto": "03", "base_imponible": "200", "tipo_impositivo": "7", "cuota_repercutida": "14" } ]
// importe_total: "214"

IPSI (Ceuta y Melilla) ​

json
"lineas": [ { "impuesto": "02", "base_imponible": "200", "tipo_impositivo": "10", "cuota_repercutida": "20" } ]
// importe_total: "220"

REBU (bienes usados, tributación por el margen) ​

El IVA se calcula sobre el margen, pero importe_total es el precio de venta. Marca clave_regimen 03 para que Bilteo no valide que base + cuota = total.

json
{ "tipo_factura": "F1", "descripcion": "Venta de bien usado (REBU)",
  "nif": "B72648193", "nombre": "Talleres Marverde SL",
  "lineas": [ { "base_imponible": "826.45", "tipo_impositivo": "21",
               "cuota_repercutida": "173.55", "clave_regimen": "03" } ],
  "importe_total": "3000" }

Emitida por un tercero o por el destinatario ​

Cuando la factura la expide un tercero autorizado (T, con su nombre y NIF) o el propio destinatario (D). El NIF del obligado lo sigue poniendo tu tenant.

json
"especial": { "emitida_por_tercero_o_destinatario": "T",
              "nombre_tercero": "Asesoría Cumbre SL", "nif_tercero": "B66912043" }
json
"especial": { "emitida_por_tercero_o_destinatario": "D" }

Tabla de claves ​

CampoValores
tipo_facturaF1 ordinaria · F2 simplificada · F3 sustitutiva · R1–R5 rectificativas
impuesto01 IVA · 02 IPSI · 03 IGIC
operacion_exentaE1–E6 (art. 20, exportación, entrega intracom.…)
calificacion_operacionS1 sujeta · S2 ISP · N1 no sujeta · N2 no sujeta por localización
clave_regimen01 general · 02 exportación · 03 REBU · 17 OSS · 18 recargo eq.…
id_otro.id_type02 NIF-IVA (VIES) · 03 pasaporte · 04 ID del país de residencia · 06 otro
tipo_rectificativaS sustitución · I diferencias
rechazo_previoN registro previo aceptado · X no consta en AEAT · S subsanación previa rechazada

Bilteo · Documentación