Получение информации по заявкам туристического оператора «Библио Глобус» в формате XML

1. Получение списка заявок агентства

По умолчанию показываются только заявки, у которых дата начала тура не раньше текущей.
Для получения списка заявок в формате XML необходимо выполнить следующий запрос:
http://www.bgoperator.ru/rservice?task=agToursXML

Формат ответа:
<tours serverTime="06.11.2013 13:14:09">
  <tour id="104400000000000001" num="123456789" dateStart="17.12.2013" dateEnd="27.12.2013">
    <country id="100410000051">Таиланд</country>
    <tourStat id="9">Подтверждено</tourStat>
    <currency>USD</currency>
    <debt>-0.02</debt>
    <cost>1842</cost>
    <commission>221</commission>
    <costToPay>1621</costToPay>
    <payed>1621.02</payed>
    <payStatus>переплачено</payStatus>
  </tour>
  <tour id="104400000000000012" num="123456777" dateStart="19.12.2013" dateEnd="28.12.2013">
    <country id="100410000049">Кипр</country>
    <tourStat id="9">Подтверждено</tourStat>
    <currency>EUR</currency>
    <debt>0</debt>
    <cost>1850</cost>
    <commission>50</commission>
    <costToPay>1750</costToPay>
    <payed>1750</payed>
    <payStatus>оплачено</payStatus>
  </tour>
  …<br>
</tours>

tour — объект заявки
tour / id — идентификатор заявки
tour / num — номер заявки
tour / dateStart — дата начала заявки
tour / dateEnd — дата окончания заявки
tour / country — страна заявки
tour / country / id — идентификатор страны заявки
tour / tourStat — состояние заявки
tour / tourStat / id — идентификатор состояния заявки
tour / currency — валюта заявки
tour / debt — сумма долга по заявке
tour / cost — стоимость заявки
tour / commission — сумма комиссии
tour / costToPay — сумма к оплате
tour / payed — сумма оплаты
tour / payStatus — состояние оплаты

Список значений состояния заявки:
1Подбор тура
2Рассматривается оператором
3Принята на бронирование
4Отказ по отелю
5Лист ожидания
6Отказ по билетам
7Отказ по классу перелета
8Отказ по круизу
9Подтверждено
10Не подтверждено
11Принята на перебронирование
12В базе уже существует данное бронирование, свяжитесь с менеджером
13Принята на аннуляцию
14Принят запрос на восстановление заявки
17Принята на перебронирование
18Принята на перебронирование
19Принята на перебронирование
20Принята на перебронирование
21Отказ по номеру
27Аннуляция. Ждите решения о фактических затратах
28Аннуляция подтверждена без фактических затрат
29Аннуляция подтверждена с фактическими затратами
30Заявка удалена, свяжитесь с менеджером

Список значений состояния оплаты:
не оплачено
оплачено
недоплачено
переплачено
выставлен штраф

1.1. Расширение параметров и фильтрация списка заявок

Дополнительные параметры запроса, позволяющие отфильтровать получаемый список заявок.

dateStart — дата начала тура, формат DD.MM.YYYY
Пример: добавление &dateStart=12.12.2014 к строке запроса вернет заявки, у которых дата начала тура не ранее 12.12.2014

dateEnd — дата окончания тура, используется только вместе с параметром dateStart, формат DD.MM.YYYY
Пример: добавление &dateEnd=12.12.2014 к строке запроса вернет заявки, у которых дата окончания тура не позднее 12.12.2014

flt — 12-значный идентификатор страны заявки (процесс получения идентификаторов стран описан в инструкции по выгрузке цен)
Пример: добавление &flt=100410000049 к строке запроса вернет заявки по направлению Кипр

2. Получение детальной информации по заявке

Для получения информации по конкретной заявке в формате XML необходимо выполнить следующий запрос:
http://www.bgoperator.ru/rservice?task=tourInfo&idTour=104400003037157369&dataType=xml
где 1044000000000000002 — 18-значный идентификатор заявки

createDate - дата создания заявки
office / id - идентификатор офиса Библио Глобуса
currency - валюта заявки
commission - сумма комиссии агентства в валюте заявки (currency)

tourDocuments - документы по туру (для всех туристов)
tourDocuments / doc / type - тип документа (см. значения типов)
tourDocuments / doc / docName - название документа
tourDocuments / doc / link - ссылка на документ
tourDocuments / doc / ext - расширение файла, содержащего документ

allDocsExists - секция отвечающая за наличие документов
allDocsExists / validated - флаг, показывающий, что собраны все документы; значение - true/false
allDocsExists / errors - описание ошибок
allDocsExists / anyDocExists - флаг, показывающий, что есть хотя бы один документ по туру; значение - true/false

tourTemplate / route - маршрут тура
tourTemplate / avia - авиакомпания тура

owner / id - идентификатор агентства (в системе Библио Глобус), создавшего заявку

tourists - список туристов в заявке
tourists / tourist / id - идентификатор туриста в системе Библио Глобус
tourists / tourist / firstname - имя туриста
tourists / tourist / lastname - фамилия туриста
tourists / tourist / birthDate - дата рождения туриста в формате DD.MM.YYYY
tourists / tourist / passport - номер паспорта туриста

tourists / tourist / visa - информация о визе текущего туриста
tourists / tourist / visa / exists - флаг, показывающий, что гражданам РФ необходимо получать визу в страну тура; значение - true/false
tourists / tourist / visa / status - статус визы (см. возможные значения статуса визы)

tourists / tourist / visa / fillingDate - дата подачи документов на визу
tourists / tourist / visa / outputDate - предполагаемая дата выдачи визы

tourists / tourist / flights - информация об авиарейсах
tourists / tourist / flights / flight / id - идентификатор рейса в системе Библио Глобус
tourists / tourist / flights / flight / num - номер рейса
tourists / tourist / flights / flight / codeCompany - код авиакомпании
tourists / tourist / flights / flight / flClass - класс перелёта
tourists / tourist / flights / flight / tickNum - номер авиабилета; элемент заполнен, если билет был выписан
tourists / tourist / flights / flight / seat - место; элемент заполнен, если турист прошел регистрацию на рейс через систему Библио Глобус
tourists / tourist / flights / flight / pnr - номер брони (может быть пустым)
tourists / tourist / flights / flight / dateTimeFlight - время вылета
tourists / tourist / flights / flight / dateTimeArrive - время прибытия
tourists / tourist / flights / flight / timeInWay - длительность перелёта
tourists / tourist / flights / flight / airportFrom - аэропорт отправления
tourists / tourist / flights / flight / cityFrom - город отправления
tourists / tourist / flights / flight / airportTo - аэропорт назначения
tourists / tourist / flights / flight / cityTo - город назначения
tourists / tourist / flights / flight / status - статус авиабилета
tourists / tourist / flights / flight / regOpen - флаг, показывающий, что регистрация на рейс открыта; значение - true/false

tourists / tourist / accommodations - информация о размещениях в отелях
tourists / tourist / accommodations / acc / dateStart - дата заезда в отель
tourists / tourist / accommodations / acc / dateEnd - дата выезда из отеля
tourists / tourist / accommodations / acc / ns - название номера, тип питания, вид из окна (например, "DELUXE CLUB ROOM BB")
tourists / tourist / accommodations / acc / roomNum - порядковый номер номера отеля внутри текущей заявки (например, 2)
tourists / tourist / accommodations / acc / status - статус бронирования номера (см. возможные значения статуса бронирования номеров)

tourists / tourist / accommodations / acc / hotel / id - идентификатор отеля в системе Библио Глобус (см. соответствующий справочник)
tourists / tourist / accommodations / acc / hotel / category - звёздность отеля

tourists / tourist / accommodations / acc / city / id - идентификатор города отеля в системе Библио Глобус (см. соответствующий справочник)
tourists / tourist / accommodations / acc / country / id - идентификатор страны отеля в системе Библио Глобус (см. соответствующий справочник)
tourists / tourist / accommodations / acc / nights - количество ночей пребывания в отеле

tourists / tourist / accommodations / acc / guide - имя фамилия гида
tourists / tourist / accommodations / acc / guide / phone - телефон гида
tourists / tourist / accommodations / acc / guide / meetingTime - время встречи с гидом в день приезда

tourists / tourist / insurance - информация о страховках
tourists / tourist / insurance / med / dateStart - дата начала срока страхования медицинской страховки
tourists / tourist / insurance / med / dateEnd - дата окончания срока страхования медицинской страховки
tourists / tourist / insurance / med / sum - страховая сумма
tourists / tourist / insurance / med / class - класс страховки; значения - "ECONOM-CLASS","BUSINESS-CLASS","VIP-CLASS"
tourists / tourist / insurance / med / currency - валюта страховой суммы

tourists / tourist / insurance / cancelPolicy - наличие у туриста страховки от невыезда; значение - true/false

tourists / tourist / transfers - информация о трансферах
tourists / tourist / transfers / transfer / date - дата трансфера
tourists / tourist / transfers / transfer / id - идентификатор трансфера в системе Библио Глобус

tourists / tourist / transfers / transfer / status - статус трансфера; значения - "есть трансфер","отказ от услуги","без трансфера"
tourists / tourist / transfers / transfer / type - тип трансфера; (например, "груповой / автобус")
tourists / tourist / transfers / transfer / name - название трансфера

tourists / tourist / excursions - информация об экскурсиях по заявке
tourists / tourist / excursions / excursion / id - идентификатор экскурсии в системе Библио Глобус
tourists / tourist / excursions / excursion / isPackage - флаг, показывающий, что эта экскурсия является пакетом экскурсий
tourists / tourist / excursions / excursion / date - дата экскурсии
tourists / tourist / excursions / excursion / desc - описание экскурсии
tourists / tourist / excursions / excursion / pickUpTime - время сбора
tourists / tourist / excursions / excursion / pickUpName - место сбора
tourists / tourist / excursions / excursion / remarks - примечания

tourists / tourist / addServices - информация о доп. услугах по заявке
tourists / tourist / addServices / addService / id - идентификатор доп. услуги в системе Библио Глобус
tourists / tourist / addServices / addService / date - дата доп. услуги
tourists / tourist / addServices / addService / name - название доп. услуги
tourists / tourist / addServices / addService / remarks - примечания

tourists / tourist / carRentals - информация об аренде автомобилей
tourists / tourist / carRentals / carRental / id - идентификатор аренды автомобиля в системе Библио Глобус
tourists / tourist / carRentals / carRental / date - дата начала аренды автомобиля
tourists / tourist / carRentals / carRental / name - название аренды автомобиля
tourists / tourist / carRentals / carRental / duration - длительность аренды автомобиля в днях
tourists / tourist / carRentals / carRental / remarks - примечания

tourists / tourist / docs - описание документов тура, связанных с текущим туристом
tourists / tourist / docs / doc / type - тип документа (см. значения типов)
tourists / tourist / docs / doc / docName - название документа
tourists / tourist / docs / doc / link - ссылка на документ
tourists / tourist / docs / doc / ext - расширение файла

tourists / tourist / tourComposition - состав тура по хронологии (например, "Авиаперелет, Трансфер, Проживание, Трансфер, Авиаперелет, Виза, Медицинская страховка")
tourists / tourist / tourComposition / item - название элемента
tourists / tourist / tourComposition / item / date - дата элемента

Типы документов: Ниже приведены часто используемые типы документов. Список может расширяться
Памятка туриста
Групповой обменный ваучер
Виза
Провиза
Страховой полис
Электронный авиабилет
Посадочный талон Трансаэро

Список значений статуса визы:
0<Пусто>
1не требуется
2надо оформить
3надо оформить провизу
4надо оформить визу
5виза в Спб
6приняты документы
7сданы документы
8Собеседование
9провиза
10приняты документы online
11отказ
12ok
13ok - провиза
14виза регион
15в ОАЭ
16в обработке
17ok - не требуется

Список значений статусов бронирования номеров:
подбор тура
бронирование
подтверждено
не подтверждено
без проживания
аннуляция
аннулировано