Winkstec Perú API

Consultar en lote

POST /v1/ruc/lote valida varios RUC en una sola petición.

Disponible en los planes Pro (hasta 50 RUC por petición) y Empresa (hasta 100). Los duplicados se cuentan una vez y cobramos sólo los encontrados.

curl -X POST https://api.peru.winkstec.com/v1/ruc/lote \
  -H "Authorization: Bearer wk_live_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"rucs": ["20131312955", "20100047218", "20999999990"]}'

Respuesta 200

{
  "consultasCobradas": 2,
  "resultados": [
    { "ruc": "20131312955", "encontrado": true, "datos": { "razonSocial": "SUPERINTENDENCIA NACIONAL…", … } },
    { "ruc": "20100047218", "encontrado": true, "datos": { … } },
    { "ruc": "20999999990", "encontrado": false, "error": "no_encontrado" }
  ]
}

Los resultados vienen en el mismo orden en que los enviaste. Cada RUC mal escrito trae "error": "ruc_invalido".

Errores propios del lote

  • 400 lote_invalido: el cuerpo no es {"rucs": [...]} con al menos un texto.
  • 403 lote_no_permitido: tu plan no incluye lote o enviaste más RUC de los permitidos (el JSON trae maximo).
  • 429 cuota_agotada: tu cuota más tus créditos no alcanzan para todos los RUC válidos del lote.