Guía rápida de integración de las APIs de Verifacti
Esta guía explica paso a paso cómo integrar tu software con la API Verifactu, la API TicketBAI o la API SII, de la cuenta gratuita a producción. La cuenta, los NIFs, el modelo de representación y el paso a producción son comunes a todas; en los pasos que cambian según la API (envío, estado y correcciones) elige la tuya y la guía muestra solo lo que te aplica.
1. Crea una cuenta gratuita
Crea una cuenta gratuita en 30 segundos:
- Haz clic en el botón regístrate gratis.
- Introduce tu email y contraseña.
- Verifica tu email haciendo clic en el correo que te enviamos.
Una vez dentro accederás al panel de empresas, donde hay una empresa de prueba ya configurada para enviar facturas al entorno de prueba de la AEAT con Verifactu, desde nuestra interfaz o mediante la API. Se puede completar toda la integración básica con la cuenta gratuita.

La empresa de prueba es de Verifactu. Para probar TicketBAI o el SII necesitas un NIF de test de esa hacienda: pídelo a soporte@verifacti.com indicando cuál (Álava, Bizkaia, Gipuzkoa o SII) y te lo activamos.
Consulta qué incluye la cuenta gratuita y si puedo probar TicketBAI con la cuenta gratuita.
2. Envía una factura de prueba
Cuando entres a la empresa de prueba, verás una terminal integrada para enviar facturas a la AEAT. Dicha terminal ofrece una interfaz sencilla para cargar todo tipo de ejemplos de facturas y enviarlas con un solo clic al entorno de prueba de la AEAT.

La respuesta trae el código QR (como string en base 64) del registro de facturación generado, para que lo pegues en tu factura. El QR contiene la URL de la AEAT que permite ver si la factura ya está registrada en sus sistemas.
API - Crear facturas
Para generar un registro de facturación y enviarlo a la AEAT, llama a POST /verifactu/create con la API key del NIF de prueba (B75777847, el mismo en todas las cuentas), que está en su pestaña API key. Más detalle en la documentación.
POST /verifactu/create
{
"serie": "Ejemplos",
"numero": "1",
"fecha_expedicion": "19-11-2026",
"tipo_factura": "F1",
"descripcion": "Factura normal",
"nif": "A15022510",
"nombre": "Nombre destinatario",
"lineas": [
{
"base_imponible": "200",
"tipo_impositivo": "21",
"cuota_repercutida": "42"
}
],
"importe_total": "242"
}Más casos en los ejemplos de facturas Verifactu.
Llama a POST /ticketbai/create con la API key del NIF. El mismo endpoint y el mismo JSON sirven para Álava, Bizkaia y Gipuzkoa: la hacienda de destino es la del NIF. La respuesta trae al instante el uuid, el código TicketBAI (tbai), la url de cotejo y el qr; el código y el QR van impresos en la factura. Verifacti genera el fichero TicketBAI, lo firma y lo envía a la hacienda foral.
Tu software no tiene que inscribirse como software garante: el software garante es Verifacti, inscrito en las tres haciendas forales.
POST /ticketbai/create
{
"serie": "Ejemplos",
"numero": "1",
"fecha_expedicion": "19-11-2026",
"descripcion": "Factura completa",
"nif": "A15022510",
"nombre": "Nombre destinatario",
"cp": "48001",
"direccion": "Calle Ejemplo 1, Bilbao",
"lineas": [
{
"descripcion": "Servicio de consultoría",
"cantidad": "2",
"importe_unitario": "100.00",
"importe_total": "242.00"
}
],
"desglose_iva": [
{
"base_imponible": "200.00",
"tipo_impositivo": "21",
"cuota_impuesto": "42.00"
}
],
"importe_total": "242.00"
}Más casos en los ejemplos de facturas TicketBAI.
Llama a POST /sii/create con la API key del NIF. La API SII envía el libro registro de facturas expedidas, y solo ese. Verifacti valida la factura y responde con su uuid y el estado Pendiente: la factura queda en cola y sale hacia la AEAT en el siguiente envío del NIF. Si tienes muchas facturas, también puedes enviarlas en lote con POST /sii/create_bulk.
POST /sii/create
{
"ejercicio": "2026",
"periodo": "11",
"serie": "A",
"numero": "1",
"fecha_expedicion": "19-11-2026",
"tipo_factura": "F1",
"clave_regimen": [
"01"
],
"descripcion": "Factura normal",
"nombre": "Nombre cliente",
"nif": "A15022510",
"desglose": {
"no_exenta": {
"tipo_no_exenta": "S1",
"detalle_iva": [
{
"tipo_impositivo": "21",
"base_imponible": "200",
"cuota_repercutida": "42"
}
]
}
},
"importe_total": "242"
}Más casos, con claves de régimen, asiento resumen o criterio de caja, en los ejemplos del SII.
3. Confirma el estado
En todas las APIs, la forma recomendada de saber el resultado es con los webhooks, que te avisan de cada cambio de estado. También puedes consultarlo con el endpoint de estado de cada API, o verlo en la tabla de registros del panel.

Al enviar la factura, la API devuelve el estado Pendiente: el registro se ha generado y está en cola para enviarse a la AEAT, normalmente en uno o dos minutos. Por el propio funcionamiento de Verifactu, los registros no se envían de forma inmediata. Consulta el estado con GET /verifactu/status y el uuid que devuelve la creación, y lista las facturas presentadas con POST /verifactu/list. Ver la documentación de la API Verifactu.
Consulta el estado con GET /ticketbai/status y el uuid, o con POST /ticketbai/status por serie, número y fecha. Ver la documentación de la API TicketBAI.
Cuando la AEAT responde, el estado del registro se actualiza; consúltalo con GET /sii/status. Los estados posibles son, entre otros, Correcto, Aceptado con errores e Incorrecto; el detalle va en codigo_error y mensaje_error. Ver la documentación de la API SII.
4. Corrige o anula facturas
Si la factura no exige una rectificativa, subsánala con PUT /verifactu/modify y el registro corregido. Si exige una rectificativa, créala con POST /verifactu/create y el tipo_factura que corresponda (R1 a R5). Para anular, POST /verifactu/cancel con serie, número y fecha de expedición; una factura anulada no se puede volver a crear con los mismos datos. Casos en las rectificativas de Verifactu.
POST /verifactu/cancel
{
"serie": "A",
"numero": "1",
"fecha_expedicion": "25-02-2025"
}PUT /verifactu/modify
{
"rechazo_previo": "N",
"serie": "Ejemplos",
"numero": "1",
"fecha_expedicion": "19-11-2026",
"tipo_factura": "F1",
"nif": "A15022510",
"nombre": "Nombre destinatario",
"descripcion": "Descripcion modificada",
"lineas": [
{
"base_imponible": "200",
"tipo_impositivo": "21",
"cuota_repercutida": "42"
}
],
"importe_total": "242"
}Para anular, POST /ticketbai/cancel con serie, número y fecha de expedición. Para corregir en Álava y Gipuzkoa, PUT /ticketbai/modify con el mismo cuerpo que al crear y el campo accion: SUBSANAR o MODIFICAR. En Bizkaia no hay modificación ni subsanación por la API.
POST /ticketbai/cancel
{
"serie": "A",
"numero": "1",
"fecha_expedicion": "19-11-2026"
}PUT /ticketbai/modify (Álava y Gipuzkoa)
{
"accion": "SUBSANAR",
"serie": "Ejemplos",
"numero": "1",
"fecha_expedicion": "19-11-2026",
"descripcion": "Factura completa (datos corregidos)",
"nif": "A15022510",
"nombre": "Nombre destinatario",
"cp": "48001",
"direccion": "Calle Ejemplo 1, Bilbao",
"lineas": [
{
"descripcion": "Servicio de consultoría",
"cantidad": "2",
"importe_unitario": "100.00",
"importe_total": "242.00"
}
],
"desglose_iva": [
{
"base_imponible": "200.00",
"tipo_impositivo": "21",
"cuota_impuesto": "42.00"
}
],
"importe_total": "242.00"
}Si la AEAT acepta una factura con errores, se corrige con PUT /sii/modify y el cuerpo completo de la factura corregida. Si la rechaza (Incorrecto), no queda registrada: corrige los datos y vuelve a enviarla con /sii/create. Para dar de baja una factura del libro, POST /sii/cancel.
PUT /sii/modify
{
"ejercicio": "2026",
"periodo": "11",
"serie": "A",
"numero": "1",
"fecha_expedicion": "19-11-2026",
"tipo_factura": "F1",
"clave_regimen": [
"01"
],
"descripcion": "Factura normal (descripción corregida)",
"nombre": "Nombre cliente",
"nif": "A15022510",
"desglose": {
"no_exenta": {
"tipo_no_exenta": "S1",
"detalle_iva": [
{
"tipo_impositivo": "21",
"base_imponible": "200",
"cuota_repercutida": "42"
}
]
}
},
"importe_total": "242"
}POST /sii/cancel
{
"ejercicio": "2026",
"periodo": "11",
"serie": "A",
"numero": "1",
"fecha_expedicion": "19-11-2026"
}5. Activa la suscripción de pago
Para preparar el paso a producción, activa tu suscripción de pago:
- Navega a la página de precios.
- Haz clic en el botón de "Comprar primer NIF". Se te redirigirá a la página de pago.
- Marca la casilla "Estoy comprando como empresa" para introducir tu CIF, que aparecerá en las facturas.

El SII tiene precio a medida, fuera de la página de precios: pide una propuesta en contacto. Consulta cuándo empiezo a pagar.
6. Da de alta tus NIFs
Con la suscripción activa puedes crear tantas empresas emisoras en modo test como quieras, sin coste adicional. Accede al panel de empresas y haz clic en "+ Añadir empresa".

Elige bien el entorno y la hacienda. Las empresas de test envían al entorno de prueba y las de producción al real; solo estas últimas cuentan para la factura mensual. La hacienda fija el destino: verifactu, alava, vizcaya, guipuzcoa o sii. Cada combinación de NIF, entorno y hacienda es un NIF independiente con su propia API key, y un mismo NIF puede estar en varias haciendas a la vez.
API - Añadir NIFs emisores de facturas
Para enviar facturas de cientos o miles de empresas o autónomos, créalas con POST /nifs y la API key de tu cuenta, que está en los ajustes de la cuenta (sección API key). Cómo añadir, modificar o desactivar NIFs, en la documentación de la API de gestión de NIFs.
Recuerda que cada empresa tiene su propia API key para enviar sus facturas. Consulta cómo funcionan las API keys, los entornos y la gestión de NIFs.
7. Gestiona el modelo de representación
Para que Verifacti pueda enviar facturas en nombre de una empresa, hay que firmar un documento que nos autorice. Es el mismo para la AEAT (Verifactu y SII) y para las tres haciendas forales. Las empresas de prueba no lo necesitan, pero puedes rellenarlo desde la empresa de test y valdrá cuando la crees en producción.
Descarga el modelo ya cumplimentado desde la página de la empresa, donde se explica cómo rellenarlo, firmarlo y enviarlo. También se puede firmar online, con verificación por vídeo y sin certificado digital (2,90 € + IVA por firma, solo personas físicas): firma online.

API - Modelo de representación
Los modelos se pueden rellenar y enviar por API con la API key de tu cuenta (ajustes de la cuenta, sección API key). Detalle en la documentación.
Consulta cómo funciona la gestión de certificados y modelos de representación.
8. Pasa a producción
Con la integración completa y el modelo de representación firmado, crea la misma empresa en el entorno de producción, con su hacienda, y cambia la API key de test por la de producción. Los NIFs de producción son los que cuentan para la suscripción; un mismo NIF dado de alta en dos haciendas cuenta como dos NIFs.
API - Crear empresas en producción
Para pasar tus empresas de test a producción por API, encadena los endpoints de listar NIFs, obtener cada uno y crearlo en producción, con la API key de tu cuenta. Detalle en la documentación de la API de gestión de NIFs.
- TicketBAI en Bizkaia: la API envía cada factura emitida al LROE de Batuz (modelo 140 o 240). Más en TicketBAI en Bizkaia.
- SII: cuenta con el plazo de cuatro días naturales desde la expedición de cada factura, sin contar sábados, domingos ni festivos nacionales (ocho en las facturas expedidas por el destinatario o por un tercero). Detalle en los plazos del SII.
9. Publica la declaración responsable (solo Verifactu)
Para cumplir con Verifactu no hay homologación externa ni verificación por parte de la AEAT: cada software de facturación debe incluir un documento que autocertifique que cumple los requisitos. TicketBAI y el SII no la piden.
Con una API como la nuestra, tanto tu software como Verifacti deben tener su declaración responsable. Puedes descargar la de Verifacti (PDF) y usar nuestra plantilla para preparar la tuya. Consulta cómo publicar la declaración responsable.
Sigue con la integración
Ya tienes el flujo completo. Para seguir, lee la documentación de tu API y copia los ejemplos de facturas.
Preguntas frecuentes
Más preguntas frecuentes¿Cuánto tiempo se tarda en hacer la integración?
¿Son diferentes las URLs de los endpoints en los entornos de test y producción?
- En entorno de test, la API key de la empresa empieza por vf_test_
- En entorno de producción, la API key de la empresa empieza por vf_prod_
¿Debo realizar una nueva integración para TicketBAI o es una misma integración para TicketBAI y Verifactu?
- Consistencia: los endpoints, campos y mensajes de error que presentamos a nuestros usuarios son prácticamente los mismos que en las APIs de las administraciones.
- Facilidad en consultas fiscales: esta similitud elimina interpretaciones o sesgos derivados de una API intermedia, lo que agiliza la comunicación con asesores y con las propias administraciones.
¿Puedo probar TicketBAI con la cuenta gratuita?
¿Cuándo empiezo a pagar? ¿Tengo que pagar ya si Verifactu todavía no es obligatorio?
¿Cómo hago mi declaración responsable?
- Proporcionamos un documento de Word editable.
- Incluimos notas informativas para los apartados más complicados.
- Añadimos una sección para explicar el papel de la API Verifacti.
- Los títulos de sección están en negrita y con letra más grande.
- Sustituye las respuestas de ejemplo con tus propios datos.
- Borra las notas informativas al completar el documento.
Empieza con la cuenta gratuita
El primer paso de la guía: entorno de test y NIF de prueba incluidos.