Получение информации по заявкам туристического оператора «Библио Глобус» в формате 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>
Для получения списка заявок в формате JSON необходимо выполнить следующий запрос:
http://www.bgoperator.ru/rservice?task=agToursXML&json=true
Формат ответа:
{
"tours": {
"serverTime": "06.11.2013 13:14:09",
"tour": [
{
"id": "104400000000000001",
"num": "123456789",
"dateStart": "17.12.2013",
"dateEnd": "27.12.2013",
"country": {
"id": "100410000051",
"name": "Таиланд"
},
"tourStat": {
"id": "9",
"stat": "Подтверждено"
},
"currency": "USD",
"debt": "-0.02",
"cost": "1842",
"commission": "221",
"costToPay": "1621",
"payed": "1621.02",
"payStatus": "переплачено"
},
{
"id": "104400000000000012",
"num": "123456777",
"dateStart": "19.12.2013",
"dateEnd": "28.12.2013",
"country": {
"id": "100410000049",
"name": "Кипр"
},
"tourStat": {
"id": "9",
"stat": "Подтверждено"
},
"currency": "EUR",
"debt": "0",
"cost": "1850",
"commission": "50",
"costToPay": "1750",
"payed": "1750",
"payStatus": "оплачено"
},
…
]
}
}
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?idTour=104400003037157369&task=tourInfo&dataType=xml
Для получения информации по конкретной заявке в формате JSON необходимо выполнить следующий запрос:
http://www.bgoperator.ru/rservice?idTour=104400003037157369&task=tourInfo&dataType=json
где 1044000000000000002 — 18-значный идентификатор заявки
Внимание! Важно, чтобы параметр idTour был первым в строке запроса
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 | отказ |
12 | ok |
13 | ok - провиза |
14 | виза регион |
15 | в ОАЭ |
16 | в обработке |
17 | ok - не требуется |
Список значений статусов бронирования номеров:
подбор тура |
бронирование |
подтверждено |
не подтверждено |
без проживания |
аннуляция |
аннулировано |