Вебскай Коллеги - История изменений

I.Skladchikov в 13:52, 13 марта 2025

2025-03-13T13:52:15Z

I.Skladchikov в 13:50, 13 марта 2025

2025-03-13T13:50:56Z

D.tsyplakova: /* Ручной импорт */

2023-07-20T07:56:27Z

‎Ручной импорт

D.tsyplakova: Новая страница: «= О модуле = Модуль '''Вебскай Коллеги''' системы позволяет производить дозагрузку авиарей…»

2023-07-20T07:51:20Z

Новая страница: «= О модуле = Модуль '''Вебскай Коллеги''' системы позволяет производить дозагрузку авиарей…»

Новая страница

= О модуле =

Модуль '''Вебскай Коллеги''' системы позволяет производить дозагрузку авиарейсов путем предоставления сотрудникам авиакомпаний возможности приобретения билетов по льготным тарифам, как с подтвержденным местом, так и без подтвержденного места. Конечные пользователи Системы - сотрудники авиакомпаний и их родственники (далее попутчики).

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

Функционал выполняется в виде подключаемого модуля Nemo.Travel. В панели управления для него присутствуют дополнительные настройки.

= Принцип работы =

В систему загружается список сотрудников и аффилированных с ними лиц.

Сотрудник может зарегистрироваться в системе самостоятельно, правильно указав свои данные.

Перейдя по ссылке из почты, сотрудник обязан установить пароль учетной записи.

В своем профиле он может увидеть данные своих попутчиков.

При поиске билетов в поисковой выдаче помимо обычных “коммерческих” билетов будет присутствовать выдача рейсов по специальным (дисконтированным) тарифам, а также тарифы без гарантированного предоставления мест (на подсадку). Купив такой билет человек приезжает в аэропорт, где при наличии свободных мест в самолете и с учетом его очереди на подсадку он допускается или не допускается к полету. Возврат билета производит авиакомпания самостоятельно согласно своему регламенту.

При бронировании билета сотрудник может выбрать только из загруженного в систему '''Вебскай Коллеги''' списка пассажиров.

= Конфигурация =

После включения модуля необходимо настроить ряд параметров

[[Файл:Вебскай Коллеги общие настройки.png]]

'''API Key''' — nокен для автоматизированного импорта списка сотрудников и их родственников в формате JSON

'''Уникальный ID для группировки сотрудников и их попутчиков''' — тут необходимо выбрать поле, которое в списках сотрудников признаком принадлежности родственника (попутчика) к сотруднику. Например у них будет одинаковый GUID или EmployeeID.

'''Дополнительные в ФИО поля для генерации уникального ID записи''' — выбираются поля, которые позволяет отличать полных тёзок друг от друга. Они используются для генерации уникального ID пользователя. Эти данные обязательно должны приходить в списке сотрудников. Если меняется ФИО или один из этих параметров в файле загрузки, то сотрудник или попутчик будет считаться новым человеком. Если изменятся другие данные, то они обновятся у существующего человека.

'''Поля сотрудника для формы регистрации''' — именно эти поля будут запрашиваться и проверяться при регистрации сотрудника в системе. Если хотя бы одно не совпадет, в регистрации будет отказано. Эти поля обязательно должны быть переданы в списке сотрудников.

[[Файл:Вебскай Коллеги Форма регистрации.png]]

'''Типы пассажиров для переопределения при поиске рейсов на подсадку''' — указываются спецкатегории пассажиров, которые являются признаками того, что тариф является тарифом на подсадку.

'''Код авиакомпании''' — импортированные сотрудники будут считаться сотрудниками авиакомпании с этим кодом. У них будет более высокий приоритет на подсадку на рейс “своей” авиакомпании.

== Дополнительные действия по настройке ==

- Сгенерировать токен для импорта по API, указать белый список серверов‎ 
- Отключить лишние компоненты‎ 
- Выключить регистрацию юрлиц‎ 
- Выключить доступ к бронированию для анонимов‎ 
- Настроить почтовый сервер‎ 
- Настроить шаблоны писем‎ 
- Включить новый вид страницы бронирования‎ 
- Отключить блок данных покупателя‎ 
- Добавить контактные данные для пассажиров‎ 
- Настроить платежный шлюз‎ 
- Настроить столбцы в личном кабинете‎ 
- Настроить пакеты реквизитов для поиска дисконтированных и мест на подсадку‎ 
- заполнить правила бронирования и права субъектов персональных данных‎ 
- Скрыть комиссию субагента‎ 

= Импорт сотрудников =

Путем регулярного импорта формируется и поддерживается в актуальном виде список Пользователей, которые имеют доступ к бронированию без места и билетов по специальному тарифу для сотрудников группы компаний. В список также вносится список родственников, на имя которых Пользователь может бронировать билеты. В систему загружается список сотрудников целиком. Если требуется удалить сотрудника, то в новом списке сотрудников не должно быть данных этого сотрудника.

== Автоматизированный импорт ==

Для импорта списка сотрудников, система Авиакомпании отправляет запрос, содержащий данные сотрудников в формате JSON по адресу `HOSTNAME/api__airline_employee_upload`

- Пример данных

```json
[
{
"GUID": 0,
"LastName": "Lennon",
"FirstName": "John",
"MiddleNameEng": null,
"BirthDay": "09.11.1940",
"Sex": "M",
"DateOfEmployment": "09.11.1980",
"EmployeeID": 884220062,
"IsEmployee": 1,
"CategoryCode": 5,
"MiddleName": null,
"LastNameEng": "Lennon",
"FirstNameEng": "John",
"Email": "it@websky.tech",
"RelationDegree": null
},
{
"GUID": 1,
"LastName": "Yoko",
"FirstName": "Ono",
"MiddleNameEng": null,
"BirthDay": "18.02.1933",
"Sex": "F",
"DateOfEmployment": null,
"EmployeeID": 884220062,
"IsEmployee": 0,
"CategoryCode": 1,
"MiddleName": null,
"LastNameEng": "Yoko",
"FirstNameEng": "Ono",
"Email": null,
"RelationDegree": "wife"
},
{
"GUID": 2,
"LastName": "McCartney",
"FirstName": "Paul",
"MiddleNameEng": null,
"BirthDay": "18.06.1942",
"Sex": "M",
"DateOfEmployment": null,
"EmployeeID": 884220062,
"IsEmployee": 0,
"CategoryCode": 1,
"MiddleName": null,
"LastNameEng": "McCartney",
"FirstNameEng": "Paul",
"Email": "pmc@beatles.com",
"RelationDegree": null
},
{
"GUID": 3,
"LastName": "Harrison",
"FirstName": "George",
"MiddleNameEng": null,
"BirthDay": "25..02.1943",
"Sex": "M",
"DateOfEmployment": null,
"EmployeeID": 884220062,
"IsEmployee": 0,
"CategoryCode": 1,
"MiddleName": null,
"LastNameEng": "Harrison",
"FirstNameEng": "George",
"Email": null,
"RelationDegree": null
},
{
"GUID": 4,
"LastName": "Starkey",
"FirstName": "Richard",
"MiddleNameEng": null,
"BirthDay": "07.07.1940",
"Sex": "M",
"DateOfEmployment": null,
"EmployeeID": 884220062,
"IsEmployee": 0,
"CategoryCode": 1,
"MiddleName": null,
"LastNameEng": "Starr",
"FirstNameEng": "Ringo",
"Email": null,
"RelationDegree": null
}
]
```

В случае ошибок обмена, возвращается сообщение об ошибке

- Пример ответа

```json
{
"status": "Error",
"error_msg": "Has invalid records",
"input_records_count": 5,
"imported_total": 0,
"employees_imported": 0,
"companions_imported": 0,
"invalid_records": [
{
"record": {
"GUID": 1,
"LastName": "Yoko",
"FirstName": "Ono",
"BirthDay": "18.32.1933",
"Sex": "F",
"EmployeeID": 884220062,
"IsEmployee": 0,
"CategoryCode": "1",
"LastNameEng": "Yoko",
"FirstNameEng": "Ono"
},
"error": "Invalid date 18.32.1933, the format is d.m.Y"
},
{
"record": {
"GUID": 2,
"LastName": "McCartney",
"FirstName": "Paul",
"BirthDay": "18.06.1942",
"Sex": "M",
"IsEmployee": 0,
"CategoryCode": "1",
"LastNameEng": "McCartney",
"FirstNameEng": "Paul",
"Email": "pmc@beatles.com"
},
"error": "No GUID field found: EmployeeID"
}
]
}
```

Также вместо JSON можно передать XLS файл (см. Ручной импорт)

Белый список адресов серверов, отправляющих данные сотрудников и Bearer Token авторизации предоставляется Технической поддержкой.

{| class="wikitable" style="margin:auto"
|+ Caption text
|-
! Наименование параметра !! Назначение !! Тип данных !! Комментарий
|-
| GUID || Уникальный идентификатор пользователя системы || Строка || идентификатор присваиваемый в сторонней системе
|-
| LastName || Фамилия на родном языке || Строка || не более 30 символов
|-
| FirstName || Отчество на родном языке, при наличии || Строка || не более 30 символов
|-
| Email || Email || Строка || соответствует формату email
|-
| LastNameEng || Фамилия || Строка || Латиница, не более 30 символов, написание должно совпадать с написанием в загранпаспорте
|-
| FirstNameEng || Имя || Строка || Латиница, не более 30 символов, написание должно совпадать с написанием в загранпаспорте
|-
| MiddleNameEng || Отчество, при наличии || Строка || Латиница, не более 30 символов, написание должно совпадать с написанием в загранпаспорте
|-
| BirthDay || Дата рождения || Дата || В формате ДД.ММ.ГГГГ
|-
| Sex || Пол || Символ || Значения поля: «M», «F»
|-
| DateOfEmployment || Дата трудоустройства || Дата || В формате ДД.ММ.ГГГГ Для родственников сотрудника указывается такое же значение, как и для сотрудника
|-
| EmployeeID || Табельный номер || Строка || Строка не более 10 символов/ Для попутчиков сотрудника указывается такое же значение, как и для сотрудника.
|-
| IsEmployee || Признак сотрудник (1) или попутчик (0) || Логический || Битовое (0,1) непустое поле
|-
| CategoryCode || Категория сотрудника || Целое число || Число от 0 до 9. Чем он меньше, тем более приоритетный сотрудник.
|-

|}

== Ручной импорт ==

Менеджер может в Панели управления (Настройки системы → Интеграция → Airline Staff ID, по адресу /settings__airline_staff_id_employee_import) загрузить XLS файл с данными сотрудников.

Пример файла:

Система не удаляет, но блокирует учетные записи сотрудников, удаленных из списка сотрудников.

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

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

= Регистрация =

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

При первоначальном входе в систему сотрудник должен перейти на форму регистрации по кнопку в правом верхнем углу, ввести поля для проверки данных. Email является обязательным полем.
Система проверяет, что есть такой сотрудник в списке и что все поля совпадают с имеющимися в системе, то отправляет на почту ссылку для входа. При первом входе сотруднику необходимо будет сменить пароль. Логином становится email. После этого пользователь может войти в систему с новым паролем.

[[Файл:Вебскай Коллеги Форма регистрации1.png]]

При создании пароля пользователем, к паролю предъявляются требования, установленные для пользователей системы Nemo.Travel. Частота смены пароля не регламентируется.

= Покупка билета =

Сотруднику после авторизации доступна покупка авиабилетов.
Поиск осуществляется в соответствии с настройками реквизитов среди рейсов на подсадку и рейсов со свободными местами. В интерфейсе рейсы на подсадку маркируются рамкой и указывается предполагаемая очередь на подсадку.

На странице ввода пассажирских данных еще раз выводится очередь на подсадку

[[Файл:Вебскай Коллеги Очередь на подсадку.png]]

На странице бронирования пользователь может выбрать только заранее добавленных в систему пассажиров — себя, либо своих попутчиков. При попытке изменить данные он получит ошибку.

[[Файл:Вебскай Коллеги Выбор пассажира.png]]

== Просмотр бронирований ==

Пользователь в Личном кабинете может видеть все свои бронирования, как на себя, так и на попутчиков.

[[Файл:Вебскай Коллеги Просмотр бронирований.png]]

== Просмотр попутчиков ==

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

[[Файл:Вебскай Коллеги Просмотр попутчиков.png]]

== Алгоритм определения места в очереди на подсадку ==

Рейс идентифицируется по оперирующему перевозчику, номеру рейса и дате рейса.
Для определения места Пассажира в очереди на посадку при бронировании билета без места, система учитывает в порядки убывания значимости:

- принадлежность сотрудника к авиакомпании, выполняющей перевозку‎ 
- класс бронирования (бизнес идёт первым)‎ 
- код приоритета обслуживания (чем меньше – тем выше в очереди.) Регулируется со стороны авиакомпании и передается в списке сотрудников.‎ 
- дата трудоустройства (чем больше стаж, тем выше приоритет)‎ 
- дата и время бронирования (кто раньше завершил бронирование – тот идёт первым)‎

@@ Строка 13: / Строка 13: @@
 - Контролировать квоты на продажу и выписку билетов<br />
 - Управлять списком клиентов для доступа к порталу<br />
-- Производить дозагрузку авиарейсов путем предоставления сотрудникам авиакомпаний возможности приобретения билетов по льготным тарифам, как с подтвержденным местом, так и без подтвержденного места;
+- Производить дозагрузку авиарейсов путем предоставления сотрудникам авиакомпаний возможности приобретения билетов по льготным тарифам, как с подтвержденным местом, так и без подтвержденного места<br />
 - Приобретать льготные авиабилеты (ID60, ID 90 и др.)<br />
-- Сотруднику при бронировании перелета выбрать пассажира, ограничив выбор списком из системы '''Вебскай Коллеги»<br />
+- Сотруднику при бронировании перелета выбрать пассажира, ограничив выбор списком из системы '''Вебскай Коллеги'''<br />
 = Порядок работы =
@@ Строка 26: / Строка 26: @@
 = Важно =
-- При поиске билетов в поисковой выдаче помимо обычных коммерческих билетов будет присутствовать выдача рейсов по специальным (дисконтированным) тарифам, а также тарифы без гарантированного предоставления мест (на подсадку). Купив такой билет, пассажир приезжает в аэропорт, где при наличии свободных мест в самолете и с учетом его очереди на подсадку он допускается к полету;
+- При поиске билетов в поисковой выдаче помимо обычных коммерческих билетов будет присутствовать выдача рейсов по специальным (дисконтированным) тарифам, а также тарифы без гарантированного предоставления мест (на подсадку). Купив такой билет, пассажир приезжает в аэропорт, где при наличии свободных мест в самолете и с учетом его очереди на подсадку он допускается к полету<br />
-- Возврат билета производит авиакомпания самостоятельно согласно своему регламенту;
+- Возврат билета производит авиакомпания самостоятельно согласно своему регламенту<br />
-- Путем регулярного импорта формируется и поддерживается в актуальном виде список пользователей, которые имеют доступ к бронированию без места и билетов по специальному тарифу для сотрудников группы компаний. В список также вносится список родственников, на имя которых пользователь может забронировать билеты. В систему загружается список сотрудников целиком;
+- Путем регулярного импорта формируется и поддерживается в актуальном виде список пользователей, которые имеют доступ к бронированию без места и билетов по специальному тарифу для сотрудников группы компаний. В список также вносится список родственников, на имя которых пользователь может забронировать билеты. В систему загружается список сотрудников целиком<br />
-- Если требуется удалить сотрудника, то в новом списке сотрудников не должно быть данных этого сотрудника.
+- Если требуется удалить сотрудника, то в новом списке сотрудников не должно быть данных этого сотрудника<br />
 - Для импорта списка сотрудников в автоматизированном режиме система авиакомпании отправляет запрос, содержащий данные сотрудников в формате JSON<br />

← Предыдущая		Версия 07:56, 20 июля 2023
Строка 250:		Строка 250:

	Пример файла:		Пример файла:
		+	[[Файл:Airline Staff.png]]

	Система не удаляет, но блокирует учетные записи сотрудников, удаленных из списка сотрудников.		Система не удаляет, но блокирует учетные записи сотрудников, удаленных из списка сотрудников.

@@ Строка 1: / Строка 1: @@
-= О модуле =
+= Общая информация =
-Модуль '''Вебскай Коллеги''' системы позволяет производить дозагрузку авиарейсов путем предоставления сотрудникам авиакомпаний возможности приобретения билетов по льготным тарифам, как с подтвержденным местом, так и без подтвержденного места. Конечные пользователи Системы - сотрудники авиакомпаний и их родственники (далее попутчики).
+'''Вебскай Коллеги''' — решение для автоматизированного оформления авиабилетов, как для сотрудников авиакомпании и членов их семей, так и для клиентов, имеющих доступ к специальным или привилегированным тарифам.
-Возможность приобретения льготных авиабилетов обычно является частью мотивационного пакета сотрудников авиакомпаний.
+Решение представляет собой закрытый портал, на котором пользователи авторизуются и далее, в соответствии с назначенными им правами, получают доступ к закрытым тарифам авиакомпании.
-Функционал выполняется в виде подключаемого модуля Nemo.Travel. В панели управления для него присутствуют дополнительные настройки.
+Решение подключается к ресурсам авиакомпании по выделенному Client ID.
-= Принцип работы =
+= Возможности =
-В систему загружается список сотрудников и аффилированных с ними лиц.
+Система позволяет:
-Сотрудник может зарегистрироваться в системе самостоятельно, правильно указав свои данные.
+- Контролировать квоты на продажу и выписку билетов<br />
-Перейдя по ссылке из почты, сотрудник обязан установить пароль учетной записи.
+= Порядок работы =
-В своем профиле он может увидеть данные своих попутчиков.
+- В систему загружается список сотрудников и аффилированных с ними лиц<br />
-При поиске билетов в поисковой выдаче помимо обычных “коммерческих” билетов будет присутствовать выдача рейсов по специальным (дисконтированным) тарифам, а также тарифы без гарантированного предоставления мест (на подсадку). Купив такой билет человек приезжает в аэропорт, где при наличии свободных мест в самолете и с учетом его очереди на подсадку он допускается или не допускается к полету. Возврат билета производит авиакомпания самостоятельно согласно своему регламенту.
+= Важно =
-При бронировании билета сотрудник может выбрать только из загруженного в систему '''Вебскай Коллеги''' списка пассажиров.
+- При поиске билетов в поисковой выдаче помимо обычных коммерческих билетов будет присутствовать выдача рейсов по специальным (дисконтированным) тарифам, а также тарифы без гарантированного предоставления мест (на подсадку). Купив такой билет, пассажир приезжает в аэропорт, где при наличии свободных мест в самолете и с учетом его очереди на подсадку он допускается к полету;
 = Конфигурация =