Apariencia
Límites y planes
Cada cuenta tiene un plan que define tres cosas:
- Módulos: qué consultas puedes hacer.
- Cuota mensual: cuántas consultas exitosas puedes hacer en el mes calendario. Algunos módulos pueden tener una cuota mensual propia dentro del plan.
- Límite por minuto: cuántas consultas puedes hacer por minuto (cuenta todas las llamadas, exitosas o no).
Puedes ver tu plan, tu consumo del mes y el historial de consultas en app.consultape.pro.
Qué consume cuota
- Sí consume: cada consulta con
success: true. - No consume: consultas con
success: false(la fuente oficial falló o no tenía datos), errores 4xx y 5xx. - La cuota mensual se reinicia el primer día de cada mes.
Las consultas desde la web y desde la API comparten la misma cuota.
Cuando llegas a un límite
La API responde HTTP 429:
| Límite | Mensaje |
|---|---|
| Por minuto | Superaste el límite de 30 consultas por minuto de tu plan |
| Mensual del plan | Alcanzaste el límite mensual de 300 consultas de tu plan |
| Mensual del módulo | Alcanzaste el límite mensual de 1000 consultas de este módulo |
Si superas el límite por minuto, espera al minuto siguiente y reintenta. Si se agotó la cuota mensual, contacta con nosotros para ampliar tu plan.
Módulos
Cada endpoint de consulta exige un módulo. Si tu plan no lo incluye, la respuesta es 403 Tu plan no incluye esta consulta.
| Módulo | Consulta | Endpoint |
|---|---|---|
dni | Nombres y apellidos por DNI | GET /v1/dni/{numero} |
dni.nombre | DNI por nombres y apellidos | POST /v1/dni/buscar-por-nombre |
dni.fecha_nacimiento | Fecha de nacimiento y edad | GET /v1/dni/{numero}/fecha-nacimiento |
dni.ruc | RUC de persona natural asociado al DNI | GET /v1/dni/{numero}/ruc |
ruc | RUC desde el padrón SUNAT | GET /v1/ruc/{numero} |
ruc.plus | Ficha RUC completa | GET /v1/ruc/{numero}/completo |
ruc.establecimientos | Establecimientos anexos | GET /v1/ruc/{numero}/establecimientos |
ruc.representantes | Representantes legales | GET /v1/ruc/{numero}/representantes |
ruc.ficha | Ficha RUC en PDF desde SUNAT (clave SOL) | POST /v1/ruc/ficha |
tipo_cambio | Tipo de cambio SUNAT y SBS | GET /v1/tipo-cambio… |
cpe.validez | Validez de un comprobante | POST /v1/cpe/validez |
cpe.validez_masiva | Validez masiva desde Excel o TXT | POST /v1/cpe/validez-masiva |
cpe.cdr | Descarga de CDR | POST /v1/cpe/cdr |
cpe.xml | Descarga de XML | POST /v1/cpe/xml |
cpe.pdf | Descarga de PDF | POST /v1/cpe/pdf, POST /v1/cpe/pdf-desde-xml |
Planes
Los planes vigentes y sus precios se publican en app.consultape.pro. Como referencia, los planes base son:
| Plan | Consultas al mes | Por minuto | Módulos |
|---|---|---|---|
| Básico | 300 | 30 | dni, ruc, tipo_cambio, cpe.validez |
| Empresarial | 500 000 | 120 | Todos |
| Premium | 1 000 000 | 300 | Todos |
¿Necesitas otro volumen o una combinación distinta de módulos? Escríbenos desde la web y armamos un plan a tu medida.