Отчет Агентства в Авиакомпанию о продаже пассажирских авиаперевозок (hsPaxSalesReport) 1. Описание Существуют форматы для «электронных» отчетов агентств о продаже пассажирских авиаперевозок. Это форматы «BSP HOT» (продажа на бланках BSP), «ARC CAT» (продажа на бланках ARC), «Стандарт обменных файлов для Перевозчиков» (продажа на бланках ТКП). Но, формата «электронных» отчетов о продаже агентствами на бланках авиакомпании, к сожалению не было. Компания «Эскорт» разработала такой формат - hsPaxSalesReport. Формат разработан базе формата IATA BSP RET, но уже с применением современных подходов XML-схем. 2. Структура отчета Отчет имеет иерархическую структуру и состоит из: Отчета (корневой сегмент- элемент REPORT) Реестров (элемент SUBREPORT) Пачек (элемент BATCH) Трансакций (элемент TRANSACTION). В отчете должен быть только один элемент REPORT. Элемент REPORT должен содержать один или несколько элементов SUBREPORT (реестров). Деления элемента REPORT на элементы SUBREPORT в настоящей версии нет. Возможно, будет в последующих версиях. В настоящей версии элемент REPORT включает один (фиктивный) элемент SUBREPORT. Элемент SUBREPORT, в свою очередь, включает один или несколько элементов BATCH (пачек). В элемент BATCH группируются элементы TRANSACTION. В отдельные пачки выделяются аннулированные, испорченные, проданные, возвращенные, обменянные документы и претензии. Пачки должны располагаться в следующем порядке: пачки вида «Аннулированные», «Испорченные», «Возврат», «Обмен», «Продажа». Каждая пачка содержит 50 документов, кроме последней пачки каждого вида, которая может быть неполной. Группировка в пачку может осуществляться по кассиру или по валидатору (по усмотрению Агента). Порядок документов в пачках, а также компоновка пачек должны соответствовать порядку документов в Едином реестре (бумажном). Элемент BATCH элементы TRANSACTION (транзакции). Элемент TRANSACTON – содержит информацию по операции над одним или группой документов, связанных одной или несколькими формами оплаты. Элемент REPORT Элемент REPORT, содержит элементы: AIRLINE – цифровой код Авиакомпании в кодировке IATA. AGENCY – код Агентства (присвоенный Агентству Авиакомпанией) PERIOD_BEGIN – дата начала отчетного периода PERIOD_END – дата окончания отчетного периода CATEGORY – категория отчета. Возможные значения: PAX (пассажирский). CURRENCY – символьный (ISO) код валюты отчета. Элемент SUBREPORT Элемент SUBREPORT содержит элемент: NAME – наименование элемента SUBREPORT. Допустимо наименование «пусто» - в настоящей версии. Элемент BATCH Элемент BATCH, включает следующие атрибуты и элементы: NO – порядковый номер пачки в элементе SUBREPORT NAME – наименование элемента BATCH. Возможные значения: AN, CANC, REF, EXC, SALE, MEMO. Элемент TRANSACTION Элемент TRANSACTION включает следующие атрибуты и элементы: NO – номер элемента TRANSACTION в элементе BATCH DAIS – дата трансакции. AGTN – код валидатора. Должен содержать код агента IATA или, при отсутствии такового, код пункта продажи Авиакомпании. TRANS_TYPE – тип элемента TRANSACTION. Может принимать следующие значения: ANNUL – аннулированные ТСТ, ЕВТ, МСО CANCEL – испорченные ТСТ, ЕВТ, МСО SALE – продажа документов TCT/ EBT/ MCO, включение в «Отчет о продаже» Претензий (ADM/ ACM), включение в «Отчет» продажи чартера REFUND – возврат ТСТ, ЕВТ, МСО STICKER – изменение условий перевозки, без выписки нового перевозочного документа (TCT или EBT). VAT – признак взимания НДС. Может принимать следующие значения: YES (облагается НДС), NO (без НДС), ND (не определено). CURRENCY – символьный (ISO) код валюты транзакции. E_TICKET – признак «электронный билет». DOC – элемент, содержащий информацию по операции над документом. Конкретный состав элемента DOC зависит от типа элемента TRANSACTION и вида документа. FOP – один или несколько элементов, содержащих информацию о формах оплаты по операции над документом. Элемент обязателен для всех транзакций, кроме CANCEL и ANNUL. AGTA – необязательный элемент для нужд агентства. В авиакомпании не обрабатывается. 3. Описание часто встречающихся элементов TDNR. Обязательный элемент элемента DOC – номер документа. В случае, если документом является TCT/ EBT/ MCO, номер документа представляется в виде AAABSSSSSSSSSS, где AAA – цифровой номер авиакомпании, B – пробел, SSSSSSSSSS – 10-тизначный серийный номер бланка документа. Для документов TCT/ EBT/ MCO, содержащих вместо 3-х цифрового номера авиакомпании, какой-то иной код авиакомпании, например, 2-х или 3-х символьный, элемент TDNR вместо цифрового номера авиакомпании будет содержать символьный код авиакомпании и иметь вид AAABSSSSSSSSSS или AABSSSSSSSSSS, где ААА (АА) – символьный код авиакомпании. Для документов ADM/ ACM (претензии) элемент TDNR должен содержать код авиакомпании и номер, разделенные пробелом. Причем номер представляет собой произвольный цифровой или символьный код, не более 10 знаков. Для документов вида «Чартер» элемент TDNR должен содержать номер чартерного договора – любые символы, не более 30. SCNR Элемент содержит учетный номер бланка (Stock Control Number). Содержит десятизначный номер SCN. AMOUNT Элемент, содержит информацию о сумме, с учетом валюты. Суммой может быть в зависимости от контекста сумма тарифа/ сбора/ оплаты. Содержит элементы: SOURCE – сумма в исходной валюте. CUTP – символьный (ISO) код исходной валюты. RATE – курс перевода исходной валюты в валюту отчета. AMNT – сумма в валюте отчета COMMISSION Элемент, содержит информацию о комиссионных. Комиссия в зависимости от контекста может быть на тариф/ сборы. Содержит следующие элементы: CORT – процент комиссионных COAM – сумма комиссионных CPUI – индикатор использования купонов в элементе DOC, вид купона в элементе COUPON. PXNM – фамилия пассажира PNRR – номер PNR TOUR – код тура INLS – индикатор продажи перевозки PERMIT – разрешающий документ. Содержит элементы: PERMIT_DOC_CODE и PERMIT_DOC_NO PERMIT_DOC_CODE – двухсимвольный код вида разрешающего документа. Перечень видов разрешающих документов определяется Авиакомпанией и доводится до сведения Агента. Возможные значения кода вида разрешающего документа следующие: BC – договор на блоки-мест CH –договор на блок-чартер LT – письмо KV – представительская квота TX – телекс BP - бонусная программа SC – трехсторонний договор PERMIT_DOC_NO – номер разрешающего документа. ENRS – ограничения по перевозке FRCA – расчет тарифа FARE Элемент, содержащий информацию о тарифе. Содержит элементы: AMOUNT и COMMISION COUPONS – участки перевозки TAXES Элемент, содержащий информацию о сборах. Содержит элементы TAX, AMOUNT и COMMISION. Элемент TAX – Содержит элементы: NO – порядковый номер сбора TMFT – код сбора Содержит двухсимвольный код сбора в кодировке IATA, соответствующий справочнику «IATA List of Ticket and Airport Taxes & Fees», односимвольный код в кодировке ЦРТ или код сбора Авиакомпании – код из списка (справочника) возможных кодов, предоставляемого Агенту Авиакомпанией. Рекомендуется, чтобы коды сборов в этом справочнике состояли из буквы и цифры – это поможет избежать пересечения с кодами сборов IATA. Рекомендуемые значения кодов сбора следующие. P1 – Штраф при возврате P2 – Сбор за обмен P3 – За несопровождаемого ребенка P4 – Сбор за выписку дубликата P9 – Штраф за обмен MAIN_DOCS Элемент, содержащий информацию о старшем документе. Старшим документом, считается документ, с которым связана перевозка, оформленная на данном документе (пример: для перевозки багажа - перевозка пассажира, для перевозки одного члена супружеской пары – перевозка другого, для перевозки сопровождающего группы – перевозка всей группы и т.д.). Содержит последовательность элементов MAIN_DOC. Элемент MAIN_DOC - содержит элемент: TDNR – номер старшего документа CONJUNCTIONS Элемент, содержащий информацию о дополнительных документах (продолжение маршрута). Содержит последовательность элементов CONJUNCTION. Элемент CONJUNCTION содержит: NO – порядковый номер документа-продолжения TDNR – номер документа-продолжения SCNR – учетный номер бланка документа-продолжения CPUI – индикатор использования купонов документа-продолжения; может содержать символы F, V, S COUPONS – купоны документа-продолжения, аналогичные купонам основного документа "IFEXCNG- индикатор того, что документ участвовал в операции обмен. Возможные значения: ДА / НЕТ WEIGHT – вес багажа в кг WEIGHT_RATE – тариф за кг CARR – двухсимвольный код перевозчика в кодировке IATA или ЦРТ. FTNR – номер рейса ORAC – пункт «От». Трехсимвольный код аэропорта или города в кодировке IATA или ЦРТ. DSTC – пункт «До». Трехсимвольный код аэропорта или города в кодировке IATA или ЦРТ. FTDA – дата рейса FTDT – время рейса FBST – статус бронирования FBTD – для ТСТ код тарифа в кодировке IATA или ЦРТ; для EBT – вид багажа из Списка (справочника) видов багажа Авиакомпании. Справочник видов багажа может быть пустым RBKD – класс бронирования в кодировке IATA или ЦРТ. NADA – действителен до даты NBDA – действителен от даты STPO – индикатор СТОПОВЕР. O (лат.) или пробел – СТОПОВЕР разрешен; X (лат.) – СТОПОВЕР запрещен. FFRF – номер карточки часто летающего пассажира 4. Описание элемента DOC в зависимости от значений TRANS_TYPE 4.1. ANNUL Операция - аннулирования бланка документа TCT/ EBT/ MCO. Элемент DOC содержит элемент CANCEL. Элемент CANCEL содержит элементы: TDNR SCNR 4.2. CANCEL Операция – порча бланка документа TCT, EBT, MCO. Элемент DOC содержит элемент CANCEL. Элемент CANCEL содержит элемент: TDNR SCNR 4.3. SALE (TCT) Операция – продажа документа TCT. Элемент DOC включает элемент TCT, содержащий: TDNR SCNR CPUI – может содержать символы F, V, S PXNM PNRR TOUR PERMIT ENRS FRCA FARE COUPONS – включает только F купоны TAXES CONJUNCTIONS MAIN_DOCS INLS Элемент COUPONS Содержит последовательность элементов COUPON. Элемент COUPON содержит следующие элементы: NO – номер купона CPUI – может принимать значение F CARR FTNR ORAC – является обязательным DSTC – является обязательным FTDA FTDT FBTD – является обязательным RBKD NADA NBDA STPO – заполняется по требованию Авиакомпании FFRF FBST 4.4. REFUND (TCT) Операция – возврат документа TCT. Элемент DOC, включает элемент TCT, содержащий: TDNR CPUI – может содержать символы R и «пусто». PXNM FARE COUPONS – включает только возвращенные купоны TAXES IFEXCNG Элемент COUPONS Содержит последовательность элементов COUPON. Элемент COUPON содержит следующие элементы: NO – номер купона CPUI – может принимать значение R CARR FTNR ORAC – является обязательным. DSTC – является обязательным. FTDA FBTD – является обязательным. RBKD FFRF 4.5. STICKER (TCT) Операция - изменение условий перевозки, без выписки нового перевозочного документа TCT. Элемент DOC, включает элемент TCT, содержащий: TDNR CPUI – может содержать символы F, и «пробел» PXNM FARE COUPONS – включает только купоны, по которым произошло изменение условий перевозки TAXES Элемент COUPONS Содержит последовательность элементов COUPON. Элемент COUPON содержит следующие элементы: NO – номер купона CPUI – может принимать значение F CARR FTNR ORAC – является обязательным DSTC – является обязательным FTDA FBTD – является обязательным RBKD 4.6. SALE (EBT) Операция – продажа документа EBT. Элемент DOC, включает элемент ЕВТ, содержащий: TDNR SCNR CPUI – может содержать символы F, V, S PXNM WEIGHT – является обязательным WEIGHT_RATE. PERMIT FARE COUPONS – включает только F купоны TAXES CONJUNCTIONS MAIN_DOCS Элемент COUPONS Содержит последовательность элементов COUPON. Элемент COUPON содержит следующие элементы: NO – номер купона CPUI – может принимать значение F CARR FTNR ORAC – является обязательным. DSTC – является обязательным. FTDA FBTD 4.7. REFUND (EBT) Операция – возврат документа EBT. Элемент DOC, включает элемент ЕВТ, содержащий: TDNR CPUI – может содержать символы R и «пусто». PXNM WEIGHT – является обязательным. WEIGHT_RATE FARE COUPONS – включает только возвращенные купоны TAXES IFEXCNG Элемент COUPONS Содержит последовательность элементов COUPON. Элемент COUPON содержит следующие элементы: NO – номер купона CPUI – может принимать значение R CARR FTNR ORAC – является обязательным DSTC – является обязательным FTDA FBTD 4.8. STICKER (EBT) Операция - изменение условий перевозки, без выписки нового перевозочного документа EBT. Элемент DOC, включает элемент ЕВТ, содержащий: TDNR CPUI – может содержать символы F и «пробел» PXNM WEIGHT WEIGHT_RATE FARE COUPONS – включает только купоны, по которым произошло изменение условий перевозки TAXES Элемент COUPONS Содержит последовательность элементов COUPON. Элемент COUPON содержит следующие элементы: NO – номер купона CPUI – может принимать значение F CARR FTNR ORAC – является обязательным DSTC – является обязательным FTDA FBTD 4.9. SALE (MCO) Операция – продажа документа MCO. Элемент DOC, включает элемент МСО, содержащий: TDNR SCNR CPUI – может содержать символы F, V PXNM USAGECODE – код вида МСО. Допустимые значения: PTA (лат.) Чековая книжка Справка Прочее Сдача при обмене Оплата перевозки «Чартер МВЛ», «Чартер ВВЛ» «Оплата групп» «Штраф за непроданные б/места» «Штраф за группу» OTHER_KIND – дополнительный код вида МСО в случае вида «Прочее» Перечень кодов определяется Авиакомпанией и доводится до сведения Агента. Примерный перечень видов «прочих» МСО: Гостиница Аренда автомобиля Тур TELEX – элемент, содержащий текст телекса, в случае вида МСО «PTA» FARE TAXES MAIN_DOCS 4.10. REFUND (MCO) Операция – возврат документа MCO. Элемент DOC, включает элемент МСО, содержащий: TDNR CPUI – может содержать символы R и «пусто». PXNM USAGECODE – см. SALE(MCO) OTHER_KIND – см. SALE(MCO) FARE TAXES 4.11. SALE (Претензии) Операции – согласие Агентства на претензии Авиакомпании и претензии, инициированные Агентством. Элемент DOC, включает элемент ADM – если по претензии Агентство должно Авиакомпании. Элемент DOC, включает элемент ACM – если по претензии Авиакомпания должна Агентству. Элементы ADM и ACM содержат следующие элементы: TDNR –номер документа Претензии. В случае, если претензия инициирована Авиакомпанией, должна содержать номер первичной претензии Авиакомпании. FROM_TO – кем инициирована претензия. Допустимые значения: AL – инициирована Авиакомпанией; AG – инициирована Агентством TRANSPCATE – категория перевозки AMOUNT – элемент, содержит информацию о сумме претензии ITEMS – сложный элемент, содержит информацию о сумме претензии с указанием AMOUNT – элемент, содержит информацию о сумме претензии категории. Заполняется только для претензий инициированных Агентством. RELATED – сложный элемент, содержащая информацию о документах, по которым выписана претензия. Заполняется только для претензий инициированных Агентством. Элемент ITEMS Содержит последовательность пар элементов: ITEM и AMOUNT. ITEM – элемент, содержит информацию о категории претензионной суммы. Содержит следующие элементы: NO – порядковый номер ITEM_TITLE – название категории AMOUNT – элемент, содержит информацию о сумме претензии Элемент RELATED Содержит последовательность элементов REL_DOC. Элемент REL_DOC - содержит элемент: TDNR – номер документа TCT/ EBT/ MCO, вызвавшего претензию 4.12. SALE (Чартер) Операция – продажа чартера. Элемент DOC, включает элемент CHARTER, содержащий следующие элементы: TDNR –номер чартерного договора TRANSPCATE – категория перевозки FARE TAXES 4.13. Элемент FOP Элемент FOP, содержит элементы: CAHS, INVOICE, CREDIT_CARD, EXCHANGE. CASH- за перечисление денег перед Авиакомпанией отвечает Агентство. Рекомендуемые значения элемента FPTP: CA – перечисление на расчетный счет Авиакомпании BA – расчеты по бартеру INVOICE – за перечисление перед Авиакомпанией отвечает Организация клиент (Корпоративные клиенты Авиакомпании, Государственные органы, Органы социальной защиты). Рекомендуемые значения элемента FPTP: AI – корпоративные клиенты Авиакомпании GV – Государственные органы OH – Органы социальной защиты и Военные CREDIT_CARD – за перечисление перед Авиакомпанией отвечает Кредитная фирма. Рекомендуемые значения элемента FPTP: СС – оплата пластиковой картой международных платежных систем UA - оплата пластиковой картой системы UATP OB - оплата прочей пластиковой картой EXCHANGE – обмен (ЕХ) собственных перевозочных документов, либо перевозочных документов Других авиакомпаний; операции внутри Авиакомпании (MC, PT). Рекомендуемые значения элемента FPTP: EX – в счет собственного перевозочного документа или документа Другой авиакомпании MC – оплата по МСО чековая книжка PT – оплата в счет РТА FF – оплата в счет программы Frequent Flyer FD – скидка при представлении определенного количества использованных перевозочных документов CASH –содержит следующие элементы: NO – порядковый номер формы оплаты. FPTF – код формы оплаты AMOUNT – сумма оплаты INVOICE – содержит следующие элементы: NO – порядковый номер формы оплаты. FPTF – код формы оплаты AMOUNT – сумма оплаты FPAC – номер подтверждающего документа организации-клиента (номер воинского требования при перевозке военных по ВПД; серия и номер листа талонов при перевозке категорий пассажиров, имеющих льготы от органов социальной защиты; номер удостоверения при перевозки депутатов Государственной думы и.т.д.) CLID – код организации-клиента. ADDINFO_VPD – дополнительная информация при перевозке военных по ВПД. VPD – номер ВПД NVU – номер военного удостоверения RUS_PASS_NAME – ФИО пассажира по-русски ADDINFO_ SZ – дополнительная информация при перевозке категорий пассажиров, имеющих льготы органов социальной защиты NPU – номер пенсионного удостоверения. LT – серия и номер листа талонов PASSPORT – паспортные данные пассажира ADDRESS – адрес пассажира BORTHDAY – дата рождения пассажира RUS_PASS_NAME – ФИО пассажира по-русски ADDINFO_GD – дополнительная информация при перевозке депутатов Государственной думы NU – номер удостоверения RUS_PASS_NAME – ФИО пассажира по-русски CREDIT_CARD – содержит следующие элементы: NO – порядковый номер формы оплаты FPTF – код формы оплаты CCCC – код кредитной фирмы. FPAC – номер кредитной карты (без указания буквенного кода платежной системы) EXDA – дата действия кредитной карты APLC – код авторизации кредитной карты CCHN – владелец кредитной карты AMOUNT – сумма оплаты EXCHANGE – содержит следующие элементы: NO – порядковый номер формы оплаты FPTF – код формы оплаты TDNR – серийный номер документа принятого в обмен CPUI – номера купонов, принятых к обмену. Содержит номера (1,2,3,4) в соответствующих позициях, в остальных позициях – пробел. AMOUNT – сумма оплаты 5. Особенности формирования трансакций Трансакции SALE (MCO) с видом МСО «Справка» всегда оформляется с нулевыми суммами. Для отражения обмена перевозочного документа возможно использование одного из двух вариантов: Вариант 1: В отчет включается транзакция SALE (TCT/EBT) перевозочного документа, оформленного в обмен на документ того же типа. Элемент FARE должен содержать информацию о вновь оформленном документе: SOURCE тариф, CUTP – код валюты тарифа, RATE – нулевое значение, AMNT – нулевое значение, или сумма доплаты/возврата в валюте транзакции. Элемент COUPONS должен содержать купоны вновь оформленного перевозочного документа. Элемент TAXES должен содержать только вновь оплаченные сборы и таксы, в т.ч. «Штраф при обмене», если при обмене взимается штраф. Элемент FOP должен содержать форму оплаты EXCHANGE с нулевой суммой, с обязательным указанием номера перевозочного документа и номеров купонов, принятых к обмену, и, при необходимости, форму оплаты, отражающую доплату/возврат. При выписке МСО в случае взимания с пассажира штрафа при обмене, МСО включается в отчет с видом «Справка» и нулевыми суммами. Вариант 2: При обмене перевозочного документа, должны последовательно вводиться трансакции SALE (TCT/EBT) и REFUND (TCT/EBT) с полной информацией по каждой в разделах FARE, COUPONS, TAXES и указывая для элемента IFEXCNG значение «Да». Обе транзакции должны содержать ФОП СА на сумму, принятого к обмену билета, а сумма доплаты (возврата пассажиру) может быть показана с кодом ФОП, отражающим реальную доплату (возврат) и принадлежать либо транзакции SALE, если имела место доплата, либо транзакции REFUND, если был возврат денег пассажиру. Если доплата (возврат) производилась наличными, то ФОП СА соответствующей транзакции должна содержать общую суммы (обмениваемого билета + доплата/возврат). Предпочтительным является первый вариант отражения обмена. При выписке МСО в случае взимания с пассажира штрафа при обмене/ возврате перевозочного документа, в трансакцию REFUND (TCT/EBT) с номером принятого в обмен/ возвращаемого документа дополнительно в элемент TAXES водится сбор «Штраф при обмене»/ «Штраф при возврате». В элементе FOP показывается сумма, полученная с пассажира/ возвращенная пассажиру с учетом удержанного штрафа. Выписанное МСО оформляется трансакцией SALE (MCO) с видом МСО – «Справка». В файле трансакция SALE МСО должна следовать за транзакцией REFUND перевозочного документа. При выписке МСО, в случае изменения условий, перевозки, при которой не выполнялся обмен перевозочного документа, вводится трансакция типа STICKER (TCT/EBT) с номером документа, к которому относятся изменения. Выписанное МСО оформляется трансакцией SALE (MCO) с видом МСО – «Справка». В файле трансакции должны следовать друг за другом. Правило заполнения необязательных элементов. Элементы могут присутствовать, если они содержат существенную информацию или, в противном случае, отсутствовать. Например: Элемент TOUR (Код тура) – элемент может присутствовать в транзакции, если данное поле заполнено на билете, и отсутствовать, если не заполнено. Элемент FDTA (дата рейса) – элемент присутствует, когда дата рейса известна, и отсутствует для рейсов с открытой датой. Элемент STOP (Стоповер) – элемент может присутствовать на купонах, соответствующих участкам рейса, на которых Стоповер запрещен, и отсутствовать на остальных купонах. Заполнение необязательных полей согласовывается с требованиями Авиакомпаний. Конец текста