3. Crear una cotización (Quote)

Un quote (o cotización) es una estimación que fija el tipo de cambio y las tarifas asociadas para una transacción de conversión de moneda o transferencia de fondos. Es un valor crucial para determinar cuánto recibirá el destinatario en la moneda objetivo, y bloquea estas condiciones por un período determinado para proteger tanto al remitente como a la plataforma contra las fluctuaciones del mercado.

Funciones Clave de un Quote

• Fijación del Tipo de Cambio: El quote establece el tipo de cambio para la transacción y lo mantiene fijo por un período específico.
• Cálculo de Tarifas: Incluye todas las comisiones y tarifas aplicadas a la transacción, tanto las visibles como las ocultas en la tasa de cambio.
• Bloqueo de Condiciones: Asegura que las condiciones de la cotización se mantengan estables incluso si el mercado fluctúa.
• Referencia para Órdenes Futuras: Se utiliza como referencia al crear una orden para que las condiciones de la transacción sean las mismas que las especificadas en la cotización.

Crear una Cotización (Quote)

El proceso de crear un quote requiere enviar una solicitud al endpoint adecuado con la información necesaria para calcular el tipo de cambio y las tarifas. Aquí se muestra el body request y la estructura de la respuesta.

Body Request para Crear un Quote

Para crear un quote, se deben enviar los siguientes datos:

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

Descripción de los Campos

• sourceCurrency: La moneda desde la que se convertirá el monto.
• targetCountry: El país de destino de la transacción.
• targetCurrency: La moneda a la que se convertirá el monto.
• amount: La cantidad de dinero a convertir.
• payoutType: El nombre de la plataforma de dispersión, obtenido del platformName del método de dispersión.
• amountType: Especifica si el monto es en la moneda de origen (SOURCE) o en la moneda de destino (TARGET).

Respuesta del Endpoint

El endpoint de cotización devolverá un objeto JSON con la siguiente estructura:

{
  "id": "84",
  "quotationBackendId": "0b3d6f36-3f75-4bf7-8b0e-b452499a7fec",
  "sourceAmount": 1000,
  "targetAmount": 38148.216,
  "convertAmount": 1000,
  "value": 39.2,
  "pricingRules": [
    {
      "backendId": "912a2a54-4280-46b7-a2e5-524b94a3d1b0",
      "pricingRule": "FX_SPREAD_FEE",
      "pricingType": "FEE",
      "appliedValue": 0.02,
      "pricingLabel": "Comisión en tasa",
      "calculationMethod": "HIDDEN_IN_RATE"
    },
    {
      "backendId": "1ee34169-2d53-41e2-9542-2c5c295de519",
      "pricingRule": "PAYOUT_TYPE_FEE",
      "pricingType": "FEE",
      "appliedValue": 1051,
      "pricingLabel": "Costo de servicio",
      "calculationMethod": "VISIBLE"
    }
  ],
  "createdTime": "2024-09-24T02:29:25.780Z",
  "updatedTime": "2024-09-24T02:29:25.780Z"
}

Descripción de los Campos en la Respuesta

• id: Identificador único del quote.
• sourceAmount y targetAmount: Los montos de origen y destino de la transacción.
• value: La tasa de cambio aplicada.
• pricingRules: Detalle de las comisiones y tarifas aplicadas, tanto visibles como ocultas.
• convertAmount: Monto a convertir luego de comisiones y tarifas.
• createdTime y updatedTime: Momentos en que se creó y se actualizó el quote.

Uso del Quote para Crear una Orden

Una vez que se genera un quote, su id se utiliza como referencia para crear una orden real, asegurando que las condiciones de la transacción se mantengan según lo acordado en la cotización inicial.

Consultar un Quote por ID

Puedes consultar el estado y los detalles de una quote existente utilizando el endpoint Get Quotation by ID. Este proceso te permitirá rastrear y obtener información actualizada sobre la transacción a medida que progresa a través de diferentes estados.