Documentación

Introducción a VeriFactu

VeriFactu es el sistema de la Agencia Estatal de Administración Tributaria (AEAT) para el control de la facturación empresarial en España. Este sistema requiere que todas las empresas envíen información sobre sus facturas emitidas y recibidas.

📋 Requisitos Principales

• Envío obligatorio en 4 días hábiles
• Firma digital XAdES requerida
• Formato XML Facturae 3.2.2
• Certificado digital válido

Configuración Inicial

1. Configurar Empresa

Primero, configura los datos de tu empresa en la sección de Configuración:

Configuración → Información de la Empresa

2. Instalar Certificado Digital

Sube tu certificado digital para la firma de facturas:

Configuración → Gestión de Certificados → Subir Certificado

3. Configurar AEAT

Selecciona el entorno de la AEAT (Producción o Pruebas):

Configuración → Configuración AEAT → Entorno: Producción

API Reference

Endpoints Principales

POST/api/invoices

Crear nueva factura

GET/api/invoices

Listar facturas

POST/api/invoices/{id}/submit

Enviar factura a AEAT

Ejemplos de Uso

Crear Factura

curl -X POST https://api.verifactu.es/api/invoices \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "number": "INV-001",
    "date": "2024-01-15",
    "client": {
      "name": "Empresa Demo S.L.",
      "nif": "B12345678"
    },
    "amount": 1250.00,
    "tax": 262.50
  }'

Enviar a AEAT

curl -X POST https://api.verifactu.es/api/invoices/123/submit \
  -H "Authorization: Bearer YOUR_TOKEN"

Solución de Problemas

Error: Certificado Expirado

Solución: Renueva tu certificado digital y súbelo en Configuración → Gestión de Certificados

Error: NIF Inválido

Solución: Verifica que el NIF/CIF del cliente tenga el formato correcto (ej: B12345678)

Error: Timeout AEAT

Solución: Los servicios de AEAT pueden estar temporalmente no disponibles. Reintenta en unos minutos.