¿Para qué se usa?
Para saber cuántos folios te quedan sin usar según el SII, cuántos te autoriza por solicitud y qué rangos te timbraron antes. Es lo que consultas para decidir si necesitas pedir más, y cuántos pedir.
Qué hace
- Responde con la última foto guardada del estado de tus folios en el SII, junto con
as_of: cuándo se leyó.
- Devuelve la foto de un ambiente:
?sii_environment=certification para maullin, y sin el parámetro la de producción. Cada ambiente tiene su propia foto y su propio as_of.
- No va al SII en esta llamada, así que no bloquea. Para forzar una relectura usa
POST /folio-queries.
- Trae también
timbrajes: los rangos históricos que el SII tiene registrados a nombre de la empresa.
Cómo leer la respuesta
available: null o una lista results vacía significan “no lo sabemos”, no “cero folios”: nunca se consultó esa empresa, o el SII no publicó el dato en la última lectura. Pide un refresco antes de concluir que te quedaste sin folios.
consistent: false en una fila de timbrajes indica que la tabla del SII no cuadraba con su propio rango y la interpretamos en el orden habitual. El dato sirve de referencia, pero no lo uses como fuente de verdad para ese rango puntual.
