Nuevo Archivo BOX - kiusys.com XML Nuevo Archivo BOX.pdf · Nuevo BOX XML Versión 1 KIU® Agosto...

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


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


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


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


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


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


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


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>


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


Ticket <TicketItemInfo TicketNumber="9993300001293" IssuingAgentInfo="MADF69701"

OriginAndDestination="MADBCN" TourCode="TC001" DateOfIssue="2013-08-06"

CountryOfIssue="ES"StatisticalCode="D" KIU_AgencyInvolved="" KIU_ShowFare=""/>


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"/>


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>


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


EMD (Electronic Miscellaneous Document) <KIU_EMDRemark Info="PENALIDAD POR CANJE DE TICKETS"/>

<KIU_EMDRFIC Code="D"/>


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>


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


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"/>


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"/>


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"/>


FreeRemark Comentario de libre ingreso Título

Info Texto informativo reservado para usos diversos de cotizaciones especiales.

(150)A DCDC/12345678…

Nuevo BOX XML


Datos Reserva / Localizador <BookingReferenceID ID="LTDYHY">

<CompanyName Code="C1"/>

</BookingReferenceID>


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>


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


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"/>


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"/>


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


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>


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>


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"/>


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


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>


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


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).


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


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

mailto:[email protected]

mailto:[email protected]

http://www.kiusys.com/

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.

Nuevo Archivo BOX - kiusys.com XML Nuevo Archivo BOX.pdf · Nuevo BOX XML Versión 1 KIU® Agosto...

Documents

Transcript of Nuevo Archivo BOX - kiusys.com XML Nuevo Archivo BOX.pdf · Nuevo BOX XML Versión 1 KIU® Agosto...