curl -X 'POST \
'http://{HOST}/voucher/create' \
-H 'accept: application/json'
Skillline.ETour
Представляем вашему вниманию Skillline.ETour - автоматизированное решение для передачи данных из вашей системы в сервис ГИС "Электронная путевка". Наше решение безопасно в использовании, потому что не хранит и не обрабатывает данные, способно в автоматическом режиме передавать данные, поддерживать в актуальном состоянии статусы путевок, существенно сократить временные и финансовые расходы на передачу информации в ГИС "Электронная путевка", не требует каких-либо дополнительных сервисов и систем для работы. И вам будет достаточно аттестовать только 1 АРМ.
Аутентификация запросов не производится.
Передача запросов происходит посредством метода POST по адресу
http://{HOST}/voucher/create
Пример кода запроса
Ответ сервиса при успешном сохранении заявки:
Пример ошибки заполнения:
Пример тела запроса
- Турист
- Иное физ.лицо
- ИП
- Юр.лицо
Данный раздел является интерактивным.
Тело запроса
Информация о турагенте.
-
number
- уникальный идентификационный номер заявки. Обязательное поле. Тип:string
. Пример:"0178964641135007"
.- Если значение
null
, то это новая заявка. - Если указан номер, то обновление существующей заявки.
- Если значение
-
status
- текущий статус заявки в ГИС "Электронная путевка". Обязательное поле. Тип:string
. Возможные значения:"ACTIVE"
- Действует"USED"
- Исполнен"CANCELED"
- Аннулирован
Статус
"USED"
следует передавать в случае, если вы отправляете в систему ваучер, статус которого уже является "Исполнен", например если вы вносите путёвку задним числом или аннулировали старую путёвку (с истёкшим сроком путешествия), но затем вам понадобилось вернуть её в реестр, тогда она отправляется со статусом"USED"
. Действующим путёвкам статус "Исполнен" система выставляет автоматически после наступления даты окончания путёвки. -
tourAgent
- ИНН турагента. Обязательное поле. Тип:string
. Пример:"5947015660"
.
Eсли путевка продана без участия турагента, то данное поле остается со значением null. Поле также можно заполнить в формате объекта.-
tourAgent
- объект с полями.inn
- ИНН турагента. Обязательное поле. Тип:string
. Пример:"5947015660"
.phoneNumbers
- cписок номеров телефонов. Тип:array
изstring
. Пример:["+798456898", "+79894556526"]
.emails
- cписок адресов электронной почты. Тип:array
изstring
. Пример:["test@test.ru"]
.
-
-
voucherType
- тип путевки. Обязательное поле. Тип:string
. Пример:"cruise"
. При отсутствии типа устанавливаетсяnull
. travelerCount
- поле, в котором фиксируется общее количество участвующих в поездке заказчиков. Обязательное поле. Тип:string
. Пример:4
.development
- заголовок запроса определяющий адресование для передачи данных в ГИС. Тип:boolean
. Возможные значения:true
/false
. Здесьtrue
означает подключение и передачу данных на демонстрационный стенд(dev - стенд),false
- подключение и передача данных в продуктивный стенд. Если данный параметр будет не заполнен, то подключение и передача данных будет осуществляться на продуктивный стенд.
Информация о заказчике:
-
order
- блок информации о заказе. Обязательное поле.-
contractNumber
- уникальный идентификационный номер договора. Тип:integer
. Пример:"00967932"
. Ограничение в 20 символов. -
contractDate
- дата заключения договора. Обязательное поле. Тип:date
. Пример:"2024-05-20"
. -
showCosts
- отображение стоимости путевки. Тип:boolean
. Возможные значения:true
/false
. -
cost
- стоимость путевки. Обязательное поле. Тип:integer
. Пример:"600000"
. -
customer
- блок информации о заказчике. Обязательное поле.-
individualCustomer
- блок информации о заказчике. Содержит поля:-
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"
. Ограничение в 255 символов.
-
-
-
Информация о туристах, на которых оформляется путевка
-
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"
. -
foodConditions
- кодовое обозначение условий питания. Обязательное поле. Тип:string
. Пример:"bb"
. -
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
. Пример:"Каир"
. -
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
- обозначение наименования услуги. Является обязательным полем. при типе услугиother
. Тип:string
. Пример:"1 день до круиза с проживанием в отеле Каира. Двухместный номер, завтрак + трансфер"
. -
travelerPositions
- состав участников поездки. Обязательное поле.-
travelerIds
- список идентификаторов заказчиков. Тип:array
изstring
.-
298813715763
- идентификатор заказчика. -
323557501286
-
-
-
-
*Uuid является уникальным идентификатором туриста/услуги внутри одной путёвки. Как его генерировать и в каком он будет формате устанавливаете вы. Т.е. в вашем реестре путёвок могут быть путёвки с одинаковыми uuid, но внутри одной путёвки (одного ваучера) такого быть не может, система просто выдаст вам ошибку при отправке ваучера. Стоит ли его сохранять решать вам, но на текущий момент API ГИС Электронная Путёвка не предусматривает методов для просмотра существующих ваучеров, поэтому для корректного редактирования туристов/услуг мы бы рекомендовали сохранять их значения для каждой путёвки.