Ir al contenido

Anular un comprobante

Pide a SUNAT la anulación (baja) de un comprobante aceptado. Faktura elige el mecanismo según la serie:

Serie Comprobantes Mecanismo SUNAT
F… Facturas y sus notas Comunicación de baja (RA)
B… Boletas y sus notas Resumen diario con estado 3, anular (RC)

SUNAT no responde en el momento: devuelve un ticket que Faktura consulta en segundo plano hasta obtener el resultado.

Método: POST

POST https://faktura-test.cgallardo.me/v1/documents/{id}/void
Campo Tipo Obligatorio Descripción
reason texto Sí Motivo de la baja, hasta 100 caracteres. Se guarda en mayúsculas.
Ventana de terminal
curl -X POST https://faktura-test.cgallardo.me/v1/documents/01a1d60b-1d4e-7c8a-9f02-3b6c5d1e2f40/void \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{ "reason": "Error en el precio" }'

El comprobante con el bloque void:

{
"full_number": "F001-2",
"status": "accepted",
"void": { "status": "requested", "reason": "ERROR EN EL PRECIO" }
}

status sigue siendo el estado del envío del comprobante (accepted). El resultado de la baja está en void.status.

void.status Significado
requested Enviada a SUNAT; esperando la respuesta del ticket.
voided SUNAT aceptó la baja. El comprobante ya no tiene efecto tributario.
rejected SUNAT rechazó la baja o no pudo procesarla. El comprobante sigue vigente. Puedes corregir y pedirla otra vez, o emitir una nota de crédito.

Consulta GET /v1/documents/{id} con la misma espera progresiva que para el envío (Estados). SUNAT suele responder en segundos, pero en ocasiones tarda bastante más.

  1. Decide si corresponde anular: solo dentro de los 7 días calendario desde la emisión y si el comprobante no tiene notas. Si no, usa una nota de crédito.
  2. Pide la baja con POST /v1/documents/{id}/void y un motivo claro.
  3. Espera el ticket de SUNAT: el aviso document.voided o document.void_rejected por webhook, o void.status en GET /v1/documents/{id}.
  4. Si SUNAT la rechaza, el comprobante sigue vigente: corrige y vuelve a pedirla, o emite una nota de crédito.
  • Solo comprobantes accepted u observed (DocumentNotAccepted).
  • Dentro del plazo: hasta 7 días calendario después de la fecha de emisión (VoidWindowExpired). Pasado el plazo, usa una nota de crédito.
  • Una sola anulación en curso por comprobante (VoidAlreadyRequested); un comprobante anulado no se puede volver a anular (AlreadyVoided).
  • Un comprobante anulado o con anulación en curso no admite notas (AffectedDocumentVoided).
  • Un comprobante con notas de crédito o débito vigentes no se anula (DocumentHasNotes): primero anula sus notas.
Estado reason Significado
202 — Solicitud de baja aceptada y encolada para SUNAT (void.status: "requested").
401 Unauthenticated Falta la API key, es inválida o venció.
403 ApiKeyScopeInsufficient, EmitterInactive Clave de alcance lookup o empresa desactivada.
404 NotFound El comprobante no existe en tu empresa y entorno.
409 DocumentNotAccepted, VoidAlreadyRequested, AlreadyVoided, DocumentHasNotes, EmitterNotReadyForProduction, CertificateExpired El comprobante aún no está aceptado, ya tiene baja en curso o confirmada, tiene notas vigentes, o faltan credenciales vigentes en producción.
422 InvalidVoidReason, VoidWindowExpired, ValidationFailed Motivo vacío o de más de 100 caracteres, o venció el plazo de 7 días calendario (Errores de anulación).
429 TooManyRequests Superaste las 120 peticiones por minuto.