Экспорт данных по заявкам

API для экспорта заявок из личного кабинета TourVisor

Экспорт данных по заявкам

Вы можете экспортировать данные по заявкам из личного кабинета TourVisor.
Для использования экспорта необходимо получить API ключ.
Данный ключ Вы можете получить, обратившись в техподдержку TourVisor.

Быстрый пример - выгрузка последних заявок в CSV (можно открыть в Excel):
https://tourvisor.ru/xml/orders.php?authkey=YOURKEY&format=csv
где вместо YOURKEY нужно вставить Ваш API ключ.

Экспорт обычных заявок

Производится GET-запросом на адрес:
https://tourvisor.ru/xml/orders.php

Параметры

  • authkey (обязательно)- API-ключ для авторизации.
  • format - формат выдачи (xml / json / csv), по умолчанию = xml
  • id - получить конкретную заявку по ID
  • limit - ограничение на количество выгружаемых заявок (по умолчанию = 100)
  • lastid - получить все заявки "свежее" указанного идентификатора (удобно для загрузки новых заявок)

Примеры

Получить конкретную заявку по ее идентификатору:
https://tourvisor.ru/xml/orders.php?authkey=YOURKEY&id=453284

Получить последние 5 заявок в формате CSV (откроются сразу в Excel):
https://tourvisor.ru/xml/orders.php?authkey=YOURKEY&limit=5&format=csv

Результат

{
  "orders": {
    "order": [
      {
        "id": "1688615", - идентификатор заявки в системе TourVisor
        "date": "05.12.2018", - дата поступления заявки
        "time": "11:05:51", - время поступления заявки
        "name": "Вася", - имя клиента
        "phone": "34534534", - телефон клиента
        "email": "", - почта клиента
        "comments": "", - комментарии клиента
        "price": "70266", - окончательная стоимость тура
        "fuelcharge": "0", - сумма топливного сбора
        "currency": "RUB", - валюта (RUB / USD / EUR / KZT / BYN / UAH)
        "operator": "Sunmar", - туроператор
        "departure": "Пермь", - город вылета
        "country": "Таиланд", - страна тура
        "region": "Пхукет", - курорт
        "hotel": "APK RESORT 3*", - название отеля
        "flydate": "11.12.2018", - дата вылета
        "nights": "11", - общая длительность тура в ночах
        "placement": "2 взр", - размещение (количество взрослых и детей)
        "meal": "Без питания", - тип питания
        "room": "standard room", - тип комнаты
        "tour": "о.Пхукет", - название тура (в системе туроператора)
        "operatorlink": "http://bron.sunmar.ru/UI/Package/Search.aspx?Destination=33&FromArea=2763&Hotel=4754&DateBeg=11.12.2018&DateEnd=11.12.2018&NightBeg=11&NightEnd=11&Adl=2&Chd=0&PartnerID=75921", - ссылка на систему бронирования оператора
        "officename": "г. Куйбышева 95б", - название офиса (если подключен модуль Многоофисность и клиент выбрал офис
        "officeid": "630", - идентификатор офиса
        "officecity": "Москва", - город офиса
        "istour": "1", - заявка на конкретный тур (могут быть заявки без указания конкретного тура)
        "type": "0", - идентификатор вида заявки (см ниже)
        "typename": "Заявка на тур", - вид заявки
        "domain": "tourcompany.ru" - адрес сайта (домен), с которого поступила заявка (если заявки поступают с нескольких сайтов)
      }
    ]
  }
}

Виды заявок:

  • 0 - Заявка на тур
  • 1 - Заявка на подбор тура
  • 2 - Заявка на подбор тура
  • 3 - Заявка из целевой страницы
  • 4 - Заявка из корзины туров
  • 5 - Заявка из своих предложений
  • 6 - Заявка из кнопки

Экспорт онлайн заявок

Производится GET-запросом на адрес:
https://tourvisor.ru/xml/ordersonline.php

Параметры

  • authkey (обязательно)- API-ключ для авторизации.
  • format - формат выдачи (xml / json), по умолчанию = json
  • id - получить конкретную заявку по ID
  • limit - ограничение на количество выгружаемых заявок (по умолчанию = 100)
  • lastid - получить все заявки "свежее" указанного идентификатора (удобно для загрузки новых заявок)

Примеры

Получить конкретную заявку по ее идентификатору:
https://tourvisor.ru/xml/ordersonline.php?authkey=YOURKEY&id=453284

Получить последние 5 заявок в формате JSON:
https://tourvisor.ru/xml/ordersonline.php?authkey=YOURKEY&limit=5

Результат

{
  "orders": {
    "order": [
      {
        "id": "111333", - идентификатор заявки в системе TourVisor
        "date": "11.12.2018", - дата поступления заявки
        "time": "15:33:52", - время поступления заявки
        "surname": "Иванова", - фамилия заказчика
        "name": "Ольга", - имя заказчика
        "otch": "Ивановна", - отчество заказчика
        "address": "г. Екатеринбург, ул.Ленина, 33-45", - адрес заказчика
        "phone": "891111133333", - телефон заказчика
        "email": "testmail@yandex.ru", - почта заказчика
        "comments": "", - комментарии к заявке
        "operator": "Pegas", - туроператор
        "departure": "Екатеринбург", - город вылета
        "country": "Таиланд", - страна
        "flydate": "03.01.2019", - дата вылета
        "nights": "11", - общая длительность тура в ночах
        "tour": "Pattaya (Ekaterinburg) Promo Price RL", - название тура (в системе туроператора)
        "price": "197700", - окончательная стоимость тура
        "currency": "RUB", - валюта (RUB / USD / EUR / KZT / BYN / UAH)
        "operatorlink": "https://pegast.ru/agency/private/pegasys/booking?hash=8aU3IDa8NyB1szcgYhVJIq2bNiAHrDcgGK03IFGuNyCKrzcg4bA3IOZMiSfJkTcgALg3IKOuNyD4tjcgnowhK2O5NyAfSLYykbs3IAa9NyAcSLYyKr83IKvANyDiwTcgG8M3IE7eNyCZ3zcg",
        "domain": "tourcompany.ru" - адрес сайта (домен), с которого поступила заявка (если заявки поступают с нескольких сайтов)
        "tourist": [ - массив с данными туристов
          {
            "surname": "IVANOVA", - фамилия туриста
            "name": "OLGA", - имя туриста
            "gender": "female", - пол туриста (male или female)
            "passportseries": "11", - серия паспорта
            "passportnumber": "2222222", - номер паспорта
            "passportissuedate": "11.11.2018", - дата выдачи паспорта
            "passportenddate": "11.11.2028", - срок действия паспорта
            "passportissuedby": "MVD 111111", - кем выдан паспорт
            "passporttype": "0", - тип паспорта (0 - загран, 1 - российский паспорт)
            "birthdate": "11.11.1971", - дата рождения туриста
            "birthcountry": "Россия", - страна рождения
            "nationality": "Россия", - гражданство
            "is_client": "1", - является ли данный турист заказчиком (определяется по транслитерации имени заказчика) 1 (является) или 0 (не является)
            "visa": "0" - виза, если больше 0 - то к стоимости тура была прибавлена эта стоимость визы для конкретного туриста
          },
          {
            "surname": "TEST",
            "name": "TEST",
            "gender": "male",
            "passportseries": "22",
            "passportnumber": "333333",
            "passportissuedate": "10.10.2018",
            "passportenddate": "10.10.2028",
            "passportissuedby": "MVD 222222",
            "passporttype": "0",
            "birthdate": "10.10.1990",
            "birthcountry": "Россия",
            "nationality": "Россия",
            "is_client": "0",
            "visa": "0"
          }
        ],
        "hotel": [ - массив отелей (в будущем может быть несколько для комбинированных туров)
          {
            "name": "CENTRA MARIS RESORT JOMTIEN BY CENTARA 4*", - название отеля
            "country": "Таиланд", - страна
            "region": "Паттайя", - курорт
            "startdate": "04.01.2019", - дата заселения в отель
            "nights": "11", - длительность проживания в отеле в ночах
            "room": "centra superior", - тип комнаты
            "meal": "Завтрак", - тип питания
            "placement": "2 взрослых" - тип размещения
          }
        ],
        "transport": [ - массив перелетов
          {
            "direction": "1", - направление вылета (1 - туда, 2 - обратно)
            "number": "RL8571", - номер рейса
            "datefrom": "03.01.2019", - дата вылета
            "dateto": "04.01.2019", - дата прилета
            "timefrom": "23:45:00", - время вылета
            "timeto": "10:10:00", - время прилета
            "aircompany": "Royal Flight", - авиакомпания
            "plane": "Boeing 767-300ER", - самолет
            "terminalfrom": "Екатеринбург", - название терминала вылета
            "terminalto": "Утапао", - название терминала прилета
            "terminalcodefrom": "SVX", - код терминала вылета
            "terminalcodeto": "UTP" - код терминала прилета
          },
          {
            "direction": "2",
            "number": "RL8572",
            "datefrom": "15.01.2019",
            "dateto": "15.01.2019",
            "timefrom": "10:00:00",
            "timeto": "16:45:00",
            "aircompany": "Royal Flight",
            "plane": "Boeing 767-300ER",
            "terminalfrom": "Утапао",
            "terminalto": "Екатеринбург",
            "terminalcodefrom": "UTP",
            "terminalcodeto": "SVX"
          }
        ],
        "service": [ - массив услуг, включенных в стоимость тура
          {
            "name": "Медицинская страховка"
          },
          {
            "name": "Трансфер аэропорт - отель - аэропорт"
          }
        ]
      }
    ]
  }
}

Уведомление о поступлении новых заявок (WebHook)

Возможно настроить уведомление Вашей системы о поступлении новых заявок через WebHook.
Как добавить адрес для уведомлений, см. в следующем разделе.

После этого Ваш адрес будет вызываться каждый раз при поступлении новой заявки.
При этом передаются следующие параметры (GET запрос):

  • id - идентификатор заявки в системе TourVisor
  • type - тип заявки (0 - обычная, 1 - онлайн)

Обратите внимание, что обычные и онлайн заявки имеют разную нумерацию и разные способы выгрузки (экспорта)

Затем Вы можете по идентификатору заявки выгрузить ее данные и сохранить их в Вашей системе.

Пример вызова:
https://yourtoursite.ru/importfromtourvisor?id=3322&type=0

Добавление адреса для уведомлений (WebHook)

Для того, чтобы добавить адрес для уведомлений (webhook), необходимо сделать POST запрос на адрес:
https://tourvisor.ru/xml/webhooks.php

в теле POST передать JSON:

{"authkey": "AUTHKEY", "url": "WEBHOOK"}

где

  • authkey - API-ключ для авторизации.
  • url - адрес для уведомления Вашей системы о поступлении новых заявок

Если передать ключ (authkey), но пустой адрес (url), то webhook для данного клиента удаляется.