Saltar al contenido

Referencia / SUNAT

Validación de comprobantes

Comprueba contra SUNAT si un comprobante existe y en qué estado está.

POST /api/sunat/consulta-cpe

Para qué sirve: Validar la factura de un proveedor antes de registrarla como crédito fiscal.

Autenticación

X-API-Key string cabecera requerido
X-API-Key: tu_token
Authorization string cabecera
Authorization: Bearer tu_token

Cualquiera de las dos sirve. El token se genera desde el panel de cliente. Ir al panel →

Parámetros del cuerpo

ruc-consultante string requerido
Credencial de tu aplicación en SUNAT, la aportas tú. Ejemplo: 20123456789
client-id string requerido
Credencial de tu aplicación en SUNAT, la aportas tú. Ejemplo: a1b2c3d4-…
client-secret string requerido
Credencial de tu aplicación en SUNAT, la aportas tú. Ejemplo: ••••••••
ruc-emisor string requerido
RUC de quien emitió el comprobante. Ejemplo: 20987654321
cod-comprobante string requerido
Tipo de comprobante: 01 factura, 03 boleta. Ejemplo: 01
serie string requerido
Serie del comprobante. Ejemplo: F001
numero string requerido
Número correlativo. Ejemplo: 184
fecha-emision string requerido
Fecha de emisión, dd/mm/aaaa. Ejemplo: 15/03/2026
monto number requerido
Importe total. Solo para facturas y boletas. Ejemplo: 1416.00

Respuesta

Campos principales que devuelve esta consulta:

  • success
  • data.estadoCp
  • data.estadoRuc
  • data.condDomiRuc
  • data.*Descripcion

Códigos de estado

200 OK
Consulta resuelta. Descuenta una petición del plan.
401 Token inválido o vencido
Falta la cabecera de autenticación o el token no es válido.
403 Sin acceso
El plan no cubre este servicio o la suscripción no está activa.
404 No encontrado
La consulta se ejecutó pero no hubo resultados. También descuenta.
429 Límite alcanzado
Se agotaron las consultas del período.
500 Error del servicio
Fallo al consultar la fuente oficial. No se guarda en caché.