{ "info": { "_postman_id": "c4dd4e23-6857-4f00-a0c5-167b90ab5c98", "name": "Документация по API запросам продукта Skilllne.ETour v2.1", "description": "Подробную информацию о решении Skillline. ETour вы можете найти на нашем сайте - [https://etour.skillline.ru/
](https://doc.etour.skillline.ru/)Документация с интерактивным примером основного запроса и список актуальных (ежедневное обновление в 00:00 UTC +0) справочников - [https://doc.etour.skillline.ru/](https://doc.etour.skillline.ru/)", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id": "34959211", "_collection_link": "https://etourchik.postman.co/workspace/Etourchik-Workspace~1c78157f-7904-41de-ac7e-037c1f01349d/collection/34959211-c4dd4e23-6857-4f00-a0c5-167b90ab5c98?action=share&source=collection_link&creator=34959211" }, "item": [ { "name": "ETour v2.1", "item": [ { "name": "Запрос на создание или обновление путевки (Upsert voucher)", "event": [ { "listen": "test", "script": { "exec": [ "" ], "type": "text/javascript", "packages": {} } } ], "protocolProfileBehavior": { "followRedirects": true, "disableUrlEncoding": false, "disableCookies": false }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "development", "value": "true", "description": "заголовок запроса определяющий адресование для передачи данных в ГИС, true - передача данных на демонстрационный стенд(dev - стенд), false - подключение и передача данных в продуктивный стенд" }, { "key": "custom-timeout", "value": "40000", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": null,\r\n \"status\": \"ACTIVE\",\r\n \"tourAgent\": \"9201007500\",\r\n \"voucherType\": \"cruise\",\r\n \"order\": {\r\n \"customer\": {},\r\n \"contractNumber\": \"00967932\",\r\n \"contractDate\": \"2024-06-06\",\r\n \"showCosts\": true,\r\n \"cost\": 352160\r\n },\r\n \"travelers\": [\r\n {\r\n \"lastName\": \"Al-Shaer\",\r\n \"firstName\": \"Elena \",\r\n \"patronymic\": \"\",\r\n \"documentType\": \"RU01004\",\r\n \"documentSeries\": \"763264351\",\r\n \"phoneNumber\": \"\",\r\n \"email\": \"\",\r\n \"isCustomer\": true,\r\n \"birthday\": \"1975-08-31\",\r\n \"country\": \"RU\",\r\n \"travelerId\": \"550318267568\"\r\n },\r\n {\r\n \"lastName\": \"Bartenev\",\r\n \"firstName\": \"Vladimir\",\r\n \"patronymic\": \"\",\r\n \"documentType\": \"RU01004\",\r\n \"documentSeries\": \"766516916\",\r\n \"phoneNumber\": \"\",\r\n \"email\": \"\",\r\n \"isCustomer\": false,\r\n \"birthday\": \"1968-01-25\",\r\n \"country\": \"RU\",\r\n \"travelerId\": \"565691173356\"\r\n }\r\n ],\r\n \"tripPeriods\": [\r\n {\r\n \"periodId\": \"f9bcf237-e27c-43bb-9dba-560c58b9b70b\",\r\n \"startDate\": \"2024-10-31\",\r\n \"endDate\": \"2024-11-08\",\r\n \"travelerIds\": [\r\n \"550318267568\",\r\n \"565691173356\"\r\n ]\r\n }\r\n ],\r\n \"tripServices\": {\r\n \"accommodationTourismServices\": [\r\n {\r\n \"serviceId\": \"02734922-91b1-433e-8ebf-ab47c3509460\",\r\n \"accommodationCountry\": \"RU\",\r\n \"accommodationRegionRF\": \"01\",\r\n \"accommodationCityName\": \"Москва\",\r\n \"hotelName\": \"Редиссон\",\r\n \"hotelCategory\": \"1\",\r\n \"foodConditions\": \"bb\",\r\n \"otherTerms\": \"\",\r\n \"checkInDate\": \"2024-10-31\",\r\n \"checkOutDate\": \"2024-11-08\",\r\n \"travelerPositions\": {\r\n \"travelerIds\": [\r\n \"550318267568\",\r\n \"565691173356\"\r\n ]\r\n }\r\n }\r\n ],\r\n \"otherTransportationTourismServices\": [\r\n {\r\n \"serviceId\": \"48a8a70f-a945-44a4-ada1-6da1e4bdf397\",\r\n \"arrivalDate\": \"2024-11-08\",\r\n \"arrivalPoint\": \"Каир\",\r\n \"departureDate\": \"2024-10-31\",\r\n \"departurePoint\": \"Каир\",\r\n \"description\": \"Круиз\",\r\n \"travelerPositions\": {\r\n \"travelerIds\": [\r\n \"550318267568\",\r\n \"565691173356\"\r\n ]\r\n }\r\n }\r\n ],\r\n \"airTransportationTourismServices\": [\r\n {\r\n \"serviceId\": \"b56837c4-418c-4962-befd-c6a426b5fd7a\",\r\n \"departureCountry\": \"EG\",\r\n \"departureCity\": \"EGGEI\",\r\n \"departureAirport\": \"ASW\",\r\n \"arrivalCountry\": \"EG\",\r\n \"arrivalCity\": \"EGGEI\",\r\n \"arrivalAirport\": \"DBB\",\r\n \"departureDate\": \"2024-10-31\",\r\n \"arrivalDate\": \"2024-10-31\",\r\n \"travelerPositions\": {\r\n \"travelerIds\": [\r\n \"550318267568\",\r\n \"565691173356\"\r\n ]\r\n }\r\n }\r\n ],\r\n \"railTransportationTourismServices\": [\r\n {\r\n \"serviceId\": \"58bbc003-8644-408a-9463-15f2cbc8dcf4\",\r\n \"departureCity\": \"Москва\",\r\n \"departureStation\": \"Октябрьская\",\r\n \"arrivalCity\": \"Санкт-Петербург\",\r\n \"arrivalStation\": \"Санкт-Петербург-Главный\",\r\n \"departureDate\": \"2024-10-31\",\r\n \"arrivalDate\": \"2024-10-31\",\r\n \"travelerPositions\": {\r\n \"travelerIds\": [\r\n \"550318267568\"\r\n ]\r\n }\r\n }\r\n ],\r\n \"otherTourismServices\": [\r\n {\r\n \"serviceId\": \"f212b676-1d1a-4658-8ae0-2c0e742a74bc\",\r\n \"tourismServiceType\": \"excursion\",\r\n \"description\": \"1 день до круиза с проживанием в отеле Каира. Двухместный номер, завтрак + трансфер\",\r\n \"travelerPositions\": {\r\n \"travelerIds\": [\r\n \"550318267568\",\r\n \"565691173356\"\r\n ]\r\n }\r\n }\r\n ]\r\n },\r\n \"travelerCount\": 2\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{etour_host}}/vouchers/upsert", "host": [ "{{etour_host}}" ], "path": [ "vouchers", "upsert" ] }, "description": "##### Для обновления в поле `number` вставьте номер путевки.\n\nПримеры запросов, в которых тело меняется в зависимости от типа заказчика.\n\n- Tourist - турист\n \n- Other natural person - иное физ. лицо\n \n- IE - ИП\n \n- Legal personality - юр. лицо (ООО/АО/ЗАО и пр.)\n \n\n#### Информация о турагенте.\n\n- `number` - (`string`) уникальный идентификационный номер заявки. Обязательное поле.\n \n - Если значение `null`, то это новая заявка.\n \n - Если указан номер, то обновление существующей заявки. Пример: `\"0178964641135007\"`.\n \n- `status` - (`string`) текущий статус заявки в ГИС \"Электронная путевка\". Обязательное поле. Возможные значения:\n \n - `\"ACTIVE\"` - Действует\n \n - `\"USED\"` - Исполнен\n \n - `\"CANCELED\"` - Аннулирован\n \n\nСтатус `\"USED\"` следует передавать в случае, если вы отправляете в систему ваучер, статус которого уже является \"Исполнен\", например если вы вносите путёвку задним числом или аннулировали старую путёвку (с истёкшим сроком путешествия), но затем вам понадобилось вернуть её в реестр, тогда она отправляется со статусом `\"USED\"`. Действующим путёвкам статус \"Исполнен\" система выставляет автоматически после наступления даты окончания путёвки.\n\n- `tourAgent` - (`string`) ИНН турагента. Обязательное поле. В случае если путевка продана без участия турагента данное поле остается со значением `null`. Пример: `\"5947015660\"`. \n В таком случае номер телефона и адрес электронной почты будут вставляться из реестра, в который вы добавляли данного турагента. Если вы хотите заменить эти данные в запросе, то:\n \n ```\n \"tourAgent\": {\n \"inn\": \"9201007500\",\n \"phoneNumbers\": [\"+798456898\", \"+79894556526\"],\n \"emails\": [\"test@test.ru\"]\n }\n \n ```\n \n где\n \n - `inn` - (`string`) ИНН турагента. Обязательное поле.\n \n - `phoneNumbers` - (`array` из `string`). Список номеров телефонов.\n \n - `emails` - (`array` из `string`). Список адресов электронной почты. \n При отсутствии полей `phoneNumbers` или `emails`, данные вставляются из реестра.\n \n- `voucherType` - (`string`) тип путевки. Обязательное поле. Пример: `\"cruise\"`.\n \n- `travelerCount` - (`string`) поле, в котором фиксируется общее количество участвующих в поездке заказчиков. Обязательное поле. Пример: `4`.\n \n\n#### Информация о туристах, на которых оформляется путевка\n\n- `travelers` - список заказчиков, содержащий объекты с полями:\n \n - `lastName` - (`string`) фамилия туриста. Обязательное поле. Пример: `\"Иванов\"`.\n \n - `firstName` - (`string`) имя туриста. Обязательное поле. Пример: `\"Иван\"`.\n \n - `patronymic` - (`string`) отчество туриста. Пример: `\"Иванович\"`.\n \n - `documentType` - (`string`) код документа. Обязательное поле. Пример: `\"RU01001\"`.\n \n - `documentSeries` - (`string`) идентификационный номер документа. Обязательное поле. Пример: `\"2329345623\"`.\n \n - `phoneNumber` - (`string`) номер телефона туриста. Значение поля - уникальное. Пример: `\"+79992222222\"`.\n \n - `email` - (`string`) адрес электронной почты туриста. Значение поля - уникальное. Пример: `\"petr@example.com\"`.\n \n - `isCustomer` - (`boolean`) является ли турист покупателем, оформившим путевку. Обязательное поле. Всегда false, если указан иной турист. Обязательное поле. Возможные значения: `true`/`false`.\n \n - `birthday` - (`string`) дата рождения туриста. Обязательное поле. Пример: `\"1981-01-15\"`.\n \n - `country` - (`string`) кодовое обозначение страны. Обязательное поле. Пример: `\"RU\"`.\n \n - `travelerId` - (`string`) уникальный идентификатор туриста. Обязательное поле. Значение поля - случайное, уникальное. Пример: `\"298813715763\"`.\n \n\n#### Информация о периоде поездки\n\n- `tripPeriods` - список периодов поездки, содержащий объекты с полями:\n \n - `periodId` - (`string`) уникальный идентификатор периода поездки. Обязательное поле. Значение поля - случайное, уникальное значение uuid v4\\*. Пример: `\"f110aba6-bd2a-4930-9b99-a3c4e7b153b5\"`.\n \n - `startDate` - (`string`) дата начала поездки. Обязательное поле. Пример: `\"2024-07-01\"`.\n \n - `endDate` - (`string`) дата окончания поездки. Обязательное поле. Пример: `\"2024-07-15\"`.\n \n - `travelerIds` - (`array` из `string`) список идентификаторов заказчиков, участвующих в поездке. Обязательное поле.\n \n - `298813715763` - идентификатор заказчика.\n \n - `565691173356`\n \n\n#### Информация об услугах\n\n- `tripServices` - блок информации об услугах, содержащий объекты с полями:\n \n - `accommodationTourismServices` - блок информации о проживании:\n \n - `serviceId` - (`string`) уникальный идентификатор услуги. Обязательное поле. Значение поля - случайное, уникальное значение uuid v4\\*. Пример: `\"e2f4084d-7e9d-4fa4-a749-207a3d9aa807\"`.\n \n - `accommodationCountry` - (`string`) кодовое обозначение страны оказания услуги. Обязательное поле. Пример: `\"RU\"`.\n \n - `accommodationCityName` - (`string`) город оказания услуги. Обязательное поле. Пример: `\"Москва\"`.\n \n - `accommodationRegionRF` - (`string`) кодовый идентификатор региона/места оказания услуги, если страна оказания услуг Россия, иначе `null`. Пример: `\"77\"`.\n \n - `hotelName` - (`string`) наименование отеля/гостиницы. Обязательное поле. Пример: `\"Редиссон\"`.\n \n - `hotelCategory` - (`string`) обозначение категории отеля по 5-звездочной международной системе оценки качества. Пример: `\"5\"`.\n \n - `foodConditions` - (`string`) кодовое обозначение условий питания. Обязательное поле. Пример: `\"ai\"`.\n \n - `otherTerms` - (`string`) прочие условия. Пример: `\" \"`.\n \n - `checkInDate` - (`string`) дата заезда в отель. Обязательное поле. Пример: `\"2024-07-29\"`.\n \n - `checkOutDate` - (`string`) дата выезда из отеля. Обязательное поле. Пример: `\"2024-07-30\"`.\n \n - `travelerPositions` - состав участников поездки. Обязательное поле.\n \n - `travelerIds` - (`array` из `string`) список идентификаторов заказчиков.\n \n - `298813715763` - идентификатор заказчика.\n \n - `323557501286`\n \n - `airTransportationTourismServices` - блок информации об авиаперелетах:\n \n - `serviceId` - (`string`) уникальный идентификатор перелета. Обязательное поле. Значение поля - случайное, уникальное значение uuid v4\\*. Пример: `\"2a64886e-cbf2-4c5f-acf0-911a4e1f27ac\"`.\n \n - `departureCountry` - (`string`) кодовое обозначение страны вылета. Обязательное поле. Пример: `\"EG\"`.\n \n - `departureCity` - (`string`) кодовое обозначение города отправления. Обязательное поле. Пример: `\"EGGEI\"`.\n \n - `departureAirport` - (`string`) кодовое обозначение аэропорта отправления. Пример: `\"ASW\"`.\n \n - `arrivalCountry` - (`string`) кодовое обозначение страны прибытия. Обязательное поле. Пример: `\"EG\"`.\n \n - `arrivalCity` - (`string`) кодовое обозначение города прибытия. Обязательное поле. Пример: `\"EGGEI\"`.\n \n - `arrivalAirport` - (`string`) кодовое обозначение аэропорта прибытия. Обязательное поле. Пример: `\"DBB\"`.\n \n - `departureDate` - (`string`) дата отправления. Обязательное поле. Пример: `\"2024-07-28\"`.\n \n - `arrivalDate` - (`string`) дата прибытия. Обязательное поле. Пример: `\"2024-07-29\"`.\n \n - `travelerPositions` - состав участников поездки. Обязательное поле.\n \n - `travelerIds` - (`array` из `string`) список идентификаторов заказчиков.\n \n - `298813715763` - идентификатор заказчика.\n \n - `323557501286`\n \n - `railTransportationTourismServices` - блок информации о ж/д перевозках:\n \n - `serviceId` - (`string`) уникальный идентификатор перевозки. Обязательное поле. Значение поля - случайное, уникальное значение uuid v4\\*. Пример: `\"58bbc003-8644-408a-9463-15f2cbc8dcf4\"`.\n \n - `departureCity` - (`string`) город отправления. Обязательное поле. Пример: `\"Москва\"`.\n \n - `departureStation` - (`string`) станция отправления. Обязательное поле. Пример: `\"Октябрьская\"`.\n \n - `arrivalCity` - (`string`) город прибытия. Обязательное поле. Пример: `\"Санкт-Петербург\"`.\n \n - `arrivalStation` - (`string`) станция прибытия. Обязательное поле. Пример: `\"Санкт-Петербург-Главный\"`.\n \n - `departureDate` - (`string`) дата отправления. Обязательное поле. Пример: `\"2024-07-28\"`.\n \n - `arrivalDate` - (`string`) дата прибытия. Обязательное поле. Пример: `\"2024-07-29\"`.\n \n - `travelerPositions` - состав участников поездки. Обязательное поле.\n \n - `travelerIds` - (`array` из `string`) список идентификаторов заказчиков.\n \n - `298813715763` - идентификатор заказчика.\n \n - `323557501286`\n \n - `otherTransportationTourismServices` - блок информации, содержащий данные о прочих транспортных услугах:\n \n - `serviceId` - (`string`) уникальный идентификатор услуги. Обязательное поле. Значение поля - случайное, уникальное значение uuid v4\\*. Пример: `\"2a64886e-cbf2-4c5f-acf0-911a4e1f27ac\"`.\n \n - `arrivalDate` - (`string`) дата прибытия. Обязательное поле. Пример: `\"2024-07-30\"`.\n \n - `arrivalPoint` - (`string`) город прибытия. Обязательное поле. Пример: `\"Каир\"`.\n \n - `departureDate` - (`string`) дата отправления. Обязательное поле. Пример: `\"2024-07-28\"`.\n \n - `departurePoint` - (`string`) города отправления. Обязательное поле. Пример: `\"Каир\"`.\n \n - `description` - (`string`) обозначение наименования услуги. Пример: `\"Круиз\"`.\n \n - `travelerPositions` - состав участников поездки. Обязательное поле.\n \n - `travelerIds` - (`array` из `string`) список идентификаторов заказчиков.\n \n - `298813715763` - идентификатор заказчика.\n \n - `323557501286`\n \n - `otherTourismServices` - список прочих услуг:\n \n - `serviceId` - (`string`) уникальный идентификатор услуги. Обязательное поле. Значение поля - случайное, уникальное значение uuid v4\\*. Пример: `\"1802a164-f560-4819-9e0e-7db1b294c1dc\"`.\n \n - `tourismServiceType` - (`string`) обозначение типа услуги. Обязательное поле. Пример: `\"excursion\"`.\n \n - `description` - (`string`) обозначение наименования услуги. Обязательное поле, если тип услуги `other`. Пример: `\"1 день до круиза с проживанием в отеле Каира. Двухместный номер, завтрак + трансфер\"`.\n \n - `travelerPositions` - состав участников поездки. Обязательное поле.\n \n - `travelerIds` - (`array` из `string`) список идентификаторов заказчиков.\n \n - `298813715763` - идентификатор заказчика.\n \n - `323557501286`\n \n\n#### Информация о заказчике\n\n##### Турист\n\n- `order` - блок информации о заказе. Обязательное поле.\n \n - `contractNumber` - (`integer`) уникальный идентификационный номер договора. Пример: `\"00967932\"`. Ограничение в 20 символов.\n \n - `contractDate` - (`date`) дата заключения договора. Обязательное поле. Пример: `\"2024-05-20\"`.\n \n - `showCosts` - (`boolean`) отображение стоимости путевки. Возможные значения: `true`/`false`.\n \n - `cost` - (`integer`) стоимость путевки. Обязательное поле. Пример: `\"600000\"`.\n \n - `customer` - блок информации о заказчике. Обязательное поле.\n \n\n##### Иное физ. лицо\n\n- `order` - блок информации о заказе.\n \n - `contractNumber` - (`integer`) уникальный идентификационный номер договора. Пример: `\"00967932\"`. Ограничение в 20 символов.\n \n - `contractDate` - (`date`) дата заключения договора. Обязательное поле. Пример: `\"2024-05-20\"`.\n \n - `showCosts` - (`boolean`) отображение стоимости путевки. Возможные значения: `true`/`false`.\n \n - `cost` - (`integer`) стоимость путевки. Обязательное поле. Пример: `\"600000\"`.\n \n - `customer` - блок информации о заказчике. Обязательное поле.\n \n - `individualCustomer` - блок информации о заказчике. Содержит поля:\n \n - `lastName` - (`string`) фамилия заказчика. Обязательное поле. Пример: `\"Камнев\"`.\n \n - `firstName` - (`string`) имя заказчика. Обязательное поле. Пример: `\"Петр\"`.\n \n - `patronymic` - (`string`) отчество заказчика. Пример: `\"Петрович\"`.\n \n - `documentType` - (`string`) код документа. Обязательное поле. Пример: `\"RU01001\"`.\n \n - `documentSeries` - (`string`) уникальный серийный номер документа заявки. Обязательное поле. Пример: `\"763264351\"`.\n \n - `country` - (`string`) код страны. Обязательное поле. Пример: `\"RU\"`.\n \n - `phoneNumber` - (`string`) номер телефона заказчика. Пример: `\"+79991111111\"`.\n \n - `email` - (`string`) адрес электронной почты заказчика. Пример: `\"ivan@example.com\"`.\n \n - `address` - (`string`) адрес заказчика. Обязательное поле. Пример: `\"РОССИЯ, Москва, ул. Дружинная, д.15, кв.12\"`. Ограничение в 255 символов.\n \n\n##### ИП\n\n- `order` - блок информации о заказе.\n \n - `contractNumber` - (`integer`) уникальный идентификационный номер договора. Пример: `\"00967932\"`. Ограничение в 20 символов.\n \n - `contractDate` - (`date`) дата заключения договора. Обязательное поле. Пример: `\"2024-05-20\"`.\n \n - `showCosts` - (`boolean`) отображение стоимости путевки. Возможные значения: `true`/`false`.\n \n - `cost` - (`integer`) стоимость путевки. Обязательное поле. Пример: `\"600000\"`.\n \n - `customer` - блок информации о заказчике. Обязательное поле.\n \n - `soleProprietorCustomer` - блок информации о заказчике. Содержит поля:\n \n - `lastName` - (`string`) фамилия заказчика. Обязательное поле. Пример: `\"Камнев\"`.\n \n - `firstName` - (`string`) имя заказчика. Обязательное поле. Пример: `\"Петр\"`.\n \n - `patronymic` - (`string`) отчество заказчика. Пример: `\"Петрович\"`.\n \n - `documentType` - (`string`) код документа. Обязательное поле. Пример: `\"RU01001\"`.\n \n - `documentSeries` - (`string`) уникальный серийный номер документа заявки. Обязательное поле. Пример: `\"763264351\"`.\n \n - `country` - (`string`) код страны. Обязательное поле. Пример: `\"RU\"`.\n \n - `phoneNumber` - (`string`) номер телефона заказчика. Пример: `\"+79991111111\"`.\n \n - `email` - (`string`) адрес электронной почты заказчика. Пример: `\"ivan@example.com\"`.\n \n - `address` - (`string`) адрес заказчика. Обязательное поле. Пример: `\"РОССИЯ, Москва, ул. Дружинная, д.15, кв.12\"`. Ограничение в 255 символов.\n \n - `inn` - (`string`) ИНН заказчика. Обязательное поле. Пример: `\"123123123123\"`.\n \n\n##### Юр. лицо\n\n- `order` - блок информации о заказе.\n \n - `contractNumber` - (`integer`) уникальный идентификационный номер договора. Пример: `\"00967932\"`. Ограничение в 20 символов.\n \n - `contractDate` - (`date`) дата заключения договора. Обязательное поле. Пример: `\"2024-05-20\"`.\n \n - `showCosts` - (`boolean`) отображение стоимости путевки. Возможные значения: `true`/`false`.\n \n - `cost` - (`integer`) стоимость путевки. Обязательное поле. Пример: `\"600000\"`.\n \n - `customer` - блок информации о заказчике. Обязательное поле.\n \n - `companyCustomer` - блок информации о заказчике. Содержит поля:\n \n - `name` - (`string`) название компании. Обязательное поле. Пример: `\"ООО Тестовая компания\"`.\n \n - `phoneNumber` - (`string`) номер телефона заказчика. Пример: `\"+79991111111\"`.\n \n - `email` - (`string`) адрес электронной почты заказчика. Пример: `\"ivan@example.com\"`.\n \n - `address` - (`string`) адрес заказчика. Обязательное поле. Пример: `\"РОССИЯ, Москва, ул. Дружинная, д.15, кв.12\"`. Ограничение в 255 символов.\n \n - `inn` - (`string`) ИНН заказчика. Обязательное поле. Пример: `\"123123123123\"`.\n \n\n\\*Uuid является уникальным идентификатором туриста/услуги внутри одной путёвки. Как его генерировать и в каком он будет формате устанавливаете вы. Т.е. в вашем реестре путёвок могут быть путёвки с одинаковыми uuid, но **внутри одной путёвки (одного ваучера) такого быть не может**, система просто выдаст вам ошибку при отправке ваучера. Стоит ли его сохранять решать вам, но на текущий момент API ГИС Электронная Путёвка не предусматривает методов для просмотра существующих ваучеров, поэтому для корректного редактирования туристов/услуг мы бы рекомендовали сохранять их значения для каждой путёвки." }, "response": [ { "name": "Tourist", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "development", "value": "true", "description": "заголовок запроса определяющий адресование для передачи данных в ГИС, true - передача данных на демонстрационный стенд(dev - стенд), false - подключение и передача данных в продуктивный стенд" } ], "body": { "mode": "raw", "raw": "{\n \"number\": null,\n \"status\": \"ACTIVE\",\n \"tourAgent\": \"9201007500\",\n \"voucherType\": \"cruise\",\n \"order\": {\n \"customer\": {},\n \"contractNumber\": \"00967932\",\n \"contractDate\": \"2024-06-06\",\n \"showCosts\": true,\n \"cost\": 352160\n },\n \"travelers\": [\n {\n \"lastName\": \"Al-Shaer\",\n \"firstName\": \"Elena \",\n \"patronymic\": \"\",\n \"documentType\": \"RU01004\",\n \"documentSeries\": \"763264351\",\n \"phoneNumber\": \"\",\n \"email\": \"\",\n \"isCustomer\": true,\n \"birthday\": \"1975-08-31\",\n \"country\": \"RU\",\n \"travelerId\": \"550318267568\"\n },\n {\n \"lastName\": \"Bartenev\",\n \"firstName\": \"Vladimir\",\n \"patronymic\": \"\",\n \"documentType\": \"RU01004\",\n \"documentSeries\": \"766516916\",\n \"phoneNumber\": \"\",\n \"email\": \"\",\n \"isCustomer\": false,\n \"birthday\": \"1968-01-25\",\n \"country\": \"RU\",\n \"travelerId\": \"565691173356\"\n }\n ],\n \"tripPeriods\": [\n {\n \"periodId\": \"f9bcf237-e27c-43bb-9dba-560c58b9b70b\",\n \"startDate\": \"2024-10-31\",\n \"endDate\": \"2024-11-08\",\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n ],\n \"tripServices\": {\n \"accommodationTourismServices\": [\n {\n \"serviceId\": \"02734922-91b1-433e-8ebf-ab47c3509460\",\n \"accommodationCountry\": \"RU\",\n \"accommodationRegionRF\": \"01\",\n \"accommodationCityName\": \"Москва\",\n \"hotelName\": \"Редиссон\",\n \"hotelCategory\": \"1\",\n \"foodConditions\": \"bb\",\n \"otherTerms\": \"\",\n \"checkInDate\": \"2024-10-31\",\n \"checkOutDate\": \"2024-11-08\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ],\n \"otherTransportationTourismServices\": [\n {\n \"serviceId\": \"48a8a70f-a945-44a4-ada1-6da1e4bdf397\",\n \"arrivalDate\": \"2024-11-08\",\n \"arrivalPoint\": \"Каир\",\n \"departureDate\": \"2024-10-31\",\n \"departurePoint\": \"Каир\",\n \"description\": \"Круиз\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ],\n \"airTransportationTourismServices\": [\n {\n \"serviceId\": \"b56837c4-418c-4962-befd-c6a426b5fd7a\",\n \"departureCountry\": \"EG\",\n \"departureCity\": \"EGGEI\",\n \"departureAirport\": \"ASW\",\n \"arrivalCountry\": \"EG\",\n \"arrivalCity\": \"EGGEI\",\n \"arrivalAirport\": \"DBB\",\n \"departureDate\": \"2024-10-31\",\n \"arrivalDate\": \"2024-10-31\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ],\n \"railTransportationTourismServices\": [\n {\n \"serviceId\": \"58bbc003-8644-408a-9463-15f2cbc8dcf4\",\n \"departureCity\": \"Москва\",\n \"departureStation\": \"Октябрьская\",\n \"arrivalCity\": \"Санкт-Петербург\",\n \"arrivalStation\": \"Санкт-Петербург-Главный\",\n \"departureDate\": \"2024-10-31\",\n \"arrivalDate\": \"2024-10-31\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\"\n ]\n }\n }\n ],\n \"otherTourismServices\": [\n {\n \"serviceId\": \"f212b676-1d1a-4658-8ae0-2c0e742a74bc\",\n \"tourismServiceType\": \"excursion\",\n \"description\": \"1 день до круиза с проживанием в отеле Каира. Двухместный номер, завтрак + трансфер\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ]\n },\n \"travelerCount\": 2\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "https://cvg867f348tgdevh07dhaiodygt2.ru:3001/api/v2/vouchers/upsert", "protocol": "https", "host": [ "cvg867f348tgdevh07dhaiodygt2", "ru" ], "port": "3001", "path": [ "api", "v2", "vouchers", "upsert" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "X-Powered-By", "value": "Express" }, { "key": "Content-Type", "value": "application/json; charset=utf-8" }, { "key": "Content-Length", "value": "304" }, { "key": "ETag", "value": "W/\"130-Pto4xH78405jba4cS4JpyvslEU0\"" }, { "key": "Date", "value": "Tue, 13 Aug 2024 10:32:40 GMT" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Keep-Alive", "value": "timeout=5" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"voucherNumber\": \"0213585875759371\",\n \"customerAuthorizationCode\": \"ЧЖ418228\",\n \"voucherCreatedDateTime\": \"2024-08-13T13:32:40\",\n \"travelers\": [\n {\n \"travelerId\": \"565691173356\",\n \"travelerAuthorizationCode\": \"УЫ130795\"\n },\n {\n \"travelerId\": \"550318267568\",\n \"travelerAuthorizationCode\": \"КЗ981904\"\n }\n ]\n }\n}" }, { "name": "Other natural person", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "development", "value": "true", "description": "заголовок запроса определяющий адресование для передачи данных в ГИС, true - передача данных на демонстрационный стенд(dev - стенд), false - подключение и передача данных в продуктивный стенд" } ], "body": { "mode": "raw", "raw": "{\n \"number\": null,\n \"status\": \"ACTIVE\",\n \"tourAgent\": \"9201007500\",\n \"voucherType\": \"cruise\",\n \"order\": {\n \"customer\": {\n \"individualCustomer\": {\n \"lastName\": \"Камнев\",\n \"firstName\": \"Петр\",\n \"patronymic\": \"Петрович\",\n \"documentType\": \"RU01001\",\n \"documentSeries\": \"4515348286\",\n \"country\": \"RU\",\n \"phoneNumber\": \"+79657865402\",\n \"email\": \"\",\n \"address\": \"РОССИЯ, Москва, Кирова 65, 109465\"\n }\n },\n \"contractNumber\": \"00967932\",\n \"contractDate\": \"2024-06-06\",\n \"showCosts\": true,\n \"cost\": 352160\n },\n \"travelers\": [\n {\n \"lastName\": \"Al-Shaer\",\n \"firstName\": \"Elena \",\n \"patronymic\": \"\",\n \"documentType\": \"RU01004\",\n \"documentSeries\": \"763264351\",\n \"phoneNumber\": \"\",\n \"email\": \"\",\n \"isCustomer\": false,\n \"birthday\": \"1975-08-31\",\n \"country\": \"RU\",\n \"travelerId\": \"550318267568\"\n },\n {\n \"lastName\": \"Bartenev\",\n \"firstName\": \"Vladimir\",\n \"patronymic\": \"\",\n \"documentType\": \"RU01004\",\n \"documentSeries\": \"766516916\",\n \"phoneNumber\": \"\",\n \"email\": \"\",\n \"isCustomer\": false,\n \"birthday\": \"1968-01-25\",\n \"country\": \"RU\",\n \"travelerId\": \"565691173356\"\n }\n ],\n \"tripPeriods\": [\n {\n \"periodId\": \"f9bcf237-e27c-43bb-9dba-560c58b9b70b\",\n \"startDate\": \"2024-10-31\",\n \"endDate\": \"2024-11-08\",\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n ],\n \"tripServices\": {\n \"accommodationTourismServices\": [\n {\n \"serviceId\": \"02734922-91b1-433e-8ebf-ab47c3509460\",\n \"accommodationCountry\": \"RU\",\n \"accommodationRegionRF\": \"01\",\n \"accommodationCityName\": \"Москва\",\n \"hotelName\": \"Редиссон\",\n \"hotelCategory\": \"1\",\n \"foodConditions\": \"bb\",\n \"otherTerms\": \"\",\n \"checkInDate\": \"2024-10-31\",\n \"checkOutDate\": \"2024-11-08\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ],\n \"otherTransportationTourismServices\": [\n {\n \"serviceId\": \"48a8a70f-a945-44a4-ada1-6da1e4bdf397\",\n \"arrivalDate\": \"2024-11-08\",\n \"arrivalPoint\": \"Каир\",\n \"departureDate\": \"2024-10-31\",\n \"departurePoint\": \"Каир\",\n \"description\": \"Круиз\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ],\n \"airTransportationTourismServices\": [\n {\n \"serviceId\": \"b56837c4-418c-4962-befd-c6a426b5fd7a\",\n \"departureCountry\": \"EG\",\n \"departureCity\": \"EGGEI\",\n \"departureAirport\": \"ASW\",\n \"arrivalCountry\": \"EG\",\n \"arrivalCity\": \"EGGEI\",\n \"arrivalAirport\": \"DBB\",\n \"departureDate\": \"2024-10-31\",\n \"arrivalDate\": \"2024-10-31\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ],\n \"railTransportationTourismServices\": [\n {\n \"serviceId\": \"58bbc003-8644-408a-9463-15f2cbc8dcf4\",\n \"departureCity\": \"Москва\",\n \"departureStation\": \"Октябрьская\",\n \"arrivalCity\": \"Санкт-Петербург\",\n \"arrivalStation\": \"Санкт-Петербург-Главный\",\n \"departureDate\": \"2024-10-31\",\n \"arrivalDate\": \"2024-10-31\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\"\n ]\n }\n }\n ],\n \"otherTourismServices\": [\n {\n \"serviceId\": \"f212b676-1d1a-4658-8ae0-2c0e742a74bc\",\n \"tourismServiceType\": \"excursion\",\n \"description\": \"1 день до круиза с проживанием в отеле Каира. Двухместный номер, завтрак + трансфер\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ]\n },\n \"travelerCount\": 2\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{etour_host}}/vouchers/upsert", "host": [ "{{etour_host}}" ], "path": [ "vouchers", "upsert" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "X-Powered-By", "value": "Express" }, { "key": "Content-Type", "value": "application/json; charset=utf-8" }, { "key": "Content-Length", "value": "304" }, { "key": "ETag", "value": "W/\"130-hKeqK6agFJxBwAeq0CAfXBAeAlY\"" }, { "key": "Date", "value": "Tue, 13 Aug 2024 10:37:50 GMT" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Keep-Alive", "value": "timeout=5" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"voucherNumber\": \"0213582477937152\",\n \"customerAuthorizationCode\": \"ЦГ915622\",\n \"voucherCreatedDateTime\": \"2024-08-13T13:37:50\",\n \"travelers\": [\n {\n \"travelerId\": \"565691173356\",\n \"travelerAuthorizationCode\": \"ЮЛ458222\"\n },\n {\n \"travelerId\": \"550318267568\",\n \"travelerAuthorizationCode\": \"ГХ786423\"\n }\n ]\n }\n}" }, { "name": "IE", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "development", "value": "true", "description": "заголовок запроса определяющий адресование для передачи данных в ГИС, true - передача данных на демонстрационный стенд(dev - стенд), false - подключение и передача данных в продуктивный стенд" } ], "body": { "mode": "raw", "raw": "{\n \"number\": null,\n \"status\": \"ACTIVE\",\n \"tourAgent\": \"9201007500\",\n \"voucherType\": \"cruise\",\n \"order\": {\n \"customer\": {\n \"soleProprietorCustomer\": {\n \"lastName\": \"Иванов\",\n \"firstName\": \"Иван\",\n \"patronymic\": \"Иванович\",\n \"documentType\": \"RU01001\",\n \"documentSeries\": \"2711999888\",\n \"country\": \"RU\",\n \"phoneNumber\": \"+79119998877\",\n \"email\": \"test@mail.ru\",\n \"address\": \"г. Москва, ул. Любая, д.777\",\n \"inn\": \"123123123123\"\n }\n },\n \"contractNumber\": \"00967932\",\n \"contractDate\": \"2024-06-06\",\n \"showCosts\": true,\n \"cost\": \"352160\"\n },\n \"travelers\": [\n {\n \"lastName\": \"Al-Shaer\",\n \"firstName\": \"Elena \",\n \"patronymic\": \"\",\n \"documentType\": \"RU01004\",\n \"documentSeries\": \"763264351\",\n \"phoneNumber\": \"\",\n \"email\": \"\",\n \"isCustomer\": false,\n \"birthday\": \"1975-08-31\",\n \"country\": \"RU\",\n \"travelerId\": \"550318267568\"\n },\n {\n \"lastName\": \"Bartenev\",\n \"firstName\": \"Vladimir\",\n \"patronymic\": \"\",\n \"documentType\": \"RU01004\",\n \"documentSeries\": \"766516916\",\n \"phoneNumber\": \"\",\n \"email\": \"\",\n \"isCustomer\": false,\n \"birthday\": \"1968-01-25\",\n \"country\": \"RU\",\n \"travelerId\": \"565691173356\"\n }\n ],\n \"tripPeriods\": [\n {\n \"periodId\": \"f9bcf237-e27c-43bb-9dba-560c58b9b70b\",\n \"startDate\": \"2024-10-31\",\n \"endDate\": \"2024-11-08\",\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n ],\n \"tripServices\": {\n \"accommodationTourismServices\": [\n {\n \"serviceId\": \"02734922-91b1-433e-8ebf-ab47c3509460\",\n \"accommodationCountry\": \"RU\",\n \"accommodationRegionRF\": \"01\",\n \"accommodationCityName\": \"Москва\",\n \"hotelName\": \"Редиссон\",\n \"hotelCategory\": \"1\",\n \"foodConditions\": \"bb\",\n \"otherTerms\": \"\",\n \"checkInDate\": \"2024-10-31\",\n \"checkOutDate\": \"2024-11-08\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ],\n \"otherTransportationTourismServices\": [\n {\n \"serviceId\": \"48a8a70f-a945-44a4-ada1-6da1e4bdf397\",\n \"arrivalDate\": \"2024-11-08\",\n \"arrivalPoint\": \"Каир\",\n \"departureDate\": \"2024-10-31\",\n \"departurePoint\": \"Каир\",\n \"description\": \"Круиз\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ],\n \"airTransportationTourismServices\": [\n {\n \"serviceId\": \"b56837c4-418c-4962-befd-c6a426b5fd7a\",\n \"departureCountry\": \"EG\",\n \"departureCity\": \"EGGEI\",\n \"departureAirport\": \"ASW\",\n \"arrivalCountry\": \"EG\",\n \"arrivalCity\": \"EGGEI\",\n \"arrivalAirport\": \"DBB\",\n \"departureDate\": \"2024-10-31\",\n \"arrivalDate\": \"2024-10-31\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ],\n \"railTransportationTourismServices\": [\n {\n \"serviceId\": \"58bbc003-8644-408a-9463-15f2cbc8dcf4\",\n \"departureCity\": \"Москва\",\n \"departureStation\": \"Октябрьская\",\n \"arrivalCity\": \"Санкт-Петербург\",\n \"arrivalStation\": \"Санкт-Петербург-Главный\",\n \"departureDate\": \"2024-10-31\",\n \"arrivalDate\": \"2024-10-31\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\"\n ]\n }\n }\n ],\n \"otherTourismServices\": [\n {\n \"serviceId\": \"f212b676-1d1a-4658-8ae0-2c0e742a74bc\",\n \"tourismServiceType\": \"excursion\",\n \"description\": \"1 день до круиза с проживанием в отеле Каира. Двухместный номер, завтрак + трансфер\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ]\n },\n \"travelerCount\": 2\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{etour_host}}/vouchers/upsert", "host": [ "{{etour_host}}" ], "path": [ "vouchers", "upsert" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "X-Powered-By", "value": "Express" }, { "key": "Content-Type", "value": "application/json; charset=utf-8" }, { "key": "Content-Length", "value": "304" }, { "key": "ETag", "value": "W/\"130-t7VwMVmP7oT0tTiomb/TNND4HkA\"" }, { "key": "Date", "value": "Tue, 13 Aug 2024 10:40:13 GMT" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Keep-Alive", "value": "timeout=5" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"voucherNumber\": \"0213583163028125\",\n \"customerAuthorizationCode\": \"РЦ117732\",\n \"voucherCreatedDateTime\": \"2024-08-13T13:40:12\",\n \"travelers\": [\n {\n \"travelerId\": \"565691173356\",\n \"travelerAuthorizationCode\": \"ГУ917046\"\n },\n {\n \"travelerId\": \"550318267568\",\n \"travelerAuthorizationCode\": \"ВС813484\"\n }\n ]\n }\n}" }, { "name": "Legal personality", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "development", "value": "true", "description": "заголовок запроса определяющий адресование для передачи данных в ГИС, true - передача данных на демонстрационный стенд(dev - стенд), false - подключение и передача данных в продуктивный стенд" } ], "body": { "mode": "raw", "raw": "{\n \"number\": null,\n \"status\": \"ACTIVE\",\n \"tourAgent\": \"9201007500\",\n \"voucherType\": \"cruise\",\n \"order\": {\n \"customer\": {\n \"companyCustomer\": {\n \"name\": \"ООО Тестовая компания\",\n \"inn\": \"1231231231\",\n \"phoneNumber\": \"+79118889922\",\n \"email\": \"test@mail.ru\",\n \"address\": \"г. Москва, ул. Любая, д.777\"\n }\n },\n \"contractNumber\": \"00967932\",\n \"contractDate\": \"2024-06-06\",\n \"showCosts\": true,\n \"cost\": 352160\n },\n \"travelers\": [\n {\n \"lastName\": \"Al-Shaer\",\n \"firstName\": \"Elena \",\n \"patronymic\": \"\",\n \"documentType\": \"RU01004\",\n \"documentSeries\": \"763264351\",\n \"phoneNumber\": \"\",\n \"email\": \"\",\n \"isCustomer\": false,\n \"birthday\": \"1975-08-31\",\n \"country\": \"RU\",\n \"travelerId\": \"550318267568\"\n },\n {\n \"lastName\": \"Bartenev\",\n \"firstName\": \"Vladimir\",\n \"patronymic\": \"\",\n \"documentType\": \"RU01004\",\n \"documentSeries\": \"766516916\",\n \"phoneNumber\": \"\",\n \"email\": \"\",\n \"isCustomer\": false,\n \"birthday\": \"1968-01-25\",\n \"country\": \"RU\",\n \"travelerId\": \"565691173356\"\n }\n ],\n \"tripPeriods\": [\n {\n \"periodId\": \"f9bcf237-e27c-43bb-9dba-560c58b9b70b\",\n \"startDate\": \"2024-10-31\",\n \"endDate\": \"2024-11-08\",\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n ],\n \"tripServices\": {\n \"accommodationTourismServices\": [\n {\n \"serviceId\": \"02734922-91b1-433e-8ebf-ab47c3509460\",\n \"accommodationCountry\": \"RU\",\n \"accommodationRegionRF\": \"01\",\n \"accommodationCityName\": \"Москва\",\n \"hotelName\": \"Редиссон\",\n \"hotelCategory\": \"1\",\n \"foodConditions\": \"bb\",\n \"otherTerms\": \"\",\n \"checkInDate\": \"2024-10-31\",\n \"checkOutDate\": \"2024-11-08\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ],\n \"otherTransportationTourismServices\": [\n {\n \"serviceId\": \"48a8a70f-a945-44a4-ada1-6da1e4bdf397\",\n \"arrivalDate\": \"2024-11-08\",\n \"arrivalPoint\": \"Каир\",\n \"departureDate\": \"2024-10-31\",\n \"departurePoint\": \"Каир\",\n \"description\": \"Круиз\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ],\n \"airTransportationTourismServices\": [\n {\n \"serviceId\": \"b56837c4-418c-4962-befd-c6a426b5fd7a\",\n \"departureCountry\": \"EG\",\n \"departureCity\": \"EGGEI\",\n \"departureAirport\": \"ASW\",\n \"arrivalCountry\": \"EG\",\n \"arrivalCity\": \"EGGEI\",\n \"arrivalAirport\": \"DBB\",\n \"departureDate\": \"2024-10-31\",\n \"arrivalDate\": \"2024-10-31\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ],\n \"railTransportationTourismServices\": [\n {\n \"serviceId\": \"58bbc003-8644-408a-9463-15f2cbc8dcf4\",\n \"departureCity\": \"Москва\",\n \"departureStation\": \"Октябрьская\",\n \"arrivalCity\": \"Санкт-Петербург\",\n \"arrivalStation\": \"Санкт-Петербург-Главный\",\n \"departureDate\": \"2024-10-31\",\n \"arrivalDate\": \"2024-10-31\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\"\n ]\n }\n }\n ],\n \"otherTourismServices\": [\n {\n \"serviceId\": \"f212b676-1d1a-4658-8ae0-2c0e742a74bc\",\n \"tourismServiceType\": \"excursion\",\n \"description\": \"1 день до круиза с проживанием в отеле Каира. Двухместный номер, завтрак + трансфер\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ]\n },\n \"travelerCount\": 2\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{etour_host}}/vouchers/upsert", "host": [ "{{etour_host}}" ], "path": [ "vouchers", "upsert" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "X-Powered-By", "value": "Express" }, { "key": "Content-Type", "value": "application/json; charset=utf-8" }, { "key": "Content-Length", "value": "304" }, { "key": "ETag", "value": "W/\"130-33iueFYWqbk9ques2wVWcWeh2Rw\"" }, { "key": "Date", "value": "Tue, 13 Aug 2024 10:42:14 GMT" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Keep-Alive", "value": "timeout=5" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"voucherNumber\": \"0213588247048437\",\n \"customerAuthorizationCode\": \"ОД786591\",\n \"voucherCreatedDateTime\": \"2024-08-13T13:42:14\",\n \"travelers\": [\n {\n \"travelerId\": \"565691173356\",\n \"travelerAuthorizationCode\": \"НР419547\"\n },\n {\n \"travelerId\": \"550318267568\",\n \"travelerAuthorizationCode\": \"ОЛ795612\"\n }\n ]\n }\n}" }, { "name": "Error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "development", "value": "true", "description": "заголовок запроса определяющий адресование для передачи данных в ГИС, true - передача данных на демонстрационный стенд(dev - стенд), false - подключение и передача данных в продуктивный стенд" } ], "body": { "mode": "raw", "raw": "{\n \"number\": null,\n \"status\": \"ACTIVE\",\n \"tourAgent\": \"9201007500\",\n \"voucherType\": \"cru\",\n \"order\": {\n \"customer\": {},\n \"contractNumber\": \"00967932\",\n \"contractDate\": \"2024-06-06\",\n \"showCosts\": true,\n \"cost\": 352160\n },\n \"travelers\": [\n {\n \"lastName\": \"Al-Shaer\",\n \"firstName\": \"Elena \",\n \"patronymic\": \"\",\n \"documentType\": \"RU01004\",\n \"documentSeries\": \"763264351\",\n \"phoneNumber\": \"\",\n \"email\": \"\",\n \"isCustomer\": true,\n \"birthday\": \"1975-08-31\",\n \"country\": \"RU\",\n \"travelerId\": \"550318267568\"\n },\n {\n \"lastName\": \"Bartenev\",\n \"firstName\": \"Vladimir\",\n \"patronymic\": \"\",\n \"documentType\": \"RU01004\",\n \"documentSeries\": \"766516916\",\n \"phoneNumber\": \"\",\n \"email\": \"\",\n \"isCustomer\": false,\n \"birthday\": \"1968-01-25\",\n \"country\": \"RU\",\n \"travelerId\": \"565691173356\"\n }\n ],\n \"tripPeriods\": [\n {\n \"periodId\": \"f9bcf237-e27c-43bb-9dba-560c58b9b70b\",\n \"startDate\": \"2024-10-31\",\n \"endDate\": \"2024-11-08\",\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n ],\n \"tripServices\": {\n \"accommodationTourismServices\": [\n {\n \"serviceId\": \"02734922-91b1-433e-8ebf-ab47c3509460\",\n \"accommodationCountry\": \"RU\",\n \"accommodationRegionRF\": \"01\",\n \"accommodationCityName\": \"Москва\",\n \"hotelName\": \"Редиссон\",\n \"hotelCategory\": \"1\",\n \"foodConditions\": \"bb\",\n \"otherTerms\": \"\",\n \"checkInDate\": \"2024-10-31\",\n \"checkOutDate\": \"2024-11-08\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ],\n \"otherTransportationTourismServices\": [\n {\n \"serviceId\": \"48a8a70f-a945-44a4-ada1-6da1e4bdf397\",\n \"arrivalDate\": \"2024-11-08\",\n \"arrivalPoint\": \"Каир\",\n \"departureDate\": \"2024-10-31\",\n \"departurePoint\": \"Каир\",\n \"description\": \"Круиз\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ],\n \"airTransportationTourismServices\": [\n {\n \"serviceId\": \"b56837c4-418c-4962-befd-c6a426b5fd7a\",\n \"departureCountry\": \"EG\",\n \"departureCity\": \"EGGEI\",\n \"departureAirport\": \"ASW\",\n \"arrivalCountry\": \"EG\",\n \"arrivalCity\": \"EGGEI\",\n \"arrivalAirport\": \"DBB\",\n \"departureDate\": \"2024-10-31\",\n \"arrivalDate\": \"2024-10-31\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ],\n \"railTransportationTourismServices\": [\n {\n \"serviceId\": \"58bbc003-8644-408a-9463-15f2cbc8dcf4\",\n \"departureCity\": \"Москва\",\n \"departureStation\": \"Октябрьская\",\n \"arrivalCity\": \"Санкт-Петербург\",\n \"arrivalStation\": \"Санкт-Петербург-Главный\",\n \"departureDate\": \"2024-10-31\",\n \"arrivalDate\": \"2024-10-31\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\"\n ]\n }\n }\n ],\n \"otherTourismServices\": [\n {\n \"serviceId\": \"f212b676-1d1a-4658-8ae0-2c0e742a74bc\",\n \"tourismServiceType\": \"excursion\",\n \"description\": \"1 день до круиза с проживанием в отеле Каира. Двухместный номер, завтрак + трансфер\",\n \"travelerPositions\": {\n \"travelerIds\": [\n \"550318267568\",\n \"565691173356\"\n ]\n }\n }\n ]\n },\n \"travelerCount\": 2\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{etour_host}}/vouchers/upsert", "host": [ "{{etour_host}}" ], "path": [ "vouchers", "upsert" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "X-Powered-By", "value": "Express" }, { "key": "Content-Type", "value": "application/json; charset=utf-8" }, { "key": "Content-Length", "value": "133" }, { "key": "ETag", "value": "W/\"85-+GWIi/qCG6uKbMyJTcuzN1k4pJA\"" }, { "key": "Date", "value": "Tue, 13 Aug 2024 13:47:43 GMT" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Keep-Alive", "value": "timeout=5" } ], "cookie": [], "body": "{\n \"success\": false,\n \"error\": \"Filling error\",\n \"exception\": {\n \"INVALID_VOUCHER_TYPE_CODE\": \"Неверный код типа путёвки\"\n }\n}" } ] }, { "name": "Запрос на создание или обновление турагента (Upsert touragent)", "event": [ { "listen": "test", "script": { "exec": [ "" ], "type": "text/javascript", "packages": {} } } ], "protocolProfileBehavior": { "followRedirects": true, "disableUrlEncoding": false, "disableCookies": false }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "development", "value": "true" }, { "key": "custom-timeout", "value": "60000", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"inn\": \"7724405484\",\n \"emails\": [\n \"hello@sk.ru\"\n ],\n \"phoneNumbers\": [\n \"896225320\"\n ],\n \"active\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{etour_host}}/tourAgents/upsert", "host": [ "{{etour_host}}" ], "path": [ "tourAgents", "upsert" ] }, "description": "##### Описание полей тела запроса\n- inn - (`string`) ИНН турагента. **Обязательное поле** Пример: `\"9201007500\"`\n- emails - (`array` из `string`) Список адресов электронной почты организации. **Обязательно поле.** Пример: `[\"hello@skillline.ru\"]`\n- phoneNumbers - (`array` из `string`) Список номеров телефона. **Обязательно поле**. Пример: `[\"89622532037\"]`\n- active - (`boolean`) Статус турагента. Возможные значения: `true`/`false` По умолчанию: `false`\n\n\nВ данном запросе нет системы возврата ошибки. Система либо принимает запрос, либо нет.\n" }, "response": [ { "name": "Inn only", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "development", "value": "true", "description": "заголовок запроса определяющий адресование для передачи данных в ГИС, true - передача данных на демонстрационный стенд(dev - стенд), false - подключение и передача данных в продуктивный стенд" } ], "body": { "mode": "raw", "raw": "{\n \"inn\": \"7724405484\",\n \"emails\": [\n \"hello@sk.ru\"\n ],\n \"phoneNumbers\": [\n \"896225320\"\n ],\n \"active\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "https://cvg867f348tgdevh07dhaiodygt2.ru:3001/api/v2/tourAgents/upsert", "protocol": "https", "host": [ "cvg867f348tgdevh07dhaiodygt2", "ru" ], "port": "3001", "path": [ "api", "v2", "tourAgents", "upsert" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "X-Powered-By", "value": "Express" }, { "key": "Content-Type", "value": "application/json; charset=utf-8" }, { "key": "Content-Length", "value": "40" }, { "key": "ETag", "value": "W/\"28-o1WMN7uEbGGA3xaLJ1KRr84VrC4\"" }, { "key": "Date", "value": "Fri, 16 Aug 2024 12:37:28 GMT" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Keep-Alive", "value": "timeout=5" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"success\": true\n }\n}" }, { "name": "Error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "development", "value": "true", "description": "заголовок запроса определяющий адресование для передачи данных в ГИС, true - передача данных на демонстрационный стенд(dev - стенд), false - подключение и передача данных в продуктивный стенд" } ], "body": { "mode": "raw", "raw": "{\n \"efrtaRegNumber\": \"РТА 0040209\",\n \"inn\": \"9201007\",\n \"fullName\": \"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \\\"КРЫМПРОФТУР\\\"\",\n \"address\": \"299038, ГОРОД СЕВАСТОПОЛЬ, УЛИЦА АСТАНА КЕСАЕВА, ДОМ 6, ОФИС 7\",\n \"emails\": [\n \"hello@skillline.ru\"\n ],\n \"phoneNumbers\": [\n \"89622532037\"\n ],\n \"active\": true,\n\t\"isNewCard\": true,\n \"name\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{etour_host}}/tourAgents/upsert", "host": [ "{{etour_host}}" ], "path": [ "tourAgents", "upsert" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "X-Powered-By", "value": "Express" }, { "key": "Content-Type", "value": "application/json; charset=utf-8" }, { "key": "Content-Length", "value": "41" }, { "key": "ETag", "value": "W/\"29-iWzimDzO/zxFglwwOJyoQQ5UxTM\"" }, { "key": "Date", "value": "Tue, 13 Aug 2024 13:49:31 GMT" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Keep-Alive", "value": "timeout=5" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"success\": false\n }\n}" } ] }, { "name": "Поиск наличия турагента в реестре туроператора", "event": [ { "listen": "test", "script": { "exec": [ "" ], "type": "text/javascript", "packages": {} } } ], "protocolProfileBehavior": { "followRedirects": true, "disableUrlEncoding": false, "disableCookies": false }, "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "development", "value": "true" }, { "key": "custom-timeout", "value": "100000", "type": "text" } ], "url": { "raw": "{{etour_host}}/tourAgents/check?inn=9201007500", "host": [ "{{etour_host}}" ], "path": [ "tourAgents", "check" ], "query": [ { "key": "inn", "value": "9201007500", "description": "инн турагента" } ] }, "description": "С помощью данного запроса можно получить информацию о наличии конкретного турагента в реестре у туроператора, указав его ИНН. В случае, если данный турагент есть в списке добавленных пользователем на его странице, то выводится информация соответствующая указанному ИНН. Если такого турагента нет - получаем ответ об отсуствии данного турагента в реестре туроператора." }, "response": [ { "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "development", "value": "true", "description": "заголовок запроса определяющий адресование для передачи данных в ГИС, true - передача данных на демонстрационный стенд(dev - стенд), false - подключение и передача данных в продуктивный стенд" } ], "url": { "raw": "https://cvg867f348tgdevh07dhaiodygt2.ru:3001/api/v2/tourAgents/check?inn=9201007500", "protocol": "https", "host": [ "cvg867f348tgdevh07dhaiodygt2", "ru" ], "port": "3001", "path": [ "api", "v2", "tourAgents", "check" ], "query": [ { "key": "inn", "value": "9201007500", "description": "инн турагента" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "X-Powered-By", "value": "Express" }, { "key": "Content-Type", "value": "application/json; charset=utf-8" }, { "key": "Content-Length", "value": "637" }, { "key": "ETag", "value": "W/\"27d-MQhDChJOgr+pQMcvGN59U0GLHZ0\"" }, { "key": "Date", "value": "Mon, 19 Aug 2024 17:59:43 GMT" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Keep-Alive", "value": "timeout=5" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"efrtaRegNumber\": \"РТА 0040209\",\n \"inn\": \"9201007500\",\n \"ogrn\": \"1149204022593\",\n \"shortName\": \"ООО \\\"КРЫМПРОФТУР\\\"\",\n \"fullName\": \"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \\\"КРЫМПРОФТУР\\\"\",\n \"address\": \"299038, ГОРОД СЕВАСТОПОЛЬ, УЛИЦА АСТАНА КЕСАЕВА, ДОМ 6, ОФИС 7\",\n \"emails\": [\n \"hello@skillline.ru\"\n ],\n \"phoneNumbers\": [\n \"89622532037\"\n ],\n \"verified\": false,\n \"active\": false,\n \"tourOperatorAbbreviatedName\": \"АНО \\\"АРВТ\\\" \",\n \"tourOperatorInn\": \"7710481598\",\n \"tourOperatorOgrn\": \"1147799013174\",\n \"tourOperatorRegistryId\": \"РТО021358\"\n }\n}" }, { "name": "Invalid long", "originalRequest": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "development", "value": "true", "description": "заголовок запроса определяющий адресование для передачи данных в ГИС, true - передача данных на демонстрационный стенд(dev - стенд), false - подключение и передача данных в продуктивный стенд" } ], "url": { "raw": "{{etour_host}}/tourAgents/check?inn=920100750", "host": [ "{{etour_host}}" ], "path": [ "tourAgents", "check" ], "query": [ { "key": "inn", "value": "920100750", "description": "инн турагента" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "X-Powered-By", "value": "Express" }, { "key": "Content-Type", "value": "application/json; charset=utf-8" }, { "key": "Content-Length", "value": "135" }, { "key": "ETag", "value": "W/\"87-LEZXgfBqvZy/hGrmuMPzpmPYp9E\"" }, { "key": "Date", "value": "Mon, 19 Aug 2024 18:00:47 GMT" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Keep-Alive", "value": "timeout=5" } ], "cookie": [], "body": "{\n \"success\": false,\n \"error\": \"Invalid inn\",\n \"exception\": {\n \"INVALID_INN_LENGHT_TOUR_AGENT\": \"Некорректная длинна ИНН: 9\"\n }\n}" }, { "name": "Invalid inn", "originalRequest": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "development", "value": "true", "description": "заголовок запроса определяющий адресование для передачи данных в ГИС, true - передача данных на демонстрационный стенд(dev - стенд), false - подключение и передача данных в продуктивный стенд" } ], "url": { "raw": "{{etour_host}}/tourAgents/check?inn=9201007501", "host": [ "{{etour_host}}" ], "path": [ "tourAgents", "check" ], "query": [ { "key": "inn", "value": "9201007501", "description": "инн турагента" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "X-Powered-By", "value": "Express" }, { "key": "Content-Type", "value": "application/json; charset=utf-8" }, { "key": "Content-Length", "value": "176" }, { "key": "ETag", "value": "W/\"b0-DLjKskrc10XnQ0g3GY3fis65YdA\"" }, { "key": "Date", "value": "Mon, 19 Aug 2024 18:01:06 GMT" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Keep-Alive", "value": "timeout=5" } ], "cookie": [], "body": "{\n \"success\": false,\n \"error\": \"Invalid inn\",\n \"exception\": {\n \"INVALID_INN_TOUR_AGENT\": \"Контрольная сумма не совпала с десятым символом 0 != 1\"\n }\n}" }, { "name": "Invalid symbol in inn", "originalRequest": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "development", "value": "true", "description": "заголовок запроса определяющий адресование для передачи данных в ГИС, true - передача данных на демонстрационный стенд(dev - стенд), false - подключение и передача данных в продуктивный стенд" } ], "url": { "raw": "{{etour_host}}/tourAgents/check?inn=61660892942@", "host": [ "{{etour_host}}" ], "path": [ "tourAgents", "check" ], "query": [ { "key": "inn", "value": "61660892942@", "description": "инн турагента" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "X-Powered-By", "value": "Express" }, { "key": "Content-Type", "value": "application/json; charset=utf-8" }, { "key": "Content-Length", "value": "144" }, { "key": "ETag", "value": "W/\"90-HSMvNI1L9FsknlFztiWBrl6uVcY\"" }, { "key": "Date", "value": "Mon, 19 Aug 2024 18:01:46 GMT" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Keep-Alive", "value": "timeout=5" } ], "cookie": [], "body": "{\n \"success\": false,\n \"error\": \"Invalid inn\",\n \"exception\": {\n \"INVALID_SYMBOL_IN_INN_TOUR_AGENT\": \"Некорректный символ \\\"@\\\" в ИНН\"\n }\n}" }, { "name": "Tour agent not found", "originalRequest": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "development", "value": "true", "description": "заголовок запроса определяющий адресование для передачи данных в ГИС, true - передача данных на демонстрационный стенд(dev - стенд), false - подключение и передача данных в продуктивный стенд" } ], "url": { "raw": "{{etour_host}}/tourAgents/check?inn=616608929424", "host": [ "{{etour_host}}" ], "path": [ "tourAgents", "check" ], "query": [ { "key": "inn", "value": "616608929424", "description": "инн турагента" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "X-Powered-By", "value": "Express" }, { "key": "Content-Type", "value": "application/json; charset=utf-8" }, { "key": "Content-Length", "value": "119" }, { "key": "ETag", "value": "W/\"77-+hVAlgPj+ba7+fxhatcVlV6O5xM\"" }, { "key": "Date", "value": "Mon, 19 Aug 2024 18:02:15 GMT" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Keep-Alive", "value": "timeout=5" } ], "cookie": [], "body": "{\n \"success\": false,\n \"error\": \"Agent not found\",\n \"exception\": {\n \"NONEXISTENT_TOUR_AGENT\": \"Турагент не наеден\"\n }\n}" } ] } ], "description": "Данная версия включает в себя:\n\n- Запрос на создание заявки;\n \n- Запрос на создание турагента;\n \n- Запрос на наличие турагента в реестре туроператора\n \n\nДля активации и работы с решением ETour требуется авторизационный токен. \nВ данной документации в значении переменной `etour_host` указан адрес тестового сервера, который принимает запросы передаваемые только в демонстративный стенд ГИС ЭП. \nТокен и адрес для отправки запросов на продуктивный стенд вы можете получить заключив договор с нашей компанией.\n\n## Обновление!!!\n\nВ данном обновлении были внесены следующие изменения:\n\n1. В объект услуги размещения было добавлено новое поле. \n `foodConditions` - (`string`) кодовое обозначение условий питания. Обязательное поле. Пример: `\"ai\"`. \n Значение поля берется из справочника с названием FOOD_CONDITIONS.\n \n2. В блоке информации о заказчике было исключено поле `authorities` - полномочия заказчика\n \n3. Была добавлена возможность менять значения `timeout` - время ожидания ответа от ГИС ЭП. Для этого нужно добавить заголовок под названием `custom-timeout` указывающего время ожидания в миллисекундах. Максимально возможное время - 300 000. По умолчанию стоит 20 000.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{etour_token}}", "type": "string" } ] }, "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "packages": {}, "exec": [ "" ] } }, { "listen": "test", "script": { "type": "text/javascript", "packages": {}, "exec": [ "" ] } } ] } ], "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "packages": {}, "exec": [ "" ] } }, { "listen": "test", "script": { "type": "text/javascript", "packages": {}, "exec": [ "" ] } } ], "variable": [ { "key": "etour_host", "value": "https://cvg867f348tgdevh07dhaiodygt2.ru:3001/api/v2", "type": "string" }, { "key": "etour_token", "value": "", "type": "string" } ] }