Ves al contingut

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 ​

CampValors
tipo_facturaF1, F2, F3, R1–R5
impuesto01 IVA, 02 IPSI, 03 IGIC
operacion_exentaE1–E6
calificacion_operacionS1, S2, N1, N2
clave_regimen01 general, 02 exportació, 03 REBU, 17 OSS, 18 recàrrec
id_otro.id_type02 NIF-IVA, 03 passaport, 04 ID del país, 06 altre
tipo_rectificativaS substitució, I diferències
rechazo_previoN, X, S

Bilteo · Documentació