Интеграция с API СберТранспорт — различия между версиями
(Новая страница: «В Такси-Мастер реализована интеграция с '''API СберТранспорт''' (перевозка сотрудников Сбер…») |
(Добавлены синонимы для поисковой системы) |
||
| (не показаны 4 промежуточные версии этого же участника) | |||
| Строка 1: | Строка 1: | ||
| + | |||
В Такси-Мастер реализована интеграция с '''API СберТранспорт''' (перевозка сотрудников Сбера). | В Такси-Мастер реализована интеграция с '''API СберТранспорт''' (перевозка сотрудников Сбера). | ||
| + | {{Синонимы|СберТранспорт API, SberTransport API, Сбер Транспорт API, Интеграция СберТранспорт, СБЕРТРАНСПОРТТЕСТ}} | ||
| Строка 51: | Строка 53: | ||
Для этого откройте в браузере http://ping.eu — на главной странице в верхней части будет ваш IP-адрес, например, в таком виде: | Для этого откройте в браузере http://ping.eu — на главной странице в верхней части будет ваш IP-адрес, например, в таком виде: | ||
| − | Your IP is | + | Your IP is 8.8.8.8 |
| − | То есть ваш IP-адрес ''' | + | То есть ваш IP-адрес '''8.8.8.8''' |
=== Как узнать Локальный порт API? === | === Как узнать Локальный порт API? === | ||
| Строка 59: | Строка 61: | ||
[[Файл:Как узнать Локальный порт API.png|обрамить|центр]] | [[Файл:Как узнать Локальный порт API.png|обрамить|центр]] | ||
| + | |||
| + | |||
| + | === История изменений === | ||
| + | <div class="mw-collapsible mw-collapsed" style="background:#e0e8ff"> | ||
| + | Чтобы посмотреть историю изменений - нажмите на кнопку «Развернуть» → | ||
| + | <div class="mw-collapsible-content" style="background:#FFFFFF" > | ||
| + | {| class="wikitable" | ||
| + | |- | ||
| + | ! Версия Такси-Мастер !! Месяц обновления !! Внесенное изменение | ||
| + | |- | ||
| + | | ТМ 3.15.122 || Сентябрь 2025 || Реализован новый запрос в SberTransportAPI. В новом запросе можно запросить координаты водителей и время до подачи сразу по нескольким заказам. | ||
| + | |- | ||
| + | | ТМ 3.15.122 || || В "Файл / Настройки / TM API / СберТранспорт / Параметры заказа" сейчас можно задать параметры, какой клиент, заказчик и группа экипажей будут подставляться в заказ из СберТранспорт в зависимости от региона, организации, вида услуги и класса заказа, полученных в запросе от СберТранспорт. В версии ТМ 3.15.122 еще было добавлено, чтобы выбор клиента, заказчика и группы экипажей мог зависеть от ИНН организации, полученной в запросе от СберТранспорт. | ||
| + | |} | ||
| + | </div> | ||
| + | </div> | ||
| + | |||
| + | <div style="font-size: 0.3em; color: #f5f5f5;"> | ||
| + | Ищут также: СберТранспорт API, API СберТранспорт, Интеграция СберТранспорт, Подключение СберТранспорт, SberTransport API, Sber Transport API, Сбер Транспорт API, Сбер Транспорт, API Сбер Транспорт, Интеграция с СберТранспорт, Интеграция с Сбер Транспорт, СберТранспорт интеграция, СберТранспорт подключение, Сбер Transport Integration, SberTransport integration, SberTransport подключение, СберТранспорт, Sber Transport, СБЕРТРАНСПОРТТЕСТ | ||
| + | </div> | ||
[[Категория:Настройка]] | [[Категория:Настройка]] | ||
[[Категория:Параметры ТМ]] | [[Категория:Параметры ТМ]] | ||
Текущая версия на 17:51, 14 октября 2025
В Такси-Мастер реализована интеграция с 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 8.8.8.8
То есть ваш IP-адрес 8.8.8.8
Как узнать Локальный порт API?
Локальный порт API указывается в соответствующем поле в Файл / Настройки / TM API/.
История изменений
Чтобы посмотреть историю изменений - нажмите на кнопку «Развернуть» →
| Версия Такси-Мастер | Месяц обновления | Внесенное изменение |
|---|---|---|
| ТМ 3.15.122 | Сентябрь 2025 | Реализован новый запрос в SberTransportAPI. В новом запросе можно запросить координаты водителей и время до подачи сразу по нескольким заказам. |
| ТМ 3.15.122 | В "Файл / Настройки / TM API / СберТранспорт / Параметры заказа" сейчас можно задать параметры, какой клиент, заказчик и группа экипажей будут подставляться в заказ из СберТранспорт в зависимости от региона, организации, вида услуги и класса заказа, полученных в запросе от СберТранспорт. В версии ТМ 3.15.122 еще было добавлено, чтобы выбор клиента, заказчика и группы экипажей мог зависеть от ИНН организации, полученной в запросе от СберТранспорт. |
Ищут также: СберТранспорт API, API СберТранспорт, Интеграция СберТранспорт, Подключение СберТранспорт, SberTransport API, Sber Transport API, Сбер Транспорт API, Сбер Транспорт, API Сбер Транспорт, Интеграция с СберТранспорт, Интеграция с Сбер Транспорт, СберТранспорт интеграция, СберТранспорт подключение, Сбер Transport Integration, SberTransport integration, SberTransport подключение, СберТранспорт, Sber Transport, СБЕРТРАНСПОРТТЕСТ
