¿Qué significa cada código de respuesta de la API?

Código Significado Dónde está el diagnóstico
200 Todo bien —
400 Petición inválida, o error del SII al procesarla Estructura del request
401 Token inválido, credenciales del SII incorrectas, sesión caída o conexión inactiva Errores 401
402 Créditos insuficientes, o IP en uso por otra conexión Errores 401 y 402: créditos y conexión suspendida
403 Sin acceso al recurso Errores 403
404 Ruta o recurso no encontrado URL base y rutas
405 Método HTTP incorrecto GET vs POST según la documentación del recurso
406 Formato de respuesta no aceptado La cabecera Accept debe admitir application/json
409 Conflicto con el SII, habitualmente indisponibilidad Intermitencias del SII
429 Límite de uso alcanzado Errores 429 y límite de consultas
500 Error interno Respuestas HTML y error interno
503 El servicio no pudo iniciar la consulta Reintenta más tarde; si persiste, genera un ticket
Diseña tu integración con un caso por defecto

Con el tiempo pueden añadirse o ajustarse códigos. Además de tratar los que conoces, deja un camino para los que no esperabas.

El detalle de cada código, con las cabeceras que ayudan a diagnosticarlo, está en manejo de errores.


Última actualización el 02/10/2026