Описание формата "MasterML"


НАШИ
ПРОДУКТЫ

Мастер-Тур 15

Мастер-Тур 2009

Мастер-Web

Мастер-Interlook

Мастер-Interlook Web

Мастер-Центр оплат (для 1С)

Мастер-Финансы

УСЛУГИ

Абонентское обслуживание

Правила обращения

Обучение

Консалтинг

БАННЕРЫ














МЕГАТЕК - информационные технологии
ИНФОРМАЦИОННЫЕ ТЕХНОЛОГИИ В ТУРИЗМЕ
       О КОМПАНИИ       КЛИЕНТЫ       ПОЛЬЗОВАТЕЛЯМ       ЦЕНЫ       ПОДДЕРЖКА ВЕРСИЙ       НАШ БЛОГ      

  Описание формата "MasterML"

MasterML – это формат, использовавшийся ранее для обмена данными между продуктами компании «Мегатек». Формат является открытым и может использоваться для обмена с продуктами третьих производителей. Ниже приводится описание формата, используемого для описания прайс-листов. В данный момент рекомендуется использовать формат TourML.

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

Документ содержит только цены на весь тур и не содержит цен и доплат за отдельные услуги. Для каждой цены хранится список услуг, которые входят в эту цену. Такая избыточность введена для того, чтобы можно было описать тур любой сложности: например, часто для разных отелей цены рассчитываются с разными трансферами, или для «детских» типов номеров авиаперелет рассчитывается по другому тарифу.

Для всех справочников предусмотрено поле для некоторого «стандартного ключа», который может быть использован для синхронизации справочников. Предполагается использование кодов, используемых в системах бронирования. В настоящее время это поле не используется, за исключением справочника классов услуг (см. далее).

Ниже описана общая структура документа, а также некоторые специфические для продуктов линейки «Мастер» моменты, такие как описания типов номеров и услуг.

Структура документа

Корневой тег документа <packet> содержит 4 тега:

  • <header> - заголовок документа. Содержит данные о туре, параметрах расчета и датах заездов.
  • <references> - справочники. Содержит части справочников, так или иначе используемых в прайс-листе.
  • <services> - описания услуг. Содержит полные описания услуг, для которых рассчитывались цены (подробнее об услугах см. п. 3)
  • <prices> - цены. Содержит данные о ценах, датах действия и услугах, для которых цена была рассчитана.

Услуги

«Услуга» - основное понятие в продуктах линейки «Мастер». Примеры услуг – «авиаперелет Москва-Анталия, рейс SU 511, экономический класс», или «проживание в отеле Topkapi Palace, DBL, All Inclusive». Любой тур может быть описан как совокупность услуг.

Описания всех услуг, для которых рассчитывались цены, содержатся в теге <services>. Атрибуты, описывающие услугу, содержатся в тегах <service> и во вложенном в него теге <variant>. «Варианты услуги» были введены исключительно с целью уменьшить размер документа. Каждому «варианту» присвоен уникальный идентификатор id, по которому на него ссылаются в дальнейшем.

Некоторые атрибуты услуги являются ключами, ссылающимися на справочники в теге <references>, это подробнее описано ниже.

Услуга описывается следующими атрибутами:

  • класс услуги (авиаперелет, трансфер, проживание, экскурсия, виза, страховка; пользователь также может определять собственные классы услуг). Ключ класса услуги хранится в атрибуте classKey и является ссылкой на справочник классов услуг (тег <serviceClasses>)
  • день начала действия (от начала тура). Хранится в атрибуте day, нумеруется от 1
  • продолжительность. Хранится в атрибуте days, является необязательной.
  • количество человек, пользующихся услугой. Хранится в атрибуте men.
  • страна. Атрибут countryKey является ключом страны и указывает на справочник стран (тег <countries>)
  • город. Атрибут cityKey является ключом страны и указывает на справочник стран (тег <cities>). Атрибут isCity для соответствующего класса услуги определяет, является ли этот обязательным.
  • от одного до трех параметров, описывающих услугу. Хранятся в атрибутах subKey (обязательный), subKey1 и subKey2 (обязательные или нет – определяется значением атрибутов isSubKey1 и isSubKey2 соответствующего класса услуги). Значения этих атрибутов указывают на тот или иной справочник, в зависимости от класса услуги. Значения и справочники приведены в таблице.

Класс услуг

subKey

subKey1

subKey2

авиаперелет

<flights>

рейс

<tariffs>

тариф

<cities>

город вылета (на город прилета указывает тег cityKey)

трансфер

<transferts>

трансфер

<transports>

вид транспорта

не используется

проживание

<hotels>

отель

<rooms>

номер (см. также п. 4)

<boardings>

питание

экскурсия

<excursions>

экскурсия

<transports>

вид транспорта

не используется

виза

<services>

пользовательские услуги

<addDescriptions1>

дополнительные описания 1

<addDescriptions2>

дополнительные описания 1

страховка

пользовательские классы

  • ключи пакета и партнера – поставщика услуги. Эта информация хранится в атрибутах packetKey и partnerKey. Они нужны для отправки заявки от агентства туроператору. Атрибуты не указывают ни на один из справочников.
  • атрибуты услуги (только в версии документа 1.1) – битовая маска, описывающая дополнительные пользовательские атрибуты, такие как возможность удаления услуги из пакета, возможность редактирования определенных атрибутов услуги, и т.п. Атрибут flags, подробное описание – в прилагаемом документе

Номера в отеле

Номера в отеле хранятся в справочнике <rooms>. Каждый тип номера описывается тремя атрибутами:

  • typeKey - тип номера (DBL, SGL, TRPL и т.п.) – ссылка на справочник <roomTypes>,
  • categoryKey - категория (Standard, Sea view и т.п.) – ссылка на справочник <roomCategories>,
  • accomodationKey - вид проживания (взрослый на основном месте, взрослый на доп. месте, ребенок 7 – 12 лет на доп. месте, и т.п.) – ссылка на справочник <roomAccomodations>.

Обозначения

В документе приняты следующие названия тегов:

  • key - первичный ключ в базе данных оператора. Используется для ссылок внутри документа. Может быть использован при отправке заявки от агентства оператору.
  • stdKey - стандартный ключ, используемый для синхронизации справочников.
  • name - название
  • nameLat - латинское название
  • code – пользовательский код

Даты сохраняются в формате YYYY-MM-DD, время – hh:mm, дни недели (в расписаниях перелетов) – в виде строки из 7 символов, например «.2...6.» обозначает, что данный рейс летает по вторникам и средам.

Более подробная информация об атрибутах и тегах приведена в комментариях к прилагаемому XML-документу.

Версии

В настоящий момент поддерживаются версии 1.0 и 1.1 документа. Теги и атрибуты, специфичные для определенной версии, особо отмечены в XML-примере.

Скачать XML-пример >>

Прайс-лист, используемый в XML-примере (MS Excel) >>



на главнуюпоискнаписать письмо
ВХОД ДЛЯ
КЛИЕНТОВ

Логин (e-mail)

Пароль


НАШ БЛОГ

Как повысить продажи экскурсионных туров?
07.02.2014 15:40

Рассчитать прайс-лист по стране на весь сезон за 10 минут в Мастер-туре, разве это реально?
23.01.2014 13:43

Служба поддержки

e-mail: service@megatec.ru

СКАЧАТЬ

Демо-версии продуктов линейки "Мастер"

Описание генератора отчетов "Report Sharp-Shooter"

Презентации

Полезные ссылки



РАЗРАБОТЧИКАМ

Описание формата "MasterML"


Copyright (c) Мегатек 1996–2017
Россия, 115201, Москва, Каширский пр-д, 23
Посмотреть схему проезда


Тел.: +7 (495) 228-32-84
E-mail: service@megatec.ru
Copyright (c) Мегатек 1996–2017
Россия, 192025, Санкт-Петербург, Невский пр-т д. 80, БЦ «Невский 80», 5 этаж, оф. 5-6
Посмотреть схему проезда


Тел.: +7 (812) 965-06-31
E-mail: spb@megatec.ru
Copyright (c) Мегатек 1996–2017
Украина, Киев, ул. Предславинская, 11, оф. 403 (ст. м. Олимпийская)
Посмотреть схему проезда


Тел. +38 (044) 490-10-82
E-mail: kiev@megatec.ru

Программы для туризма

Компания «Мегатек» – специальные программы для туризма.

Яндекс.Метрика