ICS Tour API v1.20
описание взаимодействия

Метод позволяет аннулировать заявку на тур.

Доступ к методу предоставляется по запросу.

Метод позволяет унать возможна ли аннуляция заявки и какие будут за это штрафы.

Доступ к методу предоставляется по запросу.

• Citizenship - Список возможных гражданств
• DocumentType - Список типов документов по заявке
• RoomSearchStatus - Список статусов отелей в поиске туров
• RoomStatus - Список возможных статусов комнаты в заявке
• TicketSearchStatus - Список статусов билетов в поиске туров
• TicketStatus - Список возможных статусов билета в заявке
• TransferType - Список типов трансфера
• VisaStatus - Список возможных статусов визы в заявке

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

Ценовые предложения сгруппированны по отелям.

• unavailable - документы недоступны по данной заявке
• forbidden - скачивание документов запрещено (неполная оплата, например)
• expected - документы ожидаются, еще не готовы
• available - документы готовы и доступны для скачивания, но еще не скачивались
• updated - доступны для скачивания обновленные версии документов
• downloaded - актуальные версии документов были загружены пользователем

• approved - заявка подтверждена
• processing - заявка в обработке
• canceled - заявка аннулирована

• num - номер рейса
• class - код класса обслуживания
• departure - время вылета
• arrival - время прилета
• aircompany - название авиакомпании
• aircompany_iata - IATA код авиакомпании
• departure_ap - аэропорт вылета
• departure_ap_iata - IATA код аэропорта вылета
• arrival_ap - аэропорт прилета
• arrival_ap_iata - IATA код аэропорта прилета

• coverage - покрытие
• franchise - франшиза
• insurer - название компании страховщика
• currency - валюта страховки

• transfer_type - тип трансфера (group, individual)

• room
  • id - идентификатор комнаты
  • name - название комнаты
  • hotel - идентификатор отеля
  • hotel_name - название отеля
  • hotel_category - категория отеля
  • resort - идентификатор курорта
  • resort_name - название курорта
  • country - идентификатор страны
  • country_name - название страны
• meal
  • id - идентификатор питания
  • name - название питания
• accomodation
  • id - идентификатор размещения
  • name - название размещения
  • adults - количество врослых
  • children - количество детей

Теги surcharges, extra_services могут отсутствовать в зависимости от наличия доплат или дополнительных услуг соответственно.

Тег info внутри тега part появляется только в том случае, если описываемая часть тура является проживанием.

Внимание! Если в тегах option, surcharge или extra_service отсутствует атрибут price, то это означает, что стоимость данной доплаты или услуги нужно уточнять у менеджера.

Основная информация, необходимая для бронирования тура, передается в параметре data, которая представляет собой строку формата JSON. Описание формата строки аналогично описанию в методе makeOrder, за исключением того, что наличие массива clients не является обязательным.

Основная информация, необходимая для бронирования тура, передается в параметре data, которая представляет собой строку формата JSON.

Предположим, что TOUR - это один из тегов tour, которые возвращаются методом getTours. Тогда запись TOUR.flight.option.id будет означать, что нужно взять значение атрибута id, тега option, который является узлом тега flight, который, в свою очередь, является узлом тега tour, который мы получили в выборке метода.

   {
      "seelct_flight": "Идентификатор выбранного рейса, берется из TOUR.flight.option.id",
      "change_part": [
      #  Массив объектов, которые указывают какую замену в какой части тура  следует произвести
      #
         {
             "part_id": "Идентификатор части тура, в которой происходит замена, TOUR.content.part.id",
             "change_id": "Идентификатор замены, TOUR.content.part.option.id"
         },
         ...
      ],
      "surcharges": [ "Массив идентификаторов доплат, TOUR.surcharges.surcharge.id" ],
      "extra_charges": [ "Массив идентификаторов дополнительных услуг, TOUR.extra_services.extra_service.id" ],
      "phone": "Телефон для экстренной связи c туристами. Формат: +X(XXX)XXX-XXXX",
      "email": "E-mail адрес для экстренной связи c туристами",
      "clients": [
      #  Массив объектов, которые содержат данные о туристах в заявке
      #  количество элементов в массиве должно соответствовать количеству 
      #  туристов в туре, TOUR.accomodation.adults.n + TOUR.accomodation.kids.n
      #
          {
              "surname": "Фамилия туриста латинскими буквами",
              "name": "Имя туриста латинскими буквами",
              "patronymic": "Отчество туриста латинскими буквамиш, требуется только при бронировании внутри России",
              "birth_date": "Дата рождения туриста, формат YYYY-MM-DD",
              "gender": "Пол туриста (MR - мужской, MRS - женский)",
              "citizenship": "Идентификатор гражданства туриста",
              "passport_serial": "Серия паспорта, обязательна и учитывается только для российского гражданства, для других будет проигнорирована.",
              "passport": "Номер паспорта",
              "passport_begin": "Дата начала действия паспорта, формат YYYY-MM-DD",
              "passport_end": "Дата окончания действия паспорта, формат YYYY-MM-DD"
          },
          ...
      ],
   }

Обязательным является только массив clients. Если бронируется тур с авиабилетом, то параметр select_flight так же является обязательным. Все остальные элементы могут быть пустыми или отсутствовать. Например, если при бронировании ни в одной части тура не предполагается производить замену, то массив change_part можно не указывать или передать его пустым.

Для совместивости с предыдущими версиями, данные о выбранном рейсе могут быть переданны в ключе change_flight, в этом случае select_flight указывать не надо.

После того как получен ответ от метода makeOrder, запрос на бронирование тура поставлен в очередь. Его статус в очереди можно проверить с помощью метода checkBooking, передав в него полученный от системы book_id. То есть тур бронируется не сразу, а в течении некоторого времени. Идентификатор брони можно получить с помощью метода checkBooking.

Если передан параметр check_only, то бронирование производиться не будет. В параметре book_id будет не идентификатор бронирования, а слово tested.