Quote

Definición Técnica

Un Quote es una cotización que define los términos y condiciones específicos para una transacción financiera, incluyendo las tasas de cambio, las tarifas aplicables, y los montos convertidos. El Quote actúa como un acuerdo preliminar que establece los detalles de la transferencia antes de que se realice la order definitiva.

En el contexto de las solicitudes a la API, el Quote es esencial para calcular el costo exacto de una transacción y asegurar que se mantenga la integridad de la misma al pasar a la fase de ejecución.

Uso del Quote en Solicitudes

Creación de un Quote

El proceso de creación de un Quote establece las condiciones para la transferencia utilizando parámetros como sourceCurrency, targetCountry, y targetCurrency, junto con el payoutType. Esto permite determinar la tasa de cambio y cualquier tarifa que se aplique a la transacción.

Ejemplo de Solicitud POST para Crear un Quote

{
  "sourceCurrency": "USD",
  "targetCountry": "VE",
  "targetCurrency": "VES",
  "amount": 1000,
  "payoutType": "BANK_TRANSFER",
  "amountType": "SOURCE"
}

En este ejemplo, se especifican los detalles de la transferencia, incluyendo las monedas de origen y destino, así como el payoutType, que define el método de dispersión de fondos.

Uso del Quote en la Creación de una Order

Una vez que el Quote ha sido generado, se utiliza como base para crear una order, garantizando que la transacción se ejecute de acuerdo con las condiciones previamente establecidas. El Quote asegura que las tarifas, tasas de cambio y el monto transferido permanezcan constantes durante el proceso de creación de la order.

Ejemplo de Solicitud POST para Crear una Order utilizando un Quote

{
  "pogQuotationId": 90,
  "externalId": "order-12345",
  "senderNames": "John",
  "senderLastNames": "Doe",
  "beneficiaryNames": "Jane",
  "beneficiaryLastNames": "Smith",
  "payoutType": "BANK_TRANSFER",
  "paymentInstructions": {
    "bankName": "Banco Nacional",
    "accountNumber": "123456789"
  }
}

En este ejemplo, el campo pogQuotationId asegura que la order esté directamente vinculada al Quote previamente generado, utilizando los términos acordados.

Importancia Técnica del Quote

• Base para la Ejecución de Orders: El Quote proporciona una referencia precisa para crear una order, asegurando que se mantengan las condiciones de la transacción.
• Estabilidad de Tarifas y Términos: Una vez que se crea un Quote, las tasas de cambio y las tarifas aplicadas permanecen constantes, garantizando que no haya fluctuaciones inesperadas durante la creación de la order.
• Optimización de Costos: Permite a los usuarios analizar las condiciones de varias cotizaciones antes de confirmar la ejecución de una transacción, eligiendo la opción más rentable.

Consideraciones

• Validez Temporal: Los Quotes generalmente tienen un tiempo de vida limitado, lo que significa que deben ser utilizados para crear una order antes de que expiren.
• Correspondencia con Orders: Es crucial que la order se cree utilizando el mismo Quote para mantener la coherencia en las condiciones de la transacción.

El Quote es una pieza fundamental en el proceso de dispersión de fondos, ya que asegura la transparencia y precisión de los términos de la transacción antes de que se ejecute definitivamente.