# Global66 Empresas

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



<Callout type="warn" title="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.
</Callout>

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 [#qué-necesitas]

### API de Global66 Empresas (`api_credentials`) [#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`) [#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 [#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 [#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 [#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 [#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.

## Referencias [#referencias]

* [Contrato completo de las herramientas Global66](/docs/referencia/global66).
* [Permisos y autenticación](/docs/empezar/autenticacion).
* [Sincronizar y consultar](/docs/conceptos/sincronizar-consultar).
* [Documentación oficial de Global66](https://documents-b2b.global66.com/).
