BCI PyME

El conector bci_pyme entra al portal Banco en Línea de BCI con la clave de la empresa, guarda saldos y movimientos en el plano persistido de Connect, y los sirve con dos tools de consulta que responden al instante. La conexión es la empresa: toda llamada lleva su conn_… (en REST, el header X-Connect-Connection).

Qué necesitas para conectar

El enlace de conexión pide la Clave de internet del portal, en tres campos:

El RUT de acceso y el RUT de la empresa son datos distintos a propósito: un mismo acceso puede administrar varias empresas. Cuando el portal ofrece más de un convenio, el conector elige el que coincide con el RUT de la empresa; y cuando ofrece uno solo, verifica igual que sea el configurado. Si no coinciden, la verificación falla pidiendo revisar ese campo, nunca sincroniza una empresa distinta en silencio.

El acceso es de solo lectura y se revoca al instante desde el dashboard. La clave la entrega quien la tiene, por el enlace de un solo uso: no pasa por tu código ni por el chat de un agente.

Los alcances

Los alcances se habilitan por conexión, desde el dashboard. Consultar un alcance apagado responde 403 alcance_not_enabled.

Sincronizar

Pide los alcances que necesites en la misma llamada: es un solo login contra el banco, y ese login toma cerca de 90 segundos.

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

Respuesta (recortada):

{
  "data": {
    "periodo": "2026-07",
    "results": [
      {
        "alcance": "saldos",
        "status": "ok",
        "recordsSynced": 0,
        "detalle": "Los saldos son una foto del momento, no del período, así que solo se sincronizan en el período corriente. Este cero NO significa que la cuenta no tenga saldo: pediste 2026-07; pide 2026-08 para obtenerlo."
      },
      { "alcance": "movimientos", "status": "ok", "recordsSynced": 2 }
    ]
  },
  "meta": { "request_id": "req_...", "tool_id": "bci_pyme.conexion.sincronizar", "plane": "read" }
}

Aquí se pidió julio siendo agosto el período corriente: movimientos sincroniza ese mes, y saldos devuelve cero con la explicación en detalle, porque los saldos son una foto del momento y solo se sincronizan pidiendo el período corriente. En el período corriente ambos alcances traen datos.

Si no quieres bloquear tu proceso durante el login, encola el trabajo por la API de control y entérate del resultado por webhook.

Verdades operativas

El banco admite una sola sesión activa por usuario

Entrar al portal corta la sesión de quien esté adentro, en ambas direcciones: una sincronización puede expulsar a la persona que está mirando la cartola en el navegador, y esa persona, al entrar, puede botar una sincronización en curso. Cuando le pasa al conector, el fallo se clasifica como upstream_error (reintentable), con la instrucción de reintentar en unos minutos sin nadie más usando ese acceso: las credenciales siguen buenas y no hay que reconectar nada.

Dos prácticas evitan el choque: una credencial dedicada para Connect (que ninguna persona use para navegar el portal) y una cadencia programada en un horario sin actividad. La cadencia (diaria, cada 12 o cada 6 horas) queda anclada a la hora en que la activas, así que activarla de noche la deja corriendo de noche.

El corte de 1000 movimientos por consulta

El endpoint del banco entrega a lo más los 1000 movimientos más recientes de una cuenta para el mes pedido: es el mismo tope de su propia interfaz, que sobre esa cifra ofrece exportar por Excel. Cuando una cuenta lo alcanza, el conector persiste igual todo lo que trajo y marca ese alcance con error: "movimientos_truncated" en el resultado del sync. Al consultar, el campo completo traduce ese estado: true significa que el último sync de ese período trajo todo, false que faltan filas del mes, y null (cuando consultas sin filtro de período) significa que no se sabe.

Débito y crédito van por el libro del banco

type clasifica cada movimiento al revés de como se lee una cartola: un abono (letra A del banco) es plata que entra y sale como debit; un cargo (letra C) es plata que sale y va como credit. monto es la magnitud sin signo y display trae ese monto formateado a la chilena con el signo ya aplicado, listo para mostrar. Los saldos no llevan type: son balances y conservan su propio signo, así que un sobregiro es negativo.

Las correcciones del banco entran como fila nueva

La identidad de un movimiento es una huella de su contenido, así que cuando el banco corrige un movimiento ya sincronizado, la corrección entra como una fila nueva en vez de reemplazar la anterior. Ante dos filas del mismo hecho, vale la de ultimaLecturaEn mayor: ese campo viaja en cada fila justamente para eso.

Errores que vas a ver

El detalle de cada código, con su envelope, está en el catálogo de errores.

Próximos pasos

• El contrato completo de las cuatro tools: referencia de bci_pyme.
• Por qué leer son dos pasos y qué implica: Sincronizar y consultar.
• Enterarte de cada sync sin sondear: Webhooks.