# Consultar movimientos de tarjetas de Banco de Chile
> Lee exclusivamente la caché de movimientos de tarjetas de crédito de esta conexión; NO abre una sesión ni contacta al banco.
{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}
| | |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID** | `bch_empresas.movimientos_tarjetas.consultar` |
| **Nombre MCP** | `bch_empresas__movimientos_tarjetas__consultar` |
| **Conector** | `bch_empresas` |
| **Plano** | `action` |
| **Lee el alcance** | `movimientos_tarjetas` (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-Connection` en REST, campo `connectionId` en el `execute` de MCP y en las opciones del SDK. 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`](../conexiones/estado-consultar).
## Qué hace [#qué-hace]
Incluye pendientes del período actual y estados de cuenta facturados en CLP y USD. El monto conserva el signo que entregó el banco: no se infiere cargo o abono. Por defecto devuelve solo filas vigentes; usa soloVigentes=false para incluir pendientes que ya no aparecen en la última captura. Nunca devuelve PAN, titular, RUT, número de cuenta, IDs crudos ni raw.
## Entrada [#entrada]
| Campo | Tipo | Requerido | Descripción |
| --------------- | ----------------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `periodo` | string `^\d{4}-\d{2}$` | no | Filtra por el mes AAAA-MM con que se sincronizó la fila. |
| `currency` | `"CLP"` · `"USD"` | no | Filtra por la moneda primaria. |
| `estado` | `"pendiente"` · `"facturado"` | no | Filtra por etapa de facturación. |
| `cardReference` | string `^[a-f0-9]{64}$` | no | Filtra por la referencia opaca devuelta en otra fila. |
| `soloVigentes` | booleano | no · default `true` | Por defecto excluye pendientes que desaparecieron de la captura más reciente. false también los incluye. |
| `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-500 | no · default `100` | Cuántas filas trae una página, entre 1 y 500. Por defecto, 100. |
JSON Schema de entrada
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"periodo": {
"description": "Filtra por el mes AAAA-MM con que se sincronizó la fila.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}$"
},
"currency": {
"description": "Filtra por la moneda primaria.",
"type": "string",
"enum": [
"CLP",
"USD"
]
},
"estado": {
"description": "Filtra por etapa de facturación.",
"type": "string",
"enum": [
"pendiente",
"facturado"
]
},
"cardReference": {
"description": "Filtra por la referencia opaca devuelta en otra fila.",
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"soloVigentes": {
"default": true,
"description": "Por defecto excluye pendientes que desaparecieron de la captura más reciente. false también los incluye.",
"type": "boolean"
},
"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": "Cuántas filas trae una página, entre 1 y 500. Por defecto, 100.",
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"additionalProperties": false
}
```
## Ejemplo [#ejemplo]
```bash title="curl"
curl -X POST https://connect.emisso.ai/api/v1/tools/bch_empresas.movimientos_tarjetas.consultar/execute \
-H "Authorization: Bearer connect_sk_…" \
-H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
-H "Content-Type: application/json" \
-d '{"input":{"periodo":"2026-09","currency":"USD"}}'
```
```ts title="SDK TypeScript"
const data = await connect.tools.bch_empresas.movimientos_tarjetas.consultar({ periodo: "2026-09", currency: "USD" }, { connectionId: "conn_9tKfR2mQx4Vb" });
```
```json title="MCP · meta-tool execute"
{
"tool": "bch_empresas.movimientos_tarjetas.consultar",
"params": {
"periodo": "2026-09",
"currency": "USD"
},
"connectionId": "conn_9tKfR2mQx4Vb"
}
```
**Salida esperada (200):**
```json
{
"data": {
"movimientosTarjetas": [
{
"id": "8c17b8e4960715f7eb127b945add1066897251cb61794f751d6b55bec0e7837a",
"cardReference": "4152a185babf4df0ca71b80cd31c5fb6ef03d4dfec157110d434c849b194b1b1",
"terminacionTarjeta": "1234",
"tipoTarjeta": "Visa Empresa",
"currency": "USD",
"estado": "facturado",
"vigente": true,
"periodo": "2026-09",
"fechaTransaccion": "2026-09-03",
"fechaFacturacion": "2026-09-30",
"horaAutorizacion": null,
"seccion": "compras",
"descripcion": "Compra internacional",
"comercio": "Comercio de ejemplo",
"monto": 19.75,
"display": "19,75",
"montoMonedaOrigen": 21.1,
"displayMonedaOrigen": "21,1",
"cuotas": null,
"pais": "US",
"rubro": null,
"ciudad": null,
"grupo": null,
"repeticiones": 1,
"ultimaLecturaEn": "2026-09-04T12:00:00.000Z"
}
],
"cursor": null
},
"meta": {
"request_id": "req_…",
"tool_id": "bch_empresas.movimientos_tarjetas.consultar",
"plane": "action",
"latency_ms": 24,
"audit_status": "recorded"
}
}
```
> Todos los datos son sintéticos. cardReference e id son referencias opacas, no IDs del banco.
## Salida [#salida]
| Campo | Tipo | Requerido | Descripción | |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `movimientosTarjetas` | lista de objeto | sí | Movimientos de tarjetas guardados. Una lista vacía significa que el alcance aún no se sincronizó o no encontró filas. | |
| `movimientosTarjetas[].id` | string `^[a-f0-9]{64}$` | sí | Identidad opaca y estable del movimiento. Nunca contiene el ID crudo del banco ni el número de tarjeta. | |
| `movimientosTarjetas[].cardReference` | string `^[a-f0-9]{64}$` | null | sí | Referencia opaca de la tarjeta de procedencia. Es null si el mismo objeto apareció en más de una tarjeta. |
| `movimientosTarjetas[].terminacionTarjeta` | string `^\d{4}$` | null | sí | Solo los últimos cuatro dígitos. Nunca es un PAN completo; null cuando el banco no permite atribuir la fila. |
| `movimientosTarjetas[].tipoTarjeta` | string | null | sí | Nombre o tipo que entrega el banco, o null cuando no está disponible. |
| `movimientosTarjetas[].currency` | `"CLP"` · `"USD"` | sí | Moneda del monto primario: pesos chilenos o dólares estadounidenses. | |
| `movimientosTarjetas[].estado` | `"pendiente"` · `"facturado"` | sí | Etapa del movimiento dentro del ciclo de facturación. | |
| `movimientosTarjetas[].vigente` | booleano | sí | En pendientes indica si apareció en la captura completa más reciente. Los facturados permanecen vigentes. | |
| `movimientosTarjetas[].periodo` | string `^\d{4}-\d{2}$` | sí | Mes solicitado al sincronizar esta fila, en formato AAAA-MM. | |
| `movimientosTarjetas[].fechaTransaccion` | string `^\d{4}-\d{2}-\d{2}$` | null | sí | Día de la transacción en America/Santiago, o null si el banco no lo trajo. |
| `movimientosTarjetas[].fechaFacturacion` | string `^\d{4}-\d{2}-\d{2}$` | null | sí | Día del estado de cuenta para filas facturadas; null en pendientes. |
| `movimientosTarjetas[].horaAutorizacion` | string | null | sí | Hora que informa el banco para un pendiente, o null si no viene. |
| `movimientosTarjetas[].seccion` | `"no_facturados"` · `"operaciones"` · `"cargos_impuestos_abonos"` · `"compras_en_cuotas"` · `"productos_servicios_voluntarios"` · `"pagos"` · … | sí | Sección cerrada del portal de la que salió el movimiento. | |
| `movimientosTarjetas[].descripcion` | string | null | sí | Descripción o glosa que entrega el banco, o null si no viene. |
| `movimientosTarjetas[].comercio` | string | null | sí | Nombre del comercio que entrega el banco, o null si no viene. |
| `movimientosTarjetas[].monto` | número | sí | Monto primario con el signo exacto que entregó Banco de Chile. | |
| `movimientosTarjetas[].display` | string | sí | El monto primario formateado para mostrar; conserva el signo de 'monto'. | |
| `movimientosTarjetas[].montoMonedaOrigen` | número | null | sí | Monto en moneda de origen cuando el banco lo informa, sin inventar su código; null cuando no viene. |
| `movimientosTarjetas[].displayMonedaOrigen` | string | null | sí | Presentación de montoMonedaOrigen, o null cuando no viene. |
| `movimientosTarjetas[].cuotas` | string | null | sí | Descripción de cuotas del banco, o null si no aplica. |
| `movimientosTarjetas[].pais` | string | null | sí | País o código de país informado por el banco, o null. |
| `movimientosTarjetas[].rubro` | string | null | sí | Rubro del comercio informado por el banco, o null. |
| `movimientosTarjetas[].ciudad` | string | null | sí | Ciudad informada por el banco, o null. |
| `movimientosTarjetas[].grupo` | string | null | sí | Grupo de presentación del estado de cuenta, o null. |
| `movimientosTarjetas[].repeticiones` | entero | sí | Cantidad de objetos indistinguibles agrupados sin fabricar una identidad basada en su posición. | |
| `movimientosTarjetas[].ultimaLecturaEn` | string | sí | Instante ISO 8601 en que esta fila se observó por última vez. | |
| `cursor` | string | null | sí | Cursor de la página siguiente. Reenvíalo tal cual; null significa que no quedan más filas. |
JSON Schema de salida
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"movimientosTarjetas": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Identidad opaca y estable del movimiento. Nunca contiene el ID crudo del banco ni el número de tarjeta."
},
"cardReference": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
{
"type": "null"
}
],
"description": "Referencia opaca de la tarjeta de procedencia. Es null si el mismo objeto apareció en más de una tarjeta."
},
"terminacionTarjeta": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}$"
},
{
"type": "null"
}
],
"description": "Solo los últimos cuatro dígitos. Nunca es un PAN completo; null cuando el banco no permite atribuir la fila."
},
"tipoTarjeta": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Nombre o tipo que entrega el banco, o null cuando no está disponible."
},
"currency": {
"type": "string",
"enum": [
"CLP",
"USD"
],
"description": "Moneda del monto primario: pesos chilenos o dólares estadounidenses."
},
"estado": {
"type": "string",
"enum": [
"pendiente",
"facturado"
],
"description": "Etapa del movimiento dentro del ciclo de facturación."
},
"vigente": {
"type": "boolean",
"description": "En pendientes indica si apareció en la captura completa más reciente. Los facturados permanecen vigentes."
},
"periodo": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}$",
"description": "Mes solicitado al sincronizar esta fila, en formato AAAA-MM."
},
"fechaTransaccion": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
],
"description": "Día de la transacción en America/Santiago, o null si el banco no lo trajo."
},
"fechaFacturacion": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
],
"description": "Día del estado de cuenta para filas facturadas; null en pendientes."
},
"horaAutorizacion": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Hora que informa el banco para un pendiente, o null si no viene."
},
"seccion": {
"type": "string",
"enum": [
"no_facturados",
"operaciones",
"cargos_impuestos_abonos",
"compras_en_cuotas",
"productos_servicios_voluntarios",
"pagos",
"compras",
"comisiones"
],
"description": "Sección cerrada del portal de la que salió el movimiento."
},
"descripcion": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Descripción o glosa que entrega el banco, o null si no viene."
},
"comercio": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Nombre del comercio que entrega el banco, o null si no viene."
},
"monto": {
"type": "number",
"description": "Monto primario con el signo exacto que entregó Banco de Chile."
},
"display": {
"type": "string",
"description": "El monto primario formateado para mostrar; conserva el signo de 'monto'."
},
"montoMonedaOrigen": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Monto en moneda de origen cuando el banco lo informa, sin inventar su código; null cuando no viene."
},
"displayMonedaOrigen": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Presentación de montoMonedaOrigen, o null cuando no viene."
},
"cuotas": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Descripción de cuotas del banco, o null si no aplica."
},
"pais": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "País o código de país informado por el banco, o null."
},
"rubro": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Rubro del comercio informado por el banco, o null."
},
"ciudad": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Ciudad informada por el banco, o null."
},
"grupo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Grupo de presentación del estado de cuenta, o null."
},
"repeticiones": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991,
"description": "Cantidad de objetos indistinguibles agrupados sin fabricar una identidad basada en su posición."
},
"ultimaLecturaEn": {
"type": "string",
"description": "Instante ISO 8601 en que esta fila se observó por última vez."
}
},
"required": [
"id",
"cardReference",
"terminacionTarjeta",
"tipoTarjeta",
"currency",
"estado",
"vigente",
"periodo",
"fechaTransaccion",
"fechaFacturacion",
"horaAutorizacion",
"seccion",
"descripcion",
"comercio",
"monto",
"display",
"montoMonedaOrigen",
"displayMonedaOrigen",
"cuotas",
"pais",
"rubro",
"ciudad",
"grupo",
"repeticiones",
"ultimaLecturaEn"
],
"additionalProperties": false
},
"description": "Movimientos de tarjetas guardados. Una lista vacía significa que el alcance aún no se sincronizó o no encontró filas."
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Cursor de la página siguiente. Reenvíalo tal cual; null significa que no quedan más filas."
}
},
"required": [
"movimientosTarjetas",
"cursor"
],
"additionalProperties": false
}
```
## Errores de esta tool [#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. |
| `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](../errores).
## Próximos pasos [#próximos-pasos]
* [`bch_empresas.conexion.sincronizar`](./conexion-sincronizar): la tool que escribe los datos que esta lectura devuelve.
* [Sincronizar y consultar](/docs/conceptos/sincronizar-consultar): por qué leer datos reales son dos pasos.