Приложение 2: Описание полей XML документа

TICKETS — корневой узел XML документа , состоит из записи об операции TICKET.

Табл. 1. Поля записи об операции TICKET:

Поле	Описание
TYPE	Тип документа: TICKET, ETICKET, MCO, RECEIPT, EMD.
SYSTEM	Информация о системе резервирования. Атрибут id – код системы (для ГРС – 1H, для других центров – их идентификатор). Атрибут session – сеанс работы (может отсутствовать). Атрибут bso_id – внутрисистемный номер БСО (может отсутствовать).
CURRENCY	Код валюты оплаты: USD, RUB…
DEALDATE	Дата продажи, возврата, обмена – дата сделки.
DEALTIME	Время продажи, возврата, обмена – время сделки.
OPTYPE	Тип операции: SALE – финансовые средства берутся с клиента, REFUND – финансовые средства возвращаются клиенту.
TRANS_TYPE	Общий тип транзакции: SALE, REFUND, CANCEL, EXCHANGE, ERASE.
MCO_TYPE	Если сообщение является данными MCO/EMD то указывается тип MCO из ряда : PTA, RECEIPT, PENALTY,EXC_BAGG, REF_NOTICE, USED_NOTICE, RAILWAY, SERVICE. Атрибут rfic – код основания для выдачи. Атрибут rfisc – устаревший, будет удален в следующей версии, следует использовать аналогичный атрибут элемента REASON из записи EMDCOUPON.
BSONUM	Номер БСО – 4214200000001. Содержит расчетный код авиакомпании и номер билета без пробела.
EX_BSONUM	Заполняется при обменах, содержит номер БСО сданного билета.
FIO	ФИО пассажира.
SURNAME	Фамилия пассажира, введенная в PNR при бронировании.
NAME	Имя пассажира, введенное в PNR при бронировании.
PASS	Документ, удостоверяющий личность.
BENEFIT_DOC	Документ о предоставлении льготы.
BIRTH_DATE	Дата рождения пассажира в формате ДДММГГГГ (например, 25011950).
GENERAL_CARRIER	Валидирующий перевозчик – 421.
RETTYPE	Вид возврата: добровольный = 0, вынужденный = 1.
TOURCODE	Код тура.
OCURRENCY	Код валюты графы «Тариф»: EUR, USD, RUB…
ORATE	Курс перевода из валюты расчета тарифа в валюту графы «Тариф» – 0.7103.
OPRATE	Курс перевода из валюты графы «Тариф» в валюту оплаты.
NCURRENCY	Код валюты расчета тарифа: USD, RUB…
OFARE	Сумма тарифа из графы «Тариф» билета : 400.00.
FARE	Тариф в валюте оплаты 10360.00. Атрибут type принимает значения: FREE – бесплатный билет, IT – IT-тариф, BT – BT-тариф, а при наличии текста, заданного для поля «Тариф» в 35 категории, принимает его значение. Атрибут vat_amount – сумма НДС по тарифу. Атрибут vat_rate – процентная ставка НДС по тарифу.
NRATE	Курс перевода из валюты расчета тарифа в валюту оплаты – 25.9003.
PNR	PNR заказа.
PNR_LAT	PNR заказа на латинице.
INV_PNR	Идентификатор инвенторного PNR
CONJ	Номера дополнительных бланков.
TO_BSONUM	Заполняется для МСО. Номер основного билета.
TYP_NUM	Типографский номер бланка. Атрибут ser — серия бланка.
SEGMENTS	Ни одной, одна или несколько записей участка маршрута SEGMENT.
TAXES	Ни одной, одна или несколько записей сборов TAX. Атрибут vat_amount – общая сумма НДС по сборам авиакомпании. Атрибут vat_rate – процентная ставка НДС по сборам авиакомпании.
FOPS	Одна или несколько записей форм оплаты FOP.
FCMODE	Режим тарификации: AUTO, MANUAL.
COMISSION	Информация об агентской комиссии заключена в атрибутах: type – тип комиссии, принимает значения fixed или percent; currency – код валюты комиссии;amount — сумма валюты; rate – процентная величина комиссии. Заполняется только для сеанса BSP.
BOOK	Информация о бронировании заключена в атрибутах: agency – код агентства, в котором была создана бронь; date – дата бронирования; disp – идентификатор оператора, создавшего бронь; opr_num – номер (жетон) оператора, создавшего бронь; stamp – идентификатор ППР, в котором была создана бронь; tap – пульт, с которого была проведена операция бронирования; time – время проведения бронирования; utc – UTC дата и время проведения операции бронирования в iso формате (YYYYMMDDThhmmss).
DEAL	Информация о сделке заключена в атрибутах: agency – код агентства, в котором была проведена операция; date – дата проведения операции; disp – идентификатор оператора, проведшего операцию; ersp – код интернет пункта продажи (может отсутствовать); pcc – код PCC (pseudo city code), может отсутствовать, сейчас заполняется для сеанса B1G; opr_num – номер (жетон) оператора, проведшего операцию; stamp – идентификатор ППР, в котором была проведена операция; tap – пульт, с которого была проведена операция; time – время проведения операции; utc – UTC дата и время проведения операции в iso формате (YYYYMMDDThhmmss).
SALE	Информация об операции продажи при обмене/возврате заключена в атрибутах: agency – код агентства, в котором была проведена операция продажи; date – дата проведения операции продажи; disp – идентификатор оператора, проведшего операцию продажи; opr_num – номер (жетон) оператора, проведшего операцию продажи; stamp – идентификатор ППР, в котором была проведена операция продажи; tap – пульт, с которого была проведена операция продажи; time – время проведения операции продажи; utc – UTC дата и время проведения операции продажи в iso формате (YYYYMMDDThhmmss).
FARECALС	Строка «Расчет тарифа».
CONTACTS	Массив записей CONTACT.
EXCH_TICKET	Информация об обмениваемом билете, заполняется только при обмене.

Табл. 2. Поля записи участка маршрута SEGMEN

Поле	Описание
SEGNO	Номер участка: от 1 до 4.
SEG_BSONUM	Номер бланка, на котором оформлен сегмент.
COUPON_NO	Номер купона.
IS_VOID	F – flight, V – VOID, S – Surface.
STOP	Признак стоповера (на билете Х): 0 – остановка разрешена, 1 – запрещена
CITY1CODE	Код города отправления как на бланке – LED.
CITY2CODE	Код города прибытия как на бланке – MOW.
PORT1CODE	Код порта отправления как на бланке – PUL.
PORT2CODE	Код порта прибытия как на бланке – VKO.
TERM1	Терминал вылета
TERM2	Терминал прибытия.
CARRIER	Код перевозчика на участке – S7.
CLASS	Класс обслуживания тарифа: X, N…
REIS	Номер рейса.
FLYDATE	Дата отправления в формате ДДММГГГГ.
FLYTIME	Время отправления в формате ЧЧММ.
ARRDATE	Дата прибытия в формате ДДММГГГГ.
ARRTIME	Время прибытия в формате ЧЧММ.
BASICFARE	Базовый тариф – FARE BASIS (название атрибута некорректное, но так уж исторически сложилось).
FFP_INFO	Информация о часто летающем пассажире (ЧЛП), содержащая атрибуты: number – номер бонусной карты программы ЧЛП; certificate – номер сертификата программы ЧЛП.
NFARE	Тариф в валюте расчета – 400.00.
BAGGAGE	Информация о багаже, содержащая атрибуты (могут отсутствовать): number – количество багажа; qualifier – единицы измерения багажа: P – места багажные; L – фунты; K – килограммы; S – места в салоне.

Табл. 3. Поля записи сбора TAX

Поле	Описание
Данные атрибуты сейчас заполняются только для таксы ТКП (ZZ). Атрибут vat_amount – сумма НДС по сбору, не включенному в общую сумму НДС по сборам авиакомпании. Атрибут vat_rate – процентная ставка НДС по данному сбору.
SEGNO	Номер участка: от 1 до 4.
CODE	Код таксы: RU, YQ…
AMOUNT	Сумма сбора в валюте оплаты – 389.00.
NAMOUNT	Сумма в исходной валюте сбора – 15.00.
NCURRENCY	Код исходной валюты сбора: EUR, USD.
NRATE	Курс перевода из исходной валюты сбора в валюту оплаты – 1.33.
OAMOUNT	Сумма сбора в валюте отчетности – 500.00.
OCURRENCY	Код валюты отчетности: EUR, USD.
ORATE	Курс перевода из валюты назначения в валюту отчетности – 1.56.
OPRATE	Курс перевода из валюты отчетности в валюту оплаты.

Табл. 4. Поля записи формы оплаты FOP

Поле	Описание
TYPE	Форма оплаты: CA, СС, INV, ПК.
ORG	Организация – MO (Министерство обороны)…
DOCSER	Серия документа.
DOCNUM	Номер документа.
DOCINFO	Полная информация о платежном документе.
AUTH_INFO	Информация о пластиковой карте: code – код авторизации; currency – код валюты авторизации; amount – сумма авторизации.
AMOUNT	Сумма итого в валюте оплаты – 389.00.

Табл. 5. Поля записи формы контактов CONTACTS

Поле	Описание
CONTACT	Контактная информация.

Табл. 6. Поля записи формы информации агентств AGN_INFO

Поле	Описание
CLIENT_NUM	Номер клиента – 3ПРОЧРМРКНК00000000.
RESERV_NUM	Номер заказа – 3ПРОЧРМРКНЗ00000000.
INFO	Текст ремарок – 3ПРОЧРМРК, может повторяться по числу ремарок.

Табл. 7. Поля записи о принятом в обмен билете EXCH_TICKET

FIO	ФИО пассажира.
AMOUNT	Сумма по билету, учтенная при обмене.
SEGMENTS	Массив элементов SEGMENT, каждый содержит информацию о сегменте сдаваемого билета.
TAXES	Содержит массив элементов TAX, каждый элемент содержит информацию о сборе на сдаваемом билете, учтенном в процессе обмена.

Табл. 8. Поля записи SEGMENTS по принятому в обмен билету

SEGNO	Порядковый номер сегмента.
CITY1CODE	Код города вылета.
CITY2CODE	Код города прибытия.
PORT1CODE	Код порта вылета.
PORT2CODE	Код порта прибытия.
CARRIER	Код перевозчика.
CLASS	Класс обслуживания.
REIS	Номер рейса.
FLYDATE	Дата отправления в формате ДДММГГГГ.
FLYTIME	Время отправления в формате ЧЧММ.
BASICFARE	Код тарифа.

Табл. 9. Поля записи TAXES по принятому в обмен билету

Поле	Описание
SEGNO	Номер сегмента.
CODE	Код сбора.
AMOUNT	Сумма сбора в валюте оплаты – 389.00.
NAMOUNT	Сумма в исходной валюте сбора – 15.00.
NCURRENCY	Код исходной валюты сбора: EUR, USD.
NRATE	Курс перевода из исходной валюты сбора в валюту оплаты – 1.33.

Описание полей файла с информацией о страховках