Guías

Anulaciones

Anular = informarle a SUNAT que un documento aceptado debe considerarse inválido. Solo aplica a errores reales, no a cambios comerciales (eso es nota de crédito).

¿Cuándo se puede anular?

  • Documento aceptado por SUNAT (state == accepted).
  • Dentro de los 7 días calendario desde la emisión.
  • Tienes una razón documentable (error de datos del receptor, monto, etc.).

Endpoint

POST /v1/documents/:id/cancel
curl -X POST https://api.fiscal-web.pe/v1/documents/01ARZ3.../cancel \
  -H "Authorization: Bearer $FW_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ "reason": "Error en datos del receptor" }'

El estado pasa a pending_cancellation hasta que SUNAT confirma. Recibes un webhook document.canceled cuando se aprueba.

Límites

No se puede deshacer

Una vez SUNAT confirma la anulación, el documento queda marcado como nulo permanentemente. No puedes "re-activarlo".

Alternativa: nota de crédito

Si necesitas reducir el monto pero mantener la operación registrada (devolución parcial, descuento posterior), emite una nota de crédito en lugar de anular.