Saltar al contenido principal
Docs Sitio Planes

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.

POST https://api.factosperu.com/api/v1/cpe
POST https://api.factosperu.com/api/v1/validacion-multiple-cpe

Campos requeridos

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.