API REST completa para Verifactu y Ticketbai

Integra el cumplimiento fiscal en tu aplicación con una API moderna, documentada y fácil de usar. Compatible con todos los lenguajes de programación.

Probar en Playground Ver Endpoints

Características técnicas

API REST Estándar

Endpoints RESTful con métodos HTTP estándar, respuestas JSON y códigos de estado HTTP apropiados.

Autenticación Segura

API Keys con scopes granulares, rate limiting inteligente y logs de auditoría completos.

Alta Disponibilidad

SLA del 99.99%, infraestructura redundante y monitoreo 24/7 para máxima confiabilidad.

SDKs Nativos

Librerías oficiales para Python, Node.js, PHP, Java y .NET con tipado fuerte y validaciones.

Webhooks

Notificaciones en tiempo real de cambios de estado, errores y actualizaciones de facturas.

Validaciones Inteligentes

Validación automática de datos fiscales, detección de errores y sugerencias de corrección.

Autenticación y seguridad

1

Obtener API Key

Regístrate y genera tu API Key desde el dashboard con los scopes necesarios.

2

Configurar Headers

Incluye tu API Key en el header Authorization de todas las peticiones.

3

Realizar Peticiones

Usa cualquier cliente HTTP para interactuar con nuestros endpoints seguros.

Ejemplo de autenticación:

# Configuración de headers
curl -X GET \
  "https://api.verifactu-api.com/v1/nifs" \
  -H "Authorization: Bearer tu_api_key_aqui" \
  -H "Content-Type: application/json"

Endpoints principales

GET

Listar NIFs

/v1/nifs

Obtiene la lista de todos los NIFs configurados en tu cuenta con su estado actual.

Respuesta de ejemplo:

{
  "data": [
    {
      "id": "nif_123",
      "nif": "12345678A",
      "nombre": "Empresa Ejemplo S.L.",
      "estado": "activo",
      "verifactu_habilitado": true,
      "ticketbai_habilitado": true
    }
  ],
  "total": 1
}
POST

Crear Factura

/v1/facturas

Crea una nueva factura y la envía automáticamente a Verifactu y/o Ticketbai según configuración.

Payload de ejemplo:

{
  "nif_emisor": "12345678A",
  "nif_receptor": "87654321B",
  "numero_factura": "FAC-2025-001",
  "fecha_expedicion": "2025-01-15",
  "lineas": [
    {
      "descripcion": "Servicio de consultoría",
      "cantidad": 1,
      "precio_unitario": 1000.00,
      "tipo_iva": 21
    }
  ]
}
GET

Estado de Factura

/v1/facturas/{id}/estado

Consulta el estado actual de una factura en Verifactu y Ticketbai, incluyendo posibles errores.

Respuesta de ejemplo:

{
  "id": "fac_456",
  "estado_verifactu": "aceptada",
  "estado_ticketbai": "aceptada",
  "qr_code": "https://api.verifactu-api.com/qr/abc123",
  "fecha_procesamiento": "2025-01-15T10:30:00Z"
}

Versiones de la API

Versión Estado Características Soporte hasta
v1 Estable Verifactu, Ticketbai, Webhooks básicos Diciembre 2026
v2 Beta GraphQL, Batch operations, Analytics En desarrollo
v0 Deprecated Funcionalidad básica Marzo 2025

Límites y cuotas

Plan Developer

100 requests/minuto
1,000 requests/día
Ideal para desarrollo y testing

Plan Startup

1,000 requests/minuto
50,000 requests/día
Perfecto para aplicaciones en producción

Plan Enterprise

Límites personalizados
Burst capacity disponible
SLA garantizado y soporte 24/7

¿Listo para integrar?

Comienza a usar nuestra API en menos de 5 minutos. Documentación completa, ejemplos funcionales y soporte técnico incluido.

Probar en Playground Ver documentación