Créditos
El crédito es la unidad con que se mide y se cobra todo en API Gateway.
- Se compran en números enteros, con un mínimo por compra que la plataforma indica al generar el cobro.
- Son de la conexión: cada conexión tiene su propio saldo, no se comparten ni se traspasan entre conexiones.
- El servicio es prepago: no hay saldo negativo ni facturación a posteriori.
El valor del crédito, el costo mensual de cada producto y el costo por consulta de cada recurso están en el cotizador de precios, que además incluye un video explicativo del modelo de cobro. Los costos no se listan acá para que siempre consultes el valor vigente.
Los saldos y costos se expresan con tres decimales, porque la mayoría de las consultas cuesta una fracción de crédito.
Cuando la plataforma dice 20,000 créditos está diciendo veinte créditos, no veinte mil. Al comprar, escribir la cantidad con separador de miles genera una cotización por un monto miles de veces mayor al que buscabas. Revisa siempre la cantidad y el monto de la cotización antes de transferir.
Las tres formas en que se consumen
1. Base mensual, el día 1 de cada mes
Se descuenta la suma del costo de cada producto activo más el pack de usuarios de autenticación contratado. Ese total es tu base mensual, y lo ves en Gestionar conexión → Productos como “Base mensual estimada (tu selección)”.
Si el día 1 tu saldo no cubre la base completa, la conexión se suspende. No hay cobro parcial.
Al comprar créditos después de una suspensión, el sistema cobra solo el proporcional de los días que quedan del mes y reactiva la conexión automáticamente.
2. Cada consulta a la API
Además de la base mensual, cada llamada descuenta el costo de su operación. Tener el producto activo te da acceso a los recursos; no incluye las consultas.
El costo varía según lo que la operación implica del lado del SII: una consulta simple cuesta mucho menos que una que descarga y procesa un documento. El detalle por recurso está en el cotizador y en la documentación de la API.
3. Usuarios de autenticación adicionales
Cada credencial distinta con que te autentiques en el SII, más allá de las incluidas en tu pack, descuenta créditos una vez por período. Revisa Productos y límites.
Créditos de bienvenida
Al crear tu primera conexión recibes créditos de bienvenida, pensados para una prueba de concepto: validar que los recursos entregan lo que tu sistema necesita.
Se agotan rápido si activas varios productos, porque la activación cobra de inmediato. Conviene activar solo el producto que vas a probar y revisar antes la documentación del recurso, porque una consulta mal armada consume créditos igual y devuelve un error.
No es posible ampliarlos ni entregar una segunda tanda. Y crear cuentas o conexiones adicionales para acumularlos provoca el bloqueo de las cuentas involucradas, conforme a los términos y condiciones.
Qué consultas consumen créditos
No consumen los rechazos que ocurren antes de llegar al SII: token inválido, producto no activo, créditos insuficientes o IP en uso por otra conexión.
Sí pueden consumir las consultas que llegaron al SII, incluso si terminan en error. Un 409 por indisponibilidad del SII descuenta el costo de la operación, porque la operación se ejecutó.
Cómo monitorear el saldo
- La cabecera
X-Stats-Credits-Remainingviene en las respuestas de la API. Léela en tu integración y dispara una alerta interna cuando el saldo baje de tu base mensual. - El dashboard de la conexión muestra el consumo por consulta y por día.
- El historial de eventos de la conexión registra los descuentos mensuales y las activaciones de productos. Revisa Dashboard y registros.
Vencimiento y reembolsos
Los créditos no caducan por fecha, pero se consumen: mientras haya productos activos, la base mensual descuenta créditos cada día 1 aunque no hagas consultas.
No hay reembolsos de créditos comprados ni consumidos, y no se traspasan entre conexiones. Revisa los términos y condiciones.
Desactivar los productos detiene el cargo fijo mensual, y desactivar no tiene costo. El saldo restante queda disponible. Ten presente que volver a activarlos se cobra de nuevo.