Consulta de comprobantes electrónicos
Con la Clave SOL del RUC consulta hasta 100 comprobantes por solicitud y devuelve sus archivos PDF, XML y CDR en Base64. Cada comprobante consume una unidad.
Campos requeridos
ruc: cadena requerida de 11 caracteres.usuario_solyclave_sol: cadenas requeridas.comprobantes: arreglo requerido con entre 1 y 100 elementos.
Consulta de CPE
Cada elemento de comprobantes se envía tal cual a SUNAT. Para un comprobante que tú emitiste:
{
"ruc": "20123456789",
"usuario_sol": "TU_USUARIO_SOL",
"clave_sol": "TU_CLAVE_SOL",
"comprobantes": [{
"tipo_consulta": "emitido",
"tipo": "01",
"serie": "F001",
"numero": "123"
}]
}
Con tipo_consulta: emitido se buscan comprobantes que emitiste; cualquier otro valor busca comprobantes recibidos y exige ruc_emisor. No uses credenciales reales en capturas ni ejemplos compartidos.
Validación múltiple de comprobantes
Para /api/v1/validacion-multiple-cpe, cada elemento lleva tipo, serie, numero, fecha y monto:
{
"ruc": "20123456789",
"usuario_sol": "TU_USUARIO_SOL",
"clave_sol": "TU_CLAVE_SOL",
"comprobantes": [{
"tipo": "01",
"serie": "F001",
"numero": "123",
"fecha": "FECHA_DE_EMISION",
"monto": "MONTO_DEL_COMPROBANTE"
}]
}
Usa la fecha de emisión y el importe total tal como figuran en el comprobante; SUNAT los compara con lo declarado.
Encabezados requeridos: Authorization: Bearer TU_TOKEN y Content-Type: application/json.
Respuesta
Toda respuesta trae success, code, retryable y time, más data si hubo éxito o message si hubo error. Códigos: 200 procesado, 422 campos inválidos, 500 si SUNAT no completó la consulta.
Ejemplo de respuesta (lista vacía):
{
"success": true,
"code": "found",
"retryable": false,
"data": {
"total": 0,
"exitosos": 0,
"fallidos": 0,
"comprobantes": []
},
"time": 0.12
}
La Clave SOL se usa solo para esa consulta: no se almacena ni se registra.