Importación de aéreos con cambios

Owned by devintegrations
Last updated: may 23, 2022 by Sol Fernandez
6 min read

PARTE I

(Se realizaron pruebas con el cliente y se determinó que la importación de aéreos con cambios ya no se utilizará como se describe en este documento. Para verificar como quedó actualmente la funcionalidad ir a: Importación de cambios voluntarios de ticket aéreos )

Sumario

1. Objetivo

2. Alcance

3. Configuración

4. Cambios en Importer Web

4.1. Importación de Boletos

4.2. Penalidades

4.3. Comprobantes Automáticos

Objetivo

Importar a NetOffice los tickets aéreos intercambiados en NetSuite.

Alcance

Importación de cambios:

  • Sin costo adicional para el pasajero, es decir, en cero ($0.-)

  • Con costo adicional para el pasajero, es decir, con Tarifa e Impuestos.

  • Sin penalidad.

  • Con penalidad (con o sin IVA).

Configuración

Se agrega un nuevo tipo de mapeo en el módulo de Administración > Configuración > Integración Web, solapa “Mapeo Front-NetOffice”, dentro del dropbox “Tipo de Valor” que se llama “Penalidad por cambios en reservas”.

Al seleccionarla, se pueda establecer qué SubTipo de Vario se utilizará para registrar las penalidades por cambios en tickets.


Para eso el dropbox “Valor NetOffice” lista todos los sub-tipos de Varios establecidos en la tabla dbo.Tipos_Varios.

NOTA: En valor Front se debe escribir Penalty, tal como viene en el Response.

Cambios en Importer Web

Importación de Boletos

El Importer Web identifica y crea servicios aéreos emitidos por cambios en NetSuite.

Para ello lee los siguientes campos del TravelItineraryService contenidos en la sección <AirTicketDefinitión>:

  • <EMDNumber> → Informa el número de boleto de tipo EMD.

  • <ExchangeType> → Informa si es un cambio (reissue) o una revalidación.

  • <OriginalTicketNumber> → Informa el número del boleto original, el cual fue intercambiado.

Ejemplo de Response con un boleto cambiado:

Por lo tanto cuando se procese un itinerario cuyo <AirTicketDefinition> tenga <ExchangeType> informado, quiere decir que se trata de un cambio. En ese caso el Importer Web crea un servicio aéreo en el File (como los demás) pero con las siguientes características especiales:

  • Tipo de Ticket → Si el boleto tiene <EmdNumber> informado dentro de <AirTicketDefinition> entonces queda con el campo EMD en TRUE en el File. Si por el contrario el campo <EmdNumber> se encuentra vacío o nulo dentro de <AirTicketDefinition> entonces queda con el campo “E-Tiquete” en TRUE en el File. Eso quiere decir que queda el campo MPD o ETicket = 1 según corresponda en dbo.File_Aereos_Tickets.

  • Revisado → En TRUE. Eso quiere decir que debe quedar el campo InExchange = 1 en dbo.File_Aereos_Tickets.

  • Emitido en Revisión → Con el número del boleto original (el cual sufrió el cambio). Eso quiere decir que debe almacenarse el boleto original en el campo IssuedInExchange en dbo.File_Aereos_Tickets.

  • Tarifa Original → Con la tarifa del boleto original (el cual sufrió el cambio).

  • Tarifa del Revisado con Tasas → Con el precio del boleto original (el cual sufrió el cambio).

Ejemplo de boleto revisado en NetOffice:

Los demás datos del ticket se toman igual que se hace con cualquier servicio aéreo, salvo la lista de tasas ya que en ella se puede informar el IVA de la penalidad.

Por lo tanto, si en la lista de <Taxes> del boleto cambiado se encuentra una tasa con (Code) YSP, esa tasa no queda como tasa del boleto cambiado (se desestima) ya que es el IVA de la penalidad, la cual quedará como un servicio Vario dentro del File.

Se explica su tratamiento a continuación.

Penalidades

Algunos cambios pueden ocasionar una penalidad, en casos de aerolíneas no BSP o sin numero de ticket, es por eso que el Importer Web valida si el nuevo boleto a importar posee dicha penalidad leyendo el campo <Penalty> dentro del <Price>.

Ejemplo de Response con un boleto cambiado con penalidad:

Por lo tanto si existe <Penalty>, el Importer Web debe crear un servicio de tipo Vario en el File con:

  • Proveedor: mismo proveedor del boleto cambiado

  • Prestador: mismo prestador (aerolínea) del boleto cambiado

  • Origen: mismo origen del boleto cambiado

  • Destino: mismo destino del boleto cambiado

  • Código de Reserva: mismo PNR del boleto cambiado

  • Tipo Servicio: Vario Nacional o Internacional en función del destino y el país de la agencia

  • Sub Tipo de Vario: el informado en el nuevo mapeo del punto 1 "Penalidad por cambios en reservas"

  • Fecha Inicio: misma fecha de salida del boleto cambiado

  • Fecha Fin: misma fecha de regreso del boleto cambiado (si es sólo ida, queda misma la fecha de salida por defecto)

  • Pasajeros: misma cantidad de pasajeros que el boleto cambiado (1)

  • Descripción Factura: nombre del sub tipo de vario + ruta del boleto cambiado

  • Tipo de Tarifa: mismo tipo de tarifa del boleto cambiado

  • Moneda: <EquivalentCurrencyCode> dentro de <Penalty> en el <Price> del boleto cambiado

  • Tarifa: <EquivalentAmount> dentro de <Penalty> en el <Price> del boleto cambiado

  • IVA: <EquivalentAmount> de la tasa con (Code) YSP dentro de la lista de tasas del boleto cambiado


Ejemplo de penalidad como Vario en NetOffice:

Comprobantes Automáticos

Si el nuevo boleto emitido por el cambio tiene tarifa y/o impuestos y a su vez posee un <ReservationItemPaymentDefinition> en estado Approved, entonces se genera un recibo automático en función de las reglas configuradas en Administración > Configuración > Comprobantes Automáticos por dicho boleto. A su vez, se genera la solicitud de factura y factura automática en función de las reglas configuradas en Administración > Configuración > Comprobantes, solapa Factura Automática. De igual manera sucede con la penalidad (servicio Vario).

En caso de importar un cambio en cero, es decir un ticket sin tarifa ni impuestos, se debe generar la solicitud de factura y factura automática en función de las reglas sin necesidad de recaudar previamente.

 

Aéreos con cambios - parte 2 - 3.6.1.0

Estados

Segun los estados (Ej. <Status>Pending</Status>) de cada tickete se realizan diferentes acciones:

  • Pending: Se crea el tickete en el expediente de Netoffice.

    • Se crea el tickete en Netoffice para poder recaudarlo.

    • En el response no tiene PNR o numero de reserva aun. Y este dato es obligatorio para Netoffice. Para obtenerlo, se busca el dato de "ExchangeAirReservationId>137870</ExchangeAirReservationId>" y tomar el PNR de este reserva.

    • No se tiene aun numero de tickete, se crea sin numero y luego se actualiza.

    • No se tiene desglose de tasas, solo va a llegar una tasa XT.

  • Expired: Se vencio, se cancelan los ticketes.

  • Cancelled: Cancelado, se cancela los ticketes de la reserva.

    • Expired y Cancelled

      • La reserva se vencio o se cancelo manualmente, ya no se puede emitir.

      • Se cancelan estos ticketes en Netoffice.

  • Issued: Emitido, se tiene el numero de ticket y las tasas que se actualizan en Netoffice.

  • Exchanged: El ticket original estaba como Issued cambia a Exchanged, junto con la emision del nuevo tickete. No se realizan cambios en Netoffice.

    • Issued / Enchanged

      • El tickete nuevo esta emitido y el tickete original quedo cambiado.

      • El tickete nuevo ya tiene numero de PNR, numero de tickete y tasas.

      • Si el tickete existe, se actualiza el numero de tickete y tasas.

      • Si el tickete NO existe, se crea ya con todos los datos.

Penalidad

Se crea el servicio vario de penalidad aun sin tener un ExchangeType informado.

Si un servicio tiene penalidad, se crea el servicio vario de la misma, sin importar el estado del tickete o el ExchangeType del mismo.

Solo se controla para NO crearlo duplicado si ya existe en Netoffice.

  • Si la penalidad llega en una tasa del nuevo tickete, de la misma manera se refleja en Netoffice.

  • Si la penalidad llega como EMD, se crea un servicio vario por la penalidad y un tickete para el nuevo tickete.

  • Si la penalidad es por totales, no se tiene manejo definido ni se han podido realizar pruebas.

WI 69957

Parte 2 WI 76587, 83099

 

Netactica.com