Sunteți pe pagina 1din 21

Nuevo Archivo BOX

(Schema XML)

Versin 1.2
Tabla de contenido
Nuevo Archivo BOX ............................................................................................................................. 1
(Schema XML)...................................................................................................................................... 1
Introduccin .................................................................................................................................... 1
Formas de generacin del archivo .................................................................................................. 1
Nombre del archivo ......................................................................................................................... 4
Encabezado y Etiquetas................................................................................................................... 6
Encabezado ................................................................................................................................. 7
Transaccin ................................................................................................................................. 8
Datos de la reserva ...................................................................................................................... 8
Punto de venta ............................................................................................................................ 9
Ticket ......................................................................................................................................... 10
Nombre de la agencia ............................................................................................................... 10
Pasajero ..................................................................................................................................... 10
EMD (Electronic Miscellaneous Document) .............................................................................. 11
Construccin tarifaria ................................................................................................................ 12
Endosos y restricciones ............................................................................................................. 12
Comentarios .............................................................................................................................. 12
Datos Reserva / Localizador ...................................................................................................... 13
Detalle del cupn del boleto ..................................................................................................... 13
Tarifa ......................................................................................................................................... 14
Tasas e impuestos ..................................................................................................................... 15
Fees / Cargos ............................................................................................................................. 15
Comisin .................................................................................................................................... 15
Formas de pago ......................................................................................................................... 16
Exchange ................................................................................................................................... 17
Informacin del correo electrnico .............................................................................................. 18
Nota de KIU ................................................................................................................................... 19
Nuevo BOX XML

Introduccin
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 electrnico o el EMD (Electronic Miscellaneous
Document).

Para poder ejecutar este comando se debe tener instalada la versin 118B de KIU o cualquiera superior
(www.kiusys.com/clienteres118B.exe)

Formas de generacin del archivo


Opciones y comandos para generar el archivo BOX XML:

Por nmero de ticket / EMD (Electronic Miscellaneous Document)


El comando es: BOXN/<nmero 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 nmero de documentos emitidos por el usuario
no supere los 25. Si el usuario hubiera emitido y/o anulado ms de 25 documentos el sistema
responder el error: INVALID - MORE THAN 25 DOCUMENTS ISSUED

Importante: La fecha no podr ser superior a los 7 das. Si se ingresara una fecha superior a los 7
das 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 cdigo 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 da indicado en la entrada.

El comando podr realizarse siempre y cuando el nmero de documentos emitidos en el da no


supere los 25. Si se hubieran emitido y/o anulado ms de 25 documentos el sistema responder el
error: INVALID - MORE THAN 25 DOCUMENTS ISSUED

Importante: La fecha no podr ser superior a los 7 das. Si se ingresara una fecha superior a los 7
das el sistema responder: DATE OUT OF RANGE - MAXIMUM PERMITTED 7 DAYS

Versin 1.2 KIU Diciembre 2014 1


Nuevo BOX XML

Automtico
Se podr configurar una direccin de correo electrnico o una FTP a donde se enviarn
automticamente los archivos XML cada vez que se emita y anule un ticket o EMD en la agencia de
viajes. La direccin de correo electrnico o los datos de acceso a la FTP debern ser informados a
KIU para su configuracin.

Tambin se podr definir para que el archivo se genere y se guarde automticamente 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 nmero de lnea, dentro del reporte WL, en donde se encuentra cada uno de los
tickets/EMD.

Opciones:
BOXNWL/3 Un solo documento (ticket o EMD ubicado en lnea 3 del reporte)
BOXNWL/3-10 Un rango de documentos (tickets del 3 al 10)
BOXNWL/3-10,15 Documentos del 3 al 10 y el ticket ubicado en la lnea 15 del reporte

El nmero mximo 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 nmero de lnea, dentro de la reserva, en donde se encuentra cada uno de los tickets.

Opciones:
BOXN3 Ticket ubicado en lnea 3 de la reserva
BOXN3-10 Un rango de tickets (tickets del 3 al 10)
BOXN10,15 Tickets ubicados en las lneas 10 y 15 de la reserva

Versin 1.2 KIU Diciembre 2014 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 nmero de lnea, dentro de la reserva, en donde se encuentra cada uno de los EMD.

Opciones:
BOXNEMD/3 EMD ubicado en lnea 3 de la reserva
BOXNEMD/3-5 Un rango de EMD (del 3 al 5)
BOXNEMD/3,5 EMDs ubicados en las lneas 3 y 5 de la reserva

Reenvo al mtodo automatizado (EMAIL o FTP)


Si al final del comando se agrega la extensin SEND, el sistema enviar el archivo BOXN al correo
electrnico o a la FTP, configurada para recibir automticamente estos archivos al momento de la
emisin o anulacin.

La extensin SEND aplica para todas la opciones de generacin manual del BOXN. Ejemplos:
o Por nmero de ticket: BOXN/9992200040090-SEND
o Por cdigo 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 mtodo de
envo configurado para la agencia de viajes:
o OK FILE SENT BY MAIL
o OK FILE SENT BY FTP

Si la agencia no tuviera un mtodo de envo automatizado para el BOXN, y el usuario ingresara el


comando con la opcin SEND, el sistema responder el siguiente mensaje de error:
o INVALID - AUTOMATED METHOD NOT CONFIGURED
o INVALIDO - METODO AUTOMATIZADO NO CONFIGURADO

Versin 1.2 KIU Diciembre 2014 3


Nuevo BOX XML

Nombre del archivo


El nombre del archivo podr variar segn el mtodo que se haya utilizado para generar el archivo.

Mtodo de generacin por fecha


Nombre del archivo: KIU_BOX_14AUG.XML
Estructura: KIU_BOX_<DDMMM>.XML
Descripcin:
KIU_BOX_ Estructura fija
<DDMMM> Formato fecha
.XML Extensin

Mtodo de generacin por fecha y usuario


Nombre del archivo: KIU_BOX_14AUG_CCSE59405.XML
Estructura: KIU_BOX_<DDMMM>_<ID USUARIO>.XML
Descripcin:
KIU_BOX_ Estructura fija
<DDMMM>_ Formato fecha
<ID USUARIO> Cdigo del usuario (9 caracteres alfanumricos)
.XML Extensin

Mtodo de generacin por nmero de ticket / EMD


Nombre del archivo: KIU_BOX_9994138275115.XML
Estructura: KIU_BOX_<NRO DE DOCUMENTO>.XML
Descripcin:
KIU_BOX_ Estructura fija
<NRO DE DOCUMENTO> Nmero del ticket o EMD (13 caracteres numricos)

Mtodo de generacin desde el PNR


Nombre del archivo: KIU_BOX_AFLLYA.XML
Estructura: KIU_BOX_<CODIGO DE PNR>.XML
Descripcin:
KIU_BOX_ Estructura fija
<CODIGO DE PNR> Cdigo de la reserva / Localizador (6 caracteres alfabticos)

Mtodo de generacin desde el reporte WL o WA


Nombre del archivo: KIU_BOX_CCSE5940_20AUG.XML
Estructura: KIU_BOX_<OFFICE ID>_<DDMMM>.XML
Descripcin:
KIU_BOX_ Estructura fija
<OFFICE ID> Cdigo de la agencia/oficina en KIU (8 caracteres alfanumricos)
<DDMMM> Formato fecha

Mtodo de generacin automtico con cada emisin / anulacin


Nombre del archivo: KIU_BOX_Issue_9990270000001.XML
Estructura: KIU_BOX_<TRANSACCION>_<NUMERO DE DOCUMENTO>.XML
Descripcin:
KIU_BOX_ Estructura fija
<TRANSACCION> Transaccin que gener el archivo. Opciones: Issue (emisin) o Void (anulacin)
<NUMERO DE DOC> Nmero de documento que fue emitido o anulado

Versin 1.2 KIU Diciembre 2014 4


Nuevo BOX XML

Notas:
Los archivos se enviarn comprimidos con formato .ZIP debido a normas de seguridad en la
transferencia de datos. Esta estructura aplica tanto si se configura el envo a una FTP o a un EMAIL.

El nmero de ticket informado en el nombre del archivo ser el primero de la reserva, es decir, que
si una reserva tuviera dos o ms tickets emitidos, en el nombre del archivo slo se informar el
nmero del primer ticket, pero en el interior del archivo se detallarn los datos de cada uno de los
tickets emitidos en dicha reserva.

Versin 1.2 KIU Diciembre 2014 5


Nuevo BOX XML

Encabezado y Etiquetas
A continuacin se describirn las diferentes etiquetas que componen el archivo BOX y se detallarn los
diferentes valores que puede tener cada uno de los atributos contenidos en las etiquetas.

Referencia formato de cada registro


Tipos de Datos:
A Alfanumrico
T Alfabtico
N Numrico
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 mxima), sino el valor indicado corresponde al ancho fijo del
campo.

Versin 1.2 KIU Diciembre 2014 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 Descripcin Dato Ejemplos
KIU_BackOfficeFile Archivo para Back Office Ttulo
Version Versin del archivo 1.0
Partition Entorno del sistema en Production o Test
donde se realiz la emisin
del boleto
QtyDocs Quantity of Documents / (500)N 15
Cantidad de documentos
TimestampGMT Fecha y hora de DH 2013-08-14 16:50
generacin del archivo
en hora GMT.
GenMethod Mtodo utilizado para Opciones:
generar el archivo PNR
Date
Agent
TicketNumber
WL (cuando se gener el
archivo a partir de los
reportes WL o WA)
IssueTransac (cuando el
archivo se genera
automticamente a partir
de una emisin. Incluyen
toda las emisiones
generadas en la misma
transaccin)
VoidTransac (cuando el
archivo se genera
automticamente a partir
de una anulacin)
RecordLocator Localizador. Este atributo 6T AFLLYA
se presentar cuando el
GenMethod sea PNR /
IssueTransac/VoidTransac
KIU_Office Cdigo de agencia en KIU 8A CCSE5940
PNR_DateOfCreationGMT Fecha y hora de creacin DH 2013-08-20 20:47
del PNR (GMT). Atributo
slo visible cuando el
mtodo de generacin sea
por PNR o cuando se emita
(IssueTransac) o anule
(VoidTransac)
DateOfIssue Fecha de emisin. Este 5A (DDMMM) 13AUG
atributo se presentar
cuando el GenMethod sea
Agent o Date
GenBy Cdigo del usuario que ha 9A CCSE59405
generado el archivo XML

Versin 1.2 KIU Diciembre 2014 7


Nuevo BOX XML

Transaccin
<KIU_TktDisplay IATA_Transac="TKTT">

Atributo Descripcin Dato


KIU_TktDisplay Ticket display / Despliegue de boleto Ttulo
IATA_Transac Transaccin IATA TKTT=Ticket. Boleto Emitido
CANX= Void. Boleto Anulado
EMDS= Electronic Miscellaneous Document

Datos de la reserva
<BOD><Source PNR_DateOfCreationGMT="2014-12-03 15:04" KIU_Device="BUEA776003"
PseudoCityCode="BUE" KIU_Office="BUEA7760" AgentSine="BUEA77601"/></BOD>

Atributo Descripcin Dato Ejemplos


BOD Booking Data / Datos de la Ttulo
reserva
Source Fuente de datos Ttulo
PNR_DateOfCreationGMT Fecha y hora de creacin DH 2014-12-03 15:04
del PNR (GMT). Atributo
slo visible cuando el
mtodo de generacin sea
por PNR o cuando se emita
(IssueTransac) o anule
(VoidTransac)
KIU_Device Cdigo de la terminal 10A BUEA776003
desde donde se realiz la
venta/anulacin
PseudoCityCode Cdigo de ciudad a donde 3A BUE / LIM / MIA
pertenece la agencia
KIU_Office Cdigo de la agencia en KIU 8A BUEA7760 / LIME8660
AgentSine Cdigo del usuario que hizo 9A BUEA77601
la venta

Nota:
La etiqueta BOD nicamente ser incluida en el archivo BOXN, cuando el mismo se genere con alguno de los
siguientes mtodos:

Desde un PNR (Comando: BOXN con una reserva desplegada en pantalla)


Ticket desde una reserva desplegada en pantalla (Comando: BOXN2)
Mtodo automtico (envo automtico a un mail, FTP, o a un FILE)

Versin 1.2 KIU Diciembre 2014 8


Nuevo BOX XML

Punto de venta
<POS>
<Source AirlineVendorID="XX" KIU_IssueCode="95534213" KIU_Office="BUEF6970"
PseudoCityCode="BUE" AgentSine="BUEF69701" OriginatorCountry="AR"
IssueSystemCode="C1"/>
</POS>

Atributo Descripcin Dato Ejemplos


POS Point of sale / Punto de Ttulo
venta
Source Fuente de datos Ttulo
AirlineVendorID Cdigo de aerolnea 2A 2I / VH / 3P
KIU_IssueCode Cdigo de emisin de la 8A 95534213 (Agt IATA)
oficina emisora / Nmero AR061850 (Agt NO IATA)
IATA de la agencia
KIU_Office Cdigo de la agencia en KIU 8A BUEF6970 / LIME8660
PseudoCityCode Cdigo de ciudad a donde 3A BUE / LIM / MIA
pertenece la agencia
AgentSine Cdigo del usuario que hizo 9A BUEF69701
la venta
OriginatorCountry Cdigo ISO del pas en 2T VE / AR / US
donde se vendi el boleto
IssueSystemCode Cdigo IATA del sistema en 2A C1 (Es el cdigo IATA de KIU)
donde se emiti el boleto

Versin 1.2 KIU Diciembre 2014 9


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 Descripcin Dato Ejemplos


TicketItemInfo Informacin del boleto Ttulo
TicketNumber Nmero de boleto 13N 9993300001293
IssuingAgentInfo Agente o usuario emisor 9A MADF69701
OriginAndDestination Origen y destino del boleto 6T MADBCN / CCSMIA
TourCode Cdigo de viaje (12)A TC001
DateOfIssue Fecha de emisin D 2013-08-06
CountryOfIssue Cdigo ISO del pas de 2T VE / AR / US
emisin
StatisticalCode Cdigo estadstico para 1T D: Domstico
identificar el tipo de venta I: Internacional
KIU_AgencyInvolved Agencia interviniente (20)A MIA TRAVEL
KIU_ShowFare Cuando se usa el indicador 2A BT
TOUR CODE para ocultar la
visualizacin de la tarifa en
el comprobante para el pax
EMDType Tipo de EMD 1T S= EMD Stand alone
A= EMD Associated

Nombre de la agencia
<AgencyDescription Info="AGENCIA TRAVEL"/>

Atributo Descripcin Dato Ejemplos


AgencyDescription Descripcin de la agencia Ttulo
Info Informacin / Nombre (50)A 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 Descripcin Dato Ejemplos


PassengerName Nombre del pasajero Ttulo
PassengerTypeCode Cdigo del tipo de pasajero 1T A= Adult
C= Child
I= Infant
Surname Apellido del pasajero (99)T LOPEZ
GivenName Nombre del pasajero (99)T CAROLINA
KIU_FOID Data ID del pasajero (50)A NI123456789
KIU_VAT Data Clave Fiscal (50)A 20258030169
KIU_DOB Data Fecha de nacimiento del pax 7A (DDMMMYY) 20APR87

Versin 1.2 KIU Diciembre 2014 10


Nuevo BOX XML

EMD (Electronic Miscellaneous Document)


<KIU_EMDRemark Info="PENALIDAD POR CANJE DE TICKETS"/>
<KIU_EMDRFIC Code="D"/>

Atributo Descripcin Dato Ejemplos


KIU_EMDRemark Comentario ingresado en el Ttulo
EMD
Info Informacin 100A PENALIDAD POR CANJE
KIU_EMDRFIC Cdigo de RFIC (Reason for Ttulo
issuance code)
Code Cdigo 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 Descripcin Dato Ejemplos


CouponReference Referencias del cupn Ttulo
KIU_TotalCoupon Cantidad de total de 1N 2
cupones del EMD
KIU_TicketNumberOfCoupon Nmero del EMD del 13N 9995570001147
cupn
SegmentData Datos del segmento Ttulo
KIU_NumberOfCoupon Nmero de cupn del EMD 1N 1
CouponInfo Informacin del cupn Ttulo
Number Nmero de cupn del EMD 1N 1
RFIC Cdigo del grupo al cual 1T D
pertence el EMD emitido
(Reason for issuance code)
RFISC Cdigo del motivo por el 3A 98F
cual se emiti el EMD
(Reason for issuance
subcode)
RFISC_Description Descripcin del RFISC (100)A PENALTY FEE
DateOfService Fecha vlida para el D 2013-08-28
servicio del EMD
Refundable Indica si el documento 1T Y=YES
tiene reembolso o no N=NO
Exchangeable Indica si el documento 1T Y=YES
permite canje o no N=NO
ConsumedAtIssuance Indica si se emiti con 1T Y=YES
status FLOWN/USED o no N=NO
CityOfService Ciudad en donde es vlido 3T AEP / MIA / MAD
el EMD (cdigo ISO del
aeropuerto)
CityOfServiceName Nombre de la ciudad en (100)T BUENOS AIRES / MIAMI
donde es vlido el EMD

Versin 1.2 KIU Diciembre 2014 11


Nuevo BOX XML
AirlineOfService Cdigo de la aerolnea que 2A AR / AA / VH
brindar el servicio
contratado en el EMD
AirlineOfServiceName Nombre de la aerolnea (100)T AEROPOSTAL
CouponStatus Status del cupn del EMD 1T O=Open For Use
V= Voided
E= Exchanged
F= Flown/Used

Estos atributos se presentarn nicamente cuando se haya emitido un EMD (Electronic Miscellaneous
Document).

Construccin 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 Descripcin Dato Ejemplos


FareConstruction Construccin tarifaria Ttulo
Info Informacin y detalle de la (150)A EZE XX LIM ARS100.00YLL
tarifa
FareModeIndicator Modo de cotizacin del 1N 0= Cotizacin utilizando
itinerario tarifa publicada (WS y sus
variantes)
1= Cotizacin manual
(mscara)

Nota: Cuando la construccin tarifaria tenga el tamao suficiente como para no entrar en una sola lnea,
debido a su extenso itinerario o combinacin de tarifas, y se requiera utilizar una segunda lnea en el ticket,
en el archivo BOX se visualizar el smbolo + en donde se produce el paso de una lnea a otra.

Endosos y restricciones
<Endorsement Info="END / REF CONDITIONS AND PENALTY APPLY"/>

Atributo Descripcin Dato Ejemplos


Endorsement Endosos / Restricciones Ttulo
Info Texto en donde se informa (99)A REF CONDITIONS AND
el endoso y restriccin
configurado por la aerolnea
o ingresado por el usuario al
momento de emitir el
boleto

Comentarios
<FreeRemark Info="DCDN/12345678Z/350075/123456789*F1DN/12345678Z/350"/>

Atributo Descripcin Dato Ejemplos


FreeRemark Comentario de libre ingreso Ttulo
Info Texto informativo reservado (150)A DCDC/12345678
para usos diversos de
cotizaciones especiales.

Versin 1.2 KIU Diciembre 2014 12


Nuevo BOX XML

Datos Reserva / Localizador


<BookingReferenceID ID="LTDYHY">
<CompanyName Code="C1"/>
</BookingReferenceID>

Atributo Descripcin Dato Ejemplos


BookingReferenceID Referencia de la reserva Ttulo
ID Cdigo de la reserva 6T LTDYHY
CompanyName Code Cdigo del sistema en 2A C1 (Es el cdigo IATA
donde se gener la reserva asignado a KIU)

Detalle del cupn 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 Descripcin Dato Ejemplos


FlightReference Referencia y datos del Ttulo
vuelo
KIU_TotalCoupon Cantidad de cupones que 1N 5
tiene el boleto
KIU_TickeNumberOfCoupon Nmero de ticket del 13N 9993300001293
cupn
FlightSegment Informacin del segmento Ttulo
del vuelo
DepartureDateTime Fecha y hora local de DH 2013-08-08 14:00
salida del vuelo (YYYY-MM-DD
HH:MM)
DepartureAirport Cdigo IATA del 3T CUN / MIA / MEX
aeropuerto de partida
ArrivalAirport Cdigo IATA del 3T CUN / MIA / MEX
aeropuerto de arribo
MarketingAirline Cdigo IATA de la 2A 3P / QL / W4
aerolnea marketing
FlightNumber Nmero de vuelo (4)N 623
ResBookDesigCode Clase de reserva 1T Y
KIU_NumberOfCoupon Nmero de cupn del 1N 1
ticket
CouponInfo Informacin detallada del Ttulo
cupn de vuelo
Number Nmero de cupn 1N 1
FareBasisCode Cdigo de la base tarifaria (10)A YLL

Versin 1.2 KIU Diciembre 2014 13


Nuevo BOX XML
BagaggeAllow Franquicia permitida de (3)N 20
equipaje
UnitOfMeasure Unidad de medida de la 1T K= Kilos
franquicia de equipaje P= Piece Concept
SegmentPNRStatus Status del segmento de 2T OK= Confirmado
vuelo RQ= Requerido/Lista espera
NS= No Seat (Infantes)
SA= Sujeto a espacio
StopOver Indica si el itinerario 1T Opciones: X o vaco. X indica
permite parada estancia o que se trata de vuelos en
no conexin (no permite
parada estancia)
CouponStatus Status del cupn 1T O= Open for use / Abierto
V= Voided / Anulado
E= Exchanged / Canjeado
CouponRemark Comentarios del cupn (500)A OPERATED BY XX AIRLINES

La etiqueta con los detalles del cupn 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 Descripcin Dato Ejemplos


EquivFare Amount Monto o Valor equivalente de (10)A 800.00
la tarifa (puede coincidir o no
con el valor de la tarifa
publicada segn cmo se haya
cotizado el itinerario)
CurrencyCode Cdigo de la moneda en la cual 3T ARS / USD / EUR
fue cotizada la tarifa
BSR Tipo de cambio con respecto al (10)A 1 / 3.50
USD
BaseFare Amount Monto o Valor publicado para (10)A 800.00
la tarifa
Currency Code Cdigo de la moneda en la cual 3T ARS / USD / EUR
fue publicada la tarifa
TotalFare Amount Monto o Valor total del ticket (10)A 976.11
(tarifa con tasas e impuestos
incluidos)
Currency Code Cdigo de la moneda de pago 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 Descripcin Dato Ejemplos


AditionalCollect Cobro adicional Ttulo
Amount Monto o valor (10)A 518.80
CurrencyCode Cdigo de la moneda de 3T ARS / USD / EUR
pago

Versin 1.2 KIU Diciembre 2014 14


Nuevo BOX XML

Tasas e impuestos
<Taxes>
<Tax TaxCode="IV" Amount="27.83" Paid="0"/>
<Tax TaxCode="QN" Amount="36.00" Paid="0"/>
<Tax TaxCode="TQ" Amount="20.00" Paid="0"/>
<Tax TaxCode="XR" Amount="92.28" Paid="0"/>
</Taxes>

Atributo Descripcin Dato Ejemplos


Taxes Tasas e impuestos Ttulo
TaxCode Cdigo de la tasa o impuesto 2A IV / 6J / QN
Amount Monto / Valor (10)A 27.83
Paid Indica si fue pagado 1N 0= No fue pagada
previamente o no (Exchange) 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 Descripcin Dato Ejemplos


Fee Cargo o costo extra Ttulo
FeeCode Cdigo del cargo extra 2T OB
FeeSubCode Subcdigo del cargo extra 3A Opciones:
T=Fee por ticketing
F=Fee por forma de pago

Luego de valores T o F
continan 2 caracteres
alfanumricos.
Ej.: T05 / F02
Amount Monto o valor del cargo extra (10)A 20.00
Reference Referencia (texto libre) (100)A FEE DE EMISION

Comisin
<Commission Percentage="8.00" Amount="64.00"/>

Atributo Descripcin Dato Ejemplos


Commission Comisin por la venta del Ttulo
boleto
Percentage Porcentaje de comisin (10)A 8.00
Amount Monto o Valor de la comisin (10)A 64.00

Versin 1.2 KIU Diciembre 2014 15


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 Descripcin Dato Ejemplos


FormsOfPayment Formas de pago utilizadas Ttulo
para pagar el boleto
Count Cantidad de formas de pago 1N 2
utilizadas para pagar el boleto
FormOfPayment Detalle de cada forma de Ttulo
pago
NumberFOP Nmero de forma de pago 1N 1
Code Cdigo de la forma de pago (4)T CA=Cash
CC=Credit Card
DC=Debit Card
CK=Cheque
IN=Invoice
MS=Miscelnea
DataIndicator Identifica si se trata de una 1N 3= El 3 identifica que es una
forma de pago del ticket fop del ticket que se est
recientemente emitido o de informando
una forma de pago de un
ticket previamente emitido 5= El 5 identifica que es una
(Exchange) fop del ticket original
(cuando se consulta un
boleto que emiti a partir de
un Exchange)
Amount Monto o valor abonado con (15)A 926.11
cada forma de pago
Reference Texto libre reservado para (50)A NATIONAL BANK OF
ciertas formas de pago (por
ejemplo para Cheque, Invoice,
Miscelneas, etc.)
AmountTaxes Monto de las tasas/impuestos (15)A 143.29
pagado con cada fop
CreditCard Informacin de la tarjeta de Ttulo
crdito
CardCode Cdigo de la tarjeta de crdito 2A VI / AX
o dbito
CardNumber Nmero de la tarjeta de (24)A XXXXXXXXXXXX4242
crdito o dbito. Los nmeros
estarn enmascarados con
excepcin de los ltimos 4.
ApprovalCode Cdigo de aprobacin o (10)N 12345
autorizacin
ExpirationDate Fecha de expiracin de la 4A XXXX
tarjeta. Los datos vendrn
enmascarados.

Versin 1.2 KIU Diciembre 2014 16


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 Descripcin Dato Ejemplos


KIU_OriginalTicketInfo Informacin del ticket Ttulo
original
KIU_OriginalTicketNumber Nmero de ticket original a 13N 9992200039997
partir del cual se realiz el
exchange
KIU_OriginalTicketPOI Punto de venta del ticket 3T AEP / MIA / BOG
original
KIU_OriginalTicketDOI Fecha de emisin del ticket D (YYYY-MM-DD) 2013-08-07
original
KIU_OriginalTicketIOI Cdigo de emisin de la 8A AR000010 / 95503111
agencia en donde se emiti
el ticket utilizado para el
exchange
KIU_Exchange Transaccin de canje de Ttulo
ticket
KIU_TicketNumber Nmero de ticket canjeado 13N 9992200039997
KIU_CouponNumber Nmero de cupn canjeado (8)N 1 12 123

Versin 1.2 KIU Diciembre 2014 17


Nuevo BOX XML

Informacin del correo electrnico


Cuando se haya configurado para que los archivos BOX XML se enven automticamente por correo
electrnico, la direccin configurada recibir un correo con las emisiones y anulaciones realizadas desde el
remitente noreply@kiusys.com con la siguiente informacin:

Asunto del email: KIU Back Office Files

Cuerpo del email:


Los archivos adjuntos contienen informacin detallada de los documentos emitidos y anulados por su
oficina/agencia. Por favor no responda este correo ya que fue generado automticamente.

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


soporte@kiusys.com
www.kiusys.com

Versin 1.2 KIU Diciembre 2014 18


Nuevo BOX XML

Nota de KIU
KIU System Solutions se reserva el derecho de agregar nuevos atributos al archivo XML en funcin de
nuevas consideraciones que pudieran ser contempladas en la emisin de los diferentes documentos
relacionados con la actividad de las lneas areas y la comercializacin de sus servicios.

Versin 1.2 KIU Diciembre 2014 19

S-ar putea să vă placă și