Anulaciones

Registra la anulación de una factura previamente aceptada por la AEAT.

Anular vía registro de anulación

POST /api/v1/cancellations

Campo	Tipo	Requerido	Descripción
taxpayer_id	uuid	✅	ID del contribuyente
computer_system_id	uuid	✅	ID del sistema informático
invoice_number	string	✅	Nº de la factura a anular
invoice_date	date	✅	Fecha de la factura original

curl -X POST https://api.verifactu.es/api/v1/cancellations \
  -H "Authorization: Bearer TU_API_KEY" \
  -d '{
    "taxpayer_id": "uuid",
    "computer_system_id": "uuid",
    "invoice_number": "F-2026-042",
    "invoice_date": "2026-03-01"
  }'

Anular vía endpoint directo

POST /api/v1/invoices/{id}/annul

Método alternativo que solo requiere el ID de la factura. El sistema buscará automáticamente los datos necesarios.

Requisitos

• La factura original debe estar en estado accepted o accepted_with_warnings
• Solo se pueden anular facturas de tipo registration
• La anulación genera un nuevo registro con record_type: cancellation

graph LR
    A["Factura aceptada"] --> B["POST /annul"]
    B --> C["Registro de anulación"]
    C --> D["Envío a AEAT"]
    D --> E["Estado actualizado"]