¿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