Интеграция с API СберТранспорт — различия между версиями

Текущая версия на 13:47, 7 августа 2026

В ТМ реализована интеграция с API СберТранспорт для перевозки сотрудников Сбера.

Для использования интеграции в лицензионный ключ ТМ должна быть добавлена лицензия «СберТранспорт». Для её подключения обратитесь к персональному менеджеру.

Настройка интеграции

После добавления лицензии в ТМ станет доступен раздел ««Файл → Настройки → TM API → СберТранспорт»».

На странице доступны следующие настройки:

• Использовать СберТранспорт — включает интеграцию со СберТранспорт.

• Логин и Пароль — данные для авторизации запросов от Сбера. Логин и пароль организация задаёт самостоятельно и передаёт Сберу.

• Состояние заказа при отмене заказа клиентом — состояние, в которое переводится заказ при получении от Сбера запроса на его отмену.

• Атрибут расстояния по заказу — необязательная настройка. Позволяет выбрать числовой атрибут заказа для ручного указания километража при закрытии заказа оператором. Если значение атрибута равно 0, в Сбер передаётся фактический километраж, полученный от TMDriver.

• Параметры заказа — правила, по которым для заказов, поступающих из СберТранспорт, определяются значения полей «Клиент», «Заказчик» и «Группа экипажей».
  

Для выбора подходящего правила используются данные, передаваемые из СберТранспорт:

• Организация, Вид услуги и Регион — значения из поля workGroup. В запросе они передаются через символ «/», например: «Тестовая организация 01/перевозка_пассажиров/Воронеж». Вид услуги может принимать значения «перевозка_пассажиров», «перевозка_грузов» или «ремонт».

• Класс заказа — значение поля class. Возможные значения:
  • «ECONOMY» — Эконом;
  • «COMFORT» — Комфорт;
  • «COMFORT_PLUS» — Комфорт+;
  • «BUSINESS» — Бизнес.

• ИНН перевозчика — ИНН компании-перевозчика, полученный в запросе от СберТранспорт. Условие можно использовать, если на одном сервере ТМ работают несколько перевозчиков. Например, для заказов разных перевозчиков можно назначать разные группы экипажей.

• Префикс Сбер ИД заказа — префикс идентификатора заказа, используемый для определения компании-заказчика. Например, для Сбер ИД «TT-OT-0613-00000146» префиксом является «TT-OT-0613». Для заказов одной компании-заказчика используется одинаковый префикс.

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

При поступлении заказа ТМ проверяет правила по порядку — от первого к последнему. Правило считается подходящим, если каждое заданное в нём условие совпадает с соответствующим значением поступившего заказа. Незаполненные условия при проверке не учитываются.

После нахождения подходящего правила проверка прекращается. В заказ подставляются значения полей «Клиент», «Заказчик» и «Группа экипажей», указанные в этом правиле.

В последнем правиле рекомендуется оставить все условия незаполненными. Такое правило будет применяться к заказам, для которых не подошло ни одно из предыдущих правил.

• Правила преобразования номеров телефона из формата Сбер в формат ТМ

• Отладочный режим - если данная опция включена, то в лог «Logs\TMAPI\SberTransportAPI.log» будут записываться все данные по входящим запросам и ответам. Иначе - в лог будет попадать минимальный набор данных по запросам.

Данные для подключения интеграции

После настройки интеграции передайте Сберу данные для подключения:

• Логин и Пароль, заданные в настройках интеграции.

• Адрес для отправки запросов в формате https://IP:PORT/sber_transport_api/1.0, где:
  • IP — внешний IP-адрес (желательно, чтобы он был статическим);
  • PORT — значение поля «Локальный порт» в разделе ««Файл → Настройки → TM API»».

Как узнать внешний IP-адрес?

Узнать внешний IP-адрес сервера можно с помощью сервиса 2IP (2ip.ru).

Особенности работы с заказами из СберТранспорт

• Для заказов, поступивших из СберТранспорт, в поле «Источник заказа» автоматически устанавливается значение «СберТранспорт». Это же значение доступно в системных событиях в условии «Заказ: способ создания заказа».

• Заказы из СберТранспорт создаются в состоянии, указанном в настройке ««Файл → Настройки → Заказы → Состояния заказа → Состояние нового веб-заказа»».

• Вместе с заказом передаётся Сбер ИД, например ТТ-ОТ-0001-00006764. Он используется при обращении в техническую поддержку Сбера и сохраняется в комментарии к заказу отдельной строкой после комментария, указанного сотрудником Сбера при создании заказа.

История изменений