Saltar al contenido
Facturador

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.