Casos de uso

Con el asistente ya conectado, estas son las operaciones que la mayoría de las empresas resuelve desde la conversación. Cada caso indica qué pedir, qué ocurre después y qué queda en tus manos.

Pagar a un proveedor en el exterior

Le pides: “Paga 1.200 USD a Maderas del Cauca, es por la factura de octubre.”

Qué hace: busca al proveedor entre los que tu empresa tiene registrados, revisa qué propósito corresponde declarar para ese envío y te muestra cuánto sale, cuánto llega y a qué tipo de cambio, con los costos desglosados.

Qué haces tú: si el resultado te convence, el asistente deja la operación preparada. El dinero todavía no se mueve: la confirmas desde la aplicación con tu clave. Si tu empresa exige aprobaciones, después de eso todavía deben firmarla otras personas.

Necesitas antes: que el proveedor ya esté registrado como beneficiario.

Mover fondos entre cuentas propias

Le pides: “Convierte 5.000 USD de la cuenta principal a la cuenta en pesos chilenos.”

Qué hace: identifica las dos cuentas de tu empresa, calcula la conversión entre ambas monedas y te muestra el tipo de cambio aplicado y cuánto queda en destino.

Qué haces tú: confirmas desde la aplicación, igual que en un pago. Aquí no interviene ningún beneficiario: el destino es una cuenta de la propia empresa.

Necesitas antes: tener activas la cuenta de origen y la de destino.

Revisar y conciliar movimientos

Le pides: “Muéstrame los cobros que entraron en octubre y el detalle de los que superen los 2.000 USD.”

Qué hace: recorre los movimientos del período —envíos, cobros, conversiones, depósitos, retiros y compras con tarjeta— y amplía los que le señales, con el tipo de cambio, el desglose de costos, la contraparte y el estado de cada uno.

Qué haces tú: nada. Es una consulta: no prepara ni mueve nada.

Nota

Un histórico largo puede tomarle varias vueltas al asistente, porque recorre los movimientos por tramos. Si te interesa un período completo, conviene pedírselo de forma explícita.

Lo que el asistente no puede hacer

Conviene saberlo antes de pedírselo:

• Dar de alta un beneficiario nuevo. Si el proveedor no está registrado, hay que crearlo desde la aplicación primero.
• Cancelar o modificar una operación ya preparada. Eso también se resuelve en la aplicación.
• Confirmar una operación. La confirmación es siempre tuya y siempre con tu clave. No hay forma de que el asistente la complete por su cuenta.

Cómo se encadenan las tools

Esta parte es para quien integra o depura la conexión. Ninguna tool adivina los identificadores que necesita: cada uno lo produce una tool anterior.

1. get_my_accounts entrega el accountId y el saldo por moneda, que create_transaction usa como originAccountId y destinyAccountId.
2. list_beneficiaries entrega el beneficiaryId, la moneda y el país del contacto. El país alimenta el destinyCountry de create_quote.
3. list_transaction_purposes entrega el purposeId, que viaja en purposes de create_transaction.
4. create_quote entrega el quoteId, los montos y el receiveAmountUsd.
5. create_transaction reúne todo y devuelve el identificador de la operación.

Qué operación es cada una

El campo operation es el mismo en create_quote y en create_transaction, y define qué datos hacen falta.

operation	Destino	Datos propios
TRANSFER	un beneficiario de la libreta	beneficiaryId
P2P	otro cliente de Global66	beneficiaryId y currencyCode
CONVERSION	otra cuenta de la propia empresa	destinyAccountId

Un beneficiario con global66Contact = true se paga con P2P, no con TRANSFER.

Reglas que atraviesan el camino

Una cotización sirve para una sola operación. Si cambia el monto, la moneda o el destino, hay que cotizar de nuevo antes de volver a crear la operación.

La suma de los amountUsd de purposes no puede superar el receiveAmountUsd que devolvió create_quote; puede ser menor si solo se declara una parte.

Los parámetros y las respuestas de cada tool están en Tools disponibles. Si una falla, el diagnóstico de los errores más frecuentes está en Solución de problemas.