API REST de ItSave: tus finanzas en tus sistemas
Conecta tu ERP, tus automatizaciones y tus aplicaciones internas con la información financiera de ItSave. Usa la misma capa de datos y seguridad que nuestro conector MCP, con límites de consumo, permisos por empresa y trazabilidad de cada consulta.
https://plataforma.itsave.cl/api/rest/v1curl https://plataforma.itsave.cl/api/rest/v1/flujo-caja/resumen \ -H "X-Api-Key: TU_API_KEY"
{
"periodo": "2026-08",
"ingresos": 8433096,
"egresos": 6286760,
"flujo_neto": 2146336
}
Dos formas de conectarte
Elige según quién se conecta: un sistema tuyo que solo consulta, o una aplicación externa que actúa en nombre de un usuario.
API Key
Solo lectura. Recomendada para integraciones internas que solo consultan informaciónX-Api-Key: TU_API_KEY- Permite exclusivamente operaciones de lectura.
- Está vinculada a una empresa.
- Puedes regenerarla o deshabilitarla cuando quieras.
- No permite crear ni enviar información.
- Cada consulta queda registrada.
Se obtiene en ItSave: Integraciones → API REST → Configurar
OAuth 2.0
Lectura y acciones. Recomendado para aplicaciones externas que actúan en nombre de un usuarioAuthorization: Bearer ACCESS_TOKEN- Identifica qué aplicación se conectó.
- Sabe qué usuario y qué empresa autorizaron el acceso.
- Solicita permisos específicos.
- La conexión se revoca desde ItSave.
- Ejecuta acciones solo después de una confirmación explícita.
La aplicación inicia el flujo, ItSave le muestra al usuario la empresa y los permisos, y la conexión queda en Integraciones.
Lo que puedes consultar y hacer
Movimientos, flujo de caja, facturas, cuentas por cobrar y pagar, y cotizaciones. Los mismos datos que ves en ItSave, listos para tus sistemas.
Documentación técnica
El catálogo se genera desde las herramientas realmente habilitadas, así que es la fuente más actualizada. Los recursos pausados temporalmente por protección de la infraestructura no aparecen en la especificación.
/movimientosMovimientos bancarios clasificados
/movimientos/sin-clasificarMovimientos pendientes de clasificación
/flujo-caja/resumenResumen del flujo de caja
/facturas/ventaFacturas de venta
/facturas/compraFacturas de compra
/facturas/detalleDetalle de una factura
/cuentas-por-cobrarCuentas por cobrar
/cuentas-por-pagarCuentas por pagar
/facturacion/resumenResumen de facturación
/cotizaciones/clientesBusca clientes disponibles para cotizar
/cotizaciones/productosBusca productos y servicios
/cotizaciones/prepararValida y prepara una cotización
/cotizaciones/crearCrea la cotización confirmada
/cotizaciones/preparar-envioPrepara y valida el envío
/cotizaciones/enviarEnvía la cotización confirmada
Nada se crea ni se envía sin un sí
Crear y enviar cotizaciones requiere OAuth y una confirmación en dos pasos. Una petición inicial nunca se interpreta como autorización.
La aplicación prepara
Envía la acción y recibe un resumen junto con un token temporal. Todavía no se crea ni se envía nada.
El usuario confirma
La persona revisa el resumen y confirma explícitamente que quiere crear o enviar la cotización.
La aplicación ejecuta
Con ese token temporal se ejecuta la acción. Sin la confirmación, el token no sirve.
Límites iniciales
Pensados para que la API responda rápido a todas las empresas.
Cuando superas un límite, la API entrega un error claro para que tu integración pueda esperar, paginar o reducir el rango solicitado.
Cada consulta queda registrada, tus datos no
Sabes quién consultó qué y cuándo, sin que ItSave guarde credenciales ni contenido financiero de las respuestas.
ItSave registra
- Aplicación o API Key utilizada
- Usuario asociado
- Empresa consultada
- Recurso ejecutado
- Fecha y hora
- Número de consultas y último uso
Por seguridad, no se guardan
- API Keys completas
- Tokens OAuth
- Parámetros enviados
- Contenido financiero de las respuestas
Antes de integrar
¿Cómo activo la API REST?+
Inicias sesión en ItSave, entras a Integraciones, luego a API REST y generas tu API Key. Se la entregas de forma segura al sistema que se va a conectar. La documentación no activa nada: solo explica la integración.
¿Qué diferencia hay entre API Key y OAuth 2.0?+
La API Key es para integraciones internas que solo consultan información: es de solo lectura y está vinculada a una empresa. OAuth 2.0 es para aplicaciones externas que actúan en nombre de un usuario: identifica la aplicación, al usuario y la empresa, pide permisos específicos y es la única forma de crear y enviar cotizaciones.
¿Una aplicación puede crear o enviar cotizaciones sola?+
No. Crear y enviar cotizaciones requiere OAuth y una confirmación en dos pasos: la aplicación prepara la acción, el usuario la revisa y confirma, y recién ahí se ejecuta. Una petición inicial nunca se toma como autorización.
¿Qué pasa si mi integración supera un límite?+
La API responde con un error claro para que tu integración espere, pagine o reduzca el rango de fechas. Los límites iniciales son 12 solicitudes por minuto por conexión, 2 consultas simultáneas por empresa y 100 resultados por consulta.
¿ItSave guarda lo que consulto?+
Registramos qué aplicación o API Key se usó, el usuario, la empresa, el recurso, la fecha y la hora. No guardamos las API Keys completas, los tokens OAuth, los parámetros que envías ni el contenido financiero de las respuestas.
¿Dónde veo los recursos disponibles hoy?+
En el catálogo de recursos y en la especificación OpenAPI. El catálogo se genera desde las herramientas realmente habilitadas, así que siempre está al día. Los recursos pausados temporalmente por protección de la infraestructura no aparecen.
Conecta ItSave con tus sistemas
Genera tu API Key en Integraciones y entrégasela a tu sistema de forma segura. Si todavía no usas ItSave, tu flujo de caja queda listo en 5 minutos.
