Validar comprobante con la API de SUNAT
POST /api/documents/validate-document
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Consulta el estado de un comprobante emitido por la empresa en la API de validación de SUNAT (requiere que la empresa tenga configuradas sus credenciales de API SUNAT) y lo traduce al estado de la plataforma.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
document_type_id |
string | Sí | 01, 03, 07, 08. |
series |
string | Sí | Serie. |
number |
numeric | Sí | Número. |
date_of_issue |
date | Sí | YYYY-MM-DD. |
total |
numeric | Sí | Importe total. |
Respuesta: data.state_type_id (05 aceptado, 11 anulado, -1 no existe en SUNAT), state_type_description, code_sunat (código de SUNAT), message_sunat, state_ruc y condition_ruc del emisor.
Errores: 422 {success: false, message: {campo: [...]}}; HTTP 200 con success: false si SUNAT rechaza la consulta; 500 si la empresa no configuró sus credenciales de API SUNAT.
Cuerpo
Content-Type: application/json
{
"document_type_id": "01",
"series": "F001",
"number": 1520,
"date_of_issue": "2026-11-07",
"total": 118.0
}
Respuestas
200 — Consultado
{
"success": true,
"message": "Consulta realizada correctamente.",
"data": {
"state_type_id": "05",
"state_type_description": "Aceptado",
"code_sunat": "1",
"message_sunat": "Operation Success! ",
"state_ruc": "ACTIVO",
"condition_ruc": "HABIDO"
}
}
422 — Validación
{
"success": false,
"message": {
"total": [
"El campo total es obligatorio."
]
}
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.