Conector de Global66 Empresas: API REST y MCP en Connect

Cuentas, saldos, movimientos y operaciones de Global66 Empresas. Beta por organización pendiente de piloto real.

Beta por organización: pendiente de piloto real

La implementación de global66 está probada contra un proveedor simulado y una base de datos local aislada. Todavía no se han validado credenciales reales, consentimiento MCP real, pagos ni webhooks registrados en Global66. Soporte debe habilitar el conector para la organización. Esa habilitación no acredita operación real ni disponibilidad general.

Global66 Empresas conecta cuentas multimoneda y operaciones de su API oficial con Connect. Tiene dos accesos distintos:

Acceso	Cómo se autoriza	Qué permite
API de Global66 Empresas (`api_credentials`)	La empresa entrega su `clientId` y `clientSecret` mediante el enlace de conexión	Cuentas, saldos, movimientos, catálogos, validación y ejecución REST de pagos, cambios de moneda y RaaS
Asistente de Global66 (`oauth_source`)	Una persona autoriza en Global66 por OAuth	Cuentas y saldos, compras con tarjeta, beneficiarios, cotizaciones y preparación de operaciones para aprobación en Global66

El acceso REST no sustituye el consentimiento MCP. Cada llamada usa el connectionId de la conexión correspondiente; en REST, va en X-Connect-Connection. Las credenciales se custodian cifradas en el servidor.

Qué necesitas

API de Global66 Empresas (`api_credentials`)

Para REST, la empresa genera las credenciales desde Integraciones API en Global66 y registra la IPv4 fija de salida de Connect. Si esa IP no está permitida, Global66 puede rechazar el acceso con 401 o 403. El RUT entregado en este acceso queda declarado: la API no informa un RUT que Connect pueda verificar.

Campo	Qué es
Client ID	El identificador de las credenciales API de la empresa.
Client secret	El secreto de esas credenciales. Se entrega mediante el enlace de conexión.
RUT de la empresa	El RUT declarado de la empresa a la que pertenecen las credenciales.

Asistente de Global66 (`oauth_source`)

Para MCP necesitas una cuenta en Global66 Empresas y tu usuario debe tener permiso sobre ella. El formulario de este acceso pide un solo dato, y no es un secreto:

Campo	Qué es
RUT de la empresa	El RUT declarado de la empresa que vas a conectar; no sustituye la identidad que informa Global66.

El navegador sale a Global66 para que autorices el acceso y vuelve a Connect. Connect no te pide tu contraseña de Global66. Fija la identidad de empresa que informa el proveedor y la vuelve a comprobar al abrir sesión; una autorización de otra empresa no reemplaza la original. La forma exacta de esa respuesta todavía debe confirmarse con una cuenta real.

Si Global66 rechaza el token vigente con 401, la conexión responde connection_credential_required. Un owner o admin puede entrar a Ajustes de la conexión MCP y usar Volver a autorizar con la misma empresa. La conexión conserva sus datos; autorizar otra empresa no cambia la identidad fijada. Si el alta quedó pendiente, el botón dice Continuar autorización.

Sincronizar y consultar

Alcance	Acceso	Consulta persistida
`saldos`	REST o MCP	`global66.saldos.consultar`: cuentas, saldo por moneda, frescura y campos adicionales del proveedor
`movimientos`	REST	`global66.movimientos.consultar`: movimientos del período, contraparte cuando está disponible, comisiones y detalle
`movimientos_tarjetas`	MCP	`global66.compras_tarjeta.consultar`: compras y retiros de tarjeta con los campos que informa Global66

global66.conexion.sincronizar encola el trabajo y devuelve un jobId. Espera su resultado antes de dar por leídos los datos. Las consultas leen lo persistido y no abren otra sesión. La cadencia es de cuatro horas, con tres meses de historial inicial; saldos representa el momento actual y solo se sincroniza en el mes corriente.

Una cuenta o página fallida deja el período incompleto. Revisa completo, sincronizadoEn y fresco cuando correspondan: una lista vacía sin lectura completa no demuestra que no existan movimientos. Los saldos de monedas distintas no se suman.

El accountId que entrega la consulta de saldos sirve como cuentaOrigenId en pagos REST o como originAccountId y destinyAccountId en operaciones MCP. datosProveedor conserva la cuenta original, incluidos los campos adicionales del MCP, como su equivalente en USD y límites de operación.

Pagos y operaciones

REST y MCP tienen efectos distintos:

REST ejecuta: global66.pago.validar valida el pago y deja una preparación de quince minutos ligada a la conexión, la organización, el actor y el contenido. global66.pago.ejecutar exige esa preparación, el mismo pago y una Idempotency-Key estable. Puede mover dinero. global66.pago_raas.ejecutar añade el remitente final cuando el corredor lo admite y requiere que Global66 haya habilitado RaaS para la empresa.
MCP prepara: global66.cotizacion.crear cotiza y global66.operacion.preparar deja la operación pendiente de aprobación humana en la aplicación de Global66. Preparada no significa enviada. Connect no la aprueba ni la cancela.

Los permisos global66:pagos, global66:raas y global66:preparar se otorgan expresamente a la clave y a la conexión. Un owner o admin los activa en Ajustes de la conexión. El permiso de lectura no los concede.

Ante un resultado incierto, consulta global66.pago.estado por su referencia y conserva la misma preparación y clave de idempotencia. No valides de nuevo ni cambies de clave para repetir una orden que pudo haberse ejecutado.

Un pago puede adjuntar un comprobante, pero el tamaño efectivo está limitado por el body completo de Connect, de 256 KiB, incluido el contenido base64. No es un recibo ni un DTE de una compra con tarjeta.

Catálogos y webhooks

Las tools de catálogo consultan destinos, bancos por ruta, campos del beneficiario, medios de pago, tipos de documento, propósitos y plazos. Usan los identificadores del proveedor: no inventes bancos, beneficiarios ni propósitos.

En Ajustes se crea o rota el endpoint de webhooks y se registra la clave entregada por Global66. El receptor guarda el evento de forma durable antes de confirmarlo. Recibe ingresos por transferencia y cambios de estado de remesas; Global66 documenta que no reintenta una entrega fallida, por lo que Connect también reconcilia periódicamente. Los casos contradictorios o sin una correspondencia verificable quedan en revisión; todavía no tienen una interfaz propia.

Límites del contrato

El contrato público revisado no identifica tarjeta ni colaborador en cada compra, ni ofrece un catálogo de tarjetas o los recibos y DTE de esos gastos. Connect conserva los datos que existen y no asigna personas por comercio o monto. Tampoco crea beneficiarios ni aprueba, modifica o cancela las operaciones preparadas por MCP.

Antes de un piloto real faltan confirmar los schemas de salida MCP, la correspondencia de identificadores entre pagos y webhooks, las respuestas por IP no permitida, el egreso fijo y el registro efectivo del endpoint. La existencia de una tool en la documentación no demuestra que el proveedor la haya habilitado para esa empresa.

Global66 Empresas