Objetivo

• Permitir el registro manual de tipos de cambio, diferenciando la aplicación por tipo de producto.

• Disponibilizar un historial de tipos de cambio para conocer las conversiones importadas del GDS y las registradas directamente por la agencia en el admin.

• Convertir los precios de los resultados a la moneda configurada para el flujo en función del tipo de cambio establecido por la propia agencia o por el GDS.

Alcance

Afecta el flujo de compra desde NetAdmin, CMS y NetCoreAPI, como así también el pago de las reservas.

Contexto

NetSuite maneja los siguientes conceptos:

• Moneda del Producto → Es la moneda que se visualiza durante el flujo de compra y luego en el display de reservas dentro de la sección “Detalles”. 

• Moneda del Pago → Es la moneda que se utiliza al momento de pagar una reserva. Se visualiza en el checkout como así también en el display de reservas en la sección “Precio Total del Itinerario”. 

• Moneda de la credencial → Moneda en la cual se recibe el contenido desde los distintos proveedores. 

Tipo de Cambio de la Agencia (ABM de Tipos de Cambio)

1. Tipo de Cambio en Configuración General

Con el fin de centralizar toda la administración de los Tipos de Cambio en un solo lugar, se elimina el campo “Tipo de Cambio“ de la Configuración General de NetAdmin.

2. Permiso

Se requiere asignar un nuevo permiso dentro la configuración de Roles en el módulo de Personas y Compañías de NetAdmin, que se llama “Tipos de Cambio” para visualizar la Configuración de Tipos de Cambio. 

El mismo se ubica dentro de la sección de “Permisos de Configuración”.

3. Acceso a la Configuración de Tipos de Cambio

Se disponibiliza la opción “Tipos de Cambio” dentro del menú de Configuración de NetAdmin.

La misma se encuentra visible si y sólo si, el usuario logueado tiene el permiso correspondiente del punto 4.1.

4. Registro de Tipos de Cambio Manuales

Cuando el usuario selecciona la opción “Tipos de Cambio“ dentro del menú de Configuración, se despliega el Resumen de Tipos de Cambio.

Si se selecciona el botón “Nuevo” dentro del resumen de tipos de cambio, se despliega una nueva pantalla.

La pantalla cuenta con:

• Botón “Volver” para regresar al resumen de tipos de cambio

• Botón “Nuevo” para limpiar los campos

• Botón “Guardar” para almacenar el tipo de cambio manual de la agencia

• Botón “Borrar” para eliminar el tipo de cambio manual de la agencia

• Botón “Historial” para consultar las modificaciones de los tipos de cambio manuales de la agencia

• Título “Información General del Tipo de Cambio”

• Leyenda explicativa “A continuación puede registrar los tipos de cambio con los cuales quiere trabajar en el sistema, ya sea para todos los tipos de producto o diferenciando su aplicación.”

• Checkbox “Activo” con una leyenda explicativa a la derecha “El tipo de cambio impacta en el sistema siempre y cuando se encuentre activo.”

• Campo “Moneda Origen” que debe tener el valor USD fijo y por ende debe estar grisado.

• Campo “Moneda Destino” para ingresar el código de moneda destino.

• Campo “Tipo de Cambio” con formato numérico para informar el tipo de cambio.

• “Aplicación” con las siguientes opciones con checks de selección:

  • Aéreo

  • Hotel

  • Travel Extra

  • Auto

  • Asistencia **

  • Bus

• Debajo de “Aplicación” el link  “Seleccionar Todos”. Cuando el mismo se presiona, se tildan todos los tipos de productos y el link pasa a llamarse “Limpiar Selección”

** Debajo de “Asistencia” una leyenda explicativa que dice “Únicamente para flujos desde el API”.

• Recuadro “Ejemplo” para mostrar el tipo de cambio en función de los datos ingresados. El mismo sirve de chequeo para la carga manual de conversiones.

5. Consulta de Tipos de Cambio

Cuando el usuario selecciona la opción “Tipos de Cambio” en el menú de Configuración, se despliega un resumen de las conversiones registradas en el sistema. 

La pantalla cuenta con:

• Título “Resumen de Tipos de Cambio” con una leyenda explicativa “A continuación puede consultar los tipos de cambio registrados en el sistema, ya sea para todos los tipos de producto o diferenciando su aplicación.”.

• Botón “Nuevo” para registrar un nuevo tipo de cambio

• Filtro “Moneda Destino” → para indicar el código de moneda destino

• Filtro “Fecha Desde” → Calendario para indicar la fecha Desde 

• Filtro “Fuente” → Dropdown con las opciones “Todas”, “Externa” y “Manual”. Por defecto se encuentra seleccionada “Todas”.

• Filtro “Aplicación” → Checkbox con las opciones “Aéreo”, “Hotel”, “Travel Extra”, “Auto”, “Asistencia”, “Bus”. La opción “Asistencia” tiene una leyenda explicativa debajo que indica “Únicamente para flujos desde el API”. Por otro lado, debajo de la etiqueta “Aplicación” se visualiza un link “Seleccionar Todos”. Cuando el mismo se presiona, se tildan todos los tipos de productos y el link pasa a llamarse “Limpiar Selección”

• Filtro “Solo tipos de cambio activos”

• Botón “Buscar”

En la parte inferior de la pantalla la grilla cuenta con los siguientes campos:

• Check para indicar que se encuentra activa la configuración

• Icono de edición y eliminación. El mismo se muestra únicamente para registros manuales.

• “Moneda Origen” para mostrar el código de moneda desde (siempre será USD)

• “Moneda Destino” para mostrar el código de moneda hasta

• “Tipo de Cambio” para mostrar el tipo de cambio

• “Fecha” para mostrar la fecha y hora de creación/actualización

• “Fuente” para mostrar si es un tipo de cambio externo (proveniente del GDS) o de la agencia. Si es del GDS figura la fuente, “Amadeus” o “Sabre”. Si es un tipo de cambio configurado por la agencia dice “Manual”

• "Aplicación" para mostrar los productos a los cuales aplica el tipo de cambio. Si aplica para más de un producto, se concatenan separados por comas.

6. Edición de Tipos de Cambio

⚠️ Solo se pueden editar los tipos de cambio “Manuales“.

Cuando se selecciona el ícono del lápiz dentro del resumen de tipos de cambio, se despliega la pantalla de configuración de tipos de cambio.

En ese caso la pantalla muestra los mismos campos de la creación del tipo de cambio pero con las siguientes modificaciones:

• El checkbox “Activo” tiene oculta la leyenda explicativa

• El campo “Aplicación” tiene oculta la leyenda explicativa

• Se agrega un campo adicional “Fecha” para informar la fecha de creación del tipo de cambio o de última modificación en caso de haber sido editado.

Una vez se modifica el tipo de cambio y se presiona el botón “Guardar“, se actualiza la información en la base de datos.

7. Eliminación de Tipos de Cambio

⚠️ Solo se pueden eliminar los tipos de cambio “Manuales“.

Cuando se selecciona el ícono del cesto de residuos dentro del resumen de tipos de cambio, se despliega un pop up.

Dicho pop up consulta:

Si el usuario selecciona el tilde verde → se elimina el tipo de cambio.

Si el usuario selecciona la cruz roja → se cierra el pop up y no se elimina el tipo de cambio.

8. Aplicación de Tipos de Cambio

Cuando se realiza una búsqueda, se valida si la moneda del producto es igual a la moneda de los resultados obtenidos, ya sea por los proveedores conectados o contenido de producto local.  

Para orientarnos, los resultados de los proveedores utilizan la moneda establecida en la credencial.

Los productos locales, utilizan la moneda configurada en el mismo producto dentro de su Tarifario.

Entonces:

Si la moneda del producto es igual a la moneda del resultado →  NO se necesita hacer ninguna conversión para mostrar los productos en el flujo.

Si la moneda del producto es distinta a la moneda del resultado → Entonces se consulta el tipo de cambio establecido por la agencia de forma manual para el tipo de producto. Si está definido y aplica, se utiliza ese tipo de cambio. Si no, se consultan las conversiones al GDS y se utiliza este tipo de cambio en el flujo.

📣 La aplicación de tipos de cambio tiene jerarquía. Por tal motivo, la búsqueda de conversiones siguen el siguiente orden: 

1. Buscar la conversión que coincida con la moneda origen y la moneda destino para el día que se necesita y para el tipo de producto requerido, tomando siempre la que tenga la hora más reciente y se encuentre activa. 

2. Si para ese día existe un tipo de cambio “Externo” y también “Manual”, entonces se prioriza el uso del tipo de cambio “Manual” establecido por la empresa, siempre y cuando ambos apliquen bajo las mismas condiciones.

3. Si no existe el tipo de cambio directo entre la moneda desde y hasta, entonces se busca el camino para llegar, por ejemplo: si tengo dos conversiones (USD a EUR y USD a COP) y de un proveedor viene una tarifa en EUR y tengo que devolverla en COP, se aplican las dos conversiones necesarias para llegar a la moneda de destino.

4. Si no existe el tipo de cambio que se necesita para el dia (ni manual ni externo), entonces se dispara el proceso de consulta de tipos de cambio en el proveedor (GDS) con la credencial de moneda que esté activa.

5. Si no existe el tipo de cambio manual y tampoco hay una credencial de moneda configurada, entonces se genera un error en un LOG con un mensaje de tipo de cambio invalido con el detalle de que no hay credencial de moneda configurada ni tipo de cambio manual para la combinación de monedas que se necesita [moneda desde] a [moneda hasta]. “There is no configured currency credential. There is also no manual exchange rate for the combination of currencies needed: [currency from] to [currency to]”. 

9. Consideraciones Adicionales