# Consultar saldos Global66
> Devuelve las cuentas de Global66 de la última lectura completa, una por wallet y moneda, con su saldo disponible.
{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}
| | |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID** | `global66.saldos.consultar` |
| **Nombre MCP** | `global66__saldos__consultar` |
| **Conector** | `global66` |
| **Plano** | `action` |
| **Lee el alcance** | `saldos` (debe estar habilitado en la conexión) |
| **Scope (permiso)** | `global66:read` |
| **Auth** | `none` |
| **Versión** | `1` |
| **Sensible** | no |
| **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 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`](/docs/referencia/conexiones/estado-consultar).
## Qué hace [#qué-hace]
No abre sesión en Global66. Revisa fresco y observadoEn: un saldo antiguo no es el actual. Nunca sumes saldos de monedas distintas.
## Entrada [#entrada]
| Campo | Tipo | Requerido | Descripción |
| -------- | ------ | --------- | ------------------------------ |
| `moneda` | string | no | Filtra por moneda (CLP, USD…). |
JSON Schema de entrada
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"moneda": {
"description": "Filtra por moneda (CLP, USD…).",
"type": "string"
}
}
}
```
## Salida [#salida]
| Campo | Tipo | Requerido | Descripción | |
| --------------------------- | --------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `cuentas` | lista de objeto | sí | Cuentas vigentes en la última lectura completa. | |
| `cuentas[].accountId` | string | sí | walletId REST o accountId MCP de Global66; úsalo como cuentaOrigenId REST u originAccountId/destinyAccountId MCP. | |
| `cuentas[].moneda` | string | sí | Moneda de la cuenta. Los saldos de monedas distintas nunca se suman. | |
| `cuentas[].saldoDisponible` | número | null | sí | Saldo disponible informado por Global66, en la moneda de la cuenta. Es un balance: conserva su signo. |
| `cuentas[].alias` | string | null | sí | Alias de la cuenta, si lo tiene. |
| `cuentas[].esPrincipal` | booleano | null | sí | True si Global66 la marca como principal. |
| `cuentas[].creadaEn` | string | null | sí | Instante ISO 8601 con Z de creación de la cuenta, si Global66 lo informa. |
| `cuentas[].observadoEn` | string | sí | Instante ISO 8601 con Z de la lectura que dejó este saldo. | |
| `cuentas[].datosProveedor` | objeto | sí | Cuenta original de Global66. Conserva los campos adicionales de cada acceso, como país, availableUsd y límites de operación del MCP, sin reinterpretarlos. | |
| `sincronizadoEn` | string | null | sí | Instante ISO 8601 con Z de la última lectura de cuentas; null si nunca se leyó. |
| `cursor` | string | null | sí | Siempre null: las cuentas caben en una sola respuesta. |
| `fresco` | booleano | sí | True si la última lectura de cuentas tiene menos de 8 horas (dos ciclos de sincronización). False si es más antigua o nunca se leyó: los saldos pueden estar desactualizados. | |
JSON Schema de salida
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"cuentas": {
"type": "array",
"items": {
"type": "object",
"properties": {
"accountId": {
"type": "string",
"description": "walletId REST o accountId MCP de Global66; úsalo como cuentaOrigenId REST u originAccountId/destinyAccountId MCP."
},
"moneda": {
"type": "string",
"description": "Moneda de la cuenta. Los saldos de monedas distintas nunca se suman."
},
"saldoDisponible": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Saldo disponible informado por Global66, en la moneda de la cuenta. Es un balance: conserva su signo."
},
"alias": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Alias de la cuenta, si lo tiene."
},
"esPrincipal": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "True si Global66 la marca como principal."
},
"creadaEn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Instante ISO 8601 con Z de creación de la cuenta, si Global66 lo informa."
},
"observadoEn": {
"type": "string",
"description": "Instante ISO 8601 con Z de la lectura que dejó este saldo."
},
"datosProveedor": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Cuenta original de Global66. Conserva los campos adicionales de cada acceso, como país, availableUsd y límites de operación del MCP, sin reinterpretarlos."
}
},
"required": [
"accountId",
"moneda",
"saldoDisponible",
"alias",
"esPrincipal",
"creadaEn",
"observadoEn",
"datosProveedor"
],
"additionalProperties": false
},
"description": "Cuentas vigentes en la última lectura completa."
},
"sincronizadoEn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Instante ISO 8601 con Z de la última lectura de cuentas; null si nunca se leyó."
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Siempre null: las cuentas caben en una sola respuesta."
},
"fresco": {
"type": "boolean",
"description": "True si la última lectura de cuentas tiene menos de 8 horas (dos ciclos de sincronización). False si es más antigua o nunca se leyó: los saldos pueden estar desactualizados."
}
},
"required": [
"cuentas",
"sincronizadoEn",
"cursor",
"fresco"
],
"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. |
| `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](/docs/referencia/errores).
## Próximos pasos [#próximos-pasos]
* [`global66.conexion.sincronizar`](/docs/referencia/global66/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.