¿Por qué mis consultas reutilizan la sesión del SII y cómo fuerzo una nueva?
Cuando envías credenciales en el cuerpo de la consulta, API Gateway inicia sesión en el SII y reutiliza esa sesión durante 1 hora 50 minutos desde la última consulta que requirió autenticación.
Es intencional: acelera las consultas siguientes, evita iniciar sesión una y otra vez y reduce el riesgo de que el SII bloquee tus accesos. Por eso la primera consulta de una serie es más lenta que las siguientes.
Cuando la sesión queda en mal estado, la API lo indica:
{ "code": 401, "detail": "Se debe volver a autenticar al usuario, problema con la sesión del SII (HTTP200)." }
y puede acompañarlo con la cabecera X-Auth-Session-Problem: 1. En ese caso puedes agregar auth_cache=0 a la URL para forzar un inicio de sesión nuevo.
Cada auth_cache=0 equivale a un login nuevo en el SII. Usarlo permanentemente en producción aumenta el riesgo de que el SII bloquee tus accesos y empeora el rendimiento. Es para casos puntuales.
Si consultas varias empresas en secuencia, revisa ¿Por qué recibo documentos de otra empresa?.