Skillline.ETour

Представляем вашему вниманию Skillline.ETour - автоматизированное решение для передачи данных из вашей системы в сервис ГИС "Электронная путевка". Наше решение безопасно в использовании, потому что не хранит и не обрабатывает данные, способно в автоматическом режиме передавать данные, поддерживать в актуальном состоянии статусы путевок, существенно сократить временные и финансовые расходы на передачу информации в ГИС "Электронная путевка", не требует каких-либо дополнительных сервисов и систем для работы. И вам будет достаточно аттестовать только 1 АРМ.

Перечень справочных материалов

Аэропорты Скачать
Авиакомпании Скачать
Города Скачать
Страны Скачать
Типы идентификационных документов Скачать
Железнодорожные компании Скачать
Типы услуг Скачать
Типы ваучеров Скачать
Типы ошибок Скачать
Все справочники Скачать

Аутентификация запросов не производится.
Передача запросов происходит посредством метода POST по адресу http://{HOST}/voucher/create

Пример кода запроса


curl -X 'POST \
'http://{HOST}/voucher/create' \
-H 'accept: application/json'

Ответ сервиса при успешном сохранении заявки:

Пример ошибки заполнения:

Пример тела запроса

Турист
Иное физ.лицо
ИП
Юр.лицо

Данный раздел является интерактивным.

Тело запроса

Данный раздел является интерактивным.

Тело запроса

Данный раздел является интерактивным.

Тело запроса

Данный раздел является интерактивным.

Тело запроса

Информация о турагенте.

number - уникальный идентификационный номер заявки. Обязательное поле. Тип: string. Пример: "0178964641135007".
- Если значение null, то это новая заявка.
- Если указан номер, то обновление существующей заявки.
status - текущий статус заявки в ГИС "Электронная путевка". Обязательное поле. Тип: string. Возможные значения:
- "ACTIVE" - Действует
- "USED" - Исполнен
- "CANCELED" - Аннулирован
Статус "USED" следует передавать в случае, если вы отправляете в систему ваучер, статус которого уже является "Исполнен", например если вы вносите путёвку задним числом или аннулировали старую путёвку (с истёкшим сроком путешествия), но затем вам понадобилось вернуть её в реестр, тогда она отправляется со статусом "USED". Действующим путёвкам статус "Исполнен" система выставляет автоматически после наступления даты окончания путёвки.
tourAgent - ИНН турагента. Обязательное поле. Тип: string. Пример: "5947015660".
voucherType - тип путевки. Тип: string. Пример: "cruise".
travelerCount - поле, в котором фиксируется общее количество участвующих в поездке заказчиков. Тип: string. Пример: 4.
isDev - параметр определяющий адресование для передачи данных в ГИС. Тип: boolean. Возможные значения: true/false. Здесь true означает подключение и передачу данных на демонстрационный стенд(dev - стенд), false - подключение и передача данных в продуктивный стенд. Если данный параметр будет не заполнен, то подключение и передача данных будет осуществляться на продуктивный стенд.

Информация о заказчике:

order - блок информации о заказе.
- contractNumber - уникальный идентификационный номер договора. Тип: integer. Пример: "00967932".
- contractDate - дата заключения договора. Тип: date. Пример: "2024-05-20".
- showCosts - отображение стоимости путевки. Тип: boolean. Возможные значения: true/false.
- cost - стоимость путевки. Тип: integer. Пример: "600000".
- customer - блок информации о заказчике.
  - authorities - постоянное значение ровняется null.
  - individualCustomer - блок информации о заказчике. Содержит поля:
    - name - название компании. Обязательное поле. Тип: string. Пример: "ООО Тестовая компания".
    - lastName - фамилия заказчика. Обязательное поле. Тип: string. Пример: "Камнев".
    - firstName - имя заказчика. Обязательное поле. Тип: string. Пример: "Петр".
    - patronymic - отчество заказчика. Тип: string. Пример: "Петрович".
    - documentType - код документа. Обязательное поле. Тип: string. Пример: "RU01001".
    - documentSeries - уникальный серийный документа заявки. Обязательное поле. Тип: string. Пример: "763264351".
    - country - код страны. Обязательное поле. Тип: string. Пример: "RU".
    - phoneNumber - номер телефона заказчика. Тип: string. Пример: "+79991111111".
    - email - адрес электронной почты заказчика. Тип: string. Пример: "ivan@example.com".
    - address - адрес заказчика. Обязательное поле. Тип: string. Пример: "РОССИЯ, Москва, ул. Дружинная, д.15, кв.12".
    - inn - ИНН заказчика. Обязательное поле. Тип: string. Пример: "123123123123".
    - headLastName - фамилия директора или представителя организации. Тип: string. Пример: "Дмитров".
    - headFirstName - имя директора или представителя организации. Тип: string. Пример: "Петр".
    - headPatronymic - отчество директора или представителя организации. Тип: string. Пример: "Иванович".

Информация о туристах, на которых оформляется путевка

travelers - список заказчиков, содержащий объекты с полями:
- lastName - фамилия туриста. Тип: string. Пример: "Иванов".
- firstName - имя туриста. Тип: string. Пример: "Иван".
- patronymic - отчество туриста. Тип: string. Пример: "Иванович".
- documentType - код документа. Тип: string. Пример: "RU01001".
- documentSeries - идентификационный номер документа. Тип: string. Пример: "2329345623".
- phoneNumber - номер телефона туриста. Значение поля - уникальное. Тип: string. Пример: "+79992222222".
- email - адрес электронной почты туриста. Значение поля - уникальное. Тип: string. Пример: "petr@example.com".
- isCustomer - является ли турист покупателем, оформившим путевку. Обязательное поле. Всегда false, если указан иной турист. Тип: boolean. Возможные значения: true/false.
- birthday - дата рождения туриста. Тип: string. Пример: "1981-01-15".
- country - кодовое обозначение страны. Тип: string. Пример: "RU".
- travelerId - уникальный идентификатор туриста. Значение поля - случайное, уникальное. Тип: string. Пример: "298813715763".

Информация о периоде поездки

travelPeriods - список периодов поездки, содержащий объекты с полями:
- periodId - уникальный идентификатор периода поездки. Значение поля - случайное, уникальное значение uuid v4*. Тип: string. Пример: "f110aba6-bd2a-4930-9b99-a3c4e7b153b5".
- startDate - дата начала поездки. Тип: string. Пример: "2024-07-01".
- endDate - дата окончания поездки. Тип: string. Пример: "2024-07-15".
- travelerIds - список идентификаторов заказчиков, участвующих поездке. Тип: array из string.
  - 298813715763 - идентификатор заказчика.
  - 565691173356

Информация об услугах

tripServices - блок информации об услугах, содержащий объекты с полями:
- accommodationTourismServices - блок информации о проживании:
  - serviceId - уникальный идентификатор услуги. Значение поля - случайное, уникальное значение uuid v4*. Тип: string. Пример: "e2f4084d-7e9d-4fa4-a749-207a3d9aa807".
  - accommodationCountry - кодовое обозначение страны оказания услуги. Тип: string. Пример: "RU".
  - accommodationCityName: "Москва" - город оказания услуги. Тип: string. Пример: "Москва".
  - accommodationRegionRF - кодовый идентификатор региона/места оказания услуги. Тип: string. Пример: "77".
  - hotelName - наименование отеля/гостиницы. Тип: string. Пример: "Редиссон".
  - hotelCategory - обозначение категории отеля по 5-звездочной международной системе оценки качества. Тип: string. Пример: "5".
  - otherTerms - Прочие условия. Тип: string. Пример: " ".
  - checkInDate - дата заезда в отель. Тип: string. Пример: "2024-07-29".
  - checkOutDate - дата выезда из отеля. Тип: string. Пример: "2024-07-30".
  - travelerPositions - состав участников поездки.
    - travelerIds - список идентификаторов заказчиков. Тип: array из string.
      - 298813715763 - идентификатор заказчика.
      - 323557501286
- airTransportationTourismServices - блок информации об авиаперелетах:
  - serviceId - уникальный идентификатор перелета. Значение поля - случайное, уникальное значение uuid v4*. Тип: string. Пример: "2a64886e-cbf2-4c5f-acf0-911a4e1f27ac".
  - departureCountry - кодовое обозначение страны вылета. Тип: string. Пример: "EG".
  - departureCity - кодовое обозначение города отправления. Тип: string. Пример: "EGGEI".
  - departureAirport - кодовое обозначение аэропорта отправления. Тип: string. Пример: "ASW".
  - arrivalCountry - кодовое обозначение страны прибытия. Тип: string. Пример: "EG".
  - arrivalCity - кодовое обозначение города прибытия. Тип: string. Пример: "EGGEI".
  - arrivalAirport - кодовое обозначение аэропорта прибытия. Тип: string. Пример: "DBB".
  - departureDate - дата отправления. Тип: string. Пример: "2024-07-28".
  - arrivalDate - дата прибытия. Тип: string. Пример: "2024-07-29".
  - travelerPositions - состав участников поездки.
    - travelerIds - список идентификаторов заказчиков. Тип: array из string.
      - 298813715763 - идентификатор заказчика.
      - 323557501286
- railTransportationTourismServices - блок информации, содержащий данные о поездках заказчиков по железной дороге в рамках путевки:
  - serviceId - уникальный идентификатор перевозки. Значение поля - случайное, уникальное значение uuid v4*. Тип: string. Пример: "2a64886e-cbf2-4c5f-acf0-911a4e1f27ac".
  - departureCity - город отправления. Тип: string. Пример: "Москва".
  - departureStation - станция прибытия. Тип: string. Пример: "Октябрьская".
  - arrivalCity - город прибытия. Тип: string. Пример: "Санкт-Петербург".
  - arrivalStation - станция прибытия. Тип: string. Пример: "Санкт-Петербург-Главный".
  - departureDate - дата отправления. Тип: string. Пример: "2024-07-28".
  - arrivalDate - дата прибытия. Тип: string. Пример: "2024-07-30".
  - travelerPositions - состав участников поездки.
    - travelerIds - список идентификаторов заказчиков. Тип: array из string.
      - 298813715763 - идентификатор заказчика.
      - 323557501286
- otherTransportationTourismServices - блок информации, содержащий данные о прочих транспортных услугах:
  - serviceId - уникальный идентификатор перелета. Значение поля - случайное, уникальное значение uuid v4*. Тип: string. Пример: "2a64886e-cbf2-4c5f-acf0-911a4e1f27ac".
  - arrivalDate - дата прибытия. Тип: string. Пример: "2024-07-30".
  - arrivalPoint - кодовое обозначение города прибытия. Тип: string. Пример: "RUMOW".
  - departureDate - дата отправления. Тип: string. Пример: "2024-07-28".
  - departurePoint - кодовое обозначение города отправления. Тип: string. Пример: "Каир".
  - description - обозначение наименования услуги. Тип: string. Пример: "Круиз".
  - travelerPositions - состав участников поездки.
    - travelerIds - список идентификаторов заказчиков. Тип: array из string.
      - 298813715763 - идентификатор заказчика.
      - 323557501286
- otherTourismServices - список прочих услуг:
  - serviceId - уникальный идентификатор услуги. Значение поля - случайное, уникальное значение uuid v4*. Тип: string. Пример: "1802a164-f560-4819-9e0e-7db1b294c1dc".
  - tourismServiceType - обозначение типа услуги. Тип: string. Пример: "excursion".
  - description - обозначение наименования услуги. Тип: string. Пример: "1 день до круиза с проживанием в отеле Каира. Двухместный номер, завтрак + трансфер".
  - travelerPositions - состав участников поездки.
    - travelerIds - список идентификаторов заказчиков. Тип: array из string.
      - 298813715763 - идентификатор заказчика.
      - 323557501286

*Uuid является уникальным идентификатором туриста/услуги внутри одной путёвки. Как его генерировать и в каком он будет формате устанавливаете вы. Т.е. в вашем реестре путёвок могут быть путёвки с одинаковыми uuid, но внутри одной путёвки (одного ваучера) такого быть не может, система просто выдаст вам ошибку при отправке ваучера. Стоит ли его сохранять решать вам, но на текущий момент API ГИС Электронная Путёвка не предусматривает методов для просмотра существующих ваучеров, поэтому для корректного редактирования туристов/услуг мы бы рекомендовали сохранять их значения для каждой путёвки.