Connect
ReferenciaBanco de Chile Empresas

Consultar líneas de una cartola histórica de Banco de Chile

Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar.

Tool IDbch_empresas.cartolas.detalle
Nombre MCPbch_empresas__cartolas__detalle
Conectorbch_empresas
Planoaction
Lee el alcancecartolas (debe estar habilitado en la conexión)
Scope (permiso)bch_empresas:read
Authnone
Versión1
Sensiblesí
Deprecadono
ComportamientoreadOnly=true, destructive=false, idempotent=true, openWorld=false

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST y campo connectionId en el execute de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de conexiones.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

CampoTipoRequeridoDescripción
numeroCuentastringsíCuenta canónica tal como la devuelve cartolas.consultar, incluido el código de producto.
fechaEmisionDaystring ^\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"noMoneda 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.
cursorstringnoPara 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.
limitentero 1-200no · default 100Má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
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}}'
MCP · meta-tool execute
{
  "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

CampoTipoRequeridoDescripción
cartolaobjetonullsí
cartola.numeroCuentastringsí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.tipoProductostringsí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.currencystringsí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.fechaEmisionDaystringsí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.periodostringsíEl mes (AAAA-MM) con el que se buscó esta cartola, que no es la fecha del extracto: esa es 'fechaEmisionDay'.
cartola.numeroCartolastringnullsí
cartola.saldoInicialnúmeronullsí
cartola.saldoFinalnúmeronullsí
cartola.ultimaLecturaEnstringsíInstante (ISO 8601) en que esta cartola se leyó del banco por última vez.
formatoLineasstringnullsí
lineaslista de objetonullsí
lineas[].fechastringnullsí
lineas[].glosastringnullsí
lineas[].cargonúmerosíCheque o cargo, en la moneda del extracto (currency), con el signo declarado en el archivo.
lineas[].abononúmerosíDepósito o abono, en la moneda del extracto (currency), con el signo declarado en el archivo.
lineas[].saldonúmerosíSaldo de esta línea del extracto, en la moneda del extracto (currency); puede diferir del saldo del feed de movimientos.
lineas[].numeroDocumentostringnullsí
lineas[].transaccionstringnullsí
lineas[].cajastringnullsí
lineas[].sucursalstringnullsí
totalLineasenteronullsí
lineasLeidasEnstringnullsí
cursorstringnullsí
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ódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.
connection_not_found404noUsa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.
alcance_not_enabled403noHabilita 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

En esta página