Nuevo Archivo BOX - Kiu System Solutions

Nuevo Archivo BOX - Kiu System Solutions

Nuevo Archivo BOX
(Schema XML)
Tabla de contenido
Nuevo Archivo BOX ............................................................................................................................................ 1
(Schema XML) ..................................................................................................................................................... 1
Introducción ................................................................................................................................................... 1
Formas de generación del archivo ................................................................................................................. 1
Nombre del archivo........................................................................................................................................ 4
Encabezado y Etiquetas ................................................................................................................................. 6
Encabezado ................................................................................................................................................ 7
Transacción ................................................................................................................................................ 8
Punto de venta .......................................................................................................................................... 8
Ticket ......................................................................................................................................................... 9
Nombre de la agencia ................................................................................................................................ 9
Pasajero ..................................................................................................................................................... 9
EMD (Electronic Miscellaneous Document) ............................................................................................ 10
Construcción tarifaria .............................................................................................................................. 11
Endosos y restricciones............................................................................................................................ 11
Comentarios ............................................................................................................................................ 11
Datos Reserva / Localizador ..................................................................................................................... 12
Detalle del cupón del boleto.................................................................................................................... 12
Tarifa ........................................................................................................................................................ 13
Tasas e impuestos .................................................................................................................................... 14
Fees / Cargos ........................................................................................................................................... 14
Comisión .................................................................................................................................................. 14
Formas de pago ....................................................................................................................................... 15
Exchange .................................................................................................................................................. 16
Información del correo electrónico ............................................................................................................. 17
Nota de KIU .................................................................................................................................................. 18
Nuevo BOX XML
Introducción
La funcionalidad del comando BOXN permite generar un archivo detallado con cada uno de los datos de las
emisiones realizadas en las agencias. El archivo tiene un formato XML en donde cada atributo se
corresponde con los campos contenidos en el ticket electrónico o el EMD (Electronic Miscellaneous
Document).
Para poder ejecutar este comando se debe tener instalada la versión 118B de KIU o cualquiera superior
(www.kiusys.com/clienteres118B.exe)
Formas de generación del archivo
Opciones y comandos para generar el archivo BOX XML:

Por número de ticket / EMD (Electronic Miscellaneous Document)
El comando es: BOXN/<número de documento>
Ejemplo: BOXN/9992200040090
Este comando generará el archivo XML con los datos del documento indicado.

Por usuario
El comando es: BOXN/<FECHA>/<ID USUARIO>
Ejemplo: BOXN/14AUG/CCSE594001
Este comando generará el archivo XML con los datos de todos los tickets emitidos y anulados, por el
usuario ingresado en la entrada, para la fecha indicada.
El formato de la fecha es: DDMMM
El comando podrá realizarse siempre y cuando el número de documentos emitidos por el usuario
no supere los 25. Si el usuario hubiera emitido y/o anulado más de 25 documentos el sistema
responderá el error: INVALID - MORE THAN 25 DOCUMENTS ISSUED
Importante: La fecha no podrá ser superior a los 7 días. Si se ingresara una fecha superior a los 7
días el sistema responderá: DATE OUT OF RANGE - MAXIMUM PERMITTED 7 DAYS

Por PNR
El comando es: BOXN
Ejemplo: BOXN
Este comando se debe ejecutar con el PNR desplegado en pantalla y el sistema generará el archivo
XML con los datos de todos los tickets y EMD contenidos en dicho código de reserva.

Por fecha
El comando es: BOXN/<FECHA>
Ejemplo: BOXN/14AUG
Este comando generará el archivo XML con los datos de todos los tickets y EMD emitidos y anulados
por todos los usuarios de la agencia de viajes durante el día indicado en la entrada.
El comando podrá realizarse siempre y cuando el número de documentos emitidos en el día no
supere los 25. Si se hubieran emitido y/o anulado más de 25 documentos el sistema responderá el
error: INVALID - MORE THAN 25 DOCUMENTS ISSUED
Importante: La fecha no podrá ser superior a los 7 días. Si se ingresara una fecha superior a los 7
días el sistema responderá: DATE OUT OF RANGE - MAXIMUM PERMITTED 7 DAYS
Versión 1
KIU® Agosto 2013
1
Nuevo BOX XML

Automático
Se podrá configurar una dirección de correo electrónico o una FTP a donde se enviarán
automáticamente los archivos XML cada vez que se emita y anule un ticket o EMD en la agencia de
viajes. La dirección de correo electrónico o los datos de acceso a la FTP deberán ser informados a
KIU para su configuración.
También se podrá definir para que el archivo se genere y se guarde automáticamente en la carpeta
C:\Reservas\TktFiles de la PC en donde se haya ejecutado el comando.

Desde reporte de ventas WL o WA
Se podrá generar el archivo XML desde el reporte de ventas WL o WA. Primero se deberá desplegar
el reporte en pantalla (WL/<OFICINA>#<FECHA> o WA*) y luego ingresar el siguiente comando:
BOXNWL/<ITEM>-<ITEM>
Ejemplo: BOXNWL/1-25
El ítem es el número de línea, dentro del reporte WL, en donde se encuentra cada uno de los
tickets/EMD.
Opciones:
BOXNWL/3
BOXNWL/3-10
BOXNWL/3-10,15
Un solo documento (ticket o EMD ubicado en línea 3 del reporte)
Un rango de documentos (tickets del 3 al 10)
Documentos del 3 al 10 y el ticket ubicado en la línea 15 del reporte
El número máximo permitido del rango es de 25 documentos, si la cantidad de tickets y
documentos emitidos y anulados superara esa cantidad, se deberá repetir la entrada tantas veces
como sea necesario modificando los ítems del rango.
En caso que ingresara un rango superior a 25 documentos, el sistema responderá el siguiente
mensaje de error: INVALID RANGE – MAXIMUM PERMITTED 25 ITEMS
Si se ingresara el comando para generar el BOX desde un reporte WL o WA y no se hubiera
desplegado el reporte previamente, el sistema responderá: INVALID - WL/WA IS NOT DISPLAYED

Desde un PNR seleccionando algunos tickets
Se podrá generar manualmente el archivo BOX seleccionando alguno de los tickets incluidos en la
reserva. Para poder generar los archivos bajo esta modalidad, el PNR debe estar desplegado en
pantalla y se debe ingresar el siguiente comando: BOXN<ITEM DEL TICKET>
Ejemplo: BOXN2
El ítem es el número de línea, dentro de la reserva, en donde se encuentra cada uno de los tickets.
Opciones:
BOXN3
BOXN3-10
BOXN10,15
Versión 1
Ticket ubicado en línea 3 de la reserva
Un rango de tickets (tickets del 3 al 10)
Tickets ubicados en las líneas 10 y 15 de la reserva
KIU® Agosto 2013
2
Nuevo BOX XML

Desde un PNR seleccionando algunos EMD
Se podrá generar manualmente el archivo BOX seleccionando alguno de los EMD incluidos en la
reserva. Para poder generar los archivos bajo esta modalidad, el PNR debe estar desplegado en
pantalla y se debe ingresar el siguiente comando: BOXNEMD/<ITEM DEL EMD>
Ejemplo: BOXNEMD/1
El ítem es el número de línea, dentro de la reserva, en donde se encuentra cada uno de los EMD.
Opciones:
BOXNEMD/3
BOXNEMD/3-5
BOXNEMD/3,5

EMD ubicado en línea 3 de la reserva
Un rango de EMD (del 3 al 5)
EMDs ubicados en las líneas 3 y 5 de la reserva
Reenvío al método automatizado (EMAIL o FTP)
Si al final del comando se agrega la extensión –SEND, el sistema enviará el archivo BOXN al correo
electrónico o a la FTP, configurada para recibir automáticamente estos archivos al momento de la
emisión o anulación.
La extensión –SEND aplica para todas la opciones de generación manual del BOXN. Ejemplos:
o
Por número de ticket: BOXN/9992200040090-SEND
o
Por código de usuario: BOXN/14AUG/CCSE594001-SEND
o
Por PNR: BOXN-SEND
o
Por fecha: BOXN/14AUG-SEND
o
Desde WA o WL: BOXNWL/1-10-SEND
o
Desde PNR especificando ticket: BOXN2-SEND
o
Desde PNR especificando EMD: BOXNEMD/1-SEND
Al realizar este comando el sistema responderá el siguiente mensaje, dependiendo del método de
envío configurado para la agencia de viajes:
o
OK FILE SENT BY MAIL
o
OK FILE SENT BY FTP
Si la agencia no tuviera un método de envío automatizado para el BOXN, y el usuario ingresara el
comando con la opción –SEND, el sistema responderá el siguiente mensaje de error:
o
INVALID - AUTOMATED METHOD NOT CONFIGURED
o
INVALIDO - METODO AUTOMATIZADO NO CONFIGURADO
Versión 1
KIU® Agosto 2013
3
Nuevo BOX XML
Nombre del archivo
El nombre del archivo podrá variar según el método que se haya utilizado para generar el archivo.
Método de generación por fecha
Nombre del archivo: KIU_BOX_14AUG.XML
Estructura: KIU_BOX_<DDMMM>.XML
Descripción:
KIU_BOX_
Estructura fija
<DDMMM>
Formato fecha
.XML
Extensión
Método de generación por fecha y usuario
Nombre del archivo: KIU_BOX_14AUG_CCSE59405.XML
Estructura: KIU_BOX_<DDMMM>_<ID USUARIO>.XML
Descripción:
KIU_BOX_
Estructura fija
<DDMMM>_
Formato fecha
<ID USUARIO> Código del usuario (9 caracteres alfanuméricos)
.XML
Extensión
Método de generación por número de ticket / EMD
Nombre del archivo: KIU_BOX_9994138275115.XML
Estructura: KIU_BOX_<NRO DE DOCUMENTO>.XML
Descripción:
KIU_BOX_
Estructura fija
<NRO DE DOCUMENTO> Número del ticket o EMD (13 caracteres numéricos)
Método de generación desde el PNR
Nombre del archivo: KIU_BOX_AFLLYA.XML
Estructura: KIU_BOX_<CODIGO DE PNR>.XML
Descripción:
KIU_BOX_
Estructura fija
<CODIGO DE PNR>
Código de la reserva / Localizador (6 caracteres alfabéticos)
Método de generación desde el reporte WL o WA
Nombre del archivo: KIU_BOX_CCSE5940_20AUG.XML
Estructura: KIU_BOX_<OFFICE ID>_<DDMMM>.XML
Descripción:
KIU_BOX_
Estructura fija
<OFFICE ID>
Código de la agencia/oficina en KIU (8 caracteres alfanuméricos)
<DDMMM>
Formato fecha
Método de generación automático con cada emisión / anulación
Nombre del archivo: KIU_BOX_Issue_9990270000001.XML
Estructura: KIU_BOX_<TRANSACCION>_<NUMERO DE DOCUMENTO>.XML
Descripción:
KIU_BOX_
Estructura fija
<TRANSACCION>
Transacción que generó el archivo. Opciones: Issue (emisión) o Void (anulación)
<NUMERO DE DOC>
Número de documento que fue emitido o anulado
Versión 1
KIU® Agosto 2013
4
Nuevo BOX XML
Notas:
 Los archivos se enviarán comprimidos con formato .ZIP debido a normas de seguridad en la
transferencia de datos. Esta estructura aplica tanto si se configura el envío a una FTP o a un EMAIL.

El número de ticket informado en el nombre del archivo será el primero de la reserva, es decir, que
si una reserva tuviera dos o más tickets emitidos, en el nombre del archivo sólo se informará el
número del primer ticket, pero en el interior del archivo se detallarán los datos de cada uno de los
tickets emitidos en dicha reserva.
Versión 1
KIU® Agosto 2013
5
Nuevo BOX XML
Encabezado y Etiquetas
A continuación se describirán las diferentes etiquetas que componen el archivo BOX y se detallarán los
diferentes valores que puede tener cada uno de los atributos contenidos en las etiquetas.
Referencia formato de cada registro
Tipos de Datos:
 A Alfanumérico
 T Alfabético
 N Numérico
 D Fecha (YYYY-MM-DD)
 H Hora (HH:MM)
 DH Fecha Hora (YYYY-MM-DD HH:MM)
Adelante del tipo de dato se indicará la cantidad de caracteres del campo. Si la cantidad pudiera variar, se
indicará de la siguiente manera: n(cantidad máxima), sino el valor indicado corresponde al ancho fijo del
campo.
Versión 1
KIU® Agosto 2013
6
Nuevo BOX XML
Encabezado
<KIU_BackOfficeFile Version="1.0" Partition="Production" QtyDocs="4" TimestampGMT="2013-08-14
16:50" GenMethod="PNR" RecordLocator="AFLLYA" GenBy="CCSE59405">
Atributo
KIU_BackOfficeFile
Version
Partition
Descripción
Archivo para Back Office
Versión del archivo
Entorno del sistema en
donde se realizó la emisión
del boleto
Quantity of Documents /
Cantidad de documentos
Dato
Título
1.0
Production o Test
Ejemplos
(500)N
15
TimestampGMT
Fecha y hora de
generación del archivo
en hora GMT.
DH
2013-08-14 16:50
GenMethod
Método utilizado para
generar el archivo
RecordLocator
Localizador. Este atributo
se presentará cuando el
GenMethod sea PNR /
IssueTransac/VoidTransac
Código de agencia en KIU
Fecha y hora de creación
del PNR (GMT). Atributo
sólo visible cuando el
método de generación sea
por PNR o cuando se emita
(IssueTransac) o anule
(VoidTransac)
Fecha de emisión. Este
atributo se presentará
cuando el GenMethod sea
Agent o Date
Código del usuario que ha
generado el archivo XML
Opciones:
PNR
Date
Agent
TicketNumber
WL (cuando se generó el
archivo a partir de los
reportes WL o WA)
IssueTransac (cuando el
archivo se genera
automáticamente a partir
de una emisión. Incluyen
toda las emisiones
generadas en la misma
transacción)
VoidTransac (cuando el
archivo se genera
automáticamente a partir
de una anulación)
6T
AFLLYA
8A
DH
CCSE5940
2013-08-20 20:47
5A (DDMMM)
13AUG
9A
CCSE59405
QtyDocs
KIU_Office
PNR_DateOfCreationGMT
DateOfIssue
GenBy
Versión 1
KIU® Agosto 2013
7
Nuevo BOX XML
Transacción
<KIU_TktDisplay IATA_Transac="TKTT">
Atributo
KIU_TktDisplay
IATA_Transac
Descripción
Ticket display / Despliegue de boleto
Transacción IATA
Dato
Título
TKTT=Ticket. Boleto Emitido
CANX= Void. Boleto Anulado
EMDS= Electronic Miscellaneous Document
Punto de venta
<POS>
<Source AirlineVendorID="XX" KIU_IssueCode="95534213" KIU_Office="BUEF6970"
PseudoCityCode="BUE" AgentSine="BUEF69701" OriginatorCountry="AR"
IssueSystemCode="C1"/>
</POS>
Atributo
POS
Source
AirlineVendorID
KIU_IssueCode
KIU_Office
PseudoCityCode
AgentSine
OriginatorCountry
IssueSystemCode
Versión 1
Descripción
Point of sale / Punto de
venta
Fuente de datos
Código de aerolínea
Código de emisión de la
oficina emisora / Número
IATA de la agencia
Código de la agencia en KIU
Código de ciudad a donde
pertenece la agencia
Código del usuario que hizo
la venta
Código ISO del país en
donde se vendió el boleto
Código IATA del sistema en
donde se emitió el boleto
Dato
Título
Título
2A
8A
Ejemplos
2I / VH / 3P
95534213 (Agt IATA)
AR061850 (Agt NO IATA)
8A
3A
BUEF6970 / LIME8660
BUE / LIM / MIA
9A
BUEF69701
2T
VE / AR / US
2A
C1 (Es el código IATA de KIU)
KIU® Agosto 2013
8
Nuevo BOX XML
Ticket
<TicketItemInfo TicketNumber="9993300001293" IssuingAgentInfo="MADF69701"
OriginAndDestination="MADBCN" TourCode="TC001" DateOfIssue="2013-08-06"
CountryOfIssue="ES"StatisticalCode="D" KIU_AgencyInvolved="" KIU_ShowFare=""/>
Atributo
TicketItemInfo
TicketNumber
IssuingAgentInfo
OriginAndDestination
TourCode
DateOfIssue
CountryOfIssue
StatisticalCode
KIU_AgencyInvolved
KIU_ShowFare
EMDType
Descripción
Información del boleto
Número de boleto
Agente o usuario emisor
Origen y destino del boleto
Código de viaje
Fecha de emisión
Código ISO del país de
emisión
Código estadístico para
identificar el tipo de venta
Agencia interviniente
Cuando se usa el indicador
TOUR CODE para ocultar la
visualización de la tarifa en
el comprobante para el pax
Tipo de EMD
Dato
Título
13N
9A
6T
(12)A
D
2T
Ejemplos
1T
D: Doméstico
I: Internacional
MIA TRAVEL
BT
(20)A
2A
9993300001293
MADF69701
MADBCN / CCSMIA
TC001
2013-08-06
VE / AR / US
1T
S= EMD Stand alone
A= EMD Associated
Dato
Título
(50)A
Ejemplos
Ejemplos
Nombre de la agencia
<AgencyDescription Info="AGENCIA TRAVEL"/>
Atributo
AgencyDescription
Info
Descripción
Descripción de la agencia
Información / Nombre
AGENCIA TRAVEL
Pasajero
<PassengerName PassengerTypeCode="A">
<Surname>LOPEZ</Surname>
<GivenName>CAROLINA</GivenName>
<KIU_FOID Data="NI123456789"/>
<KIU_VAT Data="20258030169"/>
<KIU_DOB Data="20APR87"/>
</PassengerName>
Atributo
PassengerName
PassengerTypeCode
Descripción
Nombre del pasajero
Código del tipo de pasajero
Dato
Título
1T
Surname
GivenName
KIU_FOID Data
KIU_VAT Data
KIU_DOB Data
Apellido del pasajero
Nombre del pasajero
ID del pasajero
Clave Fiscal
Fecha de nacimiento del pax
(99)T
(99)T
(50)A
(50)A
7A (DDMMMYY)
Versión 1
KIU® Agosto 2013
A= Adult
C= Child
I= Infant
LOPEZ
CAROLINA
NI123456789
20258030169
20APR87
9
Nuevo BOX XML
EMD (Electronic Miscellaneous Document)
<KIU_EMDRemark Info="PENALIDAD POR CANJE DE TICKETS"/>
<KIU_EMDRFIC Code="D"/>
Atributo
KIU_EMDRemark
Info
KIU_EMDRFIC
Code
Descripción
Comentario ingresado en el
EMD
Información
Código de RFIC (Reason for
issuance code)
Código
Dato
Título
Ejemplos
100A
Título
PENALIDAD POR CANJE…
1A
D
<CouponReference KIU_TotalCoupon="2" KIU_TicketNumberOfCoupon="9995570001147">
<SegmentData KIU_NumberOfCoupon="1">
<CouponInfo Number="1" RFIC="D" RFISC_Code="98F" RFISC_Description="PENALTY FEE"
DateOfService="2013-08-28" Refundable="Y" Exchangeable="N" ConsumedAtIssuance="N"
CityOfService="AEP" CityOfServiceName="BUENOS AIRES" AirlineOfService="XX"
AirlineOfServiceName="LINEAS AEREAS XX" CouponStatus="O"/>
</CouponReference>
Atributo
CouponReference
KIU_TotalCoupon
KIU_TicketNumberOfCoupon
SegmentData
KIU_NumberOfCoupon
CouponInfo
Number
RFIC
RFISC
RFISC_Description
DateOfService
Refundable
Exchangeable
ConsumedAtIssuance
CityOfService
CityOfServiceName
Versión 1
Descripción
Referencias del cupón
Cantidad de total de
cupones del EMD
Número del EMD del
cupón
Datos del segmento
Número de cupón del EMD
Información del cupón
Número de cupón del EMD
Código del grupo al cual
pertence el EMD emitido
(Reason for issuance code)
Código del motivo por el
cual se emitió el EMD
(Reason for issuance
subcode)
Descripción del RFISC
Fecha válida para el
servicio del EMD
Indica si el documento
tiene reembolso o no
Indica si el documento
permite canje o no
Indica si se emitió con
status FLOWN/USED o no
Ciudad en donde es válido
el EMD (código ISO del
aeropuerto)
Nombre de la ciudad en
donde es válido el EMD
Dato
Título
1N
Ejemplos
13N
9995570001147
Título
1N
Título
1N
1T
2
1
1
D
3A
98F
(100)A
D
PENALTY FEE
2013-08-28
1T
3T
Y=YES
N=NO
Y=YES
N=NO
Y=YES
N=NO
AEP / MIA / MAD
(100)T
BUENOS AIRES / MIAMI
1T
1T
KIU® Agosto 2013
10
Nuevo BOX XML
AirlineOfService
Código de la aerolínea que
brindará el servicio
contratado en el EMD
Nombre de la aerolínea
Status del cupón del EMD
AirlineOfServiceName
CouponStatus
2A
AR / AA / VH
(100)T
1T
AEROPOSTAL
O=Open For Use
V= Voided
E= Exchanged
F= Flown/Used
Estos atributos se presentarán únicamente cuando se haya emitido un EMD (Electronic Miscellaneous
Document).
Construcción tarifaria
<FareConstruction Info="EZE XX LIM USD100.00YLL XX X/BOG Y XX X/UIO Y XX MIA
USD600.00Y XX JFK USD100.00+NOW TTL USD800.00 END" FareModeIndicator="0"/>
Atributo
FareConstruction
Info
FareModeIndicator
Descripción
Construcción tarifaria
Información y detalle de la
tarifa
Modo de cotización del
itinerario
Dato
Título
(150)A
Ejemplos
1N
0= Cotización utilizando
tarifa publicada (WS y sus
variantes)
1= Cotización manual
(máscara)
EZE XX LIM ARS100.00YLL…
Nota: Cuando la construcción tarifaria tenga el tamaño suficiente como para no entrar en una sola línea,
debido a su extenso itinerario o combinación de tarifas, y se requiera utilizar una segunda línea en el ticket,
en el archivo BOX se visualizará el símbolo + en donde se produce el paso de una línea a otra.
Endosos y restricciones
<Endorsement Info="END / REF CONDITIONS AND PENALTY APPLY"/>
Atributo
Endorsement
Info
Descripción
Endosos / Restricciones
Texto en donde se informa
el endoso y restricción
configurado por la aerolínea
o ingresado por el usuario al
momento de emitir el
boleto
Dato
Título
(99)A
Ejemplos
REF CONDITIONS AND …
Comentarios
<FreeRemark Info="DCDN/12345678Z/350075/123456789*F1DN/12345678Z/350"/>
Atributo
FreeRemark
Info
Versión 1
Descripción
Comentario de libre ingreso
Texto informativo reservado
para usos diversos de
cotizaciones especiales.
Dato
Título
(150)A
KIU® Agosto 2013
Ejemplos
DCDC/12345678…
11
Nuevo BOX XML
Datos Reserva / Localizador
<BookingReferenceID ID="LTDYHY">
<CompanyName Code="C1"/>
</BookingReferenceID>
Atributo
BookingReferenceID
ID
CompanyName Code
Descripción
Referencia de la reserva
Código de la reserva
Código del sistema en
donde se generó la reserva
Dato
Título
6T
2A
Ejemplos
LTDYHY
C1 (Es el código IATA
asignado a KIU)
Detalle del cupón del boleto
<FlightReference KIU_TotalCoupon="5" KIU_TicketNumberOfCoupon="9993300001293">
<FlightSegment DepartureDateTime="2013-08-08 14:00" DepartureAirport="CUN"
ArrivalAirport="MEX" MarketingAirline="XX" FlightNumber=" 623"
ResBookDesigCode="Y"KIU_NumberOfCoupon="1">
<CouponInfo Number="1" FareBasisCode="YLL" BaggageAllow="20" UnitOfMeasure="K"
SegmentPNRStatus="OK" StopOver=" " CouponStatus="O" CouponRemark="OPERATED BY XX
AIRLINES"/>
</FlightSegment>
</FlightReference>
Atributo
FlightReference
KIU_TotalCoupon
KIU_TickeNumberOfCoupon
FlightSegment
DepartureDateTime
DepartureAirport
ArrivalAirport
MarketingAirline
FlightNumber
ResBookDesigCode
KIU_NumberOfCoupon
CouponInfo
Number
FareBasisCode
Versión 1
Descripción
Referencia y datos del
vuelo
Cantidad de cupones que
tiene el boleto
Número de ticket del
cupón
Información del segmento
del vuelo
Fecha y hora local de
salida del vuelo
Dato
Título
Ejemplos
1N
5
13N
9993300001293
DH
(YYYY-MM-DD
HH:MM)
2013-08-08 14:00
Código IATA del
aeropuerto de partida
Código IATA del
aeropuerto de arribo
Código IATA de la
aerolínea marketing
Número de vuelo
Clase de reserva
Número de cupón del
ticket
Información detallada del
cupón de vuelo
Número de cupón
Código de la base tarifaria
3T
CUN / MIA / MEX
3T
CUN / MIA / MEX
2A
3P / QL / W4
(4)N
1T
1N
623
Y
1
Título
Título
1N
(10)A
KIU® Agosto 2013
1
YLL
12
Nuevo BOX XML
BagaggeAllow
Franquicia permitida de
equipaje
Unidad de medida de la
franquicia de equipaje
Status del segmento de
vuelo
(3)N
20
1T
StopOver
Indica si el itinerario
permite parada estancia o
no
1T
CouponStatus
Status del cupón
1T
K= Kilos
P= Piece Concept
OK= Confirmado
RQ= Requerido/Lista espera
NS= No Seat (Infantes)
SA= Sujeto a espacio
Opciones: X o vacío. X indica
que se trata de vuelos en
conexión (no permite
parada estancia)
O= Open for use / Abierto
V= Voided / Anulado
E= Exchanged / Canjeado
CouponRemark
Comentarios del cupón
(500)A
UnitOfMeasure
SegmentPNRStatus
2T
OPERATED BY XX AIRLINES
La etiqueta con los detalles del cupón de vuelo se repetirá tantas veces como cupones tenga el boleto
emitido.
Tarifa
<EquivFare Amount="800.00" CurrencyCode="USD" BSR="1"/>
<BaseFare Amount="800.00" CurrencyCode="USD"/>
<TotalFare Amount="976.11" CurrencyCode="USD"/>
Atributo
EquivFare Amount
CurrencyCode
BSR
BaseFare Amount
Currency Code
TotalFare Amount
Currency Code
Descripción
Monto o Valor equivalente de
la tarifa (puede coincidir o no
con el valor de la tarifa
publicada según cómo se haya
cotizado el itinerario)
Código de la moneda en la cual
fue cotizada la tarifa
Tipo de cambio con respecto al
USD
Monto o Valor publicado para
la tarifa
Código de la moneda en la cual
fue publicada la tarifa
Monto o Valor total del ticket
(tarifa con tasas e impuestos
incluidos)
Código de la moneda de pago
Dato
(10)A
Ejemplos
800.00
3T
ARS / USD / EUR
(10)A
1 / 3.50
(10)A
800.00
3T
ARS / USD / EUR
(10)A
976.11
3T
ARS / USD / EUR
El siguiente atributo se presentará en el XML cuando se realice un exchange con diferencia que el pasajero
debe abonar:
<AditionalCollect Amount="518.80" CurrencyCode="USD"/>
Atributo
AditionalCollect
Amount
CurrencyCode
Versión 1
Descripción
Cobro adicional
Monto o valor
Código de la moneda de
pago
Dato
Título
(10)A
3T
KIU® Agosto 2013
Ejemplos
518.80
ARS / USD / EUR
13
Nuevo BOX XML
Tasas e impuestos
<Taxes>
<Tax TaxCode="IV"
<Tax TaxCode="QN"
<Tax TaxCode="TQ"
<Tax TaxCode="XR"
</Taxes>
Atributo
Taxes
TaxCode
Amount
Paid
Amount="27.83"
Amount="36.00"
Amount="20.00"
Amount="92.28"
Paid="0"/>
Paid="0"/>
Paid="0"/>
Paid="0"/>
Descripción
Tasas e impuestos
Código de la tasa o impuesto
Monto / Valor
Indica si fue pagado
previamente o no (Exchange)
Dato
Título
2A
(10)A
1N
Ejemplos
IV / 6J / QN
27.83
0= No fue pagada
previamente
1= Pagada previamente en
otro boleto (Exchange)
El atributo TaxCode se repetirá tantas veces como tasas e impuestos se hubieran cobrado en el boleto.
Fees / Cargos
<Fees>
<Fee FeeCode="OB" FeeSubCode="T05" Amount="20.00" Reference="FEE DE EMISION" />
<Fee FeeCode="OB" FeeSubCode="T07" Amount="23.00" Reference="FEE ESPECIAL" />
</Fees>
Atributo
Fee
FeeCode
FeeSubCode
Amount
Reference
Descripción
Cargo o costo extra
Código del cargo extra
Subcódigo del cargo extra
Monto o valor del cargo extra
Referencia (texto libre)
Dato
Título
2T
3A
(10)A
(100)A
Ejemplos
OB
Opciones:
T=Fee por ticketing
F=Fee por forma de pago
Luego de valores T o F
continúan 2 caracteres
alfanuméricos.
Ej.: T05 / F02
20.00
FEE DE EMISION
Comisión
<Commission Percentage="8.00" Amount="64.00"/>
Atributo
Commission
Percentage
Amount
Versión 1
Descripción
Comisión por la venta del
boleto
Porcentaje de comisión
Monto o Valor de la comisión
Dato
Título
Ejemplos
(10)A
(10)A
8.00
64.00
KIU® Agosto 2013
14
Nuevo BOX XML
Formas de pago
<FormsOfPayment Count="2">
<FormOfPayment NumberFOP="1" Code="CA" DataIndicator="3" Amount="926.11"
AmountTaxes="143.29"/>
<FormOfPayment NumberFOP="2" Code="CC" DataIndicator="3" Amount="50.00" AmountTaxes="10.00">
<CreditCardInfo CardCode="VI" CardNumber="XXXXXXXXXXXX4242" ApprovalCode="12345"
ExpirationDate="XXXX"/>
</FormOfPayment>
</FormsOfPayment>
Atributo
FormsOfPayment
Count
FormOfPayment
NumberFOP
Code
DataIndicator
Amount
Reference
AmountTaxes
CreditCard
CardCode
CardNumber
ApprovalCode
ExpirationDate
Versión 1
Descripción
Formas de pago utilizadas
para pagar el boleto
Cantidad de formas de pago
utilizadas para pagar el boleto
Detalle de cada forma de
pago
Número de forma de pago
Código de la forma de pago
Dato
Título
Ejemplos
1N
2
Identifica si se trata de una
forma de pago del ticket
recientemente emitido o de
una forma de pago de un
ticket previamente emitido
(Exchange)
1N
Monto o valor abonado con
cada forma de pago
Texto libre reservado para
ciertas formas de pago (por
ejemplo para Cheque, Invoice,
Misceláneas, etc.)
Monto de las tasas/impuestos
pagado con cada fop
Información de la tarjeta de
crédito
Código de la tarjeta de crédito
o débito
Número de la tarjeta de
crédito o débito. Los números
estarán enmascarados con
excepción de los últimos 4.
Código de aprobación o
autorización
Fecha de expiración de la
tarjeta. Los datos vendrán
enmascarados.
(15)A
5= El 5 identifica que es una
fop del ticket original
(cuando se consulta un
boleto que emitió a partir de
un Exchange)
926.11
(50)A
NATIONAL BANK OF …
(15)A
143.29
Título
1N
(4)T
1
CA=Cash
CC=Credit Card
DC=Debit Card
CK=Cheque
IN=Invoice
MS=Miscelánea
3= El 3 identifica que es una
fop del ticket que se está
informando
Título
2A
VI / AX
(24)A
XXXXXXXXXXXX4242
(10)N
12345
4A
XXXX
KIU® Agosto 2013
15
Nuevo BOX XML
Exchange
<KIU_OriginalTicketInfo KIU_OriginalTicketNumber="9992200039997" KIU_OrginalTicketPOI="BUE"
KIU_OrginalTicketDOI="2013-08-07" KIU_OrginalTicketIOI="95503111"/>
<KIU_Exchange KIU_TicketNumber="9992200039997" KIU_CouponNumber="1 "/>
Esta etiqueta se presentará cuando se haga un canje de tickets (exchange).
Atributo
KIU_OriginalTicketInfo
KIU_OriginalTicketNumber
KIU_OriginalTicketPOI
KIU_OriginalTicketDOI
KIU_OriginalTicketIOI
KIU_Exchange
KIU_TicketNumber
KIU_CouponNumber
Versión 1
Descripción
Información del ticket
original
Número de ticket original a
partir del cual se realizó el
exchange
Punto de venta del ticket
original
Fecha de emisión del ticket
original
Código de emisión de la
agencia en donde se emitió
el ticket utilizado para el
exchange
Transacción de canje de
ticket
Número de ticket canjeado
Número de cupón canjeado
Dato
Título
Ejemplos
13N
9992200039997
3T
AEP / MIA / BOG
D (YYYY-MM-DD)
2013-08-07
8A
AR000010 / 95503111
Título
13N
(8)N
KIU® Agosto 2013
9992200039997
1 12 123
16
Nuevo BOX XML
Información del correo electrónico
Cuando se haya configurado para que los archivos BOX XML se envíen automáticamente por correo
electrónico, la dirección configurada recibirá un correo con las emisiones y anulaciones realizadas desde el
remitente [email protected] con la siguiente información:
Asunto del email: KIU Back Office Files
Cuerpo del email:
Los archivos adjuntos contienen información detallada de los documentos emitidos y anulados por su
oficina/agencia. Por favor no responda este correo ya que fue generado automáticamente.
Attached files contain detailed information about documents issued and voided by your office/agency. This
is an automatically generated email, please do not reply.
KIU System Solutions
[email protected]
www.kiusys.com
Versión 1
KIU® Agosto 2013
17
Nuevo BOX XML
Nota de KIU
KIU System Solutions® se reserva el derecho de agregar nuevos atributos al archivo XML en función de
nuevas consideraciones que pudieran ser contempladas en la emisión de los diferentes documentos
relacionados con la actividad de las líneas aéreas y la comercialización de sus servicios.
Versión 1
KIU® Agosto 2013
18