# API Verifactu para tu software de facturación

La API Verifactu de Verifacti conecta tu software de facturación con la Agencia Tributaria (AEAT): envías cada factura en JSON, recibes el código QR al instante y Verifacti genera el registro de facturación, lo encadena y lo envía a la AEAT en nombre del contribuyente, sin que necesites certificado digital. Puedes probarla con una cuenta gratuita, que incluye entorno de test y NIF de prueba.

## Cómo funciona la API Verifactu

1. **Envías la factura en JSON.** Tu software llama a la API con los datos de la factura y la API key del NIF emisor.
2. **Recibes el QR al instante.** La respuesta trae el QR en Base64, listo para imprimir en la factura.
3. **Verifacti envía el registro a la AEAT.** Generamos el registro de facturación, calculamos la huella (hash), lo encadenamos con el anterior y lo enviamos a la AEAT en segundo plano.

El envío a la AEAT no bloquea la emisión de la factura: el resultado te llega por webhook o consultando el estado del registro.

## Ejemplo: crear una factura con la API Verifactu

Una factura completa (F1) contra el entorno de test. Copia la petición, pon tu API key de test y funciona.

```bash
curl -X POST https://api.verifacti.com/verifactu/create \
  -H "Authorization: Bearer $VERIFACTI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serie": "A",
    "numero": "1",
    "fecha_expedicion": "19-11-2026",
    "tipo_factura": "F1",
    "descripcion": "Factura normal",
    "nif": "A15022510",
    "nombre": "Nombre cliente",
    "lineas": [{
      "base_imponible": "200",
      "tipo_impositivo": "21",
      "cuota_repercutida": "42"
    }],
    "importe_total": "242"
  }'
```

```json
{
  "uuid": "b018ced3-b362-4494-8776-9eefff1c160c",
  "estado": "Pendiente",
  "url": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=…",
  "qr": "iVBORw0KGgoAAAANSUhEUgAA…",
  "huella": "B11F3A015173AD99075E2720F61E2DE1…"
}
```

## Qué incluye la API Verifactu

- **Validación antes de enviar.** Cada factura se valida antes de enviarla a la AEAT, también el NIF del destinatario en la AEAT y en VIES, y si hay un error vuelve con un código ([catálogo de códigos](https://www.verifacti.com/openapi/codigos-verifactu.yaml)).
- **QR al instante.** En la respuesta, en Base64, para imprimirlo junto a la leyenda VERI*FACTU. [Tamaño y posición del QR](https://www.verifacti.com/verifactu/qr).
- **Reintentos sin duplicados.** Con la cabecera `Idempotency-Key`, repetir la misma petición devuelve la respuesta original durante 24 horas.
- **Respuestas de la AEAT por webhook.** O consultando el estado del registro cuando quieras.
- **Rectificativas, anulación y subsanación.** Rectificativas (R1–R5) y abonos con el mismo endpoint de creación; anulación y modificación con los suyos. [Ejemplos de rectificativas](https://www.verifacti.com/recursos/ejemplos/verifactu/rectificativas).
- **Sin certificado digital.** Verifacti es colaborador social de la AEAT. Cada contribuyente firma una vez el [modelo de representación](https://www.verifacti.com/api-gestion-nifs/modelo-de-representacion), también [online, sin certificado](https://www.verifacti.com/api-gestion-nifs/modelo-de-representacion/firma-online).
- **Solo modalidad VERI*FACTU.** Cada registro se envía a la AEAT en tiempo real; la API no cubre la modalidad NO VERI*FACTU. [Modalidades de Verifactu](https://www.verifacti.com/verifactu/modalidades).
- **Tus datos, en la UE y exportables.** Los datos se alojan en la Unión Europea y puedes exportar los registros cuando quieras. El SLA está en los términos de uso.

## Una integración por normativa sobre la API de gestión de NIFs

Integras una vez la [API de gestión de NIFs](https://www.verifacti.com/api-gestion-nifs): alta, activación y baja de NIFs, representación y webhooks. Cada normativa añade su propia integración de envío, pegada a la API de la administración de destino. Si un NIF tributa en Álava, Bizkaia o Gipuzkoa, usa la API TicketBAI con la misma gestión de NIFs.

- [API TicketBAI](/api-ticketbai): Para los NIFs que tributan en Álava, Bizkaia o Gipuzkoa.
- [API SII](/api-sii): SII (Suministro Inmediato de Información): libro registro de facturas expedidas, para grandes empresas, grupos de IVA y REDEME.
- [API Factura Electrónica](/api-factura-electronica) (próximamente): Factura B2B entre empresas y profesionales.

## Verifactu: fechas y a quién aplica

Verifactu es el sistema de la AEAT para que el software de facturación genere registros inalterables y, en modalidad VERI*FACTU, los envíe en tiempo real ([RD 1007/2023](https://www.boe.es/eli/es/rd/2023/12/05/1007/con)). Aplica en territorio común; quien está en el SII o tributa en territorio foral queda fuera.

| Quién | Fecha | Estado | Norma |
| --- | --- | --- | --- |
| Productores y comercializadores de software de facturación | Desde 29 jul 2025 | En vigor | [RD 1007/2023](https://www.boe.es/eli/es/rd/2023/12/05/1007/con), [Orden HAC/1177/2024](https://www.boe.es/eli/es/o/2024/10/17/hac1177/con) |
| Contribuyentes del Impuesto sobre Sociedades | 1 ene 2027 | Publicada en el BOE con fecha futura | [RDL 15/2025](https://www.boe.es/diario_boe/txt.php?id=BOE-A-2025-24446) |
| Resto de obligados, autónomos incluidos | 1 jul 2027 | Publicada en el BOE con fecha futura | [RDL 15/2025](https://www.boe.es/diario_boe/txt.php?id=BOE-A-2025-24446) |
| Aplazamiento de las obligaciones pendientes | oct 2028 | Anunciada sin norma publicada | [Nota de Hacienda, 5 oct 2026](https://www.hacienda.gob.es/sgt/gabsehacienda/nota-informativa-verifactu.pdf) |

Esta información no es asesoramiento.

## Precio de la API Verifactu

Desde 14,99 € /mes por NIF activo en producción, sin IVA

- El precio por NIF baja con cada tramo de NIFs.
- Hasta 3.000 registros de facturación al mes por NIF.
- Firma online del modelo de representación: 2,90 € + IVA.
- Entorno de test y NIF de prueba gratuitos.
- Plan anual con un 10 % de descuento, sin costes de instalación.
- Mismo precio con la API TicketBAI.
- [Plan Startup](https://www.verifacti.com/soluciones/startups) para empresas de menos de 12 meses, con menos de 100.000 € de facturación y menos de 200.000 € de financiación.

[Ver todos los precios](/precios)

## Preguntas sobre la API Verifactu

### ¿Necesito un certificado digital para enviar facturas a Verifactu con la API?

No. Verifacti es colaborador social de la AEAT y envía con su propio certificado, una vez que el contribuyente firma el modelo de representación. Se puede firmar online, sin certificado.

### ¿Hay un entorno de pruebas para Verifactu?

Sí. La cuenta gratuita incluye entorno de test con API keys `vf_test_`, que envían al entorno de pruebas de la AEAT, y un NIF de prueba. Las URLs de la API son las mismas en test y en producción.

### ¿Se ha aplazado Verifactu? ¿Tengo que integrar ya?

Las fechas del BOE siguen siendo el 1 de enero de 2027 para el Impuesto sobre Sociedades y el 1 de julio de 2027 para el resto. Hacienda ha anunciado un aplazamiento a octubre de 2028, sin norma publicada. Para quien fabrica o vende software de facturación, la obligación está en vigor desde el 29 de julio de 2025. [Plazos de Verifactu](https://www.verifacti.com/verifactu/plazos).

### ¿Me ayudáis con la declaración responsable?

Sí. Tu software necesita su propia declaración responsable, y Verifacti tiene la suya como componente externo. Te damos una [plantilla en Word](https://storage.googleapis.com/verifacti_non_sensitive/Declaracion%20Responsable%20Clientes.docx) adaptada del ejemplo de la AEAT, con notas para los apartados más complicados y una sección que explica el papel de Verifacti. La versión vigente de nuestro software, que tienes que indicar, la devuelve `GET /verifactu/declaracion`. Más en [declaración responsable](https://www.verifacti.com/api-verifactu/declaracion-responsable).

### ¿Cuánto se tarda en integrar la API Verifactu?

En la mayoría de casos, de uno a tres días de un desarrollador, más algunos días de ajustes.

### Ya tengo Verifactu integrado. ¿Me sirve para la factura electrónica B2B?

La API de gestión de NIFs que ya tienes integrada sirve. La factura electrónica tendrá su propia integración de envío, con la API Factura Electrónica, que llegará próximamente.

## Todo lo que necesitas para integrar

- [Documentación de la API Verifactu](/docs)
- [Guía rápida](/recursos/guia-rapida?api=verifactu)
- [Ejemplos de facturas](/recursos/ejemplos/verifactu)
- [Glosario de Verifactu](/recursos/glosario/verifactu)
- [Especificación OpenAPI](/openapi/verifactu.yaml)
- [llms.txt](/llms.txt)
