При подключении этот МОД мод отправляет запрос в gds на предмет подтверждения того, что билет отлетан и формирует справку, в которой шапка и подвал могут быть кастомизированы с помощью html.

Table of Contents

Кому будет полезен этот

...

мод:

Info
Это клиентский МОДмод. Он доступен для подключения и использования только клиентам.

Он будет полезен клиентам, желающим получать подтверждения от агенства о факте выписки билета и присутствии пассажира на рейсе.

Подключение

...

мода:

Для подключения МОДа мода необходимо перейти в раздел “Marketplace”

...

Настройка

...

мода:

После подключения МОДамода, необходимо перейти в раздел “Расширения” и выбрать пункт “Присутствие на рейсе”.

...

Настройка бланка уведомления

Настройка шапки и подвала письма:

Верхняя поле для ввода HTML отвечает за “шапку” бланка, нижняя за “подвал”

...

Настройка шапки и подвала письма:

Все записи должны иметь следующий вид:

...

Code Block

<table style="width:100%">
    <tr>
        <td style="width:50%;font-size:22px;padding-left:0px;color:#7f888a;">
            Контактный телефон: <br />
            +7 (495) 111-11-11
        </td>
        <td style="width:50%;text-align:right;font-size:22px;padding-right:0px;color:#7f888a;">
            ФИО исполнителяЖ.Н. <br />
            Должность
        </td>
    </tr>
</table>

Настройка бланка квитанции-подтверждения:

Редактор выглядит следующим образом:

...

Это классический HTML редактор, в котором используется набор тегов-переменных, список которых представлен ниже. Эти теги-переменные необходимо встраивать в разметку документа квитанции-подтверждения для получения желаемого результата.

Note
Внимание! Шапка и подвал являются элементами бланка-квитанции, т.е. их обязательно необходимо добавить в виде тегов в редактируемый документ в виде тегов ##HEADER## и ##FOOTER##

Переменные для генерации документа:

##HEADER## - шапка документа, берется из настроек мода
##GIVEN## - дата формирования справки
##OWNER## - кому выдана
##AGENCY## - название агентства, в котором выписан билет
##TICKET## - номер электронного билета, по которому летел пассажир
##ROUTE## - маршрут полета,
##DATE## - дата вылета рейса, по которому формируем справку
##PAX## - пассажир, который летел
##FIORU## - ФИО пассажира на русском языке из карточки персоны в формате: Фамилия Имя Отчество
##FIOEN## - ФИО пассажира на латинице из карточки персоны в формате: Secondname Name Patronymic
##FLIGHT## - номер рейса
##PRICE## - стоимость билета (именно всего билета, а не сегмента)
##STATE## - информация о статусе купона - запись вида “Статус купона - открыт для использования, о чем свидетельствует следующая запись из ответа системы бронирования - SU6022 N 12MAY0645 OK NNOR O 12MAY”
##GDS## - информация из системы бронирования в оригинальном виде
##SUPPLIER## - наименование системы бронирования, в которой был оформлен билет. В настоящий момент это Amadeus и Sirena Travel.
##FOOTER## - подвал из настроек мода

Пример кода квитанции-подтверждения:

Code Block

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <title>Справка о присутствии на рейсе</title>
    <style type="text/css">
        body {
            font-family: Arial;
            font-size:18px;
            margin:10px;
        }
    </style>
</head>
<body>
    <table>
        <tr>
            <td>##HEADER##</td>
        </tr>
        <tr>
            <td>
                <h1>Справка-подтверждение</h1>
            </td>
        </tr>
        <tr>
            <td><b>Дата выдачи:</b> ##GIVEN##</td>
        </tr>
        <tr>
            <td><b>Кому выдана:</b> ##OWNER##</td>
        </tr>
        <tr>
            <td>
                <hr />
                Агентство <b>##AGENCY##</b> информирует о статусе перелета пассажира<br />
                с использованием авиабилета ЕТ <b>##TICKET##</b><br />
                по маршруту <b>##ROUTE##</b> на <b>##DATE##</b>, пассажир &ndash; <b>##PAX##</b>, <br />
                ##STATE##.<br />
                Ниже приведен ответ на запрос получения информации о купоне из системы бронирования:
                <hr />
            </td>
        </tr>
        <tr>
            <td style="font-family:'Courier New';white-space:pre">##GDS##</td>
        </tr>
        <tr>
            <td>
                <hr />
                ##FOOTER##
            </td>
        </tr>
    </table>
</body>
</html>

Пример формируемого документа:

Справка формируется в виде PDF-документа и выглядит таким образом:

...

Для билетов Сирены справка- подтверждение выглядит вот так

...

Настройка информации об агентстве:

...

Необходимо внести код Аккредитованного в ТКП агентства из списка, а также имя пульта Sirena travel, используемого в системе.
Также можно внести наименование агентства для отображения в справке-подтверждении.
...
По окончании настроек необходимо нажать на кнопку “Сохранить” в правом нижнем углу.
...

Работа с

...

модом:

При переходе на страницу заказа, будет доступна кнопка, по нажатию на которую в файлы заказа будет добавлена справка о присутствии пассажира на рейсе.

...

Справка о присутствии на рейсе доступна только в тех заказах, которые были уже пролетаны (прошло время прибытия последнего рейса в заказе), выгрузить её можно при помощи кнопки “Справка о присутствии на рейсе” в деталях заказа авиабилетов или через обращение к API:

...

Далее происходит обращение к системе бронирования авиабилетов (в настоящее время поддерживаются ГДС Амадеус и Сирена-2000GDS Amadeus, Sabre, Sirena и S7 API), в результате чего пользователь попадает на страницу с результатом генерации справок, откуда он может сразу же их скачать:

...

После этого справка также будет доступна в разделе “файлы” в деталях заказа с типом “подтверждение от поставщика”:

...

Note
Внимание! В силу имеющихся технологических ограничений у поставщиков справки-подтверждения представляется возможным сформировать только в течение трёх суток с момента окончания перелета.

Почему справка может не сформироваться?

Note

Внимание! Справка формируется только по онлайн заказам (или по оффлайн заказам, в которые предварительно была подгружена бронь (локатор) через импорт и только в случае если статус купона = F (ОТЛЕТАН). Важно понимать, что система имеет связь с GDS (откуда забирает статус купона) через PNR (локатор). Если заказ был оформлен офлайн и после бронь не была подгружена в заказ - справка НЕ сформируется = это корректно. Если статус купона отличен от F (FLOWN) - справка НЕ сформируется = это корректно.

В логах (в событии таймера) будет доступна причина, по которой справка не была сформирована, например:

Смотрим в логе (событие) ТАЙМЕР AviaFlightReportGenerationExecutor для SimpleReserve#(номер заказа)

В логе видим, что по данному заказу у нас действует второе правило. Данный заказ был оформлен оффлайн и не был импортирован локатор (PNR), чтобы связать GDS и заказ. Системе неоткуда получить данные. Система передает такой заказ агенту с соответствующим заданием:

...

Соответственно всегда проверяем лог формирования справки (на предмет распространенных ошибок):

нет локатора в заказе = справка не сформируется
статус купона отличен от “F” = справка не сформируется

Помимо двух данных распространенных ошибок могут встречать и альтернативные ошибки, например, ошибка связи с GDS в момент формирования справки и прочие неисправности.

Вся информация будет доступна в логе таймера.

Поддерживаемые модом поставщики Авиа

Panel

panelIconId	atlassian-note
panelIcon	:note:
bgColor	#C0B6F2

На данный момент мод поддерживает формирование справок для следующих поставщиков авиа: Amadeus, Mixvel, Sabre, S7 API

Доработка мода возможна под других доступных на платформе поставщиков при наличии у поставщика документации по работе с купонами билетов. Доработка осуществляется только на платной основе. Стоимость доработки уточняйте с отделом имплементации, через заявку с типом “оценка” на портале Okdesk. Рекомендуем предварительно вложить (API) документацию желаемого поставщика по работе с купонами.

Выгрузка через API: ^{release 29.11.2022}

Данные о присутствии на рейсе можно выгрузить Универсальным методом выгрузки заказа или командировки Универсальный метод выгрузки заказа или командировки

Для этого в запросе следует передать необязательный параметр <AugmentationData> <xml FlightStatuses="true" /> </AugmentationData>, содержимое которого закодировано в виде HtmlEncode:

Code Block

<soapenv:Body>
  <cor:GetReservationDetails>  
      <cor:id_Reserve>1790548</cor:id_Reserve>
      <cor:AugmentationData>&lt;xml FlightStatuses="true" /&gt;</cor:AugmentationData>
    </cor:GetReservationDetails>
</soapenv:Body>

Данные о присутствии на рейсе буду добавлены в ответе в AugmentationData:

...

Пример структуры ответа:

Code Block

<FlightStatuses>
	<Flight id_Reserve="1790548" Airline="S7" Number="1007" OriginCode="DME" DestinationCode="LED" DepartureDate="13.11.2022" State="FLOWN" Used="true"/>
	<Flight id_Reserve="1790548" Airline="S7" Number="1002" OriginCode="LED" DestinationCode="DME" DepartureDate="14.11.2022" State="FLOWN" Used="true"/>
</FlightStatuses>

Versions Compared

Old Version 1

New Version Current

Key

Кому будет полезен этот

мод:

Подключение

мода:

Настройка

мода:

Настройка бланка уведомления

Настройка шапки и подвала письма:

Настройка бланка квитанции-подтверждения:

Пример формируемого документа:

Настройка информации об агентстве:

Работа с

модом:

Почему справка может не сформироваться?

Поддерживаемые модом поставщики Авиа

Выгрузка через API: ^{release 29.11.2022}

Page Comparison

Versions Compared

Old Version 1

New Version Current

Key

Кому будет полезен этот

мод:

Подключение

мода:

Настройка

мода:

Настройка бланка уведомления

Настройка шапки и подвала письма:

Настройка бланка квитанции-подтверждения:

Пример формируемого документа:

Настройка информации об агентстве:

Работа с

модом:

Почему справка может не сформироваться?

Поддерживаемые модом поставщики Авиа

Выгрузка через API: release 29.11.2022

Выгрузка через API: ^{release 29.11.2022}