Verifactu Direct API · tipus d'operació
Tu aportes el desglossament ja classificat a cada línia. El cos complet d'una alta és a Començar; aquí només canvien lineas i, en operacions internacionals, id_otro. Les dades són fictícies.
Diversos tipus d'IVA
json
"lineas": [
{ "base_imponible": "350", "tipo_impositivo": "21", "cuota_repercutida": "73.50" },
{ "base_imponible": "180", "tipo_impositivo": "10", "cuota_repercutida": "18" }
]Exempta d'IVA
json
{ "serie": "FV", "numero": "1050", "fecha_expedicion": "2026-04-01",
"tipo_factura": "F1", "descripcion": "Serveis sanitaris exempts",
"nif": "B66912043", "nombre": "Clínica Vall SL",
"lineas": [ { "base_imponible": "500", "operacion_exenta": "E1" } ],
"importe_total": "500" }No subjecta
json
"lineas": [ { "base_imponible": "500", "calificacion_operacion": "N1" } ]Inversió del subjecte passiu
El destinatari autoliquida l'IVA: calificacion_operacion: "S2", amb tipus i quota zero.
json
{ "tipo_factura": "F1", "descripcion": "Execució d'obra (ISP)",
"nif": "B85447761", "nombre": "Comercial Aldealta SL",
"lineas": [ { "base_imponible": "1200", "tipo_impositivo": "0",
"cuota_repercutida": "0", "calificacion_operacion": "S2" } ],
"importe_total": "1200" }Venda intracomunitària de béns
Destinatari UE amb VAT-IES (id_type: "02") i operació exempta E5.
json
{ "tipo_factura": "F1", "descripcion": "Venda de béns a una 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" }Serveis intracomunitaris B2B
json
{ "tipo_factura": "F1", "descripcion": "Serveis B2B a una 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 intracomunitària per sota del llindar
Identifica el particular sense VAT-IES amb id_type: "03" i aplica IVA espanyol.
json
{ "tipo_factura": "F1", "descripcion": "Venda a un 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 intracomunitària amb règim OSS
Per sobre del llindar: clave_regimen: "17" i calificacion_operacion: "N2", sense tipus ni quota espanyols.
json
{ "tipo_factura": "F1", "descripcion": "Venda a un 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ó de béns
json
{ "tipo_factura": "F1", "descripcion": "Exportació de béns",
"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ó de serveis
json
{ "tipo_factura": "F1", "descripcion": "Serveis a un client extracomunitari",
"id_otro": { "codigo_pais": "US", "id_type": "03", "id": "P472019583" },
"nombre": "Northbridge Trading LLC",
"lineas": [ { "base_imponible": "900", "calificacion_operacion": "N2" } ],
"importe_total": "900" }Recàrrec d'equivalència
Utilitza clave_regimen: "18" i aporta tipus i quota del recàrrec.
json
"lineas": [
{ "base_imponible": "200", "tipo_impositivo": "21", "cuota_repercutida": "42",
"clave_regimen": "18", "tipo_recargo_equivalencia": "5.2",
"cuota_recargo_equivalencia": "10.4" }
]IGIC i IPSI
json
"lineas": [ { "impuesto": "03", "base_imponible": "200", "tipo_impositivo": "7", "cuota_repercutida": "14" } ]json
"lineas": [ { "impuesto": "02", "base_imponible": "200", "tipo_impositivo": "10", "cuota_repercutida": "20" } ]REBU
L'IVA es calcula sobre el marge, però importe_total és el preu de venda. clave_regimen: "03" evita validar base + quota = total.
json
{ "tipo_factura": "F1", "descripcion": "Venda d'un bé usat (REBU)",
"nif": "B72648193", "nombre": "Tallers Marverd SL",
"lineas": [ { "base_imponible": "826.45", "tipo_impositivo": "21",
"cuota_repercutida": "173.55", "clave_regimen": "03" } ],
"importe_total": "3000" }Emesa per un tercer o pel destinatari
json
"especial": { "emitida_por_tercero_o_destinatario": "T",
"nombre_tercero": "Assessoria Cim SL", "nif_tercero": "B66912043" }json
"especial": { "emitida_por_tercero_o_destinatario": "D" }Taula de claus
| Camp | Valors |
|---|---|
tipo_factura | F1, F2, F3, R1–R5 |
impuesto | 01 IVA, 02 IPSI, 03 IGIC |
operacion_exenta | E1–E6 |
calificacion_operacion | S1, S2, N1, N2 |
clave_regimen | 01 general, 02 exportació, 03 REBU, 17 OSS, 18 recàrrec |
id_otro.id_type | 02 NIF-IVA, 03 passaport, 04 ID del país, 06 altre |
tipo_rectificativa | S substitució, I diferències |
rechazo_previo | N, X, S |