Consultar saldos Global66
Devuelve las cuentas de Global66 de la última lectura completa, una por wallet y moneda, con su saldo disponible.
| 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-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
No abre sesión en Global66. Revisa fresco y observadoEn: un saldo antiguo no es el actual. Nunca sumes saldos de monedas distintas.
Entrada
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
moneda | string | no | Filtra por moneda (CLP, USD…). |
JSON Schema de entrada
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"moneda": {
"description": "Filtra por moneda (CLP, USD…).",
"type": "string"
}
}
}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í |
cuentas[].alias | string | null | sí |
cuentas[].esPrincipal | booleano | null | sí |
cuentas[].creadaEn | string | null | sí |
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í |
cursor | string | null | sí |
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
{
"$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
| 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
global66.conexion.sincronizar: la tool que escribe los datos que esta lectura devuelve.- Sincronizar y consultar: por qué leer datos reales son dos pasos.