¿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 un tiempo, del orden de dos horas.
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 en la sesión del SII." }
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?.