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
Versión 1 KIU® Agosto 2013 1
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
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 2
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 Un solo documento (ticket o EMD ubicado en línea 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 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 Ticket ubicado en línea 3 de la reserva BOXN3-10 Un rango de tickets (tickets del 3 al 10) BOXN10,15 Tickets ubicados en las líneas 10 y 15 de la reserva
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 3
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 EMD ubicado en línea 3 de la reserva BOXNEMD/3-5 Un rango de EMD (del 3 al 5) BOXNEMD/3,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
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 4
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
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 5
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.
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 6
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.
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 7
Encabezado
<KIU_BackOfficeFile Version="1.0" Partition="Production" QtyDocs="4" TimestampGMT="2013-08-14 16:50" GenMethod="PNR" RecordLocator="AFLLYA" GenBy="CCSE59405">
Atributo Descripción Dato Ejemplos
KIU_BackOfficeFile Archivo para Back Office Título
Version Versión del archivo 1.0
Partition Entorno del sistema en donde se realizó la emisión del boleto
Production o Test
QtyDocs Quantity of Documents / Cantidad de documentos
(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
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)
RecordLocator Localizador. Este atributo se presentará cuando el GenMethod sea PNR / IssueTransac/VoidTransac
6T AFLLYA
KIU_Office Código de agencia en KIU 8A CCSE5940
PNR_DateOfCreationGMT 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)
DH 2013-08-20 20:47
DateOfIssue Fecha de emisión. Este atributo se presentará cuando el GenMethod sea Agent o Date
5A (DDMMM) 13AUG
GenBy Código del usuario que ha generado el archivo XML
9A CCSE59405
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 8
Transacción
<KIU_TktDisplay IATA_Transac="TKTT">
Atributo Descripción Dato
KIU_TktDisplay Ticket display / Despliegue de boleto Título
IATA_Transac Transacción IATA 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 Descripción Dato Ejemplos
POS Point of sale / Punto de venta
Título
Source Fuente de datos Título
AirlineVendorID Código de aerolínea 2A 2I / VH / 3P
KIU_IssueCode Código de emisión de la oficina emisora / Número IATA de la agencia
8A 95534213 (Agt IATA) AR061850 (Agt NO IATA)
KIU_Office Código de la agencia en KIU 8A BUEF6970 / LIME8660
PseudoCityCode Código de ciudad a donde pertenece la agencia
3A BUE / LIM / MIA
AgentSine Código del usuario que hizo la venta
9A BUEF69701
OriginatorCountry Código ISO del país en donde se vendió el boleto
2T VE / AR / US
IssueSystemCode Código IATA del sistema en donde se emitió el boleto
2A C1 (Es el código IATA de KIU)
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 9
Ticket <TicketItemInfo TicketNumber="9993300001293" IssuingAgentInfo="MADF69701"
OriginAndDestination="MADBCN" TourCode="TC001" DateOfIssue="2013-08-06"
CountryOfIssue="ES"StatisticalCode="D" KIU_AgencyInvolved="" KIU_ShowFare=""/>
Atributo Descripción Dato Ejemplos
TicketItemInfo Información del boleto Título
TicketNumber Número de boleto 13N 9993300001293
IssuingAgentInfo Agente o usuario emisor 9A MADF69701
OriginAndDestination Origen y destino del boleto 6T MADBCN / CCSMIA
TourCode Código de viaje (12)A TC001
DateOfIssue Fecha de emisión D 2013-08-06
CountryOfIssue Código ISO del país de emisión
2T VE / AR / US
StatisticalCode Código estadístico para identificar el tipo de venta
1T D: Doméstico I: Internacional
KIU_AgencyInvolved Agencia interviniente (20)A MIA TRAVEL
KIU_ShowFare Cuando se usa el indicador TOUR CODE para ocultar la visualización de la tarifa en el comprobante para el pax
2A BT
EMDType Tipo de EMD 1T S= EMD Stand alone A= EMD Associated
Nombre de la agencia <AgencyDescription Info="AGENCIA TRAVEL"/>
Atributo Descripción Dato Ejemplos
AgencyDescription Descripción de la agencia Título
Info Información / 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 Descripción Dato Ejemplos
PassengerName Nombre del pasajero Título
PassengerTypeCode Código 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
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 10
EMD (Electronic Miscellaneous Document) <KIU_EMDRemark Info="PENALIDAD POR CANJE DE TICKETS"/>
<KIU_EMDRFIC Code="D"/>
Atributo Descripción Dato Ejemplos
KIU_EMDRemark Comentario ingresado en el EMD
Título
Info Información 100A PENALIDAD POR CANJE…
KIU_EMDRFIC Código de RFIC (Reason for issuance code)
Título
Code Código 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 Descripción Dato Ejemplos
CouponReference Referencias del cupón Título
KIU_TotalCoupon Cantidad de total de cupones del EMD
1N 2
KIU_TicketNumberOfCoupon Número del EMD del cupón
13N 9995570001147
SegmentData Datos del segmento Título
KIU_NumberOfCoupon Número de cupón del EMD 1N 1
CouponInfo Información del cupón Título
Number Número de cupón del EMD 1N 1
RFIC Código del grupo al cual pertence el EMD emitido (Reason for issuance code)
1T D
RFISC Código del motivo por el cual se emitió el EMD (Reason for issuance subcode)
3A 98F
RFISC_Description Descripción del RFISC (100)A PENALTY FEE
DateOfService Fecha válida para el servicio del EMD
D 2013-08-28
Refundable Indica si el documento tiene reembolso o no
1T Y=YES N=NO
Exchangeable Indica si el documento permite canje o no
1T Y=YES N=NO
ConsumedAtIssuance Indica si se emitió con status FLOWN/USED o no
1T Y=YES N=NO
CityOfService Ciudad en donde es válido el EMD (código ISO del aeropuerto)
3T AEP / MIA / MAD
CityOfServiceName Nombre de la ciudad en donde es válido el EMD
(100)T BUENOS AIRES / MIAMI
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 11
AirlineOfService Código de la aerolínea que brindará el servicio contratado en el EMD
2A AR / AA / VH
AirlineOfServiceName Nombre de la aerolínea (100)T AEROPOSTAL
CouponStatus Status del cupón del EMD 1T 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 Descripción Dato Ejemplos
FareConstruction Construcción tarifaria Título
Info Información y detalle de la tarifa
(150)A EZE XX LIM ARS100.00YLL…
FareModeIndicator Modo de cotización del itinerario
1N 0= Cotización utilizando tarifa publicada (WS y sus variantes) 1= Cotización manual (máscara)
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 Descripción Dato Ejemplos
Endorsement Endosos / Restricciones Título
Info 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
(99)A REF CONDITIONS AND …
Comentarios <FreeRemark Info="DCDN/12345678Z/350075/123456789*F1DN/12345678Z/350"/>
Atributo Descripción Dato Ejemplos
FreeRemark Comentario de libre ingreso Título
Info Texto informativo reservado para usos diversos de cotizaciones especiales.
(150)A DCDC/12345678…
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 12
Datos Reserva / Localizador <BookingReferenceID ID="LTDYHY">
<CompanyName Code="C1"/>
</BookingReferenceID>
Atributo Descripción Dato Ejemplos
BookingReferenceID Referencia de la reserva Título
ID Código de la reserva 6T LTDYHY
CompanyName Code Código del sistema en donde se generó la reserva
2A 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 Descripción Dato Ejemplos
FlightReference Referencia y datos del vuelo
Título
KIU_TotalCoupon Cantidad de cupones que tiene el boleto
1N 5
KIU_TickeNumberOfCoupon Número de ticket del cupón
13N 9993300001293
FlightSegment Información del segmento del vuelo
Título
DepartureDateTime Fecha y hora local de salida del vuelo
DH (YYYY-MM-DD HH:MM)
2013-08-08 14:00
DepartureAirport Código IATA del aeropuerto de partida
3T CUN / MIA / MEX
ArrivalAirport Código IATA del aeropuerto de arribo
3T CUN / MIA / MEX
MarketingAirline Código IATA de la aerolínea marketing
2A 3P / QL / W4
FlightNumber Número de vuelo (4)N 623
ResBookDesigCode Clase de reserva 1T Y
KIU_NumberOfCoupon Número de cupón del ticket
1N 1
CouponInfo Información detallada del cupón de vuelo
Título
Number Número de cupón 1N 1
FareBasisCode Código de la base tarifaria (10)A YLL
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 13
BagaggeAllow Franquicia permitida de equipaje
(3)N 20
UnitOfMeasure Unidad de medida de la franquicia de equipaje
1T K= Kilos P= Piece Concept
SegmentPNRStatus Status del segmento de vuelo
2T OK= Confirmado RQ= Requerido/Lista espera NS= No Seat (Infantes) SA= Sujeto a espacio
StopOver Indica si el itinerario permite parada estancia o no
1T Opciones: X o vacío. X indica que se trata de vuelos en conexión (no permite parada estancia)
CouponStatus Status del cupón 1T O= Open for use / Abierto V= Voided / Anulado E= Exchanged / Canjeado
CouponRemark Comentarios del cupón (500)A 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 Descripción Dato Ejemplos
EquivFare Amount 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)
(10)A 800.00
CurrencyCode Código de la moneda en la cual fue cotizada la tarifa
3T ARS / USD / EUR
BSR Tipo de cambio con respecto al USD
(10)A 1 / 3.50
BaseFare Amount Monto o Valor publicado para la tarifa
(10)A 800.00
Currency Code Código de la moneda en la cual fue publicada la tarifa
3T ARS / USD / EUR
TotalFare Amount Monto o Valor total del ticket (tarifa con tasas e impuestos incluidos)
(10)A 976.11
Currency Code Código 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 Descripción Dato Ejemplos
AditionalCollect Cobro adicional Título
Amount Monto o valor (10)A 518.80
CurrencyCode Código de la moneda de pago
3T ARS / USD / EUR
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 14
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 Descripción Dato Ejemplos
Taxes Tasas e impuestos Título
TaxCode Código de la tasa o impuesto 2A IV / 6J / QN
Amount Monto / Valor (10)A 27.83
Paid Indica si fue pagado previamente o no (Exchange)
1N 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 Descripción Dato Ejemplos
Fee Cargo o costo extra Título
FeeCode Código del cargo extra 2T OB
FeeSubCode Subcódigo del cargo extra 3A 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
Amount Monto o valor del cargo extra (10)A 20.00
Reference Referencia (texto libre) (100)A FEE DE EMISION
Comisión <Commission Percentage="8.00" Amount="64.00"/>
Atributo Descripción Dato Ejemplos
Commission Comisión por la venta del boleto
Título
Percentage Porcentaje de comisión (10)A 8.00
Amount Monto o Valor de la comisión (10)A 64.00
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 15
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 Descripción Dato Ejemplos
FormsOfPayment Formas de pago utilizadas para pagar el boleto
Título
Count Cantidad de formas de pago utilizadas para pagar el boleto
1N 2
FormOfPayment Detalle de cada forma de pago
Título
NumberFOP Número de forma de pago 1N 1
Code Código de la forma de pago (4)T CA=Cash CC=Credit Card DC=Debit Card CK=Cheque IN=Invoice MS=Miscelánea
DataIndicator 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 3= El 3 identifica que es una fop del ticket que se está informando
5= El 5 identifica que es una fop del ticket original (cuando se consulta un boleto que emitió a partir de un Exchange)
Amount Monto o valor abonado con cada forma de pago
(15)A 926.11
Reference Texto libre reservado para ciertas formas de pago (por ejemplo para Cheque, Invoice, Misceláneas, etc.)
(50)A NATIONAL BANK OF …
AmountTaxes Monto de las tasas/impuestos pagado con cada fop
(15)A 143.29
CreditCard Información de la tarjeta de crédito
Título
CardCode Código de la tarjeta de crédito o débito
2A VI / AX
CardNumber Número de la tarjeta de crédito o débito. Los números estarán enmascarados con excepción de los últimos 4.
(24)A XXXXXXXXXXXX4242
ApprovalCode Código de aprobación o autorización
(10)N 12345
ExpirationDate Fecha de expiración de la tarjeta. Los datos vendrán enmascarados.
4A XXXX
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 16
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 Descripción Dato Ejemplos
KIU_OriginalTicketInfo Información del ticket original
Título
KIU_OriginalTicketNumber Número de ticket original a partir del cual se realizó el exchange
13N 9992200039997
KIU_OriginalTicketPOI Punto de venta del ticket original
3T AEP / MIA / BOG
KIU_OriginalTicketDOI Fecha de emisión del ticket original
D (YYYY-MM-DD) 2013-08-07
KIU_OriginalTicketIOI Código de emisión de la agencia en donde se emitió el ticket utilizado para el exchange
8A AR000010 / 95503111
KIU_Exchange Transacción de canje de ticket
Título
KIU_TicketNumber Número de ticket canjeado 13N 9992200039997
KIU_CouponNumber Número de cupón canjeado (8)N 1 12 123
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 17
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
Nuevo BOX XML
Versión 1 KIU® Agosto 2013 18
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.
Top Related