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

Версия 12:14, 15 марта 2023

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

Для работы интеграции Сберу надо передать следующие данные:

• логин и пароль (их можно придумать самостоятельно)
• адрес для отправки запросов в таком виде: https://IP:PORT/sber_transport_api/1.0 (IP-адрес можно посмотреть на сайте ping.eu, а порт в «Файл / Настройки / TM API/поле "Локальный порт"»)

Чтобы в Такси-Мастер появились настройки данного функционала, необходимо в лицензионный ключ добавить (прошить) специальную опцию "СберТранспорт". Для добавления обратитесь к персональному менеджеру.

После этого в Такси-Мастер появится страница настроек «Файл / Настройки / TM API / СберТранспорт».

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

• Использовать СберТранспорт - включение интеграции со СберТранспорт.
• Логин и Пароль - данные, которые организация генерирует самостоятельно и передает в Сбер. Они будут проверяться при обработке запросов из Сбера.
• Состояние заказа при отмене заказа клиентом - в это состояние будет переводиться заказ, когда от Сбера приходит запрос отмены заказа.
• Атрибут расстояния по заказу (не обязательная настройка) - специальный числовой атрибут, который можно будет привязывать к заказу, чтобы оператор при ручном закрытии заказа смог вручную заполнить в этом атрибуте значение километража. Если значение атрибута будет 0, то в Сбер будет передаваться обычное значение фактического километража, полученное от TMDriver.
• Параметры заказа - правила определения значения полей заказа "Клиент", "Заказчик" и "Группа экипажей", когда от Сбера приходит новый заказ.

Подробности настройки правил:

Сбер в новом заказе также передает 2 таких поля:

• workGroup - рабочая группа, которая состоит из 3 значений: Организация, Вид услуги и Регион, разделенные символом "/", например: "Тестовая организация 01/перевозка_пассажиров/Воронеж". На данный момент виды услуги могут быть такие: "перевозка_пассажиров", "перевозка_грузов", "ремонт".
• class - класс заказа, может иметь варианты: "ECONOMY" (Эконом), "COMFORT" (Комфорт), "COMFORT_PLUS" (Комфорт+), "BUSINESS" (Бизнес).

В зависимости от тех значений, которые придут в полях workGroup и class, в карточку заказа можно подставлять различные значения Клиента, Заказчика и Группы экипажей.

В карточке редактирования правила первые 4 поля определяют фильтр входных данных по заказу из Сбера для использования данного правила. Для того, чтобы правило было применено, значение каждого поля фильтра должно быть пустым или оно должно совпадать с соответствующим значением, полученным в заказе из Сбера. Правила проверяются по порядку от первого до последнего, пока не будет найдено подходящее по фильтрам правило. И когда нужное правило найдено, то в карточку нового заказа будут подставляться значения Клиента, Заказчика и Группы экипажей, указанные в правиле. В самом последнем правиле все поля фильтров должны быть пустыми, чтобы данное правило применялось всегда, если не применились все остальные правила.

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

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

• Для заказов из СберТранспорт будет задаваться особое значение поля "Источник заказа": "СберТранспорт". Также в системных событиях в условии "Заказ: способ создания заказа" будет доступно значение "СберТранспорт".
• Заказы из Сбера будут создаваться в состоянии из настройки «Файл / Настройки / Заказы / Состояния заказа / Состояние нового веб-заказа».
• В заказах из Сбера будет приходить специальный ИД заказа (например, ТТ-ОТ-0001-00006764), который надо будет использовать при общении с техподдержкой Сбера. Этот ИД заказа будет записываться в поле комментария заказа отдельной строкой сразу после комментария, который указывал сотрудник Сбера при создании заказа.

Дополнительная информация

Чтобы передать адрес для отправки запросов, необходимо знать:

• Внешний IP-адрес (желательно, чтобы он был статическим).
• Локальный порт API.

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

Если вы по какой-то причине не знаете свой внешний IP-адрес, то можете узнать его с помощью сервиса Ping.eu (http://ping.eu).

Для этого откройте в браузере http://ping.eu — на главной странице в верхней части будет ваш IP-адрес, например, в таком виде:

Your IP is 192.168.2.24 

То есть ваш IP-адрес 192.168.2.24

Как узнать Локальный порт API?

Локальный порт API указывается в соответствующем поле в «Файл / Настройки / TM API/».