Scotiabank Empresas

Con la clave de internet de la empresa, scotiabank_empresas sincroniza saldos y movimientos del Portal Empresas de Scotiabank hacia el plano persistido de Connect, y dos tools de consulta los leen de esa caché sin esperar al banco. El conn_… de la conexión dice qué empresa lees y viaja en toda llamada (en REST, el header X-Connect-Connection).

Connect usa un navegador para iniciar sesión en el Portal Empresas y, con esa sesión, lee las cuentas por HTTP. La conexión no requiere que mantengas abierto un navegador ni un emulador.

Qué necesitas para conectar

En el enlace de conexión la persona entrega la clave de internet del Portal Empresas, en tres campos:

Scotiabank separa el RUT de la empresa del RUT de quien accede: la empresa se elige al autenticar. El acceso solo lee, y desde el dashboard se revoca en el acto. La clave no pasa por tu código: la entrega quien la tiene, en un enlace que sirve una sola vez.

Los alcances

Qué alcances quedan habilitados se decide por conexión, desde el dashboard.

Un movimiento

movimientos.consultar entrega, por fila, la cuenta, la fecha, la glosa del banco, el eje del monto y el saldo arrastrado:

{
  "id": "984225849|2026-10-19|5993780011|TPTOFF",
  "numeroCuenta": "984225849",
  "currency": "CLP",
  "periodo": "2026-10",
  "fecha": "2026-10-19T00:00:00.000Z",
  "monto": 1469510,
  "type": "cargo",
  "display": "-1.469.510",
  "saldoContable": 45335146,
  "descripcion": "TEF 77938106-4 Proveedor Ejemplo"
}

monto es la magnitud sin signo; type dice si la plata sale (cargo) o entra (abono); y display trae ese monto ya formateado a la chilena, con su signo. saldoContable es el saldo arrastrado tras el movimiento: conserva su propio signo. descripcion es la glosa tal como aparece en la cartola —en una transferencia incluye el RUT y el nombre de la contraparte—; Connect la conserva íntegra y no la interpreta.

La identidad del movimiento

La clave natural de un movimiento es la cuenta, la fecha, la referencia del banco y el tipo de la operación; no depende del período que pediste ni de la posición en la lista. Volver a sincronizar actualiza la misma fila en vez de duplicarla. Si en una misma respuesta dos movimientos compartieran esa clave, el período no se persiste: Connect prefiere no guardar antes que guardar dos hechos distintos bajo una sola identidad.

Sincronizar

curl -X POST https://connect.emisso.ai/api/v1/tools/scotiabank_empresas.conexion.sincronizar/execute \
  -H "Authorization: Bearer connect_sk_..." \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"periodo":"2026-10","alcances":["saldos","movimientos"]}}'

Esta ruta y el body del ejemplo corresponden a la tool scotiabank_empresas.conexion.sincronizar. El header X-Connect-Connection es obligatorio: usa el id de una conexión Scotiabank, que puedes obtener con GET /v1/connections. No uses el id de una conexión SII u otro banco.

La llamada encola el trabajo. El resultado incluye estado: "encolado" y un jobId; consulta ese job para conocer los alcances completados y recordsSynced. Un trabajo encolado todavía no acredita una sincronización.

{
  "data": {
    "periodo": "2026-10",
    "estado": "encolado",
    "jobId": "sjb_...",
    "yaEnCurso": false
  },
  "meta": { "request_id": "req_...", "tool_id": "scotiabank_empresas.conexion.sincronizar", "plane": "read" }
}

Cada sincronización obtiene una sesión nueva y comparte el login entre los alcances solicitados. Como en los demás bancos, saldos es una foto del momento: en un período que no es el corriente termina en cero con su explicación en detalle. El resultado por alcance se lee en outcomes de GET /v1/syncs/{jobId}, en la API de control.

Verdades operativas

Una sesión por sincronización

Connect inicia sesión con un navegador, verifica la empresa autorizada y recorre las cuentas y las páginas de movimientos por HTTP. Al terminar elimina el material de sesión local. No conserva tokens para la siguiente sincronización.

Verificar y sincronizar

conexion.verificar comprueba el login y la autorización de la empresa sin persistir datos de negocio. conexion.sincronizar obtiene los saldos y movimientos y los guarda en Connect. Las consultas leen esos datos persistidos, sin abrir otra sesión bancaria.

El movimiento se pide por mes, en tramos

El Portal Empresas entrega los movimientos por rango de fechas, y Connect recorre el mes en tramos para respetar el máximo del portal. Cada movimiento queda archivado bajo el mes de su propia fecha, no bajo el período con el que se pidió la corrida.

Los montos son números, con la convención del libro del banco

type es el eje del libro del banco: cargo es plata que sale de la cuenta y abono plata que entra. monto es la magnitud sin signo y display el texto ya formateado con el signo que corresponde. Un saldo es un balance: no lleva type y conserva su propio signo.

Errores que vas a ver

El envelope de cada código está en el catálogo de errores.

Próximos pasos

• Las cuatro tools, con contrato completo: referencia de scotiabank_empresas.
• La separación entre escribir la caché y leerla: Sincronizar y consultar.
• Saber de cada sync sin preguntar: Webhooks.