Utilidades¶

Validar factura (dry-run)¶

Valida el payload de una factura sin registrarla ni enviarla a la AEAT.

POST /api/v1/invoices/validate

Acepta el mismo cuerpo que POST /invoices. Retorna 200 si es válido o 422 con los errores.

Clasificación fiscal automática¶

Determina automáticamente el tipo de operación fiscal.

POST /api/v1/invoices/classify

Campo	Tipo	Requerido	Descripción
`recipient_country`	string	✅	Código ISO 3166-1 alpha-2
`recipient_vat`	string	❌	Número de IVA (con prefijo país)
`issuer_territory`	string	❌	`peninsula`, `canarias`, `ceuta`, `melilla`

Ejemplo¶

curl -X POST https://api.verifactu.es/api/v1/invoices/classify \
  -H "Authorization: Bearer TU_API_KEY" \
  -d '{
    "recipient_country": "DE",
    "recipient_vat": "DE123456789"
  }'

{
  "data": {
    "operation_class": "B2B Intracomunitario",
    "operation_type": "E1",
    "regime_type": "02",
    "tax_type": "01",
    "tax_rate": 0,
    "notes": "Entrega intracomunitaria exenta. Verificar VIES."
  }
}

Clasificaciones soportadas¶

Caso	Resultado
🇪🇸 Nacional	S1, régimen 01, IVA 21%
🇪🇺 B2B Intracomunitario	E1, régimen 02, IVA 0%
🇪🇺 B2C OSS	S1, régimen 17, tipo local
🌍 Exportación	E2, régimen 02, IVA 0%
🇮🇨 Canarias	S1, régimen 01, IGIC
🇪🇦 Ceuta/Melilla	S1, régimen 01, IPSI

Cadena de hash¶

Consulta el estado de la cadena de hashes de un contribuyente:

GET /api/v1/chain/{nif}

{
  "data": {
    "nif": "B12345678",
    "last_hash": "SHA256...",
    "total_records": 42,
    "last_record_at": "2026-03-13T12:00:00Z"
  }
}

Health check¶

GET /api/v1/health

No requiere autenticación.