Solución de problemas

Esta sección está organizada por síntoma: lo que ves cuando algo falla, y qué revisar en cada caso.

Si prefieres partir del código de respuesta, la tabla de códigos los enumera todos con su significado.

Los cuatro culpables habituales

Antes de un diagnóstico largo, descarta estos cuatro en orden. Resuelven la mayoría de los casos:

¿Es el día 1 del mes o pasó hace poco? Puede ser una suspensión por créditos.
¿Están activos los productos? Y presionaste “Actualizar productos y límites”.
¿Está el proxy configurado y respondiendo?
¿La estructura del request coincide campo por campo con la documentación?

Errores 401 al consumir la API

Diagnóstico de los distintos 401: token inválido, cabecera mal formada, credenciales del SII y sesión caída.

Errores 403: sin acceso al recurso

Diagnóstico cuando la conexión no tiene productos asociados o no tiene acceso a una operación.

Errores 401 y 402: créditos y conexión suspendida

Diagnóstico cuando faltan créditos, la conexión está suspendida o la IP está en uso por otra conexión.

Errores de proxy y timeouts hacia el SII

Qué revisar cuando la API no logra salir al SII por el proxy de la conexión, incluidas las consultas que quedan colgadas y terminan canceladas por tu cliente.

Errores 400: estructura del request

Los siete errores de estructura que explican la mitad de los problemas reportados, con ejemplos correctos e incorrectos.

Recibo HTML o "Error interno" en vez de JSON

Diagnóstico de las respuestas 500 y 404 que llegan como página HTML en vez de JSON.

Errores 409, lentitud e intermitencias del SII

Cómo distinguir una indisponibilidad real del SII de un problema en el request o en el proxy, y cómo saber si una consulta cancelada alcanzó a ejecutarse.

Errores 429 y límite de consultas

Cómo funciona el límite de 60 consultas por minuto, qué provoca los 429 y cómo evitarlos.

Última actualización el 02/10/2026 por Anonymous

PDF Completo

Markdown Copiar Completo Copiar todo

Extraer PEM con OpenSSL

Errores 401 al consumir la API