Интеграция с API СберТранспорт

В ТМ реализована интеграция с 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. Он используется при обращении в техническую поддержку Сбера и сохраняется в комментарии к заказу отдельной строкой после комментария, указанного сотрудником Сбера при создании заказа.

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

Чтобы посмотреть историю изменений - нажмите на кнопку «Развернуть» →

Версия Такси-Мастер	Месяц обновления	Внесенное изменение
ТМ 3.16.110	Июль 2026	Добавлена возможность подставлять в заказы из СберТранспорт разные значения клиента, заказчика и группы экипажей в зависимости от компании-заказчика. В разделе «Файл → Настройки → TM API → СберТранспорт → Параметры заказа» в карточку редактирования правила добавлено поле «Префикс Сбер ИД заказа». В нём можно указать префикс, используемый в заказах определённой компании-заказчика.
ТМ 3.16.110	Июль 2026	Изменен состав данных о водителе, передаваемых в СберТранспорт: в качестве имени используется значение поля «Имя для клиента» из карточки водителя; если поле «Имя для клиента» не заполнено, передаётся значение поля «Ф.И.О.»; дополнительно передаётся рейтинг водителя.
ТМ 3.16.110	Июль 2026	Поддерживается новый формат получения заказов из СберТранспорт. В новом формате для каждого адреса передаются сведения о пассажирах, которые садятся или выходят на этом адресе. Данные пассажиров сохраняются в заказе следующим образом: номер телефона первого пассажира, указанного для первого адреса, сохраняется как основной номер телефона заказа; Сбер ИД заказа, комментарий из СберТранспорт и сведения об остальных пассажирах добавляются в комментарий к заказу.
ТМ 3.15.122	Сентябрь 2025	Реализован новый запрос в SberTransportAPI. В новом запросе можно запросить координаты водителей и время до подачи сразу по нескольким заказам.
ТМ 3.15.122	Сентябрь 2025	В "Файл / Настройки / TM API / СберТранспорт / Параметры заказа" сейчас можно задать параметры, какой клиент, заказчик и группа экипажей будут подставляться в заказ из СберТранспорт в зависимости от региона, организации, вида услуги и класса заказа, полученных в запросе от СберТранспорт. В версии ТМ 3.15.122 еще было добавлено, чтобы выбор клиента, заказчика и группы экипажей мог зависеть от ИНН организации, полученной в запросе от СберТранспорт.

Ищут также: СберТранспорт API, API СберТранспорт, Интеграция СберТранспорт, Подключение СберТранспорт, SberTransport API, Sber Transport API, Сбер Транспорт API, Сбер Транспорт, API Сбер Транспорт, Интеграция с СберТранспорт, Интеграция с Сбер Транспорт, СберТранспорт интеграция, СберТранспорт подключение, Сбер Transport Integration, SberTransport integration, SberTransport подключение, СберТранспорт, Sber Transport, СБЕРТРАНСПОРТТЕСТ