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.


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.

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

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

{
  "$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

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

{
  "$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

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.

Preparar operación Global66 para aprobación

Qué hace

Entrada

Salida

Errores de esta tool

En esta página