Validar comprobante en SUNAT (consulta pública)
POST /api/services/validate_cpe
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Verifica la validez de un comprobante de cualquier emisor en la consulta pública de SUNAT (estado del comprobante y estado/condición del RUC emisor). Útil para validar comprobantes de proveedores.
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 |
|---|---|---|---|
numero_ruc_emisor |
string | Sí | RUC del emisor. |
codigo_tipo_documento |
string | Sí | 01, 03, 07, 08... |
serie_documento |
string | Sí | Serie. |
numero_documento |
string | Sí | Número. |
fecha_de_emision |
date | Sí | YYYY-MM-DD. |
total |
numeric | Sí | Importe total. |
Respuesta: data.comprobante_estado_codigo/_descripcion (0 NO EXISTE, 1 ACEPTADO, 2 ANULADO, 3 AUTORIZADO, 4 NO AUTORIZADO), empresa_estado_codigo/empresa_estado_description y empresa_condicion_codigo/_descripcion.
Reglas y errores: no hay validación previa (envía los 6 campos). La consulta depende de la web de SUNAT y puede fallar; en ese caso responde HTTP 200 con {success: false, data: {success: false, message}} (el mensaje va dentro de data). Si la empresa tiene credenciales de la API de SUNAT, prefiere Validar comprobante con la API de SUNAT.
Cuerpo
Content-Type: application/json
{
"numero_ruc_emisor": "20456789123",
"codigo_tipo_documento": "01",
"serie_documento": "F001",
"numero_documento": "4587",
"fecha_de_emision": "2026-11-01",
"total": "1180.00"
}
Respuestas
200 — Válido
{
"success": true,
"data": {
"comprobante_estado_codigo": "1",
"comprobante_estado_descripcion": "ACEPTADO",
"empresa_estado_codigo": "00",
"empresa_estado_description": "ACTIVO",
"empresa_condicion_codigo": "00",
"empresa_condicion_descripcion": "HABIDO"
}
}
200 — Error de consulta
{
"success": false,
"data": {
"success": false,
"message": "El codigo de captcha es incorrecto"
}
}
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.