При подключении этот МОД мод отправляет запрос в gds на предмет подтверждения того, что билет отлетан и формирует справку, в которой шапка и подвал могут быть кастомизированы с помощью html.
| Table of Contents |
|---|
Кому будет полезен этот
...
мод:
| Info |
|---|
Это клиентский МОДмод. Он доступен для подключения и использования только клиентам. |
Он будет полезен клиентам, желающим получать подтверждения от агенства о факте выписки билета и присутствии пассажира на рейсе.
Подключение
...
мода:
Для подключения МОДа мода необходимо перейти в раздел “Marketplace”
...
Настройка
...
мода:
После подключения МОДамода, необходимо перейти в раздел “Расширения” и выбрать пункт “Присутствие на рейсе”.
...
Настройка бланка уведомления
...
##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>, пассажир – <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, используемого в системе.
...
По окончании настроек необходимо нажать на кнопку “Сохранить” в правом нижнем углу.
...
Работа с
...
модом:
При переходе на страницу заказа, будет доступна кнопка, по нажатию на которую в файлы заказа будет добавлена справка о присутствии пассажира на рейсе.
...
Далее происходит обращение к системе бронирования авиабилетов (в настоящее время поддерживаются ГДС Амадеус и Сирена-2000GDS Amadeus, Sabre, Sirena и S7 API), в результате чего пользователь попадает на страницу с результатом генерации справок, откуда он может сразу же их скачать:
...
После этого справка также будет доступна в разделе “файлы” в деталях заказа с типом “подтверждение от поставщика”:
...
| Note |
|---|
Внимание! В силу имеющихся технологических ограничений у поставщиков справки-подтверждения представляется возможным сформировать только в течение трёх суток с момента окончания перелета. |
Почему справка может не сформироваться?
| Note |
|---|
Внимание! Справка формируется только по онлайн заказам (или по оффлайн заказам, в которые предварительно была подгружена бронь (локатор) через импорт и только в случае если статус купона = F (ОТЛЕТАН). Важно понимать, что система имеет связь с GDS (откуда забирает статус купона) через PNR (локатор). Если заказ был оформлен офлайн и после бронь не была подгружена в заказ - справка НЕ сформируется = это корректно. Если статус купона отличен от F (FLOWN) - справка НЕ сформируется = это корректно. |
В логах (в событии таймера) будет доступна причина, по которой справка не была сформирована, например:
Смотрим в логе (событие) ТАЙМЕР AviaFlightReportGenerationExecutor для SimpleReserve#(номер заказа)
В логе видим, что по данному заказу у нас действует второе правило. Данный заказ был оформлен оффлайн и не был импортирован локатор (PNR), чтобы связать GDS и заказ. Системе неоткуда получить данные. Система передает такой заказ агенту с соответствующим заданием:
...
Соответственно всегда проверяем лог формирования справки (на предмет распространенных ошибок):
нет локатора в заказе = справка не сформируется
статус купона отличен от “F” = справка не сформируется
Помимо двух данных распространенных ошибок могут встречать и альтернативные ошибки, например, ошибка связи с GDS в момент формирования справки и прочие неисправности.
Вся информация будет доступна в логе таймера.
Поддерживаемые модом поставщики Авиа
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
На данный момент мод поддерживает формирование справок для следующих поставщиков авиа: 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><xml FlightStatuses="true" /></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> |