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
Endpoint
Sección titulada «Endpoint»POST https://faktura-test.cgallardo.me/v1/documents/{id}/voidPOST https://faktura.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. |
Ejemplo
Sección titulada «Ejemplo»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" }'use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->post('https://faktura-test.cgallardo.me/v1/documents/01a1d60b-1d4e-7c8a-9f02-3b6c5d1e2f40/void', ['reason' => 'Error en el precio']);
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/documents/01a1d60b-1d4e-7c8a-9f02-3b6c5d1e2f40/void', { method: 'POST', headers: { Authorization: 'Bearer sk_test_...', 'Content-Type': 'application/json', }, body: JSON.stringify({ reason: 'Error en el precio' }),});const data = await response.json();Respuesta 202 Accepted
Sección titulada «Respuesta 202 Accepted»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.
Estados de la anulación (void.status)
Sección titulada «Estados de la anulación (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.
Flujo recomendado
Sección titulada «Flujo recomendado»- 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.
- Pide la baja con
POST /v1/documents/{id}/voidy un motivo claro. - Espera el ticket de SUNAT: el aviso
document.voidedodocument.void_rejectedpor webhook, ovoid.statusenGET /v1/documents/{id}. - Si SUNAT la rechaza, el comprobante sigue vigente: corrige y vuelve a pedirla, o emite una nota de crédito.
- Solo comprobantes
accepteduobserved(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.
Respuestas y errores
Sección titulada «Respuestas y errores»| 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. |