BCI PyME
Conecta el portal de empresas de BCI y obtén saldos y movimientos en una caché que se consulta al instante, sin tocar al banco.
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 Emisso, 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:
| Campo | Qué es |
|---|---|
| RUT de acceso | El RUT de la persona que inicia sesión en el portal. |
| Clave | Su clave de internet de BCI. |
| RUT de la empresa | La empresa (el convenio) que esta conexión va a leer. |
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.
Emisso solo consulta saldos y movimientos: nunca transfiere, paga ni cambia nada en la cuenta. Puedes eliminar la clave cuando quieras desde el dashboard. 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
| Alcance | Qué trae | Tool que lo lee |
|---|---|---|
saldos | Los cuatro saldos de cada cuenta (contable, disponible, contable a las 9AM y retención), como una foto por día (cómo leer el saldo de una cuenta) | bci_pyme.saldos.consultar |
movimientos | Los movimientos del período, con contraparte, categoría, mnemónico y saldo arrastrado | bci_pyme.movimientos.consultar y, para validar un pago, bci_pyme.transferencias.buscar (beta) |
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. No lo esperas tú: la llamada encola el trabajo y responde al instante.
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 de encolado (200, metadatos recortados):
{
"data": {
"periodo": "2026-07",
"estado": "encolado",
"jobId": "sjb_9f2kc0q8w1m4x7t3p6b5d",
"yaEnCurso": false
},
"meta": {
"request_id": "req_...",
"tool_id": "bci_pyme.conexion.sincronizar",
"plane": "read"
}
}La llamada acepta el trabajo y responde antes del login. Sigue data.jobId con
GET /api/v1/syncs/{jobId} hasta que termine y revisa los alcances en data.outcomes:
succeeded puede incluir alcances parciales o fallidos. La guía de seguimiento
explica la espera, los errores y el caso yaEnCurso: true con jobId: null.
Para esta llamada, outcomes queda así (recortado):
"outcomes": [
{
"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 }
]Aquí se pidió julio siendo agosto el período corriente: movimientos sincroniza ese mes, y saldos termina en 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.
Meses anteriores
Al conectar, Emisso trae el mes en curso y los dos anteriores. El panel no tiene un botón para pedir meses más antiguos de BCI PyME: Conexión → Sincronización → Cargar histórico existe solo para SII y Previred. Los meses anteriores se piden de dos formas:
- A tu agente, si lo conectaste por MCP. Pídele, por ejemplo, «trae los movimientos de BCI desde enero de 2025». El agente llama a
bci_pyme.conexion.sincronizaruna vez por mes. - Por API, con la misma tool y
periodo, un mes por llamada, o con la API de control y{"periodos":["2025-01","2025-02"],"alcances":["movimientos"]}, hasta 24 meses por petición.
Pide solo movimientos: en un mes cerrado, saldos vuelve en cero por la razón de arriba. Cada mes es un login aparte. Hasta dónde se llega lo define lo que conserve el banco: un mes que el portal ya no entrega sincroniza en cero, sin error.
Antes de depender de los datos
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.
La práctica que evita el choque es una credencial dedicada para Emisso, que ninguna persona use para navegar el portal. El horario sí hay que pensarlo: la cadencia de sincronización es 4h y no se configura, así que el conector corre seis veces al día, incluidas dos corridas en horario laboral (13:00 y 17:00), y no existe una franja de madrugada que evite el cruce. Si alguien en tu equipo navega el portal con el mismo acceso durante el día, esas dos corridas pueden expulsarlo de su propia sesión; la credencial dedicada de arriba es la única mitigación real, no el horario.
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
| Código | Qué significa | Qué hacer |
|---|---|---|
428 connection_credential_required | La conexión no tiene una credencial viva: nunca se vinculó, venció o fue revocada. | Emite un enlace de reconexión y pide la clave de nuevo. No reintentes con la credencial anterior. |
409 connection_busy | La conexión está en uso o el servicio alcanzó temporalmente su capacidad. | Espera unos segundos y reintenta. No reconectes ni vuelvas a ingresar credenciales. |
409 connection_sync_in_progress | Solo por POST /v1/connections/{conn}/syncs: ese período ya tiene una sincronización en cola o corriendo. La tool conexion.sincronizar no lo devuelve: responde yaEnCurso: true. | Sigue ese trabajo, o consulta directamente: puede que ya haya datos. |
502 upstream_error | El banco falló o cerró la sesión a mitad del login (típico de la sesión única). | Reintenta más tarde, idealmente sin nadie más usando ese acceso. |
El detalle de cada código, con su envelope, está en el catálogo de errores.
Próximos pasos
- El contrato completo de las cinco tools: referencia de
bci_pyme. - Validar un pago por transferencia (beta): la guía.
- Por qué leer son dos pasos y qué implica: Sincronizar y consultar.
- Enterarte de cada sync sin sondear: Webhooks.
Tesorería General de la República
Los convenios de pago de una empresa con la Tesorería: resoluciones, estado de pago, cuotas pagadas y por pagar, y deudas acogidas, con la Clave Tributaria del SII.
BCI 360: saldos, movimientos y nóminas de pago
Conecta BCI 360 para consultar saldos actuales, movimientos y el estado de las nóminas de pago de tu empresa mediante API o MCP.