API de validación de comprobantes
¿Esa factura existe en la SUNAT? Pregúntalo antes de pagarla
Antes de pagar a un proveedor, de dar por buena una compra o de cerrar el mes: la SUNAT responde si el comprobante existe, si está aceptado o anulado, y cómo está su emisor. Uno a uno o en lotes de 100.
curl https://acredita.stackealabs.com/api/v1/cpe/validar -H "Authorization: Bearer $ACREDITA_TOKEN" -H "Content-Type: application/json" -d '{"ruc_emisor":"20999999906","tipo":"01","serie":"F001","numero":1,
"fecha_emision":"2026-10-01","monto":"118.00"}'{
"success": true,
"data": {
"estado": "aceptado",
"estado_ruc": "ACTIVO",
"condicion_domicilio": "HABIDO",
"observaciones": []
},
"meta": { "origen": "sandbox", "request_id": "…" }
}Endpoints
POST/api/v1/cpe/validar
Un comprobante · plan Empresa
POST/api/v1/cpe/batch
Hasta 100 comprobantes por petición · plan Empresa
Con la credencial de tu empresa. La consulta va a la API oficial de la SUNAT con la credencial que tu empresa crea en SOL, y que nos confías: se guarda cifrada y solo sirve para tus consultas. Te guiamos a crearla. Para probar antes, un token de prueba responde con tres facturas del sandbox, sin credencial.
Qué devuelve
| Campo | Qué es | Presente en |
|---|---|---|
| estado | aceptado, anulado, autorizado, no_autorizado o no_existe | siempre |
| estado_ruc | El estado del emisor en la SUNAT: ACTIVO, BAJA DE OFICIO… | si el comprobante existe |
| condicion_domicilio | La condición de su domicilio fiscal: HABIDO, NO HABIDO… | si el comprobante existe |
| observaciones | Lo que la SUNAT añade sobre el comprobante, tal como lo dice | siempre |
| meta.origen | sunat_cpe, o sandbox con un token de prueba | siempre |
Preguntas frecuentes
¿Qué credencial necesito?
La de la API de consulta de validez de la SUNAT, de tu propia empresa. Se crea en SOL, en Empresas → Comprobantes de pago → Consulta de validez de comprobante de pago → Credenciales de API SUNAT: un nombre y una URL, y la SUNAT te da el client_id y el client_secret. Te guiamos por WhatsApp.
Tengo muchas empresas. ¿Una credencial por cada una?
No. Con la credencial de tu empresa se validan comprobantes de cualquier emisor. Un sistema que factura para cincuenta empresas carga una sola: la suya.
¿Cuenta como consulta?
Sí, una por comprobante, de la cuota del plan Empresa. Solo si la SUNAT respondió: si la SUNAT no está disponible o rechaza la credencial, no se cobra.
¿Puedo probar sin credencial?
Sí, con un token de prueba o con el token público del sandbox: la factura F001-1 responde aceptado, la factura F001-2 responde anulado, la factura F001-3 responde no_existe. Cualquier otro comprobante responde no_existe, y nada sale a la SUNAT.
¿Qué pasa si la SUNAT no responde?
La respuesta es 503 fuente_no_disponible, se puede reintentar y no se cobra. Un comprobante que no existe no es un error: es la respuesta, no_existe.
¿Guardan los comprobantes?
No. La respuesta de la SUNAT se te entrega y no se guarda; queda solo el registro de que consultaste. Si el emisor es una persona natural (RUC 10), su RUC se registra seudonimizado, nunca en claro.
¿Acredita emite comprobantes?
No. Valida los que ya existen: pregunta a la SUNAT por ellos. Emitirlos es otro servicio.