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 cinco culpables habituales

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

  1. ¿Es el día 1 del mes o pasó hace poco? Puede ser una suspensión por créditos.
  2. ¿Estás en la plataforma correcta? V2 y Legacy son servicios independientes.
  3. ¿Están activos los productos? Y presionaste “Actualizar productos y límites”.
  4. ¿Está el proxy configurado y respondiendo?
  5. ¿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 402 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 con página HTML y de las respuestas que llegan sin cuerpo.
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 bloqueos por exceso de uso
Cómo funciona el límite de consultas, por qué se produce el bloqueo automático y cómo evitarlo.
Última actualización el 11/09/2026 por Anonymous
PDF Completo
Markdown Copiar Completo Copiar todo
Anterior
Extraer PEM con OpenSSL
Siguiente
Errores 401 al consumir la API