Errores
Los errores responden con un código HTTP y un JSON con el código y un mensaje en español.
{
"error": "cuota_agotada",
"mensaje": "Se agotaron las consultas de tu plan y tus créditos."
}Usa el campo error en tu código: es estable. El mensaje puede cambiar de redacción.
| Código | HTTP | Mensaje |
|---|---|---|
ruc_invalido | 400 | El RUC debe tener 11 dígitos y un dígito verificador válido. |
lote_invalido | 400 | El cuerpo debe ser { "rucs": ["..."] } con al menos un RUC. |
lote_no_permitido | 403 | Tu plan no incluye consultas en lote o pediste más RUC de los permitidos. |
ubigeo_invalido | 400 | El ubigeo debe tener 6 dígitos. |
no_encontrado | 404 | No existe en el padrón de SUNAT. |
clave_faltante | 401 | Falta la cabecera Authorization: Bearer <tu clave>. |
clave_invalida | 401 | La clave no existe o fue revocada. |
ip_no_permitida | 403 | Esta clave no acepta peticiones desde tu IP. |
cuenta_suspendida | 403 | La cuenta está suspendida. Escríbenos para revisarla. |
limite_por_segundo | 429 | Demasiadas peticiones por segundo para tu plan. |
limite_por_minuto | 429 | Superaste el límite por minuto de tu plan. |
cuota_agotada | 429 | Se agotaron las consultas de tu plan y tus créditos. |
demasiados_intentos | 429 | Demasiadas claves inválidas desde tu IP. Espera unos minutos. |
ruta_no_existe | 404 | Esa ruta no existe. Revisa la documentación. |
error_interno | 500 | Error interno. Ya nos llegó el aviso. |
padron_no_disponible | 503 | El padrón se está cargando por primera vez. Intenta en unos minutos. |