Anular una factura

La factura pasa a annulled, voided_at empieza a informar de cuándo ocurrió y el estado es terminal: anular es irreversible y no hay vuelta a sent ni a draft.

¿Anular o rectificar? Anula cuando el documento entero nunca debería haber existido y no se ha cobrado — la factura se retira en bloque y no se produce ningún documento rectificativo.

Emite una rectificativa (POST /v1/invoices/{id}/corrective) cuando la factura ya estaba cobrada, o cuando solo está mal en parte (importe, destinatario, devolución parcial): una factura paid no se puede anular nunca, y anular no corrige jamás una cifra.

Lo que anular no hace: el número correlativo de la serie ni se libera ni se reutiliza (el contador de la serie solo avanza), la factura original no se borra y su registro de alta en VeriFactu no se retira.

Cuando la empresa está acogida a VeriFactu, se encola un registro de anulación ante la AEAT de forma asíncrona con tu reason como motivo — un 200 significa que la factura está anulada de nuestro lado, no que la AEAT ya haya procesado la anulación.

Con VeriFactu inactivo la anulación es puramente interna.

Límites: solo se puede anular una factura en sent u overdue.

Un draft no es anulable (bórralo en su lugar), y paid, cancelled y annulled devuelven 422. Una factura que es rectificativa no se puede anular nunca — para deshacer una rectificativa equivocada, emite una nueva rectificativa de la original.

Fíjate en que lo inverso sí se admite: tener rectificativas no impide anular la original.

Llama antes a GET /v1/invoices/{id}/can-annul si necesitas comprobar la elegibilidad sin intentar el cambio.

Aquí reason es opcional y se persiste un texto de relleno cuando lo omites.

POST /v1/invoices/{id}/annul es exactamente la misma operación con reason obligatorio — prefiérela siempre que el motivo tenga que quedar documentado.