Просмотр исходного текста страницы Интеграция с API СберТранспорт

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


Для работы интеграции Сберу надо передать следующие данные:
* логин и пароль (их можно придумать самостоятельно)
* адрес для отправки запросов в таком виде: <nowiki>https://IP:PORT/sber_transport_api/1.0</nowiki> (IP-адрес можно посмотреть на сайте ping.eu, а порт в {{путь|Файл / Настройки / TM API/поле "Локальный порт"}})


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


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

[[Файл:Файл Настройки TM API СберТранспорт.png|обрамить|центр]]

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

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

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

[[Файл:Правила определения значения полей заказа от сбера.png|обрамить|центр]]

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

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

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

== Дополнительная информация ==
Чтобы передать адрес для отправки запросов, необходимо знать:
* Внешний IP-адрес (желательно, чтобы он был статическим).
* Локальный порт API.

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

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

 Your IP is 8.8.8.8 

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

=== Как узнать Локальный порт API? ===
Локальный порт API указывается в соответствующем поле в {{путь|Файл / Настройки / TM API/}}.

[[Файл:Как узнать Локальный порт API.png|обрамить|центр]]

[[Категория:Настройка]]
[[Категория:Параметры ТМ]]