Consultar compras con tarjeta Global66

Devuelve las compras y retiros con tarjeta ya sincronizados desde el MCP de Global66 (filtro CARD_PURCHASES), del más reciente al más antiguo.


Tool ID	`global66.compras_tarjeta.consultar`
Nombre MCP	`global66__compras_tarjeta__consultar`
Conector	`global66`
Plano	`action`
Lee el alcance	`movimientos_tarjetas` (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.

Qué hace

Conserva los campos que entrega Global66; el contrato público no identifica tarjeta ni colaborador, y Connect no los infiere. No abre sesión en Global66.

Entrada

Campo	Tipo	Requerido	Descripción
`periodo`	string `^\d{4}-\d{2}$`	no	Mes AAAA-MM (UTC). Sin él se devuelven todos los meses sincronizados y completo es null.
`accountId`	string	no	Limita a una cuenta.
`cursor`	string	no	Cursor devuelto por la página anterior.
`limit`	entero 1-500	no	Máximo de filas por página.

JSON Schema de entrada

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "periodo": {
      "description": "Mes AAAA-MM (UTC). Sin él se devuelven todos los meses sincronizados y completo es null.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$"
    },
    "accountId": {
      "description": "Limita a una cuenta.",
      "type": "string"
    },
    "cursor": {
      "description": "Cursor devuelto por la página anterior.",
      "type": "string"
    },
    "limit": {
      "description": "Máximo de filas por página.",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

Salida

Campo	Tipo	Requerido	Descripción
`compras`	lista de objeto	sí	Compras y retiros con tarjeta persistidos.
`compras[].accountId`	string	sí	Cuenta de la compra.
`compras[].movementId`	string	sí	id del movimiento en Global66, o una huella sin_id:… si Global66 no lo informa.
`compras[].fecha`	string	null	sí
`compras[].datos`	objeto	sí	Campos del movimiento tal como los entrega el MCP de Global66.
`compras[].observadoEn`	string	sí	Instante ISO 8601 con Z de la lectura.
`completo`	booleano	null	sí
`sincronizadoEn`	string	null	sí
`cursor`	string	null	sí

JSON Schema de salida

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "compras": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "accountId": {
            "type": "string",
            "description": "Cuenta de la compra."
          },
          "movementId": {
            "type": "string",
            "description": "id del movimiento en Global66, o una huella sin_id:… si Global66 no lo informa."
          },
          "fecha": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Instante ISO 8601 con Z."
          },
          "datos": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {},
            "description": "Campos del movimiento tal como los entrega el MCP de Global66."
          },
          "observadoEn": {
            "type": "string",
            "description": "Instante ISO 8601 con Z de la lectura."
          }
        },
        "required": [
          "accountId",
          "movementId",
          "fecha",
          "datos",
          "observadoEn"
        ],
        "additionalProperties": false
      },
      "description": "Compras y retiros con tarjeta persistidos."
    },
    "completo": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "True si la última sincronización del período leyó todas las cuentas y páginas; false si alguna cuenta o página faltó o el último intento falló; null si se desconoce. Una lista vacía con completo distinto de true no confirma ausencia."
    },
    "sincronizadoEn": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Instante ISO 8601 con Z de la última lectura persistida del período (completa o parcial); null si nunca se persistió una."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Cursor de la página siguiente."
    }
  },
  "required": [
    "compras",
    "completo",
    "sincronizadoEn",
    "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

global66.conexion.sincronizar: la tool que escribe los datos que esta lectura devuelve.
Sincronizar y consultar: por qué leer datos reales son dos pasos.