Una de las mayores dificultades al integrar Verifactu en un software de facturación es entender cómo se estructura cada tipo de factura según la normativa. Cada caso —simplificada, normal, rectificativa, intracomunitaria, con IGIC, con inversión del sujeto pasivo…— tiene sus propios campos obligatorios, claves de régimen y reglas de validación.
Por eso, en Verifacti hemos publicado una colección completa de más de 25 ejemplos de peticiones API que cubren prácticamente todos los escenarios de facturación contemplados por el Reglamento Verifactu (RD 1007/2023). Cada ejemplo incluye el JSON real que se envía a nuestra API, listo para copiar, adaptar y probar.
En este artículo repasamos los principales tipos de facturas incluidos en la sección de ejemplos de la API Verifactu y explicamos brevemente cuándo se usa cada uno.
¿Por qué tantos ejemplos de facturas Verifactu?
La normativa Verifactu no se limita a un solo formato de factura. Dependiendo del tipo de operación, la residencia fiscal del destinatario, el régimen impositivo aplicable o si la factura corrige otra anterior, los campos obligatorios y las claves cambian significativamente.
Para un desarrollador que integra Verifactu por primera vez, esto supone dedicar horas a leer la documentación técnica de la Agencia Tributaria, interpretar los campos del XML y, muchas veces, descubrir errores solo después de enviar la factura.
Los ejemplos de Verifacti eliminan esa fricción. Cada ejemplo es una petición JSON real al endpoint /verifactu/create, con todos los campos correctamente rellenados. Solo tienes que adaptarlos a tus datos y lanzar la petición.
Facturas simplificadas y normales
Son los dos tipos de factura más habituales y el punto de partida para cualquier integración.
Factura simplificada (F2)
Se utiliza cuando no es necesario identificar al destinatario, típicamente en ventas al público con importes inferiores a 3.000 €. En términos fiscales, los tickets de compra son facturas simplificadas. Solo requiere las líneas de impuestos y el importe total.
La API de Verifacti valida automáticamente que el importe no supere el límite legal y rechaza la factura si lo excede.
Factura normal (F1)
Es obligatoria cuando se identifican los datos fiscales del destinatario. Requiere los campos nif y nombre del receptor. Nuestra API valida el NIF contra el censo de la AEAT, previniendo que se generen registros que la Agencia Tributaria rechazará.
Consulta los ejemplos de factura simplificada y factura normal en nuestra documentación.
Facturas con múltiples tipos de IVA
Es habitual que una misma factura incluya productos o servicios con diferentes tipos impositivos (21 %, 10 %, 4 %). En la API de Verifacti, el campo lineas acepta un array con tantos tipos impositivos como necesites.
Este caso es especialmente relevante para sectores como la hostelería, donde una misma factura puede combinar alimentos al tipo reducido con bebidas alcohólicas al tipo general.
Ver el ejemplo de factura con múltiples IVAs.
Facturas intracomunitarias (B2B y B2C)
Las operaciones con otros países de la UE son uno de los aspectos más complejos de la facturación en Verifactu. Los ejemplos cubren cuatro escenarios distintos:
B2B intracomunitario: venta de bienes
Cuando ambas partes están registradas en el ROI (VIES), la factura no incluye IVA. La operación se marca como exenta bajo el artículo 25 de la Ley del IVA con la clave E5. Se utiliza el campo id_otro con el tipo de documento 02 (IVA intracomunitario VIES). La API valida automáticamente que el IVA-VIES esté correctamente registrado.
B2B intracomunitario: prestación de servicios
Similar al caso anterior, pero la exención se basa en las reglas de localización del servicio (artículo 69 de la Ley del IVA). Se marca como operación no sujeta con la clave N2.
B2C intracomunitario: por debajo del umbral
Ventas a consumidores finales en la UE cuando el volumen anual no supera los 10.000 €. Se aplica IVA español.
B2C intracomunitario: por encima del umbral (régimen OSS)
Cuando se supera el umbral de 10.000 €, se aplica el IVA del país del consumidor bajo el régimen One-Stop Shop (OSS). Se utiliza la clave de régimen 17.
Consulta todos los ejemplos de facturas intracomunitarias.
Facturas extracomunitarias y exportaciones
Las ventas fuera de la UE también tienen sus particularidades en Verifactu:
Exportación de bienes
Las exportaciones están exentas de IVA bajo el artículo 21 de la Ley del IVA. Se utiliza la clave de exención E2 y se identifica al destinatario con su número de pasaporte u otro documento oficial del país correspondiente.
Prestación de servicios extracomunitarios
Cuando el destinatario es una empresa fuera de la UE, el servicio se considera no sujeto por reglas de localización (artículo 69 de la Ley del IVA), utilizando la clave N2.
Ver los ejemplos de facturas extracomunitarias.
Facturas exentas, con IGIC e IPSI
No todas las operaciones tributan al IVA general. Los ejemplos incluyen tres variantes adicionales:
Factura exenta de IVA
Aplica a operaciones exentas por ley, como determinados servicios sanitarios, educativos o financieros. Se marca con la clave de exención correspondiente sin incluir cuota repercutida.
Factura con IGIC
Para empresas con domicilio fiscal en Canarias. El Impuesto General Indirecto Canario sustituye al IVA y se declara con sus propios tipos impositivos.
Factura con IPSI
Para empresas en Ceuta y Melilla. El Impuesto sobre la Producción, los Servicios y la Importación tiene sus propias reglas.
Consulta los ejemplos de facturas exentas, con IGIC y con IPSI.
Facturas rectificativas, de canje y de abono
La corrección de facturas es uno de los aspectos más complejos de Verifactu. Publicamos ejemplos detallados de cada modalidad:
Rectificativa por sustitución
Sustituye completamente la factura original. Se utiliza el tipo R1 y se incluyen las referencias a las facturas que se rectifican. La nueva factura refleja los importes correctos completos.
Rectificativa por diferencias
Solo refleja la diferencia entre la factura original y la corrección. Es útil cuando el error es parcial y no se desea reemitir la factura completa.
Factura de canje
Convierte una factura simplificada en una normal. Es habitual cuando un cliente solicita una factura completa después de haber recibido un ticket.
Factura de abono
Para devoluciones totales o parciales. Se vincula a la factura original y refleja importes negativos.
Ver los ejemplos de facturas rectificativas, de canje y de abono.
Casos especiales: suplidos, recargo de equivalencia, inversión del sujeto pasivo y más
Además de los tipos más comunes, los ejemplos cubren escenarios que muchos ERPs necesitan gestionar:
Suplidos y retención
Facturas que incluyen pagos por cuenta del cliente (suplidos) y retenciones de IRPF, habituales en el ámbito de los profesionales autónomos.
Recargo de equivalencia
Obligatorio para determinados comerciantes minoristas. La factura incluye un recargo adicional sobre la cuota de IVA.
Inversión del sujeto pasivo
En determinadas operaciones, es el destinatario quien debe declarar e ingresar el IVA. Se marca con la clave de régimen S2.
Factura emitida por terceros o por el destinatario
Para los casos en que la factura no la emite el proveedor directamente, sino un tercero autorizado o el propio destinatario (autofacturación).
Régimen de bienes usados (REBU)
Aplica a operaciones con bienes de segunda mano donde se tributa únicamente sobre el margen de beneficio, no sobre el precio total.
Operación no sujeta
Para operaciones que quedan fuera del ámbito de aplicación del IVA por localización u otras circunstancias.
Consulta todos estos ejemplos de casos especiales en la documentación.
Anulación y subsanación de facturas
Por último, la sección de ejemplos incluye los dos mecanismos de gestión posterior a la emisión:
Anulación
Permite invalidar una factura previamente registrada en Verifactu. Se envía un registro de anulación vinculado a la factura original.
Subsanación
Permite corregir errores en facturas ya enviadas sin necesidad de anularlas completamente. Es útil para correcciones menores que no afectan a los importes.
Ver los ejemplos de anulación y subsanación.
Cómo usar estos ejemplos en tu integración
Todos los ejemplos están disponibles en la sección de ejemplos de la API de Verifacti. Cada uno incluye el JSON completo que se envía al endpoint /verifactu/create, listo para copiar.
El flujo de trabajo recomendado es sencillo:
- Identifica el tipo de factura que necesitas generar.
- Copia el ejemplo correspondiente desde nuestra documentación.
- Adapta los datos (serie, número, fecha, importes, destinatario) a tu caso real.
- Envía la petición a la API de Verifacti. La API valida automáticamente los campos, el NIF contra el censo de la AEAT y las reglas fiscales aplicables.
Si tu software de facturación o ERP necesita cumplir con Verifactu, integrar la API de Verifacti es la forma más rápida y sencilla. Con más de 25 ejemplos reales, la curva de aprendizaje se reduce a días, no meses.