Documente Academic
Documente Profesional
Documente Cultură
(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)
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.
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
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.
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 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
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
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
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.
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.
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.
Transaccin
<KIU_TktDisplay IATA_Transac="TKTT">
Datos de la reserva
<BOD><Source PNR_DateOfCreationGMT="2014-12-03 15:04" KIU_Device="BUEA776003"
PseudoCityCode="BUE" KIU_Office="BUEA7760" AgentSine="BUEA77601"/></BOD>
Nota:
La etiqueta BOD nicamente ser incluida en el archivo BOXN, cuando el mismo se genere con alguno de los
siguientes mtodos:
Punto de venta
<POS>
<Source AirlineVendorID="XX" KIU_IssueCode="95534213" KIU_Office="BUEF6970"
PseudoCityCode="BUE" AgentSine="BUEF69701" OriginatorCountry="AR"
IssueSystemCode="C1"/>
</POS>
Nombre de la agencia
<AgencyDescription Info="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>
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"/>
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"/>
Comentarios
<FreeRemark Info="DCDN/12345678Z/350075/123456789*F1DN/12345678Z/350"/>
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"/>
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>
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>
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"/>
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 "/>
Attached files contain detailed information about documents issued and voided by your office/agency. This
is an automatically generated email, please do not reply.
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.