XML-шлюз. Структура заявки

Главная / Статьи

Ниже представлена структура xml-заявки. Приведено описание тегов, возвращаемых при просмотре заявки.

Элемент OrderType

Тип заявки.При бронировании необходимо использовать тип Touristic для стандартных заявок и Excursion для внесения только экскурсий.

Вложенные элементы:

type – тип заявки.

Элемент Country

Информация о стране отдыха.

Содержит вложенные элементы:

id – идентификатор страны.

name – название страны на английском языке.

Элемент Summary

Общая информация по заявке

orderId – идентификатор заявки. При бронировании и предрасчете не используется.

creationDate – дата и время создания заявки. При бронировании и предрасчете не используется.

startDate – дата начала тура. При бронировании и предрасчете не используется.

endDate – дата завершения тура. При бронировании и предрасчете не используется.

calculated – параметр, показывающий, рассчитана заявка или нет, false – не рассчитана, true – рассчитана. При бронировании и предрасчете не используется.

confirmed – параметр, показывающий, подтверждена ли заявка или нет, false- не подтверждена, true – подтверждена. При бронировании и предрасчете не используется.

documentsReady – готовность документов по заявке. true – готовы, false – не готовы. При бронировании и предрасчете не используется.

lastPayDate – крайняя дата оплаты заявки (включительно), в формате dd.mm.yyyy. При бронировании и предрасчете не используется.

price – номинальная цена заявки. При бронировании и предрасчете не используется.

charge – начислено за заявку (сколько агентство должно заплатить). При бронировании и предрасчете не используется.

penalty - сборы. При бронировании и предрасчете не используется.

paid - оплачено. При бронировании и предрасчете не используется.

currency – идентификатор валюты, в которой производится расчет.

agencyRussianName – название агентства, забронировавшего заявку, на русском языке. При бронировании и предрасчете не используется.

agencyName – название агентства латинскими буквами.

percent – процент комиссии по заявке. При бронировании и предрасчете не используется.

managerLogin – логин менеджера, создавшего заявку. При бронировании и предрасчете не используется.

updatedDate – дата и время последнего обновления заявки. Кодируется по специальному алгоритму (возвращает количество миллисекунд прошедших с

Января 1, 1970, 00:00:00 GMT). При бронировании и предрасчете не используется.

Элемент Tourist

Информация о туристе. Содержит элементы:

touristId – идентификатор туриста в заявке.

surname – фамилия туриста.

name - имя туриста.

gender – идентификатор обращения.

birthday – дата рождения туриста.

birthdayPlace - место рождения туриста.

nationality – идентификатор страны, гражданином которой является турист.

residenceCityId - идентификатор города проживания туриста.

visaType - тип оформления визы.

visaCityRegistrationId - идентификатор города оформления визы.

passport_seria – серия паспорта.

passport – номер паспорта.

passport_issue_date – дата выдачи паспорта.

passport_issuer – организация, выдавшая паспорт.

passport_expiration_date – дата окончания действия паспорта.

inn - ИНН туриста. Необходим для граждан Белоруссии и Казахстана

aviaInfoMsg – текстовое сообщение о возможности печати авиасправки. Например, «Печать невозможна, только после отбытия туристов.»

genderName – имя типа туриста. Например, MR.

sex - пол туриста. Например, 1 - мужчина.

eTickets – номер электронного билета. При бронировании и предрасчете не используется.

insuranceNumbers – номера страховок. При бронировании и предрасчете не используется.

Элемент Residence

Инфомрация о размещении. Содержит вложенные элементы:

serviceId – идентификатор услуги внутри заявки.

checkIn – дата заезда.

checkOut - дата отъезда.

hotel – идентификатор отеля.

hotelPansion – идентификатор пансиона в отеле.

hotelRoom – идентификатор типа комнаты в отеле.

hotelStayTypeId – идентификатор типа размещения в отеле.

hotelStayType – названия типа размещения в отеле.

shortInfo – краткая текстовая информация о проживании. При бронировании и предрасчете не используется.

status – статус услуги. Передается в виде текста на русском языке. При бронировании и предрасчете не используется.

region – название региона отеля на английском языке.

regionId – идентификатор региона.

hotelName – название отеля.

hotelTypeName – название категории отеля.

pansionName – название пансиона.

roomName – название комнаты.

statusEng – статус услуги на английском языке. При бронировании и предрасчете не используется.

note – примечание отеля. При бронировании и предрасчете не используется.

Элемент Transfer

Информация о трансфере. Содержит вложенные элементы:

serviceId – идентификатор трансфера как услуги внутри заявки.

date – дата выполнения трансфера.

fromId – место отправления трансфера. Идентификатор аэропорта или отеля.

toId – место назначения трансфера. Идентификатор аэропорта или отеля.

type – идентификатор типа трансфера.

typeName – название типа трансфера.

flightDeparture – идентификатор рейса, под который организован трансфер. Необходимо использовать значение элемента flightDepartureиз из блока Ticket.

shortInfo – краткая текстовая информация о трансфере. При бронировании и предрасчете не используется.

status – статус услуги, название на русском языке. При бронировании и предрасчете не используется.

statusEng – статус услуги на английском языке. При бронировании и предрасчете не используется.

departure_point – название точки отправления трансфера на английском языке.

arrival_point – название точки назначения на английском языке.

Элемент Ticket

Информация об авиабилетах.

serviceId – идентификатор авиабилетов как услуги внутри заявки.

flightDeparture – идентификатор рейса.

seatType – идентификатор типа кресел в самолете.

food – класс питания, не ясно, откуда оно и нужно ли.

shortInfo – краткая текстовая информация о рейсе.

status – статус услуги на русском языке.

flightNumber – номер рейса.

startDate – дата вылета рейса.

toResortCountry – параметра, определяющий направление рейса – на курорт или обратно. true – на курорт, false – обратный рейс.

statusEng – статус заявки на английском языке.

seat_type – название типа кресел в самолете на английском языке.

departure_datetime – дата и время отправления.

arrival_datetime – дата и время прилета.

departure_airport – название аэропорта вылета на английском языке.

arrival_airport – название аэропорта прилета на английском языке.

eTickets – номер электронного билета.

aircraftType – название самолета на английском языке. Например, AIRBUS A321.

departureCityId – идентификатор города вылета.

arrivalCityId – идентификатор города прилета.

Элемент Insurance

Информация по страховке. При бронировании и предрасчете обычно не используется, но возвращается при просмотре заявки.

serviceId – идентификатор страховки как услуги внутри заявки.

from – дата начала действия страховки.

to – дата завершения действия страховки.

typeId – идентификатор типа страховки.

type – название типа страховки латинскими буквами.

shortInfo – краткая текстовая информация по страховке.

status – статус услуги по страхованию на русском языке.

statusEng – статус услуги по страхованию на английском языке.

insuranceNumbers - номер страховки.

insuranceNevyletFull – описание страховки.

polis - номер страхового полиса.

extrarisk - страхование дополнительных рисков.

Элемент Visa

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

serviceId - идентификатор услуги.

from - дата начала.

to - дата завершения.

type - название типа визы на русском языке.

visaStatus - статус визы на русском языке.

shortInfo - краткая инфомрация по визе.

status - статус услуги на русском языке.

statusEng - статус услуги на английском языке.

price - стоимость визы.

cityRegistrationId - идентификатор города.

cityRegistrationName - название города на русском языке.

Элемент Excursion

Информация об экскурсии по заявке.

serviceId - идентификатор услуги. Обязательно указывать при бронировании.

excursionId - идентификатор экскурсии. Обязательно указывать при бронировании.

date - дата проведения экскурсии. Обязательно указывать при бронировании.

hotel - идентификатор отеля. Обязательно указывать при бронировании.

roomNumber - номер комнаты.

adultCount - количество взрослых на экскрусии. Обязательно указывать при бронировании.

childCount - количество детей на экскурсии. Обязательно указывать при бронировании. Если отсутсвуют - указывать 0.

infantCount - количество детей младшего возраста на экскурсии. Обязательно указывать при бронировании. Если отсутсвуют - указывать 0.

status - статус услуги на русском языке

statusEng - статус услуги на английском языке.

price - стоимость экскурсии. Обязательно указывать при бронировании.

excursionName - название экскурсии на английском языке.

Элемент ExtraService

Информация о дополнительных услугах по заявке.

serviceId - идентификатор услуги.

date - дата оказания услуги.

type - текст. Тип дополнительной услуги.

shortInfo - текстовое описание дополнительной услуги.

status - статус услуги на русском языке.

statusEng - статус услуги на английском языке.

price - стоимость услуги.

Элемент Comment

Примечание к заявке. Содержит вложенный элемент:

text – текст примечания.

Элемент ServiceLanguage

Язык обслуживания.

Language – название языка на английском.

Элемент ServiceTourist

Привязка туристов к услугам в заявке. Содержит вложенные элементы.

serviceId – идентификатор услуги.

touristId – идентификатор туриста.

ageCategory – название возрастной категории туриста на английском языке. При бронировании и предрасчете не используется.

Элемент TimeLimit

Элемент, содержащий информацию об условиях предварительного бронирования. Содержит вложенные элементы:

type - элемент, содержащий информацию о типе предварительного бронирования.

value - дата и время, до которого заявка находится на этапе предварительного бронирования. Формат dd:mm:yyyy hh:mm.

Пример xml при просмотре заявки:

<?xml version="1.0"?>
<order>
<OrderType>
    <type>Touristic</type>
</OrderType>
<Country>
    <id>5732</id>
    <name>EGYPT</name>
</Country>
<Summary>
    <orderId>12700343</orderId>
    <creationDate>05.12.2012 21:56</creationDate>
    <startDate>07.02.2013</startDate>
    <endDate>13.02.2013</endDate>
    <spoId>10017086</spoId>
    <spo>Spo 14</spo>
    <calculated>false</calculated>
    <confirmed>false</confirmed>
    <released>true</released>
    <documentsReady>true</documentsReady>
    <price>0.0</price>
    <charge>0.0</charge>
    <penalty>0.0</penalty>
    <paid>0.0</paid>
    <currency>5561</currency>
    <agencyRussianName>Тестовое агентство</agencyRussianName>
    <agencyName>TEST</agencyName>
    <percent>9.5</percent>
    <updatedDate>1354737600000</updatedDate>
    <isOnlineChange>false</isOnlineChange>
</Summary>
<Tourist>
    <touristId>28973551</touristId>
    <surname>TESTSECOND</surname>
    <name>TESTSECOND</name>
    <gender>2689</gender>
    <birthday>10.08.1981</birthday>
    <aviaInfoMsg>Печать невозможна, только после отбытия туристов.</aviaInfoMsg>
    <genderName>MRS.</genderName>
    <eTickets></eTickets>
    <insuranceNumbers>28973551 W-912</insuranceNumbers>
</Tourist>
<Tourist>
    <touristId>28973550</touristId>
    <surname>TEST</surname>
    <name>TEST</name>
    <gender>2688</gender>
    <birthday>10.10.1980</birthday>
    <aviaInfoMsg>Печать невозможна, только после отбытия туристов.</aviaInfoMsg>
    <genderName>MR.</genderName>
    <eTickets></eTickets>
    <insuranceNumbers>28343450 W-912</insuranceNumbers>
</Tourist>
<Residence>
    <serviceId>77699384</serviceId>
    <checkIn>07.02.2013</checkIn>
    <checkOut>13.02.2013</checkOut>
    <hotel>40069</hotel>
    <hotelPansion>9009889</hotelPansion>
    <hotelRoom>54202</hotelRoom>
    <hotelStayTypeId>2</hotelStayTypeId>
    <hotelStayType>DBL</hotelStayType>
    <shortInfo>LUNA (07.02 - 13.02.13)</shortInfo>
    <status>Снята</status>
    <levyPercent>1</levyPercent>
    <region>SHARM EL-SHEIKH</region>
    <regionId>5735</regionId>
    <hotelName>LUNA</hotelName>
    <hotelTypeName>3 *</hotelTypeName>
    <pansionName>BB</pansionName>
    <roomName>Standard</roomName>
    <statusEng>Cancel</statusEng>
</Residence>
<Transfer>
    <serviceId>77699386</serviceId>
    <date>13.08.2012</date>
    <fromId>40069</fromId>
    <toId>359</toId>
    <type>3635</type>
    <typeName>G</typeName>
    <flightDeparture>809888</flightDeparture>
    <shortInfo>G (13.02.13) LUNA - SHARM(SSH)</shortInfo>
    <status>Снята</status>
    <levyPercent>1</levyPercent>
    <statusEng>Cancel</statusEng>
    <departure_point>LUNA</departure_point>
    <arrival_point>SHARM-EL-SHEIKH (SSH)</arrival_point>
</Transfer>
<Transfer>
    <serviceId>77699385</serviceId>
    <date>07.08.2012</date>
    <fromId>359</fromId>
    <toId>40069</toId>
    <type>3635</type>
    <typeName>G</typeName>
    <flightDeparture>835619</flightDeparture>
    <shortInfo>G (07.02.13) SHARM(SSH) - LUNA</shortInfo>
    <status>Снята</status>
    <levyPercent>1</levyPercent>
    <statusEng>Cancel</statusEng>
    <departure_point>SHARM-EL-SHEIKH (SSH)</departure_point>
    <arrival_point>LUNA</arrival_point>
</Transfer>
<Ticket>
    <serviceId>77699387</serviceId>
    <flightDeparture>835619</flightDeparture>
    <seatType>3</seatType>
    <food>3</food>
    <jClass>0</jClass>
    <shortInfo>Y7 7601E (07.02) DME - SHARM-EL-SHEIKH (SSH) (12:2</shortInfo>
    <status>Снята</status>
    <levyPercent>1</levyPercent>
    <flightNumber>Y7 7601</flightNumber>
    <startDate>07.02.2013</startDate>
    <toResortCountry>true</toResortCountry>
    <statusEng>Cancel</statusEng>
    <seat_type>Economy</seat_type>
    <departure_datetime>07.02.2013 09:55</departure_datetime>
    <arrival_datetime>07.02.2013 12:25</arrival_datetime>
    <departure_airport>DME</departure_airport>
    <arrival_airport>SHARM-EL-SHEIKH (SSH)</arrival_airport>
    <eTickets></eTickets>
    <aircraftType>B-737-800</aircraftType>
    <departureCityId>345</departureCityId>
    <arrivalCityId>15951</arrivalCityId>
</Ticket>
<Ticket>
    <serviceId>77699388</serviceId>
    <flightDeparture>809888</flightDeparture>
    <seatType>3</seatType>
    <food>3</food>
    <jClass>0</jClass>
    <shortInfo>SU 409E (13.02) SHARM-EL-SHEIKH (SSH) - SVO-C (23:</shortInfo>
    <status>Снята</status>
    <levyPercent>1</levyPercent>
    <flightNumber>SU 409</flightNumber>
    <startDate>13.02.2013</startDate>
    <toResortCountry>false</toResortCountry>
    <statusEng>Cancel</statusEng>
    <seat_type>Economy</seat_type>
    <departure_datetime>13.08.2012 16:40</departure_datetime>
    <arrival_datetime>13.08.2012 23:20</arrival_datetime>
    <departure_airport>SHARM-EL-SHEIKH (SSH)</departure_airport>
    <arrival_airport>SVO-C</arrival_airport>
    <eTickets></eTickets>
    <aircraftType>IL-96</aircraftType>
    <departureCityId>15951</departureCityId>
    <arrivalCityId>345</arrivalCityId>
</Ticket>
<Insurance>
    <serviceId>77699390</serviceId>
    <from>07.08.2012</from>
    <to>13.08.2012</to>
    <typeId>144491</typeId>
    <type>RESO - EGYPT</type>
    <shortInfo>07.08 - 13.08.12</shortInfo>
    <status>Снята</status>
    <statusEng>Cancel</statusEng>
    <levyPercent>1</levyPercent>
    <insuranceNumbers>W-9122sddsds1W-9122212173550</insuranceNumbers>
    <export>IssueReso</export>
    <polis>W-912</polis>
    <extrarisk>UNCONDITIONAL FRANCHISE - 30$</extrarisk>
    <InsuranceNevyletFull>Страхование расходов, возникших вследствие отмены поездки за границу или изменения сроков пребывания за границей</InsuranceNevyletFull>
</Insurance>
<ExtraService>
    <serviceId>77699389</serviceId>
    <date>07.08.2012</date>
    <type>Доплата за авиакомпанию</type>
    <shortInfo>Доплата за авиа (07.08.12)</shortInfo>
    <status>Снята</status>
    <statusEng>Cancel</statusEng>
    <price>0.0</price>
    <levyPercent>0</levyPercent>
</ExtraService>
<ServiceLanguage>
    <Language>Russian</Language>
</ServiceLanguage>
<Comment>
    <text>05.12.2012 Online Book: SPO 14 Sh (MOSCOW)</text>
</Comment>
<ServiceTourist>
    <serviceId>77699387</serviceId>
    <touristId>28973550</touristId>
    <ageCategory>Adult</ageCategory>
</ServiceTourist>
<ServiceTourist>
    <serviceId>77699387</serviceId>
    <touristId>28973551</touristId>
    <ageCategory>Adult</ageCategory>
</ServiceTourist>
<ServiceTourist>
    <serviceId>77699386</serviceId>
    <touristId>28973551</touristId>
    <ageCategory>Adult</ageCategory>
</ServiceTourist>
<ServiceTourist>
    <serviceId>77699386</serviceId>
    <touristId>28973550</touristId>
    <ageCategory>Adult</ageCategory>
</ServiceTourist>
<ServiceTourist>
    <serviceId>77699385</serviceId>
    <touristId>28973551</touristId>
    <ageCategory>Adult</ageCategory>
</ServiceTourist>
<ServiceTourist>
    <serviceId>77699385</serviceId>
    <touristId>28973550</touristId>
    <ageCategory>Adult</ageCategory>
</ServiceTourist>
<ServiceTourist>
    <serviceId>77699384</serviceId>
    <touristId>28973550</touristId>
    <ageCategory>Adult</ageCategory>
</ServiceTourist>
<ServiceTourist>
    <serviceId>77699384</serviceId>
    <touristId>28973551</touristId>
    <ageCategory>Adult</ageCategory>
</ServiceTourist>
<ServiceTourist>
    <serviceId>77699390</serviceId>
    <touristId>28973551</touristId>
    <ageCategory>Adult</ageCategory>
</ServiceTourist>
<ServiceTourist>
    <serviceId>77699390</serviceId>
    <touristId>28973550</touristId>
    <ageCategory>Adult</ageCategory>
</ServiceTourist>
<ServiceTourist>
    <serviceId>77699389</serviceId>
    <touristId>28973550</touristId>
    <ageCategory>Adult</ageCategory>
</ServiceTourist>
<ServiceTourist>
    <serviceId>77699389</serviceId>
    <touristId>28973551</touristId>
    <ageCategory>Adult</ageCategory>
</ServiceTourist>
<ServiceTourist>
    <serviceId>77699388</serviceId>
    <touristId>28973551</touristId>
    <ageCategory>Adult</ageCategory>
</ServiceTourist>
<ServiceTourist>
    <serviceId>77699388</serviceId>
    <touristId>28973550</touristId>
    <ageCategory>Adult</ageCategory>
</ServiceTourist>

Возможные значения статусов услуг в заявке (английское название - русское название):

Release - Снята
Regret - Отказ
Cancel - Аннуляция
InProgress - В работе
Confirmed - Подтверждена
Fine - Штраф

<TimeLimit>
  <type>128770</type>
  <value>26.01.2013 13:00</value>
</TimeLimit>

Настройки

XML-шлюз. Структура заявки

Элемент OrderType

Элемент Country

Элемент Summary

Элемент Tourist

Элемент Residence

Элемент Transfer

Элемент Ticket

Элемент Insurance

Элемент Visa

Элемент Excursion

Элемент ExtraService

Элемент Comment

Элемент ServiceLanguage

Элемент ServiceTourist

Элемент TimeLimit