Consultar líneas de una cartola histórica de Banco de Chile
Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar.
| Tool ID | bch_empresas.cartolas.detalle |
| Nombre MCP | bch_empresas__cartolas__detalle |
| Conector | bch_empresas |
| Plano | action |
| Lee el alcance | cartolas (debe estar habilitado en la conexión) |
| Scope (permiso) | bch_empresas:read |
| Auth | none |
| Versión | 1 |
| Sensible | sí |
| Deprecado | no |
| Comportamiento | readOnly=true, destructive=false, idempotent=true, openWorld=false |
Requiere conexión. Indica cuál en cada llamada: header
X-Connect-Connectionen REST y campoconnectionIden elexecutede MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale deconexiones.estado.consultar.
Qué hace
Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. Lee un extracto ya sincronizado por cuenta, moneda y fecha de emisión, y pagina sus líneas disponibles. No contacta al banco: primero sincroniza el alcance cartolas. El detalle de líneas está disponible para extractos CLP y USD cuando se obtuvo; otros extractos ofrecen sólo el resumen con sus saldos. Conserva repeticiones y documentos textuales; no ofrece contraparte estructurada ni IDs equivalentes al feed de movimientos. Una cartola puede existir con lineas null: no implica que esté vacía.
Entrada
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
numeroCuenta | string | sí | Cuenta canónica tal como la devuelve cartolas.consultar, incluido el código de producto. |
fechaEmisionDay | string ^\d{4}-\d{2}-\d{2}$ | sí | Día de emisión del extracto en AAAA-MM-DD, sin zona horaria; no es el período pedido al sincronizar. |
currency | "CLP" · "USD" | no | Moneda del extracto, tal como la devuelve cartolas.consultar_v2. Si se omite se consulta CLP por compatibilidad; indica USD para un extracto en dólares. |
cursor | string | no | Para pedir la página siguiente: el valor que la respuesta anterior devolvió en 'cursor', tal cual. Nunca lo construyas ni lo edites a mano. Omítelo para empezar por la primera página. |
limit | entero 1-200 | no · default 100 | Máximo de líneas por página, entre 1 y 200; por omisión 100. |
JSON Schema de entrada
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"numeroCuenta": {
"type": "string",
"minLength": 1,
"description": "Cuenta canónica tal como la devuelve cartolas.consultar, incluido el código de producto."
},
"fechaEmisionDay": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Día de emisión del extracto en AAAA-MM-DD, sin zona horaria; no es el período pedido al sincronizar."
},
"currency": {
"description": "Moneda del extracto, tal como la devuelve cartolas.consultar_v2. Si se omite se consulta CLP por compatibilidad; indica USD para un extracto en dólares.",
"type": "string",
"enum": [
"CLP",
"USD"
]
},
"cursor": {
"description": "Para pedir la página siguiente: el valor que la respuesta anterior devolvió en 'cursor', tal cual. Nunca lo construyas ni lo edites a mano. Omítelo para empezar por la primera página.",
"type": "string"
},
"limit": {
"default": 100,
"description": "Máximo de líneas por página, entre 1 y 200; por omisión 100.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"required": [
"numeroCuenta",
"fechaEmisionDay"
]
}Ejemplo
curl -X POST https://connect.emisso.ai/api/v1/tools/bch_empresas.cartolas.detalle/execute \
-H "Authorization: Bearer connect_sk_…" \
-H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
-H "Content-Type: application/json" \
-d '{"input":{"numeroCuenta":"CTD12345678","fechaEmisionDay":"2026-07-31","limit":100}}'{
"tool": "bch_empresas.cartolas.detalle",
"params": {
"numeroCuenta": "CTD12345678",
"fechaEmisionDay": "2026-07-31",
"limit": 100
},
"connectionId": "conn_9tKfR2mQx4Vb"
}Salida esperada (200):
{
"data": {
"cartola": {
"numeroCuenta": "CTD12345678",
"tipoProducto": "CTD",
"currency": "CLP",
"fechaEmisionDay": "2026-07-31",
"periodo": "2026-07",
"numeroCartola": null,
"saldoInicial": null,
"saldoFinal": null,
"ultimaLecturaEn": "2026-08-10T14:05:00Z"
},
"formatoLineas": "xls_texto",
"lineas": [
{
"fecha": "2026-07-15",
"glosa": "Abono sintético",
"cargo": 0,
"abono": 1234,
"saldo": 5234,
"numeroDocumento": "00000123",
"transaccion": "0000",
"caja": "0000",
"sucursal": "OFICINA"
}
],
"totalLineas": 1,
"lineasLeidasEn": "2026-08-10T14:05:00Z",
"cursor": null
},
"meta": {
"request_id": "req_…",
"tool_id": "bch_empresas.cartolas.detalle",
"plane": "action",
"latency_ms": 24,
"audit_status": "recorded"
}
}Datos sintéticos. Las líneas pertenecen al extracto; no se deduplican ni se mezclan con movimientos.
Salida
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
cartola | objeto | null | sí |
cartola.numeroCuenta | string | sí | La cuenta a la que pertenece esta fila, con el código de producto adelante y sin el relleno de ceros del banco (por ejemplo 'CTD12345678'). Es el mismo valor en saldos, movimientos y cartolas, y el que espera el filtro 'numeroCuenta'. |
cartola.tipoProducto | string | sí | El tipo de producto de la cuenta según el índice de cartolas del banco (por ejemplo 'CTD'). Cuando el índice no lo trae, cae al código de producto de la cuenta. |
cartola.currency | string | sí | Código de tres letras de la moneda declarada por la cuenta, por ejemplo CLP o USD. Los importes se conservan en esa moneda, sin conversión a pesos. Las consultas v2 incluyen todas las monedas guardadas: agrupa los totales por currency, sin sumar monedas distintas. |
cartola.fechaEmisionDay | string | sí | El día (AAAA-MM-DD) en que el banco emitió este extracto. Junto con la cuenta y la moneda es lo que identifica a la cartola, y es lo que filtra el 'fechaEmisionDay' de la entrada. |
cartola.periodo | string | sí | El mes (AAAA-MM) con el que se buscó esta cartola, que no es la fecha del extracto: esa es 'fechaEmisionDay'. |
cartola.numeroCartola | string | null | sí |
cartola.saldoInicial | número | null | sí |
cartola.saldoFinal | número | null | sí |
cartola.ultimaLecturaEn | string | sí | Instante (ISO 8601) en que esta cartola se leyó del banco por última vez. |
formatoLineas | string | null | sí |
lineas | lista de objeto | null | sí |
lineas[].fecha | string | null | sí |
lineas[].glosa | string | null | sí |
lineas[].cargo | número | sí | Cheque o cargo, en la moneda del extracto (currency), con el signo declarado en el archivo. |
lineas[].abono | número | sí | Depósito o abono, en la moneda del extracto (currency), con el signo declarado en el archivo. |
lineas[].saldo | número | sí | Saldo de esta línea del extracto, en la moneda del extracto (currency); puede diferir del saldo del feed de movimientos. |
lineas[].numeroDocumento | string | null | sí |
lineas[].transaccion | string | null | sí |
lineas[].caja | string | null | sí |
lineas[].sucursal | string | null | sí |
totalLineas | entero | null | sí |
lineasLeidasEn | string | null | sí |
cursor | string | null | sí |
JSON Schema de salida
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"cartola": {
"anyOf": [
{
"type": "object",
"properties": {
"numeroCuenta": {
"type": "string",
"description": "La cuenta a la que pertenece esta fila, con el código de producto adelante y sin el relleno de ceros del banco (por ejemplo 'CTD12345678'). Es el mismo valor en saldos, movimientos y cartolas, y el que espera el filtro 'numeroCuenta'."
},
"tipoProducto": {
"type": "string",
"description": "El tipo de producto de la cuenta según el índice de cartolas del banco (por ejemplo 'CTD'). Cuando el índice no lo trae, cae al código de producto de la cuenta."
},
"currency": {
"type": "string",
"description": "Código de tres letras de la moneda declarada por la cuenta, por ejemplo CLP o USD. Los importes se conservan en esa moneda, sin conversión a pesos. Las consultas v2 incluyen todas las monedas guardadas: agrupa los totales por currency, sin sumar monedas distintas."
},
"fechaEmisionDay": {
"type": "string",
"description": "El día (AAAA-MM-DD) en que el banco emitió este extracto. Junto con la cuenta y la moneda es lo que identifica a la cartola, y es lo que filtra el 'fechaEmisionDay' de la entrada."
},
"periodo": {
"type": "string",
"description": "El mes (AAAA-MM) con el que se buscó esta cartola, que no es la fecha del extracto: esa es 'fechaEmisionDay'."
},
"numeroCartola": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "El número correlativo del extracto, SIEMPRE como texto: convertirlo a número le come los ceros a la izquierda. 'null' cuando el extracto no lo declara."
},
"saldoInicial": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "El saldo de apertura del extracto, en la moneda de la cuenta y con su propio signo: un sobregiro sale negativo. No cuadra necesariamente con la suma de 'movimientos' del mismo mes, porque el extracto encadena por fecha contable y el feed vivo por fecha del movimiento. 'null' cuando el extracto no lo declara."
},
"saldoFinal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "El saldo de cierre del extracto, en la moneda de la cuenta, con el mismo criterio de signo y la misma advertencia de cuadratura que 'saldoInicial'."
},
"ultimaLecturaEn": {
"type": "string",
"description": "Instante (ISO 8601) en que esta cartola se leyó del banco por última vez."
}
},
"required": [
"numeroCuenta",
"tipoProducto",
"currency",
"fechaEmisionDay",
"periodo",
"numeroCartola",
"saldoInicial",
"saldoFinal",
"ultimaLecturaEn"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Resumen del extracto persistido; null si todavía no está guardado."
},
"formatoLineas": {
"anyOf": [
{
"type": "string",
"const": "xls_texto"
},
{
"type": "null"
}
],
"description": "Formato de las líneas normalizadas guardadas. null cuando no están disponibles."
},
"lineas": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"fecha": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"x-emisso-formato": "AAAA-MM-DD",
"description": "La fecha de la línea del extracto, sin equipararla a la fecha contable del feed en formato AAAA-MM-DD, o null si no se pudo parsear. Es un día calendario sin zona horaria: compáralo como texto o con Date.UTC, porque new Date('2026-09-07') es medianoche UTC y en Chile se muestra como el 6. Es el campo que conviene usar para ordenar y filtrar."
},
"glosa": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Detalle del movimiento impreso en el extracto; null si la celda está vacía. No acredita una contraparte estructurada."
},
"cargo": {
"type": "number",
"description": "Cheque o cargo, en la moneda del extracto (`currency`), con el signo declarado en el archivo."
},
"abono": {
"type": "number",
"description": "Depósito o abono, en la moneda del extracto (`currency`), con el signo declarado en el archivo."
},
"saldo": {
"type": "number",
"description": "Saldo de esta línea del extracto, en la moneda del extracto (`currency`); puede diferir del saldo del feed de movimientos."
},
"numeroDocumento": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Número de documento como texto, conservando ceros a la izquierda. null si la celda está vacía; no es un ID único."
},
"transaccion": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Campo Trn del archivo, como texto. Puede venir en ceros; null si está vacío."
},
"caja": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Código de caja como texto, incluidos sus ceros. null si está vacío."
},
"sucursal": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Sucursal declarada en el archivo. null si la celda está vacía."
}
},
"required": [
"fecha",
"glosa",
"cargo",
"abono",
"saldo",
"numeroDocumento",
"transaccion",
"caja",
"sucursal"
],
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "Página de líneas del extracto, en su orden original y con repeticiones, con montos en la moneda del extracto. No son IDs ni filas del feed de movimientos. Una lista vacía es un extracto emitido sin movimientos. null cuando no hay líneas persistidas, incluso si existe el resumen; no implica ausencia de operaciones."
},
"totalLineas": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "Cantidad total de líneas del extracto persistido; null si no se han obtenido."
},
"lineasLeidasEn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Instante ISO 8601 con zona UTC (Z) de captura de estas líneas, independiente de una lectura posterior del resumen. null si no se han leído."
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Puntero opaco a la siguiente página de este mismo extracto. null al terminar. Si se vuelven a sincronizar las líneas, reinicia la lectura sin cursor."
}
},
"required": [
"cartola",
"formatoLineas",
"lineas",
"totalLineas",
"lineasLeidasEn",
"cursor"
],
"additionalProperties": false
}Errores de esta tool
| Código | HTTP | Reintentable | Qué hacer |
|---|---|---|---|
connection_disabled | 403 | no | Reactívala en /connections o usa otra conexión del mismo sistema. |
connection_not_found | 404 | no | Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada. |
alcance_not_enabled | 403 | no | Habilita el alcance en /connections o quítalo del input de la sincronización. |
Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.
Próximos pasos
bch_empresas.conexion.sincronizar: la tool que escribe los datos que esta lectura devuelve.- Sincronizar y consultar: por qué leer datos reales son dos pasos.
Consultar cartolas de Banco de Chile en todas las monedas (Recomendada)
Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar.
Sincronizar conexión Banco de Chile
Sincroniza los alcances solicitados (saldos, movimientos, movimientos de tarjetas y cartolas) para un período en una sola sincronización.