¿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 | 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 | Parámetro formato o cabeceras |
| 409 | Conflicto con el SII, habitualmente indisponibilidad | Intermitencias del SII |
| 410 | Recurso ya no disponible en la API | Documentación vigente |
| 423 | Cuenta bloqueada por términos de uso | Términos y soporte |
| 429 | Límite de uso alcanzado | Bloqueos y límites de uso |
| 500 | Error interno | Respuestas HTML y error interno |
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 11/09/2026