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

TechnicalWriter в 13:53, 10 февраля 2026

2026-02-10T13:53:58Z

TechnicalWriter: Добавлены синонимы для поисковой системы

2025-10-14T14:51:56Z

Добавлены синонимы для поисковой системы

TechnicalWriter: Добавлены скрытые синонимы, чтобы страница выходила в поиске по синонимам

2025-10-14T11:45:48Z

Добавлены скрытые синонимы, чтобы страница выходила в поиске по синонимам

TechnicalWriter: Доаполнена история изменений

2025-10-09T09:57:15Z

Доаполнена история изменений

TechnicalWriter: Добавлена история изменений

2025-09-11T10:34:41Z

Добавлена история изменений

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

2023-03-15T10:24:41Z

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

TechnicalWriter: Новая страница: «В Такси-Мастер реализована интеграция с '''API СберТранспорт''' (перевозка сотрудников Сбер…»

2023-03-15T09:14:48Z

Новая страница: «В Такси-Мастер реализована интеграция с '''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 192.168.2.24

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

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

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

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

← Предыдущая		Версия 11:45, 14 октября 2025
Строка 1:		Строка 1:
		+
	В Такси-Мастер реализована интеграция с '''API СберТранспорт''' (перевозка сотрудников Сбера).		В Такси-Мастер реализована интеграция с '''API СберТранспорт''' (перевозка сотрудников Сбера).
		+	{{Синонимы\|СберТранспорт API, SberTransport API, Сбер Транспорт API, Интеграция СберТранспорт, СБЕРТРАНСПОРТТЕСТ}}

@@ Строка 67: / Строка 67: @@
 {| class="wikitable"
 |-
-! Версия Такси-Мастер !! Внесенное изменение
+! Версия Такси-Мастер !! Месяц обновления !! Внесенное изменение
 |-
-| ТМ 3.15.122 || В  "Файл / Настройки / TM API / СберТранспорт / Параметры заказа" сейчас можно задать параметры, какой клиент, заказчик и группа экипажей будут подставляться в заказ из СберТранспорт в зависимости от региона, организации, вида услуги и класса заказа, полученных в запросе от СберТранспорт. В версии ТМ 3.15.122 еще было добавлено, чтобы выбор  клиента, заказчика и группы экипажей мог зависеть от ИНН организации, полученной в запросе от СберТранспорт.
+| ТМ 3.15.122 || Сентябрь 2025 || Реализован новый запрос в SberTransportAPI. В новом запросе можно запросить координаты водителей и время до подачи сразу по нескольким заказам.
 |}
 </div>

@@ Строка 1: / Строка 1: @@
+<div style="font-size:10.5pt; width:100%; max-width:180ch; margin-left:18px; margin-right:auto; padding-left:0; padding-right:8px; text-align:left;">
 В Такси-Мастер реализована интеграция с '''API СберТранспорт''' (перевозка сотрудников Сбера).
 {{Синонимы|СберТранспорт API, SberTransport API, Сбер Транспорт API, Интеграция СберТранспорт, СБЕРТРАНСПОРТТЕСТ}}
@@ Строка 17: / Строка 17: @@
 На данной странице такие настройки:
 * '''Использовать СберТранспорт''' - включение интеграции со СберТранспорт.
 * '''Логин''' и '''Пароль''' - данные, которые организация генерирует самостоятельно и передает в Сбер. Они будут проверяться при обработке запросов из Сбера.
 * '''Состояние заказа при отмене заказа клиентом''' - в это состояние будет переводиться заказ, когда от Сбера приходит запрос отмены заказа.
-* '''Атрибут расстояния по заказу''' (не обязательная настройка) - специальный числовой атрибут, который можно будет привязывать к заказу, чтобы оператор при ручном закрытии заказа смог вручную заполнить в этом атрибуте значение километража. Если значение атрибута будет 0, то в Сбер будет передаваться обычное значение фактического километража, полученное от [[TMDriver]].
 * '''Параметры заказа''' - правила определения значения полей заказа "Клиент", "Заказчик" и "Группа экипажей", когда от Сбера приходит новый заказ.
 {{info|Подробности настройки правил:

@@ Строка 76: / Строка 76: @@
 |}
 </div>
 </div>
 [[Категория:Настройка]]
 [[Категория:Параметры ТМ]]

@@ Строка 51: / Строка 51: @@
 Для этого откройте в браузере http://ping.eu — на главной странице в верхней части будет ваш IP-адрес, например, в таком виде:
-  Your IP is 192.168.2.24
+  Your IP is 8.8.8.8
-То есть ваш IP-адрес '''192.168.2.24'''
+То есть ваш IP-адрес '''8.8.8.8'''
 === Как узнать Локальный порт API? ===