Productos y límites
Todo se administra en Gestionar conexión → Productos.
Qué es un producto
Un producto agrupa un conjunto de operaciones de la API. Para consumir una operación, el producto que la contiene debe estar activo en tu conexión.
Cada producto tiene un costo mensual en créditos, que se descuenta el día 1 de cada mes y es independiente de cuántas consultas hagas.
El listado de productos con su costo mensual, y el costo por consulta de cada recurso, están en el cotizador de precios. Ahí puedes armar tu combinación y estimar el total mensual antes de contratar. La misma pantalla de Productos de tu conexión muestra el costo de cada uno y la “Base mensual estimada (tu selección)” según lo que marques.
Los productos cubren: información de contribuyentes, Registro de Compra y Venta, Documentos Tributarios, Cesión de DTE, Boletas de Honorarios, Boletas de Terceros, Portal MiPYME, Portal eBoleta, Formulario 29, Bienes Raíces, Vehículos e Indicadores Previsionales.
Qué operaciones incluye cada producto
El código de cada operación indica el producto que la contiene. Cuando la API rechaza una consulta por autorización, el mensaje nombra ese código:
| Prefijo de la operación | Producto |
|---|---|
sii.contribuyentes.* |
Info. Contribuyentes |
sii.rcv.* |
Registro de Compra y Venta |
sii.dte.* |
Documentos Tributarios |
sii.rtc.* |
Cesión de DTE |
sii.bhe.* |
Boletas de Honorarios |
sii.bte.* |
Boletas de Terceros |
sii.mipyme.* |
Portal MiPYME |
sii.eboleta.* |
Portal eBoleta |
sii.f29.* |
Formulario 29 |
sii.bienes_raices.* |
Bienes Raíces |
sii.vehiculos.* |
Vehículos |
previred.indicadores.* |
Indicadores Previsionales |
Todos los productos incluyen además el acceso a sii.misii.* y sii.indicadores.*.
Activar productos
- Marca los productos que necesitas.
- Revisa la “Base mensual estimada (tu selección)”, que muestra el total que pagarás cada mes. La cantidad se muestra también en texto, para evitar confusiones con la coma decimal.
- Presiona “Actualizar productos y límites”.
Marcar los casilleros no guarda nada. Sin presionar “Actualizar productos y límites” la selección se pierde al recargar la página, y la API seguirá respondiendo 403. Es la causa más frecuente de los reportes de “activé el producto y no funciona”.
Lo que cuesta activar y desactivar
- Activar un producto descuenta créditos en ese momento, de forma proporcional a los días que restan del mes.
- Desactivar no tiene costo, pero tampoco devuelve lo cobrado.
- Volver a activar lo cobra otra vez, aunque sea el mismo mes y el mismo producto.
La plataforma advierte de esto al guardar:
¿Estás seguro de querer actualizar los productos y usuarios de autenticación? Los créditos consumidos no se reembolsarán, según las políticas explicadas en los Términos y Condiciones.
Por eso no conviene activar y desactivar productos para explorar: usa el cotizador, que es gratis y no consume créditos.
Usuarios de autenticación
Un usuario de autenticación es cada credencial distinta con la que la conexión inicia sesión en el SII: cada RUT y clave, o cada certificado, diferente.
Si eres una oficina contable que consulta por doce clientes con las credenciales de cada uno, esos son doce usuarios de autenticación.
- El servicio incluye un usuario gratuito.
- Cada usuario adicional distinto tiene un costo en créditos, que se descuenta una sola vez por usuario y por período mensual. Si vuelves a consultar por ese mismo usuario en el mismo mes, no se cobra de nuevo.
- Para muchas credenciales conviene contratar un pack de usuarios, que resulta más económico que pagarlos uno por uno.
Los packs son tramos fijos: no puedes combinar dos para llegar a una cantidad intermedia. Debes elegir el tramo que cubra la cantidad que necesitas, y solo están disponibles los publicados. Al indicar la cantidad de usuarios, el sistema calcula automáticamente el pack que corresponde.
Los tramos disponibles y su costo están en el cotizador y en la propia pantalla de Productos de tu conexión. Los usuarios con que ya te has autenticado en el período se ven en el dashboard de la conexión.
Límite de consultas
El límite estándar es de 60 consultas por minuto por conexión. Los límites de API Gateway están basados en los del SII y se ajustan si estos cambian.
Las respuestas traen X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset para que puedas controlarlo desde tu integración. Revisa Bloqueos y límites de uso.