# Preparar operación Global66 para aprobación
> Deja una operación en Global66 PENDIENTE DE APROBACIÓN humana en la app de Global66 (PENDING_CONFIRMATION_MCP), a partir de una cotización.
{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}
| | |
| ------------------- | ----------------------------------------------------------------- |
| **Tool ID** | `global66.operacion.preparar` |
| **Nombre MCP** | `global66__operacion__preparar` |
| **Conector** | `global66` |
| **Plano** | `action` |
| **Scope (permiso)** | `global66:preparar` |
| **Auth** | `connection_credentials` |
| **Versión** | `1` |
| **Sensible** | sí |
| **Deprecado** | no |
| **Comportamiento** | readOnly=false, destructive=true, idempotent=true, openWorld=true |
> **Requiere conexión.** Indica cuál en cada llamada: header `X-Connect-Connection` en REST y campo `connectionId` en el `execute_write` 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 envía dinero: nadie puede aprobarla, cancelarla ni modificarla desde Connect. El quoteId es de un solo uso, así que repetirla no crea otra operación.
## Entrada [#entrada]
| Campo | Tipo | Requerido | Descripción |
| ---------------------- | --------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------- |
| `operation` | `"TRANSFER"` · `"P2P"` · `"CONVERSION"` | sí | Debe coincidir con la cotización. |
| `quoteId` | string `^[1-9][0-9]{0,15}$` | sí | quoteId de global66.cotizacion.crear; de un solo uso. |
| `originAccountId` | string `^[1-9][0-9]{0,15}$` | sí | Cuenta de origen (accountId de Global66). |
| `beneficiaryId` | string `^[1-9][0-9]{0,15}$` | no | Obligatorio en TRANSFER y P2P. |
| `currencyCode` | string | no | Solo P2P. |
| `destinyAccountId` | string `^[1-9][0-9]{0,15}$` | no | Cuenta propia de destino; solo y obligatoria en CONVERSION. |
| `description` | string | no | Glosa de la operación. |
| `purposes` | lista de objeto | no | Propósitos sin repetir; la suma no puede superar receiveAmountUsd de la cotización. Obligatorio en COMEX. |
| `purposes[].purposeId` | string `^[1-9][0-9]{0,15}$` | sí | purposeId real de global66.propositos\_operacion.listar. |
| `purposes[].amountUsd` | número | sí | Monto en USD asignado a este propósito. |
JSON Schema de entrada
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"operation": {
"type": "string",
"enum": [
"TRANSFER",
"P2P",
"CONVERSION"
],
"description": "Debe coincidir con la cotización."
},
"quoteId": {
"type": "string",
"pattern": "^[1-9][0-9]{0,15}$",
"description": "quoteId de global66.cotizacion.crear; de un solo uso."
},
"originAccountId": {
"type": "string",
"pattern": "^[1-9][0-9]{0,15}$",
"description": "Cuenta de origen (accountId de Global66)."
},
"beneficiaryId": {
"description": "Obligatorio en TRANSFER y P2P.",
"type": "string",
"pattern": "^[1-9][0-9]{0,15}$"
},
"currencyCode": {
"description": "Solo P2P.",
"type": "string"
},
"destinyAccountId": {
"description": "Cuenta propia de destino; solo y obligatoria en CONVERSION.",
"type": "string",
"pattern": "^[1-9][0-9]{0,15}$"
},
"description": {
"description": "Glosa de la operación.",
"type": "string",
"maxLength": 66
},
"purposes": {
"description": "Propósitos sin repetir; la suma no puede superar receiveAmountUsd de la cotización. Obligatorio en COMEX.",
"type": "array",
"items": {
"type": "object",
"properties": {
"purposeId": {
"type": "string",
"pattern": "^[1-9][0-9]{0,15}$",
"description": "purposeId real de global66.propositos_operacion.listar."
},
"amountUsd": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Monto en USD asignado a este propósito."
}
},
"required": [
"purposeId",
"amountUsd"
]
}
}
},
"required": [
"operation",
"quoteId",
"originAccountId"
]
}
```
## Salida [#salida]
| Campo | Tipo | Requerido | Descripción |
| ---------------- | ------ | --------- | ---------------------------------------------------------------------------------------------------------------------- |
| `estado` | string | sí | La operación espera que una persona la apruebe con PIN en la app de Global66 (vence a las 24 h). No es dinero enviado. |
| `estadoGlobal66` | string | sí | Estado verbatim de Global66. |
| `operacionId` | string | sí | Id de la operación preparada en Global66, como texto. |
| `datos` | objeto | sí | Respuesta de Global66 sin reinterpretar. |
JSON Schema de salida
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"estado": {
"type": "string",
"const": "pendiente_aprobacion_en_global66",
"description": "La operación espera que una persona la apruebe con PIN en la app de Global66 (vence a las 24 h). No es dinero enviado."
},
"estadoGlobal66": {
"type": "string",
"const": "PENDING_CONFIRMATION_MCP",
"description": "Estado verbatim de Global66."
},
"operacionId": {
"type": "string",
"description": "Id de la operación preparada en Global66, como texto."
},
"datos": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Respuesta de Global66 sin reinterpretar."
}
},
"required": [
"estado",
"estadoGlobal66",
"operacionId",
"datos"
],
"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. |
| `connection_credential_required` | 428 | no | Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior. |
| `connection_busy` | 409 | sí | Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez. |
| `upstream_error` | 502 | sí | Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración. |
| `timeout` | 504 | sí | Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo. |
| `connector_onboarding_required` | 428 | no | Lee el mensaje: dice qué falta. Se completa en el portal de ese sistema, no en Connect, y después la llamada funciona sin cambios. |
| `connection_scope_not_enabled` | 403 | no | Pide a un owner/admin que habilite el scope en /connections para esa conexión, o usa otra que ya lo tenga activo. Cambiar la credencial del actor no resuelve este error. |
| `rate_limited` | 429 | sí | Espera y reintenta con backoff exponencial. |
| `upstream_unexpected_response` | 502 | no | No reintentes: la respuesta es determinista. Repórtalo con el request\_id para que actualicemos el conector. |
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).