TM API — различия между версиями

Версия 12:28, 26 мая 2015 (просмотреть исходный код) TechnicalWriter (обсуждение | вклад) (→‎Расчет суммы заказа 2) ← Предыдущая правка		Текущая версия на 14:04, 5 декабря 2023 (просмотреть исходный код) TechnicalWriter (обсуждение | вклад) (→‎Ветка «Открытое API»)
(не показаны 444 промежуточные версии 2 участников)
Строка 5:		Строка 5:
	# Создать механизм приема заказов через интернет.		# Создать механизм приема заказов через интернет.
	# Сделать ваш сайт более информативным: публиковать полезную для клиентов информацию прямо из системы - список ближайших [[Справочник «Экипажи»|экипажей]], предварительный расчет стоимости поездки, мониторинг движения автомобиля такси в процессе выполнения [[заказ]]а, [[Модуль «Интеграция с картами»|карты города]] и контактную информацию.		# Сделать ваш сайт более информативным: публиковать полезную для клиентов информацию прямо из системы - список ближайших [[Справочник «Экипажи»|экипажей]], предварительный расчет стоимости поездки, мониторинг движения автомобиля такси в процессе выполнения [[заказ]]а, [[Модуль «Интеграция с картами»|карты города]] и контактную информацию.
−	# Расширить возможности своей службы за счет популярного онлайн-сервиса Яндекс.Такси.
−	{{Warning|Все перечисленные функции работают в Такси-Мастер не ниже [[История изменений в программе Такси-Мастер#Такси-Мастер. Версия 0.6.1 от 31.12.2014|0.6.1 от 31.12.2014г]]. В более низких версиях программы часть функций может не поддерживаться.}}	+	{{Warning|Все перечисленные функции работают в Такси-Мастер не ниже [[История изменений в программе Такси-Мастер#Такси-Мастер. Версия 3.13.0 от 24.10.2022|3.13.0 от 24.10.2022г]]. В более ранних версиях программы часть функций может не поддерживаться.}}
	== Параметры TM API ==		== Параметры TM API ==
	Задать настройки для корректной работы TM API вы сможете в программе [[Такси-Мастер]] в меню {{tab|Настройки}} в одноименной ветке {{tab|TM API}}.		Задать настройки для корректной работы TM API вы сможете в программе [[Такси-Мастер]] в меню {{tab|Настройки}} в одноименной ветке {{tab|TM API}}.
−	Параметры организуют и контролируют работу [[Модуль «Интернет-заказы»|модуля «Интернет-заказы»]].
	# Установите флажок {{checkbox|Использовать TM API}}, чтобы приступить к его использованию.		# Установите флажок {{checkbox|Использовать TM API}}, чтобы приступить к его использованию.
	# В поле {{поле|Локальный порт}} введите номер порта подключения к интернету, на котором работает и будет ожидать запросы о новых заказах [[TMServer]]. Рекомендуется оставить номер порта по умолчанию.		# В поле {{поле|Локальный порт}} введите номер порта подключения к интернету, на котором работает и будет ожидать запросы о новых заказах [[TMServer]]. Рекомендуется оставить номер порта по умолчанию.
−	# Установите флажок {{checkbox|Можно использовать данное рабочее место TMServer для распознавания адресов}} для того, чтобы конкретно с данного рабочего места происходило распознавание адресов модулем "Интернет-заказы".	+	# При необходимости установите флажок {{checkbox|Использовать автопроброс порта с помощью UPnP}}, также укажите {{поле|Внешний порт}} и {{поле|Локальный IP}}.
−	# Перезапустите [[Такси-Мастер]] и [[TMServer]] для запуска работы модуля.
	=== Ветка «Открытое API» ===		=== Ветка «Открытое API» ===
−	В данной ветке регулируется доступ к синхронизации Такси-Мастер со сторонним сервисом (сайтом), с помощью которого клиенты будут создавать интернет-заказы. С примером кода для работы вы можете ознакомиться в данной статье в разделе [[TM API#Общее описание протокола|Общее описание протокола]].	+	В данной ветке регулируется доступ к синхронизации Такси-Мастер со сторонним сервисом (сайтом), с помощью которого клиенты будут создавать заказы. С примером кода для работы вы можете ознакомиться в данной статье в разделе [[TM API#Общее описание протокола|Общее описание протокола]].
−	# Установите флажок {{checkbox|Использовать открытое API}} для того, чтобы запустить работу по обслуживанию модуля «Интернет-заказы». При установленном флажке сервер [[Модуль «Интернет-заказы»|модуля «Интернет-заказы»]] запускается и ожидает запросы о новых заказах.	+	# Установите флажок {{checkbox|Использовать открытое API}} для того, чтобы запустить работу протокола TMCommonAPI.
−	# В поле {{поле|Секретный ключ}} укажите произвольный номер. В дальнейшем этот номер следует использовать в API-запросах на сайте.	+	# В поле {{поле|Секретный ключ}} укажите произвольный номер. В дальнейшем этот номер следует использовать в API-запросах на сайте.
−	# Перезапустите [[Такси-Мастер]] и [[TMServer]] для запуска работы модуля.	+	# В таблице "Пользователи CommonAPI" можно настроить доступ к CommonAPI. Для этого нужно создать пользователей, у которых будет отдельный секретный ключ, и отметить доступные запросы CommonAPI.
	=== Ветка «API для телефонии» ===		=== Ветка «API для телефонии» ===
	В данной ветке регулируются настройки API для телефонии, т.е. взаимодействие [[Такси-Мастер]] с call-центром через программный интерфейс. С его помощью [[Call-центр Oktell|call-центр]] может дать команду Такси-Мастер создать [[заказ]] или запросить информацию о [[Справочник «Состояния заказа»|статусе текущего заказа]].		В данной ветке регулируются настройки API для телефонии, т.е. взаимодействие [[Такси-Мастер]] с call-центром через программный интерфейс. С его помощью [[Call-центр Oktell|call-центр]] может дать команду Такси-Мастер создать [[заказ]] или запросить информацию о [[Справочник «Состояния заказа»|статусе текущего заказа]].
−	# Установите флажок {{checkbox|Использовать открытое API для телефонии}} для того, чтобы запустить работу по обслуживанию телефонии через API.	+	# Установите флажок {{checkbox|Использовать открытое API для телефонии}} для того, чтобы запустить работу протокола TMTAPI.
	# В поле {{поле|Секретный ключ}} укажите номер секретного ключа для работы.		# В поле {{поле|Секретный ключ}} укажите номер секретного ключа для работы.
−	# Перезапустите [[Такси-Мастер]] и [[TMServer]] для запуска работы модуля.	+
		+	=== Ветка «TaxoPhone API» ===
		+	{{вам сюда|Настройка приложения TaxoPhone}}
	=== Ветка «Платежные терминалы» ===		=== Ветка «Платежные терминалы» ===
Строка 33:		Строка 32:
	Параметры этой ветки отвечают за работу [[Модуль интеграции с платежными терминалами|модуля интеграции с платежными системами]].		Параметры этой ветки отвечают за работу [[Модуль интеграции с платежными терминалами|модуля интеграции с платежными системами]].
−	# Установите флажок {{checkbox|Включить прием терминальных платежей}}. Данная функция позволит отображать все платежные операции по приходу средств от водителей через терминалы в [[База данных Такси-Мастер 2|базе данных]] программы.	+	# Установите флажок {{checkbox|Включить прием терминальных платежей}}. Данная функция позволит отображать все платежные операции по приходу средств от водителей через терминалы в базе данных программы.
	# В поле {{поле|Секретный ключ}} укажите номер секретного ключа для работы с платежными системами и сверки платежей, который будет выслан вам в письме от менеджера. Секретный ключ - это определенный набор символов, необходимый для формирования подписи при передаче информации о платеже.		# В поле {{поле|Секретный ключ}} укажите номер секретного ключа для работы с платежными системами и сверки платежей, который будет выслан вам в письме от менеджера. Секретный ключ - это определенный набор символов, необходимый для формирования подписи при передаче информации о платеже.
−	# В полях {{поле|Логин}} и {{поле|Пароль}} введите данные учетной записи на сайте http://term.bitmaster.ru.
	# Кнопка {{кнопка|Задать всем водителям терминальный аккаунт по их ИД}} служит для соединения TM API с сервером Такси-Мастер. В результате соединения записи о терминальных аккаунтах генерируются, заносятся (для тех водителей, у которых они отсутствуют) и обновляются (для тех водителей, у которых уже существуют терминальные аккаунты) в Такси-Мастер.		# Кнопка {{кнопка|Задать всем водителям терминальный аккаунт по их ИД}} служит для соединения TM API с сервером Такси-Мастер. В результате соединения записи о терминальных аккаунтах генерируются, заносятся (для тех водителей, у которых они отсутствуют) и обновляются (для тех водителей, у которых уже существуют терминальные аккаунты) в Такси-Мастер.
−	# Перезапустите [[Такси-Мастер]] и [[TMServer]] для запуска работы модуля.
−	{{info|Обратите внимание, что для платежных систем также существует открытый и свободно распространяемый API, с помощью которого есть возможность связать [[Такси-Мастер]] и [[Модуль интеграции с платежными системами|платежные системы]]. Обратитесь в отдел дополнительных услуг, написав на {{ящик ОДУ}}, за получением кода для данного компонента системы.}}	+	[[Категория:Параметры ТМ]]
	== Общее описание протокола ==		== Общее описание протокола ==
Строка 49:		Строка 46:
	<pre>		<pre>
−	GET https://ip:port/common_api/1.0/get_crew_groups_list HTTP/1.1	+	GET https://ip:port/common_api/1.0/get_crew_groups_list
	</pre>		</pre>
−	Для получения данных из БД используются запросы типа GET. Для записи данных в [[База данных Такси-Мастер|базу данных]] используются запросы типа POST. В запросе типа GET параметры запроса передаются в URI. Пример:	+	Для получения данных из БД используются запросы типа GET. Для записи данных в базу данных используются запросы типа POST. В запросе типа GET параметры запроса передаются в URI. Пример:
	<pre>		<pre>
−	GET https://ip:port/common_api/1.0/calc_order_cost?tariff_id=1&distance_city=10 HTTP/1.1	+	GET https://ip:port/common_api/1.0/calc_order_cost?tariff_id=1&distance_city=10
	Signature: <...>		Signature: <...>
	</pre>		</pre>
Строка 61:		Строка 58:
	<pre>		<pre>
−	POST https://ip:port/common_api/1.0/create_order HTTP/1.1	+	POST https://ip:port/common_api/1.0/create_order
	Signature: <...>		Signature: <...>
	Content-Type: application/x-www-form-urlencoded		Content-Type: application/x-www-form-urlencoded
Строка 70:		Строка 67:
	</pre>		</pre>
−	В любом запросе обязательно должен быть заголовок Signature. В нем передается MD5 хэш, рассчитанный для строки, которая получается сцеплением строки параметров запроса с секретным ключом. Секретный ключ задается в настройках модуля TMWeb в ТМ2. Пример:	+	В любом запросе обязательно должен быть заголовок Signature. В нем передается MD5 хэш, рассчитанный для строки, которая получается сцеплением строки параметров запроса с секретным ключом. Секретный ключ задается в {{путь|Файл - Настройки - TM API - Открытое API}}. Пример:
	<pre>		<pre>
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/calc_order_cost?tariff_id=1&distance_city=10 HTTP/1.1	+	GET https://ip:port/common_api/1.0/calc_order_cost?tariff_id=1&distance_city=10
	Секретный ключ:		Секретный ключ:
Строка 152:		Строка 149:
	<pre>		<pre>
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/ping HTTP/1.1	+	GET https://ip:port/common_api/1.0/ping
	Ответ:		Ответ:
	{		{
Строка 194:		Строка 191:
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/get_crew_groups_list HTTP/1.1	+	GET https://ip:port/common_api/1.0/get_crew_groups_list
	Signature: <...>		Signature: <...>
Строка 249:		Строка 246:
	<pre>		<pre>
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/get_client_groups_list HTTP/1.1	+	GET https://ip:port/common_api/1.0/get_client_groups_list
	Signature: <...>		Signature: <...>
	Ответ:		Ответ:
Строка 305:		Строка 302:
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/get_uds_list HTTP/1.1	+	GET https://ip:port/common_api/1.0/get_uds_list
	Signature: <...>		Signature: <...>
Строка 367:		Строка 364:
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/get_tariffs_list HTTP/1.1	+	GET https://ip:port/common_api/1.0/get_tariffs_list
	Signature: <...>		Signature: <...>
Строка 393:		Строка 390:
	=== Запрос списка услуг ===		=== Запрос списка услуг ===
		+	'''Запрос устарел. Рекомендуется использовать [[#Запрос списка атрибутов|Запрос списка атрибутов]]'''
		+
	Метод: GET		Метод: GET
Строка 434:		Строка 433:
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/get_services_list HTTP/1.1	+	GET https://ip:port/common_api/1.0/get_services_list
	Signature: <...>		Signature: <...>
Строка 461:		Строка 460:
	</pre>		</pre>
−		+	=== Запрос списка атрибутов ===
−	=== Запрос списка параметров заказа ===
	Метод: GET		Метод: GET
Строка 480:		Строка 478:
	|order_params		|order_params
	|Массив		|Массив
−	|Список переметров заказа	+	|Список параметров заказа
	|-		|-
	|&bull; id		|&bull; id
Строка 508:		Строка 506:
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/get_order_params_list HTTP/1.1	+	GET https://ip:port/common_api/1.0/get_order_params_list
	Signature: <...>		Signature: <...>
Строка 579:		Строка 577:
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/get_discounts_list HTTP/1.1	+	GET https://ip:port/common_api/1.0/get_discounts_list
	Signature: <...>		Signature: <...>
Строка 621:		Строка 619:
	|-		|-
	|phone		|phone
−	|Строка, <= 16 символов	+	|Строка, <= 30 символов
	|Номер телефона		|Номер телефона
	|-		|-
Строка 695:		Строка 693:
	|103		|103
	|Служба ЕДС не найдена		|Служба ЕДС не найдена
		+	|-
		+	|110
		+	|Клиент заблокирован
		+	|-
		+	|111
		+	|Не найден клиент, который может использовать собственный счет для оплаты заказов
		+	|-
		+	|114
		+	|Недостаточно средств на безналичном счете клиента в ТМ
		+	|-
		+	|115
		+	|Отрицательный баланс на безналичном счете клиента в ТМ
		+	|-
		+	|116
		+	|Для клиента запрещена оплата заказа наличными. Клиент должен максимально использовать в заказе безналичную оплату (оплату с основного счета)
	|}		|}
Строка 713:		Строка 726:
	Запрос:		Запрос:
−	POST https://ip:port/common_api/1.0/create_order HTTP/1.1	+	POST https://ip:port/common_api/1.0/create_order
	Signature: <...>		Signature: <...>
	Content-Type: application/x-www-form-urlencoded		Content-Type: application/x-www-form-urlencoded
Строка 738:		Строка 751:
	Название запроса: create_order2		Название запроса: create_order2
−	Параметры:	+	Параметры в формате JSON:
	{|		{|
Строка 748:		Строка 761:
	|-		|-
	|phone		|phone
−	|Строка, <= 16 символов	+	|Строка, <= 30 символов
	|Номер телефонам (необязателен, если client_id присутствует).		|Номер телефонам (необязателен, если client_id присутствует).
	|-		|-
Строка 778:		Строка 791:
	|Целое		|Целое
	|ИД стоянки		|ИД стоянки
		+	|-
		+	|server_time_offset
		+	|Целое
		+	|Смещения относительно серверного времени
	|-		|-
	|source_time		|source_time
Строка 788:		Строка 805:
	|Строка		|Строка
	|Пассажир		|Пассажир
		+	|-
		+	|phone_to_dial
		+	|Строка, <= 30 символов
		+	|Телефон для отзвона
	|-		|-
	|customer		|customer
Строка 812:		Строка 833:
	|true или false		|true или false
	|Предварительный заказ		|Предварительный заказ
		+	|-
		+	|check_duplicate
		+	|true или false
		+	|Проверка на дубликат
	|-		|-
	|services		|services
	|Массив		|Массив
−	|Массив услуг. Устарело. Рекомендуется использовать параметр order_params.	+	|Массив услуг. Устарело. Рекомендуется использовать параметр attribute_values.
	|-		|-
	|&bull;		|&bull;
Строка 823:		Строка 848:
	|crew_props		|crew_props
	|Массив		|Массив
−	|Массив признаков экипажей. Устарело. Рекомендуется использовать параметр order_params.	+	|Массив признаков экипажей. Устарело. Рекомендуется использовать параметр attribute_values.
	|-		|-
	|&bull;		|&bull;
Строка 831:		Строка 856:
	|order_params		|order_params
	|Массив		|Массив
−	|Массив параметров заказа	+	|Массив параметров заказа. Устарело. Рекомендуется использовать параметр attribute_values.
	|-		|-
	|&bull;		|&bull;
Строка 856:		Строка 881:
	|Дробное		|Дробное
	|Фиксированная сумма оплаты заказа с бонусного счета клиента (не используется, если use_bonus = true).		|Фиксированная сумма оплаты заказа с бонусного счета клиента (не используется, если use_bonus = true).
		+	|-
		+	|client_employee_id
		+	|Целое
		+	|ИД сотрудника клиента (если задан client_id)
		+	|-
		+	|email
		+	|Строка
		+	|Email для отправки уведомлений
		+	|-
		+	|prior_to_current_before_minutes
		+	|Целое
		+	|Время перехода из предварительного в текущие заказы, мин
		+	|-
		+	|flight_number
		+	|Строка
		+	|Номер рейса
		+	|-
		+	|need_custom_validate
		+	|true или false
		+	|Использовать специальную проверку перед созданием заказа
		+	|-
		+	|attribute_values
		+	|Массив
		+	|Массив значений атрибутов
		+	|-
		+	|&bull; id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|&bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|&bull; num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|&bull; str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
	|}		|}
Строка 883:		Строка 952:
	|106		|106
	|Стоянка не найдена		|Стоянка не найдена
		+	|-
		+	|107
		+	|Сотрудник клиента не найден
		+	|-
		+	|108
		+	|Параметр заказа не найден
		+	|-
		+	|109
		+	|Атрибут не может быть привязан к заказу
		+	|-
		+	|110
		+	|Клиент заблокирован
		+	|-
		+	|111
		+	|Не найден клиент, который может использовать собственный счет для оплаты заказов
		+	|-
		+	|112
		+	|Сотрудник клиента заблокирован
		+	|-
		+	|113
		+	|Ошибка специальной проверки заказа перед созданием. В ответе будет возвращаться:
		+	"data": {
		+	"message":"Текст ошибки для пользователя."
		+	}
		+	|-
		+	|114
		+	|Недостаточно средств на безналичном счете клиента в ТМ
		+	|-
		+	|115
		+	|Отрицательный баланс на безналичном счете клиента в ТМ
		+	|-
		+	|116
		+	|Для клиента запрещена оплата заказа наличными. Клиент должен максимально использовать в заказе безналичную оплату (оплату с основного счета)
	|}		|}
Строка 899:		Строка 1001:
	<pre>		<pre>
−	Запрос:
	POST https://ip:port/common_api/1.0/create_order2 HTTP/1.1		POST https://ip:port/common_api/1.0/create_order2 HTTP/1.1
	Signature: <...>		Signature: <...>
	Content-Type: application/json		Content-Type: application/json
−	Content-Length: 395	+	Content-Length: <...>
		+
	{		{
		+	"server_time_offset":2,
	"source_time":"20140415172811",		"source_time":"20140415172811",
	"is_prior":false,		"is_prior":false,
		+	"check_duplicate":true,
	"phone":"123456",		"phone":"123456",
−	"client_id":1,	+	"phone_to_dial":"654321",
		+	"client_id":1,
		+	"client_employee_id":4,
	"customer":"CUSTOMER",		"customer":"CUSTOMER",
	"passenger":"PASSENGER",		"passenger":"PASSENGER",
Строка 915:		Строка 1021:
	"uds_id":1,		"uds_id":1,
	"tariff_id":1,		"tariff_id":1,
−	"addresses":[	+	"addresses": [
−	{"address":"SOURCE","lat":56.896817,"lon":53.147830,"zone_id":1,"parking_id":1},	+	{
−	{"address":"STOP1","lat":56.845452,"lon":53.226775,"zone_id":2,"parking_id":2},	+	"address": "SOURCE",
−	{"address":"STOP2"},	+	"lat": 56.896817,
−	{"address":"DESTINATION","lat":56.861230,"lon":53.241870}	+	"lon": 53.14783
−	],	+	"zone_id": 1,
		+	"parking_id": 1
		+	},
		+	{
		+	"address": "STOP1",
		+	"lat": 56.845452,
		+	"lon": 53.226775
		+	"zone_id": 2,
		+	"parking_id": 2
		+	},
		+	{
		+	"address": "STOP2"
		+	},
		+	{
		+	"address": "DESTINATION",
		+	"lat": 56.86123,
		+	"lon": 53.24187
		+	}
		+	]
	"services":[1,2],		"services":[1,2],
	"crew_props":[1],		"crew_props":[1],
	"order_params":[3,4],		"order_params":[3,4],
	"total_cost":370,		"total_cost":370,
		+	"client_id":28,
	"use_cashless":false,		"use_cashless":false,
	"use_bonus":false,		"use_bonus":false,
	"cashless_sum":700,		"cashless_sum":700,
−	"bonus_sum":350	+	"bonus_sum":350,
		+	"email":"email@gmail.com",
		+	"prior_to_current_before_minutes":30,
		+	"flight_number":"130-qwe2",
		+	"need_custom_validate":false,
		+	"attribute_values": [
		+	{
		+	"id": 1,
		+	"bool_value": true
		+	},
		+	{
		+	"id": 2,
		+	"num_value": 1
		+	},
		+	{
		+	"id": 3,
		+	"num_value": 10
		+	},
		+	{
		+	"id": 4,
		+	"str_value": "строка"
		+	}
		+	]
	}		}
Строка 972:		Строка 1119:
	|Целое		|Целое
	|ИД клиента		|ИД клиента
		+	|-
		+	|client_employee_id
		+	|Целое
		+	|ИД сотрудника клиента
	|-		|-
	|discount_id		|discount_id
Строка 1065:		Строка 1216:
	|106		|106
	|Дисконтная карта не найдена		|Дисконтная карта не найдена
		+	|-
		+	|107
		+	|Район остановки не найден
		+	|-
		+	|108
		+	|Группа экипажа не найдена
		+	|-
		+	|109
		+	|Служба ЕДС не найдена
		+	|-
		+	|110
		+	|Дисконтная карта не действительна
		+	|-
		+	|111
		+	|Не найден сотрудник клиента
	|}		|}
Строка 1095:		Строка 1261:
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/calc_order_cost?	+	GET https://ip:port/common_api/1.0/calc_order_cost?tariff_id=1&source_time=20120501100000&is_prior=false&client_id=1&client_employee_id=11&discount_id=1&disc_card_id=1&
−	tariff_id=1&source_time=20120501100000&is_prior=false&client_id=1&discount_id=1&disc_card_id=1&sour	+	source_zone_id=1&dest_zone_id=2&distance_city=10&distance_country=20&source_distance_country=5&is_country=true&waiting_minutes=10&is_hourly=false&hourly_minutes=60&
−	ce_zone_id=1&dest_zone_id=2&distance_city=10&distance_country=20&source_distance_country=5&is_count	+	is_prize=true&back_way=false&services=1;2;3&order_params=1;2;3 HTTP/1.1
−	ry=true&waiting_minutes=10&is_hourly=false&hourly_minutes=60&is_prize=true&back_way=false&services=
−	1;2;3&order_params=1;2;3 HTTP/1.1
	Signature: <...>		Signature: <...>
Строка 1128:		Строка 1292:
	Название запроса: calc_order_cost2		Название запроса: calc_order_cost2
		+
		+	Параметры в формате JSON:
	{|		{|
	!Параметр		!Параметр
Строка 1133:		Строка 1299:
	!Описание		!Описание
	|-		|-
−	!colspan="3"|Обязательные параметры	+	|order_id
		+	|Целое
		+	|ИД заказа
	|-		|-
	|tariff_id		|tariff_id
	|Целое		|Целое
	|ИД тарифа		|ИД тарифа
−	|-
−	Параметры:
−
−	!colspan="3"|Необязательные параметры
	|-		|-
	|source_time		|source_time
Строка 1154:		Строка 1318:
	|Целое		|Целое
	|ИД клиента		|ИД клиента
		+	|-
		+	|phone
		+	|Строка
		+	|Телефон клиента
	|-		|-
	|discount_id		|discount_id
Строка 1166:		Строка 1334:
	|Целое		|Целое
	|ИД района подачи		|ИД района подачи
		+	|-
		+	|source_lon
		+	|Дробное
		+	|Долгота адреса подачи
		+	|-
		+	|source_lat
		+	|Дробное
		+	|Широта адреса подачи
	|-		|-
	|dest_zone_id		|dest_zone_id
	|Целое		|Целое
	|ИД района назначения		|ИД района назначения
		+	|-
		+	|dest_lon
		+	|Дробное
		+	|Долгота адреса назначения
		+	|-
		+	|dest_lat
		+	|Дробное
		+	|Широта адреса назначения
	|-		|-
	|distance_city		|distance_city
Строка 1209:		Строка 1393:
	|order_params		|order_params
	|Массив		|Массив
−	|Массив параметров заказа	+	|Массив параметров заказа. Устарело. Рекомендуется использовать параметр attribute_values.
	|-		|-
	|&bull;		|&bull;
Строка 1226:		Строка 1410:
	|Целое		|Целое
	|ИД района остановки		|ИД района остановки
		+	|-
		+	|&bull; lat
		+	|Дробное
		+	|Широта адреса остановки
		+	|-
		+	|&bull; lon
		+	|Дробное
		+	|Долгота адреса остановки
		+	|-
		+	|crew_group_id
		+	|Целое
		+	|ИД группы экипажа
		+	|-
		+	|uds_id
		+	|Целое
		+	|ИД службы ЕДС
		+	|-
		+	|analyze_route
		+	|true или false
		+	|Нужно ли выполнять анализ адресов и маршрута. Если данный флаг установлен (analyze_route=true), то значения параметров: distance_city, distance_country, source_distance_country, переданные в данном запросе будут игнорироваться. Они автоматически будут рассчитаны в ходе выполнения запроса в результате анализа адресов и маршрута. Также перед анализом адресов будут автоматически найдены районы (по справочнику "Районы") для тех адресов, у которых район не указан явно (zone_id=0). Также по результатам анализа адресов автоматически будут определены флаги "Загородный заказ" (is_country) и "Межгород".
		+	|-
		+	|attribute_values
		+	|Массив
		+	|Массив значений атрибутов
		+	|-
		+	|&bull; id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|&bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|&bull; num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|&bull; str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
	|}		|}
Строка 1256:		Строка 1484:
	|107		|107
	|Район остановки не найден		|Район остановки не найден
		+	|-
		+	|108
		+	|Группа экипажа не найдена
		+	|-
		+	|109
		+	|Служба ЕДС не найдена
		+	|-
		+	|110
		+	|Дисконтная карта не действительна
		+	|-
		+	|111
		+	|Сотрудник клиента не найден
		+	|-
		+	|112
		+	|Атрибут не найден
		+	|-
		+	|113
		+	|Атрибут не может быть привязан к заказу
		+	|-
		+	|114
		+	|Заказ не найден
	|}		|}
Строка 1272:		Строка 1521:
	|Дополнительная информация по расчету суммы заказа		|Дополнительная информация по расчету суммы заказа
	|-		|-
−	| &bull; comment	+	|&bull; comment
	|Строка		|Строка
	|Описание позиции дополнительной информации по расчету суммы заказа		|Описание позиции дополнительной информации по расчету суммы заказа
	|-		|-
−	| &bull; sum	+	|&bull; sum
	|Строка		|Строка
	|Сумма позиции дополнительной информации по расчету суммы заказа		|Сумма позиции дополнительной информации по расчету суммы заказа
Строка 1286:		Строка 1535:
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/calc_order_cost2 HTTP/1.1	+	POST https://ip:port/common_api/1.0/calc_order_cost2 HTTP/1.1
	Signature: <...>		Signature: <...>
	Content-Type: application/json		Content-Type: application/json
	Content-Length: <...>		Content-Length: <...>
		+
	{		{
	"tariff_id":1,		"tariff_id":1,
	"source_time":"20140415172811",		"source_time":"20140415172811",
	"is_prior":false,		"is_prior":false,
−	"client_id":1,	+	"client_id":1,
	"discount_id":1,		"discount_id":1,
	"disc_card_id":1,		"disc_card_id":1,
−	"source_zone_id":1,	+	"source_zone_id":1,,
−	"dest_zone_id":2,	+	"source_lat":11.111111,
		+	"source_lon":22.222222,
		+	"dest_zone_id":2,,
		+	"dest_lat":33.333333,
		+	"dest_lon":44.444444,
	"distance_city":10,		"distance_city":10,
	"distance_country":20,		"distance_country":20,
Строка 1311:		Строка 1565:
	"stops": [		"stops": [
	{		{
−	"zone_id": 1	+	"zone_id": 1,
		+	"lat": 11.111111,
		+	"lon": 22.222222
		+	},
		+	{
		+	"zone_id": 2,
		+	"lat": 33.333333,
		+	"lon": 44.444444
		+	}
		+	],
		+	"attribute_values": [
		+	{
		+	"id": 1,
		+	"bool_value": true
		+	},
		+	{
		+	"id": 2,
		+	"num_value": 1
		+	},
		+	{
		+	"id": 3,
		+	"num_value": 10
	},		},
	{		{
−	"zone_id": 2	+	"id": 4,
		+	"str_value": "строка"
	}		}
	]		]
	}		}
		+
	Ответ:		Ответ:
	{		{
Строка 1337:		Строка 1614:
	}		}
	</pre>		</pre>
−
	=== Изменение состояния заказа ===		=== Изменение состояния заказа ===
−
	Метод: POST		Метод: POST
Строка 1353:		Строка 1628:
	!colspan="3"|Обязательные параметры		!colspan="3"|Обязательные параметры
	|-		|-
−	|ORDER_ID	+	|order_id
	|Целое		|Целое
	|ИД заказа		|ИД заказа
	|-		|-
−	|NEW_STATE	+	|new_state
	|Целое		|Целое
	|Новое состояние заказа		|Новое состояние заказа
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|cancel_order_penalty_sum
		+	|Дробное
		+	|Сумма штрафа клиента за отмену заказа. Если свойство new_state имеет тип "Прекращен" (выполняется отмена заказа) и при отмене заказа должен быть назначен штраф клиенту, то если данное значение штрафа указано (даже если указано значение 0), то оно имеет приоритет. Если данное значение не указано, то сумма штрафа будет определена автоматически по группе клиентов.
	|}		|}
Строка 1383:		Строка 1664:
	!Описание		!Описание
	|-		|-
−	|ORDER_ID	+	|order_id
	|Целое		|Целое
	|ИД заказа		|ИД заказа
	|-		|-
−	|NEW_STATE	+	|new_state
	|Целое		|Целое
	|Новое состояние заказа		|Новое состояние заказа
Строка 1396:		Строка 1677:
	Запрос:		Запрос:
−	POST https://ip:port/common_api/1.0/calc_order_cost?order_id=6&new_state=4 HTTP/1.1	+	POST https://ip:port/common_api/1.0/change_order_state?order_id=6&new_state=4
	Signature: <...>		Signature: <...>
Строка 1427:		Строка 1708:
	|Целое		|Целое
	|ИД экипажа		|ИД экипажа
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|fields
		+	|Строка
		+	|Список возвращаемых полей через запятую
	|}		|}
Строка 1495:		Строка 1782:
	|Целое		|Целое
	|Динамический приоритет		|Динамический приоритет
		+	|-
		+	|rating_priority
		+	|Целое
		+	|Приоритет по рейтингу
	|-		|-
	|order_change_id		|order_change_id
Строка 1507:		Строка 1798:
	|true или false		|true или false
	|Наклейка		|Наклейка
		+	|-
		+	|use_plan_shifts
		+	|true или false
		+	|Запрет работы вне запланированных смен
		+	|-
		+	|fuel_level
		+	|Дробное
		+	|Уровень топлива в автомобиле
	|-		|-
	|order_params		|order_params
	|Массив		|Массив
−	|Массив параметров заказа экипажа	+	|Массив параметров экипажа
	|-		|-
	|&bull;		|&bull;
	|Целое		|Целое
	|ИД параметра заказа		|ИД параметра заказа
		+	|-
		+	|attribute_values
		+	|Массив
		+	|Массив значений атрибутов
		+	|-
		+	|&bull; id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|&bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|&bull; num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|&bull; str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
	|}		|}
Строка 1522:		Строка 1845:
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/get_crew_info?crew_id=1 HTTP/1.1	+	GET https://ip:port/common_api/1.0/get_crew_info?crew_id=1
	Signature: <...>		Signature: <...>
		+
	Ответ:		Ответ:
Строка 1542:		Строка 1866:
	"common_priority":0,		"common_priority":0,
	"static_priority":0,		"static_priority":0,
−	"dynamic_priority":0,	+	"dynamic_priority":0,
		+	"rating_priority":0,
	"order_change_id":218,		"order_change_id":218,
	"has_light_house":false,		"has_light_house":false,
Строка 1549:		Строка 1874:
	1,		1,
	2,		2,
		+	],
		+	"attribute_values": [
		+	{
		+	"id": 1,
		+	"bool_value": true
		+	},
		+	{
		+	"id": 2,
		+	"num_value": 1
		+	},
		+	{
		+	"id": 3,
		+	"num_value": 10
		+	},
		+	{
		+	"id": 4,
		+	"str_value": "строка"
		+	}
	]		]
	}		}
Строка 1554:		Строка 1897:
	</pre>		</pre>
−	=== Запрос информации об экипажах на линии ===	+	=== Запрос информации об экипажах ===
	Метод: GET		Метод: GET
	Название запроса: get_crews_info		Название запроса: get_crews_info
−	Параметры: нет	+	Параметры:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	! colspan="3" | Необязательные параметры
		+	|-
		+	|not_working_crews
		+	|true или false
		+	|Нужно ли возвращать экипажи не на линии. По умолчанию возвращаются только экипажи на линии
		+	|-
		+	|fields
		+	|Строка
		+	|Список возвращаемых полей через запятую
		+	|}
	Специальные возвращаемые коды: нет		Специальные возвращаемые коды: нет
Строка 1568:		Строка 1926:
	!Тип		!Тип
	!Описание		!Описание
−	|-
−	! colspan="3" | Обязательные параметры
	|-		|-
	|crews_info		|crews_info
	|Массив		|Массив
−	|Массив экипажей на линии	+	|Массив экипажей
	|-		|-
	|&bull; crew_id		|&bull; crew_id
Строка 1626:		Строка 1982:
	|Целое		|Целое
	|Динамический приоритет		|Динамический приоритет
		+	|-
		+	|&bull; rating_priority
		+	|Целое
		+	|Приоритет по рейтингу
	|-		|-
	|&bull; order_change_id		|&bull; order_change_id
Строка 1639:		Строка 1999:
	|Наклейка		|Наклейка
	|-		|-
−	|&bull; has_label	+	|&bull; use_plan_shifts
−	|true или false	+	|true или false
−	|Наклейка	+	|Запрет работы вне запланированных смен
		+	|-
		+	|&bull; fuel_level
		+	|Дробное
		+	|Уровень топлива в автомобиле
	|-		|-
	|&bull; order_params		|&bull; order_params
Строка 1647:		Строка 2011:
	|Массив параметров заказа экипажа		|Массив параметров заказа экипажа
	|-		|-
−	|&bull; order_params	+	|&bull; &bull;
	|Целое		|Целое
	|ИД параметра заказа		|ИД параметра заказа
−	|}	+	|-
−		+	|&bull; attribute_values
		+	|Массив
		+	|Массив значений атрибутов
		+	|-
		+	|&bull; &bull; id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|&bull; &bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|&bull; &bull; num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|&bull; &bull; str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
		+	|}
		+
	Пример:		Пример:
	<pre>		<pre>
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/get_crews_info HTTP/1.1	+	GET https://ip:port/common_api/1.0/get_crews_info
	Signature: <...>		Signature: <...>
Строка 1679:		Строка 2067:
	"static_priority":10,		"static_priority":10,
	"dynamic_priority":0,		"dynamic_priority":0,
		+	"rating_priority":0,
	"order_change_id":0,		"order_change_id":0,
	"has_light_house":false,		"has_light_house":false,
	"has_label":false,		"has_label":false,
		+	"use_plan_shifts":false,
		+	"fuel_level":8.15,
	"order_params":[		"order_params":[
	1,		1,
Строка 1701:		Строка 2092:
	"static_priority":15,		"static_priority":15,
	"dynamic_priority":0,		"dynamic_priority":0,
		+	"rating_priority":0,
	"order_change_id":0,		"order_change_id":0,
	"has_light_house":false,		"has_light_house":false,
	"has_label":true,		"has_label":true,
		+	"use_plan_shifts":true,
		+	"fuel_level":null,
	"order_params":[]		"order_params":[]
	}		}
Строка 1711:		Строка 2105:
	</pre>		</pre>
−	=== Запрос информации о водителе ===	+	=== Создание экипажа ===
−	Метод: GET	+	Метод: POST
		+
		+	Название запроса: create_crew
−	Название запроса: get_driver_info	+	Параметры в формате JSON:
−	Параметры:
	{|		{|
−	!Параметры	+	!Параметр
	!Тип		!Тип
	!Описание		!Описание
	|-		|-
−	!colspan="3"|Обязательные параметры	+	! colspan="3" | Обязательные параметры
		+	|-
		+	|car_id
		+	|Целое
		+	|ИД автомобиля
	|-		|-
	|driver_id		|driver_id
Строка 1728:		Строка 2127:
	|ИД водителя		|ИД водителя
	|-		|-
−	!colspan="3"|Необязательные параметры	+	|crew_group_id
		+	|Целое
		+	|ИД группы экипажа
	|-		|-
−	|need_photo	+	! colspan="3" | Необязательные параметры
−	|true или false
−	|Нужна ли фотография водителя
−	|}
−
−	Специальные возвращаемые коды:
−	{|
−	!Код
−	!Описание
	|-		|-
−	|100	+	|code
−	|Водитель не найден
−	|}
−
−	Возвращаемые параметры в случае успешного выполнения запроса:
−	{|
−	!Параметр
−	!Тип
−	!Описание
−	|-
−	|driver_id
−	|Целое
−	|ИД водителя
−	|-
−	|name
	|Строка		|Строка
−	|ФИО водителя	+	|Позывной экипажа
	|-		|-
−	|birthday	+	|work_shift_sum
−	|ДД.ММ.ГГГГ	+	|Дробное
−	|День рождения водителя	+	|Сумма, списываемая за смену
	|-		|-
−	|car_id	+	|min_balance
−	|Целое	+	|Дробное
−	|ИД основного автомобиля водителя	+	|Минимальный баланс, при котором можно выйти на смену
	|-		|-
−	|license	+	|work_time
	|Строка		|Строка
−	|Удостоверение водителя	+	|Время работы, формат: “6.00-10.30, 23:00-00:48”
		+	|-
		+	|has_light_house
		+	|true или false
		+	|Шашка
		+	|-
		+	|has_label
		+	|true или false
		+	|Наклейка
		+	|-
		+	|use_plan_shifts
		+	|true или false
		+	|Запрет работы вне запланированных смен
		+	|-
		+	|order_params
		+	|Массив
		+	|Массив параметров экипажа. Устарело. Рекомендуется использовать параметр attribute_values.
		+	|-
		+	|&bull;
		+	|Целое
		+	|ИД параметра
	|-		|-
−	|home_phone	+	|attribute_values
−	|Строка	+	|Массив
−	|Домашний телефон водителя	+	|Массив значений атрибутов
	|-		|-
−	|mobile_phone	+	|&bull; id
−	|Строка	+	|Целое
−	|Мобильный телефон водителя	+	|Идентификатор атрибута
	|-		|-
−	|is_locked	+	|&bull; bool_value
	|true или false		|true или false
−	|Водитель заблокирован	+	|Значение, если тип атрибута «Логический»
	|-		|-
−	|is_dismissed	+	|&bull; num_value
−	|true или false	+	|Дробное
−	|Водитель уволен	+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
	|-		|-
−	|driver_photo	+	|&bull; str_value
−	|Base64	+	|Строка
−	|Фото водителя (только если need_photo = true)	+	|Значение, если тип атрибута «Строка»
	|}		|}
−	Пример:	+	Специальные возвращаемые коды:
−		+	{|
−	<pre>	+	!Код
−	Запрос:	+	!Описание
		+	|-
		+	|100
		+	|Автомобиль с ИД=ID не найден
		+	|-
		+	|101
		+	|Водитель с ИД=ID не найден
		+	|-
		+	|102
		+	|Группа экипажа с ИД=ID не найдена
		+	|-
		+	|103
		+	|Параметр с ИД=ID не найден или не может быть привязан к экипажу
		+	|-
		+	|104
		+	|Экипаж с таким водителем и автомобилем уже существует
		+	|-
		+	|105
		+	|Служба ЕДС автомобиля и водителя не совпадает
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|crew_id
		+	|Целое
		+	|ИД созданного экипажа
		+	|}
		+
		+	Пример:
−	GET https://ip:port/common_api/1.0/get_driver_info?driver_id=1&need_photo=false HTTP/1.1	+	<pre>
		+	Запрос:
		+	POST https://ip:port/common_api/1.0/create_crew HTTP/1.1
	Signature: <...>		Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"car_id":1,
		+	"driver_id":2,
		+	"crew_group_id":3,
		+	"code":"CODE",
		+	"use_shifts":true,
		+	"order_params":[3,4],
		+	"attribute_values": [
		+	{
		+	"id": 1,
		+	"bool_value": true
		+	},
		+	{
		+	"id": 2,
		+	"num_value": 1
		+	},
		+	{
		+	"id": 3,
		+	"num_value": 10
		+	},
		+	{
		+	"id": 4,
		+	"str_value": "строка"
		+	}
		+	]
		+	}
	Ответ:		Ответ:
−
	{		{
	"code":0,		"code":0,
	"descr":"OK",		"descr":"OK",
	"data":{		"data":{
−	"driver_id":1,	+	"crew_id":1
−	"name":"DRIVER_NAME",	+	}
−	"birthday":"01.01.1980",
−	"car_id":1,
−	"license":"1234567890",
−	"home_phone":"123456",
−	"mobile_phone":"+79123456789",
−	"is_locked":false,
−	"is_dismissed":false
−	}
	}		}
	</pre>		</pre>
		+	=== Обновление информации об экипаже ===
		+	Метод: POST
−	=== Запрос списка водителей ===	+	Название запроса: update_crew_info
−	Метод: GET
−	Название запроса: get_drivers_info	+	Параметры в формате JSON:
−	Параметры:
	{|		{|
	!Параметр		!Параметр
Строка 1830:		Строка 2287:
	!Описание		!Описание
	|-		|-
−	!colspan="3"|Небязательные параметры	+	! colspan="3" | Обязательные параметры
	|-		|-
−	|locked_drivers	+	|crew_id
−	|true или false	+	|Целое
−	|Включить в ответ запроса заблокированных водителей (по умолчанию false)	+	|ИД экипажа
	|-		|-
−	|dismissed_drivers	+	! colspan="3" | Необязательные параметры
−	|true или false
−	|Включить в ответ запроса уволенных водителей (по умолчанию false)
−	|}
−
−
−	Специальные возвращаемые коды: нет
−
−	Возвращаемые данные в случае успешного выполнения запроса:
−
−	{|
−	!Параметр
−	!Тип
−	!Описание
	|-		|-
−	|drivers_info	+	|car_id
−	|Массив	+	|Целое
−	|Массив не удаленных водителей	+	|ИД автомобиля
	|-		|-
−	|&bull; driver_id	+	|driver_id
	|Целое		|Целое
	|ИД водителя		|ИД водителя
	|-		|-
−	|&bull; name	+	|crew_group_id
		+	|Целое
		+	|ИД группы экипажа
		+	|-
		+	|code
	|Строка		|Строка
−	|ФИО водителя	+	|Позывной экипажа
	|-		|-
−	|&bull; balance	+	|work_shift_sum
	|Дробное		|Дробное
−	|Баланс водителя	+	|Сумма, списываемая за смену
	|-		|-
−	|&bull; birthday	+	|min_balance
−	|ДД.ММ.ГГГГ	+	|Дробное
−	|День рождения водителя	+	|Минимальный баланс, при котором можно выйти на смену
−	|-
−	|&bull; car_id
−	|Целое
−	|ИД основного автомобиля водителя
	|-		|-
−	|&bull; license	+	|work_time
	|Строка		|Строка
−	|Удостоверение водителя	+	|Время работы, формат: “6.00-10.30, 23:00-00:48”
	|-		|-
−	|&bull; home_phone	+	|has_light_house
−	|Строка	+	|true или false
−	|Домашний телефон водителя	+	|Шашка
	|-		|-
−	|&bull; mobile_phone	+	|has_label
−	|Строка	+	|true или false
−	|Мобильный телефон водителя	+	|Наклейка
	|-		|-
−	|&bull; is_locked	+	|crew_gps_id
−	|true или false	+	|Целое
−	|Водитель заблокирован	+	|GPS идентификатор экипажа
	|-		|-
−	|&bull; is_dismissed	+	|use_plan_shifts
	|true или false		|true или false
−	|Водитель уволен	+	|Запрет работы вне запланированных смен
	|-		|-
−	|&bull; order_params	+	|order_params
	|Массив		|Массив
−	|Массив параметров заказа водителя	+	|Массив параметров экипажа
	|-		|-
	|&bull;		|&bull;
	|Целое		|Целое
−	|ИД параметра заказа	+	|ИД параметра
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Автомобиль с ИД=ID не найден
		+	|-
		+	|101
		+	|Водитель с ИД=ID не найден
		+	|-
		+	|102
		+	|Группа экипажа с ИД=ID не найдена
		+	|-
		+	|103
		+	|Параметр с ИД=ID не найден или не может быть привязан к экипажу
		+	|-
		+	|104
		+	|Экипаж с таким водителем и автомобилем уже существует
		+	|-
		+	|105
		+	|Служба ЕДС автомобиля и водителя не совпадает
		+	|-
		+	|106
		+	|Экипаж с ИД=ID не найден
		+	|-
		+	|107
		+	|Экипаж на линии, запрещено редактирование полей: водитель, автомобиль, позывной, группа экипажа, сумма за смену, минимальный баланс, запрет выхода вне запланированной смены.
	|}		|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет.
	Пример:		Пример:
−
	<pre>		<pre>
−
	Запрос:		Запрос:
−		+	POST https://ip:port/common_api/1.0/update_crew_info
−	GET https://ip:port/common_api/1.0/get_drivers_info HTTP/1.1
	Signature: <...>		Signature: <...>
−	locked_drivers=true&dismissed_drivers=true	+	Content-Type: application/json
		+	Content-Length: 104
		+	{
		+	"crew_id":1,
		+	"car_id":1,
		+	"driver_id":3,
		+	"crew_group_id":3,
		+	"code":"CODE",
		+	"use_plan_shifts":true,
		+	"order_params":[3,4]
		+	}
	Ответ:		Ответ:
−
	{		{
	"code":0,		"code":0,
	"descr":"OK",		"descr":"OK",
−	"data":{	+	"data":{}
−	"drivers_info":[	+	}
−	{	+	</pre>
−	"driver_id":1,	+
−	"name":"DRIVER_NAME1",	+	=== Запрос информации о водителе ===
−	"balance":100.00,
−	"birthday":"01.01.1980",
−	"car_id":1,
−	"license":"1234567890",
−	"home_phone":"123456",
−	"mobile_phone":"+79123456788",
−	"is_locked":false,
−	"is_dismissed":false,
−	"order_params":[3,4]
−	},
−	{
−	"driver_id":2,
−	"name":"DRIVER_NAME2",
−	"balance":-50.00,
−	"birthday":"01.01.1980",
−	"car_id":2,
−	"license":"1234567899",
−	"home_phone":"123457",
−	"mobile_phone":"+79123456789",
−	"is_locked":true,
−	"is_dismissed":true,
−	"order_params":[5,6]
−	}
−	]
−	}
−	}
−
−	</pre>
−
−	=== Запрос информации об автомобиле ===
	Метод: GET		Метод: GET
−	Название запроса: get_car_info	+	Название запроса: get_driver_info
	Параметры:		Параметры:
Строка 1967:		Строка 2419:
	!colspan="3"|Обязательные параметры		!colspan="3"|Обязательные параметры
	|-		|-
−	|car_id	+	|driver_id
	|Целое		|Целое
−	|ИД автомобиля	+	|ИД водителя
	|-		|-
	!colspan="3"|Необязательные параметры		!colspan="3"|Необязательные параметры
Строка 1975:		Строка 2427:
	|need_photo		|need_photo
	|true или false		|true или false
−	|Нужна ли фотография автомобиля	+	|Нужна ли фотография водителя
		+	|-
		+	|fields
		+	|Строка
		+	|Список возвращаемых полей через запятую
	|}		|}
Строка 1984:		Строка 2440:
	|-		|-
	|100		|100
−	|Автомобиль не найден	+	|Водитель не найден
	|}		|}
−	Возвращаемые данные в случае успешного выполнения запроса:	+	Возвращаемые параметры в случае успешного выполнения запроса:
	{|		{|
	!Параметр		!Параметр
Строка 1993:		Строка 2449:
	!Описание		!Описание
	|-		|-
−	|car_id	+	|driver_id
	|Целое		|Целое
−	|ИД автомобиля	+	|ИД водителя
−	|-
−	|code
−	|Строка
−	|Позывной автомобиля
	|-		|-
	|name		|name
	|Строка		|Строка
−	|Наименование автомобиля	+	|ФИО водителя
	|-		|-
−	|gos_number	+	|balance
−	|Строка	+	|Дробное
−	|Государственный номер автомобиля	+	|Баланс основного счета водителя
	|-		|-
−	|color	+	|birthday
−	|Строка	+	|ДД.ММ.ГГГГ
−	|Цвет автомобиля	+	|День рождения водителя
		+	|-
		+	|car_id
		+	|Целое
		+	|ИД основного автомобиля водителя
	|-		|-
−	|mark	+	|license
	|Строка		|Строка
−	|Марка автомобиля	+	|Удостоверение водителя
	|-		|-
−	|model	+	|home_phone
	|Строка		|Строка
−	|Модель автомобиля	+	|Любой неосновной телефон водителя (устаревшее поле)
	|-		|-
−	|short_name	+	|mobile_phone
	|Строка		|Строка
−	|Краткое название автомобиля	+	|Основной телефон водителя (устаревшее поле)
	|-		|-
−	|production_year	+	|is_locked
−	|Целое	+	|true или false
−	|Год выпуска автомобиля	+	|Водитель заблокирован
	|-		|-
−	|is_locked	+	|is_dismissed
	|true или false		|true или false
−	|Автомобиль заблокирован	+	|Водитель уволен
		+	|-
		+	|driver_photo
		+	|Base64
		+	|Фото водителя (только если need_photo = true)
	|-		|-
	|order_params		|order_params
−	|Массив	+	|Массив
−	|Массив параметров заказа автомобиля	+	|Массив параметров водителя
	|-		|-
	|&bull;		|&bull;
	|Целое		|Целое
−	|ИД параметра заказа	+	|ИД параметра
		+	|-
		+	|phones
		+	|Массив
		+	|Массив телефонов водителя
		+	|-
		+	|&bull; phone
		+	|Строка
		+	|Номер телефона
		+	|-
		+	|&bull; is_default
		+	|true или false
		+	|Признак основного телефона
		+	|-
		+	|&bull; use_for_call
		+	|true или false
		+	|Использовать для отзвона
	|-		|-
−	|car_photo	+	|term_account
−	|Base64	+	|Строка
−	|Фото автомобиля (только если need_photo = true)	+	|Терминальный аккаунт
−	|}	+	|-
−		+	|name_for_taxophone
−	Пример:	+	|Строка
−		+	|Имя для TaxoPhone
−	<pre>	+	|-
−	Запрос:	+	|accounts
−		+	|Массив
−	GET https://ip:port/common_api/1.0/get_car_info?car_id=1&need_photo=false HTTP/1.1	+	|Массив балансов счетов
−	Signature: <...>	+	|-
		+	|&bull;account_kind
		+	|Целое
		+	|Тип счета
		+	|-
		+	|&bull;balance
		+	|Дробное
		+	|Баланс счета
		+	|-
		+	|attribute_values
		+	|Массив
		+	|Массив значений атрибутов
		+	|-
		+	|&bull; id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|&bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|&bull; num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|&bull; str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	GET https://ip:port/common_api/1.0/get_driver_info?driver_id=1&need_photo=false
		+	Signature: <...>
	Ответ:		Ответ:
Строка 2060:		Строка 2576:
	"descr":"OK",		"descr":"OK",
	"data":{		"data":{
		+	"driver_id":1,
		+	"name":"DRIVER_NAME",
		+	"balance":100,
		+	"birthday":"01.01.1980",
	"car_id":1,		"car_id":1,
−	"code":"123",	+	"license":"1234567890",
−	"name":"CAR_NAME",	+	"home_phone":"79999999999",
−	"gos_number":"a123bc",	+	"mobile_phone":"79999999999",
−	"color":"COLOR",
−	"mark":"MARK",
−	"model":"MODEL",
−	"short_name":"SHORT_NAME",
−	"production_year":2000,
	"is_locked":false,		"is_locked":false,
−	"order_params":[1,2]	+	"is_dismissed":false,
		+	"order_params":[3,4],
		+	"phones":[
		+	{
		+	"phone":"79999999999",
		+	"is_default":true,
		+	“use_for_call”:true
		+	},
		+	{
		+	"phone":"79999999999",
		+	"is_default":false,
		+	“use_for_call”:false
		+	}
		+	],
		+	"term_account":"00008",
		+	"name_for_taxophone":"NameForTaxoPhone",
		+	"accounts":
		+	[
		+	{
		+	"account_kind":0,
		+	"balance":1000993.00
		+	},
		+	{
		+	"account_kind":1000,
		+	"balance":600.00
		+	}
		+	],
		+	"attribute_values": [
		+	{
		+	"id": 1,
		+	"bool_value": true
		+	},
		+	{
		+	"id": 2,
		+	"num_value": 1
		+	},
		+	{
		+	"id": 3,
		+	"num_value": 10
		+	},
		+	{
		+	"id": 4,
		+	"str_value": "строка"
		+	}
		+	]
	}		}
	}		}
	</pre>		</pre>
−		+	=== Запрос списка водителей ===
−	=== Запрос списка автомобилей ===
−
	Метод: GET		Метод: GET
−	Название запроса: get_cars_info	+	Название запроса: get_drivers_info
	Параметры:		Параметры:
	{|		{|
−	!Параметры	+	!Параметр
	!Тип		!Тип
	!Описание		!Описание
	|-		|-
−	!colspan="3"|Необязательные параметры	+	!colspan="3"|Небязательные параметры
		+	|-
		+	|locked_drivers
		+	|true или false
		+	|Включить в ответ запроса заблокированных водителей (по умолчанию false)
	|-		|-
−	|locked_cars	+	|dismissed_drivers
	|true или false		|true или false
−	|Включить в ответ заблокированных автомобилей (по умолчанию false)	+	|Включить в ответ запроса уволенных водителей (по умолчанию false)
		+	|-
		+	|fields
		+	|Строка
		+	|Список возвращаемых полей через запятую
	|}		|}
Строка 2100:		Строка 2665:
	Возвращаемые данные в случае успешного выполнения запроса:		Возвращаемые данные в случае успешного выполнения запроса:
−	Параметры:
	{|		{|
−	!Параметры	+	!Параметр
	!Тип		!Тип
	!Описание		!Описание
	|-		|-
−	|cars_info	+	|drivers_info
	|Массив		|Массив
−	|Массив автомобилей	+	|Массив не удаленных водителей
	|-		|-
−	|&bull; car_id	+	|&bull; driver_id
	|Целое		|Целое
−	|ИД автомобиля	+	|ИД водителя
	|-		|-
−	|&bull; code	+	|&bull; name
	|Строка		|Строка
−	|Позывной автомобиля	+	|ФИО водителя
	|-		|-
−	|&bull; name	+	|&bull; balance
−	|Строка	+	|Дробное
−	|Наименование автомобиля	+	|Баланс водителя
	|-		|-
−	|&bull; gos_number	+	|&bull; birthday
−	|Строка	+	|ДД.ММ.ГГГГ
−	|Гос. номер автомобиля	+	|День рождения водителя
	|-		|-
−	|&bull; color	+	|&bull; car_id
−	|Строка	+	|Целое
−	|Цвет автомобиля	+	|ИД основного автомобиля водителя
	|-		|-
−	|&bull; mark	+	|&bull; license
	|Строка		|Строка
−	|Марка автомобиля	+	|Номер лицензии на перевозку (разрешения на перевозку)
	|-		|-
−	|&bull; model	+	|&bull; home_phone
	|Строка		|Строка
−	|Модель автомобиля	+	|Любой неосновной телефон водителя (устаревшее поле)
	|-		|-
−	|&bull; short_name	+	|&bull; mobile_phone
	|Строка		|Строка
−	|Краткое название автомобиля	+	|Основной телефон водителя (устаревшее поле)
	|-		|-
−	|&bull; production_year	+	|&bull; is_locked
		+	|true или false
		+	|Водитель заблокирован
		+	|-
		+	|&bull; is_dismissed
		+	|true или false
		+	|Водитель уволен
		+	|-
		+	|&bull; order_params
		+	|Массив
		+	|Массив параметров водителя
		+	|-
		+	|&bull; &bull;
	|Целое		|Целое
−	|Год выпуска автомобиля	+	|ИД параметра
		+	|-
		+	|&bull; phones
		+	|Массив
		+	|Массив телефонов водителя
		+	|-
		+	|&bull; &bull; phone
		+	|Строка
		+	|Номер телефона
	|-		|-
−	|&bull; is_locked	+	|&bull; &bull; is_default
	|true или false		|true или false
−	|Автомобиль заблокирован	+	|Признак основного телефона
		+	|-
		+	|&bull; &bull; use_for_call
		+	|true или false
		+	|Использовать для отзвона
		+	|-
		+	|&bull; term_account
		+	|Строка
		+	|Терминальный аккаунт
	|-		|-
−	|&bull; order_params	+	|&bull; attribute_values
	|Массив		|Массив
−	|Массив параметров заказа автомобиля	+	|Массив значений атрибутов
	|-		|-
−	|&bull;	+	|&bull; &bull; id
	|Целое		|Целое
−	|ИД параметра заказа	+	|Идентификатор атрибута
		+	|-
		+	|&bull; &bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|&bull; &bull; num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|&bull; &bull; str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
	|}		|}
Строка 2162:		Строка 2770:
	<pre>		<pre>
		+
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/get_cars_info HTTP/1.1	+	GET https://ip:port/common_api/1.0/get_drivers_info
	Signature: <...>		Signature: <...>
−	locked_cars=true	+	locked_drivers=true&dismissed_drivers=true
Строка 2175:		Строка 2784:
	"descr":"OK",		"descr":"OK",
	"data":{		"data":{
−	"cars_info":[	+	"drivers_info":[
−	{	+	{
−	"car_id":1,	+	"driver_id":1,
−	"code":"111",	+	"name":"DRIVER_NAME1",
−	"name":"CAR_1",	+	"balance":100.00,
−	"gos_number":"111111",	+	"birthday":"01.01.1980",
−	"color":"COLOR_1",	+	"car_id":1,
−	"mark":"MARK_1",	+	"license":"1234567890",
−	"model":"MODEL_1",	+	"home_phone":"79999999999",
−	"short_name":"SHORT_NAME_1",	+	"mobile_phone":"79999999999",
−	"production_year":2000,	+	"is_locked":false,
−	"is_locked":false,	+	"is_dismissed":false,
−	"order_params":[1,2]	+	"order_params":[3,4],
−	},	+	"phones":[
−	{	+	{
−	"car_id":2,	+	"phone":"79999999999",
−	"code":"222",	+	"is_default":true,
−	"name":"CAR_2",	+	“use_for_call”: true
−	"gos_number":"222222",
−	"color":"COLOR_2",
−	"mark":"MARK_2",
−	"model":"MODEL_2",
−	"short_name":"SHORT_NAME_2",
−	"production_year":2000,
−	"is_locked":false,
−	"order_params":[3,4]
−	}
−	]
−	}
−	}
−	</pre>	+	},
		+	{
		+	"phone":"79999999999",
		+	"is_default":false,
		+	“use_for_call”: true
−	=== Запрос координат экипажей ===	+	}
−	Метод: GET	+	],
		+	"term_account":"00008",
		+	"attribute_values": [
		+	{
		+	"id": 3,
		+	"num_value": 10
		+	},
		+	{
		+	"id": 4,
		+	"str_value": "строка"
		+	}
		+	]
		+	},
		+	{
		+	"driver_id":2,
		+	"name":"DRIVER_NAME2",
		+	"balance":-50.00,
		+	"birthday":"01.01.1980",
		+	"car_id":2,
		+	"license":"1234567899",
		+	"is_locked":true,
		+	"is_dismissed":true,
		+	"order_params":[5,6],
		+	"phones":[
		+	{
		+	"phone":"79999999999",
		+	"is_default":true,
		+	“use_for_call”: true
		+	},
		+	{
		+	"phone":"79999999999",
		+	"is_default":false,
		+	“use_for_call”: false
		+	}
		+	],
		+	"term_account":"00009",
		+	"attribute_values": [
		+	{
		+	"id": 3,
		+	"num_value": 10
		+	},
		+	{
		+	"id": 4,
		+	"str_value": "строка"
		+	}
		+	]
		+	}
		+	]
		+	}
		+	}
		+
		+	</pre>
−	Название запроса: get_crews_coords	+	=== Создание водителя ===
		+	Метод: POST
−	Параметры:	+	Название запроса: create_driver
−	{|
−	!Параметры
−	!Тип
−	!Описание
−	|-
−	!colspan="3"|Необязательные параметры
−	|-
−	|crew_id
−	|Целое
−	|ИД экипажа, по которому нужно вернуть координаты. Если не задано, то будут возвращены координаты всех экипажей на линии.
−	|}
−	Специальные возвращаемые коды:	+	Параметры в формате JSON:
−	{|
−	!Код
−	!Описание
−	|-
−	|100
−	|Координаты не найдены
−	|}
−	Возвращаемые данные в случае успешного выполнения запроса:
	{|		{|
	!Параметр		!Параметр
Строка 2241:		Строка 2875:
	!Описание		!Описание
	|-		|-
−	|crews_coords	+	!colspan="3"|Обязательные параметры
−	|Массив	+	|-
−	|Список координат экипажей	+	|name
		+	|Строка
		+	|ФИО водителя
	|-		|-
−	|&bull; crew_id	+	|car_id
	|Целое		|Целое
−	|ИД экипажа	+	|ИД основного автомобиля
	|-		|-
−	|&bull; crew_code	+	|password
	|Строка		|Строка
−	|Позывной экипажа	+	|Пароль (обязательное поле, если используется сервер связи с водителями)
	|-		|-
−	|&bull; coords_time	+	|uds_id
		+	|Целое
		+	|ИД службы ЕДС (обязательное поле, если используется ЕДС, иначе можно не указывать)
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|home_phone
		+	|Строка
		+	|Неосновной телефон водителя (устаревший параметр)
		+	|-
		+	|mobile_phone
		+	|Строка
		+	|Основной телефон водителя (устаревший параметр)
		+	|-
		+	|passport
		+	|Строка
		+	|Паспортные данные
		+	|-
		+	|driver_license
		+	|Строка
		+	|Водительское удостоверение
		+	|-
		+	|employee_type
		+	|Целое
		+	|Тип работника (0 - работник компании, 1 - частник)
		+	|-
		+	|birthday
		+	|ГГГГММДДччммсс
		+	|День рождения
		+	|-
		+	|number
		+	|Строка
		+	|Табельный номер
		+	|-
		+	|license
		+	|Строка
		+	|Удостоверение
		+	|-
		+	|start_date
	|ГГГГММДДччммсс		|ГГГГММДДччммсс
−	|Время получения координат	+	|Дата приема на работу
	|-		|-
−	|&bull; lat	+	|lic_date
−	|Дробное	+	|ГГГГММДДччммсс
−	|Долгота	+	|Дата окончания договора
	|-		|-
−	|&bull; lon	+	|term_account
−	|Дробное	+	|Строка
−	|Широта	+	|Терминальный аккаунт (если не указан, будет сгенерирован автоматически), должен состоять из 5 цифр
	|-		|-
−	|&bull; state_kind	+	|comment
	|Строка		|Строка
−	|Тип состояния экипажа. Может принимать значения:	+	|Описание
−	• "not_available" — экипаж не на линии	+	|-
−		+	|order_params
−	• "waiting" — экипаж свободен, ожидает заказы	+	|Массив
−		+	|Массив параметров водителя. Устарело. Рекомендуется использовать параметр attribute_values.
−	• "on_order" — экипаж на заказе	+	|-
−		+	|&bull;
−	• "on_break" — экипаж на перерыве	+	|Целое
−	|}	+	|ИД параметра
−		+	|-
−	Пример:	+	|driver_photo
		+	|Base64
		+	|Фотография водителя
		+	|-
		+	|phones
		+	|Массив
		+	|Массив телефонов водителя
		+	|-
		+	|&bull; phone
		+	|Строка
		+	|Номер телефона
		+	|-
		+	|&bull; is_default
		+	|true или false
		+	|Признак основного телефона
		+	|-
		+	|&bull; use_for_call
		+	|true или false
		+	|Использовать для отзвона
		+	|-
		+	|name_for_taxophone
		+	|Строка
		+	|Имя для TaxoPhone
		+	|-
		+	|attribute_values
		+	|Массив
		+	|Массив значений атрибутов
		+	|-
		+	|&bull; id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|&bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|&bull; num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|&bull; str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
		+	|}
−	<pre>	+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Автомобиль с ИД=ID не найден
		+	|-
		+	|101
		+	|Служба ЕДС с ИД=ID не найдена
		+	|-
		+	|102
		+	|Параметр с ИД=ID не найден или не может быть привязан к водителю
		+	|-
		+	|103
		+	|Терминальный аккаунт не уникален
		+	|-
		+	|104
		+	|Некорректный терминальный аккаунт
		+	|-
		+	|107
		+	|Основной телефон может быть только один
		+	|-
		+	|108
		+	|Водитель должен иметь основной телефон
		+	|-
		+	|109
		+	|Пароль водителя не соответствует политике паролей
		+	|}
−	Запрос:	+	Возвращаемые данные в случае успешного выполнения запроса:
−	GET https://ip:port/common_api/1.0/get_crews_coords HTTP/1.1	+	{|
−	Signature: <...>	+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|driver_id
		+	|Целое
		+	|ИД созданного водителя
		+	|}
−	Ответ:	+	Пример:
		+	<pre>
		+	Запрос:
		+	POST https://ip:port/common_api/1.0/create_driver HTTP/1.1
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
	{		{
−	"code":0,	+	"name":"NAME",
−	"descr":"OK",	+	"car_id":140,
−	"data":{	+	"password":"PASSWORD",
−	"crews_coords":[	+	"birthday":"19930218000000",
		+	"comment":"COMMENT",
		+	"order_params":[3,4],
		+	"name_for_taxophone":"NameForTaxoPhone",
		+	"phones":[
		+	{
		+	"phone":"79999999999",
		+	"is_default":true,
		+	“use_for_call”: true
		+	},
		+	{
		+	"phone":"79999999999",
		+	"is_default":false,
		+	“use_for_call”: true
		+	}
		+	],
		+	"attribute_values": [
		+	{
		+	"id": 1,
		+	"bool_value": true
		+	},
		+	{
		+	"id": 2,
		+	"num_value": 1
		+	},
		+	{
		+	"id": 3,
		+	"num_value": 10
		+	},
	{		{
−	"crew_id":1,	+	"id": 4,
−	"crew_code":"111",	+	"str_value": "строка"
−	"coords_time":"20120101101010",
−	"lat":11.111111,
−	"lon":22.222222,
−	"state_kind":"waiting"
−	},
−	{
−	"crew_id":2,
−	"crew_code":"222",
−	"coords_time":"20120101101010",
−	"lat":33.333333,
−	"lon":44.444444,
−	"state_kind":"on_order"
	}		}
−	]	+	]
−	}
	}		}
−
−	Запрос:
−
−	GET https://ip:port/common_api/1.0/get_crews_coords?crew_id=1 HTTP/1.1
−	Signature: <...>
	Ответ:		Ответ:
−
	{		{
	"code":0,		"code":0,
	"descr":"OK",		"descr":"OK",
	"data":{		"data":{
−	"crews_coords":[	+	"driver_id":10
−	{	+	}
−	"crew_id":1,	+	}
−	"crew_code":"111",	+	</pre>
−	"coords_time":"20120101101010",	+
−	"lat":11.111111,	+	=== Обновление информации о водителе ===
−	"lon":22.222222,	+	Метод: POST
−	"state_kind":"waiting"
−	}
−	]
−	}
−	}
−	</pre>
−	=== Запрос адресов, содержащих нужную строку ===	+	Название запроса: update_driver_info
−	Метод: GET
−	Название запроса: get_addresses_like	+	Параметры в формате JSON:
−
−	Параметры:
	{|		{|
−	!Параметры	+	!Параметр
	!Тип		!Тип
	!Описание		!Описание
	|-		|-
−	! colspan="3"|Обязательные параметры	+	!colspan="3"|Обязательные параметры
		+	|-
		+	|driver_id
		+	|Целое
		+	|ИД редактируемого водителя
	|-		|-
−	|get_streets	+	!colspan="3"|Необязательные параметры
−	|true или false
−	|Искать улицы
	|-		|-
−	|get_houses	+	|name
−	|true или false	+	|Строка
−	|Искать дома. Не может быть равно true, если get_streets = true или get_points = true.	+	|ФИО водителя
	|-		|-
−	|get_points	+	|car_id
−	|true или false	+	|Целое
−	|Искать пункты.	+	|ИД основного автомобиля
	|-		|-
−	|street	+	|password
	|Строка		|Строка
−	|Часть названия улицы или пункта, если идет поиск улиц или пунктов, или полное название улицы, если идет поиск домов	+	|Пароль
	|-		|-
−	!colspan="3"|Необязательные параметры	+	|uds_id
		+	|Целое
		+	|ИД службы ЕДС (обязательное поле, если используется ЕДС, иначе можно не указывать)
	|-		|-
−	|house	+	|home_phone
	|Строка		|Строка
−	|Часть номера дома. Нужно только если get_houses = true.	+	|Неосновной телефон водителя (устаревший параметр)
	|-		|-
−	|max_addresses_count	+	|mobile_phone
−	|Целое	+	|Строка
−	|Максимальное количество адресов в ответе	+	|Основной телефон водителя (устаревший параметр)
−	|}
−
−	Специальные возвращаемые коды:
−	{|
−	!Код
−	!Описание
	|-		|-
−	|100	+	|passport
−	|Подходящие адреса не найдены	+	|Строка
−	|}	+	|Паспортные данные
−		+	|-
−	Возвращаемые данные в случае успешного выполнения запроса:	+	|driver_license
−	{|	+	|Строка
−	!Параметр	+	|Водительское удостоверение
−	!Тип	+	|-
−	!Описание	+	|employee_type
		+	|Целое
		+	|Тип работника (0 - работник компании, 1 - частник)
		+	|-
		+	|birthday
		+	|ГГГГММДДччммсс
		+	|День рождения
	|-		|-
−	|addresses	+	|number
−	|Массив	+	|Строка
−	|Список подходящих адресов	+	|Табельный номер
	|-		|-
−	|&bull; street	+	|license
	|Строка		|Строка
−	|Название улицы или пункта	+	|Удостоверение
		+	|-
		+	|start_date
		+	|ГГГГММДДччммсс
		+	|Дата приема на работу
		+	|-
		+	|lic_date
		+	|ГГГГММДДччммсс
		+	|Дата окончания договора
	|-		|-
−	|&bull; house	+	|term_account
	|Строка		|Строка
−	|Номер дома	+	|Терминальный аккаунт
	|-		|-
−	|&bull; kind	+	|comment
	|Строка		|Строка
−	|Тип адреса. Может принимать значения:	+	|Описание
−	• "street" — улица	+	|-
−		+	|time_block
−	• "house" — дом	+	|ГГГГММДДччммсс
−		+	|Временная блокировка до
−	• "point" — пункт	+	|-
		+	|is_locked
		+	|true или false
		+	|Заблокирован
	|-		|-
−	|&bull; comment	+	|lock_description
	|Строка		|Строка
−	|Комментарий	+	|Причина блокировки
−	|}	+	|-
−		+	|is_dismissed
−	Пример:	+	|true или false
−		+	|Уволен
−	<pre>	+	|-
−		+	|dismiss_description
−	Запрос:	+	|Строка
−		+	|Причина увольнения
−	GET https://ip:port/common_api/1.0/get_addresses_like?get_streets=true&get_points=true&	+	|-
−	get_houses=false&street=STREE HTTP/1.1	+	|order_params
−	Signature: <...>	+	|Массив
		+	|Массив параметров водителя. Устарело. Рекомендуется использовать параметр attribute_values.
		+	|-
		+	|&bull;
		+	|Целое
		+	|ИД параметра
		+	|-
		+	|driver_photo
		+	|Base64
		+	|Фотография водителя
		+	|-
		+	|phones
		+	|Массив
		+	|Массив телефонов водителя
		+	|-
		+	|&bull; phone
		+	|Строка
		+	|Номер телефона
		+	|-
		+	|&bull; is_default
		+	|true или false
		+	|Признак основного телефона
		+	|-
		+	|&bull; use_for_call
		+	|true или false
		+	|Использовать для отзвона
		+	|-
		+	|name_for_taxophone
		+	|Строка
		+	|Имя для TaxoPhone
		+	|-
		+	|attribute_values
		+	|Массив
		+	|Массив значений атрибутов
		+	|-
		+	|&bull; id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|&bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|&bull; num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|&bull; str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
		+	|}
−	Ответ:	+	Специальные возвращаемые коды:
−		+	{|
−	{	+	!Код
−	"code":0,	+	!Описание
−	"descr":"OK",	+	|-
−	"data":{	+	|100
−	"addresses":[	+	|Автомобиль с ИД=ID не найден
−	{	+	|-
−	"street":"STREET1",	+	|101
−	"house":"",	+	|Служба ЕДС с ИД=ID не найдена
−	"kind":"street",	+	|-
−	"comment":""	+	|102
		+	|Параметр с ИД=ID не найден или не может быть привязан к водителю
		+	|-
		+	|103
		+	|Терминальный аккаунт не уникален
		+	|-
		+	|104
		+	|Некорректный терминальный аккаунт
		+	|-
		+	|105
		+	|Водитель с ИД=ID не найден
		+	|-
		+	|106
		+	|Экипаж на линии, запрещено редактирование полей: основной автомобиль, тип работника, служба ЕДС.
		+	|-
		+	|107
		+	|Основной телефон может быть только один
		+	|-
		+	|108
		+	|Водитель должен иметь основной телефон
		+	|-
		+	|109
		+	|Пароль водителя не соответствует политике паролей
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет.
		+
		+	Пример:
		+	<pre>
		+	Запрос:
		+	POST https://ip:port/common_api/1.0/update_driver_info HTTP/1.1
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"driver_id":10
		+	"name":"NAME",
		+	"car_id":140,
		+	"password":"PASSWORD",
		+	"birthday":"19930218000000",
		+	"comment":"COMMENT",
		+	"order_params":[3,4],
		+	"name_for_taxophone":"NameForTaxoPhone",
		+	"phones":[
		+	{
		+	"phone":"79999999999",
		+	"is_default":true,
		+	“use_for_call”: true
		+	},
		+	{
		+	"phone":"79999999999",
		+	"is_default":false,
		+	“use_for_call”: false
		+	}
		+	],
		+	"attribute_values": [
		+	{
		+	"id": 1,
		+	"bool_value": true
		+	},
		+	{
		+	"id": 2,
		+	"num_value": 1
	},		},
	{		{
−	"street":"STREET2",	+	"id": 3,
−	"house":"",	+	"num_value": 10
−	"kind":"street",
−	"comment":""
	},		},
	{		{
−	"street":"POINT_STREET1",	+	"id": 4,
−	"house":"",	+	"str_value": "строка"
−	"kind":"point",
−	"comment":"Point at street STREET1"
	}		}
−	]	+	]
−	}
	}		}
−
−	Запрос:
−
−	GET https://ip:port/common_api/1.0/get_addresses_like?get_streets=false&get_points=false&
−	get_houses=true&street=STREET1&house=1&max_addresses_count=10 HTTP/1.1
−	Signature: <...>
−
	Ответ:		Ответ:
−
	{		{
	"code":0,		"code":0,
	"descr":"OK",		"descr":"OK",
−	"data":{	+	"data":{}
−	"addresses":[
−	{
−	"street":"STREET1",
−	"house":"1",
−	"kind":"house",
−	"comment":""
−	},
−	{
−	"street":"STREET1",
−	"house":"10",
−	"kind":"house",
−	"comment":""
−	},
−	{
−	"street":"STREET1",
−	"house":"11",
−	"kind":"house",
−	"comment":""
−	}
−	]
−	}
	}		}
	</pre>		</pre>
−	=== Анализ маршрута ===	+	=== Запрос информации об автомобиле ===
	Метод: GET		Метод: GET
−	Название запроса: analyze_route	+	Название запроса: get_car_info
	Параметры:		Параметры:
−
	{|		{|
	!Параметры		!Параметры
Строка 2508:		Строка 3367:
	!colspan="3"|Обязательные параметры		!colspan="3"|Обязательные параметры
	|-		|-
−	|source	+	|car_id
−	|Строка	+	|Целое
−	|Адрес подачи	+	|ИД автомобиля
−	|-
−	|dest
−	|Строка
−	|Адрес назначения
	|-		|-
	!colspan="3"|Необязательные параметры		!colspan="3"|Необязательные параметры
	|-		|-
−	|source_lon	+	|need_photo
−	|Дробное	+	|true или false
−	|Долгота адреса подачи	+	|Нужна ли фотография автомобиля
	|-		|-
−	|source_lat	+	|fields
−	|Дробное	+	|Строка
−	|Широта адреса подачи	+	|Список возвращаемых полей через запятую
−	|-
−	|dest_lon
−	|Дробное
−	|Долгота адреса назначения
−	|-
−	|dest_lat
−	|Дробное
−	|Широта адреса назначения
	|}		|}
−		+	Специальные возвращаемые коды:
−	Параметр source не является обязательным к заполнению, если заданы source_lon и source_lat.
−
−	Параметр dest не является обязательным к заполнению, если заданы dest_lon и dest_lat.
−
−
−	Специальные возвращаемые коды:
	{|		{|
	!Код		!Код
Строка 2547:		Строка 3388:
	|-		|-
	|100		|100
−	|Адрес подачи не распознан	+	|Автомобиль не найден
−	|-
−	|101
−	|Адрес назначения не распознан
−	|-
−	|102
−	|Маршрут не распознан
	|}		|}
Строка 2562:		Строка 3397:
	!Описание		!Описание
	|-		|-
−	|source_lat	+	|car_id
−	|Дробное	+	|Целое
−	|Широта адреса подачи	+	|ИД автомобиля
	|-		|-
−	|source_lon	+	|code
−	|Дробное	+	|Строка
−	|Долгота адреса подачи	+	|Позывной автомобиля
	|-		|-
−	|source_zone_id	+	|name
−	|Целое	+	|Строка
−	|ИД района подачи	+	|Наименование автомобиля
	|-		|-
−	|dest_lat	+	|gos_number
−	|Дробное	+	|Строка
−	|Широта адреса назначения	+	|Государственный номер автомобиля
	|-		|-
−	|dest_lon	+	|color
−	|Дробное	+	|Строка
−	|Долгота адреса назначения	+	|Цвет автомобиля
	|-		|-
−	|dest_zone_id	+	|mark
−	|Целое	+	|Строка
−	|ИД района назначения	+	|Марка автомобиля
	|-		|-
−	|city_dist	+	|model
−	|Дробное	+	|Строка
−	|Километраж по городу	+	|Модель автомобиля
	|-		|-
−	|country_dist	+	|short_name
		+	|Строка
		+	|Краткое название автомобиля
		+	|-
		+	|production_year
		+	|Целое
		+	|Год выпуска автомобиля
		+	|-
		+	|is_locked
		+	|true или false
		+	|Автомобиль заблокирован
		+	|-
		+	|fuel_level
	|Дробное		|Дробное
−	|Километраж за городом	+	|Уровень топлива в автомобиле
		+	|-
		+	|order_params
		+	|Массив
		+	|Массив параметров автомобиля. Устарело. Рекомендуется использовать параметр attribute_values.
		+	|-
		+	|&bull;
		+	|Целое
		+	|ИД параметра
		+	|-
		+	|car_photo
		+	|Base64
		+	|Фото автомобиля (только если need_photo = true или поле driver_photo указано в списке фильтра полей fields)
		+	|-
		+	|attribute_values
		+	|Массив
		+	|Массив значений атрибутов
		+	|-
		+	|&bull; id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|&bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
	|-		|-
−	|source_country_dist	+	|&bull; num_value
	|Дробное		|Дробное
−	|Километраж до адреса подачи, если адрес подачи за городом	+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|&bull; str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
	|}		|}
Строка 2604:		Строка 3483:
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/analyze_route?source=STREET1,1&dest=STREET2,2&source_lon=	+	GET https://ip:port/common_api/1.0/get_car_info?car_id=1&need_photo=false
−	53.153044&source_lat=56.893301&dest_lon=53.218103&dest_lat=56.869759 HTTP/1.1
	Signature: <...>		Signature: <...>
Строка 2614:		Строка 3492:
	"descr":"OK",		"descr":"OK",
	"data":{		"data":{
−	"source_lat":11.111111,	+	"car_id":1,
−	"source_lon":22.222222,	+	"code":"123",
−	"source_zone_id":1,	+	"name":"CAR_NAME",
−	"dest_lat":33.333333,	+	"gos_number":"a123bc",
−	"dest_lon":44.444444,	+	"color":"COLOR",
−	"dest_zone_id":2,	+	"mark":"MARK",
−	"city_dist":1.1,	+	"model":"MODEL",
−	"country_dist":2.2,	+	"short_name":"SHORT_NAME",
−	"source_country_dist":3.3	+	"production_year":2000,
		+	"is_locked":false,
		+	"order_params":[1,2],
		+	"attribute_values": [
		+	{
		+	"id": 1,
		+	"bool_value": true
		+	},
		+	{
		+	"id": 2,
		+	"num_value": 1
		+	},
		+	{
		+	"id": 3,
		+	"num_value": 10
		+	},
		+	{
		+	"id": 4,
		+	"str_value": "строка"
		+	}
		+	]
	}		}
	}		}
	</pre>		</pre>
−	=== Анализ маршрута 2 ===	+	=== Запрос списка автомобилей ===
	Метод: GET		Метод: GET
−	Название запроса: analyze_route2	+	Название запроса: get_cars_info
	Параметры:		Параметры:
−
	{|		{|
−	!Параметр	+	!Параметры
	!Тип		!Тип
	!Описание		!Описание
	|-		|-
−	!colspan="3"|Обязательные параметры	+	!colspan="3"|Необязательные параметры
	|-		|-
−	|addresses	+	|locked_cars
−	|Массив	+	|true или false
−	|Массив адресов. Первый элемент — адрес подачи, последний — адрес назначения, между ними — остановки.	+	|Включить в ответ заблокированных автомобилей (по умолчанию false)
	|-		|-
−	|&bull; address	+	|fields
	|Строка		|Строка
−	|Адрес подачи	+	|Список возвращаемых полей через запятую
−	|-
−	|&bull; lat
−	|Дробное
−	|Широта адреса
−	|-
−	|&bull; lon
−	|Дробное
−	|Долгота адреса
	|}		|}
−	Специальные возвращаемые коды:
−	{|	+	Специальные возвращаемые коды: нет
−	!Код
−	!Описание
−	|-
−	|100
−	|Маршрут не распознан
−	|}
	Возвращаемые данные в случае успешного выполнения запроса:		Возвращаемые данные в случае успешного выполнения запроса:
Строка 2676:		Строка 3558:
	!Описание		!Описание
	|-		|-
−	|Addresses	+	|crews_info
	|Массив		|Массив
−	|Массив адресов. Первый элемент — адрес подачи, последний — адрес назначения, между ними — остановки.	+	|Массив автомобилей
	|-		|-
−	|&bull; lat	+	|&bull; car_id
−	|Дробное	+	|Целое
−	|Широта адреса	+	|ИД автомобиля
	|-		|-
−	|&bull; lon	+	|&bull; code
−	|Дробное	+	|Строка
−	|Долгота адреса	+	|Позывной автомобиля
	|-		|-
−	|&bull; zone_id	+	|&bull; name
−	|Целое	+	|Строка
−	|Район адреса	+	|Наименование автомобиля
	|-		|-
−	|&bull; parking_id	+	|&bull; gos_number
		+	|Строка
		+	|Гос. номер автомобиля
		+	|-
		+	|&bull; color
		+	|Строка
		+	|Цвет автомобиля
		+	|-
		+	|&bull; mark
		+	|Строка
		+	|Марка автомобиля
		+	|-
		+	|&bull; model
		+	|Строка
		+	|Модель автомобиля
		+	|-
		+	|&bull; short_name
		+	|Строка
		+	|Краткое название автомобиля
		+	|-
		+	|&bull; production_year
	|Целое		|Целое
−	|Стоянка адреса	+	|Год выпуска автомобиля
		+	|-
		+	|&bull; is_locked
		+	|true или false
		+	|Автомобиль заблокирован
	|-		|-
−	|city_dist	+	|&bull; fuel_level
	|Дробное		|Дробное
−	|Километраж по городу	+	|Уровень топлива в автомобиле
		+	|-
		+	|&bull; order_params
		+	|Массив
		+	|Массив параметров автомобиля. Устарело. Рекомендуется использовать параметр attribute_values.
		+	|-
		+	|&bull; &bull;
		+	|Целое
		+	|ИД параметра
		+	|-
		+	|&bull; attribute_values
		+	|Массив
		+	|Массив значений атрибутов
		+	|-
		+	|&bull; &bull; id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|&bull; &bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
	|-		|-
−	|country_dist	+	|&bull; &bull; num_value
	|Дробное		|Дробное
−	|Километраж за городом	+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
	|-		|-
−	|source_country_dist	+	|&bull; &bull; str_value
−	|Дробное	+	|Строка
−	|Километраж до адреса подачи, если адрес подачи за городом.	+	|Значение, если тип атрибута «Строка»
	|}		|}
Строка 2712:		Строка 3642:
	<pre>		<pre>
−
	Запрос:		Запрос:
−	POST /common_api/1.0/analyze_route2 HTTP/1.1	+	GET https://ip:port/common_api/1.0/get_cars_info
−	Host: ip:port
−	Keep-Alive: 300
−	Connection: keep-alive
−	Content-Type: application/json
−	Content-Length: 243
	Signature: <...>		Signature: <...>
−		+	locked_cars=true
−	{"addresses":[{"address":"STREET1, 1","lat":11.111111,"lon":22.222222},{"address":"STREET2,
−	2","lat":33.333333,"lon":44.444444},{"address":"STREET3, 3","lat":55.555555,"lon":55.555555},
−	{"address":"STREET4, 4","lat":77.777777,"lon":88.888888}]}
Строка 2734:		Строка 3655:
	"descr":"OK",		"descr":"OK",
	"data":{		"data":{
−	"addresses":[	+	"crews_info":[
	{		{
−	"lat":11.111111,	+	"car_id":1,
−	"lon":22.222222,	+	"code":"111",
−	"zone_id":1,	+	"name":"CAR_1",
−	"parking_id":1	+	"gos_number":"111111",
		+	"color":"COLOR_1",
		+	"mark":"MARK_1",
		+	"model":"MODEL_1",
		+	"short_name":"SHORT_NAME_1",
		+	"production_year":2000,
		+	"is_locked":false,
		+	"order_params":[1,2],
		+	"attribute_values": [
		+	{
		+	"id": 1,
		+	"bool_value": true
		+	},
		+	{
		+	"id": 2,
		+	"num_value": 1
		+	}
		+	]
	},		},
	{		{
−	"lat":33.333333,	+	"car_id":2,
−	"lon":44.444444,	+	"code":"222",
−	"zone_id":2,	+	"name":"CAR_2",
−	"parking_id":2	+	"gos_number":"222222",
		+	"color":"COLOR_2",
		+	"mark":"MARK_2",
		+	"model":"MODEL_2",
		+	"short_name":"SHORT_NAME_2",
		+	"production_year":2000,
		+	"is_locked":false,
		+	"order_params":[3,4],
		+	"attribute_values": [
		+	{
		+	"id": 3,
		+	"num_value": 10
		+	},
		+	{
		+	"id": 4,
		+	"str_value": "строка"
		+	}
		+	]
	}		}
−	],	+	]
−	"city_dist":0,
−	"country_dist":2.647,
−	"source_country_dist":3.412
	}		}
	}		}
Строка 2756:		Строка 3708:
	</pre>		</pre>
−	=== Запрос информации о состоянии заказа ===	+	=== Создание автомобиля ===
−	Метод: GET	+	Метод: POST
−	Название запроса: get_order_state	+	Название запроса: create_car
−
−	Параметры:
		+	Параметры в формате JSON:
	{|		{|
	!Параметры		!Параметры
Строка 2771:		Строка 3722:
	!colspan="3"|Обязательные параметры		!colspan="3"|Обязательные параметры
	|-		|-
−	|order_id	+	|code
−	|Целое	+	|Строка
−	|ИД заказа	+	|Позывной
−	|}	+	|-
−		+	|mark
−	Специальные возвращаемые коды:	+	|Строка
−	{|	+	|Марка
−	!Код	+	|-
−	!Описание	+	|color
		+	|Строка
		+	|Цвет
	|-		|-
−	|100	+	|gos_number
−	|Заказ не найден	+	|Строка
−	|}	+	|Государственный номер
−
−	Возвращаемые данные в случае успешного выполнения запроса:
−	{|
−	!Параметр
−	!Тип
−	!Описание
	|-		|-
−	|order_id	+	|uds_id
	|Целое		|Целое
−	|ИД заказа	+	|ИД службы ЕДС (обязательное поле, если используется ЕДС, иначе можно не указывать)
	|-		|-
−	|state_id	+	!colspan="3"|Необязательные параметры
−	|Целое
−	|ИД состояния заказа
	|-		|-
−	|state_kind	+	|model
−	|Строка	+	|Строка
−	|Тип состояния заказа. Может принимать значения:	+	|Модель
−
−	• "new_order" — новый заказ
−
−	• "driver_assigned" — водитель назначен
−
−	• "car_at_place" — машина подъехала на место
−
−	• "client_inside" — клиент в машине
−
−	• "finished" — заказ успешно завершен
−
−	• "aborted" — заказ прекращен
	|-		|-
−	|crew_id	+	|short_name
−	|Целое	+	|Строка
−	|ИД экипажа	+	|Краткое название
	|-		|-
−	|prior_crew_id	+	|production_year
−	|Целое
−	|ИД предварительного экипажа
−	|-
−	|driver_id
	|Целое		|Целое
−	|ИД водителя	+	|Год выпуска
	|-		|-
−	|car_id	+	|car_class
−	|Целое	+	|Строка
−	|ИД автомобиля	+	|Класс автомобиля (A, B, C, ...)
	|-		|-
−	|start_time	+	|vin
−	|ГГГГММДДччммсс	+	|Строка
−	|Время создания заказа	+	|VIN
−	|-
−	|source_time
−	|ГГГГММДДччммсс
−	|Время подачи
−	|-
−	|finish_time
−	|ГГГГММДДччммсс
−	|Время завершения заказа
	|-		|-
−	|source	+	|body_number
	|Строка		|Строка
−	|Адрес подачи	+	|Номер кузова
	|-		|-
−	|destination	+	|engine_number
	|Строка		|Строка
−	|Адрес назначения	+	|Номер двигателя
	|-		|-
−	|passenger	+	|permit
	|Строка		|Строка
−	|Пассажир	+	|Разрешение на перевозку
	|-		|-
−	|phone	+	|comment
	|Строка		|Строка
−	|Номер телефона	+	|Описание
	|-		|-
−	|client_id	+	|order_params
		+	|Массив
		+	|Массив параметров автомобиля. Устарело. Рекомендуется использовать параметр attribute_values.
		+	|-
		+	|&bull;
	|Целое		|Целое
−	|ИД клиента	+	|ИД параметра
		+	|-
		+	|car_photo
		+	|Base64
		+	|Фотография автомобиля
	|-		|-
−	|order_crew_group_id	+	|attribute_values
−	|Целое	+	|Массив
−	|ИД группы экипажей, которая указана в заказе	+	|Массив значений атрибутов
	|-		|-
−	|tariff_id	+	|&bull; id
	|Целое		|Целое
−	|ИД тарифа	+	|Идентификатор атрибута
	|-		|-
−	|car_mark	+	|&bull; bool_value
−	|Строка	+	|true или false
−	|Марка автомобиля	+	|Значение, если тип атрибута «Логический»
	|-		|-
−	|car_model	+	|&bull; num_value
−	|Строка	+	|Дробное
−	|Модель автомобиля	+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
	|-		|-
−	|car_color	+	|&bull; str_value
	|Строка		|Строка
−	|Цвет автомобиля	+	|Значение, если тип атрибута «Строка»
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
	|-		|-
−	|car_number	+	|100
−	|Строка	+	|Автомобиль с ИД=ID имеет такой же позывной=CODE
−	|Государственный номер автомобиля
	|-		|-
−	|crew_coords	+	|101
−	|Массив	+	|Служба ЕДС не найдена
−	|Координаты экипажа
	|-		|-
−	|&bull; lat	+	|0
−	|Дробное	+	|Параметр с ИД=ID не найден или не может быть привязан к автомобилю
−	|Широта	+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
	|-		|-
−	|&bull; lon	+	|car_id
−	|Дробное	+	|Целое
−	|Долгота	+	|ИД созданного автомобиля
	|}		|}
Строка 2904:		Строка 3847:
	<pre>		<pre>
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/get_order_state?order_id=1 HTTP/1.1	+	POST https://ip:port/common_api/1.0/create_car HTTP/1.1
	Signature: <...>		Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"code":"CODE",
		+	"mark":"MARK",
		+	"model":"MODEL",
		+	"color":"BLACK",
		+	"gos_number":"NUMBER",
		+	"production_year":2000,
		+	"comment":"COMMENT",
		+	"order_params":[1,2,3,4],
		+	"attribute_values": [
		+	{
		+	"id": 1,
		+	"bool_value": true
		+	},
		+	{
		+	"id": 2,
		+	"num_value": 1
		+	},
		+	{
		+	"id": 3,
		+	"num_value": 10
		+	},
		+	{
		+	"id": 4,
		+	"str_value": "строка"
		+	}
		+	]
		+	}
		+
	Ответ:		Ответ:
	{		{
Строка 2911:		Строка 3886:
	"descr":"OK",		"descr":"OK",
	"data":{		"data":{
−	"order_id":1,	+	"car_id":140
−	"state_id":12,	+	}
−	"state_kind":"car_at_place",
−	"crew_id":1,
−	"prior_crew_id":0,
−	"driver_id":2,
−	"car_id":3,
−	"start_time":"20130117125641",
−	"source_time":"20130117132617",
−	"finish_time":"20130117130343",
−	"source":"1",
−	"destination":"2",
−	"passenger":"Слепаков",
−	"phone":"8800",
−	"client_id":1,
−	"order_crew_group_id":1,
−	"tariff_id":1,
−	"car_mark":"Ауди",
−	"car_model":"Q7",
−	"car_color":"черный",
−	"car_number":"А777АА",
−	"crew_coords": {
−	"lat": 56.833981,
−	"lon": 53.220249
−	}
−	}
	}		}
	</pre>		</pre>
−	=== Создание задачи СМС серверу ===	+	=== Обновить информацию об автомобиле ===
	Метод: POST		Метод: POST
−	Название запроса: send_sms	+	Название запроса: update_car_info
−	Параметры:	+	Параметры в формате JSON:
	{|		{|
Строка 2955:		Строка 3906:
	!colspan="3"|Обязательные параметры		!colspan="3"|Обязательные параметры
	|-		|-
−	|phone	+	|car_id
−	|Строка, <= 16 символов	+	|Целое
−	|Номер телефона	+	|ИД автомобиля
		+	|-
		+	!colspan="3"|Необязательные параметры
	|-		|-
−	|message	+	|mark
	|Строка		|Строка
−	|Текст СМС	+	|Марка
−	|}	+	|-
−		+	|color
−	Специальные возвращаемые коды: нет	+	|Строка
−		+	|Цвет
−	Возвращаемые данные в случае успешного выполнения запроса: нет	+	|-
−		+	|gos_number
−	Пример:	+	|Строка
−		+	|Государственный номер
−	<pre>
−	Запрос:
−
−	POST /common_api/1.0/send_sms HTTP/1.1
−	Content-Type: application/x-www-form-urlencoded
−	Content-Length: 33
−
−	Signature: <...>
−
−	message=SMSText&phone=89050057216
−
−	Ответ:
−
−	{
−	"code":0,
−	"descr":"OK",
−	"data":{}
−	}
−	</pre>
−
−	=== Проверка авторизации ===
−
−	Метод: GET
−
−	Название запроса: check_authorization
−
−	Параметры:
−
−	{|
−	!Параметры
−	!Тип
−	!Описание
	|-		|-
−	!colspan="3"|Обязательные параметры	+	|model
		+	|Строка
		+	|Модель
	|-		|-
−	|login	+	|short_name
−	|Строка, <= 60 символов	+	|Строка
−	|Логин	+	|Краткое название
	|-		|-
−	|password	+	|production_year
−	|Строка, <= 60 символов	+	|Целое
−	|Пароль	+	|Год выпуска
−	|}	+	|-
−		+	|car_class
		+	|Строка
		+	|Класс автомобиля (A, B, C, ...)
		+	|-
		+	|vin
		+	|Строка
		+	|VIN
		+	|-
		+	|body_number
		+	|Строка
		+	|Номер кузова
		+	|-
		+	|engine_number
		+	|Строка
		+	|Номер двигателя
		+	|-
		+	|permit
		+	|Строка
		+	|Разрешение на перевозку
		+	|-
		+	|comment
		+	|Строка
		+	|Описание
		+	|-
		+	|order_params
		+	|Массив
		+	|Массив параметров автомобиля
		+	|-
		+	|&bull;
		+	|Целое
		+	|ИД параметра
		+	|-
		+	|is_locked
		+	|true или false
		+	|Автомобиль заблокирован
		+	|-
		+	|lock_description
		+	|Строка
		+	|Причина блокировки
		+	|-
		+	|uds_id
		+	|Целое
		+	|ИД службы ЕДС
		+	|-
		+	|car_photo
		+	|Base64
		+	|Фотография автомобиля
		+	|}
		+
	Специальные возвращаемые коды:		Специальные возвращаемые коды:
	{|		{|
Строка 3019:		Строка 3990:
	!Описание		!Описание
	|-		|-
−	|100	+	|101
−	|Не найден клиент с логином LOGIN и/или неверный пароль	+	|Служба ЕДС не найдена
		+	|-
		+	|102
		+	|Автомобиль с ИД=ID не найден
		+	|-
		+	|103
		+	|Экипаж на линии, запрещено редактирование полей: марка, модель, краткое наименование, цвет, гос. номер, служба ЕДС.
		+	|-
		+	|104
		+	|Параметр с ИД=ID не найден или не может быть привязан к автомобилю
	|}		|}
−	Возвращаемые данные в случае успешного выполнения запроса:	+	Возвращаемые данные в случае успешного выполнения запроса: нет.
−	{|
−	!Параметр
−	!Тип
−	!Описание
−	|-
−	|client_id
−	|Целое
−	|ИД клиента
−	|}
	Пример:		Пример:
−
	<pre>		<pre>
	Запрос:		Запрос:
		+	POST https://ip:port/common_api/1.0/update_car_info
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: 104
−	GET https://ip:port/common_api/1.0/check_authorization?login=LOGIN&password=PASSWORD HTTP/1.1	+	{
−		+	"car_id":1,
−	Signature: <...>	+	"code":"CODE",
		+	"mark":"MARK",
		+	"model":"MODEL",
		+	"color":"BLACK",
		+	"gos_number":"NUMBER",
		+	"production_year":2000,
		+	"comment":"COMMENT",
		+	"order_params":[3,4]
		+	}
	Ответ:		Ответ:
−
	{		{
	"code":0,		"code":0,
	"descr":"OK",		"descr":"OK",
−	"data":{	+	"data":{}
−	"client_id":131
−	}
	}		}
	</pre>		</pre>
−	=== Регистрация клиента ===	+	=== Запрос координат экипажей ===
		+	Метод: GET
−	Метод: POST	+	Название запроса: get_crews_coords
−
−	Название запроса: register_client
	Параметры:		Параметры:
−
	{|		{|
	!Параметры		!Параметры
Строка 3067:		Строка 4044:
	!Описание		!Описание
	|-		|-
−	!colspan="3"|Обязательные параметры	+	!colspan="3"|Необязательные параметры
	|-		|-
−	|name	+	|crew_id
−	|Строка, <= 60 символов	+	|Целое
−	|ФИО	+	|ИД экипажа, по которому нужно вернуть координаты. Если не задано, то будут возвращены координаты всех экипажей на линии.
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
	|-		|-
−	|login	+	|100
−	|Строка, <= 60 символов	+	|Координаты не найдены
−	|Логин	+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
	|-		|-
−	|password	+	|crews_coords
−	|Строка, <= 60 символов	+	|Массив
−	|Пароль	+	|Список координат экипажей
	|-		|-
−	|phones	+	|&bull; crew_id
		+	|Целое
		+	|ИД экипажа
		+	|-
		+	|&bull; crew_code
	|Строка		|Строка
−	|Номера телефонов (через запятую)	+	|Позывной экипажа
		+	|-
		+	|&bull; coords_time
		+	|ГГГГММДДччммсс
		+	|Время получения координат
		+	|-
		+	|&bull; lat
		+	|Дробное
		+	|Долгота
	|-		|-
−	!colspan="4"|Необязательные параметры	+	|&bull; lon
		+	|Дробное
		+	|Широта
	|-		|-
−	|address	+	|speed
−	|Строка	+	|Целое
−	|Домашний адрес	+	|Скорость движения, км/ч
	|-		|-
−	|birthday	+	|direction
−	|ДД.ММ.ГГГГ	+	|Целое
−	|Дата рождения	+	|Направление движения (0-Север, 90-Восток, 180-Юг, 270-Запад, -1-не задано)
	|-		|-
−	|gender	+	|&bull; state_kind
	|Строка		|Строка
−	|Пол. Может принимать значения:	+	|Тип состояния экипажа. Может принимать значения:
−	• "male" -  мужской	+	• "not_available" — экипаж не на линии
		+
		+	• "waiting" — экипаж свободен, ожидает заказы
		+
		+	• "on_order" — экипаж на заказе
−	• "female" - женский	+	• "on_break" — экипаж на перерыве
−	|-
−	|client_group
−	|Целое
−	|Группа клиента
	|}		|}
−	Специальные возвращаемые коды:	+	Пример:
−	{|
−	!Код
−	!Описание
−	|-
−	|100
−	|Клиент с ИД=ID имеет такой же номер телефона=PHONE
−	|-
−	|101
−	|Клиент с логином=LOGIN уже существует
−	|}
−	Возвращаемые данные в случае успешного выполнения запроса:	+	<pre>
−	{|	+
−	!Параметр	+	Запрос:
−	!Тип	+	GET https://ip:port/common_api/1.0/get_crews_coords
−	!Описание	+	Signature: <...>
−	|-	+
−	|client_id	+	Ответ:
−	|Целое
−	|ИД созданного клиента
−	|}
−	Пример:	+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"crews_coords":[
		+	{
		+	"crew_id":1,
		+	"crew_code":"111",
		+	"coords_time":"20120101101010",
		+	"lat":11.111111,
		+	"lon":22.222222,
		+	"state_kind":"waiting"
		+	},
		+	{
		+	"crew_id":2,
		+	"crew_code":"222",
		+	"coords_time":"20120101101010",
		+	"lat":33.333333,
		+	"lon":44.444444,
		+	"state_kind":"on_order"
		+	}
		+	]
		+	}
		+	}
−	<pre>
	Запрос:		Запрос:
−	POST https://ip:port/common_api/1.0/create_order HTTP/1.1	+	GET https://ip:port/common_api/1.0/get_crews_coords?crew_id=1
	Signature: <...>		Signature: <...>
−	Content-Type: application/x-www-form-urlencoded
−	Content-Length: 104
−	name=NAME&phones=88,99&login=LOGIN&password=PASSWORD&birthday=19930218115517&gender=male&address=ADDRESS&client_group=5
	Ответ:		Ответ:
Строка 3147:		Строка 4156:
	"descr":"OK",		"descr":"OK",
	"data":{		"data":{
−	"client_id":140	+	"crews_coords":[
		+	{
		+	"crew_id":1,
		+	"crew_code":"111",
		+	"coords_time":"20120101101010",
		+	"lat":11.111111,
		+	"lon":22.222222,
		+	"state_kind":"waiting"
		+	}
		+	]
	}		}
	}		}
	</pre>		</pre>
−	=== Запрос информации по клиенту ===	+	=== Запрос адресов, содержащих нужную строку ===
−
	Метод: GET		Метод: GET
−	Название запроса: get_client_info	+	Название запроса: get_addresses_like
	Параметры:		Параметры:
Строка 3165:		Строка 4182:
	!Описание		!Описание
	|-		|-
−	!colspan="3"|Обязательные параметры	+	! colspan="3"|Обязательные параметры
		+	|-
		+	|get_streets
		+	|true или false
		+	|Искать улицы
		+	|-
		+	|get_points
		+	|true или false
		+	|Искать пункты
		+	|-
		+	|get_houses
		+	|true или false
		+	|Искать дома. Не может быть равно true, если get_streets = true или get_points = true.
		+	|-
		+	|street
		+	|Строка
		+	|Часть названия улицы или пункта, если идет поиск улиц или пунктов, или полное название улицы, если идет поиск домов
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|house
		+	|Строка
		+	|Часть номера дома. Нужно только если get_houses = true.
		+	|-
		+	|city
		+	|Строка
		+	|Город, в котором искать адреса
	|-		|-
−	|client_id	+	|max_addresses_count
	|Целое		|Целое
−	|ИД клиента	+	|Максимальное количество адресов в ответе
		+	|-
		+	|search_in_tm
		+	|true или false
		+	|Искать адреса в ТМ (по умолчанию = true)
		+	|-
		+	|search_in_yandex
		+	|true или false
		+	|Искать адреса в Яндекс (по умолчанию = false)
		+	|-
		+	|search_in_google
		+	|true или false
		+	|Искать адреса в Google (по умолчанию = false)
		+	|-
		+	|search_in_2gis
		+	|true или false
		+	|Искать адреса в 2GIS (по умолчанию = false)
		+	|-
		+	|search_in_tmgeoservice
		+	|true или false
		+	|Искать адреса в TMGeoService (по умолчанию = false)
		+	|-
		+	|search_in_mapmd
		+	|true или false
		+	|Искать адреса в Map.md (по умолчанию = false)
	|}		|}
Строка 3178:		Строка 4245:
	|-		|-
	|100		|100
−	|Не найден клиент ИД=CLIENT_ID	+	|Подходящие адреса не найдены
		+	|-
		+	|101
		+	|Не указано место для поиска адресов
	|}		|}
Строка 3187:		Строка 4257:
	!Описание		!Описание
	|-		|-
−	|client_id	+	|addresses
−	|Целое	+	|Массив
−	|ИД клиента	+	|Список подходящих адресов
	|-		|-
−	|name	+	|&bull;address_source
	|Строка		|Строка
−	|ФИО	+	|Источник адреса. Может принимать значения:
		+
		+	•"tm" — Такси Мастер (адрес из базы данных или из карты)
		+
		+	•"yandex" — Яндекс
		+
		+	•"google" — Google
		+
		+	•"2gis" — 2GIS
		+
		+	•"tmgeoservice" — TMGeoService
		+
		+	•"mapmd" - Map.md
	|-		|-
−	|number	+	|&bull; street
	|Строка		|Строка
−	|Номер договора	+	|Название улицы или пункта
	|-		|-
−	|address	+	|&bull; house
	|Строка		|Строка
−	|Домашний адрес	+	|Номер дома
	|-		|-
−	|gender	+	|&bull; kind
−	|Строка	+	|Строка
−	|Пол. Может принимать значения:	+	|Тип адреса. Может принимать значения:
		+	• "street" — улица
−	• "male" -  мужской	+	• "house" — дом
−	• "female" - женский	+	• "point" — пункт
	|-		|-
−	|birthday	+	|&bull; comment
−	|ДД.ММ.ГГГГ	+	|Строка
−	|Дата рождения	+	|Комментарий
	|-		|-
−	|phones	+	|&bull; coords
−	|Строка	+	|Массив
−	|Номера телефонов (через запятую)	+	|Координаты дома или пункта
	|-		|-
−	|balance	+	|&bull; &bull;  lat
	|Дробное		|Дробное
−	|Баланс	+	|Широта
	|-		|-
−	|bonus_balance	+	|&bull;  &bull; lon
	|Дробное		|Дробное
−	|Бонусный баланс	+	|Долгота
−	|-
−	|login
−	|Строка
−	|Логин
−	|-
−	|password
−	|Строка
−	|Пароль
−	|-
−	|client_group_id
−	|Целое
−	|ИД группы клиента
	|}		|}
Строка 3243:		Строка 4314:
	<pre>		<pre>
		+
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/get_client_info?client_id=140 HTTP/1.1	+	GET https://ip:port/common_api/1.0/get_addresses_like?get_streets=true&get_points=true&
−		+	get_houses=false&street=STREE
	Signature: <...>		Signature: <...>
Строка 3255:		Строка 4327:
	"descr":"OK",		"descr":"OK",
	"data":{		"data":{
−	"client_id":140,	+	"addresses":[
−	"name":"Васильев Артём",	+	{
−	"number":"000140",	+	"street":"STREET1",
−	"address":"Бутово,45",	+	"house":"",
−	"gender":"male",	+	"kind":"street",
−	"birthday":"18.02.1993",	+	"comment":""
−	"phones":"[	+	"coords":{
−	"88",	+	"lat":0,
−	"99"	+	"lon":0
−	]",	+	}
−	"balance":2985,	+	},
−	"bonus_balance":85,	+	{
−	"login":"artem",	+	"street":"STREET2",
−	"password":"vasilev",	+	"house":"",
−	"client_group_id":1	+	"kind":"street",
−	}	+	"comment":""
		+	"coords":{
		+	"lat":0,
		+	"lon":0
		+	}
		+	},
		+	{
		+	"street":"POINT_STREET1",
		+	"house":"",
		+	"kind":"point",
		+	"comment":"Point at street STREET1"
		+	"coords":{
		+	"lat":53.224656,
		+	"lon":56.842521
		+	}
		+	}
		+	]
		+	}
	}		}
−	</pre>
−	=== Изменение информации по клиенту ===	+	Запрос:
−	Метод: POST	+	GET https://ip:port/common_api/1.0/get_addresses_like?get_streets=false&get_points=false&
		+	get_houses=true&street=STREET1&house=1&max_addresses_count=10
		+	Signature: <...>
−	Название запроса: update_client_info	+	Ответ:
−	Параметры:	+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"addresses":[
		+	{
		+	"street":"STREET1",
		+	"house":"1",
		+	"kind":"house",
		+	"comment":""
		+	},
		+	{
		+	"street":"STREET1",
		+	"house":"10",
		+	"kind":"house",
		+	"comment":""
		+	},
		+	{
		+	"street":"STREET1",
		+	"house":"11",
		+	"kind":"house",
		+	"comment":""
		+	}
		+	]
		+	}
		+	}
		+	</pre>
		+
		+	=== Запрос адресов, содержащих нужную строку 2 ===
		+	Метод: GET
		+
		+	Название запроса: get_addresses_like2
		+
		+	Параметры:
	{|		{|
Строка 3287:		Строка 4410:
	!Описание		!Описание
	|-		|-
−	!colspan="3"|Обязательные параметры	+	! colspan="3"|Обязательные параметры
	|-		|-
−	|client_id	+	|get_streets
−	|Целое	+	|true или false
−	|ИД клиента	+	|Искать улицы
	|-		|-
−	!colspan="3"|Необязательные параметры	+	|get_points
		+	|true или false
		+	|Искать пункты
	|-		|-
−	|name	+	|get_houses
−	|Строка, <= 60 символов	+	|true или false
−	|ФИО	+	|Искать дома
−	|-
−	|login
−	|Строка, <= 60 символов
−	|Логин
−	|-
−	|password
−	|Строка, <= 60 символов
−	|Пароль
−	|-
−	|phones
−	|Строка
−	|Номера телефонов (через запятую)
	|-		|-
	|address		|address
	|Строка		|Строка
−	|Домашний адрес	+	|Строка для поиска адреса
	|-		|-
−	|birthday	+	!colspan="3"|Необязательные параметры
−	|ДД.ММ.ГГГГ
−	|Дата рождения
	|-		|-
−	|gender	+	|city
	|Строка		|Строка
−	|Пол. Может принимать значения:	+	|Города, разделенные запятой, в которых искать адреса
−	• "male" -  мужской
−
−	• "female" - женский
	|-		|-
−	|client_group_id	+	|max_addresses_count
	|Целое		|Целое
−	|ИД группы клиента	+	|Максимальное количество адресов в ответе
−	|}
−
−	Специальные возвращаемые коды:
−	{|
−	!Код
−	!Описание
	|-		|-
−	|100	+	|search_in_tm
−	|Клиент с номером телефона=PHONE уже существует	+	|true или false
		+	|Искать адреса в ТМ (по умолчанию = true)
	|-		|-
−	|101	+	|search_in_yandex
−	|Клиент с ИД=ID имеет такой же номер телефона=PHONE	+	|true или false
		+	|Искать адреса в Яндекс (по умолчанию = false)
	|-		|-
−	|102	+	|search_in_google
−	|Клиент с логином=LOGIN уже существует	+	|true или false
		+	|Искать адреса в Google (по умолчанию = false)
	|-		|-
−	|103	+	|search_in_2gis
−	|Группа клиента с ИД=CLIENT_GROUP_ID не найдена	+	|true или false
−	|}	+	|Искать адреса в 2GIS (по умолчанию = false)
−
−	Возвращаемые данные в случае успешного выполнения запроса: нет
−
−	Пример:
−
−	<pre>
−	Запрос:
−
−	POST https://ip:port/common_api/1.0/create_order HTTP/1.1
−	Signature: <...>
−	Content-Type: application/x-www-form-urlencoded
−	Content-Length: 118
−
−	client_id=140&name=NAME&phones=88,99&login=LOGIN&password=PASSWORD&birthday=20140901000000&gender=m
−	ale&address=ADDRESS&client_group_id=3
−
−	Ответ:
−
−	{
−	"code":0,
−	"descr":"OK",
−	"data":{}
−	}
−	</pre>
−
−	=== Запрос текущих заказов ===
−
−	Метод: GET
−
−	Название запроса: get_current_orders
−
−	Параметры:
−
−	{|
−	!Параметры
−	!Тип
−	!Описание
	|-		|-
−	!colspan="3"|Обязательные параметры	+	|search_in_tmgeoservice
		+	|true или false
		+	|Искать адреса в TMGeoService (по умолчанию = false)
	|-		|-
−	|client_id	+	|search_in_mapmd
−	|Целое	+	|true или false
−	|ИД клиента (может отсутствовать, если phone заполнен)	+	|Искать адреса в Map.md (по умолчанию = false)
−	|-
−	|phone
−	|Строка, <= 16 символов
−	|Телефон клиента (может отсутствовать, если client_id заполнен)
	|}		|}
Строка 3403:		Строка 4469:
	|-		|-
	|100		|100
−	|Не найден клиент ИД=CLIENT_ID	+	|Подходящие адреса не найдены
		+	|-
		+	|101
		+	|Не указано место для поиска адресов
	|}		|}
Строка 3412:		Строка 4481:
	!Описание		!Описание
	|-		|-
−	|id	+	|addresses
−	|Целое	+	|Массив
−	|ИД заказа	+	|Список подходящих адресов
	|-		|-
−	|state_id	+	|&bull; address_source
−	|Целое	+	|Строка
−	|ИД состояния заказа	+	|Источник адреса. Может принимать значения:
		+
		+	•"tm" — Такси Мастер (адрес из базы данных или из карты)
		+
		+	•"yandex" — Яндекс
		+
		+	•"google" — Google
		+
		+	•"2gis" — 2GIS
		+
		+	•"tmgeoservice" — TMGeoService
		+
		+	•"mapmd" - Map.md
	|-		|-
−	|start_time	+	|&bull; city
−	|ГГГГММДДччммсс	+	|Строка
−	|Дата создания заказа	+	|Название города
	|-		|-
−	|source_time	+	|&bull; point
−	|ГГГГММДДччммсс	+	|Строка
−	|Время подачи	+	|Название пункта
	|-		|-
−	|source	+	|&bull; street
	|Строка		|Строка
−	|Адрес подачи	+	|Название улицы
	|-		|-
−	|destination	+	|&bull; house
	|Строка		|Строка
−	|Адрес назначения	+	|Номер дома
	|-		|-
−	|passenger	+	|&bull; kind
	|Строка		|Строка
−	|Пассажир	+	|Тип адреса. Может принимать значения:
		+	• "street" — улица
		+
		+	• "house" — дом
		+
		+	• "point" — пункт
	|-		|-
−	|crew_id	+	|&bull; comment
−	|Целое	+	|Строка
−	|ИД экипажа	+	|Комментарий
	|-		|-
−	|prior_crew_id	+	|&bull; coords
−	|Целое	+	|Массив
−	|ИД предварительного экипажа	+	|Координаты дома или пункта
	|-		|-
−	|driver_id	+	|&bull; &bull;  lat
−	|Целое	+	|Дробное
−	|ИД водителя	+	|Широта
	|-		|-
−	|car_id	+	|&bull;  &bull; lon
−	|Целое	+	|Дробное
−	|ИД автомобиля	+	|Долгота
−	|-
−	|phone
−	|Строка
−	|Номер телефона
−	|-
−	|client_id
−	|Целое
−	|ИД клиента
−	|-
−	|tariff_id
−	|Целое
−	|ИД тарифа
−	|-
−	|order_crew_group_id
−	|Целое
−	|ИД группы экипажей, которая указана в заказе
	|}		|}
Строка 3476:		Строка 4546:
	<pre>		<pre>
		+
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/get_current_orders?client_id=140&phone=18 HTTP/1.1	+
		+	GET https://ip:port/common_api/1.0/get_addresses_like2?get_streets=true&get_points=true& get_houses=true&address=STR12
	Signature: <...>		Signature: <...>
		+
	Ответ:		Ответ:
		+
	{		{
	"code":0,		"code":0,
	"descr":"OK",		"descr":"OK",
	"data":{		"data":{
−	"orders":[	+	"addresses":[
	{		{
−	"id":20648,	+	"address_source":"tm",
−	"state_id":44,	+	"kind":"street",
−	"start_time":"20130204181111",	+	"city":"CITY ",
−	"source_time":"20130204181111",	+	"point":"",
−	"source":"1-й пр-т \/Москва\/,",	+	"street":"STREET",
−	"destination":"12-й мкр,",	+	"house":"12",
−	"passenger":"маша",	+	"comment":"",
−	"crew_id":0,	+	"coords":{
−	"prior_crew_id":0,	+	"lat":11.11111,
−	"driver_id":0,	+	"lon":22.222222
−	"car_id":0,	+	}
−	"phone":"18",
−	"client_id":140,
−	"tariff_id":1,
−	"order_crew_group_id":1
	},		},
	{		{
−	"id":20670,	+	"address_source":"tm",
−	"state_id":45,	+	"kind":"street",
−	"start_time":"20130207153022",	+	"city":"CITY ",
−	"source_time":"20130207153022",	+	"point":"",
−	"source":"11-й мкр,",	+	"street":"STREET",
−	"destination":"1-й пр-т \/Москва\/,",	+	"house":"120",
−	"passenger":"саша",	+	"comment":"",
−	"crew_id":1,	+	"coords":{
−	"prior_crew_id":1,	+	"lat":11.11111,
−	"driver_id":1,	+	"lon":22.222222
−	"car_id":1,	+	}
−	"phone":"18",
−	"client_id":140,
−	"tariff_id":2,
−	"order_crew_group_id":2
	}		}
	]		]
	}		}
	}		}
		+
		+
	</pre>		</pre>
−	=== Запрос выполненных заказов ===	+	=== Поиск ближайшего адреса ===
		+	Метод: GET
−	Метод: GET	+	Название запроса: find_nearest_address
−	Название запроса: get_finished_orders	+	Версия ТМ: 3.12
	Параметры:		Параметры:
−
	{|		{|
	!Параметры		!Параметры
Строка 3537:		Строка 4605:
	!Описание		!Описание
	|-		|-
−	!colspan="3"|Обязательные параметры	+	! colspan="3"|Обязательные параметры
		+	|-
		+	|lat
		+	|Дробное
		+	|Широта
		+	|-
		+	|lon
		+	|Дробное
		+	|Долгота
		+	|-
		+	! colspan="3"|Необязательные параметры
	|-		|-
−	|client_id	+	|radius
	|Целое		|Целое
−	|ИД клиента (может отсутствовать, если phone заполнен)	+	|Радиус в метрах
	|-		|-
−	|phone	+	|search_in_tm
−	|Строка, <= 16 символов	+	|true или false
−	|Телефон клиента (может отсутствовать, если client_id заполнен)	+	|Искать адреса в ТМ (по умолчанию = true)
	|-		|-
−	|start_time	+	|search_in_google
−	|ГГГГММДДччммсс	+	|true или false
−	|Начало периода	+	|Искать адреса в Google (по умолчанию = false)
	|-		|-
−	|finish_time	+	|search_in_tmgeoservice
−	|ГГГГММДДччммсс	+	|true или false
−	|Конец периода	+	|Искать адреса в TMGeoService (по умолчанию = false)
		+	|-
		+	|search_in_mapmd
		+	|true или false
		+	|Искать адреса в Map.md (по умолчанию = false)
		+	|-
		+	|search_in_2gis
		+	|true или false
		+	|Искать адреса в 2ГИС (по умолчанию = false)
	|}		|}
Строка 3562:		Строка 4648:
	|-		|-
	|100		|100
−	|Не найден клиент ИД=CLIENT_ID	+	|Подходящие адреса не найдены
		+	|-
		+	|101
		+	|Не указано место для поиска адресов
	|}		|}
Строка 3571:		Строка 4660:
	!Описание		!Описание
	|-		|-
−	|id	+	|address_source
−	|Целое	+	|Строка
−	|ИД заказа	+	|Источник адреса. Может принимать значения:
		+
		+	* "tm" — Такси Мастер (адрес из базы данных или из карты)
		+	* "google" — Google
		+	* "tmgeoservice" — TMGeoService
		+	* "2gis" — 2ГИС
		+	* "mapmd" — Map.md
	|-		|-
−	|state_id	+	|city
−	|Целое	+	|Строка
−	|ИД состояния заказа	+	|Название города
	|-		|-
−	|start_time	+	|point
−	|ГГГГММДДччммсс	+	|Строка
−	|Время создания заказа	+	|Название пункта
	|-		|-
−	|source_time	+	|street
−	|ГГГГММДДччммсс	+	|Строка
−	|Время подачи	+	|Название улицы
	|-		|-
−	|finish_time	+	|house
−	|ГГГГММДДччммсс
−	|Время завершения заказа
−	|-
−	|source
	|Строка		|Строка
−	|Адрес подачи	+	|Номер дома
	|-		|-
−	|destination	+	|kind
	|Строка		|Строка
−	|Адрес назначения	+	|
		+	Тип адреса. Может принимать значения:
		+
		+	* "street" — улица
		+	* "house" — дом
		+	* "point" — пункт
	|-		|-
−	|passenger	+	|comment
	|Строка		|Строка
−	|Пассажир	+	|Комментарий
	|-		|-
−	|sum	+	|coords
−	|Дробное	+	|Массив
−	|Стоимость заказа без учета скидок (наценок)	+	|Координаты дома или пункта
	|-		|-
−	|total_sum	+	|&bull; lat
	|Дробное		|Дробное
−	|Итоговая стоимость заказа	+	|Широта
	|-		|-
−	|cash_sum	+	|&bull; lon
	|Дробное		|Дробное
−	|Заплачено наличными	+	|Долгота
−	|-
−	|cashless_sum
−	|Дробное
−	|Заплачено с безналичного счета клиента
−	|-
−	|bonus_sum
−	|Дробное
−	|Заплачено с бонусного счета клиента
−	|-
−	|bank_card_sum
−	|Дробное
−	|Заплачено банковской картой
−	|-
−	|crew_id
−	|Целое
−	|ИД экипажа
−	|-
−	|prior_crew_id
−	|Целое
−	|ИД предварительного экипажа
−	|-
−	|driver_id
−	|Целое
−	|ИД водителя
−	|-
−	|car_id
−	|Целое
−	|ИД автомобиля
−	|-
−	|phone
−	|Строка
−	|Номер телефона
−	|-
−	|client_id
−	|Целое
−	|ИД клиента
−	|-
−	|tariff_id
−	|Целое
−	|ИД тарифа
−	|-
−	|order_crew_group_id
−	|Целое
−	|ИД группы экипажей, которая указана в заказе
	|}		|}
Строка 3663:		Строка 4715:
	<pre>		<pre>
		+
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/get_finished_orders?client_id=140&phone= HTTP/1.1	+
		+	GET https://ip:port/common_api/1.0/find_nearest_address?lat=56.850926&lon=53.212706&radius=100&search_in_tm=false&search_in_google=false&search_in_tmgeoservice=true HTTP/1.1
	Signature: <...>		Signature: <...>
		+
	Ответ:		Ответ:
		+
	{		{
	"code":0,		"code":0,
	"descr":"OK",		"descr":"OK",
−	"data":{	+	"data":
−	"orders":[	+	{
−	{	+	"address_source":"tmgeoservice",
−	"id":20651,	+	"kind":"house",
−	"state_id":34,	+	"city":"Ижевск",
−	"source_time":"20130205110812",	+	"point":"",
−	"start_time":"20130205110812",	+	"street":"Пушкинская ул.",
−	"finish_time":"20130205115618",	+	"house":"206",
−	"source":"прпроп",	+	"comment":"",
−	"destination":"рррррр",	+	"coords":
−	"passenger":"вера",	+	{
−	"sum":908,	+	"lat":56.850951,
−	"total_sum":1000,	+	"lon":53.212822
−	"cash_sum":700,	+	}
−	"cashless_sum":100,	+	}
−	"bonus_sum":150,	+	}
−	"bank_card_sum":50,	+
−	"crew_id":6,
−	"prior_crew_id":0,
−	"driver_id":4,
−	"car_id":6,
−	"phone":"111111",
−	"client_id":140,
−	"tariff_id":1,
−	"order_crew_group_id":1
−	},
−	{
−	"id":20669,
−	"state_id":34,
−	"source_time":"20130205130500",
−	"start_time":"20130205130500",
−	"finish_time":"20130205134511",
−	"source":"1",
−	"destination":"2",
−	"passenger":"маша",
−	"sum":454,
−	"total_sum":500,
−	"cash_sum":0,
−	"cashless_sum":500,
−	"bonus_sum":0,
−	"bank_card_sum":0,
−	"crew_id":6,
−	"prior_crew_id":0,
−	"driver_id":4,
−	"car_id":6,
−	"phone":"222222",
−	"client_id":140,
−	"tariff_id":2,
−	"order_crew_group_id":2
−	}
−	]
−	}
−	}
	</pre>		</pre>
−	=== Проведение операции по клиенту ===	+	=== Анализ маршрута ===
		+	Метод: GET
−	Метод: POST	+	Название запроса: analyze_route
−
−	Название запроса: create_client_operation
	Параметры:		Параметры:
Строка 3740:		Строка 4759:
	!colspan="3"|Обязательные параметры		!colspan="3"|Обязательные параметры
	|-		|-
−	|client_id	+	|source
−	|Целое	+	|Строка
−	|ИД клиента	+	|Адрес подачи
	|-		|-
−	|sum	+	|dest
−	|Дробное	+	|Строка
−	|Сумма	+	|Адрес назначения
	|-		|-
−	|oper_type	+	!colspan="3"|Необязательные параметры
−	|Целое
−	|Тип операции:
−	• "receipt" - приход
−
−	• "expense" - расход
	|-		|-
−	|pay_type	+	|source_lon
−	|Целое	+	|Дробное
−	|Тип оплаты:	+	|Долгота адреса подачи
−	• "cash" - наличный
−
−	• "nocash" - безналичный
	|-		|-
−	!colspan="3"|Необязательные параметры	+	|source_lat
		+	|Дробное
		+	|Широта адреса подачи
	|-		|-
−	|oper_time	+	|dest_lon
−	|ГГГГММДДччммсс	+	|Дробное
−	|Время создания операции	+	|Долгота адреса назначения
	|-		|-
−	|comment	+	|dest_lat
−	|Строка	+	|Дробное
−	|Комментарий	+	|Широта адреса назначения
	|}		|}
		+
		+
		+	Параметр source не является обязательным к заполнению, если заданы source_lon и source_lat.
		+
		+	Параметр dest не является обязательным к заполнению, если заданы dest_lon и dest_lat.
		+
	Специальные возвращаемые коды:		Специальные возвращаемые коды:
Строка 3779:		Строка 4798:
	|-		|-
	|100		|100
−	|Не найден клиент ИД=CLIENT_ID	+	|Адрес подачи не распознан
		+	|-
		+	|101
		+	|Адрес назначения не распознан
		+	|-
		+	|102
		+	|Маршрут не распознан
	|}		|}
Строка 3788:		Строка 4813:
	!Описание		!Описание
	|-		|-
−	|oper_id	+	|source_lat
−	|Целое	+	|Дробное
−	|ИД операции	+	|Широта адреса подачи
		+	|-
		+	|source_lon
		+	|Дробное
		+	|Долгота адреса подачи
		+	|-
		+	|source_zone_id
		+	|Целое
		+	|ИД района подачи
		+	|-
		+	|dest_lat
		+	|Дробное
		+	|Широта адреса назначения
		+	|-
		+	|dest_lon
		+	|Дробное
		+	|Долгота адреса назначения
		+	|-
		+	|dest_zone_id
		+	|Целое
		+	|ИД района назначения
		+	|-
		+	|city_dist
		+	|Дробное
		+	|Километраж по городу
		+	|-
		+	|country_dist
		+	|Дробное
		+	|Километраж за городом
		+	|-
		+	|source_country_dist
		+	|Дробное
		+	|Километраж до адреса подачи, если адрес подачи за городом
	|}		|}
Строка 3798:		Строка 4855:
	Запрос:		Запрос:
−	POST https://ip:port/common_api/1.0/create_client_operation HTTP/1.1	+	GET https://ip:port/common_api/1.0/analyze_route?source=STREET1,1&dest=STREET2,2&source_lon=
		+	53.153044&source_lat=56.893301&dest_lon=53.218103&dest_lat=56.869759
	Signature: <...>		Signature: <...>
−	Content-Type: application/x-www-form-urlencoded
−	Content-Length: 99
−
−	client_id=112&oper_time=20130221100719&oper_sum=300&oper_type=receipt&pay_type=cash&comment=COMMENT
	Ответ:		Ответ:
Строка 3811:		Строка 4865:
	"descr":"OK",		"descr":"OK",
	"data":{		"data":{
−	"oper_id":31	+	"source_lat":11.111111,
−		+	"source_lon":22.222222,
		+	"source_zone_id":1,
		+	"dest_lat":33.333333,
		+	"dest_lon":44.444444,
		+	"dest_zone_id":2,
		+	"city_dist":1.1,
		+	"country_dist":2.2,
		+	"source_country_dist":3.3
	}		}
	}		}
	</pre>		</pre>
−	=== Запрос операций по клиенту ===	+	=== Анализ маршрута 2 ===
−	Метод: GET	+	Метод: POST
−	Название запроса: get_client_operations	+	Название запроса: analyze_route2
−	Параметры:	+	Параметры в формате JSON:
	{|		{|
−	!Параметры	+	!Параметр
	!Тип		!Тип
	!Описание		!Описание
Строка 3832:		Строка 4893:
	!colspan="3"|Обязательные параметры		!colspan="3"|Обязательные параметры
	|-		|-
−	|client_id	+	|addresses
−	|Целое	+	|Массив
−	|ИД клиента (обязателен, если phone отсутствует)	+	|Массив адресов. Первый элемент — адрес подачи, последний — адрес назначения, между ними — остановки.
		+	|-
		+	|&bull; address
		+	|Строка
		+	|Адрес подачи
		+	|-
		+	|&bull; lat
		+	|Дробное
		+	|Широта адреса
		+	|-
		+	|&bull; lon
		+	|Дробное
		+	|Долгота адреса
	|-		|-
−	|phone	+	!colspan="3"|Необязательные параметры
−	|Целое
−	|Телефон клиента (обязателен, если client_id отсутствует)
	|-		|-
−	|start_time	+	|get_full_route_coords
−	|ГГГГММДДччммсс	+	|true или false
−	|Начало периода	+	|Возвращать координаты точек полного маршрута (по умолчанию false)
	|-		|-
−	|finish_time	+	|crew_group_id
−	|ГГГГММДДччммсс	+	|Целое
−	|Конец периода	+	|ИД группы экипажей
	|}		|}
	Специальные возвращаемые коды:		Специальные возвращаемые коды:
		+
	{|		{|
	!Код		!Код
Строка 3855:		Строка 4927:
	|-		|-
	|100		|100
−	|Не найден клиент ИД=CLIENT_ID	+	|Маршрут не распознан
	|}		|}
	Возвращаемые данные в случае успешного выполнения запроса:		Возвращаемые данные в случае успешного выполнения запроса:
		+
	{|		{|
−	!Параметр	+	!Параметры
	!Тип		!Тип
	!Описание		!Описание
	|-		|-
−	|oper_id	+	|Addresses
−	|Целое	+	|Массив
−	|ИД операции	+	|Массив адресов. Первый элемент — адрес подачи, последний — адрес назначения, между ними — остановки.
	|-		|-
−	|oper_time	+	|&bull; lat
−	|ГГГГММДДччммсс	+	|Дробное
−	|Время создания операции	+	|Широта адреса
	|-		|-
−	|sum	+	|&bull; lon
	|Дробное		|Дробное
−	|Сумма	+	|Долгота адреса
	|-		|-
−	|order_id	+	|&bull; zone_id
	|Целое		|Целое
−	|Заказ, связанный с операцией	+	|Район адреса
	|-		|-
−	|oper_type	+	|&bull; parking_id
	|Целое		|Целое
−	|Тип операции:	+	|Стоянка адреса
−	• "receipt" - приход	+	|-
−		+	|city_dist
−	• "expense" - расход	+	|Дробное
		+	|Километраж по городу
	|-		|-
−	|pay_type	+	|country_dist
−	|Целое	+	|Дробное
−	|Тип оплаты:	+	|Километраж за городом
−	• "cash" - наличный
−
−	• "nocash" - безналичный
	|-		|-
−	|name	+	|source_country_dist
−	|Строка	+	|Дробное
−	|Наименование	+	|Километраж до адреса подачи, если адрес подачи за городом.
	|-		|-
−	|comment	+	|full_route_coords
−	|Строка	+	|Массив
−	|Комментарий	+	|Массив координат точек маршрута.
−	|}	+	|-
		+	|&bull; lat
		+	|Дробное
		+	|Широта точки
		+	|-
		+	|&bull; lon
		+	|Дробное
		+	|Долгота точки
		+	|}
	Пример:		Пример:
	<pre>		<pre>
		+
	Запрос:		Запрос:
−	GET	+	POST /common_api/1.0/analyze_route2
		+	Host: ip:port
		+	Keep-Alive: 300
		+	Connection: keep-alive
		+	Content-Type: application/json
		+	Content-Length: 243
		+	Signature: <...>
		+
		+	{"get_full_route_coords":true,"addresses":[{"address":"STREET1, 1","lat":11.111111,
		+	"lon":22.222222},{"address":"STREET2, 2","lat":33.333333,"lon":44.444444},
		+	{"address":"STREET3, 3","lat":55.555555,"lon":55.555555},{"address":"STREET4,
		+	4","lat":77.777777,"lon":88.888888}]}
−	GET https://ip:port/common_api/1.0/get_client_operations?
−	client_id=112&start_time=20130201092112&finish_time=20130221092112 HTTP/1.1
−	Signature: <...>
	Ответ:		Ответ:
−
	{		{
	"code":0,		"code":0,
	"descr":"OK",		"descr":"OK",
	"data":{		"data":{
−	"operations":[	+	"addresses":[
−	{	+	{
−	"oper_id":112,	+	"lat":11.111111,
−	"oper_time":"20130219091328",	+	"lon":22.222222,
−	"sum":"21,8",	+	"zone_id":1,
−	"order_id":11800,	+	"parking_id":1
−	"oper_type":"receipt",	+	},
−	"pay_type":"cash",	+	{
−	"name":"Пополнение счета",	+	"lat":33.333333,
−	"comment":"Комментарий"	+	"lon":44.444444,
−	},	+	"zone_id":2,
−	{	+	"parking_id":2
−	"oper_id":112,	+	}
−	"oper_time":"20130220112245",	+	],
−	"sum":"4500",	+	"city_dist":0,
−	"order_id":11801,	+	"country_dist":2.647,
−	"oper_type":"receipt",	+	"source_country_dist":3.412,
−	"pay_type":"cash",	+	"full_route_coords":[
−	"name":"Пополнение счета",	+	{
−	"comment":"Комментарий"	+	"lat":55.833603,
−	}	+	"lon":37.515537
		+	},
		+	{
		+	"lat":55.832855,
		+	"lon":37.516315
		+	},
		+	{
		+	"lat":55.833405,
		+	"lon":37.51799
		+	},
		+	...
	]		]
	}		}
Строка 3947:		Строка 5044:
	</pre>		</pre>
		+	=== Запрос информации о состоянии заказа ===
−	=== Проведение операции по водителю ===	+	Метод: GET
−	Метод: POST	+	Название запроса: get_order_state
−
−	Название запроса: create_driver_operation
	Параметры:		Параметры:
	{|		{|
−	!Параметр	+	!Параметры
	!Тип		!Тип
	!Описание		!Описание
Строка 3963:		Строка 5059:
	!colspan="3"|Обязательные параметры		!colspan="3"|Обязательные параметры
	|-		|-
−	|driver_id	+	|order_id
	|Целое		|Целое
−	|ИД водителя	+	|ИД заказа
−	|-
−	|oper_sum
−	|Дробное
−	|Сумма
−	|-
−	|oper_type
−	|Строка
−	|Тип операции: receipt - приход, expense - расход.
	|-		|-
	!colspan="3"|Необязательные параметры		!colspan="3"|Необязательные параметры
	|-		|-
−	|name	+	|fields
−	|Строка
−	|Наименование операции
−	|-
−	|oper_time
−	|ГГГГММДДччммсс
−	|Время создания операции (если не задано, текущее)
−	|-
−	|comment
	|Строка		|Строка
−	|Комментарий	+	|Список возвращаемых полей через запятую
	|}		|}
	Специальные возвращаемые коды:		Специальные возвращаемые коды:
−
	{|		{|
	!Код		!Код
Строка 3997:		Строка 5076:
	|-		|-
	|100		|100
−	|Водитель не найден ИД=DRIVER_ID	+	|Заказ не найден
	|}		|}
	Возвращаемые данные в случае успешного выполнения запроса:		Возвращаемые данные в случае успешного выполнения запроса:
−
	{|		{|
	!Параметр		!Параметр
Строка 4007:		Строка 5085:
	!Описание		!Описание
	|-		|-
−	|oper_id	+	|order_id
	|Целое		|Целое
−	|ИД операции	+	|ИД заказа
−	|}	+	|-
		+	|state_id
		+	|Целое
		+	|ИД состояния заказа
		+	|-
		+	|state_kind
		+	|Строка
		+	|Тип состояния заказа. Может принимать значения:
		+	• "new_order" — новый заказ
−	Пример:	+	• "driver_assigned" — водитель назначен
−	<pre>	+	• "car_at_place" — машина подъехала на место
−	Запрос:	+	• "client_inside" — клиент в машине
−	POST https://ip:port/common_api/1.0/create_driver_operation HTTP/1.1	+	• "finished" — заказ успешно завершен
−	Signature: <...>
−	Content-Type: application/json
−	Content-Length: 99
−	{	+	• "aborted" — заказ прекращен
−	"driver_id": 1,	+	|-
−	"oper_sum": 10.00,	+	|crew_id
−	"oper_type": "receipt",	+	|Целое
−	"name": "Пополнение счета",	+	|ИД экипажа
−	"oper_time": "20141210100719",
−	"comment": "Комментарий к операции"
−	}
−
−	Ответ:
−
−	{
−	"code":0,
−	"descr":"OK",
−	"data":{
−	"oper_id":31
−	}
−	}
−
−	</pre>
−
−
−	=== Запрос операций по водителю ===
−
−	Метод: GET
−
−	Название запроса: get_driver_operations
−
−	Параметры:
−
−	{|
−	!Параметр
−	!Тип
−	!Описание
	|-		|-
−	!colspan="3"|Обязательные параметры	+	|prior_crew_id
		+	|Целое
		+	|ИД предварительного экипажа
	|-		|-
−	|driver_id	+	|driver_id
	|Целое		|Целое
	|ИД водителя		|ИД водителя
	|-		|-
−	|start_time	+	|car_id
		+	|Целое
		+	|ИД автомобиля
		+	|-
		+	|server_time_offset
		+	|Целое
		+	|Смещение относительно серверного времени
		+	|-
		+	|start_time
		+	|ГГГГММДДччммсс
		+	|Время создания заказа
		+	|-
		+	|source_time
	|ГГГГММДДччммсс		|ГГГГММДДччммсс
−	|Начало периода	+	|Время подачи
	|-		|-
	|finish_time		|finish_time
	|ГГГГММДДччммсс		|ГГГГММДДччммсс
−	|Конец периода	+	|Время завершения заказа
−	|}	+	|-
−		+	|source
−		+	|Строка
−	Специальные возвращаемые коды:	+	|Адрес подачи
−	{|	+	|-
−	!Код	+	|source_lat
−	!Описание	+	|Строка
		+	|Широта адреса подачи
	|-		|-
−	|100	+	|source_lon
−	|Не найден водитель ИД=DRIVER_ID	+	|Строка
−	|}	+	|Долгота адреса подачи
−
−
−	Возвращаемые данные в случае успешного выполнения запроса:
−	{|
−	!Параметр
−	!Тип
−	!Описание
	|-		|-
−	|oper_id	+	|destination
−	|Целое	+	|Строка
−	|ИД операции	+	|Адрес назначения
	|-		|-
−	|oper_time	+	|destination_lat
−	|ГГГГММДДччммсс	+	|Строка
−	|Время создания операции	+	|Широта адреса назначения
	|-		|-
−	|sum	+	|destination_lon
−	|Дробное	+	|Строка
−	|Сумма	+	|Долгота адреса назначения
	|-		|-
−	|order_id	+	|stops
−	|Целое	+	|Массив
−	|Заказ, связанный с операцией	+	|Информация по остановкам заказа
	|-		|-
−	|oper_type	+	|&bull; address
−	|Целое	+	|Строка
−	|Тип операции:	+	|Адрес остановки
−	•"receipt" - приход
−	•"expense" - расход
	|-		|-
−	|name	+	|&bull; lat
−	|Строка	+	|Дробное
−	|Наименование	+	|Широта адреса остановки
	|-		|-
−	|comment	+	|&bull; lon
−	|Строка	+	|Дробное
−	|Комментарий	+	|Долгота адреса остановки
−	|}
−
−	Пример:
−
−	<pre>
−	Запрос:
−
−	GET https://ip:port/common_api/1.0/get_driver_operations?
−	driver_id=112&start_time=20130201092112&finish_time=20130221092112 HTTP/1.1
−	Signature: <...>
−
−	Ответ:
−
−	{
−	"code":0,
−	"descr":"OK",
−	"data":{
−	"operations":[
−	{
−	"oper_id":112,
−	"oper_time":"20130219091328",
−	"sum":"21,8",
−	"order_id":11800,
−	"oper_type":"receipt",
−	"name":"DRIVER_OPERATION_1",
−	"comment":"DRIVER_OPERATION_COMMENT_1"
−	},
−	{
−	"oper_id":112,
−	"oper_time":"20130220112245",
−	"sum":"4500",
−	"order_id":11801,
−	"oper_type":"receipt",
−	"name":"DRIVER_OPERATION_2",
−	"comment":"DRIVER_OPERATION_COMMENT_2"
−	}
−	]
−	}
−	}
−	</pre>
−
−	=== Задание координат экипажей ===
−	Метод: POST
−
−	Название запроса: set_crews_coords
−
−	Параметры в формате JSON:
−	{|
−	!Параметр
−	!Тип
−	!Описание
	|-		|-
−	!Обязательные параметры	+	|trip_distance
		+	|Дробное
		+	|Фактический километраж
	|-		|-
−	|crew_coords	+	|trip_time
−	|Массив	+	|Целое
−	|Массив координат экипажей	+	|Фактическое время в пути
	|-		|-
−	|&bull; crew_id	+	|customer
		+	|Строка
		+	|Заказчик
		+	|-
		+	|passenger
		+	|Строка
		+	|Пассажир
		+	|-
		+	|phone
		+	|Строка
		+	|Номер телефона
		+	|-
		+	|phone_to_dial
		+	|Строка
		+	|Номер телефона для отзвона
		+	|-
		+	|client_id
		+	|Целое
		+	|ИД клиента
		+	|-
		+	|client_name
		+	|Строка
		+	|Имя клиента
		+	|-
		+	|client_group_id
	|Целое		|Целое
−	|ИД экипажа	+	|ИД группы клиента
		+	|-
		+	|client_group_name
		+	|Строка
		+	|Название группы клиента
	|-		|-
−	|&bull; gps_id	+	|client_employee_id
	|Целое		|Целое
−	|GPS идентификатор (если не задан ИД экипажа)	+	|ИД сотрудника клиента
	|-		|-
−	|&bull; lat	+	|order_crew_group_id
−	|Дробное	+	|Целое
−	|Широта	+	|ИД группы экипажей, которая указана в заказе
	|-		|-
−	|&bull; lon	+	|tariff_id
−	|Дробное	+	|Целое
−	|Долгота	+	|ИД тарифа
	|-		|-
−	!Необязательные параметры	+	|car_mark
		+	|Строка
		+	|Марка автомобиля
	|-		|-
−	|speed	+	|car_model
−	|Дробное	+	|Строка
−	|Скорость	+	|Модель автомобиля
−	|}	+	|-
−		+	|car_color
−		+	|Строка
−	Специальные возвращаемые коды: нет	+	|Цвет автомобиля
−		+	|-
−	Возвращаемые данные в случае успешного выполнения запроса: нет	+	|car_number
−		+	|Строка
−		+	|Государственный номер автомобиля
−	Пример:	+	|-
		+	|confirmed
		+	|Строка
		+	|Состояние подтвержденности заказа водителем или оператором.
		+
		+	Может принимать значения:
		+
		+	• "not_confirmed" — не подтверждено
−	<pre>	+	• "confirmed_by_driver" — заказ принят водителем
−	Запрос:
−	POST https://ip:port/common_api/1.0/set_crews_coords HTTP/1.1	+	• "confirmed_by_oper" — заказ подтвержден оператором
−	Signature: <...>	+	|-
−	Content-Type: application/json	+	|crew_coords
−	Content-Length: 109	+	|Массив
		+	|Координаты экипажа
		+	|-
		+	|&bull; lat
		+	|Дробное
		+	|Широта
		+	|-
		+	|&bull; lon
		+	|Дробное
		+	|Долгота
		+	|-
		+	|order_params
		+	|Массив
		+	|Массив параметров заказа экипажа
		+	|-
		+	|&bull;
		+	|Целое
		+	|ИД параметра заказа
		+	|-
		+	|creation_way
		+	|Строка
		+	|Способ создания заказа. Может принимать значения:
−	{"crews_coords":[{"crew_id":1,"lat":11.111111,"lon":22.222222},	+	• "operator" — заказ создан оператором
−	{"gps_id":2,"lat":33.333333,"lon":44.444444}]}
−	Ответ:	+	• "sms" — заказ создан через смс
−	{	+	• "market" — заказ из биржи
−	"code":0,
−	"descr":"OK",
−	"data":{}
−	}
−	</pre>
−	=== Анализ телефона ===	+	• "common_api" — заказ создан через api
−	Метод: GET	+	• "t_api" — заказ создан через api
−	Название запроса: analyze_phone	+	• "taxophone" — заказ создан через таксофон с телефона
−	Параметры:	+	• "driver" — заказ создан водителем
−	{|	+
−	!Параметр	+	• "daily_order" — ежедневный заказ
−	!Тип	+
−	!Описание	+	• "taxophone_web" — заказ создан через таксофон с сайта
−	|-	+
−	!Обязательные параметры	+	• "unknown" — неизвестный
		+	|-
		+	|is_prior
		+	|true или false
		+	|Предварительный заказ
		+	|-
		+	|is_really_prior
		+	|true или false
		+	|Предварительный заказ на вкладке "Предварительные"
		+	|-
		+	|email
		+	|Строка
		+	|Email для уведомлений
	|-		|-
−	|phone	+	|prior_to_current_before_minutes
		+	|Целое
		+	|Время перехода из предварительного в текущие заказы, мин
		+	|-
		+	|flight_number
	|Строка		|Строка
−	|Номер телефона	+	|Номер рейса
	|-		|-
−	!Необязательные параметры	+	|sum
		+	|Дробное
		+	|Сумма без скидки
	|-		|-
−	|search_in_drivers_mobile	+	|total_sum
−	|true или false	+	|Дробное
−	|Искать среди мобильных телефонов водителей	+	|Итоговая сумма заказа
	|-		|-
−	|search_in_drivers_home	+	|cash_sum
−	|true или false	+	|Дробное
−	|Искать среди домашних телефонов водителей	+	|Сумма наличными
	|-		|-
−	|search_in_clients	+	|cashless_sum
−	|true или false	+	|Дробное
−	|Искать среди телефонов клиентов	+	|Сумма безналичными
	|-		|-
−	|search_in_phones	+	|bonus_sum
−	|true или false	+	|Дробное
−	|Искать в справочнике телефонов	+	|Сумма бонусами
−	|}
−
−
−	Если параметры search_in_drivers_mobile, search_in_drivers_home, search_in_clients, search_in_phones не заданы, то поиск телефона будет происходить во всех справочниках.
−
−	Специальные возвращаемые коды:
−	{|
−	!Код
−	!Описание
	|-		|-
−	|100	+	|bank_card_sum
−	|Телефон не найден	+	|Дробное
−	|}	+	|Сумма банковской картой
−
−	Возвращаемые данные в случае успешного выполнения запроса:
−	{|
−	!Параметр
−	!Тип
−	!Описание
	|-		|-
−	|phone_type	+	|attribute_values
−	|Строка	+	|Массив
−	|Может принимать значения: «driver_mobile», «driver_home», «client», «phone».	+	|Массив значений атрибутов
	|-		|-
−	|id	+	|&bull; id
	|Целое		|Целое
−	|ИД водителя, клиента, телефона из справочника.	+	|Идентификатор атрибута
		+	|-
		+	|&bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|&bull; num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|&bull; str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
		+	|-
		+	|bill
		+	|Массив
		+	|Чек TMDriver. Данный узел выводится только, если по заказу есть чек
		+	|-
		+	|&bull; code
		+	|Строка
		+	|Код элемента расчета
		+	|-
		+	|&bull; text
		+	|Строка
		+	|Наименование элемента расчета
		+	|-
		+	|&bull; value
		+	|Строка
		+	|Значение элемента расчета (количество)
		+	|-
		+	|&bull; sum
		+	|Строка
		+	|Стоимость элемента расчета
		+	|-
		+	|fact_route
		+	|Массив
		+	|Фактический маршрут по заказу, выводится только если поле fact_route передали в списке фильтра полей fields
		+	|-
		+	|&bull; lat
		+	|Дробное
		+	|Широта точки маршрута
		+	|-
		+	|&bull; lon
		+	|Дробное
		+	|Долгота точки маршрута
		+	|-
		+	|&bull; time
		+	|ГГГГММДДччммсс
		+	|Время данной точки
		+	|-
		+	|&bull; speed
		+	|Целое
		+	|Скорость в данный момент, км/ч
		+	|-
		+	|&bull; direction
		+	|Целое
		+	|Направление движения, градусы (0 - север, 90 - восток, 180 - юг, 270 - запад)
		+	|-
		+	|is_auction
		+	|true или false
		+	|Признак заказа-аукциона
		+	|-
		+	|payment_pay_system
		+	|Строка
		+	|Тип платежной системы ("card", "gpay", "apple_pay", "qr", "sber_pay", либо пусто, если не используется).
	|}		|}
−
	Пример:		Пример:
	<pre>		<pre>
−	Запрос:	+	Запрос:
−	GET /common_api/1.0/analyze_phone?	+	GET https://ip:port/common_api/1.0/get_order_state?order_id=1
−	phone=89501234567&search_in_drivers_mobile=true&search_in_drivers_home=true&search_in_clients=true&	+	Signature: <...>
−	search_in_phones=true HTTP/1.1
−
−	Host: 127.0.0.1:8089
−	Keep-Alive: 300
−	Connection: keep-alive
−	Signature: 4285286a446064353f4a951b721c54f7
−	Ответ:	+	Ответ:
	{		{
Строка 4314:		Строка 5440:
	"descr":"OK",		"descr":"OK",
	"data":{		"data":{
−	"phone_type":"client",	+	"order_id":1,
−	"id":1	+	"state_id":12,
−	}	+	"state_kind":"car_at_place",
−	}	+	"crew_id":1,
−		+	"prior_crew_id":0,
		+	"driver_id":2,
		+	"car_id":3,
		+	"server_time_offset:0,
		+	"start_time":"20130117125641",
		+	"source_time":"20130117132617",
		+	"finish_time":"20130117130343",
		+	"source":"30 Лет Победы ул. \/Ижевск\/, 4Б",
		+	"source_lat":56.863613,
		+	"source_lon":53.186539,
		+	"destination":"Кирова ул. \/Ижевск\/, 56",
		+	"destination_lat":56.862202,
		+	"destination_lon":53.187485,
		+	"stops":[
		+	{
		+	"address":"30 Лет Победы ул. \/Ижевск\/, 8",
		+	"lat":56.863388,
		+	"lon":53.184269
		+	}
		+	],
		+	"trip_distance":10.5,
		+	"trip_time":20,
		+	"customer":"Слепаков",
		+	"passenger":"Слепаков",
		+	"phone":"8800",
		+	"client_id":1,
		+	"client_employee_id":1,
		+	"order_crew_group_id":1,
		+	"tariff_id":1,
		+	"car_mark":"Ауди",
		+	"car_model":"Q7",
		+	"car_color":"черный",
		+	"car_number":"А777АА",
		+	"confirmed":"confirmed_by_oper",
		+	"crew_coords": {
		+	"lat": 56.833981,
		+	"lon": 53.220249
		+	},
		+	"order_params":[
		+	1,
		+	2,
		+	5
		+	],
		+	"creation_way":"operator",
		+	"is_prior":true,
		+	"is_really_prior":false,
		+	"email":"mail@mail.ru",
		+	"prior_to_current_before_minutes":30,
		+	"flight_number":"A-0501/123",
		+	"sum":50.5,
		+	"total_sum":80,
		+	"cash_sum":20.1,
		+	"cashless_sum":10,
		+	"bonus_sum":5.2,
		+	"bank_card_sum":15,
		+	"attribute_values": [
		+	{
		+	"id": 1,
		+	"bool_value": true
		+	},
		+	{
		+	"id": 2,
		+	"num_value": 1
		+	},
		+	{
		+	"id": 3,
		+	"num_value": 10
		+	},
		+	{
		+	"id": 4,
		+	"str_value": "строка"
		+	}
		+	],
		+	"bill":
		+	[
		+	{
		+	"code":"BOARDING",
		+	"text":"Посадка",
		+	"value":"",
		+	"sum":"20,00"
		+	},
		+	{
		+	"code":"TRIP_TIME",
		+	"text":"Общее время",
		+	"value":"0:00:00",
		+	"sum":""
		+	},
		+	{
		+	"code":"TRIP_DIST",
		+	"text":"Общее расстояние",
		+	"value":"0,00 км",
		+	"sum":""
		+	},
		+	{
		+	"code":"BEFORE_DISC",
		+	"text":"Сумма без скидки",
		+	"value":"",
		+	"sum":"20,00"
		+	},
		+	{
		+	"code":"AFTER_DISC",
		+	"text":"Сумма со скидкой",
		+	"value":"",
		+	"sum":"20,00"
		+	},
		+	{
		+	"code":"MINIMUM",
		+	"text":"Минималка",
		+	"value":"",
		+	"sum":"60,00"
		+	}
		+	],
		+	"fact_route":
		+	[
		+	{
		+	"lat":11.111111,
		+	"lon":22.222222,
		+	"time":"20130117132617",
		+	"speed":123,
		+	"direction":0
		+	}
		+	],
		+	"is_auction":false,
		+	"payment_pay_system": "qr"
		+	}
		+	}
	</pre>		</pre>
−		+	=== Создание задачи СМС серверу ===
−	=== Показать сообщение в ТМ ===
	Метод: POST		Метод: POST
−	Название запроса: show_tm_message	+	Название запроса: send_sms
	Параметры:		Параметры:
	{|		{|
−	!Параметр	+	!Параметры
	!Тип		!Тип
	!Описание		!Описание
	|-		|-
−	!Обязательные параметры	+	!colspan="3"|Обязательные параметры
	|-		|-
−	|text	+	|phone
		+	|Строка, <= 30 символов
		+	|Номер телефона
		+	|-
		+	|message
	|Строка		|Строка
−	|Текст сообщения	+	|Текст СМС
−	|-
−	!Необязательные параметры
−	|-
−	|header
−	|Строка
−	|Заголовок сообщения
−	|-
−	|timeout
−	|Целое
−	|Скрывать сообщение через, сек. (0 — не скрывать)
−	|-
−	|users
−	|Массив
−	|Массив пользователей (если не указаны — отправлять всем)
−	|-
−	|&bull;
−	|Целое
−	|ИД пользователя
	|}		|}
		+	Специальные возвращаемые коды: нет
−	Специальные возвращаемые коды:	+	Возвращаемые данные в случае успешного выполнения запроса: нет
−
−	{|
−	!Код
−	!Описание
−	|-
−	|100
−	|Пользователи для отправки сообщения не найдены
−	|}
		+	Пример:
−	Возвращаемые данные в случае успешного выполнения запроса: нет.
−
−	Пример:
	<pre>		<pre>
		+	Запрос:
−	Запрос:	+	POST /common_api/1.0/send_sms
−	POST /common_api/1.0/show_tm_message HTTP/1.1	+	Content-Type: application/x-www-form-urlencoded
−	Host: 127.0.0.1:8089	+	Content-Length: 33
−	Keep-Alive: 300
−	Connection: keep-alive
−	Signature: 4285286a446064353f4a951b721c54f7
−	{	+	Signature: <...>
−	"text": "Текст сообщения",
−	"users": [
−	1,
−	2,
−	3
−	],
−	"header": "Заголовок",
−	"timeout": 12
−	}
		+	message=SMSText&phone=89050057216
	Ответ:		Ответ:
Строка 4403:		Строка 5620:
	"data":{}		"data":{}
	}		}
−
	</pre>		</pre>
−		+	=== Проверка авторизации ===
−	=== Запрос списка купленных смен водителей ===
	Метод: GET		Метод: GET
−	Название запроса: get_driver_shifts	+	Название запроса: check_authorization
	Параметры:		Параметры:
	{|		{|
−	!Параметр	+	!Параметры
	!Тип		!Тип
	!Описание		!Описание
	|-		|-
−	!Обязательные параметры	+	!colspan="3"|Обязательные параметры
	|-		|-
−	|start_time	+	|login
−	|ГГГГММДДччммсс	+	|Строка, <= 60 символов
−	|Начало периода	+	|Логин
	|-		|-
−	|finish_time	+	|password
−	|ГГГГММДДччммсс	+	|Строка, <= 60 символов
−	|Конец периода	+	|Пароль
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
	|-		|-
−	!Необязательные параметры	+	|100
−	|-	+	|Не найден клиент с логином LOGIN и/или неверный пароль
−	|driver_id
−	|Целое
−	|ИД водителя
−	|-
−	|new_shifts
−	|true или false
−	|Включить в ответ новые смены (по умолчанию true)
−	|-
−	|in_work_shifts
−	|true или false
−	|Включить в ответ смены в работе (по умолчанию true)
−	|-
−	|finished_shifts
−	|true или false
−	|Включить в ответ выполненные смены (по умолчанию true)
−	|-
−	|failed_shifts
−	|true или false
−	|Включить в ответ неуспешно завершенные смены (по умолчанию true)
−	|-
−	|returned_shifts
−	|true или false
−	|Включить в ответ возвращенные смены (по умолчанию false)
	|}		|}
−
−	Специальные возвращаемые коды: нет
	Возвращаемые данные в случае успешного выполнения запроса:		Возвращаемые данные в случае успешного выполнения запроса:
−
	{|		{|
	!Параметр		!Параметр
Строка 4466:		Строка 5661:
	!Описание		!Описание
	|-		|-
−	|shifts	+	|client_id
−	|Массив	+	|Целое
−	|Массив купленных смен	+	|ИД клиента
−	|-	+	|}
−	|&bull; shift_id	+
−	|Целое	+	Пример:
−	|ИД купленной смены	+
		+	<pre>
		+	Запрос:
		+
		+	GET https://ip:port/common_api/1.0/check_authorization?login=LOGIN&password=PASSWORD
		+
		+	Signature: <...>
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"client_id":131
		+	}
		+	}
		+	</pre>
		+
		+	=== Регистрация клиента ===
		+
		+	Метод: POST
		+
		+	Название запроса: register_client
		+
		+	Параметры:
		+
		+	{|
		+	!Параметры
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|name
		+	|Строка, <= 60 символов
		+	|ФИО
	|-		|-
−	|&bull; driver_id	+	|login
−	|Целое	+	|Строка, <= 60 символов
−	|ИД водителя	+	|Логин
	|-		|-
−	|&bull;driver_name	+	|password
−	|Строка	+	|Строка, <= 60 символов
−	|ФИО водителя	+	|Пароль
	|-		|-
−	|&bull; plan_shift_id	+	|phones
	|Строка		|Строка
−	|ИД запланированной смены	+	|Номера телефонов (через запятую)
	|-		|-
−	|&bull; plan_shift_name	+	!colspan="4"|Необязательные параметры
−	|Строка
−	|Наименование запланированной смены
	|-		|-
−	|&bull; plan_shift_cost	+	|client_group
−	|Дробное	+	|Целое
−	|Цена смены	+	|ИД группы клиента
	|-		|-
−	|&bull; plan_shift_type	+	|parent_id
−	|Строка	+	|Целое
−	|Тип смены («limited» - срочная, «unlimited» - бессрочная)	+	|ИД клиента-родителя
	|-		|-
−	|&bull; plan_shift_start_time	+	|address
−	|ГГГГММДДччммсс	+	|Строка
−	|План-начало смены (для срочных)	+	|Домашний адрес
	|-		|-
−	|&bull; plan_shift_finish_time	+	|birthday
−	|ГГГГММДДччммсс	+	|ГГГГММДДччммсс
−	|План-конец смены (для срочных)	+	|Дата рождения
	|-		|-
−	|&bull; plan_shift_length	+	|gender
−	|Целое	+	|Строка
−	|План продолжительность смены, ч. (для бессрочных)	+	|Пол. Может принимать значения:
		+	• "male" -  мужской
		+
		+	• "female" - женский
	|-		|-
−	|&bull; plan_shift_crew_group_id	+	|email
−	|Целое	+	|Строка
−	|ИД группы экипажей, которые могут купить смену	+	|E-mail
	|-		|-
−	|&bull; shift_state	+	|use_email_informing
−	|Строка	+	|true или false
−	|Состояние смены («new» - новая, «in_work» - в работе, «finished» - завершена успешно, «failed» - завершена неуспешно)	+	|Использовать E-mail для отправки уведомлений по заказу
	|-		|-
−	|&bull; buy_time	+	|comment
−	|ГГГГММДДччммсс	+	|Строка
−	|Время продажи смены водителю	+	|Комментарий
	|-		|-
−	|&bull; is_returned	+	|use_own_account
−	|true или false	+	|true или false
−	|Признак возвращенной смены	+	|Использовать собственный счет для оплаты заказов
−	|-	+	|}
−	|&bull; return_time	+
−	|ГГГГММДДччммсс	+	Специальные возвращаемые коды:
−	|Время возврата смены	+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Клиент с ИД=ID имеет такой же номер телефона=PHONE
		+	|-
		+	|101
		+	|Клиент с логином=LOGIN уже существует
		+	|-
		+	|102
		+	|Группа клиента с ИД=CLIENT_GROUP не найдена
	|-		|-
−	|&bull; orders_count	+	|103
−	|Целое	+	|Клиент указанный в качестве родителя с ИД=PARENT_ID не найден
−	|Количество заказов, выполненных водителем за смену
	|-		|-
−	|&bull; orders_sum	+	|109
−	|Дробное	+	|Пароль клиента не соответствует политике паролей
−	|Сумма заказов, выполненных водителем за смену	+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
	|-		|-
−	|&bull; fact_length	+	|client_id
−	|Дробное	+	|Целое
−	|Фактическая продолжительность смены, ч.	+	|ИД созданного клиента
	|}		|}
Строка 4548:		Строка 5796:
	Запрос:		Запрос:
−	GET https://ip:port/common_api/1.0/get_driver_shifts?start_time=20140101101010&finish_time=20140101202020 HTTP/1.1	+	POST https://ip:port/common_api/1.0/register_client
	Signature: <...>		Signature: <...>
		+	Content-Type: application/x-www-form-urlencoded
		+	Content-Length: 104
		+	name=NAME&phones=88,99&login=LOGIN&password=PASSWORD&birthday=19930218115517&gender=male&address=ADDRESS&client_group=1&parent_id=10&email=mail%40ya.ru&use_email_informing=true&use_own_account=false
Строка 4558:		Строка 5809:
	"descr":"OK",		"descr":"OK",
	"data":{		"data":{
−	"shifts":[	+	"client_id":140
−	{	+	}
−	"shift_id":1,	+	}
−	"driver_id":1,	+	</pre>
−	"driver_name":"DRIVER_1",	+
−	"plan_shift_id":1,	+	=== Регистрация клиента 2 ===
−	"plan_shift_name":"PLAN_SHIFT_1",	+	Метод: POST
−	"plan_shift_cost":100,	+
−	"plan_shift_type":"limited",	+	Название запроса: register_client2
−	"plan_shift_start_time":"20140101101010",	+
−	"plan_shift_finish_time":"20140101101010",	+	Версия ТМ: 3.12
−	"plan_shift_length":null,	+
−	"plan_shift_crew_group_id":1,	+	Параметры в формате JSON:
−	"shift_state":new,	+
−	"buy_time":"20140101101010",
−	"is_returned":false,
−	"return_time":null,
−	"orders_count":10,
−	"orders_sum":1000,
−	"fact_length":1.2
−	},
−	{
−	"shift_id":2,
−	"driver_id":2,
−	"driver_name":"DRIVER_2",
−	"plan_shift_id":2,
−	"plan_shift_name":"PLAN_SHIFT_2",
−	"plan_shift_cost":200,
−	"plan_shift_type":"unlimited",
−	"plan_shift_start_time":null,
−	"plan_shift_finish_time":null,
−	"plan_shift_length":8,
−	"plan_shift_crew_group_id":null,
−	"shift_state":new,
−	"buy_time":"20140101101010",
−	"is_returned":true,
−	"return_time":"20140101101010",
−	"orders_count":0,
−	"orders_sum":0,
−	"fact_length":0
−	}
−	]
−	}
−	}
−	</pre>
−
−
−	=== Запрос списка запланированных смен водителей ===
−
−	Метод: GET
−
−	Название запроса: get_driver_plan_shifts
−
−	Параметры:
−
	{|		{|
−	!Параметр	+	!Параметры
	!Тип		!Тип
	!Описание		!Описание
	|-		|-
−	!Обязательные параметры	+	!colspan="3"|Обязательные параметры
	|-		|-
−	|start_time	+	|name
−	|ГГГГММДДччммсс	+	|Строка, <= 60 символов
−	|Начало периода (если включаем в ответ срочные смены)	+	|ФИО
	|-		|-
−	|finish_time	+	|login
−	|ГГГГММДДччммсс	+	|Строка, <= 60 символов
−	|Конец периода (если включаем в ответ срочные смены)	+	|Логин
	|-		|-
−	!Необязательные параметры	+	|password
		+	|Строка, <= 60 символов
		+	|Пароль
	|-		|-
−	|limited_shifts	+	|phones
−	|true или false	+	|Массив
−	|Включить в ответ срочные смены (по умолчанию true)	+	|Массив телефонов клиента
	|-		|-
−	|unlimited_shifts	+	|&bull; phone
−	|true или false	+	|Строка
−	|Включить в ответ бессрочные смены (по умолчанию true)	+	|Номер телефона
−	|}
−
−	Специальные возвращаемые коды: нет
−
−	Возвращаемые данные в случае успешного выполнения запроса:
−	{|
−	!Параметр
−	!Тип
−	!Описание
	|-		|-
−	|plan_shifts	+	|&bull; is_default
−	|Массив	+	|true или false
−	|Массив запланированных смен	+	|Признак основного телефона
	|-		|-
−	|&bull; plan_shift_id	+	!colspan="4"|Необязательные параметры
−	|Целое
−	|ИД запланированной смены
	|-		|-
−	|&bull; plan_shift_name	+	|client_group_id
−	|Строка	+	|Целое
−	|Наименование запланированной смены	+	|ИД группы клиента
	|-		|-
−	|&bull; plan_shift_comment	+	|parent_id
−	|Строка	+	|Целое
−	|Комментарий запланированной смены	+	|ИД клиента-родителя
	|-		|-
−	|&bull; plan_shift_cost	+	|address
−	|Дробное	+	|Строка
−	|Цена смены	+	|Домашний адрес
	|-		|-
−	|&bull; plan_shift_type	+	|birthday
−	|Строка	+	|ГГГГММДДччммсс
−	|Тип смены («limited» - срочная, «unlimited» - бессрочная)	+	|Дата рождения
	|-		|-
−	|&bull; plan_shift_start_time	+	|gender
−	|ГГГГММДДччммсс	+	|Строка
−	|План-начало смены (для срочных)	+	|Пол. Может принимать значения:
		+	• "male" -  мужской
		+
		+	• "female" - женский
		+	|-
		+	|email
		+	|Строка
		+	|E-mail
		+	|-
		+	|use_email_informing
		+	|true или false
		+	|Использовать E-mail для отправки уведомлений по заказу
		+	|-
		+	|comment
		+	|Строка
		+	|Комментарий
		+	|-
		+	|use_own_account
		+	|true или false
		+	|Использовать собственный счет для оплаты заказов
	|-		|-
−	|&bull; plan_shift_finish_time	+	|attribute_values
−	|ГГГГММДДччммсс	+	|Массив
−	|План-конец смены (для срочных)	+	|Массив значений атрибутов
	|-		|-
−	|&bull; plan_shift_length	+	|&bull; id
−	|Целое	+	|Целое
−	|План продолжительность смены, ч. (для бессрочных)	+	|Идентификатор атрибута
	|-		|-
−	|&bull; plan_shift_crew_group_id	+	|&bull; bool_value
−	|Целое	+	|true или false
−	|ИД группы экипажей, которые могут купить смену	+	|Значение, если тип атрибута «Логический»
	|-		|-
−	|&bull; max_sell_count	+	|&bull; num_value
−	|Целое	+	|Дробное
−	|Максимальное количество продаж смены	+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
	|-		|-
−	|&bull; sold_count	+	|&bull; str_value
−	|Целое	+	|Строка
−	|Количество продаж смены	+	|Значение, если тип атрибута «Строка»
	|}		|}
−	Пример:	+	Специальные возвращаемые коды:
−		+	{|
−	<pre>	+	!Код
−	Запрос:	+	!Описание
−		+	|-
−	GET https://ip:port/common_api/1.0/get_driver_plan_shifts?start_time=20140101101010&finish_time=20140101202020 HTTP/1.1	+	|100
−	Signature: <...>	+	|Дублирование номера телефона=PHONE в списке
−		+	|-
−		+	|101
		+	|Клиент с логином=LOGIN уже существует
		+	|-
		+	|102
		+	|Группа клиента с ИД=CLIENT_GROUP не найдена
		+	|-
		+	|103
		+	|Клиент указанный в качестве родителя с ИД=PARENT_ID не найден
		+	|-
		+	|105
		+	|Основной телефон может быть только один
		+	|-
		+	|106
		+	|Клиент должен иметь основной телефон
		+	|-
		+	|107
		+	|Атрибут с ИД=ID не найден
		+	|-
		+	|108
		+	|Атрибут с ИД=ID не может быть привязан к клиенту
		+	|-
		+	|109
		+	|Пароль клиента не соответствует политике паролей
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|client_id
		+	|Целое
		+	|ИД созданного клиента
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/common_api/1.0/register_client2 HTTP/1.1
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"name":"NAME",
		+	"login":"LOGIN",
		+	"password":"PASSWORD",
		+	"phones":[
		+	{
		+	"phone":"88",
		+	"is_default":true
		+	},
		+	{
		+	"phone":"99",
		+	"is_default":false
		+	}
		+	],
		+	"address":"ADDRESS",
		+	"gender":"male",
		+	"birthday":"20000101000000",
		+	"client_group_id":1,
		+	"parent_id":10,
		+	"email":"mail@ya.ru",
		+	"use_email_informing":true,
		+	"comment":"TEXT",
		+	"use_own_account":false,
		+	"attribute_values":[
		+	{
		+	"id":5,
		+	"bool_value":true
		+	},
		+	{
		+	"id":7,
		+	"num_value":10
		+	},
		+	{
		+	"id":9,
		+	"str_value":"TEST"
		+	}
		+	]
		+	}
		+
	Ответ:		Ответ:
Строка 4711:		Строка 6019:
	"descr":"OK",		"descr":"OK",
	"data":{		"data":{
−	"plan_shifts":[	+	"client_id":140
−	{	+	}
−	"plan_shift_id":1,	+	}
−	"plan_shift_name":"PLAN_SHIFT_1",	+
−	"plan_shift_comment":"PLAN_SHIFT_COMMENT_1",
−	"plan_shift_cost":100,
−	"plan_shift_type":"limited",
−	"plan_shift_start_time":"20140101101010",
−	"plan_shift_finish_time":"20140101101010",
−	"plan_shift_length":null,
−	"plan_shift_crew_group_id":1,
−	"max_sell_count":100,
−	"sold_count":10
−	},
−	{
−	"plan_shift_id":2,
−	"plan_shift_name":"PLAN_SHIFT_2",
−	"plan_shift_comment":"PLAN_SHIFT_COMMENT_2",
−	"plan_shift_cost":200,
−	"plan_shift_type":"unlimited",
−	"plan_shift_start_time":null,
−	"plan_shift_finish_time":null,
−	"plan_shift_length":8,
−	"plan_shift_crew_group_id":2,
−	"max_sell_count":200,
−	"sold_count":20
−	}
−	]
−	}
−	}
	</pre>		</pre>
		+	=== Запрос информации по клиенту ===
−	=== Продажа смены водителю ===	+	Метод: GET
−	Метод: POST	+	Название запроса: get_client_info
−
−	Название запроса: driver_buy_shift
	Параметры:		Параметры:
	{|		{|
−	!Параметр	+	!Параметры
	!Тип		!Тип
	!Описание		!Описание
	|-		|-
−	!Обязательные параметры	+	!colspan="3"|Обязательные параметры
	|-		|-
−	|crew_id	+	|client_id
−	|Целое	+	|Целое
−	|ИД экипажа	+	|ИД клиента
		+	|-
		+	!colspan="3"|Необязательные параметры
	|-		|-
−	|plan_shift_id	+	|fields
−	|Целое	+	|Строка
−	|ИД запланированной смены	+	|Список возвращаемых полей через запятую. Для полей списка сотрудников, запрашиваемого клиента, названия начинаются с "employees.", например: "employees.name"
	|}		|}
	Специальные возвращаемые коды:		Специальные возвращаемые коды:
−
	{|		{|
	!Код		!Код
	!Описание		!Описание
	|-		|-
−	|100	+	|100
−	|Запланированная смена не найдена	+	|Не найден клиент ИД=CLIENT_ID
−	|-	+	|}
−	|101	+
−	|Экипаж не найден	+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
	|-		|-
−	|102	+	|client_id
−	|Водитель не найден	+	|Целое
		+	|ИД клиента
	|-		|-
−	|103	+	|parent_id
−	|Недостаточно денег на счете водителя	+	|Целое
		+	|ИД клиента-родителя
	|-		|-
−	|104	+	|name
−	|Водитель уволен либо заблокирован	+	|Строка
		+	|ФИО
	|-		|-
−	|105	+	|number
−	|Запланированная смена устарела	+	|Строка
		+	|Номер договора
	|-		|-
−	|106	+	|address
−	|Не подходит группа экипажа	+	|Строка
		+	|Домашний адрес
	|-		|-
−	|107	+	|gender
−	|Превышено максимальное число покупок смены	+	|Строка
−	|-	+	|Пол. Может принимать значения:
−	|108	+	• "" - не указан
−	|Повторная покупка смены
−	|}
		+	• "male" -  мужской
−	Возвращаемые данные в случае успешного выполнения запроса: нет.	+	• "female" - женский
−		+	|-
−	Пример:	+	|birthday
−		+	|ДД.ММ.ГГГГ
−	<pre>	+	|Дата рождения
−	Запрос:	+	|-
−		+	|phones
−	POST https://ip:port/common_api/1.0/get_cars_info HTTP/1.1	+	|Массив
−	Signature: <...>	+	|Массив телефонов клиента
−	Content-Type: application/x-www-form-urlencoded	+	|-
−	Content-Length: 25	+	|&bull; phone
−	crew_id=1&plan_shift_id=1	+	|Строка
−		+	|Номер телефона клиента
−		+	|-
−	Ответ:	+	|balance
−		+	|Дробное
−	{	+	|Баланс
−	"code":0,	+	|-
−	"descr":"OK",	+	|bonus_balance
−	"data":{}	+	|Дробное
−	}	+	|Бонусный баланс
−	</pre>	+	|-
−		+	|login
−	== Описание протокола TMTAPI Версия 1.0 ==	+	|Строка
−		+	|Логин
−	=== Общее описание протокола ===	+	|-
−		+	|password
−	==== Формат запроса ====	+	|Строка
−		+	|Пароль
−	TM API принимает входящие запросы по протоколу HTTPS. В URI запроса после ip адреса и порта, который будет слушать TM API, должно идти название API (tm_tapi) и версия API.	+	|-
−		+	|client_group_id
−	Пример:	+	|Целое
−		+	|ИД группы клиента
−	<pre>	+	|-
−	GET https://ip:port/tm_tapi/1.0/get_info_by_phone HTTP/1.1	+	|tariff_id
−	</pre>	+	|Целое
−		+	|ИД тарифа клиента или группы клиентов
−	Для получения данных из БД используются запросы типа GET. Для записи данных в БД используются запросы типа POST. В запросе типа GET параметры запроса передаются в URI.	+	|-
−		+	|prize_tariff_id
−	Пример:	+	|Целое
−		+	|ИД призового тарифа клиента или группы клиентов
−	<pre>	+	|-
−	GET https://ip:port/tm_tapi/1.0/get_info_by_phone?phone=89058800565&fields=PHONE_TYPE-PHONE_	+	|tariff_shift_id
−	TO_DIAL&signature=661ce071eeefcb4f7fc8bc1f17bd520b HTTP/1.1	+	|Целое
−	</pre>	+	|ИД смены тарифов клиента или группы клиентов
−
−	В запросе типа POST параметры передаются в теле запроса в формате application/x-www-form-
−	urlencoded.
−
−	Пример:
−
−	<pre>
−	POST https://ip:port/tm_tapi/1.0/change_order_state HTTP/1.1
−	Content-Type: application/x-www-form-urlencoded
−	Content-Length: 71
−
−	order_id=98798&need_state=12&signature=a204c50c7e48f0c6849a87485fe5e171
−	</pre>
−
−	В любом запросе обязательно с другими полями должно передаваться поле signature. В нем передается MD5 хэш, рассчитанный для строки, которая получается сцеплением строки параметров запроса с секретным ключом. Секретный ключ задается в настройках модуля TMAPI в Такси-Мастер.
−
−	Пример:
−
−	<pre>
−	Запрос:
−	GET https://ip:port/tm_tapi/1.0/get_info_by_phone?phone=89058800565&fields=PHONE_TYPE
−	&signature=ef17ea682d09e452af544a5758dba396 HTTP/1.1
−
−	Секретный ключ:
−	321
−
−	Signature = MD5("phone=89058800565&fields=PHONE_TYPE" + "321") = ef17ea682d09e452af544a5758dba396
−	HTTP/1.1
−	</pre>
−
−	==== Формат ответа ====
−	TM API всегда возвращает HTTP код 200 ОК. Результат выполнения запроса содержится в теле ответа в формате XML. Общий вид возвращаемого результата:
−
−	<pre>
−	<response>
−	<code>Числовой код результата</code>
−	<descr>Строковое описание результата</descr>
−	<data>Дополнительная информация</data>
−	</response>
−	</pre>
−
−	Существуют общие для всех запросов коды результатов:
−	{|
−	! Код
−	! Описание
	|-		|-
−	|0	+	|discount_id
−	|Успешное выполнение запроса	+	|Целое
		+	|ИД скидки клиента или группы клиентов
	|-		|-
−	|1	+	|prize_discount_id
−	|Неизвестная ошибка	+	|Целое
		+	|ИД призовой скидки клиента или группы клиентов
	|-		|-
−	|2	+	|min_balance
−	|Неизвестный тип API	+	|Дробное
		+	|Порог, ниже которого не может опускаться баланс
	|-		|-
−	|3	+	|min_balance_for_use_cashless
−	|API отключено в настройках модуля TM API в Такси-Мастер	+	|Дробное
		+	|Минимальный баланс для использования безналичного счета
	|-		|-
−	|4	+	|min_bonus_balance_for_use_bonus
−	|Не совпадает секретный ключ	+	|Дробное
		+	|Минимальный баланс для использования бонусного счета
	|-		|-
−	|5	+	|is_locked
−	|Неподдерживаемая версия API	+	|true или false
		+	|Клиент заблокирован
	|-		|-
−	|6	+	|lock_description
−	|Неизвестное название запроса	+	|Строка
		+	|Причина блокировки
	|-		|-
−	|7	+	|use_cashless_account
−	|Неверный тип запроса GET	+	|true или false
		+	|Признак использования безналичного счета
	|-		|-
−	|8	+	|use_cashless
−	|Не хватает входного параметра (в доп. информации ответа будет название отсутствующего параметра)	+	|true или false
		+	|Признак использования безналичного расчета по умолчанию. Имеет смысл только при use_cashless_account = true
	|-		|-
−	|9	+	|no_cash_payment
−	|Некорректный входной параметр (в доп. информации ответа будет название некорректного параметра)	+	|true или false
		+	|Признак запрета использования наличных расчетов. Имеет смысл только при use_cashless_account = true и use_cashless = true
	|-		|-
−	|10	+	|remain_prize
−	|Внутренняя ошибка обработки запроса	+	|Целое
−	|}	+	|Сколько заказов осталось до призового
−
−	=== Описание запросов ===
−
−	==== Запрос информации по номеру телефона ====
−	Метод: GET
−
−	Название запроса: get_info_by_phone
−
−	Параметры:
−
−	{|
−	!Параметр
−	!Тип
−	!Описание
	|-		|-
−	!colspan="3"|Обязательные параметры	+	|email
		+	|Строка
		+	|E-mail
	|-		|-
−	|PHONE	+	|use_email_informing
−	|Строка, <= 16 символов	+	|true или false
−	|Номер телефона	+	|Использовать E-mail для отправки уведомлений по заказу
	|-		|-
−	|FIELDS	+	|default_crew_group
−	|Строка	+	|Целое
−	|Список полей, которые необходимо вернуть. Поля перечисляются через символ ''"-"''	+	|Группа экипажей по умолчанию
	|-		|-
−	|signature	+	|use_own_account
−	|Строка	+	|true или false
−	|Поле для проверки секретного ключа.	+	|Использовать собственный счет для оплаты заказа
−	|}
−
−	Специальные возвращаемые коды: нет
−
−	Возвращаемые данные в случае успешного выполнения запроса: зависит от того какие поля были переданы в поле fields.
−
−	{|
−	!Параметр
−	!Тип
−	!Описание
	|-		|-
−	|PHONE_TYPE	+	|comment
−	|Целое	+	|Строка
−	|Тип телефона звонящего	+	|Комментарий
−	(1 - если звонит водитель; 2 - если звонит физическое лицо; 3 - если звонит юридическое лицо; 4 - если звонит номер из справочника Телефоны; 0 - неизвестный номер)
	|-		|-
−	|PHONE_TO_DIAL	+	|employees
−	|Строка, <= 16 символов	+	|Массив
−	|Номер телефона для отзвона по заказу	+	|Массив сотрудников клиента. Поля аналогичны полям основного клиента, только у сотрудников отсутствует поле employees
	|-		|-
−	|CREW_ID	+	|accounts
−	|Целое	+	|Массив
−	|ИД экипажа	+	|Массив счетов клиента. Для сотрудников счета возвращаются, только если их явно запросили в фильтре полей "employees.accounts"
−	|-
−	|IS_PRIOR
−	|true или false
−	|Признак предварительного заказа
	|-		|-
−	|ORDER_CLIENT_ID	+	|&bull; account_kind
	|Целое		|Целое
−	|ИД клиента из заказа	+	|Тип счета:
		+	* 0 - Основной счет
		+	* 1- Бонусный счет
		+	* Остальные - нестандартные счета
	|-		|-
−	|DRIVER_PHONE	+	|&bull; balance
−	|Строка, <= 16 символов	+	|Дробное
−	|Номер телефона водителя	+	|Баланс счета клиента
	|-		|-
−	|CREW_SYSTEMSTATE	+	|&bull; balance_with_children
−	|Целое	+	|Дробное
−	|Состояние экипажа	+	|Баланс счета клиента с учетом вложенных клиентов
	|-		|-
−	|CLIENT_ID	+	|attribute_values
−	|Целое	+	|Массив
−	|ИД клиента	+	|Массив значений атрибутов. Возвращается, только если явно запросили в фильтре полей "attribute_values" или "employees.attribute_values" для сотрудников
	|-		|-
−	|CLIENT_TYPE	+	|&bull; id
−	|Целое	+	|Целое
−	|Тип клиента	+	|Идентификатор атрибута
	|-		|-
−	|CATEGORYID	+	|&bull; bool_value
−	|Целое	+	|true или false
−	|ИД категории телефона	+	|Значение, если тип атрибута «Логический»
	|-		|-
−	|PHONE_SYSTEM_CATEGORY	+	|&bull; num_value
−	|Целое	+	|Дробное
−	|Системное значение категории телефона (0 - обычный, 1 - черный, 2 - белый, 3 - серый)	+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
	|-		|-
−	|ORDER_ID	+	|&bull; str_value
−	|Целое	+	|Строка
−	|ИД заказа	+	|Значение, если тип атрибута «Строка»
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	GET https://ip:port/common_api/1.0/get_client_info?client_id=140
		+
		+	Signature: <...>
		+
		+	Ответ:
		+
		+	{
		+	"code": 0,
		+	"descr": "OK",
		+	"data": {
		+	"client_id": 20,
		+	"parent_id": 0,
		+	"name": "Юр. лицо1",
		+	"number": "111",
		+	"address": "Адрес Юр. лицо1",
		+	"gender": "",
		+	"birthday": "22.01.2016",
		+	"phones": [
		+	"105",
		+	"123456789",
		+	"100"
		+	],
		+	"balance": 10,
		+	"bonus_balance": 333,
		+	"login": "111",
		+	"password": "111",
		+	"client_group_id": 1,
		+	"tariff_id": 39,
		+	"prize_tariff_id": 0,
		+	"tariff_shift_id": 0,
		+	"discount_id": 2,
		+	"prize_discount_id": 0,
		+	"min_balance": 0,
		+	"min_balance_for_use_cashless": null,
		+	"min_bonus_balance_for_use_bonus": null,
		+	"is_locked": false,
		+	"lock_description": "",
		+	"use_cashless_account": true,
		+	"use_cashless": true,
		+	"remain_prize": 0,
		+	"email": "Юр. лицо1@ss.ru",
		+	"use_email_informing": true,
		+	"default_crew_group": 6,
		+	"comment": "Сотрудник СВР. Использовать максимальные скидки",
		+	"employees": [
		+	{
		+	"client_id": 323,
		+	"parent_id": 20,
		+	"name": "Сотрудник1",
		+	"number": "111",
		+	"address": "Адрес Сотрудник1",
		+	"gender": "",
		+	"birthday": null,
		+	"phones": [
		+	"11221122112211"
		+	],
		+	"balance": 0,
		+	"bonus_balance": 0,
		+	"login": "",
		+	"password": "",
		+	"client_group_id": 1,
		+	"tariff_id": 17,
		+	"prize_tariff_id": 0,
		+	"tariff_shift_id": 0,
		+	"discount_id": 2,
		+	"prize_discount_id": 0,
		+	"min_balance": 0,
		+	"min_balance_for_use_cashless": null,
		+	"min_bonus_balance_for_use_bonus": null,
		+	"is_locked": false,
		+	"lock_description": "",
		+	"use_cashless": true,
		+	"remain_prize": 0,
		+	"email": "Сотрудник1@ss.ru",
		+	"use_email_informing": true,
		+	"default_crew_group": 6,
		+	"accounts": [
		+	{
		+	"account_kind": 0,
		+	"balance": 400.00,
		+	"balance_with_children": 0.00
		+	},
		+	{
		+	"account_kind": 1,
		+	"balance": 0.00,
		+	"balance_with_children": 0.00
		+	},
		+	{
		+	"account_kind": 1003,
		+	"balance": 100.00,
		+	"balance_with_children": 0.00
		+	}
		+	],
		+	"attribute_values": [
		+	{
		+	"id": 5,
		+	"bool_value": true
		+	},
		+	{
		+	"id": 4,
		+	"bool_value": true
		+	}
		+	]
		+	}
		+	],
		+	"accounts": [
		+	{
		+	"account_kind": 0,
		+	"balance": 2355.00,
		+	"balance_with_children": 2755.00
		+	},
		+	{
		+	"account_kind": 1,
		+	"balance": 0.00,
		+	"balance_with_children": 0.00
		+	},
		+	{
		+	"account_kind": 1003,
		+	"balance": -20.00,
		+	"balance_with_children": 80.00
		+	}
		+	],
		+	"attribute_values": [
		+	{
		+	"id": 4,
		+	"bool_value": true
		+	}
		+	]
		+	}
		+	}
		+	</pre>
		+
		+	=== Запрос информации по клиентам ===
		+	Метод: GET
		+
		+	Название запроса: get_clients_info
		+
		+	Версия ТМ: 3.5
		+
		+	Параметры:
		+	{|
		+	!Параметры
		+	!Тип
		+	!Описание
	|-		|-
−	|DRIVER_ID	+	!colspan="3"|Необязательные параметры
−	|Целое
−	|ИД водителя
	|-		|-
−	|ORDER_STATE	+	|text
−	|Целое	+	|Строка
−	|Состояние заказа	+	|Текст для поиска по названию или по номеру договора клиента
	|-		|-
−	|DRIVER_REMAINDER	+	|max_clients_count
−	|Дробное	+	|Целое
−	|Баланс счета водителя	+	|Максимальное количество клиентов, которое надо вернуть. Если не указано, то 10.
	|-		|-
−	|DISCOUNTEDSUMM	+	|client_group_id
−	|Строка	+	|Целое
−	|Сумма заказа с учетом всех скидок	+	|Фильтр по группе клиентов
	|-		|-
−	|CREW_GROUP_ID	+	|parent_id
−	|Целое	+	|Целое
−	|ИД группы экипажа	+	|Фильтр по вышестоящему подразделению, возвращаются все подчиненные отделы и сотрудники на всю глубину иерархии
	|-		|-
−	|CLIENT_BALANCE	+	|fields
−	|Дробное	+	|Строка
−	|Баланс клиента	+	|Список возвращаемых полей через запятую. По умолчанию возвращаются поля "name" и "number". Поле "client_id" возвращается всегда
		+	|}
		+
		+	Специальные возвращаемые коды: Нет
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметры
		+	!Тип
		+	!Описание
	|-		|-
−	|DRIVER_TIMECOUNT	+	|client_id
−	|Целое	+	|Целое
−	|Время пути водителя до адреса подачи (в минутах)	+	|ИД клиента
	|-		|-
−	|SOURCE_TIMECOUNT	+	|name
−	|Целое	+	|Строка
−	|Время оставшееся до подачи (в минутах)	+	|Наименование
	|-		|-
−	|SOUND_COLOR	+	|number
−	|Строка	+	|Строка
−	|Запись с информацией о цвете	+	|Номер договора
	|-		|-
−	|SOUND_MARK	+	|parent_id
−	|Строка	+	|Целое
−	|Запись с информацией о марке автомобиля	+	|ИД клиента-родителя
	|-		|-
−	|GOSNUMBER	+	|address
−	|Строка	+	|Строка
−	|Государственный номер автомобиля	+	|Домашний адрес
	|-		|-
−	|CAR_COLOR	+	|gender
	|Строка		|Строка
−	|Цвет автомобиля	+	|Пол. Может принимать значения:
		+	• "" - не указан
		+
		+	• "male" -  мужской
		+
		+	• "female" - женский
	|-		|-
−	|CAR_MARK	+	|birthday
−	|Строка	+	|ДД.ММ.ГГГГ
−	|Марка автомобиля	+	|Дата рождения
		+	|-
		+	|phones
		+	|Массив
		+	|Массив телефонов клиента
		+	|-
		+	|&bull; phone
		+	|Строка
		+	|Номер телефона клиента
		+	|-
		+	|balance
		+	|Дробное
		+	|Баланс
		+	|-
		+	|bonus_balance
		+	|Дробное
		+	|Бонусный баланс
		+	|-
		+	|login
		+	|Строка
		+	|Логин
		+	|-
		+	|password
		+	|Строка
		+	|Пароль
		+	|-
		+	|client_group_id
		+	|Целое
		+	|ИД группы клиента
	|-		|-
−	|ORDER_COORDS	+	|tariff_id
−	|Строка	+	|Целое
−	|Координаты места подачи	+	|ИД тарифа клиента или группы клиентов
	|-		|-
−	|CREW_COORDS	+	|prize_tariff_id
−	|Строка	+	|Целое
−	|Координаты назначенного экипажа	+	|ИД призового тарифа клиента или группы клиентов
	|-		|-
−	|MARKET_TYPE	+	|tariff_shift_id
	|Целое		|Целое
−	|Тип биржи заказов (2 — Яндекс, 3 — ЦОЗ).	+	|ИД смены тарифов клиента или группы клиентов
	|-		|-
−	|ORDERS_COUNT	+	|discount_id
	|Целое		|Целое
−	|Для телефона клиента — количество текущих и предварительных заказов по телефону; для телефона водителя — количество текущих заказов, на которые назначен данный водитель	+	|ИД скидки клиента или группы клиентов
	|-		|-
−	|CLIENT_GROUP_ID	+	|prize_discount_id
	|Целое		|Целое
−	|ИД группы клиента	+	|ИД призовой скидки клиента или группы клиентов
	|-		|-
−	|CLIENT_BONUS_BALANCE	+	|min_balance
	|Дробное		|Дробное
−	|Бонусный баланс клиента	+	|Порог, ниже которого не может опускаться баланс
	|-		|-
−	|AD_LIGHTHOUSE	+	|min_balance_for_use_cashless
−	|Строка	+	|Дробное
−	|Признак наличия шашек. Пустая строка – номер клиента или водителя без экипажа. 1 – есть шашки, 0 – нет шашек.	+	|Минимальный баланс для использования безналичного счета
	|-		|-
−	|CREW_STATE	+	|min_bonus_balance_for_use_bonus
−	|Целое	+	|Дробное
−	|Состояние экипажа.	+	|Минимальный баланс для использования бонусного счета
−	|}	+	|-
		+	|is_locked
		+	|true или false
		+	|Клиент заблокирован
		+	|-
		+	|lock_description
		+	|Строка
		+	|Причина блокировки
		+	|-
		+	|use_cashless_account
		+	|true или false
		+	|Признак использования безналичного счета
		+	|-
		+	|use_cashless
		+	|true или false
		+	|Признак использования безналичного расчета по умолчанию. Имеет смысл только при use_cashless_account = true
		+	|-
		+	|no_cash_payment
		+	|true или false
		+	|Признак запрета использования наличных расчетов. Имеет смысл только при use_cashless_account = true и use_cashless = true
		+	|-
		+	|remain_prize
		+	|Целое
		+	|Сколько заказов осталось до призового
		+	|-
		+	|email
		+	|Строка
		+	|E-mail
		+	|-
		+	|use_email_informing
		+	|true или false
		+	|Использовать E-mail для отправки уведомлений по заказу
		+	|-
		+	|default_crew_group
		+	|Целое
		+	|Группа экипажей по умолчанию
		+	|-
		+	|use_own_account
		+	|true или false
		+	|Использовать собственный счет для оплаты заказа
		+	|-
		+	|comment
		+	|Строка
		+	|Комментарий
		+	|-
		+	|accounts
		+	|Массив
		+	|Массив счетов клиента
		+	|-
		+	|&bull; account_kind
		+	|Целое
		+	|Тип счета:
		+	* 0 - Основной счет
		+	* 1- Бонусный счет
		+	* Остальные - нестандартные счета
		+	|-
		+	|&bull; balance
		+	|Дробное
		+	|Баланс счета клиента
		+	|-
		+	|&bull; balance_with_children
		+	|Дробное
		+	|Баланс счета клиента с учетом вложенных клиентов
		+	|-
		+	|attribute_values
		+	|Массив
		+	|Массив значений атрибутов
		+	|-
		+	|&bull; id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|&bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|&bull; num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|&bull; str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
		+	|}
	Пример:		Пример:
Строка 5104:		Строка 6617:
	<pre>		<pre>
	Запрос:		Запрос:
−	GET https://ip:port/tm_tapi/1.0/get_info_by_phone?phone=89058800565l&fields=PHONE_TYPE-PHONE_	+
−	TO_DIAL-CREW_ID-ORDER_ID&signature=d35ab2765f2968d48c096d5f5327db26 HTTP/1.1	+	GET https://ip:port/common_api/1.0/get_clients_info?text=test&max_clients_count=10&client_group_id=1&parent_id=20&fields=name,number HTTP/1.1
		+	Signature: <...>
	Ответ:		Ответ:
−	<response>	+	{
−	<code>0</code>	+	"code":0,
−	<descr>OK</descr>	+	"descr":"OK",
−	<data>	+	"data":{
−	<PHONE_TYPE>0</PHONE_TYPE>	+	"clients_info":[
−	<PHONE_TO_DIAL></PHONE_TO_DIAL>	+	{
−	<CREW_ID>3</CREW_ID>	+	"client_id":390,
−	<ORDER_ID>6</ORDER_ID>	+	"name":"tester1",
−	</data>	+	"number":"001"
−	</response>	+	},
		+	{
		+	"client_id":394,
		+	"name":"tester2",
		+	"number":"002"
		+	}
		+	]
		+	}
		+	}
		+
	</pre>		</pre>
−	==== Запрос информации по ИД заказа ====	+	=== Изменение информации по клиенту ===
−	Метод: GET	+	Метод: POST
−	Название запроса: get_info_by_order_id	+	Название запроса: update_client_info
	Параметры:		Параметры:
	{|		{|
−	!Параметр	+	!Параметры
−	!Тип	+	!Тип
	!Описание		!Описание
	|-		|-
−	|colspan="3"|Обязательные параметры	+	!colspan="3"|Обязательные параметры
	|-		|-
−	|ORDER_ID	+	|client_id
−	|Целое	+	|Целое
−	|ИД заказа	+	|ИД клиента
	|-		|-
−	|FIELDS	+	!colspan="3"|Необязательные параметры
−	|Строка
−	|Список полей, которые необходимо вернуть. Поля перечисляются через символ ''"-"''
	|-		|-
−	|signature	+	|name
−	|Строка	+	|Строка, <= 60 символов
−	|Поле для проверки секретного ключа	+	|ФИО
−	|}
−
−	Специальные возвращаемые коды: нет
−
−	Возвращаемые данные в случае успешного выполнения запроса: зависит от того какие поля были переданы в поле fields.
−
−	{|
−	!Параметр
−	!Тип
−	!Описание
	|-		|-
−	|DRIVER_TIMECOUNT	+	|login
−	|Строка, <= 16 символов	+	|Строка, <= 60 символов
−	|Время до подачи в минутах, указанное водителем	+	|Логин
	|-		|-
−	|SOUND_COLOR	+	|password
−	|Строка	+	|Строка, <= 60 символов
−	|Запись с информацией о цвете	+	|Пароль
	|-		|-
−	|CAR_MARK	+	|phones
−	|Строка	+	|Строка
−	|Марка автомобиля	+	|Номера телефонов (через запятую)
	|-		|-
−	|CAR_COLOR	+	|address
−	|Строка	+	|Строка
−	|Цвет автомобиля	+	|Домашний адрес
	|-		|-
−	|GOSNUMBER	+	|birthday
−	|Строка	+	|ГГГГММДДччммсс
−	|Государственный номер автомобиля	+	|Дата рождения
	|-		|-
−	|SOUND_MARK	+	|gender
−	|Строка	+	|Строка
−	|Запись с информацией о марке автомобиля	+	|Пол. Может принимать значения:
		+	• "male" -  мужской
		+
		+	• "female" - женский
	|-		|-
−	|CREW_GROUP_ID	+	|parent_id
−	|Целое	+	|Целое
−	|ИД группы экипажа	+	|ИД клиента-родителя
	|-		|-
−	|IS_PRIOR	+	|client_group_id
−	|true или false	+	|Целое
−	|Признак предварительного заказа	+	|ИД группы клиента
	|-		|-
−	|DISCOUNTEDSUMM	+	|email
−	|Строка	+	|Строка
−	|Сумма заказа с учетом всех скидок	+	|E-mail
	|-		|-
−	|DRIVER_PHONE	+	|use_email_informing
−	|Строка, <= 16 символов	+	|true или false
−	|Номер телефона водителя	+	|Использовать E-mail для отправки уведомлений по заказу
	|-		|-
−	|CATEGORYID	+	|comment
−	|Целое	+	|Строка
−	|ИД категории телефона	+	|Комментарий
	|-		|-
−	|SOURCE_TIMECOUNT	+	|use_own_account
−	|Целое	+	|true или false
−	|Время до подачи в минутах	+	|Использовать собственный счет для оплаты заказов
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
	|-		|-
−	|ORDER_COORDS	+	|100
−	|Строка	+	|Клиент с номером телефона=PHONE уже существует
−	|Координаты места подачи
	|-		|-
−	|CREW_COORDS	+	|101
−	|Строка	+	|Клиент с ИД=ID имеет такой же номер телефона=PHONE
−	|Координаты назначенного экипажа
	|-		|-
−	|ORDER_STATE	+	|102
−	|Целое	+	|Клиент с логином=LOGIN уже существует
−	|ИД состояния заказа
	|-		|-
−	|MARKET_TYPE	+	|103
−	|Целое	+	|Группа клиента с ИД=CLIENT_GROUP_ID не найдена
−	|Тип биржи заказов (2 — Яндекс, 3 — ЦОЗ).
	|-		|-
−	|AD_LIGHTHOUSE	+	|104
−	|Строка	+	|Клиент указанный в качестве родителя с ИД=PARENT_ID не найден
−	|Признак наличия шашек (1 – шашки есть, 0 – шашек нет).
	|-		|-
−	|CREW_STATE	+	|109
−	|Целое	+	|Пароль клиента не соответствует политике паролей
−	|Состояние экипажа.
	|}		|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет
	Пример:		Пример:
Строка 5236:		Строка 6752:
	Запрос:		Запрос:
−	GET https://ip:port/tm_tapi/1.0/get_info_by_order_id?order_id=60&fields=DRIVER_SOURCETIME-MARKCOLOR-	+	POST https://ip:port/common_api/1.0/update_client_info
−	GOSNUMBER-IS_PRIOR-MOBILE_PHONE-SOURCE_TIME&signature=fdcd04e570443b56176b83f44748dc23	+	Signature: <...>
−	HTTP/1.1	+	Content-Type: application/x-www-form-urlencoded
		+	Content-Length: <...>
		+
		+	client_id=140&name=NAME&phones=88,99&login=LOGIN&password=PASSWORD&birthday=20140901000000&gender=male&address=ADDRESS&parent_id=10&client_group_id=3&email=mail%40ya.ru&use_email_informing=true
	Ответ:		Ответ:
−	<response>	+	{
−	<code>0</code>	+	"code":0,
−	<descr>OK</descr>	+	"descr":"OK",
−	<data>	+	"data":{}
−	<DRIVER_SOURCETIME></DRIVER_SOURCETIME>	+	}
−	<MARK></MARK>	+	</pre>
−	<COLOR></COLOR>
−	<GOSNUMBER></GOSNUMBER>
−	<IS_PRIOR></IS_PRIOR>
−	<MOBILE_PHONE></MOBILE_PHONE>
−	<SOURCE_TIME></SOURCE_TIME>
−	</data>
−	</response>
−	</pre>
−	==== Смена состояния заказа ====	+	=== Изменение информации по клиенту 2 ===
	Метод: POST		Метод: POST
−	Название запроса: change_order_state	+	Название запроса: update_client_info2
		+
		+	Версия ТМ: 3.12
−	Параметры:	+	Параметры в формате JSON:
	{|		{|
−	!Параметр	+	!Параметры
−	!Тип	+	!Тип
	!Описание		!Описание
	|-		|-
	!colspan="3"|Обязательные параметры		!colspan="3"|Обязательные параметры
	|-		|-
−	|ORDER_ID	+	|client_id
−	|Целое	+	|Целое
−	|ИД заказа	+	|ИД клиента
		+	|-
		+	!colspan="3"|Необязательные параметры
	|-		|-
−	|NEED_STATE	+	|name
−	|Целое	+	|Строка, <= 60 символов
−	|Новое состояние заказа	+	|ФИО
	|-		|-
−	|signature	+	|login
−	|Строка	+	|Строка, <= 60 символов
−	|Поле для проверки секретного ключа	+	|Логин
−	|}
−
−	Специальные возвращаемые коды:
−
−	{|
−	!Код
−	!Описание
	|-		|-
−	|100	+	|password
−	|Заказ с таким ИД не найден	+	|Строка, <= 60 символов
		+	|Пароль
	|-		|-
−	|101	+	|phones
−	|Изменение состояния не соответствует необходимым условиям	+	|Массив
−	|}	+	|Массив телефонов клиента
−
−	Возвращаемые данные в случае успешного выполнения запроса:
−
−	{|
−	!Параметр
−	!Тип
−	!Описание
	|-		|-
−	|ORDER_ID	+	|&bull; phone
−	|Целое	+	|Строка
−	|ИД созданного заказа	+	|Номер телефона
	|-		|-
−	|NEW_STATE	+	|&bull; is_default
−	|Целое	+	|true или false
−	|Новое состояние заказа	+	|Признак основного телефона
−	|}
−
−	Пример:
−
−	<pre>
−	Запрос:
−
−	POST https://ip:port/tm_tapi/1.0/change_order_state HTTP/1.1
−	Content-Type: application/x-www-form-urlencoded
−	Content-Length: 71
−
−	order_id=18561&need_state=14&signature=3e8107e0c044e55d983db1fbed82fd8c
−
−	Ответ:
−
−	<response>
−	<code>0</code>
−	<descr>OK</descr>
−	<data>
−	<ORDER_ID>18561</ORDER_ID>
−	<NEW_STATE>14</NEW_STATE>
−	</data>
−	</response>
−	</pre>
−
−	==== Запись пути к файлу разговора в базу данных ====
−
−	Метод: POST
−
−	Название запроса: create_record_link
−
−	Параметры:
−
−	{|
−	!Параметр
−	!Тип
−	!Описание
	|-		|-
−	!colspan="3"|Обязательные параметры	+	|client_group_id
		+	|Целое
		+	|ИД группы клиента
	|-		|-
−	|RECORD_DATE	+	|parent_id
−	|ДДММГГГГччммсс	+	|Целое
−	|Дата записи	+	|ИД клиента-родителя
	|-		|-
−	|RECORD_LENGTH	+	|address
−	|Целое	+	|Строка
−	|Продолжительность записи (в секундах)	+	|Домашний адрес
		+	|-
		+	|birthday
		+	|ГГГГММДДччммсс
		+	|Дата рождения
		+	|-
		+	|gender
		+	|Строка
		+	|Пол. Может принимать значения:
		+	• "male" -  мужской
		+
		+	• "female" - женский
		+	|-
		+	|email
		+	|Строка
		+	|E-mail
		+	|-
		+	|use_email_informing
		+	|true или false
		+	|Использовать E-mail для отправки уведомлений по заказу
		+	|-
		+	|comment
		+	|Строка
		+	|Комментарий
		+	|-
		+	|use_own_account
		+	|true или false
		+	|Использовать собственный счет для оплаты заказов
	|-		|-
−	|CALL_ID	+	|attribute_values
−	|Строка, <= 60 символов	+	|Массив
−	|ИД звонка (необязателен, если указан PHONE)	+	|Массив значений атрибутов
	|-		|-
−	|PHONE	+	|&bull; id
−	|Строка, <= 16 символов	+	|Целое
−	|Номер телефона (необязателен, если указан CALL_ID)	+	|Идентификатор атрибута
	|-		|-
−	|FILE_PATH	+	|&bull; bool_value
−	|Строка, <=255 символов	+	|true или false
−	|Путь к файлу записи	+	|Значение, если тип атрибута «Логический»
	|-		|-
−	|CALL_TYPE	+	|&bull; num_value
−	|0 или 1	+	|Дробное
−	|0 — Исходящий, 1 — Входящий	+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
	|-		|-
−	|signature	+	|&bull; str_value
−	|Строка	+	|Строка
−	|Поле для проверки секретного ключа	+	|Значение, если тип атрибута «Строка»
	|}		|}
−	Специальные возвращаемые коды: нет.	+	Специальные возвращаемые коды:
−
−	Возвращаемые данные в случае успешного выполнения запроса
−
	{|		{|
−	!Параметр	+	!Код
−	!Тип
	!Описание		!Описание
	|-		|-
−	|RECORD_ID	+	|100
−	|Целое	+	|Клиент с ИД=CLIENT_ID не найден
−	|ИД созданной записи	+	|-
		+	|101
		+	|Дублирование номера телефона=PHONE в списке
		+	|-
		+	|102
		+	|Клиент с логином=LOGIN уже существует
		+	|-
		+	|103
		+	|Группа клиента с ИД=CLIENT_GROUP_ID не найдена
		+	|-
		+	|104
		+	|Клиент указанный в качестве родителя с ИД=PARENT_ID не найден
		+	|-
		+	|105
		+	|Основной телефон может быть только один
		+	|-
		+	|106
		+	|Клиент должен иметь основной телефон
		+	|-
		+	|107
		+	|Атрибут с ИД=ID не найден
		+	|-
		+	|108
		+	|Атрибут с ИД=ID не может быть привязан к клиенту
		+	|-
		+	|109
		+	|Пароль клиента не соответствует политике паролей
	|}		|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет
	Пример:		Пример:
Строка 5399:		Строка 6921:
	Запрос:		Запрос:
−	POST https://ip:port/tm_tapi/1.0/create_record_link HTTP/1.1	+	POST https://ip:port/common_api/1.0/update_client_info2 HTTP/1.1
−	Content-Type: application/x-www-form-urlencoded	+	Signature: <...>
−	Content-Length: 185	+	Content-Type: application/json
		+	Content-Length: <...>
−	RECORD_DATE=20130122180949&RECORD_LENGTH=215&CALL_ID=12345&PHONE=8987564&FILE_PATH=d%3A%5Ctemp%5CTM	+	{
−	%5Ctrunk%5CSource%5CDevUtils%5CTMAPITest%5C&CALL_TYPE=1&signature=56851c4e8d2d4bb9ba615615f76ad7f7	+	"client_id":140,
		+	"name":"NAME",
		+	"login":"LOGIN",
		+	"password":"PASSWORD",
		+	"phones":[
		+	{
		+	"phone":"88",
		+	"is_default":true
		+	}
		+	],
		+	"address":"ADDRESS",
		+	"gender":"male",
		+	"birthday":"20000101000000",
		+	"client_group_id":1,
		+	"parent_id":10,
		+	"email":"mail@ya.ru",
		+	"use_email_informing":true,
		+	"comment":"TEXT",
		+	"use_own_account":false,
		+	"attribute_values":[
		+	{
		+	"id":7,
		+	"num_value":5
		+	},
		+	{
		+	"id":9,
		+	"str_value":null
		+	}
		+	]
		+	}
	Ответ:		Ответ:
−	<response>	+
−	<code>0</code>	+	{
−	<descr>OK</descr>	+	"code":0,
−	<data>	+	"descr":"OK",
−	<RECORD_ID>25</RECORD_ID>	+	"data":{}
−	</data>	+	}
−	</response>	+
	</pre>		</pre>
−	==== Создать новый заказ ====	+	=== Запрос текущих заказов ===
−	Метод: POST	+	Метод: GET
−	Название запроса: make_new_order	+	Название запроса: get_current_orders
	Параметры:		Параметры:
	{|		{|
−	!Параметр	+	!Параметры
−	!Тип	+	!Тип
	!Описание		!Описание
	|-		|-
−	!colspan="3"|Обязательные параметры	+	!colspan="3"|Необязательные параметры
	|-		|-
−	|PHONE	+	|client_id
−	|Строка, <= 16 символов	+	|Целое
−	|Номер телефона	+	|ИД клиента
	|-		|-
−	|ORDER_STATE_ID	+	|client_employee_id
−	|Целое	+	|Целое
−	|ИД состояния заказа	+	|ИД сотрудника (только если указан ИД клиента)
	|-		|-
−	|signature	+	|phone
−	|Строка	+	|Строка, <= 30 символов
−	|Поле для проверки секретного ключа	+	|Телефон клиента
	|-		|-
−	!colspan="3"|Необязательные параметры	+	|crew_id
		+	|Целое
		+	|ИД экипажа
	|-		|-
−	|CREWGROUPID	+	|driver_id
−	|Целое	+	|Целое
−	|ИД группы экипажа	+	|ИД водителя
	|-		|-
−	|TARIF_ID	+	|fields
−	|Целое	+	|Строка
−	|ИД тарифа	+	|Список возвращаемых полей через запятую
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
	|-		|-
−	|DISCOUNTEDSUMM	+	|100
−	|Дробное	+	|Не найден клиент ИД=CLIENT_ID
−	|Фиксированная сумма за заказ
−	|-
−	|CUSTOMER
−	|Строка, <=80 символов
−	|Заказчик
	|-		|-
−	|SOURCE	+	|101
−	|Строка, <=80 символов	+	|Не найден сотрудник клиента ИД=CLIENT_EMPLOYEE_ID
−	|Адрес подачи	+	|}
−	|-	+
−	|SOURCE_STREET	+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|id
	|Целое		|Целое
−	|ИД улицы подачи	+	|ИД заказа
	|-		|-
−	|SOURCE_HOUSE	+	|state_id
−	|Строка, <=10 символов	+	|Целое
−	|Дом подачи	+	|ИД состояния заказа
	|-		|-
−	|SOURCE_FLAT	+	|state_kind
−	|Строка, <=10 символов	+	|Строка
−	|Квартира подачи	+	|Тип состояния заказа. Может принимать значения:
		+	* "new_order" — новый заказ
		+	* "driver_assigned" — водитель назначен
		+	* "car_at_place" — машина подъехала на место
		+	* "client_inside" — клиент в машине
		+	* "finished" — заказ успешно завершен
		+	* "aborted" — заказ прекращен
	|-		|-
−	|SOURCE_POINT	+	|crew_id
	|Целое		|Целое
−	|ИД пункта подачи	+	|ИД экипажа
	|-		|-
−	|DESTINATION	+	|prior_crew_id
−	|Строка, <=80 символов	+	|Целое
−	|Адрес назначения	+	|ИД предварительного экипажа
	|-		|-
−	|DESTINATION_STREET	+	|driver_id
	|Целое		|Целое
−	|ИД улицы назначения	+	|ИД водителя
	|-		|-
−	|DESTINATION_HOUSE	+	|car_id
−	|Строка, <=10 символов
−	|Дом назначения
−	|-
−	|DESTINATION_FLAT
−	|Строка, <=10 символов
−	|Квартира назначения
−	|-
−	|DESTINATION_POINT
	|Целое		|Целое
−	|ИД пункта назначения	+	|ИД автомобиля
	|-		|-
−	|CREWID	+	|server_time_offset
	|Целое		|Целое
−	|ИД экипажа	+	|Смещение относительно серверного времени
	|-		|-
−	|SUMM	+	|start_time
−	|Дробное	+	|ГГГГММДДччммсс
−	|Стоимость заказа без учета скидок (наценок)	+	|Дата создания заказа
	|-		|-
−	|STARTUSER	+	|source_time
−	|Целое
−	|Пользователь, создавший заказ
−	|-
−	|STARTTIME
	|ГГГГММДДччммсс		|ГГГГММДДччммсс
−	|Дата создания заказа	+	|Время подачи
	|-		|-
−	|FINISHUSER	+	|source
−	|Целое	+	|Строка
−	|Пользователь, завершивший заказ	+	|Адрес подачи
	|-		|-
−	|FINISHTIME	+	|source_lat
−	|ГГГГММДДччммсс	+	|Строка
−	|Дата завершения заказа	+	|Широта адреса подачи
	|-		|-
−	|SOURCE_ZONE	+	|source_lon
−	|Целое	+	|Строка
−	|Район подачи	+	|Долгота адреса подачи
	|-		|-
−	|DESTINATION_ZONE	+	|destination
−	|Целое	+	|Строка
−	|Район назначения	+	|Адрес назначения
	|-		|-
−	|SOURCE_PARKING	+	|destination_lat
−	|Целое	+	|Строка
−	|Стоянка подачи	+	|Широта адреса назначения
	|-		|-
−	|DESTINATION_PARKING	+	|destination_lon
−	|Целое	+	|Строка
−	|Стоянка назначения	+	|Долгота адреса назначения
	|-		|-
−	|SOURCE_TIME	+	|stops
−	|ГГГГММДДччммсс	+	|Массив
−	|Дата подачи	+	|Информация по остановкам заказа
	|-		|-
−	|SOURCE_COUNTRY	+	|• address
−	|0 или 1 (false или true)	+	|Строка
−	|Признак междугороднего заказа	+	|Адрес остановки
	|-		|-
−	|IS_PRIOR	+	|• lat
−	|0 или 1 (false или true)	+	|Дробное
−	|Признак предварительного заказа	+	|Широта адреса остановки
	|-		|-
−	|PRIZE	+	|• lon
−	|0 или 1 (false или true)	+	|Дробное
−	|Признак призового заказа	+	|Долгота адреса остановки
		+	|-
		+	|customer
		+	|Строка
		+	|Заказчик
	|-		|-
−	|NOTE	+	|passenger
−	|Строка, <=80 символов	+	|Строка
−	|Примечание	+	|Пассажир
	|-		|-
−	|BONUSPOINT	+	|phone
−	|Дробное	+	|Строка
−	|Бонусные баллы, начисленные водителю за заказ	+	|Номер телефона
	|-		|-
−	|DISTANCE	+	|phone_to_dial
−	|Дробное	+	|Строка
−	|Километраж по городу (в километрах)	+	|Номер телефона для отзвона
	|-		|-
−	|HOURLY_LEN	+	|client_id
	|Целое		|Целое
−	|Длительность исполнения почасового заказа (в минутах)	+	|ИД клиента
	|-		|-
−	|HOURLY_START	+	|client_name
−	|ГГГГММДДччммсс	+	|Строка
−	|Дата начала отсчета при почасовом заказе	+	|Имя клиента
	|-		|-
−	|HOURLY_PAY	+	|client_group_id
−	|0 или 1 (false или true)	+	|Целое
−	|Признак почасового заказа	+	|ИД группы клиента
	|-		|-
−	|PHONE_TO_DIAL	+	|client_group_name
−	|Строка, <=16 символов	+	|Строка
−	|Номер телефона для отзвона по заказу	+	|Название группы клиента
	|-		|-
−	|FROMBORDER	+	|client_employee_id
−	|0 или 1 (false или true)	+	|Целое
−	|Признак заказа "с бордюра"	+	|ИД сотрудника клиента
	|-		|-
−	|WAITING_START	+	|order_crew_group_id
−	|ГГГГММДДччммсс
−	|Дата начала ожидания заказчика водителем
−	|-
−	|WAITING_LENGTH
	|Целое		|Целое
−	|Общая длина периода ожидания заказчика водителем (в минутах)	+	|ИД группы экипажей, которая указана в заказе
	|-		|-
−	|BACKFREE	+	|tariff_id
	|Целое		|Целое
−	|Признак применения скидки в 50% на обратный путь	+	|ИД тарифа
	|-		|-
−	|INPUTTIME	+	|car_mark
−	|ГГГГММДДччммсс	+	|Строка
−	|Дата принятия заказа (от даты создания заказа отличается тем, что может быть задана пользователем)	+	|Марка автомобиля
		+	|-
		+	|car_model
		+	|Строка
		+	|Модель автомобиля
		+	|-
		+	|car_color
		+	|Строка
		+	|Цвет автомобиля
	|-		|-
−	|MONEY_RECEIVE	+	|car_number
−	|0 или 1 (false или true)	+	|Строка
−	|Подтверждение принятия денег наличными	+	|Гос.номер автомобиля
	|-		|-
−	|NOTIFY_BEFORE	+	|confirmed
−	|Целое	+	|Строка
−	|Период времени, за который пользователь оповещается о наступлении даты подачи	+	|Состояние подтвержденности заказа водителем или оператором. Может принимать значения:
		+
		+	* "not_confirmed" — не подтверждено
		+	* "confirmed_by_driver" — заказ принят водителем
		+	* "confirmed_by_oper" — заказ подтвержден оператором
	|-		|-
−	|WANTCREWID	+	|crew_coords
−	|Целое	+	|Массив
−	|ИД желаемого экипажа	+	|Координаты экипажа
	|-		|-
−	|DISTANCE_COUNTRY	+	|• lat
	|Дробное		|Дробное
−	|Километраж за границами города (в километрах)	+	|Широта
	|-		|-
−	|DISTANCE_CHECK	+	|• lon
−	|0 или 1 (false или true)	+	|Дробное
−	|Разрешение ручного ввода километража	+	|Долгота
	|-		|-
−	|CLIENTID	+	|order_params
−	|Целое	+	|Массив
−	|ИД постоянного клиента	+	|Массив параметров заказа экипажа. Устарело. Рекомендуется использовать параметр attribute_values. (Возвращается только если в списке фильтра полей fields запросили поле order_params)
	|-		|-
−	|INFRA_STATE	+	|•
	|Целое		|Целое
−	|Состояние заявки в исходящей кампании колцентра INFRA (1 - заявка передана в исходящую компанию, 2 - отзвон успешно произведен, 3 - занято, 4 - не берут трубку)	+	|ИД параметра заказа
	|-		|-
−	|INFRA_ORDER	+	|creation_way
−	|Целое	+	|Строка
−	|INFRA-заказ (спец. поле для работы с колцентром компании Инфрател)	+	|Способ создания заказа. Может принимать значения:
−	|}	+
		+	• "operator" — заказ создан оператором
		+
		+	• "sms" — заказ создан через смс
−	Специальные возвращаемые коды: нет	+	• "market" — заказ из биржи
−	Возвращаемые данные в случае успешного выполнения запроса	+	• "common_api" — заказ создан через api
−	{|	+	• "t_api" — заказ создан через api
−	!Параметр
−	!Тип
−	!Описание
−	|-
−	|ORDER_ID
−	|Целое
−	|ИД созданного заказа
−	|}
−
−	Пример:
−
−	<pre>
−	Запрос:
−
−	POST https://ip:port/tm_tapi/1.0/make_new_order HTTP/1.1
−	Content-Type: application/x-www-form-urlencoded
−	Content-Length: 206
−
−	PHONE=89058770593&ORDER_STATE_ID=10&DISCOUNTED_SUMM=100&signature=afc947f610eba380df6d0e441b03ddad
−	Ответ:	+	• "taxophone" —  заказ создан через таксофон с телефона
−
−	<response>
−	<code>0</code>
−	<descr>OK</descr>
−	<data>
−	<order_id>27</order_id>
−	</data>
−	</response>
−	</pre>
−	==== Поиск улицы в базе ====	+	• "driver" — заказ создан водителем
−	Метод: POST
−	Название запроса: street_search	+	• "daily_order" — ежедневный заказ
−	Параметры:	+	• "taxophone_web" — заказ создан через таксофон с сайта
−	{|	+	• "unknown" — неизвестный
−	!Параметр
−	!Тип
−	!Описание
	|-		|-
−	!colspan="3"|Обязательные параметры	+	|is_prior
		+	|true или false
		+	|Предварительный заказ
	|-		|-
−	|PHONE	+	|is_really_prior
−	|Строка, <= 16 символов	+	|true или false
−	|Номер телефона	+	|Предварительный заказ на вкладке "Предварительные"
	|-		|-
−	|CALL_ID	+	|email
−	|Целое	+	|Строка
−	|ИД звонка	+	|Email для уведомлений
	|-		|-
−	|VOICE_STREET	+	|prior_to_current_before_minutes
−	|Строка, <= 60 символов	+	|Целое
−	|Название улицы или пункта, полученное через преобразование голоса в текст	+	|Время перехода из предварительного в текущие заказы, мин
	|-		|-
−	|signature	+	|flight_number
	|Строка		|Строка
−	|Поле для проверки секретного ключа	+	|Номер рейса
−	|}	+	|-
−		+	|sum
−	Специальные возвращаемые коды: нет	+	|Дробное
−		+	|Сумма без скидки
−	Возвращаемые данные в случае успешного выполнения запроса:	+	|-
−		+	|total_sum
−	{|	+	|Дробное
−	!Параметр	+	|Итоговая сумма заказа
−	!Тип	+	|-
−	!Описание	+	|cash_sum
		+	|Дробное
		+	|Сумма наличными
		+	|-
		+	|cashless_sum
		+	|Дробное
		+	|Сумма безналичными
		+	|-
		+	|bonus_sum
		+	|Дробное
		+	|Сумма бонусами
		+	|-
		+	|bank_card_sum
		+	|Дробное
		+	|Сумма банковской картой
		+	|-
		+	|attribute_values
		+	|Массив
		+	|Массив значений атрибутов
		+	|-
		+	|• id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|• bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|• num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|• str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
		+	|-
		+	|bill
		+	|Массив
		+	|Чек TMDriver. Данный узел выводится только, если по заказу есть чек и если в списке фильтра полей fields запросили поле bill
		+	|-
		+	|• code
		+	|Строка
		+	|Код элемента расчета
		+	|-
		+	|• text
		+	|Строка
		+	|Наименование элемента расчета
	|-		|-
−	|CALL_ID	+	|• value
−	|Целое	+	|Строка
−	|ИД звонка	+	|Значение элемента расчета (количество)
	|-		|-
−	|PHONE	+	|• sum
−	|Строка, <= 16 символов	+	|Строка
−	|Номер телефона	+	|Стоимость элемента расчета
	|-		|-
−	|STREET_FOUND	+	|is_auction
−	|0 или 1 (false или true)	+	|true или false
−	|Признак того, что улица найдена	+	|Признак заказа-аукциона
	|-		|-
−	|STREET_NAME	+	|payment_pay_system
−	|Строка, <= 60 символов	+	|Строка
−	|Наименование улицы или пункта, найденное в базе данных	+	|Тип платежной системы ("card", "gpay", "apple_pay", "qr", "sber_pay", либо пусто, если не используется)
	|}		|}
−
	Пример:		Пример:
Строка 5736:		Строка 7325:
	<pre>		<pre>
	Запрос:		Запрос:
−	POST https://ip:port/tm_tapi/1.0/new_order_by_voice HTTP/1.1
−	Content-Type: application/x-www-form-urlencoded
−	Content-Length: 175
−	PHONE=89058770593&CALL_ID=56&VOICE_STREET=пушкинск&FIND_STREET=0&API_FIND_STREET=&NUM_HOUSE=&signat	+	GET https://ip:port/common_api/1.0/get_current_orders?client_id=140&phone=18
−	ure=9204a53e0f4842bb623c3a5f7683520a	+	Signature: <...>
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"order_id":1,
		+	"state_id":12,
		+	"state_kind":"car_at_place",
		+	"crew_id":1,
		+	"prior_crew_id":0,
		+	"driver_id":2,
		+	"car_id":3,
		+	"server_time_offset:0,
		+	"start_time":"20130117125641",
		+	"source_time":"20130117132617",
		+	"source":"30 Лет Победы ул. \/Ижевск\/, 4Б",
		+	"source_lat":56.863613,
		+	"source_lon":53.186539,
		+	"destination":"Кирова ул. \/Ижевск\/, 56",
		+	"destination_lat":56.862202,
		+	"destination_lon":53.187485,
		+	"stops":[
		+	{
		+	"address":"30 Лет Победы ул. \/Ижевск\/, 8",
		+	"lat":56.863388,
		+	"lon":53.184269
		+	}
		+	],
		+	"customer":"Слепаков",
		+	"passenger":"Слепаков",
		+	"phone":"8800",
		+	"client_id":1,
		+	"client_employee_id":1,
		+	"order_crew_group_id":1,
		+	"tariff_id":1,
		+	"car_mark":"Ауди",
		+	"car_model":"Q7",
		+	"car_color":"черный",
		+	"car_number":"А777АА",
		+	"confirmed":"confirmed_by_oper",
		+	"crew_coords": {
		+	"lat": 56.833981,
		+	"lon": 53.220249
		+	},
		+	"order_params":[
		+	1,
		+	2,
		+	5
		+	],
		+	"creation_way":"operator",
		+	"is_prior":true,
		+	"is_really_prior":false,
		+	"email":"mail@mail.ru",
		+	"prior_to_current_before_minutes":30,
		+	"flight_number":"A-0501/123",
		+	"sum":50.5,
		+	"total_sum":80,
		+	"cash_sum":20.1,
		+	"cashless_sum":10,
		+	"bonus_sum":5.2,
		+	"bank_card_sum":15,
		+	"attribute_values": [
		+	{
		+	"id": 1,
		+	"bool_value": true
		+	},
		+	{
		+	"id": 2,
		+	"num_value": 1
		+	},
		+	{
		+	"id": 3,
		+	"num_value": 10
		+	},
		+	{
		+	"id": 4,
		+	"str_value": "строка"
		+	}
		+	],
		+	"bill":
		+	[
		+	{
		+	"code":"BOARDING",
		+	"text":"Посадка",
		+	"value":"",
		+	"sum":"20,00"
		+	},
		+	{
		+	"code":"TRIP_TIME",
		+	"text":"Общее время",
		+	"value":"0:00:00",
		+	"sum":""
		+	},
		+	{
		+	"code":"TRIP_DIST",
		+	"text":"Общее расстояние",
		+	"value":"0,00 км",
		+	"sum":""
		+	},
		+	{
		+	"code":"BEFORE_DISC",
		+	"text":"Сумма без скидки",
		+	"value":"",
		+	"sum":"20,00"
		+	},
		+	{
		+	"code":"AFTER_DISC",
		+	"text":"Сумма со скидкой",
		+	"value":"",
		+	"sum":"20,00"
		+	},
		+	{
		+	"code":"MINIMUM",
		+	"text":"Минималка",
		+	"value":"",
		+	"sum":"60,00"
		+	}
		+	]
		+	"is_auction":false,
		+	"payment_pay_system":"qr"
		+	}
		+	}
		+	</pre>
		+
		+	=== Запрос выполненных заказов ===
		+
		+	Метод: GET
		+
		+	Название запроса: get_finished_orders
		+
		+	Параметры:
		+
		+	{|
		+	!Параметры
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|start_time
		+	|ГГГГММДДччммсс
		+	|Начало периода
		+	|-
		+	|finish_time
		+	|ГГГГММДДччммсс
		+	|Конец периода
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	!colspan="3"| '''Примечание''': должен присутствовать хотя бы один параметр из client_id, phone, crew_id, driver_id.
		+	|-
		+	|client_id
		+	|Целое
		+	|ИД клиента
		+	|-
		+	|client_employee_id
		+	|Целое
		+	|ИД сотрудника (только если указан ИД клиента)
		+	|-
		+	|phone
		+	|Строка, <= 30 символов
		+	|Телефон клиента
		+	|-
		+	|crew_id
		+	|Целое
		+	|ИД экипажа
		+	|-
		+	|driver_id
		+	|Целое
		+	|ИД водителя
		+	|-
		+	|state_type
		+	|Строка
		+	|Тип состояния заказа. Может принимать значения:
		+
		+	• "all" — все
		+
		+	• "finished" — выполненные
		+
		+	• "aborted" — прекращенные
		+	|-
		+	|state_ids
		+	|Строка
		+	|Список состояний заказа через точку с запятой, пример: «1;2;3»
		+	|-
		+	|fields
		+	|Строка
		+	|Список возвращаемых полей через запятую
		+	|}
		+
		+	'''Примечание''': должен присутствовать хотя бы один параметр из client_id, phone, crew_id, driver_id.
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|id
		+	|Целое
		+	|ИД заказа
		+	|-
		+	|state_id
		+	|Целое
		+	|ИД состояния заказа
		+	|-
		+	|crew_id
		+	|Целое
		+	|ИД экипажа
		+	|-
		+	|prior_crew_id
		+	|Целое
		+	|ИД предварительного экипажа
		+	|-
		+	|driver_id
		+	|Целое
		+	|ИД водителя
		+	|-
		+	|car_id
		+	|Целое
		+	|ИД автомобиля
		+	|-
		+	|server_time_offset
		+	|Целое
		+	|Смещение относительно серверного времени
		+	|-
		+	|start_time
		+	|ГГГГММДДччммсс
		+	|Время создания заказа
		+	|-
		+	|source_time
		+	|ГГГГММДДччммсс
		+	|Время подачи
		+	|-
		+	|finish_time
		+	|ГГГГММДДччммсс
		+	|Время завершения заказа
		+	|-
		+	|source
		+	|Строка
		+	|Адрес подачи
		+	|-
		+	|source_lat
		+	|Дробное
		+	|Широта адреса подачи
		+	|-
		+	|source_lon
		+	|Дробное
		+	|Долгота адреса подачи
		+	|-
		+	|destination
		+	|Строка
		+	|Адрес назначения
		+	|-
		+	|destination_lat
		+	|Дробное
		+	|Широта адреса назначения
		+	|-
		+	|destination_lon
		+	|Дробное
		+	|Долгота адреса назначения
		+	|-
		+	|stops
		+	|Массив
		+	|Массив адресов остановок
		+	|-
		+	|&bull; address
		+	|Строка
		+	|Адрес остановки
		+	|-
		+	|&bull; lat
		+	|Дробное
		+	|Широта адреса остановки
		+	|-
		+	|&bull; lon
		+	|Дробное
		+	|Долгота адреса остановки
		+	|-
		+	|trip_distance
		+	|Дробное
		+	|Фактический километраж
		+	|-
		+	|trip_time
		+	|Целое
		+	|Фактическое время в пути
		+	|-
		+	|customer
		+	|Строка
		+	|Заказчик
		+	|-
		+	|passenger
		+	|Строка
		+	|Пассажир
		+	|-
		+	|phone
		+	|Строка
		+	|Номер телефона
		+	|-
		+	|phone_to_dial
		+	|Строка
		+	|Номер телефона для отзвона
		+	|-
		+	|client_id
		+	|Целое
		+	|ИД клиента
		+	|-
		+	|client_name
		+	|Строка
		+	|Имя клиента
		+	|-
		+	|client_group_id
		+	|Целое
		+	|ИД группы клиента
		+	|-
		+	|client_group_name
		+	|Строка
		+	|Название группы клиента
		+	|-
		+	|client_employee_id
		+	|Целое
		+	|ИД сотрудника клиента
		+	|-
		+	|order_crew_group_id
		+	|Целое
		+	|ИД группы экипажей, которая указана в заказе
		+	|-
		+	|tariff_id
		+	|Целое
		+	|ИД тарифа
		+	|-
		+	|car_mark
		+	|Строка
		+	|Марка автомобиля
		+	|-
		+	|car_model
		+	|Строка
		+	|Модель автомобиля
		+	|-
		+	|car_color
		+	|Строка
		+	|Цвет автомобиля
		+	|-
		+	|car_number
		+	|Строка
		+	|Гос.номер автомобиля
		+	|-
		+	|order_params
		+	|Массив
		+	|Массив параметров заказа экипажа. Устарело. Рекомендуется использовать параметр attribute_values. (Возвращается только если в списке фильтра полей fields запросили поле order_params)
		+	|-
		+	|•
		+	|Целое
		+	|ИД параметра заказа
		+	|-
		+	|creation_way
		+	|Строка
		+	|Способ создания заказа. Может принимать значения:
		+
		+	• "operator" — заказ создан оператором
		+
		+	• "sms" — заказ создан через смс
		+
		+	• "market" — заказ из биржи
		+
		+	• "common_api" — заказ создан через api
		+
		+	• "t_api" — заказ создан через api
		+
		+	• "taxophone" —  заказ создан через таксофон с телефона
		+
		+	• "driver" — заказ создан водителем
		+
		+	• "daily_order" — ежедневный заказ
		+
		+	• "taxophone_web" — заказ создан через таксофон с сайта
		+
		+	• "unknown" — неизвестный
		+	|-
		+	|is_prior
		+	|true или false
		+	|Предварительный заказ
		+	|-
		+	|email
		+	|Строка
		+	|Email для уведомлений
		+	|-
		+	|flight_number
		+	|Строка
		+	|Номер рейса
		+	|-
		+	|sum
		+	|Дробное
		+	|Стоимость заказа без учета скидок (наценок)
		+	|-
		+	|total_sum
		+	|Дробное
		+	|Итоговая стоимость заказа
		+	|-
		+	|cash_sum
		+	|Дробное
		+	|Заплачено наличными
		+	|-
		+	|cashless_sum
		+	|Дробное
		+	|Заплачено с безналичного счета клиента
		+	|-
		+	|bonus_sum
		+	|Дробное
		+	|Заплачено с бонусного счета клиента
		+	|-
		+	|bank_card_sum
		+	|Дробное
		+	|Заплачено банковской картой
		+	|-
		+	|attribute_values
		+	|Массив
		+	|Массив значений атрибутов
		+	|-
		+	|• id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|• bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|• num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|• str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
		+	|-
		+	|bill
		+	|Массив
		+	|Чек TMDriver. Данный узел выводится только, если по заказу есть чек и если в списке фильтра полей fields запросили поле bill
		+	|-
		+	|• code
		+	|Строка
		+	|Код элемента расчета
		+	|-
		+	|• text
		+	|Строка
		+	|Наименование элемента расчета
		+	|-
		+	|• value
		+	|Строка
		+	|Значение элемента расчета (количество)
		+	|-
		+	|• sum
		+	|Строка
		+	|Стоимость элемента расчета
		+	|-
		+	|is_auction
		+	|true или false
		+	|Признак заказа-аукциона
		+	|-
		+	|payment_pay_system
		+	|Строка
		+	|Тип платежной системы ("card", "gpay", "apple_pay", "qr", "sber_pay", либо пусто, если не используется)
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	GET https://ip:port/common_api/1.0/get_finished_orders?start_time=20220405142210&finish_time=20220405142710&fields=state_id,crew_id,prior_crew_id,driver_id,car_id,server_time_offset,start_time,source_time,finish_time,source,source_lat,source_lon,destination,destination_lat,destination_lon,stops,trip_distance,trip_time,customer,passenger,phone,phone_to_dial,client_id,client_name,client_group_id,client_group_name,client_employee_id,order_crew_group_id,tariff_id,order_params,attribute_values,creation_way,is_prior,email,flight_number,sum,total_sum,cash_sum,cashless_sum,bonus_sum,bank_card_sum,car_mark,car_model,car_color,car_number,bill
	Ответ:		Ответ:
−		+	{
−	<response>	+	"code":0,
−	<code>0</code>	+	"descr":"OK",
−	<descr>OK</descr>	+	"data":
−	<data>	+	{
−	<CALL_ID>56</CALL_ID>	+	"orders":
−	<PHONE>89058770593</PHONE>	+	[
−	<FIND_STREET>1</FIND_STREET>	+	{
−	<API_FIND_STREET>Пушкинская</API_FIND_STREET>	+	"id":47834,
−	</data>	+	"state_id":4,
−	</response>	+	"crew_id":17,
−	</pre>	+	"prior_crew_id":0,
−		+	"driver_id":17,
−	==== Смена состояния заказа по результату автодозвона ====	+	"car_id":16,
−	Метод: POST	+	"server_time_offset":0,
−		+	"start_time":"20220405142418",
−	Название запроса: set_request_state	+	"source_time":"20220405142418",
−		+	"finish_time":"20220405142708",
−	Параметры:	+	"source":"5-Я ЯМСКОГО ПОЛЯ УЛ., 37",
−		+	"source_lat":56.853062,
−	{|	+	"source_lon":53.20715,
−	!Параметр	+	"destination":"ХОДЫНСКАЯ УЛ., 10А",
−	!Тип	+	"destination_lat":0,
−	!Описание	+	"destination_lon":0,
		+	"stops":
		+	[],
		+	"trip_distance":10,
		+	"trip_time":3600,
		+	"customer":"Client 89872977005",
		+	"passenger":"",
		+	"phone":"89872977005",
		+	"phone_to_dial":"",
		+	"client_id":43111,
		+	"client_name":"Client 89872977005",
		+	"client_group_id":2,
		+	"client_group_name":"Физические",
		+	"client_employee_id":0,
		+	"order_crew_group_id":0,
		+	"tariff_id":2,
		+	"order_params":
		+	[
		+	28,
		+	29,
		+	30,
		+	55,
		+	58,
		+	59,
		+	62
		+	],
		+	"attribute_values":
		+	[
		+	{
		+	"id":28,
		+	"num_value":0
		+	},
		+	{
		+	"id":29,
		+	"num_value":0
		+	},
		+	{
		+	"id":30,
		+	"num_value":0
		+	},
		+	{
		+	"id":55,
		+	"num_value":1
		+	},
		+	{
		+	"id":58,
		+	"num_value":0
		+	},
		+	{
		+	"id":59,
		+	"num_value":0
		+	},
		+	{
		+	"id":62,
		+	"num_value":0
		+	}
		+	],
		+	"creation_way":"operator",
		+	"is_prior":false,
		+	"email":"",
		+	"flight_number":"",
		+	"sum":100,
		+	"total_sum":100,
		+	"cash_sum":50,
		+	"cashless_sum":40,
		+	"bonus_sum":10,
		+	"bank_card_sum":0,
		+	"car_mark":"Баф",
		+	"car_model":"Fenix 3346",
		+	"car_color":"белая",
		+	"car_number":"а111аа",
		+	"is_auction":false,
		+	"payment_pay_system": "qr"
		+	}
		+	]
		+	}
		+	}
		+	</pre>
		+
		+	=== Проведение операции по клиенту ===
		+
		+	Метод: POST
		+
		+	Название запроса: create_client_operation
		+
		+	Параметры:
		+
		+	{|
		+	!Параметры
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|client_id
		+	|Целое
		+	|ИД клиента
		+	|-
		+	|sum
		+	|Дробное
		+	|Сумма
		+	|-
		+	|oper_type
		+	|Целое
		+	|Тип операции:
		+	• "receipt" - приход
		+
		+	• "expense" - расход
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|oper_time
		+	|ГГГГММДДччммсс
		+	|Время создания операции (если не указано, текущее)
		+	|-
		+	|comment
		+	|Строка
		+	|Комментарий
		+	|-
		+	|pay_type
		+	|Целое
		+	|Тип оплаты:
		+	• "cash" - наличный
		+
		+	• "nocash" - безналичный
		+	|-
		+	|bonus_oper
		+	|true или false
		+	|Операция по бонусному счёту. Данный параметр устарел - рекомендуется использовать "account_kind"
		+	|-
		+	|account_kind
		+	|Целое
		+	|Тип счета:
		+	* 0 - Основной счет
		+	* 1- Бонусный счет
		+	* Остальные - нестандартные счета
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Не найден клиент ИД=CLIENT_ID
		+	|-
		+	|101
		+	|Не найден тип счета ИД=ACCOUNT_KIND
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|oper_id
		+	|Целое
		+	|ИД операции
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/common_api/1.0/create_client_operation
		+	Signature: <...>
		+	Content-Type: application/x-www-form-urlencoded
		+	Content-Length: <...>
		+
		+	client_id=112&oper_time=20130221100719&oper_sum=300&oper_type=receipt&pay_type=cash&comment=COMMENT&account_kind=0
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"oper_id":31
		+
		+	}
		+	}
		+	</pre>
		+
		+	=== Запрос операций по клиенту ===
		+
		+	Метод: GET
		+
		+	Название запроса: get_client_operations
		+
		+	Параметры:
		+
		+	{|
		+	!Параметры
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|client_id
		+	|Целое
		+	|ИД клиента
		+	|-
		+	|start_time
		+	|ГГГГММДДччммсс
		+	|Начало периода
		+	|-
		+	|finish_time
		+	|ГГГГММДДччммсс
		+	|Конец периода
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|account_kind
		+	|Целое
		+	|Тип счета:
		+	* 0 - Основной счет
		+	* 1- Бонусный счет
		+	* Остальные - нестандартные счета
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Не найден клиент ИД=CLIENT_ID
		+	|-
		+	|101
		+	|Не найден тип счета ИД=ACCOUNT_KIND
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|oper_id
		+	|Целое
		+	|ИД операции
		+	|-
		+	|oper_time
		+	|ГГГГММДДччммсс
		+	|Время создания операции
		+	|-
		+	|sum
		+	|Дробное
		+	|Сумма
		+	|-
		+	|order_id
		+	|Целое
		+	|Заказ, связанный с операцией
		+	|-
		+	|oper_type
		+	|Целое
		+	|Тип операции:
		+	• "receipt" - приход
		+
		+	• "expense" - расход
		+	|-
		+	|pay_type
		+	|Целое
		+	|Тип оплаты:
		+	• "cash" - наличный
		+
		+	• "nocash" - безналичный
		+	|-
		+	|account_kind
		+	|Целое
		+	|Тип счета:
		+	* 0 - Основной счет
		+	* 1- Бонусный счет
		+	* Остальные - нестандартные счета
		+	|-
		+	|name
		+	|Строка
		+	|Наименование
		+	|-
		+	|comment
		+	|Строка
		+	|Комментарий
		+	|-
		+	|cancelled_by_oper_id
		+	|Целое
		+	|ИД операции отмены (для отмененной операции)
		+	|-
		+	|cancelled_oper_id
		+	|Целое
		+	|ИД отмененной операции (для операции отмены)
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	GET https://ip:port/common_api/1.0/get_client_operations?client_id=112&start_time=20130201092112&finish_time=20130221092112&account_kind=0 HTTP/1.1
		+	Signature: <...>
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"operations":[
		+	{
		+	"oper_id":111,
		+	"oper_time":"20130219091328",
		+	"sum":"21,8",
		+	"order_id":11800,
		+	"oper_type":"receipt",
		+	"pay_type":"cash",
		+	"account_kind":0,
		+	"name":"Пополнение счета",
		+	"comment":"Комментарий",
		+	"cancelled_by_oper_id":0,
		+	"cancelled_oper_id":112
		+	},
		+	{
		+	"oper_id":112,
		+	"oper_time":"20130220112245",
		+	"sum":"4500",
		+	"order_id":11801,
		+	"oper_type":"receipt",
		+	"pay_type":"cash",
		+	"account_kind":0,
		+	"name":"Пополнение счета",
		+	"comment":"Комментарий"
		+	"cancelled_by_oper_id":111,
		+	"cancelled_oper_id":0
		+	}
		+	]
		+	}
		+	}
		+	</pre>
		+
		+	=== Проведение операции по водителю ===
		+
		+	Метод: POST
		+
		+	Название запроса: create_driver_operation
		+
		+	Параметры  в формате JSON:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|driver_id
		+	|Целое
		+	|ИД водителя
		+	|-
		+	|oper_sum
		+	|Дробное
		+	|Сумма
		+	|-
		+	|oper_type
		+	|Строка
		+	|Тип операции:
		+
		+	• receipt - приход
		+
		+	• expense - расход
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|name
		+	|Строка
		+	|Наименование операции
		+	|-
		+	|oper_time
		+	|ГГГГММДДччммсс
		+	|Время создания операции (если не задано, текущее)  !! Не используется с ТМ 3.7
		+	|-
		+	|comment
		+	|Строка
		+	|Комментарий
		+	|-
		+	|account_kind
		+	|Целое
		+	|ИД типа счета (0 - основной счет), по умолчанию 0
		+	|}
		+
		+	Специальные возвращаемые коды:
		+
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Водитель не найден ИД=DRIVER_ID
		+	|-
		+	|101
		+	|Не найден тип счета ИД=ACCOUNT_KIND
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|oper_id
		+	|Целое
		+	|ИД операции
		+	|}
		+
		+
		+	Пример:
		+
		+	<pre>
		+
		+	Запрос:
		+
		+	POST https://ip:port/common_api/1.0/create_driver_operation
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: 99
		+
		+	{
		+	"driver_id": 1,
		+	"oper_sum": 10.00,
		+	"oper_type": "receipt",
		+	"name": "Пополнение счета",
		+	"oper_time": "20141210100719",
		+	"comment": "Комментарий к операции"
		+	"account_kind": 1
		+	}
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"oper_id":31
		+	}
		+	}
		+
		+	</pre>
		+
		+	=== Запрос операций по водителю ===
		+
		+	Метод: GET
		+
		+	Название запроса: get_driver_operations
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|driver_id
		+	|Целое
		+	|ИД водителя
		+	|-
		+	|start_time
		+	|ГГГГММДДччммсс
		+	|Начало периода
		+	|-
		+	|finish_time
		+	|ГГГГММДДччммсс
		+	|Конец периода
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|account_kind
		+	|Целое
		+	|ИД типа счета (0 - основной счет), по умолчанию 0
		+	|}
		+
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Не найден водитель ИД=DRIVER_ID
		+	|-
		+	|101
		+	|Не найден тип счета ИД=ACCOUNT_KIND
		+	|}
		+
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|oper_id
		+	|Целое
		+	|ИД операции
		+	|-
		+	|oper_time
		+	|ГГГГММДДччммсс
		+	|Время создания операции
		+	|-
		+	|sum
		+	|Дробное
		+	|Сумма
		+	|-
		+	|order_id
		+	|Целое
		+	|Заказ, связанный с операцией
		+	|-
		+	|oper_type
		+	|Целое
		+	|Тип операции:
		+
		+	•"receipt" - приход
		+
		+	•"expense" - расход
		+	|-
		+	|name
		+	|Строка
		+	|Наименование
		+	|-
		+	|comment
		+	|Строка
		+	|Комментарий
		+	|-
		+	|account_kind
		+	|Целое
		+	| ИД типа счета
		+	|-
		+	|cancelled_by_oper_id
		+	|Целое
		+	|ИД операции отмены (для отмененной операции)
		+	|-
		+	|cancelled_oper_id
		+	|Целое
		+	|ИД отмененной операции (для операции отмены)
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	GET https://ip:port/common_api/1.0/get_driver_operations?
		+	driver_id=112&start_time=20130201092112&finish_time=20130221092112
		+	Signature: <...>
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"operations":[
		+	{
		+	"oper_id":111,
		+	"oper_time":"20130219091328",
		+	"sum":"21,8",
		+	"order_id":11800,
		+	"oper_type":"receipt",
		+	"name":"DRIVER_OPERATION_1",
		+	"comment":"DRIVER_OPERATION_COMMENT_1",
		+	"account_kind":0,
		+	"cancelled_by_oper_id":0,
		+	"cancelled_oper_id":112
		+	},
		+	{
		+	"oper_id":112,
		+	"oper_time":"20130220112245",
		+	"sum":"4500",
		+	"order_id":11801,
		+	"oper_type":"receipt",
		+	"name":"DRIVER_OPERATION_2",
		+	"comment":"DRIVER_OPERATION_COMMENT_2",
		+	"account_kind":0,
		+	"cancelled_by_oper_id":111,
		+	"cancelled_oper_id":0
		+	}
		+	]
		+	}
		+	}
		+	</pre>
		+
		+	=== Назначение динамического приоритета водителю ===
		+	Метод: POST
		+
		+	Название запроса: create_driver_dyn_priority
		+
		+	Параметры в формате JSON:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|driver_id
		+	|Целое
		+	|ИД водителя (должно быть что-то одно: либо driver_id, либо crew_id)
		+	|-
		+	|crew_id
		+	|Целое
		+	|ИД экипажа (должно быть что-то одно: либо driver_id, либо crew_id)
		+	|-
		+	|priority
		+	|Целое
		+	|Приоритет
		+	|-
		+	|start_time
		+	|ГГГГММДДччммсс
		+	|Время начала действия приоритета
		+	|-
		+	|finish_time
		+	|ГГГГММДДччммсс
		+	|Время окончания действия приоритета
		+	|-
		+	|name
		+	|Строка
		+	|Наименование приоритета
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Водитель не найден ИД=DRIVER_ID
		+	|-
		+	|101
		+	|Экипаж не найден ИД=CREW_ID
		+	|-
		+	|102
		+	|Время начала действия приоритета должно быть меньше времени окончания
		+	|-
		+	|103
		+	|Время действия приоритета уже истекло
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|dyn_priority_id
		+	|Целое
		+	|ИД созданного динамического приоритета
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+	POST https://ip:port/common_api/1.0/create_driver_dyn_priority
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"driver_id": 1,
		+	"priority": 10,
		+	"start_time": "20150101100000",
		+	"finish_time": "20150101200000",
		+	"name": "За выполнение заказа в отдаленный район"
		+	}
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"dyn_priority_id":123
		+	}
		+	}
		+	</pre>
		+
		+	=== Задание координат экипажей ===
		+	Метод: POST
		+
		+	Название запроса: set_crews_coords
		+
		+	Параметры в формате JSON:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|crew_coords
		+	|Массив
		+	|Массив координат экипажей
		+	|-
		+	|&bull; crew_id
		+	|Целое
		+	|ИД экипажа
		+	|-
		+	|&bull; gps_id
		+	|Целое
		+	|GPS идентификатор (если не задан ИД экипажа). Данный параметр устарел - не применяется, начиная с версии 3.9
		+	|-
		+	|&bull; lat
		+	|Дробное
		+	|Широта
		+	|-
		+	|&bull; lon
		+	|Дробное
		+	|Долгота
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|speed
		+	|Дробное
		+	|Скорость
		+	|-
		+	|direction
		+	|Целое
		+	|Направление движения (0-Север, 90-Восток, 180-Юг, 270-Запад, -1-не задано)
		+	|}
		+
		+
		+	Специальные возвращаемые коды: нет
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет
		+
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/common_api/1.0/set_crews_coords HTTP/1.1
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"crews_coords":[
		+	{
		+	"crew_id":1,
		+	"lat":11.111111,
		+	"lon":22.222222,
		+	"speed":66.66,
		+	"direction":333
		+	},
		+	{
		+	"gps_id":2,
		+	"lat":33.333333,
		+	"lon":44.444444
		+	}
		+	]
		+	}
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{}
		+	}
		+	</pre>
		+
		+	=== Изменение информации по заказу ===
		+	Метод: POST
		+
		+	Название запроса: update_order
		+
		+	Параметры в формате JSON:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|order_id
		+	|Целое
		+	|ИД заказа
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|phone
		+	|Строка, <= 30 символов
		+	|Номер телефона
		+	|-
		+	|source_time
		+	|ГГГГММДДччммсс
		+	|Время подачи
		+	|-
		+	|is_prior
		+	|true или false
		+	|Предварительный заказ
		+	|-
		+	|customer
		+	|Строка
		+	|Заказчик
		+	|-
		+	|passenger
		+	|Строка
		+	|Пассажир
		+	|-
		+	|comment
		+	|Строка
		+	|Комментарий
		+	|-
		+	|crew_group_id
		+	|Целое
		+	|ИД группы экипажей
		+	|-
		+	|client_id
		+	|Целое
		+	|ИД клиента
		+	|-
		+	|uds_id
		+	|Целое
		+	|ИД службы ЕДС
		+	|-
		+	|tariff_id
		+	|Целое
		+	|ИД тариф
		+	|-
		+	|addresses
		+	|Массив
		+	|Массив адресов. Первый элемент — адрес
		+	подачи(обязательно), последний — адрес назначения,
		+	между ними — остановки.
		+	|-
		+	|&bull; address
		+	|Строка
		+	|Адрес подачи
		+	|-
		+	|&bull; lat
		+	|Дробное
		+	|Широта адреса
		+	|-
		+	|&bull; lon
		+	|Дробное
		+	|Долгота адреса
		+	|-
		+	|order_params
		+	|Массив
		+	|Массив параметров заказа. Устарело. Рекомендуется использовать параметр attribute_values.
		+	|-
		+	|&bull;
		+	|Целое
		+	|ИД параметра заказа
		+	|-
		+	|attribute_values
		+	|Массив
		+	|Массив значений атрибутов
		+	|-
		+	|&bull; id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|&bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|&bull; num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|&bull; str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
		+	|-
		+	|cost_order
		+	|Дробное
		+	|Сумма заказа
		+	|-
		+	|state_id
		+	|Целое
		+	|ИД состояния заказа
		+	|-
		+	|discount_id
		+	|Целое
		+	|ИД скидки
		+	|-
		+	|auto_select_discount
		+	|true или false
		+	|Автоматически подобрать скидку, если не указана явно
		+	|-
		+	|auto_select_tariff
		+	|true или false
		+	|Автоматически подобрать тариф, если не указан явно
		+	|-
		+	|auto_recalc_cost
		+	|true или false
		+	|Автоматически пересчитать сумму заказа
		+	|-
		+	|auto_update_order_params
		+	|true или false
		+	|Автоматически обновить параметры заказа по клиенту и группе клиента
		+	|-
		+	|email
		+	|Строка
		+	|Email для уведомлений
		+	|-
		+	|prior_to_current_before_minutes
		+	|Целое
		+	|Время перехода из предварительного в текущие заказы, мин
		+	|-
		+	|flight_number
		+	|Строка
		+	|Номер рейса
		+	|-
		+	|need_custom_validate
		+	|true или false
		+	|Использовать специальную проверку перед изменением заказа
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Заказ не найден
		+	|-
		+	|101
		+	|Состояние заказа не найдено
		+	|-
		+	|102
		+	|Тариф не найден
		+	|-
		+	|103
		+	|Скидка не найдена
		+	|-
		+	|104
		+	|Группа экипажа не найдена
		+	|-
		+	|105
		+	|Служба не найдена
		+	|-
		+	|106
		+	|Клиент не найден
		+	|-
		+	|107
		+	|Изменение состояния не соответствует необходимым условиям
		+	|-
		+	|108
		+	|Параметр заказа не найден
		+	|-
		+	|109
		+	|Атрибут не может быть привязан к заказу
		+	|-
		+	|110
		+	|Ошибка специальной проверки заказа перед изменением. В ответе будет возвращаться:
		+	"data": {
		+	"message":"Текст ошибки для пользователя."
		+	}
		+	|-
		+	|111
		+	|Недостаточно средств на безналичном счете клиента в ТМ
		+	|-
		+	|112
		+	|Для клиента запрещена оплата заказа наличными. Клиент должен максимально использовать в заказе безналичную оплату (оплату с основного счета)
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет.
		+
		+	Пример:
		+
		+	<pre>
		+	POST https://ip:port/common_api/1.0/update_order HTTP/1.1
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"order_id": 12105,
		+	"phone": "555",
		+	"source_time": "20141216095044",
		+	"is_prior": true,
		+	"auto_select_discount": true,
		+	"auto_select_tariff": true,
		+	"auto_recalc_cost": true,
		+	"auto_update_order_params": true,
		+	"customer": "Заказчик",
		+	"passenger": "Пассажир",
		+	"comment": "Комментарий",
		+	"crew_group_id": 8,
		+	"client_id": 30,
		+	"tariff_id": 33,
		+	"addresses":[
		+	{"address":"SOURCE","lat":56.896817,"lon":53.147830},
		+	{"address":"STOP1","lat":56.845452,"lon":53.226775},
		+	{"address":"STOP2"},
		+	{"address":"DESTINATION","lat":56.861230,"lon":53.241870}
		+	],
		+	"cost_order": 200,
		+	"state_id": 55,
		+	"discount_id": 1,
		+	"email" : "mail@mail.ru",
		+	"prior_to_current_before_minutes":30,
		+	"flight_number":"Number",
		+	"need_custom_validate":false,
		+	"attribute_values": [
		+	{
		+	"id": 1,
		+	"bool_value": true
		+	},
		+	{
		+	"id": 2,
		+	"num_value": 1
		+	},
		+	{
		+	"id": 3,
		+	"num_value": 10
		+	},
		+	{
		+	"id": 4,
		+	"str_value": "строка"
		+	}
		+	]
		+	}
		+
		+	Ответ:
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{}
		+	}
		+	</pre>
		+
		+	=== Анализ телефона ===
		+
		+	Метод: GET
		+
		+	Название запроса: analyze_phone
		+
		+	Параметры:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|phone
		+	|Строка
		+	|Номер телефона
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|search_in_drivers_mobile
		+	|true или false
		+	|Искать среди телефонов водителей
		+	|-
		+	|search_in_clients
		+	|true или false
		+	|Искать среди телефонов клиентов
		+	|-
		+	|search_in_phones
		+	|true или false
		+	|Искать в справочнике телефонов
		+	|}
		+
		+
		+	Если параметры search_in_drivers_mobile, search_in_clients, search_in_phones не заданы, то поиск телефона будет происходить во всех справочниках.
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Телефон не найден
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|phone_type
		+	|Строка
		+	|Может принимать значения: «driver_mobile», «client», «phone».
		+	|-
		+	|id
		+	|Целое
		+	|ИД водителя, клиента, телефона из справочника.
		+	|-
		+	|client_employee_id
		+	|Целое
		+	|ИД сотрудника клиента (если телефон найден среди телефонов клиента)
		+	|}
		+
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	GET /common_api/1.0/analyze_phone?
		+	phone=89501234567&search_in_drivers_mobile=true&search_in_drivers_home=true&search_in_clients=true&
		+	search_in_phones=true
		+
		+	Host: 127.0.0.1:8089
		+	Keep-Alive: 300
		+	Connection: keep-alive
		+	Signature: 4285286a446064353f4a951b721c54f7
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"phone_type":"client",
		+	"id":1
		+	"client_employee_id":2
		+	}
		+	}
		+
		+	</pre>
		+
		+	=== Показать сообщение в ТМ ===
		+
		+	Метод: POST
		+
		+	Название запроса: show_tm_message
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|text
		+	|Строка
		+	|Текст сообщения
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|type
		+	|Строка
		+	|Тип сообщения ("warning", "error", "information", "confirmation"), по умолчанию "information"
		+	|-
		+	|header
		+	|Строка
		+	|Заголовок сообщения
		+	|-
		+	|timeout
		+	|Целое
		+	|Скрывать сообщение через, сек. (0 — не скрывать)
		+	|-
		+	|users
		+	|Массив
		+	|Массив пользователей (если не указаны — отправлять всем)
		+	|-
		+	|&bull;
		+	|Целое
		+	|ИД пользователя
		+	|-
		+	|color
		+	|Строка
		+	|Цвет уведомления в формате RGB: #FFFFFF
		+	|-
		+	|order_id
		+	|Целое
		+	|ИД заказа для кнопки открытия карточки в уведомлении
		+	|-
		+	|car_id
		+	|Целое
		+	|ИД автомобиля для кнопки открытия карточки в уведомлении
		+	|-
		+	|driver_id
		+	|Целое
		+	|ИД водителя для кнопки открытия карточки в уведомлении
		+	|-
		+	|crew_id
		+	|Целое
		+	|ИД экипажа для кнопки открытия карточки в уведомлении
		+	|-
		+	|client_id
		+	|Целое
		+	|ИД клиента для кнопки открытия карточки в уведомлении
		+	|}
		+
		+
		+	Специальные возвращаемые коды:
		+
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Пользователи для отправки сообщения не найдены
		+	|}
		+
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет.
		+
		+	Пример:
		+	<pre>
		+
		+	Запрос:
		+
		+	POST https://ip:port/common_api/1.0/show_tm_message HTTP/1.1
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"text": "Текст сообщения",
		+	"type": "warning",
		+	"users": [
		+	1,
		+	2,
		+	3
		+	],
		+	"header": "Заголовок",
		+	"timeout": 12,
		+	"color":"#FFFF80",
		+	"car_id":55
		+	}
		+
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{}
		+	}
		+
		+	</pre>
		+
		+	=== Запрос списка купленных смен водителей ===
		+
		+	Метод: GET
		+
		+	Название запроса: get_driver_shifts
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|start_time
		+	|ГГГГММДДччммсс
		+	|Начало периода
		+	|-
		+	|finish_time
		+	|ГГГГММДДччммсс
		+	|Конец периода
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|driver_id
		+	|Целое
		+	|ИД водителя
		+	|-
		+	|new_shifts
		+	|true или false
		+	|Включить в ответ новые смены (по умолчанию true)
		+	|-
		+	|in_work_shifts
		+	|true или false
		+	|Включить в ответ смены в работе (по умолчанию true)
		+	|-
		+	|finished_shifts
		+	|true или false
		+	|Включить в ответ выполненные смены (по умолчанию true)
		+	|-
		+	|failed_shifts
		+	|true или false
		+	|Включить в ответ неуспешно завершенные смены (по умолчанию true)
		+	|-
		+	|returned_shifts
		+	|true или false
		+	|Включить в ответ возвращенные смены (по умолчанию false)
		+	|}
		+
		+	Специальные возвращаемые коды: нет
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|shifts
		+	|Массив
		+	|Массив купленных смен
		+	|-
		+	|&bull; shift_id
		+	|Целое
		+	|ИД купленной смены
		+	|-
		+	|&bull; driver_id
		+	|Целое
		+	|ИД водителя
		+	|-
		+	|&bull;driver_name
		+	|Строка
		+	|ФИО водителя
		+	|-
		+	|&bull; plan_shift_id
		+	|Строка
		+	|ИД запланированной смены
		+	|-
		+	|&bull; plan_shift_name
		+	|Строка
		+	|Наименование запланированной смены
		+	|-
		+	|&bull; plan_shift_cost
		+	|Дробное
		+	|Цена смены
		+	|-
		+	|&bull; plan_shift_type
		+	|Строка
		+	|Тип смены («limited» - срочная, «unlimited» - бессрочная)
		+	|-
		+	|&bull; plan_shift_start_time
		+	|ГГГГММДДччммсс
		+	|План-начало смены (для срочных)
		+	|-
		+	|&bull; plan_shift_finish_time
		+	|ГГГГММДДччммсс
		+	|План-конец смены (для срочных)
		+	|-
		+	|&bull; plan_shift_length
		+	|Целое
		+	|План продолжительность смены, ч. (для бессрочных)
		+	|-
		+	|&bull; plan_shift_crew_group_id
		+	|Целое
		+	|ИД первой группы экипажей, которая может купить смену
		+	|-
		+	|&bull; plan_shift_crew_groups
		+	|Массив
		+	|ИД групп экипажей, которые могут купить смену
		+	|-
		+	|&bull; shift_state
		+	|Строка
		+	|Состояние смены («new» - новая, «in_work» - в работе, «finished» - завершена успешно, «failed» - завершена неуспешно)
		+	|-
		+	|&bull; buy_time
		+	|ГГГГММДДччммсс
		+	|Время продажи смены водителю
		+	|-
		+	|&bull; is_returned
		+	|true или false
		+	|Признак возвращенной смены
		+	|-
		+	|&bull; return_time
		+	|ГГГГММДДччммсс
		+	|Время возврата смены
		+	|-
		+	|&bull; orders_count
		+	|Целое
		+	|Количество заказов, выполненных водителем за смену
		+	|-
		+	|&bull; orders_sum
		+	|Дробное
		+	|Сумма заказов, выполненных водителем за смену
		+	|-
		+	|&bull; fact_length
		+	|Дробное
		+	|Фактическая продолжительность смены, ч.
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	GET https://ip:port/common_api/1.0/get_driver_shifts?start_time=20140101101010&finish_time=20140101202020
		+	Signature: <...>
		+
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"shifts":[
		+	{
		+	"shift_id":1,
		+	"driver_id":1,
		+	"driver_name":"DRIVER_1",
		+	"plan_shift_id":1,
		+	"plan_shift_name":"PLAN_SHIFT_1",
		+	"plan_shift_cost":100,
		+	"plan_shift_type":"limited",
		+	"plan_shift_start_time":"20140101101010",
		+	"plan_shift_finish_time":"20140101101010",
		+	"plan_shift_length":null,
		+	"plan_shift_crew_group_id":1,
		+	"shift_state":new,
		+	"buy_time":"20140101101010",
		+	"is_returned":false,
		+	"return_time":null,
		+	"orders_count":10,
		+	"orders_sum":1000,
		+	"fact_length":1.2
		+	},
		+	{
		+	"shift_id":2,
		+	"driver_id":2,
		+	"driver_name":"DRIVER_2",
		+	"plan_shift_id":2,
		+	"plan_shift_name":"PLAN_SHIFT_2",
		+	"plan_shift_cost":200,
		+	"plan_shift_type":"unlimited",
		+	"plan_shift_start_time":null,
		+	"plan_shift_finish_time":null,
		+	"plan_shift_length":8,
		+	"plan_shift_crew_group_id":null,
		+	"shift_state":new,
		+	"buy_time":"20140101101010",
		+	"is_returned":true,
		+	"return_time":"20140101101010",
		+	"orders_count":0,
		+	"orders_sum":0,
		+	"fact_length":0
		+	}
		+	]
		+	}
		+	}
		+	</pre>
		+
		+	=== Запрос списка запланированных смен водителей ===
		+
		+	Метод: GET
		+
		+	Название запроса: get_driver_plan_shifts
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|start_time
		+	|ГГГГММДДччммсс
		+	|Начало периода (если включаем в ответ срочные смены)
		+	|-
		+	|finish_time
		+	|ГГГГММДДччммсс
		+	|Конец периода (если включаем в ответ срочные смены)
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|limited_shifts
		+	|true или false
		+	|Включить в ответ срочные смены (по умолчанию true)
		+	|-
		+	|unlimited_shifts
		+	|true или false
		+	|Включить в ответ бессрочные смены (по умолчанию true)
		+	|}
		+
		+	Специальные возвращаемые коды: нет
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|plan_shifts
		+	|Массив
		+	|Массив запланированных смен
		+	|-
		+	|&bull; plan_shift_id
		+	|Целое
		+	|ИД запланированной смены
		+	|-
		+	|&bull; plan_shift_name
		+	|Строка
		+	|Наименование запланированной смены
		+	|-
		+	|&bull; plan_shift_comment
		+	|Строка
		+	|Комментарий запланированной смены
		+	|-
		+	|&bull; plan_shift_cost
		+	|Дробное
		+	|Цена смены
		+	|-
		+	|&bull; plan_shift_type
		+	|Строка
		+	|Тип смены («limited» - срочная, «unlimited» - бессрочная)
		+	|-
		+	|&bull; plan_shift_start_time
		+	|ГГГГММДДччммсс
		+	|План-начало смены (для срочных)
		+	|-
		+	|&bull; plan_shift_finish_time
		+	|ГГГГММДДччммсс
		+	|План-конец смены (для срочных)
		+	|-
		+	|&bull; plan_shift_length
		+	|Целое
		+	|План продолжительность смены, ч. (для бессрочных)
		+	|-
		+	|&bull; plan_shift_crew_group_id
		+	|Целое
		+	|ИД первой группы экипажей, которая может купить смену
		+	|-
		+	|&bull; plan_shift_crew_groups
		+	|Массив
		+	|ИД групп экипажей, которые могут купить смену
		+	|-
		+	|&bull; max_sell_count
		+	|Целое
		+	|Максимальное количество продаж смены
		+	|-
		+	|&bull; sold_count
		+	|Целое
		+	|Количество продаж смены
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	GET https://ip:port/common_api/1.0/get_driver_plan_shifts?start_time=20140101101010&finish_time=20140101202020
		+	Signature: <...>
		+
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"plan_shifts":[
		+	{
		+	"plan_shift_id":1,
		+	"plan_shift_name":"PLAN_SHIFT_1",
		+	"plan_shift_comment":"PLAN_SHIFT_COMMENT_1",
		+	"plan_shift_cost":100,
		+	"plan_shift_type":"limited",
		+	"plan_shift_start_time":"20140101101010",
		+	"plan_shift_finish_time":"20140101101010",
		+	"plan_shift_length":null,
		+	"plan_shift_crew_group_id":1,
		+	"max_sell_count":100,
		+	"sold_count":10
		+	},
		+	{
		+	"plan_shift_id":2,
		+	"plan_shift_name":"PLAN_SHIFT_2",
		+	"plan_shift_comment":"PLAN_SHIFT_COMMENT_2",
		+	"plan_shift_cost":200,
		+	"plan_shift_type":"unlimited",
		+	"plan_shift_start_time":null,
		+	"plan_shift_finish_time":null,
		+	"plan_shift_length":8,
		+	"plan_shift_crew_group_id":2,
		+	"max_sell_count":200,
		+	"sold_count":20
		+	}
		+	]
		+	}
		+	}
		+	</pre>
		+
		+	=== Продажа смены водителю ===
		+
		+	Метод: POST
		+
		+	Название запроса: driver_buy_shift
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|crew_id
		+	|Целое
		+	|ИД экипажа
		+	|-
		+	|plan_shift_id
		+	|Целое
		+	|ИД запланированной смены
		+	|}
		+
		+	Специальные возвращаемые коды:
		+
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Запланированная смена не найдена
		+	|-
		+	|101
		+	|Экипаж не найден
		+	|-
		+	|102
		+	|Водитель не найден
		+	|-
		+	|103
		+	|Недостаточно денег на счете водителя
		+	|-
		+	|104
		+	|Водитель уволен либо заблокирован
		+	|-
		+	|105
		+	|Запланированная смена устарела
		+	|-
		+	|106
		+	|Не подходит группа экипажа
		+	|-
		+	|107
		+	|Превышено максимальное число покупок смены
		+	|-
		+	|108
		+	|Повторная покупка смены
		+	|-
		+	|109
		+	|Экипажу не назначен атрибут для доступа к смене
		+	|}
		+
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет.
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/common_api/1.0/driver_buy_shift
		+	Signature: <...>
		+	Content-Type: application/x-www-form-urlencoded
		+	Content-Length: 25
		+	crew_id=1&plan_shift_id=1
		+
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{}
		+	}
		+	</pre>
		+
		+	=== Сохранение отзыва клиента ===
		+	Метод: POST
		+
		+	Название запроса: save_client_feed_back
		+
		+	Параметры в формате JSON:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|phone
		+	|Строка
		+	|Телефон
		+	|-
		+	|rating
		+	|Целое
		+	|Рейтинг (от 1 до 5)
		+	|-
		+	|text
		+	|Строка
		+	|Текстовый отзыв
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|order_id
		+	|Целое
		+	|ИД заказа
		+	|-
		+	|attribute_values
		+	|Массив
		+	|Массив значений атрибутов
		+	|-
		+	|&bull; id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|&bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|&bull; num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|&bull; str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
		+	|}
		+
		+	Допускается указывать либо параметр rating либо text, либо оба параметра.
		+
		+	Специальные возвращаемые коды: нет.
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет.
		+
		+	Пример:
		+	<pre>
		+	Запрос:
		+	POST /common_api/1.0/save_client_feed_back
		+	Host: 127.0.0.1:8090
		+	Keep-Alive: 300
		+	Connection: keep-alive
		+	Content-Type: application/json
		+	Content-Length: 72
		+	Signature: <...>
		+
		+	{
		+	"phone":"89123456789",
		+	"rating":4,
		+	"text":"test feedback",
		+	"order_id":100
		+	}
		+	Ответ:
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{}
		+	}
		+	</pre>
		+
		+	=== Поиск экипажей по координатам ===
		+	Метод: GET
		+
		+	Название запроса: find_crews_by_coords
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|lat
		+	|Дробное
		+	|Широта точки центра поиска
		+	|-
		+	|lon
		+	|Дробное
		+	|Долгота точки центра поиска
		+	|-
		+	|radius
		+	|Дробное
		+	|Радиус поиска, км или мили
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|crews_without_coords
		+	|true или false
		+	|Искать экипажи без реальных координат по координатам стоянок
		+	|-
		+	|crews_release_in
		+	|Целое
		+	|Допустимое время до освобождения в зоне поиска, если надо возвращать занятые экипажи (если 0, то искать только свободные экипажи), мин
		+	|-
		+	|crew_group_id
		+	|Целое
		+	|ИД группы экипажей, заказы из которой должны видеть подходящие экипажи
		+	|-
		+	|uds_id
		+	|Целое
		+	|ИД службы ЕДС, к которой должны принадлежать подходящие экипажи
		+	|-
		+	|attributes
		+	|Строка
		+	|Список ИД атрибутов заказа, которыми должны обладать подходящие экипажи (через точку с запятой, пример: «1;2;3»). Устарело. Рекомендуется использовать параметр attribute_values.
		+	|-
		+	|attribute_values
		+	|Массив
		+	|Массив значений атрибутов
		+	|-
		+	|&bull; id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|&bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|&bull; num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|&bull; str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
		+	|}
		+
		+	Специальные возвращаемые коды: нет
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|waiting_count
		+	|Целое
		+	|Количество свободных экипажей в зоне поиска
		+	|-
		+	|on_order_count
		+	|Целое
		+	|Количество занятых экипажей, освобождающихся в зоне поиска
		+	|}
		+
		+	Пример:
		+	<pre>
		+	Запрос:
		+	GET https://ip:port/common_api/1.0/find_crews_by_coords?
		+	lat=11.111111&lon=22.222222&radius=2&crews_release_in=5
		+	Signature: <...>
		+	Ответ:
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"waiting_count":5,
		+	"on_order_count":2
		+	}
		+	}
		+	</pre>
		+
		+	=== Подбор тарифа для заказа ===
		+	Метод: POST
		+
		+	Название запроса: select_tariff_for_order
		+
		+	Параметры в формате JSON:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|client_id
		+	|Целое
		+	|ИД клиента
		+	|-
		+	|crew_group_id
		+	|Целое
		+	|ИД группы экипажей
		+	|-
		+	|uds_id
		+	|Целое
		+	|ИД службы ЕДС
		+	|-
		+	|source_time
		+	|ГГГГММДДччммсс
		+	|Время подачи
		+	|-
		+	|is_prize
		+	|true или false
		+	|Призовой заказ
		+	|-
		+	|addresses
		+	|Массив
		+	|Массив координат адресов. Первый элемент — адрес подачи,
		+	последний — адрес назначения, между ними — остановки.
		+	Заполняется если определены координаты всех адресов.
		+	|-
		+	|&bull; lon
		+	|Дробное
		+	|Долгота адреса
		+	|-
		+	|&bull; lat
		+	|Дробное
		+	|Широта адреса
		+	|}
		+
		+	Специальные возвращаемые коды:
		+
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Клиент не найден
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|tariff_id
		+	|Целое
		+	|Тариф
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+	POST https://ip:port/common_api/1.0/select_tariff_for_order
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+	{
		+	"client_id":1,
		+	"crew_group_id":2,
		+	"source_time":"20160101100000",
		+	"is_prize":true
		+	"addresses": [
		+	{
		+	"lat": 11.111111,
		+	"lon": 22.222222
		+	},
		+	{
		+	"lat": 33.333333,
		+	"lon": 44.444444
		+	}
		+	}
		+	Ответ:
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"tariff_id":2
		+	}
		+	}
		+	</pre>
		+
		+	=== Импорт марок автомобилей в БД  ===
		+	Метод: POST
		+
		+	Название запроса:  import_car_marks
		+
		+	Параметры в формате JSON:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|marks
		+	|Массив строк
		+	|Импортируемые марки автомобилей
		+	|}
		+
		+	Специальные возвращаемые коды: нет
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/common_api/1.0/import_car_marks
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+	{
		+	"marks": [
		+	"Mercedes",
		+	"BMW"
		+	]
		+	}
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{}
		+	}
		+
		+	</pre>
		+
		+	=== Импорт цветов автомобилей в БД  ===
		+	Метод: POST
		+
		+	Название запроса:  import_car_colors
		+
		+	Параметры в формате JSON:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|colors
		+	|Массив строк
		+	|Импортируемые цвета автомобилей
		+	|}
		+
		+	Специальные возвращаемые коды: нет
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/common_api/1.0/import_car_colors
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"colors": [
		+	"красный",
		+	"синий"
		+	]
		+	}
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{}
		+	}
		+
		+	</pre>
		+
		+	=== Запрос информации по сотруднику клиента  ===
		+	Метод: GET
		+
		+	Название запроса: get_client_employee_info
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|client_employee_id
		+	|Целое
		+	|ИД сотрудника клиента
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Не найден сотрудник клиента ИД=CLIENT_EMPLOYEE_ID
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|client_employee_id
		+	|Целое
		+	|ИД сотрудника
		+	|-
		+	|client_id
		+	|Целое
		+	|ИД клиента
		+	|-
		+	|name
		+	|Строка
		+	|ФИО сотрудника
		+	|-
		+	|is_deleted
		+	|true или false
		+	|Признак удаленного сотрудника
		+	|-
		+	|email
		+	|Строка
		+	|E-mail
		+	|-
		+	|use_email_informing
		+	|true или false
		+	|Использовать E-mail для отправки уведомлений по заказу
		+	|-
		+	|default_crew_group
		+	|Целое
		+	|Группа экипажей по умолчанию
		+	|-
		+	|phones
		+	|Массив
		+	|Массив телефонов сотрудника клиента
		+	|-
		+	|&bull; phone
		+	|Строка
		+	|Номер телефона сотрудника
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	GET https://ip:port/common_api/1.0/get_client_employee_info?client_employee_id=10
		+	Signature: <...>
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"client_employee_id":5,
		+	"client_id":1,
		+	"name":"Иванов Иван",
		+	"is_deleted":false,
		+	"email":"mail@mail.ru",
		+	"use_email_informing":true,
		+	"default_crew_group":1,
		+	"phones":[
		+	{
		+	"phone":"88"
		+	},
		+	{
		+	"phone":"99"
		+	}
		+	]
		+	}
		+	}
		+
		+	</pre>
		+
		+	=== Создание сотрудника клиента ===
		+	Метод: POST
		+
		+	Название запроса: create_client_employee
		+
		+	Параметры в формате JSON:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|client_id
		+	|Целое
		+	|ИД клиента
		+	|-
		+	|name
		+	|Строка
		+	|ФИО сотрудника
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|email
		+	|Строка
		+	|E-mail
		+	|-
		+	|use_email_informing
		+	|true или false
		+	|Использовать E-mail для отправки уведомлений по заказу
		+	|-
		+	|phones
		+	|Массив
		+	|Массив телефонов сотрудника
		+	|-
		+	|&bull; phone
		+	|Строка
		+	|Номер телефона
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Клиент с ИД=CLIENT_ID не найден
		+	|-
		+	|101
		+	|Клиент с ИД=ID имеет такой же номер телефона=PHONE
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет.
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/common_api/1.0/create_client_employee
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: 104
		+
		+	{
		+	"client_id":10
		+	"name":"Иванов Иван",
		+	"email":"mail@mail.ru",
		+	"use_email_informing":true,
		+	"phones":[
		+	{
		+	"phone":"79999999999",
		+	},
		+	{
		+	"phone":"79999999999",
		+	}
		+	]
		+	}
		+
		+	Ответ:
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{}
		+	}
		+
		+	</pre>
		+
		+	=== Обновление информации о сотруднике клиента ===
		+	Метод: POST
		+
		+	Название запроса: update_client_employee_info
		+
		+	Параметры в формате JSON:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|client_employee_id
		+	|Целое
		+	|ИД редактируемого сотрудника клиента
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|name
		+	|Строка
		+	|ФИО сотрудника
		+	|-
		+	|is_deleted
		+	|true или false
		+	|Признак удаленного сотрудника
		+	|-
		+	|email
		+	|Строка
		+	|E-mail
		+	|-
		+	|use_email_informing
		+	|true или false
		+	|Использовать E-mail для отправки уведомлений по заказу
		+	|-
		+	|phones
		+	|Массив
		+	|Массив телефонов сотрудника
		+	|-
		+	|&bull; phone
		+	|Строка
		+	|Номер телефона
		+	|}
		+
		+	Примечание: запрещено редактировать телефоны удаленного сотрудника.
		+
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Сотрудник с ИД=CLIENT_EMPLOYEE_ID не найден
		+	|-
		+	|101
		+	|Клиент с ИД=ID имеет такой же номер телефона=PHONE
		+	|-
		+	|102
		+	|Запрещено редактирование телефонов удаленного сотрудника
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет.
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/common_api/1.0/update_client_employee_info
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: 104
		+
		+	{
		+	"client_employee_id":10
		+	"name":"Иванов Иван",
		+	"is_deleted":false,
		+	"email":"mail@mail.ru",
		+	"use_email_informing":true,
		+	"phones":[
		+	{
		+	"phone":"79999999999",
		+	},
		+	{
		+	"phone":"79999999999",
		+	}
		+	]
		+	}
		+
		+	Ответ:
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{}
		+	}
		+
		+	</pre>
		+
		+	=== Запрос списка состояний заказа ===
		+	Метод: GET
		+
		+	Название запроса: get_order_states_list
		+
		+	Параметры: нет
		+
		+	Специальные возвращаемые коды: нет
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|order_params
		+	|Массив
		+	|Список параметров заказа
		+	|-
		+	|&bull; id
		+	|Целое
		+	|ИД параметра
		+	|-
		+	|&bull; name
		+	|Строка
		+	|Название параметра
		+	|-
		+	|&bull; state_type
		+	|Строка
		+	|Тип состояния. Может принимать значения:
		+
		+	• "accepted" — заказ принят
		+
		+	• "in_work" — заказ в работе
		+
		+	• "finished" — заказ выполнен
		+
		+	• "aborted" — заказ прекращен
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+
		+	GET https://ip:port/common_api/1.0/get_order_states_list
		+
		+	Signature: <...>
		+
		+	Ответ:
		+
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"order_params":[
		+	{
		+	"id":1,
		+	"name":"Принят",
		+	"state_type":"accepted"
		+	},
		+	{
		+	"id":2,
		+	"name":"В работе",
		+	"state_type":"in_work"
		+	},
		+	...
		+	]
		+	}
		+	}
		+
		+	</pre>
		+
		+	===  Запрос списка состояний экипажа ===
		+	Метод: GET
		+
		+	Название запроса: get_crew_states_list
		+
		+	Параметры: нет
		+
		+	Специальные возвращаемые коды: нет
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|order_params
		+	|Массив
		+	|Список параметров заказа
		+	|-
		+	|&bull; id
		+	|Целое
		+	|ИД параметра
		+	|-
		+	|&bull; name
		+	|Строка
		+	|Название параметра
		+	|-
		+	|&bull; state_type
		+	|Строка
		+	|Тип состояния. Может принимать значения:
		+
		+	• "waiting" — экипаж свободен
		+
		+	• "not_available" — экипаж не на линии
		+
		+	• "on_order" — экипаж на заказе
		+
		+	• "on_break" — экипаж на перерыве
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+	GET https://ip:port/common_api/1.0/get_crew_states_list
		+	Signature: <...>
		+
		+	Ответ:
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"order_params":[
		+	{
		+	"id":1,
		+	"name":"Свободен",
		+	"state_type":"waiting"
		+	},
		+	{
		+	"id":2,
		+	"name":"Не работает",
		+	"state_type":"not_available"
		+	},
		+	...
		+	]
		+	}
		+	}
		+
		+	</pre>
		+
		+
		+	=== Запрос глобальных атрибутов ===
		+	Метод: GET
		+
		+	Название запроса: get_global_attributes
		+
		+	Версия ТМ: 3.9
		+
		+	Параметры: нет
		+
		+	Специальные возвращаемые коды: нет
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|attribute_values
		+	|Массив
		+	|Массив значений глобальных атрибутов
		+	|-
		+	|&bull; id
		+	|Целое
		+	|Идентификатор атрибута
		+	|-
		+	|&bull; bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|&bull; num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|&bull; str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Пример запроса:
		+
		+	GET https://ip:port/common_api/1.0/get_global_attributes
		+
		+	Пример ответа:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"global_attributes":[
		+	{
		+	"id":123,
		+	"bool_value":true
		+	},
		+	{
		+	"id":124,
		+	"num_value":314
		+	},
		+	{
		+	"id":125,
		+	"str_value": "AAA"
		+	}
		+	]
		+	}
		+	}
		+
		+	</pre>
		+
		+	=== Изменение глобального атрибута ===
		+	Метод: POST
		+
		+	Название запроса: update_global_attribute
		+
		+	Версия ТМ: 3.9
		+
		+	Параметры в формате JSON:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|id
		+	|Целое
		+	|ИД изменяемого атрибута
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|bool_value
		+	|true или false
		+	|Значение, если тип атрибута «Логический»
		+	|-
		+	|num_value
		+	|Дробное
		+	|Значение, если тип атрибута:
		+	* «Число» (непосредственное значение)
		+	* «Число (выбор из списка)» (непосредственное значение выбранного элемента списка)
		+	* «Перечисляемый» (значение выбранного элемента перечисления)
		+	* «Дата» и «Дата/время» (Unix-время, всегда целое число)
		+	|-
		+	|str_value
		+	|Строка
		+	|Значение, если тип атрибута «Строка»
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Атрибут не найден
		+	|-
		+	|101
		+	|Атрибут не глобальный
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет.
		+
		+	Пример:
		+
		+	<pre>
		+	Пример запроса:
		+
		+	POST https://ip:port/common_api/1.0/update_global_attribute HTTP/1.1
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"id": 12,
		+	"bool_value": true
		+	}
		+
		+	Пример ответа:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{}
		+	}
		+
		+	</pre>
		+
		+	=== Создание резервирования автомобиля ===
		+	Метод: POST
		+
		+	Название запроса: create_car_reservation
		+
		+	Версия ТМ: 3.9.46
		+
		+	Параметры в формате JSON:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|car_id
		+	|Целое
		+	|ИД автомобиля
		+	|-
		+	|driver_id
		+	|Целое
		+	|ИД водителя
		+	|-
		+	|car_reservation_type_id
		+	|Целое
		+	|ИД типа резервирования
		+	|-
		+	|start_time
		+	|ГГГГММДД
		+
		+	или
		+
		+	ГГГГММДДччммсс
		+	|Дата или дата/время начала.
		+	Если указывается дата без времени, то планируемое время начала резервирования устанавливается исходя из времени начала, указанного в соответствующем типе резервирования
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|finish_time
		+	|ГГГГММДДччммсс
		+	|Время окончания резервирования. Если не указано, рассчитывается на основании времени планируемого начала резервирования и продолжительности резервирования, указанного в соответствующем типе резервирования
		+	|-
		+	|comment
		+	|Строка
		+	|Комментарий
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Не найден автомобиль
		+	|-
		+	|101
		+	|Не найден водитель
		+	|-
		+	|102
		+	|Не найден тип резервирования
		+	|-
		+	|103
		+	|Время начала резервирования должно быть меньше времени завершения
		+	|-
		+	|104
		+	|Автомобиль уже зарезервирован в указанный период времени
		+	|-
		+	|105
		+	|Водитель уже имеет зарезервированный автомобиль в указанный период времени
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|car_reservation_id
		+	|Целое
		+	|ИД резервирования
		+	|}
		+
		+	<pre>
		+	Пример запроса:
		+
		+	POST https://ip:port/common_api/1.0/create_car_reservation HTTP/1.1
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"car_id": 1,
		+	"driver_id": 1,
		+	"car_reservation_type_id": 1,
		+	"start_date": "20201231",
		+	"comment": "COMMENT"
		+	}
		+
		+	Пример ответа:
		+
		+	{
		+	"code": 0,
		+	"descr": "OK",
		+	"data": {
		+	"car_reservation_id": 5
		+	}
		+	}
		+
		+	</pre>
		+
		+	=== Создание недоступности автомобиля ===
		+	Метод: POST
		+
		+	Название запроса: create_car_inaccessibility
		+
		+	Версия ТМ: 3.9.46
		+
		+	Параметры в формате JSON:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|car_id
		+	|Целое
		+	|ИД автомобиля
		+	|-
		+	|car_inaccessibility_type_id
		+	|Целое
		+	|ИД типа недоступности
		+	|-
		+	|start_time
		+	|ГГГГММДДччммсс
		+	|Время начала
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|finish_time
		+	|ГГГГММДДччммсс
		+	|Время завершения
		+	|-
		+	|comment
		+	|Строка
		+	|Комментарий
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Не найден автомобиль
		+	|-
		+	|101
		+	|Не найден тип недоступности
		+	|-
		+	|102
		+	|Время начала недоступности должно быть меньше времени завершения
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|car_inaccessibility_id
		+	|Целое
		+	|ИД недоступности
		+	|}
		+
		+	<pre>
		+	Пример запроса:
		+
		+	POST https://ip:port/common_api/1.0/create_car_inaccessibility HTTP/1.1
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"car_id": 1,
		+	"car_inaccesibility_type_id": 1,
		+	"start_time": "20201231235959",
		+	"finish_time": "20210101050000",
		+	"comment": "COMMENT"
		+	}
		+
		+	Пример ответа:
		+
		+	{
		+	"code": 0,
		+	"descr": "OK",
		+	"data": {
		+	"car_inaccessibility_id": 5
		+	}
		+	}
		+
		+	</pre>
		+
		+	=== Вызвать системное событие ===
		+	Метод: POST
		+
		+	Название запроса: run_system_event
		+
		+	Версия ТМ: 3.10
		+
		+	Параметры в формате JSON:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|system_event_id
		+	|Целое
		+	|ИД системного события с типом "По запросу CommonAPI"
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|Произвольный параметр
		+	|любой
		+	|В запросе можно передавать дополнительные произвольные параметры с любыми названиями и значениями. Эти параметры могут использоваться в системном событии.
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|У системного события тип не "По запросу CommonAPI"
		+	|-
		+	|101
		+	|Системное событие не найдено
		+	|-
		+	|102
		+	|Системное событие не активно
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет.
		+
		+	<pre>
		+	Пример запроса:
		+
		+	POST https://ip:port/common_api/1.0/run_system_event HTTP/1.1
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"system_event_id": 123,
		+	"custom_param_1": true
		+	"custom_param_2": 123,
		+	"custom_param_3": 123.45,
		+	"custom_param_4": "aaa"
		+	}
		+
		+	Пример ответа:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{}
		+	}
		+
		+	</pre>
		+
		+	=== Проверить штраф клиента за отмену заказа ===
		+	Метод: GET
		+
		+	Название запроса: check_cancel_order_penalty
		+
		+	Версия ТМ: 3.11
		+
		+	Параметры в формате JSON:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|order_id
		+	|Целое
		+	|ИД заказа
		+	|-
		+	|cancel_order_state_id
		+	|Целое
		+	|ИД состояния заказа, в которое переходит заказ при отмене
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Не найден заказ ИД=order_id
		+	|-
		+	|101
		+	|Не найдено состояние заказа ИД=cancel_order_state_id
		+	|-
		+	|102
		+	|Состояние заказа не соответствует необходимым условиям
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|cancel_order_penalty_sum
		+	|Дробное
		+	|Величина штрафа, которая будет начислена клиенту в случае отмены заказа или 0, если штрафа нет
		+	|}
		+
		+
		+	<pre>
		+	Пример запроса:
		+	GET https://ip:port/common_api/1.0/check_cancel_order_penalty?order_id=12345&cancel_order_state_id=12 HTTP/1.1
		+	Signature: <...>
		+
		+	Пример ответа:
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"cancel_order_penalty_sum":350
		+	}
		+	}
		+
		+
		+	</pre>
		+
		+	=== Запрос трека экипажа ===
		+	Метод: GET
		+
		+	Название запроса: get_crew_track
		+
		+	Версия ТМ: 3.11
		+
		+	Параметры:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|crew_id
		+	|Целое
		+	|ИД экипажа
		+	|-
		+	|start_time
		+	|ГГГГММДДччммсс
		+	|Начало периода
		+	|-
		+	|finish_time
		+	|ГГГГММДДччммсс
		+	|Конец периода, должен отличаться о начала периода не более чем на 7 дней
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Не найден экипаж ИД=crew_id
		+	|-
		+	|101
		+	|Задан период времени более 7 дней
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|track
		+	|Массив
		+	|Массив, трек экипажа за период времени
		+	|-
		+	|&bull; lat
		+	|Дробное
		+	|Широта точки маршрута
		+	|-
		+	|&bull; lon
		+	|Дробное
		+	|Долгота точки маршрута
		+	|-
		+	|&bull; time
		+	|ГГГГММДДччммсс
		+	|Время данной точки
		+	|-
		+	|&bull; speed
		+	|Целое
		+	|Скорость в данный момент, км/ч
		+	|-
		+	|&bull; direction
		+	|Целое
		+	|Направление движения, градусы (0 - север, 90 - восток, 180 - юг, 270 - запад)
		+	|}
		+
		+
		+	<pre>
		+	Пример запроса:
		+
		+	GET https://ip:port/common_api/1.0/get_crew_track?crew_id=1&start_time=20210911120000&finish_time=20210911130000 HTTP/1.1
		+	Signature: <...>
		+
		+	Пример ответа:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{
		+	"track": [
		+	{
		+	"lat": 11.111111,
		+	"lon": 22.222222,
		+	"time": "20210911120000",
		+	"speed": 123,
		+	"direction": 0
		+	}
		+	]
		+	}
		+	}
		+
		+	</pre>
		+
		+	=== Создание фиксированной смены водителя ===
		+	Метод: POST
		+
		+	Название запроса: create_fixed_driver_shift
		+
		+	Версия ТМ: 3.12
		+
		+	Параметры:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|driver_id
		+	|Целое
		+	|ИД водителя
		+	|-
		+	|start_time
		+	|ГГГГММДДччммсс
		+	|Время начала
		+	|-
		+	|finish_time
		+	|ГГГГММДДччммсс
		+	|Время завершения
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Не найден водитель
		+	|-
		+	|101
		+	|Время начала фиксированной смены должно быть меньше времени завершения
		+	|-
		+	|102
		+	|Создаваемая смена пересекается по времени с уже существующей сменой данного водителя
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|fixed_driver_shift_id
		+	|Целое
		+	|ИД фиксированной смены
		+	|}
		+
		+	Пример:
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/common_api/1.0/create_fixed_driver_shift HTTP/1.1
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"driver_id": 1,
		+	"start_time": "20201231235959",
		+	"finish_time": "20210101050000"
		+	}
		+
		+	Ответ:
		+
		+	{
		+	"code": 0,
		+	"descr": "OK",
		+	"data": {
		+	"fixed_driver_shift_id": 5
		+	}
		+	}
		+
		+	</pre>
		+
		+	=== Удаление фиксированной смены водителя ===
		+	Метод: POST
		+
		+	Название запроса: delete_fixed_driver_shift
		+
		+	Версия ТМ: 3.12
		+
		+	Параметры:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|fixed_driver_shift_id
		+	|Целое
		+	|ИД фиксированной смены водителя
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Фиксированная смена водителя не найдена
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет.
		+
		+	Пример:
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/common_api/1.0/delete_fixed_driver_shift HTTP/1.1
		+	Signature: <...>
		+	Content-Type: application/x-www-form-urlencoded
		+	Content-Length: <...>
		+
		+	fixed_driver_shift_id=1
		+
		+	Ответ:
		+
		+	{
		+	"code":0,
		+	"descr":"OK",
		+	"data":{}
		+	}
		+
		+	</pre>
		+
		+
		+	=== Создание путевого листа ===
		+	Метод: POST
		+
		+	Название запроса: create_way_bill
		+
		+	Версия ТМ: 3.14
		+
		+	Параметры:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|start_time
		+	|ГГГГММДДччммсс
		+	|Время начала
		+	|-
		+	|finish_time
		+	|ГГГГММДДччммсс
		+	|Время завершения
		+	|-
		+	|driver_id
		+	|Целое
		+	|ИД водителя
		+	|-
		+	|car_id
		+	|Целое
		+	|ИД автомобиля
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|number
		+	|Строка
		+	|Номер путевого листа
		+	|-
		+	|comment
		+	|Строка
		+	|Комментарий
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Нет лицензии на использование путевых листов
		+	|-
		+	|101
		+	|Не найден водитель
		+	|-
		+	|102
		+	|Не найден автомобиль
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|way_bill_id
		+	|Целое
		+	|ИД созданного путевого листа
		+	|}
		+
		+	Пример:
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/common_api/1.0/create_way_bill HTTP/1.1
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"number": "api_123",
		+	"start_time": "20230508000000",
		+	"finish_time": "20230509000000",
		+	"driver_id": 123,
		+	"car_id": 123,
		+	"comment": "Комментарий"
		+	}
		+
		+	Ответ:
		+
		+	{
		+	"code": 0,
		+	"descr": "OK",
		+	"data": {
		+	"way_bill_id": 5
		+	}
		+	}
		+
		+	</pre>
		+
		+	=== Создание осмотра по путевому листу ===
		+	Метод: POST
		+
		+	Название запроса: create_way_bill_check
		+
		+	Версия ТМ: 3.14
		+
		+	Параметры:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|way_bill_id
		+	|Целое
		+	|ИД путевого листа (должен быть задан либо ИД либо номер)
		+	|-
		+	|way_bill_number
		+	|Строка
		+	|Номер путевого листа (должен быть задан либо ИД либо номер)
		+	|-
		+	|kind
		+	|Строка
		+	|Тип осмотра ("med/tech")
		+	|-
		+	|user_name
		+	|Строка
		+	|Имя пользователя
		+	|-
		+	|success
		+	|true или false
		+	|Результат осмотра
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|number
		+	|Строка
		+	|Номер осмотра
		+	|-
		+	|comment
		+	|Строка
		+	|Комментарий
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Нет лицензии на использование путевых листов
		+	|-
		+	|101
		+	|Не найден путевой лист
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет
		+
		+	Пример:
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/common_api/1.0/create_way_bill_check HTTP/1.1
		+	Signature: <...>
		+	Content-Type: application/json
		+	Content-Length: <...>
		+
		+	{
		+	"way_bill_id": 123,
		+	"number": "api_med_123",
		+	"kind": "med",
		+	"user_name": "Имя",
		+	"success": true,
		+	"comment": "Комментарий"
		+	}
		+
		+	Ответ:
		+
		+	{
		+	"code": 0,
		+	"descr": "OK",
		+	"data": {}
		+	}
		+
		+	</pre>
		+
		+	== Описание протокола TMTAPI Версия 1.0 ==
		+
		+	=== Общее описание протокола ===
		+
		+	==== Формат запроса ====
		+
		+	TM API принимает входящие запросы по протоколу HTTPS. В URI запроса после ip адреса и порта, который будет слушать TM API, должно идти название API (tm_tapi) и версия API.
		+
		+	Пример:
		+
		+	<pre>
		+	GET https://ip:port/tm_tapi/1.0/get_info_by_phone
		+	</pre>
		+
		+	Для получения данных из БД используются запросы типа GET. Для записи данных в БД используются запросы типа POST. В запросе типа GET параметры запроса передаются в URI.
		+
		+	Пример:
		+
		+	<pre>
		+	GET https://ip:port/tm_tapi/1.0/get_info_by_phone?phone=89058800565&fields=PHONE_TYPE-PHONE_
		+	TO_DIAL&signature=661ce071eeefcb4f7fc8bc1f17bd520b
		+	</pre>
		+
		+	В запросе типа POST параметры передаются в теле запроса в формате application/x-www-form-
		+	urlencoded.
		+
		+	Пример:
		+
		+	<pre>
		+	POST https://ip:port/tm_tapi/1.0/change_order_state
		+	Content-Type: application/x-www-form-urlencoded
		+	Content-Length: 71
		+
		+	order_id=98798&need_state=12&signature=a204c50c7e48f0c6849a87485fe5e171
		+	</pre>
		+
		+	В любом запросе обязательно с другими полями должно передаваться поле signature. В нем передается MD5 хэш, рассчитанный для строки, которая получается сцеплением строки параметров запроса с секретным ключом. Секретный ключ задается в настройках модуля TMAPI в Такси-Мастер.
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+	GET https://ip:port/tm_tapi/1.0/get_info_by_phone?phone=89058800565&fields=PHONE_TYPE
		+	&signature=ef17ea682d09e452af544a5758dba396
		+
		+	Секретный ключ:
		+	321
		+
		+	Signature = MD5("phone=89058800565&fields=PHONE_TYPE" + "321") = ef17ea682d09e452af544a5758dba396
		+
		+	</pre>
		+
		+	==== Формат ответа ====
		+	TM API всегда возвращает HTTP код 200 ОК. Результат выполнения запроса содержится в теле ответа в формате XML. Общий вид возвращаемого результата:
		+
		+	<pre>
		+	<response>
		+	<code>Числовой код результата</code>
		+	<descr>Строковое описание результата</descr>
		+	<data>Дополнительная информация</data>
		+	</response>
		+	</pre>
		+
		+	Существуют общие для всех запросов коды результатов:
		+	{|
		+	! Код
		+	! Описание
		+	|-
		+	|0
		+	|Успешное выполнение запроса
		+	|-
		+	|1
		+	|Неизвестная ошибка
		+	|-
		+	|2
		+	|Неизвестный тип API
		+	|-
		+	|3
		+	|API отключено в настройках модуля TM API в Такси-Мастер
		+	|-
		+	|4
		+	|Не совпадает секретный ключ
		+	|-
		+	|5
		+	|Неподдерживаемая версия API
		+	|-
		+	|6
		+	|Неизвестное название запроса
		+	|-
		+	|7
		+	|Неверный тип запроса GET
		+	|-
		+	|8
		+	|Не хватает входного параметра (в доп. информации ответа будет название отсутствующего параметра)
		+	|-
		+	|9
		+	|Некорректный входной параметр (в доп. информации ответа будет название некорректного параметра)
		+	|-
		+	|10
		+	|Внутренняя ошибка обработки запроса
		+	|}
		+
		+	=== Описание запросов ===
		+
		+	==== Запрос информации по номеру телефона ====
		+	Метод: GET
		+
		+	Название запроса: get_info_by_phone
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|PHONE
		+	|Строка, <= 16 символов
		+	|Номер телефона
		+	|-
		+	|FIELDS
		+	|Строка
		+	|Список полей, которые необходимо вернуть. Поля перечисляются через символ ''"-"''
		+	|-
		+	|signature
		+	|Строка
		+	|Поле для проверки секретного ключа.
		+	|}
		+
		+	Специальные возвращаемые коды: нет
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: зависит от того какие поля были переданы в поле fields.
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|PHONE_TYPE
		+	|Целое
		+	|Тип телефона звонящего:
		+	1 - если звонит водитель с основного телефона;
		+
		+	2 - если звонит физическое лицо;
		+
		+	3 - если звонит юридическое лицо;
		+
		+	4 - если звонит номер из справочника Телефоны;
		+
		+	5 - если звонит водитель с неосновного телефона;
		+
		+	6 - если звонит ЦОЗ водитель;
		+
		+	0 - неизвестный номер.
		+	|-
		+	|PHONE_TO_DIAL
		+	|Строка, <= 16 символов
		+	|Номер телефона для отзвона по заказу
		+	|-
		+	|CREW_ID
		+	|Целое
		+	|ИД экипажа
		+	|-
		+	|IS_PRIOR
		+	|0 или 1 (false или true)
		+	|Признак предварительного заказа
		+	|-
		+	|IS_PRIZE
		+	|0 или 1 (false или true)
		+	|Признак призового заказа
		+	|-
		+	|ORDER_CLIENT_ID
		+	|Целое
		+	|ИД клиента из заказа
		+	|-
		+	|DRIVER_PHONE
		+	|Строка, <= 16 символов
		+	|Номер телефона водителя
		+	|-
		+	|CREW_SYSTEMSTATE
		+	|Целое
		+	|Состояние экипажа
		+	|-
		+	|CLIENT_ID
		+	|Целое
		+	|ИД клиента
		+	|-
		+	|CLIENT_TYPE
		+	|Целое
		+	|Тип клиента
		+	|-
		+	|CATEGORYID
		+	|Целое
		+	|ИД категории телефона
		+	|-
		+	|PHONE_SYSTEM_CATEGORY
		+	|Целое
		+	|Системное значение категории телефона (0 - обычный, 1 - черный, 2 - белый, 3 - серый)
		+	|-
		+	|ORDER_ID
		+	|Целое
		+	|ИД заказа
		+	|-
		+	|DRIVER_ID
		+	|Целое
		+	|ИД водителя
		+	|-
		+	|ORDER_STATE
		+	|Целое
		+	|Состояние заказа
		+	|-
		+	|DRIVER_REMAINDER
		+	|Дробное
		+	|Баланс счета водителя
		+	|-
		+	|DISCOUNTEDSUMM
		+	|Строка
		+	|Сумма заказа с учетом всех скидок
		+	|-
		+	|CREW_GROUP_ID
		+	|Целое
		+	|ИД группы экипажа (если в заказе указан экипаж, то берется ИД группы экипажа, если нет — из карты заказа)
		+	|-
		+	|FIRST_CREW_GROUP_ID
		+	|Целое
		+	|ИД первой группы экипажа
		+	|-
		+	|CLIENT_BALANCE
		+	|Дробное
		+	|Баланс клиента
		+	|-
		+	|DRIVER_TIMECOUNT
		+	|Целое
		+	|Время пути водителя до адреса подачи в минутах
		+	|-
		+	|SOURCE_TIMECOUNT
		+	|Целое
		+	|Время оставшееся до подачи в минутах
		+	|-
		+	|GOSNUMBER
		+	|Строка
		+	|Государственный номер автомобиля
		+	|-
		+	|CAR_COLOR
		+	|Строка
		+	|Цвет автомобиля
		+	|-
		+	|CAR_MARK
		+	|Строка
		+	|Марка автомобиля
		+	|-
		+	|ORDER_COORDS
		+	|Строка
		+	|Координаты места подачи. Порядок координат: долгота адреса, широта адреса.
		+	|-
		+	|CREW_COORDS
		+	|Строка
		+	|Координаты назначенного экипажа. Порядок координат: долгота адреса, широта адреса.
		+	|-
		+	|MARKET_TYPE
		+	|Целое
		+	|Тип биржи заказов (2 — Яндекс, 3 — ЦОЗ).
		+	|-
		+	|ORDERS_COUNT
		+	|Целое
		+	|Для телефона клиента — количество текущих и предварительных заказов по телефону; для телефона водителя — количество текущих заказов, на которые назначен данный водитель
		+	|-
		+	|CLIENT_GROUP_ID
		+	|Целое
		+	|ИД группы клиента
		+	|-
		+	|CLIENT_BONUS_BALANCE
		+	|Дробное
		+	|Бонусный баланс клиента
		+	|-
		+	|AD_LIGHTHOUSE
		+	|Строка
		+	|Признак наличия шашек. Пустая строка – номер клиента или водителя без экипажа. 1 – есть шашки, 0 – нет шашек.
		+	|-
		+	|CREW_STATE
		+	|Целое
		+	|Состояние экипажа.
		+	|-
		+	|SOURCE_TIME
		+	|ГГГГММДДччммсс
		+	|Дата и время подачи
		+	|-
		+	|DRV_SHIFT_START_TIME
		+	|ГГГГММДДччммсс
		+	|Начало фактической смены водителя
		+	|-
		+	|START_USER_SIP_ACCOUNTS
		+	|Строка
		+	|Список логинов SIP–аккаунтов пользователя, принявшего заказ
		+	|-
		+	|CREATION_WAY
		+	|Строка
		+	|Способ создания заказа (operator, sms, market, common_api, t_api, taxophone, driver, daily_order, taxophone_web, unknown)
		+	|-
		+	|CREATOR_TAXI_PHONE
		+	|Строка
		+	|Телефон службы-создателя для заказов, принятых из ЦОЗ
		+	|-
		+	|PERFORMER_TAXI_PHONE
		+	|Строка
		+	|Телефон службы-исполнителя для заказов, отданных в ЦОЗ
		+	|-
		+	|CLIENT_IS_LOCKED
		+	|0 или 1 (false или true)
		+	|Признак блокировки клиента
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+	GET https://ip:port/tm_tapi/1.0/get_info_by_phone?phone=89058800565l&fields=PHONE_TYPE-PHONE_
		+	TO_DIAL-CREW_ID-ORDER_ID&signature=d35ab2765f2968d48c096d5f5327db26
		+
		+	Ответ:
		+
		+	<response>
		+	<code>0</code>
		+	<descr>OK</descr>
		+	<data>
		+	<PHONE_TYPE>0</PHONE_TYPE>
		+	<PHONE_TO_DIAL></PHONE_TO_DIAL>
		+	<CREW_ID>3</CREW_ID>
		+	<ORDER_ID>6</ORDER_ID>
		+	<SOURCE_TIME>20140929134911</SOURCE_TIME>
		+	<DRV_SHIFT_START_TIME>20141007105050</DRV_SHIFT_START_TIME>
		+	</data>
		+	</response>
		+	</pre>
		+
		+	==== Запрос информации по ИД заказа ====
		+
		+	Метод: GET
		+
		+	Название запроса: get_info_by_order_id
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|ORDER_ID
		+	|Целое
		+	|ИД заказа
		+	|-
		+	|FIELDS
		+	|Строка
		+	|Список полей, которые необходимо вернуть. Поля перечисляются через символ ''"-"''
		+	|-
		+	|signature
		+	|Строка
		+	|Поле для проверки секретного ключа
		+	|}
		+
		+	Специальные возвращаемые коды: нет
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: зависит от того какие поля были переданы в поле fields.
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|DRIVER_TIMECOUNT
		+	|Строка, <= 16 символов
		+	|Время до подачи в минутах, указанное водителем
		+	|-
		+	|CAR_MARK
		+	|Строка
		+	|Марка автомобиля
		+	|-
		+	|CAR_COLOR
		+	|Строка
		+	|Цвет автомобиля
		+	|-
		+	|GOSNUMBER
		+	|Строка
		+	|Государственный номер автомобиля
		+	|-
		+	|CREW_GROUP_ID
		+	|Целое
		+	|ИД группы экипажа (значение из карты заказа)
		+	|-
		+	|FIRST_CREW_GROUP_ID
		+	|Целое
		+	|ИД первой группы экипажа
		+	|-
		+	|IS_PRIOR
		+	|0 или 1 (false или true)
		+	|Признак предварительного заказа
		+	|-
		+	|IS_PRIZE
		+	|0 или 1 (false или true)
		+	|Признак призового заказа
		+	|-
		+	|DISCOUNTEDSUMM
		+	|Строка
		+	|Сумма заказа с учетом всех скидок
		+	|-
		+	|DRIVER_PHONE
		+	|Строка, <= 16 символов
		+	|Номер телефона водителя
		+	|-
		+	|CATEGORYID
		+	|Целое
		+	|ИД категории телефона
		+	|-
		+	|SOURCE_TIMECOUNT
		+	|Целое
		+	|Время до подачи в минутах
		+	|-
		+	|ORDER_COORDS
		+	|Строка
		+	|Координаты места подачи. Порядок координат: долгота адреса, широта адреса.
		+	|-
		+	|CREW_COORDS
		+	|Строка
		+	|Координаты назначенного экипажа. Порядок координат: долгота адреса, широта адреса.
		+	|-
		+	|ORDER_STATE
		+	|Целое
		+	|ИД состояния заказа
		+	|-
		+	|MARKET_TYPE
		+	|Целое
		+	|Тип биржи заказов (3 — ЦОЗ).
		+	|-
		+	|AD_LIGHTHOUSE
		+	|Строка
		+	|Признак наличия шашек (1 – шашки есть, 0 – шашек нет).
		+	|-
		+	|CREW_STATE
		+	|Целое
		+	|Состояние экипажа
		+	|-
		+	|SOURCE_TIME
		+	|ГГГГММДДччммсс
		+	|Дата и время подачи
		+	|-
		+	|START_USER_SIP_ACCOUNTS
		+	|Строка
		+	|Список логинов SIP–аккаунтов пользователя, принявшего заказ
		+	|-
		+	|ORDER_PARAMS
		+	|Целое
		+	|Список ИД параметров заказа
		+	|-
		+	|CREATION_WAY
		+	|Строка
		+	|Способ создания заказа (operator, sms, market, common_api, t_api, taxophone, driver, daily_order, taxophone_web, unknown)
		+	|-
		+	|CREATOR_TAXI_PHONE
		+	|Строка
		+	|Телефон службы-создателя для заказов, принятых из ЦОЗ
		+	|-
		+	|PERFORMER_TAXI_PHONE
		+	|Строка
		+	|Телефон службы-исполнителя для заказов, отданных в ЦОЗ
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	GET https://ip:port/tm_tapi/1.0/get_info_by_order_id?order_id=60&fields=DRIVER_SOURCETIME-MARKCOLOR-
		+	GOSNUMBER-IS_PRIOR-MOBILE_PHONE-SOURCE_TIME&signature=fdcd04e570443b56176b83f44748dc23
		+
		+
		+	Ответ:
		+
		+	<response>
		+	<code>0</code>
		+	<descr>OK</descr>
		+	<data>
		+	<DRIVER_SOURCETIME></DRIVER_SOURCETIME>
		+	<MARK></MARK>
		+	<COLOR></COLOR>
		+	<GOSNUMBER></GOSNUMBER>
		+	<IS_PRIOR></IS_PRIOR>
		+	<MOBILE_PHONE></MOBILE_PHONE>
		+	<SOURCE_TIME>20140929134911</SOURCE_TIME>
		+	</data>
		+	</response>
		+	</pre>
		+
		+	==== Смена состояния заказа ====
		+	Метод: POST
		+
		+	Название запроса: change_order_state
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|ORDER_ID
		+	|Целое
		+	|ИД заказа
		+	|-
		+	|NEED_STATE
		+	|Целое
		+	|Новое состояние заказа
		+	|-
		+	|signature
		+	|Строка
		+	|Поле для проверки секретного ключа
		+	|}
		+
		+	Специальные возвращаемые коды:
		+
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Заказ с таким ИД не найден
		+	|-
		+	|101
		+	|Изменение состояния не соответствует необходимым условиям
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|ORDER_ID
		+	|Целое
		+	|ИД заказа
		+	|-
		+	|NEED_STATE
		+	|Целое
		+	|Новое состояние заказа
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/tm_tapi/1.0/change_order_state
		+	Content-Type: application/x-www-form-urlencoded
		+	Content-Length: 71
		+
		+	order_id=18561&need_state=14&signature=3e8107e0c044e55d983db1fbed82fd8c
		+
		+	Ответ:
		+
		+	<response>
		+	<code>0</code>
		+	<descr>OK</descr>
		+	<data>
		+	<ORDER_ID>18561</ORDER_ID>
		+	<NEW_STATE>14</NEW_STATE>
		+	</data>
		+	</response>
		+	</pre>
		+
		+	==== Запись пути к файлу разговора в базу данных ====
		+
		+	Метод: POST
		+
		+	Название запроса: create_record_link
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|CALL_ID
		+	|Строка, <= 60 символов
		+	|ИД звонка (необязателен, если указан PHONE)
		+	|-
		+	|PHONE
		+	|Строка, <= 16 символов
		+	|Номер телефона (необязателен, если указан CALL_ID)
		+	|-
		+	|CALL_TYPE
		+	|0 или 1
		+	|0 — Исходящий, 1 — Входящий
		+	|-
		+	|signature
		+	|Строка
		+	|Поле для проверки секретного ключа
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|RECORD_DATE
		+	|ДДММГГГГччммсс
		+	|Дата записи
		+	|-
		+	|RECORD_LENGTH
		+	|Целое
		+	|Продолжительность записи (в секундах)
		+	|-
		+	|FILE_PATH
		+	|Строка, <=255 символов
		+	|Путь к файлу записи
		+	|-
		+	|TRANSFERED_TO
		+	|Строка,<=30 символов
		+	|Номер телефона(линии) на который(ую) был переведен звонок (доп. параметр для CALL_RESULT="transfered")
		+	|-
		+	|CALL_RESULT
		+	|Строка
		+	|Результат звонка, возможны следующие значения:
		+	* "success" - успешный,
		+	* "no_answer" - не дозвонились,
		+	* "answered" - ответили,
		+	* "missed" - пропущен,
		+	* "transfered" - переведен,
		+	* "broke_off" - сброшен,
		+	* "other_user_answered" - принят другим оператором.
		+	* Если не задан, то "success"
		+	|}
		+
		+	Специальные возвращаемые коды: нет.
		+
		+	Возвращаемые данные в случае успешного выполнения запроса
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|RECORD_ID
		+	|Целое
		+	|ИД созданной записи
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/tm_tapi/1.0/create_record_link HTTP/1.1
		+	Content-Type: application/x-www-form-urlencoded
		+	Content-Length: <...>
		+
		+	RECORD_DATE=20130122180949&RECORD_LENGTH=215&CALL_ID=12345&PHONE=8987564&FILE_PATH=d%3A%5Ctemp%5CTM%5Ctrunk%5CSource%5CDevUtils%5CTMAPITest%5C&CALL_TYPE=1&CALL_RESULT=no_answer&signature=<...>
		+
		+	Ответ:
		+	<response>
		+	<code>0</code>
		+	<descr>OK</descr>
		+	<data>
		+	<RECORD_ID>25</RECORD_ID>
		+	</data>
		+	</response>
		+	</pre>
		+
		+	==== Создать новый заказ ====
		+
		+	Метод: POST
		+
		+	Название запроса: make_new_order
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|PHONE
		+	|Строка, <= 16 символов
		+	|Номер телефона
		+	|-
		+	|ORDER_STATE_ID
		+	|Целое
		+	|ИД состояния заказа
		+	|-
		+	|signature
		+	|Строка
		+	|Поле для проверки секретного ключа
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|CREWGROUPID
		+	|Целое
		+	|ИД группы экипажа
		+	|-
		+	|TARIF_ID
		+	|Целое
		+	|ИД тарифа
		+	|-
		+	|DISCOUNTEDSUMM
		+	|Дробное
		+	|Фиксированная сумма за заказ
		+	|-
		+	|CUSTOMER
		+	|Строка, <=80 символов
		+	|Заказчик
		+	|-
		+	|SOURCE
		+	|Строка, <=80 символов
		+	|Адрес подачи
		+	|-
		+	|SOURCE_STREET
		+	|Целое
		+	|ИД улицы подачи
		+	|-
		+	|SOURCE_HOUSE
		+	|Строка, <=10 символов
		+	|Дом подачи
		+	|-
		+	|SOURCE_FLAT
		+	|Строка, <=10 символов
		+	|Квартира подачи
		+	|-
		+	|SOURCE_POINT
		+	|Целое
		+	|ИД пункта подачи
		+	|-
		+	|DESTINATION
		+	|Строка, <=80 символов
		+	|Адрес назначения
		+	|-
		+	|DESTINATION_STREET
		+	|Целое
		+	|ИД улицы назначения
		+	|-
		+	|DESTINATION_HOUSE
		+	|Строка, <=10 символов
		+	|Дом назначения
		+	|-
		+	|DESTINATION_FLAT
		+	|Строка, <=10 символов
		+	|Квартира назначения
		+	|-
		+	|DESTINATION_POINT
		+	|Целое
		+	|ИД пункта назначения
		+	|-
		+	|CREWID
		+	|Целое
		+	|ИД экипажа
		+	|-
		+	|SUMM
		+	|Дробное
		+	|Стоимость заказа без учета скидок (наценок)
		+	|-
		+	|STARTUSER
		+	|Целое
		+	|Пользователь, создавший заказ
		+	|-
		+	|STARTTIME
		+	|ГГГГММДДччммсс
		+	|Дата создания заказа
		+	|-
		+	|FINISHUSER
		+	|Целое
		+	|Пользователь, завершивший заказ
		+	|-
		+	|FINISHTIME
		+	|ГГГГММДДччммсс
		+	|Дата завершения заказа
		+	|-
		+	|SOURCE_ZONE
		+	|Целое
		+	|Район подачи
		+	|-
		+	|DESTINATION_ZONE
		+	|Целое
		+	|Район назначения
		+	|-
		+	|SOURCE_PARKING
		+	|Целое
		+	|Стоянка подачи
		+	|-
		+	|DESTINATION_PARKING
		+	|Целое
		+	|Стоянка назначения
		+	|-
		+	|SOURCE_TIME
		+	|ГГГГММДДччммсс
		+	|Дата подачи
		+	|-
		+	|SOURCE_COUNTRY
		+	|0 или 1 (false или true)
		+	|Признак междугороднего заказа
		+	|-
		+	|IS_PRIOR
		+	|0 или 1 (false или true)
		+	|Признак предварительного заказа
		+	|-
		+	|PRIZE
		+	|0 или 1 (false или true)
		+	|Признак призового заказа
		+	|-
		+	|NOTE
		+	|Строка, <=80 символов
		+	|Примечание
		+	|-
		+	|BONUSPOINT
		+	|Дробное
		+	|Бонусные баллы, начисленные водителю за заказ
		+	|-
		+	|DISTANCE
		+	|Дробное
		+	|Километраж по городу (в километрах)
		+	|-
		+	|HOURLY_LEN
		+	|Целое
		+	|Длительность исполнения почасового заказа (в минутах)
		+	|-
		+	|HOURLY_START
		+	|ГГГГММДДччммсс
		+	|Дата начала отсчета при почасовом заказе
		+	|-
		+	|HOURLY_PAY
		+	|0 или 1 (false или true)
		+	|Признак почасового заказа
		+	|-
		+	|PHONE_TO_DIAL
		+	|Строка, <=16 символов
		+	|Номер телефона для отзвона по заказу
		+	|-
		+	|FROMBORDER
		+	|0 или 1 (false или true)
		+	|Признак заказа "с бордюра"
		+	|-
		+	|WAITING_START
		+	|ГГГГММДДччммсс
		+	|Дата начала ожидания заказчика водителем
		+	|-
		+	|WAITING_LENGTH
		+	|Целое
		+	|Общая длина периода ожидания заказчика водителем (в минутах)
		+	|-
		+	|BACKFREE
		+	|Целое
		+	|Признак применения скидки в 50% на обратный путь
		+	|-
		+	|INPUTTIME
		+	|ГГГГММДДччммсс
		+	|Дата принятия заказа (от даты создания заказа отличается тем, что может быть задана пользователем)
		+	|-
		+	|MONEY_RECEIVE
		+	|0 или 1 (false или true)
		+	|Подтверждение принятия денег наличными
		+	|-
		+	|NOTIFY_BEFORE
		+	|Целое
		+	|Период времени, за который пользователь оповещается о наступлении даты подачи
		+	|-
		+	|WANTCREWID
		+	|Целое
		+	|ИД желаемого экипажа
		+	|-
		+	|DISTANCE_COUNTRY
		+	|Дробное
		+	|Километраж за границами города (в километрах)
		+	|-
		+	|DISTANCE_CHECK
		+	|0 или 1 (false или true)
		+	|Разрешение ручного ввода километража
		+	|-
		+	|CLIENTID
		+	|Целое
		+	|ИД постоянного клиента
		+	|-
		+	|INFRA_STATE
		+	|Целое
		+	|Состояние заявки в исходящей компании колцентра INFRA (1 - заявка передана в исходящую компанию, 2 - отзвон успешно произведен, 3 - занято, 4 - не берут трубку)
		+	|-
		+	|INFRA_ORDER
		+	|Целое
		+	|INFRA-заказ (спец. поле для работы с колцентром компании Инфрател)
		+	|}
		+
		+	Специальные возвращаемые коды: нет
		+
		+	Возвращаемые данные в случае успешного выполнения запроса
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|ORDER_ID
		+	|Целое
		+	|ИД созданного заказа
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/tm_tapi/1.0/make_new_order
		+	Content-Type: application/x-www-form-urlencoded
		+	Content-Length: 206
		+
		+	PHONE=89058770593&ORDER_STATE_ID=10&DISCOUNTED_SUMM=100&signature=afc947f610eba380df6d0e441b03ddad
		+
		+	Ответ:
		+
		+	<response>
		+	<code>0</code>
		+	<descr>OK</descr>
		+	<data>
		+	<order_id>27</order_id>
		+	</data>
		+	</response>
		+	</pre>
		+
		+	==== Поиск улицы в базе ====
		+	Метод: POST
		+
		+	Название запроса: street_search
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|PHONE
		+	|Строка, <= 16 символов
		+	|Номер телефона
		+	|-
		+	|CALL_ID
		+	|Целое
		+	|ИД звонка
		+	|-
		+	|VOICE_STREET
		+	|Строка, <= 60 символов
		+	|Название улицы или пункта, полученное через преобразование голоса в текст
		+	|-
		+	|signature
		+	|Строка
		+	|Поле для проверки секретного ключа
		+	|}
		+
		+	Специальные возвращаемые коды: нет
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|CALL_ID
		+	|Целое
		+	|ИД звонка
		+	|-
		+	|PHONE
		+	|Строка, <= 16 символов
		+	|Номер телефона
		+	|-
		+	|STREET_FOUND
		+	|0 или 1 (false или true)
		+	|Признак того, что улица найдена
		+	|-
		+	|STREET_NAME
		+	|Строка, <= 60 символов
		+	|Наименование улицы или пункта, найденное в базе данных
		+	|}
		+
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+	POST https://ip:port/tm_tapi/1.0/street_search
		+	Content-Type: application/x-www-form-urlencoded
		+	Content-Length: 175
		+
		+	PHONE=89058770593&CALL_ID=56&VOICE_STREET=пушкинск&FIND_STREET=0&API_FIND_STREET=&NUM_HOUSE=&signat
		+	ure=9204a53e0f4842bb623c3a5f7683520a
		+
		+	Ответ:
		+
		+	<response>
		+	<code>0</code>
		+	<descr>OK</descr>
		+	<data>
		+	<CALL_ID>56</CALL_ID>
		+	<PHONE>89058770593</PHONE>
		+	<FIND_STREET>1</FIND_STREET>
		+	<API_FIND_STREET>Пушкинская</API_FIND_STREET>
		+	</data>
		+	</response>
		+	</pre>
		+
		+	==== Смена состояния заказа по результату автодозвона ====
		+	Метод: POST
		+
		+	Название запроса: set_request_state
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|STATE_ID
		+	|Целое
		+	|Cостояние заказа до отзвона
		+	|-
		+	|PHONE_TYPE
		+	|0..2
		+	|Признак, что звонили 1-  клиенту, 0 – водителю, 2 -диспетчеру
		+	|-
		+	|ORDER_ID
		+	|Целое
		+	|ИД заказа
		+	|-
		+	|STATE
		+	|Целое (0, 1, 2, 3, 4, 5)
		+	|Состояние отзвона (0 – начальное, 1 — в процессе, 2 — успешно, 3 — занято, 4 — нет ответа, 5 — ошибка)
		+	|-
		+	|signature
		+	|Строка
		+	|Поле для проверки секретного ключа
		+	|}
		+
		+	Специальные возвращаемые коды: нет
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет
		+
		+	Настройки смены состояний заказа с использованием автодозвона задаются в карточке
		+	состояний заказа.
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+	POST https://ip:port/tm_tapi/1.0/set_request_state
		+	Content-Type: application/x-www-form-urlencoded
		+	Content-Length: 71
		+
		+	state_id=7&phone_type=1&order_id=50&state=4&signature=0eb50db401d3540e038fde68eb260333
		+
		+	Ответ:
		+
		+	<response>
		+	<code>0</code>
		+	<descr>OK</descr>
		+	</response>
		+	</pre>
		+
		+	==== Соединить клиента и водителя ====
		+	Метод: POST
		+
		+	Название запроса: connect_client_and_driver
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|order_id
		+	|Целое
		+	|ИД заказа
		+	|-
		+	|signature
		+	|Строка
		+	|Поле для проверки секретного ключа
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Не найден заказ с таким ИД
		+	|-
		+	|103
		+	|В заказе нет водителя
		+	|-
		+	|104
		+	|У водителя не определен телефон
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/tm_tapi/1.0/connect_client_and_driver
		+	Content-Type: application/x-www-form-urlencoded
		+	Content-Length: 53
		+
		+	order_id=13&signature=6a4b16da44a495b67eb7af11d51954d4
		+
		+	Ответ:
		+
		+	<response>
		+	<code>0</code>
		+	<descr>OK</descr>
		+	</response>
		+
		+	</pre>
		+
		+	==== Количество свободных экипажей на линии ====
		+	Метод: GET
		+
		+	Название запроса: get_free_crews_count
		+
		+	Параметры:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|signature
		+	|Строка
		+	|Поле для проверки секретного ключа
		+	|-
		+	!colspan="3"|Необязательные параметры
		+	|-
		+	|crew_group_id
		+	|Целое
		+	|ИД группы экипажа предполагаемого заказа
		+	|-
		+	|uds_id
		+	|Целое
		+	|ИД службы ЕДС предполагаемого заказа
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|COUNT
		+	|Целое
		+	|Количество свободных экипажей на линии
		+	|}
		+
		+	Пример:
		+	<pre>
		+	Запрос:
		+	GET https://ip:port/tm_tapi/1.0/get_free_crews_count?
		+	crew_group_id=1&uds_id=1&signature=88ca2091061c3e90123275f2c5df55a6
		+	Content-Type: application/x-www-form-urlencoded
		+	Ответ:
		+	<response>
		+	<code>0</code>
		+	<descr>OK</descr>
		+	<data>
		+	<COUNT>5</COUNT>
		+	</data>
		+	</response>
		+	</pre>
		+
		+	==== Запрос пользователя по логину софтфона ====
		+	Метод: GET
		+
		+	Название запроса: get_user_by_sip_login
		+
		+	Параметры:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|signature
		+	|Строка
		+	|Поле для проверки секретного ключа
		+	|-
		+	|login
		+	|Строка
		+	|Логин SIP-аккаунта
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|ID
		+	|Целое
		+	|ИД пользователя, который использует указанный логин SIP-аккаунта софтфона в данный момент
		+	|-
		+	|NAME
		+	|Строка
		+	|Имя пользователя, который использует указанный логин SIP-аккаунта софтфона в данный момент
		+	|}
		+
		+	Пример:
		+	<pre>
		+	Запрос:
		+	GET https://ip:port/tm_tapi/1.0/get_user_by_sip_login?
		+	login=LOGIN&signature=9b06455cdfe933e7af12a35a70e9b1c6
		+	Content-Type: application/x-www-form-urlencoded
		+	Ответ:
		+	<response>
		+	<code>0</code>
		+	<descr>OK</descr>
		+	<data>
		+	<ID>1</ID>
		+	<NAME>ADMINISTRATOR</NAME>
		+	</data>
		+	</response>
		+	</pre>
		+
		+	==== Установить режим «Перерыв» для линий софтфона ====
		+	Метод: POST
		+
		+	Название запроса: set_sip_account_dnd_mode
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|dnd
		+	|Строка
		+	|0 или 1
		+	|-
		+	|user_login
		+	|Строка
		+	|Логин пользователя ТМ
		+	|-
		+	|lines
		+	|Строка
		+	|<nowiki>Список линий, разделенных символом «|»</nowiki>
		+	|-
		+	|signature
		+	|Строка
		+	|Поле для проверки секретного ключа
		+	|}
		+
		+	Специальные возвращаемые коды:
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Пользователь с таким логином или линиями не найден.
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса: нет
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	POST https://ip:port/tm_tapi/1.0/set_sip_account_dnd_mode
		+	Content-Type: application/x-www-form-urlencoded
		+	Content-Length: 66
		+
		+	dnd=1&user_login=USER&lines=101%7C102&signature=3e8107e0c044e55d983db1fbed82fd8c
		+
		+	Ответ:
		+
		+	<response>
		+	<code>0</code>
		+	<descr>OK</descr>
		+	</response>
		+	</pre>
		+
		+	==== Запрос телефонов водителя по позывному экипажа ====
		+
		+	Метод: GET
		+
		+	Название запроса: get_driver_phones_by_crew_code
		+
		+	Параметры:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	!colspan="3"|Обязательные параметры
		+	|-
		+	|crew_code
		+	|Строка
		+	|Позывной экипажа
		+	|}
		+
		+
		+	Специальные возвращаемые коды:
		+
		+	{|
		+	!Код
		+	!Описание
		+	|-
		+	|100
		+	|Водитель не найден
		+	|}
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|mobile_phone
		+	|Строка
		+	|Основной телефон водителя
		+	|-
		+	|home_phone
		+	|Строка
		+	|Неосновной телефон водителя
		+	|}
		+
		+	Пример:
		+
		+	<pre>
		+	Запрос:
		+
		+	GET https://ip:port/tm_tapi/1.0/get_driver_phones_by_crew_code?
		+	crew_code=CODE&signature=6f03bc45d3aa17f7738672180a3ee5de
		+	Content-Type: application/x-www-form-urlencoded
		+
		+	Ответ:
		+
		+	<response>
		+	<code>0</code>
		+	<descr>OK</descr>
		+	<data>
		+	<mobile_phone>123456789</mobile_phone>
		+	<home_phone>987654321</home_phone>
		+	</data>
		+	</response>
		+
		+	</pre>
		+
		+	==== Запрос информации о ключе защиты ====
		+
		+	Метод: GET
		+
		+	Название запроса: get_key_info
		+
		+	Параметры: нет.
		+
		+	Специальные возвращаемые коды: нет.
		+
		+	Возвращаемые данные в случае успешного выполнения запроса:
		+	{|
		+	!Параметр
		+	!Тип
		+	!Описание
		+	|-
		+	|company_name
		+	|Строка
		+	|Наименование организации
		+	|-
		+	|company_id
		+	|Целое
		+	|ИД организации
		+	|-
		+	|tm_server_license_count
		+	|Целое
		+	|Количество лицензий для TMServer
		+	|-
		+	|tm_license_count
		+	|Целое
		+	|Количество лицензий для TM2
		+	|-
		+	|tm_terminal_license_count
		+	|Целое
		+	|Количество лицензий для терминала
	|-		|-
−	!colspan="3"|Обязательные параметры	+	|tm_driver_server_license_count
−	|-
−	|STATE_ID
	|Целое		|Целое
−	|Cостояние заказа до отзвона	+	|Количество лицензий для TMDriverServer
−	|-
−	|PHONE_TYPE
−	|0 или 1
−	|Признак, указывающий кому был совершен звонок (0 - водителю, 1 - клиенту)
	|-		|-
−	|ORDER_ID	+	|tm_driver_license_count
	|Целое		|Целое
−	|ИД заказа	+	|Количество лицензий для водителей
−	|-
−	|STATE
−	|Целое (2, 3, 4, 5)
−	|Состояние отзвона
−	|-
−	|signature
−	|Строка
−	|Поле для проверки секретного ключа
−	|}
−
−	Специальные возвращаемые коды: нет
−
−	Возвращаемые данные в случае успешного выполнения запроса: нет
−
−	Настройки смены состояний заказа с использованием автодозвона задаются в карточке
−	состояний заказа.
−
−	Пример:
−
−	<pre>
−	Запрос:
−	POST https://ip:port/tm_tapi/1.0/set_request_state HTTP/1.1
−	Content-Type: application/x-www-form-urlencoded
−	Content-Length: 71
−
−	state_id=7&phone_type=1&order_id=50&state=4&signature=0eb50db401d3540e038fde68eb260333
−
−	Ответ:
−
−	<response>
−	<code>0</code>
−	<descr>OK</descr>
−	</response>
−	</pre>
−
−	==== Соединить клиента и водителя ====
−	Метод: POST
−
−	Название запроса: connect_client_and_driver
−
−	Параметры:
−
−	{|
−	!Параметр
−	!Тип
−	!Описание
−	|-
−	!colspan="3"|Обязательные параметры
	|-		|-
−	|order_id	+	|tm_sms_server_license_count
	|Целое		|Целое
−	|ИД заказа	+	|Количество лицензий для TMSMSServer
−	|-
−	|signature
−	|Строка
−	|Поле для проверки секретного ключа
−	|}
−
−	Специальные возвращаемые коды:
−	{|
−	!Код
−	!Описание
−	|-
−	|100
−	|Не найден заказ с таким ИД
−	|-
−	|102
−	|Не найдена биржа заказа у данного заказа
−	|}
−
−	Возвращаемые данные в случае успешного выполнения запроса: нет
−
−	Пример:
−
−	<pre>
−	Запрос:
−
−	POST https://ip:port/tm_tapi/1.0/connect_client_and_driver HTTP/1.1
−	Content-Type: application/x-www-form-urlencoded
−	Content-Length: 53
−
−	order_id=13&signature=6a4b16da44a495b67eb7af11d51954d4
−
−	Ответ:
−
−	<response>
−	<code>102</code>
−	<descr>Market not found by OrderId</descr>
−	</response>
−
−	</pre>
−
−
−	==== Установить режим «Перерыв» для линий софтфона ====
−	Метод: POST
−
−	Название запроса: set_sip_account_dnd_mode
−
−	Параметры:
−
−	{|
−	!Параметр
−	!Тип
−	!Описание
−	|-
−	!colspan="3"|Обязательные параметры
−	|-
−	|dnd
−	|Строка
−	|0 или 1
−	|-
−	|user_login
−	|Строка
−	|Логин пользователя ТМ
−	|-
−	|lines
−	|Строка
−	|<nowiki>Список линий, разделенных символом «|».</nowiki>
−	|-
−	|signature
−	|Строка
−	|Поле для проверки секретного ключа.
−	|}
−
−	Специальные возвращаемые коды:
−	{|
−	!Код
−	!Описание
−	|-
−	|100
−	|Пользователь с таким логином или линиями не найден.
	|}		|}
−
−	Возвращаемые данные в случае успешного выполнения запроса: нет
	Пример:		Пример:
−
	<pre>		<pre>
	Запрос:		Запрос:
−		+	GET https://ip:port/tm_tapi/1.0/get_key_info
−	POST https://ip:port/tm_tapi/1.0/set_sip_account_dnd_mode HTTP/1.1
	Content-Type: application/x-www-form-urlencoded		Content-Type: application/x-www-form-urlencoded
−	Content-Length: 66
−
−	dnd=1&user_login=USER&lines=101%7C102&signature=3e8107e0c044e55d983db1fbed82fd8c
−
−	Ответ:
−
−	<response>
−	<code>0</code>
−	<descr>OK</descr>
−	</response>
−	</pre>
−
−
−	=== Запрос телефонов водителя по позывному экипажа ===
−
−	Метод: GET
−
−	Название запроса: get_driver_phones_by_crew_code
−
−	Параметры:
−
−	{|
−	!Параметр
−	!Тип
−	!Описание
−	|-
−	!Обязательные параметры
−	|-
−	|crew_code
−	|Строка
−	|Позывной экипажа
−	|}
−
−
−	Специальные возвращаемые коды:
−
−	{|
−	!Код
−	!Описание
−	|-
−	|100
−	|Водитель не найден
−	|}
−
−	Возвращаемые данные в случае успешного выполнения запроса:
−
−	{|
−	!Параметр
−	!Тип
−	!Описание
−	|-
−	|mobile_phone
−	|Строка
−	|Сотовый телефон водителя
−	|-
−	|home_phone
−	|Строка
−	|Домашний телефон водителя
−	|}
−
−	Пример:
−
−	<pre>
−	Запрос:
−	GET https://ip:port/tm_tapi/1.0/get_driver_phones_by_crew_code?	+	signature=6f03bc45d3aa17f7738672180a3ee5de
−	crew_code=CODE&signature=6f03bc45d3aa17f7738672180a3ee5de HTTP/1.1
−	Content-Type: application/x-www-form-urlencoded
	Ответ:		Ответ:
Строка 5999:		Строка 12 693:
	<descr>OK</descr>		<descr>OK</descr>
	<data>		<data>
−	<mobile_phone>123456789</mobile_phone>	+	company_name>ООО БИТ-Мастер</company_name>
−	<home_phone>987654321</home_phone>	+	<company_id>000</company_id>
		+	<tm_server_license_count>1</tm_server_license_count>
		+	<tm_license_count>10</tm_license_count>
		+	<tm_terminal_license_count>1</tm_terminal_license_count>
		+	<tm_driver_server_license_count>1</tm_driver_server_license_count>
		+	<tm_driver_license_count>30</tm_driver_license_count>
		+	<tm_sms_server_license_count>1</tm_sms_server_license_count>
	</data>		</data>
	</response>		</response>
−
	</pre>		</pre>
Строка 6014:		Строка 12 713:
	Форма, представленная в примере, будет выглядеть следующим образом:		Форма, представленная в примере, будет выглядеть следующим образом:
	{{картинка|Форма для заказа такси.jpg}}		{{картинка|Форма для заказа такси.jpg}}
−
−	[[Категория:ТМ2]]

---

Текущая версия на 14:04, 5 декабря 2023

TM API - специальный набор инструментов Такси-Мастер, который позволит объединить систему с вашим сайтом и различными полезными сервисами. Он предоставляется вам на свободных условиях.

Благодаря этому набору вы сможете:

1. Создать механизм приема заказов через интернет.
2. Сделать ваш сайт более информативным: публиковать полезную для клиентов информацию прямо из системы - список ближайших экипажей, предварительный расчет стоимости поездки, мониторинг движения автомобиля такси в процессе выполнения заказа, карты города и контактную информацию.

Параметры TM API

Задать настройки для корректной работы TM API вы сможете в программе Такси-Мастер в меню «Настройки» в одноименной ветке «TM API».

1. Установите флажок « Использовать TM API», чтобы приступить к его использованию.
2. В поле «Локальный порт» введите номер порта подключения к интернету, на котором работает и будет ожидать запросы о новых заказах TMServer. Рекомендуется оставить номер порта по умолчанию.
3. При необходимости установите флажок « Использовать автопроброс порта с помощью UPnP», также укажите «Внешний порт» и «Локальный IP».

Ветка «Открытое API»

В данной ветке регулируется доступ к синхронизации Такси-Мастер со сторонним сервисом (сайтом), с помощью которого клиенты будут создавать заказы. С примером кода для работы вы можете ознакомиться в данной статье в разделе Общее описание протокола.

1. Установите флажок « Использовать открытое API» для того, чтобы запустить работу протокола TMCommonAPI.
2. В поле «Секретный ключ» укажите произвольный номер. В дальнейшем этот номер следует использовать в API-запросах на сайте.
3. В таблице "Пользователи CommonAPI" можно настроить доступ к CommonAPI. Для этого нужно создать пользователей, у которых будет отдельный секретный ключ, и отметить доступные запросы CommonAPI.

Ветка «API для телефонии»

В данной ветке регулируются настройки API для телефонии, т.е. взаимодействие Такси-Мастер с call-центром через программный интерфейс. С его помощью call-центр может дать команду Такси-Мастер создать заказ или запросить информацию о статусе текущего заказа.

1. Установите флажок « Использовать открытое API для телефонии» для того, чтобы запустить работу протокола TMTAPI.
2. В поле «Секретный ключ» укажите номер секретного ключа для работы.

Ветка «TaxoPhone API»

Ветка «Платежные терминалы»

Параметры этой ветки отвечают за работу модуля интеграции с платежными системами.

1. Установите флажок « Включить прием терминальных платежей». Данная функция позволит отображать все платежные операции по приходу средств от водителей через терминалы в базе данных программы.
2. В поле «Секретный ключ» укажите номер секретного ключа для работы с платежными системами и сверки платежей, который будет выслан вам в письме от менеджера. Секретный ключ - это определенный набор символов, необходимый для формирования подписи при передаче информации о платеже.
3. Кнопка «Задать всем водителям терминальный аккаунт по их ИД» служит для соединения TM API с сервером Такси-Мастер. В результате соединения записи о терминальных аккаунтах генерируются, заносятся (для тех водителей, у которых они отсутствуют) и обновляются (для тех водителей, у которых уже существуют терминальные аккаунты) в Такси-Мастер.

Общее описание протокола

Формат запроса

TMAPI принимает входящие запросы по протоколу HTTPS. В URI запроса после ip адреса и порта, который будет слушать TM API, должно идти название API (common_api) и версия API. Пример:

GET https://ip:port/common_api/1.0/get_crew_groups_list 

Для получения данных из БД используются запросы типа GET. Для записи данных в базу данных используются запросы типа POST. В запросе типа GET параметры запроса передаются в URI. Пример:

GET https://ip:port/common_api/1.0/calc_order_cost?tariff_id=1&distance_city=10 
Signature: <...>

В запросе типа POST параметры передаются в теле запроса в формате application/x-www-form-urlencoded. Пример:

POST https://ip:port/common_api/1.0/create_order 
Signature: <...>
Content-Type: application/x-www-form-urlencoded
Content-Length: 118

phone=89123456789&source=SOURCE&source_time=20120501100000&dest=DEST&customer=CUSTOMER&
comment=COMMENT&crew_group_id=1

В любом запросе обязательно должен быть заголовок Signature. В нем передается MD5 хэш, рассчитанный для строки, которая получается сцеплением строки параметров запроса с секретным ключом. Секретный ключ задается в «Файл - Настройки - TM API - Открытое API». Пример:

Запрос:
GET https://ip:port/common_api/1.0/calc_order_cost?tariff_id=1&distance_city=10 

Секретный ключ:
1234567890

Signature = MD5("tariff_id=1&distance_city=10" + "1234567890") = d7b8fb11b5499b64d750b8efe53e2877

Формат ответа

TM API всегда возвращает HTTP код 200 ОК. Результат выполнения запроса содержится в теле ответа в формате JSON. Общий вид возвращаемого результата:

{
"code":<Числовой код результата>,
"descr":"<Строковое описание результата>",
"data":{<Дополнительная информация>}
}

Существуют общие для всех запросов коды результатов:

Код	Описание
0	Успешное выполнение запроса
1	Неизвестная ошибка
2	Неизвестный тип API
3	API отключено в настройках модуля TM API в ТМ2
4	Не совпадает секретный ключ
5	Неподдерживаемая версия API
6	Неизвестное название запроса
7	Неверный тип запроса GET/POST
8	Не хватает входного параметра (в доп. информации ответа будет название отсутствующего параметра)
9	Некорректный входной параметр (в доп. информации ответа будет название некорректного параметра)
10	Внутренняя ошибка обработки запроса

Описание запросов

Запрос-пинг

Для данного запроса не проверяется версия API, секретный ключ и тип запроса GET/POST.

Метод: GET или POST

Название запроса: ping

Параметры: нет

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса: нет

Пример:

Запрос:
GET https://ip:port/common_api/1.0/ping 
Ответ:
{
"code":0,
"descr":"OK",
"data":{}
}

Запрос списка групп экипажей

Метод: GET

Название запроса: get_crew_groups_list

Параметры: нет

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
crew_groups	Массив	Список групп экипажей
• id	Целое	ИД группы экипажей
• name	Строка	Название группы экипажей

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_crew_groups_list 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "crew_groups":[
     {
       "id":1,
       "name":"CREW_GROUP1"
     },
     {
       "id":2,
       "name":"CREW_GROUP2"
     }
    ]
  }
}

Запрос списка групп клиентов

Метод: GET

Название запроса: get_client_groups_list

Параметры: нет

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
client_groups	Массив	Список групп клиентов
• id	Целое	ИД группы клиентов
• name	Строка	Название группы клиентов

Пример:

Запрос:
GET https://ip:port/common_api/1.0/get_client_groups_list 
Signature: <...>
Ответ:
{
  "code":0,
  "descr":"OK",
  "data":{
    "client_groups":[
      {
        "id":1,
        "name":"CLIENT_GROUP1"
      },
      {
        "id":2,
        "name":"CLIENT_GROUP2"
      }
    ]
  }
}

Запрос списка служб ЕДС

Метод: GET

Название запроса: get_uds_list

Параметры: нет

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
uds	Массив	Список служб ЕДС
• id	Целое	ИД службы ЕДС
• name	Строка	Название службы ЕДС

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_uds_list 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "uds":[
      {
        "id":1,
        "name":"UDS1"
      },
      {
        "id":2,
        "name":"UDS2"
      }
    ]
  }
}

Запрос списка тарифов

Метод: GET

Название запроса: get_tariffs_list

Параметры: нет

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
tariffs	Массив	Список тарифов
• id	Целое	ИД тарифа
• name	Строка	Название тарифа
• is_active	true или false	Активный тариф

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_tariffs_list 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "tariffs":[
      {
        "id":1,
        "name":"TARIFF1"
        "is_active":true 
      },
      {
         "id":2,
         "name":"TARIFF2"
         "is_active":true
      }
    ]
  }
}

Запрос списка услуг

Запрос устарел. Рекомендуется использовать Запрос списка атрибутов

Метод: GET

Название запроса: get_services_list

Параметры: нет

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
services	Массив	Список услуг
• id	Целое	ИД услуги
• name	Строка	Название услуги
• sum	Дробное	Абсолютная сумма услуги, руб
• percent	Дробное	Процент услуги от стоимости заказа, %

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_services_list 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "services":[
      {
        "id":1,
        "name":"SERVICE1",
        "sum":100,
        "percent":0
      },
      {
        "id":2,
        "name":"SERVICE2"
        "sum":0,
        "percent":10
      }
    ]
  }
}

Запрос списка атрибутов

Метод: GET

Название запроса: get_order_params_list

Параметры: нет

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
order_params	Массив	Список параметров заказа
• id	Целое	ИД параметра
• name	Строка	Название параметра
• sum	Дробное	Абсолютная сумма параметра, руб
• percent	Дробное	Процент параметра от стоимости заказа, %
• order_access_control	true или falce	Регулирует доступ к заказу

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_order_params_list 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "order_params":[
      {
        "id":1,
        "name":"PARAM1",
        "sum":100,
        "percent":0,
        "order_access_control":true
      },
      {
        "id":2,
        "name":"PARAM2",
        "sum":0,
        "percent":10,
        "order_access_control":false
      }
    ]
  }
}

Запрос списка скидок

Метод: GET

Название запроса: get_discounts_list

Параметры: нет

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
discounts	Массив	Список скидок
• id	Целое	ИД скидки
• name	Строка	Название скидки
• sum	Дробное	Абсолютная сумма скидки, руб
• percent	Дробное	Процент скидки от стоимости заказа, %

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_discounts_list 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "discounts":[
      {
        "id":1,
        "name":"DISCOUNT1",
        "sum":100,
        "percent":0
      },
      {
        "id":2,
        "name":"DISCOUNT2"
        "sum":0,
        "percent":10
      }
    ]
  }
}

Создание нового заказа

Метод: POST

Название запроса: create_order

Параметры:

Параметр	Тип	Описание
Обязательные параметры
phone	Строка, <= 30 символов	Номер телефона
source	Строка	Адрес подачи
source_time	ГГГГММДДччммсс	Время подачи
Необязательные параметры
dest	Строка	Адрес назначения
customer	Строка	Заказчик
comment	Строка	Комментарий
crew_group_id	Целое	ИД группы экипажей
uds_id	Целое	ИД службы ЕДС
tariff_id	Целое	ИД тарифа
is_prior	true или false	Предварительный заказ
source_lon	Дробное	Долгота адреса подачи
source_lat	Дробное	Широта адреса подачи
dest_lon	Дробное	Долгота адреса назначения
dest_lat	Дробное	Широта адреса назначения

Специальные возвращаемые коды:

Код	Описание
100	Заказ с такими параметрами уже создан
101	Тариф не найден
102	Группа экипажа не найдена
103	Служба ЕДС не найдена
110	Клиент заблокирован
111	Не найден клиент, который может использовать собственный счет для оплаты заказов
114	Недостаточно средств на безналичном счете клиента в ТМ
115	Отрицательный баланс на безналичном счете клиента в ТМ
116	Для клиента запрещена оплата заказа наличными. Клиент должен максимально использовать в заказе безналичную оплату (оплату с основного счета)

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
order_id	Целое	ИД созданного заказа

Пример:

Запрос:

POST https://ip:port/common_api/1.0/create_order 
Signature: <...>
Content-Type: application/x-www-form-urlencoded
Content-Length: 156

phone=89123456789&source=SOURCE&source_time=20120501100000&dest=DEST&customer=CUSTOMER&
comment=COMMENT&crew_group_id=1&uds_id=1&tariff_id=3&is_prior=false&source_lon=53.147836&source_lat
=56.896817&dest_lon=53.226775&dest_lat=56.845452

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "order_id":12345
  }
}

Создание нового заказа 2

Метод: POST

Название запроса: create_order2

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
phone	Строка, <= 30 символов	Номер телефонам (необязателен, если client_id присутствует).
client_id	Целое	ИД клиента (необязателен, если phone присутствует).
addresses	Массив	Массив адресов. Первый элемент — адрес подачи(обязательно), последний — адрес назначения, между ними — остановки.
• address	Строка	Адрес подачи
• lat	Дробное	Широта адреса
• lon	Дробное	Долгота адреса
• zone_id	Целое	ИД района
• parking_id	Целое	ИД стоянки
server_time_offset	Целое	Смещения относительно серверного времени
source_time	ГГГГММДДччммсс	Время подачи
Необязательные параметры
passenger	Строка	Пассажир
phone_to_dial	Строка, <= 30 символов	Телефон для отзвона
customer	Строка	Заказчик
comment	Строка	Комментарий
crew_group_id	Целое	ИД группы экипажей
uds_id	Целое	ИД службы ЕДС
tariff_id	Целое	ИД тарифа
is_prior	true или false	Предварительный заказ
check_duplicate	true или false	Проверка на дубликат
services	Массив	Массив услуг. Устарело. Рекомендуется использовать параметр attribute_values.
•	Целое	ИД услуги
crew_props	Массив	Массив признаков экипажей. Устарело. Рекомендуется использовать параметр attribute_values.
•	Целое	ИД признака экипажа
order_params	Массив	Массив параметров заказа. Устарело. Рекомендуется использовать параметр attribute_values.
•	Целое	ИД параметра заказа
total_cost	Дробное	Сумма заказа
use_cashless	true или false	Оплата по возможности всей суммы заказа с безналичного счета клиента (насколько хватает средств на счете).
use_bonus	true или false	Оплата по возможности всей суммы заказа с бонусного счета клиента (насколько хватает средств на бонусном счете).
cashless_sum	Дробное	Фиксированная сумма оплаты заказа с безналичного счета клиента (не используется, если use_cashless = true).
bonus_sum	Дробное	Фиксированная сумма оплаты заказа с бонусного счета клиента (не используется, если use_bonus = true).
client_employee_id	Целое	ИД сотрудника клиента (если задан client_id)
email	Строка	Email для отправки уведомлений
prior_to_current_before_minutes	Целое	Время перехода из предварительного в текущие заказы, мин
flight_number	Строка	Номер рейса
need_custom_validate	true или false	Использовать специальную проверку перед созданием заказа
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Специальные возвращаемые коды:

Код	Описание
100	Заказ с такими параметрами уже создан
101	Тариф не найден
102	Группа экипажа не найдена
103	Служба ЕДС не найдена
104	Клиент не найден
105	Район не найден
106	Стоянка не найдена
107	Сотрудник клиента не найден
108	Параметр заказа не найден
109	Атрибут не может быть привязан к заказу
110	Клиент заблокирован
111	Не найден клиент, который может использовать собственный счет для оплаты заказов
112	Сотрудник клиента заблокирован
113	Ошибка специальной проверки заказа перед созданием. В ответе будет возвращаться: "data": { "message":"Текст ошибки для пользователя." }
114	Недостаточно средств на безналичном счете клиента в ТМ
115	Отрицательный баланс на безналичном счете клиента в ТМ
116	Для клиента запрещена оплата заказа наличными. Клиент должен максимально использовать в заказе безналичную оплату (оплату с основного счета)

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
order_id	Целое	ИД созданного заказа

Пример:

POST https://ip:port/common_api/1.0/create_order2 HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "server_time_offset":2,
  "source_time":"20140415172811",
  "is_prior":false,
  "check_duplicate":true,
  "phone":"123456",
  "phone_to_dial":"654321",
  "client_id":1,  
  "client_employee_id":4,  
  "customer":"CUSTOMER",
  "passenger":"PASSENGER",
  "comment":"COMMENT",
  "crew_group_id":1,
  "uds_id":1,
  "tariff_id":1,
  "addresses": [
      {
          "address": "SOURCE",
          "lat": 56.896817,
          "lon": 53.14783
          "zone_id": 1,
          "parking_id": 1
      },
      {
          "address": "STOP1",
          "lat": 56.845452,
          "lon": 53.226775
          "zone_id": 2,
          "parking_id": 2
      },
      {
          "address": "STOP2"
      },
      {
          "address": "DESTINATION",
          "lat": 56.86123,
          "lon": 53.24187
      }
  ]
  "services":[1,2],
  "crew_props":[1],
  "order_params":[3,4],
  "total_cost":370,
  "client_id":28,
  "use_cashless":false,
  "use_bonus":false,
  "cashless_sum":700,
  "bonus_sum":350,
  "email":"email@gmail.com",
  "prior_to_current_before_minutes":30,
  "flight_number":"130-qwe2",
  "need_custom_validate":false,
  "attribute_values": [
      {
            "id": 1,
            "bool_value": true
      },
      {
            "id": 2,
            "num_value": 1
      },
      {
            "id": 3,
            "num_value": 10
      },
      {
            "id": 4,
            "str_value": "строка"
      }
  ]
}

Ответ:
{
  "code":0,
  "descr":"OK",
  "data":{
    "order_id":1672
  }
}

Расчет суммы заказа

Метод: GET

Название запроса: calc_order_cost

Параметры:

Параметр	Тип	Описание
Обязательные параметры
tariff_id	Целое	ИД тарифа
Необязательные параметры
source_time	ГГГГММДДччммсс	Время подачи
is_prior	true или false	Предварительный заказ
client_id	Целое	ИД клиента
client_employee_id	Целое	ИД сотрудника клиента
discount_id	Целое	ИД скидки
disc_card_id	Целое	ИД дисконтной карты
source_zone_id	Целое	ИД района подачи
dest_zone_id	Целое	ИД района назначения
distance_city	Дробное	Километраж по городу
distance_country	Дробное	Километраж за городом
source_distance_country	Дробное	Километраж до подачи за городом
is_country	true или false	Загородный заказ
waiting_minutes	Целое	Время ожидания посадки клиента в минутах
is_hourly	true или false	Почасовой заказ
hourly_minutes	Целое	Длительность почасового заказа в минутах
is_prize	true или false	Призовой заказ
back_way	true или false	Обратный путь за городом
services	Строка	Список ИД услуг через точку с запятой, пример: «1;2;3» Устарело. Рекомендуется использовать параметр order_params.
order_params	Строка	Список ИД параметров заказа через точку с запятой, пример: «1;2;3»
cashless	true или false	Признак безналичного заказа

Специальные возвращаемые коды:

Код	Описание
100	Тариф не найден
101	Ошибка при расчете по тарифу
102	Скидка не найдена
103	Клиент не найден
104	Район подачи не найден
105	Район назначения не найден
106	Дисконтная карта не найдена
107	Район остановки не найден
108	Группа экипажа не найдена
109	Служба ЕДС не найдена
110	Дисконтная карта не действительна
111	Не найден сотрудник клиента

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
sum	Дробное	Рассчитанная общая сумма заказа
info	Массив	Дополнительная информация по расчету суммы заказа
• comment	Строка	Описание позиции дополнительной информации по расчету суммы заказа
• sum	Строка	Сумма позиции дополнительной информации по расчету суммы заказа

Пример:

Запрос: 

GET https://ip:port/common_api/1.0/calc_order_cost?tariff_id=1&source_time=20120501100000&is_prior=false&client_id=1&client_employee_id=11&discount_id=1&disc_card_id=1&
source_zone_id=1&dest_zone_id=2&distance_city=10&distance_country=20&source_distance_country=5&is_country=true&waiting_minutes=10&is_hourly=false&hourly_minutes=60&
is_prize=true&back_way=false&services=1;2;3&order_params=1;2;3 HTTP/1.1
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "sum":1000,
    "info":[
      {
         "comment":"SUM1",
         "sum":"100"
      },
      {
         "comment":"SUM2",
         "sum":"200"
      }
    ]
  }
} 

Расчет суммы заказа 2

Метод: POST

Название запроса: calc_order_cost2

Параметры в формате JSON:

Параметр	Тип	Описание
order_id	Целое	ИД заказа
tariff_id	Целое	ИД тарифа
source_time	ГГГГММДДччммсс	Время подачи
is_prior	true или false	Предварительный заказ
client_id	Целое	ИД клиента
phone	Строка	Телефон клиента
discount_id	Целое	ИД скидки
disc_card_id	Целое	ИД дисконтной карты
source_zone_id	Целое	ИД района подачи
source_lon	Дробное	Долгота адреса подачи
source_lat	Дробное	Широта адреса подачи
dest_zone_id	Целое	ИД района назначения
dest_lon	Дробное	Долгота адреса назначения
dest_lat	Дробное	Широта адреса назначения
distance_city	Дробное	Километраж по городу
distance_country	Дробное	Километраж за городом
source_distance_country	Дробное	Километраж до подачи за городом
is_country	true или false	Загородный заказ
waiting_minutes	Целое	Время ожидания посадки клиента в минутах
is_hourly	true или false	Почасовой заказ
hourly_minutes	Целое	Длительность почасового заказа в минутах
is_prize	true или false	Призовой заказ
back_way	true или false	Обратный путь за городом
order_params	Массив	Массив параметров заказа. Устарело. Рекомендуется использовать параметр attribute_values.
•	Целое	ИД параметра заказа
cashless	true или false	Признак безналичного заказа
stops	Массив	Список остановок
• zone_id	Целое	ИД района остановки
• lat	Дробное	Широта адреса остановки
• lon	Дробное	Долгота адреса остановки
crew_group_id	Целое	ИД группы экипажа
uds_id	Целое	ИД службы ЕДС
analyze_route	true или false	Нужно ли выполнять анализ адресов и маршрута. Если данный флаг установлен (analyze_route=true), то значения параметров: distance_city, distance_country, source_distance_country, переданные в данном запросе будут игнорироваться. Они автоматически будут рассчитаны в ходе выполнения запроса в результате анализа адресов и маршрута. Также перед анализом адресов будут автоматически найдены районы (по справочнику "Районы") для тех адресов, у которых район не указан явно (zone_id=0). Также по результатам анализа адресов автоматически будут определены флаги "Загородный заказ" (is_country) и "Межгород".
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Специальные возвращаемые коды:

Код	Описание
100	Тариф не найден
101	Ошибка при расчете по тарифу
102	Скидка не найдена
103	Клиент не найден
104	Район подачи не найден
105	Район назначения не найден
106	Дисконтная карта не найдена
107	Район остановки не найден
108	Группа экипажа не найдена
109	Служба ЕДС не найдена
110	Дисконтная карта не действительна
111	Сотрудник клиента не найден
112	Атрибут не найден
113	Атрибут не может быть привязан к заказу
114	Заказ не найден

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
sum	Дробное	Рассчитанная общая сумма заказа
info	Массив	Дополнительная информация по расчету суммы заказа
• comment	Строка	Описание позиции дополнительной информации по расчету суммы заказа
• sum	Строка	Сумма позиции дополнительной информации по расчету суммы заказа

Пример:

Запрос: 

POST https://ip:port/common_api/1.0/calc_order_cost2 HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "tariff_id":1,
  "source_time":"20140415172811",
  "is_prior":false,
  "client_id":1,  
  "discount_id":1,
  "disc_card_id":1,
  "source_zone_id":1,,
  "source_lat":11.111111,
  "source_lon":22.222222,
  "dest_zone_id":2,,
  "dest_lat":33.333333,
  "dest_lon":44.444444,
  "distance_city":10,
  "distance_country":20,
  "source_distance_country":5,
  "is_country":true,
  "waiting_minutes":10,
  "is_hourly":false,
  "hourly_minutes":60,
  "is_prize":true,
  "back_way":false,
  "order_params":[3,4],
  "stops": [
      {
          "zone_id": 1,
          "lat": 11.111111,
          "lon": 22.222222
      },
      { 
          "zone_id": 2,
          "lat": 33.333333,
          "lon": 44.444444
      }
  ],
  "attribute_values": [
      {
            "id": 1,
            "bool_value": true
      },
      {
            "id": 2,
            "num_value": 1
      },
      {
            "id": 3,
            "num_value": 10
      },
      {
            "id": 4,
            "str_value": "строка"
      }
  ]
}

Ответ:
{
  "code":0,
  "descr":"OK",
  "data":{
    "sum":1000,
    "info":[
      {
        "comment":"SUM1",
        "sum":"100"
      },
      {
        "comment":"SUM2",
        "sum":"200"
      }
    ]
  }
}

Изменение состояния заказа

Метод: POST

Название запроса: change_order_state

Параметры:

Параметр	Тип	Описание
Обязательные параметры
order_id	Целое	ИД заказа
new_state	Целое	Новое состояние заказа
Необязательные параметры
cancel_order_penalty_sum	Дробное	Сумма штрафа клиента за отмену заказа. Если свойство new_state имеет тип "Прекращен" (выполняется отмена заказа) и при отмене заказа должен быть назначен штраф клиенту, то если данное значение штрафа указано (даже если указано значение 0), то оно имеет приоритет. Если данное значение не указано, то сумма штрафа будет определена автоматически по группе клиентов.

Специальные возвращаемые коды:

Код	Описание
100	Не найден заказ ИД=ORDER_ID
101	Не найдено состояние заказа ИД=NEW_STATE
102	Изменение состояния не соответствует необходимым условиям.

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
order_id	Целое	ИД заказа
new_state	Целое	Новое состояние заказа

Пример:

Запрос: 

POST https://ip:port/common_api/1.0/change_order_state?order_id=6&new_state=4 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "order_id":6,
    "new_state":4
  }
} 

Запрос информации об экипаже

Метод: GET

Название запроса: get_crew_info

Параметры:

Параметр	Тип	Описание
Обязательные параметры
crew_id	Целое	ИД экипажа
Необязательные параметры
fields	Строка	Список возвращаемых полей через запятую

Специальные возвращаемые коды:

Код	Описание
100	Экипаж не найден

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
crew_id	Целое	ИД экипажа
code	Строка	Позывной экипажа
name	Строка	Наименование экипажа
driver_id	Целое	ИД водителя
car_id	Целое	ИД автомобиля
crew_group_id	Целое	ИД группы экипажа
crew_state_id	Целое	ИД состояния экипажа
online	true или false	Водитель подключен к серверу «Связи с водителями»
work_shift_sum	Дробное	Сумма, списываемая за смену
min_balance	Дробное	Минимальный баланс, при котором можно выйти на смену
common_priority	Целое	Общий приоритет
static_priority	Целое	Статический приоритет
dynamic_priority	Целое	Динамический приоритет
rating_priority	Целое	Приоритет по рейтингу
order_change_id	Целое	Индивидуальная сдача с заказа
has_light_house	true или false	Шашка
has_label	true или false	Наклейка
use_plan_shifts	true или false	Запрет работы вне запланированных смен
fuel_level	Дробное	Уровень топлива в автомобиле
order_params	Массив	Массив параметров экипажа
•	Целое	ИД параметра заказа
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Пример:

Запрос: 

GET https://ip:port/common_api/1.0/get_crew_info?crew_id=1 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "crew_id":1,
    "code":"123",
    "name":"CREW_NAME",
    "driver_id":1,
    "car_id":1,
    "crew_group_id":1,
    "crew_state_id":3,
    "online":true
    "work_shift_sum":0,
    "min_balance":10,
    "common_priority":0,
    "static_priority":0,
    "dynamic_priority":0,
    "rating_priority":0,
    "order_change_id":218,
    "has_light_house":false,
    "has_label":false,
    "order_params":[
      1,
      2,
    ],
    "attribute_values": [
        {
              "id": 1,
              "bool_value": true
        },
        {
              "id": 2,
              "num_value": 1
        },
        {
              "id": 3,
              "num_value": 10
        },
        {
              "id": 4,
              "str_value": "строка"
        }
    ]
  }
}

Запрос информации об экипажах

Метод: GET

Название запроса: get_crews_info

Параметры:

Параметр	Тип	Описание
Необязательные параметры
not_working_crews	true или false	Нужно ли возвращать экипажи не на линии. По умолчанию возвращаются только экипажи на линии
fields	Строка	Список возвращаемых полей через запятую

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
crews_info	Массив	Массив экипажей
• crew_id	Целое	ИД экипажа
• code	Строка	Позывной экипажа
• name	Строка	Наименование экипажа
• driver_id	Целое	ИД водителя
• car_id	Целое	ИД автомобиля
• crew_group_id	Целое	ИД группы экипажа
• crew_state_id	Целое	ИД состояния экипажа
• online	true или false	Водитель подключен к серверу «Связи с водителями»
• work_shift_sum	Дробное	Сумма, списываемая за смену
• min_balance	Дробное	Минимальный баланс, при котором можно выйти на смену
• common_priority	Целое	Общий приоритет
• static_priority	Целое	Статический приоритет
• dynamic_priority	Целое	Динамический приоритет
• rating_priority	Целое	Приоритет по рейтингу
• order_change_id	Целое	Индивидуальная сдача с заказа
• has_light_house	true или false	Шашка
• has_label	true или false	Наклейка
• use_plan_shifts	true или false	Запрет работы вне запланированных смен
• fuel_level	Дробное	Уровень топлива в автомобиле
• order_params	Массив	Массив параметров заказа экипажа
• •	Целое	ИД параметра заказа
• attribute_values	Массив	Массив значений атрибутов
• • id	Целое	Идентификатор атрибута
• • bool_value	true или false	Значение, если тип атрибута «Логический»
• • num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• • str_value	Строка	Значение, если тип атрибута «Строка»

Пример:

Запрос:
GET https://ip:port/common_api/1.0/get_crews_info 
Signature: <...>

Ответ:
{
  "code":0,
  "descr":"OK",
  "data":{
    "crews_info":[
      {
        "crew_id":1,
        "code":"123",
        "name":"CREW_NAME1",
        "driver_id":1,
        "car_id":1,
        "crew_group_id":1,
        "crew_state_id":3
        "online":true,
        "work_shift_sum":0,
        "min_balance":10,
        "common_priority":10,
        "static_priority":10,
        "dynamic_priority":0,
        "rating_priority":0,
        "order_change_id":0,
        "has_light_house":false,
        "has_label":false,
        "use_plan_shifts":false,
        "fuel_level":8.15,
        "order_params":[
          1,
          5,
        ]
      },
      {
        "crew_id":12,
        "code":"777",
        "name":"CREW_NAME2",
        "driver_id":12,
        "car_id":12,
        "crew_group_id":2
        "crew_state_id":1,
        "online":false,
        "work_shift_sum":0,
        "min_balance":10,
        "common_priority":15,
        "static_priority":15,
        "dynamic_priority":0,
        "rating_priority":0,
        "order_change_id":0,
        "has_light_house":false,
        "has_label":true,
        "use_plan_shifts":true,
        "fuel_level":null,
        "order_params":[]
      }
    ]
  }
}

Создание экипажа

Метод: POST

Название запроса: create_crew

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
car_id	Целое	ИД автомобиля
driver_id	Целое	ИД водителя
crew_group_id	Целое	ИД группы экипажа
Необязательные параметры
code	Строка	Позывной экипажа
work_shift_sum	Дробное	Сумма, списываемая за смену
min_balance	Дробное	Минимальный баланс, при котором можно выйти на смену
work_time	Строка	Время работы, формат: “6.00-10.30, 23:00-00:48”
has_light_house	true или false	Шашка
has_label	true или false	Наклейка
use_plan_shifts	true или false	Запрет работы вне запланированных смен
order_params	Массив	Массив параметров экипажа. Устарело. Рекомендуется использовать параметр attribute_values.
•	Целое	ИД параметра
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Специальные возвращаемые коды:

Код	Описание
100	Автомобиль с ИД=ID не найден
101	Водитель с ИД=ID не найден
102	Группа экипажа с ИД=ID не найдена
103	Параметр с ИД=ID не найден или не может быть привязан к экипажу
104	Экипаж с таким водителем и автомобилем уже существует
105	Служба ЕДС автомобиля и водителя не совпадает

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
crew_id	Целое	ИД созданного экипажа

Пример:

Запрос:
POST https://ip:port/common_api/1.0/create_crew HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "car_id":1,
  "driver_id":2,
  "crew_group_id":3,
  "code":"CODE",
  "use_shifts":true,
  "order_params":[3,4],
  "attribute_values": [
      {
            "id": 1,
            "bool_value": true
      },
      {
            "id": 2,
            "num_value": 1
      },
      {
            "id": 3,
            "num_value": 10
      },
      {
            "id": 4,
            "str_value": "строка"
      }
  ]
}

Ответ:
{
  "code":0,
  "descr":"OK",
  "data":{
  "crew_id":1
 }
}

Обновление информации об экипаже

Метод: POST

Название запроса: update_crew_info

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
crew_id	Целое	ИД экипажа
Необязательные параметры
car_id	Целое	ИД автомобиля
driver_id	Целое	ИД водителя
crew_group_id	Целое	ИД группы экипажа
code	Строка	Позывной экипажа
work_shift_sum	Дробное	Сумма, списываемая за смену
min_balance	Дробное	Минимальный баланс, при котором можно выйти на смену
work_time	Строка	Время работы, формат: “6.00-10.30, 23:00-00:48”
has_light_house	true или false	Шашка
has_label	true или false	Наклейка
crew_gps_id	Целое	GPS идентификатор экипажа
use_plan_shifts	true или false	Запрет работы вне запланированных смен
order_params	Массив	Массив параметров экипажа
•	Целое	ИД параметра

Специальные возвращаемые коды:

Код	Описание
100	Автомобиль с ИД=ID не найден
101	Водитель с ИД=ID не найден
102	Группа экипажа с ИД=ID не найдена
103	Параметр с ИД=ID не найден или не может быть привязан к экипажу
104	Экипаж с таким водителем и автомобилем уже существует
105	Служба ЕДС автомобиля и водителя не совпадает
106	Экипаж с ИД=ID не найден
107	Экипаж на линии, запрещено редактирование полей: водитель, автомобиль, позывной, группа экипажа, сумма за смену, минимальный баланс, запрет выхода вне запланированной смены.

Возвращаемые данные в случае успешного выполнения запроса: нет.

Пример:

Запрос:
POST https://ip:port/common_api/1.0/update_crew_info 
Signature: <...>
Content-Type: application/json
Content-Length: 104

{
  "crew_id":1,
  "car_id":1,
  "driver_id":3,
  "crew_group_id":3,
  "code":"CODE",
  "use_plan_shifts":true,
  "order_params":[3,4]
}

Ответ:
{
  "code":0,
  "descr":"OK",
  "data":{}
}

Запрос информации о водителе

Метод: GET

Название запроса: get_driver_info

Параметры:

Параметры	Тип	Описание
Обязательные параметры
driver_id	Целое	ИД водителя
Необязательные параметры
need_photo	true или false	Нужна ли фотография водителя
fields	Строка	Список возвращаемых полей через запятую

Специальные возвращаемые коды:

Код	Описание
100	Водитель не найден

Возвращаемые параметры в случае успешного выполнения запроса:

Параметр	Тип	Описание
driver_id	Целое	ИД водителя
name	Строка	ФИО водителя
balance	Дробное	Баланс основного счета водителя
birthday	ДД.ММ.ГГГГ	День рождения водителя
car_id	Целое	ИД основного автомобиля водителя
license	Строка	Удостоверение водителя
home_phone	Строка	Любой неосновной телефон водителя (устаревшее поле)
mobile_phone	Строка	Основной телефон водителя (устаревшее поле)
is_locked	true или false	Водитель заблокирован
is_dismissed	true или false	Водитель уволен
driver_photo	Base64	Фото водителя (только если need_photo = true)
order_params	Массив	Массив параметров водителя
•	Целое	ИД параметра
phones	Массив	Массив телефонов водителя
• phone	Строка	Номер телефона
• is_default	true или false	Признак основного телефона
• use_for_call	true или false	Использовать для отзвона
term_account	Строка	Терминальный аккаунт
name_for_taxophone	Строка	Имя для TaxoPhone
accounts	Массив	Массив балансов счетов
•account_kind	Целое	Тип счета
•balance	Дробное	Баланс счета
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_driver_info?driver_id=1&need_photo=false 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "driver_id":1,
    "name":"DRIVER_NAME",
    "balance":100,
    "birthday":"01.01.1980",
    "car_id":1,
    "license":"1234567890",
    "home_phone":"79999999999",
    "mobile_phone":"79999999999",
    "is_locked":false,
    "is_dismissed":false,
    "order_params":[3,4],
    "phones":[
      {
        "phone":"79999999999",
        "is_default":true,
        “use_for_call”:true
      },
      {
        "phone":"79999999999",
        "is_default":false,
        “use_for_call”:false
      }
    ],
    "term_account":"00008",
    "name_for_taxophone":"NameForTaxoPhone",
    "accounts":
    [
      {
        "account_kind":0,
        "balance":1000993.00
      },
      {
        "account_kind":1000,
        "balance":600.00
      }
    ],
    "attribute_values": [
        {
              "id": 1,
              "bool_value": true
        },
        {
              "id": 2,
              "num_value": 1
        },
        {
              "id": 3,
              "num_value": 10
        },
        {
              "id": 4,
              "str_value": "строка"
        }
    ]
  }
}

Запрос списка водителей

Метод: GET

Название запроса: get_drivers_info

Параметры:

Параметр	Тип	Описание
Небязательные параметры
locked_drivers	true или false	Включить в ответ запроса заблокированных водителей (по умолчанию false)
dismissed_drivers	true или false	Включить в ответ запроса уволенных водителей (по умолчанию false)
fields	Строка	Список возвращаемых полей через запятую

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
drivers_info	Массив	Массив не удаленных водителей
• driver_id	Целое	ИД водителя
• name	Строка	ФИО водителя
• balance	Дробное	Баланс водителя
• birthday	ДД.ММ.ГГГГ	День рождения водителя
• car_id	Целое	ИД основного автомобиля водителя
• license	Строка	Номер лицензии на перевозку (разрешения на перевозку)
• home_phone	Строка	Любой неосновной телефон водителя (устаревшее поле)
• mobile_phone	Строка	Основной телефон водителя (устаревшее поле)
• is_locked	true или false	Водитель заблокирован
• is_dismissed	true или false	Водитель уволен
• order_params	Массив	Массив параметров водителя
• •	Целое	ИД параметра
• phones	Массив	Массив телефонов водителя
• • phone	Строка	Номер телефона
• • is_default	true или false	Признак основного телефона
• • use_for_call	true или false	Использовать для отзвона
• term_account	Строка	Терминальный аккаунт
• attribute_values	Массив	Массив значений атрибутов
• • id	Целое	Идентификатор атрибута
• • bool_value	true или false	Значение, если тип атрибута «Логический»
• • num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• • str_value	Строка	Значение, если тип атрибута «Строка»

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_drivers_info 
Signature: <...>
locked_drivers=true&dismissed_drivers=true


Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "drivers_info":[
      {
        "driver_id":1,
        "name":"DRIVER_NAME1",
        "balance":100.00,
        "birthday":"01.01.1980",
        "car_id":1,
        "license":"1234567890",
        "home_phone":"79999999999",
        "mobile_phone":"79999999999",
        "is_locked":false,
        "is_dismissed":false,
        "order_params":[3,4],
        "phones":[
          {
            "phone":"79999999999",
            "is_default":true,
            “use_for_call”: true

          },
          {
            "phone":"79999999999",
            "is_default":false,
            “use_for_call”: true

          }
        ],
        "term_account":"00008",
        "attribute_values": [
            {
                  "id": 3,
                  "num_value": 10
            },
            {
                  "id": 4,
                  "str_value": "строка"
            }
        ]
      },
      {
        "driver_id":2,
        "name":"DRIVER_NAME2",
        "balance":-50.00,
        "birthday":"01.01.1980",
        "car_id":2,
        "license":"1234567899",
        "is_locked":true,
        "is_dismissed":true,
        "order_params":[5,6],
        "phones":[
          {
            "phone":"79999999999",
            "is_default":true,
            “use_for_call”: true
          },
          {
            "phone":"79999999999",
            "is_default":false,
            “use_for_call”: false
          }
        ],
        "term_account":"00009",
        "attribute_values": [
            {
                  "id": 3,
                  "num_value": 10
            },
            {
                  "id": 4,
                  "str_value": "строка"
            }
        ]
      }
    ]
  }
}

Создание водителя

Метод: POST

Название запроса: create_driver

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
name	Строка	ФИО водителя
car_id	Целое	ИД основного автомобиля
password	Строка	Пароль (обязательное поле, если используется сервер связи с водителями)
uds_id	Целое	ИД службы ЕДС (обязательное поле, если используется ЕДС, иначе можно не указывать)
Необязательные параметры
home_phone	Строка	Неосновной телефон водителя (устаревший параметр)
mobile_phone	Строка	Основной телефон водителя (устаревший параметр)
passport	Строка	Паспортные данные
driver_license	Строка	Водительское удостоверение
employee_type	Целое	Тип работника (0 - работник компании, 1 - частник)
birthday	ГГГГММДДччммсс	День рождения
number	Строка	Табельный номер
license	Строка	Удостоверение
start_date	ГГГГММДДччммсс	Дата приема на работу
lic_date	ГГГГММДДччммсс	Дата окончания договора
term_account	Строка	Терминальный аккаунт (если не указан, будет сгенерирован автоматически), должен состоять из 5 цифр
comment	Строка	Описание
order_params	Массив	Массив параметров водителя. Устарело. Рекомендуется использовать параметр attribute_values.
•	Целое	ИД параметра
driver_photo	Base64	Фотография водителя
phones	Массив	Массив телефонов водителя
• phone	Строка	Номер телефона
• is_default	true или false	Признак основного телефона
• use_for_call	true или false	Использовать для отзвона
name_for_taxophone	Строка	Имя для TaxoPhone
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Специальные возвращаемые коды:

Код	Описание
100	Автомобиль с ИД=ID не найден
101	Служба ЕДС с ИД=ID не найдена
102	Параметр с ИД=ID не найден или не может быть привязан к водителю
103	Терминальный аккаунт не уникален
104	Некорректный терминальный аккаунт
107	Основной телефон может быть только один
108	Водитель должен иметь основной телефон
109	Пароль водителя не соответствует политике паролей

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
driver_id	Целое	ИД созданного водителя

Пример:

Запрос:
POST https://ip:port/common_api/1.0/create_driver HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "name":"NAME",
  "car_id":140,
  "password":"PASSWORD",
  "birthday":"19930218000000",
  "comment":"COMMENT",
  "order_params":[3,4],
  "name_for_taxophone":"NameForTaxoPhone",
  "phones":[
    {
      "phone":"79999999999",
      "is_default":true,
      “use_for_call”: true
    },
    {
      "phone":"79999999999",
      "is_default":false,
      “use_for_call”: true
    }
  ],
  "attribute_values": [
      {
            "id": 1,
            "bool_value": true
      },
      {
            "id": 2,
            "num_value": 1
      },
      {
            "id": 3,
            "num_value": 10
      },
      {
            "id": 4,
            "str_value": "строка"
      }
  ]
}

Ответ:
{
  "code":0,
  "descr":"OK",
  "data":{
  "driver_id":10
 }
}

Обновление информации о водителе

Метод: POST

Название запроса: update_driver_info

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
driver_id	Целое	ИД редактируемого водителя
Необязательные параметры
name	Строка	ФИО водителя
car_id	Целое	ИД основного автомобиля
password	Строка	Пароль
uds_id	Целое	ИД службы ЕДС (обязательное поле, если используется ЕДС, иначе можно не указывать)
home_phone	Строка	Неосновной телефон водителя (устаревший параметр)
mobile_phone	Строка	Основной телефон водителя (устаревший параметр)
passport	Строка	Паспортные данные
driver_license	Строка	Водительское удостоверение
employee_type	Целое	Тип работника (0 - работник компании, 1 - частник)
birthday	ГГГГММДДччммсс	День рождения
number	Строка	Табельный номер
license	Строка	Удостоверение
start_date	ГГГГММДДччммсс	Дата приема на работу
lic_date	ГГГГММДДччммсс	Дата окончания договора
term_account	Строка	Терминальный аккаунт
comment	Строка	Описание
time_block	ГГГГММДДччммсс	Временная блокировка до
is_locked	true или false	Заблокирован
lock_description	Строка	Причина блокировки
is_dismissed	true или false	Уволен
dismiss_description	Строка	Причина увольнения
order_params	Массив	Массив параметров водителя. Устарело. Рекомендуется использовать параметр attribute_values.
•	Целое	ИД параметра
driver_photo	Base64	Фотография водителя
phones	Массив	Массив телефонов водителя
• phone	Строка	Номер телефона
• is_default	true или false	Признак основного телефона
• use_for_call	true или false	Использовать для отзвона
name_for_taxophone	Строка	Имя для TaxoPhone
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Специальные возвращаемые коды:

Код	Описание
100	Автомобиль с ИД=ID не найден
101	Служба ЕДС с ИД=ID не найдена
102	Параметр с ИД=ID не найден или не может быть привязан к водителю
103	Терминальный аккаунт не уникален
104	Некорректный терминальный аккаунт
105	Водитель с ИД=ID не найден
106	Экипаж на линии, запрещено редактирование полей: основной автомобиль, тип работника, служба ЕДС.
107	Основной телефон может быть только один
108	Водитель должен иметь основной телефон
109	Пароль водителя не соответствует политике паролей

Возвращаемые данные в случае успешного выполнения запроса: нет.

Пример:

Запрос:
POST https://ip:port/common_api/1.0/update_driver_info HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "driver_id":10
  "name":"NAME",
  "car_id":140,
  "password":"PASSWORD",
  "birthday":"19930218000000",
  "comment":"COMMENT",
  "order_params":[3,4],
  "name_for_taxophone":"NameForTaxoPhone",
  "phones":[
    {
      "phone":"79999999999",
      "is_default":true,
      “use_for_call”: true
    },
    {
      "phone":"79999999999",
      "is_default":false,
      “use_for_call”: false
    }
  ],
  "attribute_values": [
      {
            "id": 1,
            "bool_value": true
      },
      {
            "id": 2,
            "num_value": 1
      },
      {
            "id": 3,
            "num_value": 10
      },
      {
            "id": 4,
            "str_value": "строка"
      }
  ]
}
Ответ:
{
  "code":0,
  "descr":"OK",
  "data":{}
}

Запрос информации об автомобиле

Метод: GET

Название запроса: get_car_info

Параметры:

Параметры	Тип	Описание
Обязательные параметры
car_id	Целое	ИД автомобиля
Необязательные параметры
need_photo	true или false	Нужна ли фотография автомобиля
fields	Строка	Список возвращаемых полей через запятую

Специальные возвращаемые коды:

Код	Описание
100	Автомобиль не найден

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
car_id	Целое	ИД автомобиля
code	Строка	Позывной автомобиля
name	Строка	Наименование автомобиля
gos_number	Строка	Государственный номер автомобиля
color	Строка	Цвет автомобиля
mark	Строка	Марка автомобиля
model	Строка	Модель автомобиля
short_name	Строка	Краткое название автомобиля
production_year	Целое	Год выпуска автомобиля
is_locked	true или false	Автомобиль заблокирован
fuel_level	Дробное	Уровень топлива в автомобиле
order_params	Массив	Массив параметров автомобиля. Устарело. Рекомендуется использовать параметр attribute_values.
•	Целое	ИД параметра
car_photo	Base64	Фото автомобиля (только если need_photo = true или поле driver_photo указано в списке фильтра полей fields)
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_car_info?car_id=1&need_photo=false 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "car_id":1,
    "code":"123",
    "name":"CAR_NAME",
    "gos_number":"a123bc",
    "color":"COLOR",
    "mark":"MARK",
    "model":"MODEL",
    "short_name":"SHORT_NAME",
    "production_year":2000,
    "is_locked":false,
    "order_params":[1,2],
    "attribute_values": [
        {
              "id": 1,
              "bool_value": true
        },
        {
              "id": 2,
              "num_value": 1
        },
        {
              "id": 3,
              "num_value": 10
        },
        {
              "id": 4,
              "str_value": "строка"
        }
    ]
  }
}

Запрос списка автомобилей

Метод: GET

Название запроса: get_cars_info

Параметры:

Параметры	Тип	Описание
Необязательные параметры
locked_cars	true или false	Включить в ответ заблокированных автомобилей (по умолчанию false)
fields	Строка	Список возвращаемых полей через запятую

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметры	Тип	Описание
crews_info	Массив	Массив автомобилей
• car_id	Целое	ИД автомобиля
• code	Строка	Позывной автомобиля
• name	Строка	Наименование автомобиля
• gos_number	Строка	Гос. номер автомобиля
• color	Строка	Цвет автомобиля
• mark	Строка	Марка автомобиля
• model	Строка	Модель автомобиля
• short_name	Строка	Краткое название автомобиля
• production_year	Целое	Год выпуска автомобиля
• is_locked	true или false	Автомобиль заблокирован
• fuel_level	Дробное	Уровень топлива в автомобиле
• order_params	Массив	Массив параметров автомобиля. Устарело. Рекомендуется использовать параметр attribute_values.
• •	Целое	ИД параметра
• attribute_values	Массив	Массив значений атрибутов
• • id	Целое	Идентификатор атрибута
• • bool_value	true или false	Значение, если тип атрибута «Логический»
• • num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• • str_value	Строка	Значение, если тип атрибута «Строка»

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_cars_info 
Signature: <...>
locked_cars=true


Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "crews_info":[
      {
        "car_id":1,
        "code":"111",
        "name":"CAR_1",
        "gos_number":"111111",
        "color":"COLOR_1",
        "mark":"MARK_1",
        "model":"MODEL_1",
        "short_name":"SHORT_NAME_1",
        "production_year":2000,
        "is_locked":false,
        "order_params":[1,2],
        "attribute_values": [
            {
                  "id": 1,
                  "bool_value": true
            },
            {
                  "id": 2,
                  "num_value": 1
            }
        ]
      },
      {
        "car_id":2,
        "code":"222",
        "name":"CAR_2",
        "gos_number":"222222",
        "color":"COLOR_2",
        "mark":"MARK_2",
        "model":"MODEL_2",
        "short_name":"SHORT_NAME_2",
        "production_year":2000,
        "is_locked":false,
        "order_params":[3,4],
        "attribute_values": [
            {
                  "id": 3,
                  "num_value": 10
            },
            {
                  "id": 4,
                  "str_value": "строка"
            }
        ]
      }
    ]
  }
}

Создание автомобиля

Метод: POST

Название запроса: create_car

Параметры в формате JSON:

Параметры	Тип	Описание
Обязательные параметры
code	Строка	Позывной
mark	Строка	Марка
color	Строка	Цвет
gos_number	Строка	Государственный номер
uds_id	Целое	ИД службы ЕДС (обязательное поле, если используется ЕДС, иначе можно не указывать)
Необязательные параметры
model	Строка	Модель
short_name	Строка	Краткое название
production_year	Целое	Год выпуска
car_class	Строка	Класс автомобиля (A, B, C, ...)
vin	Строка	VIN
body_number	Строка	Номер кузова
engine_number	Строка	Номер двигателя
permit	Строка	Разрешение на перевозку
comment	Строка	Описание
order_params	Массив	Массив параметров автомобиля. Устарело. Рекомендуется использовать параметр attribute_values.
•	Целое	ИД параметра
car_photo	Base64	Фотография автомобиля
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Специальные возвращаемые коды:

Код	Описание
100	Автомобиль с ИД=ID имеет такой же позывной=CODE
101	Служба ЕДС не найдена
0	Параметр с ИД=ID не найден или не может быть привязан к автомобилю

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
car_id	Целое	ИД созданного автомобиля

Пример:

Запрос:
POST https://ip:port/common_api/1.0/create_car HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "code":"CODE",
  "mark":"MARK",
  "model":"MODEL",
  "color":"BLACK",
  "gos_number":"NUMBER",
  "production_year":2000,
  "comment":"COMMENT",
  "order_params":[1,2,3,4],
  "attribute_values": [
      {
            "id": 1,
            "bool_value": true
      },
      {
            "id": 2,
            "num_value": 1
      },
      {
            "id": 3,
            "num_value": 10
      },
      {
            "id": 4,
            "str_value": "строка"
      }
  ]
}

Ответ:
{
  "code":0,
  "descr":"OK",
  "data":{
  "car_id":140
 }
}

Обновить информацию об автомобиле

Метод: POST

Название запроса: update_car_info

Параметры в формате JSON:

Параметры	Тип	Описание
Обязательные параметры
car_id	Целое	ИД автомобиля
Необязательные параметры
mark	Строка	Марка
color	Строка	Цвет
gos_number	Строка	Государственный номер
model	Строка	Модель
short_name	Строка	Краткое название
production_year	Целое	Год выпуска
car_class	Строка	Класс автомобиля (A, B, C, ...)
vin	Строка	VIN
body_number	Строка	Номер кузова
engine_number	Строка	Номер двигателя
permit	Строка	Разрешение на перевозку
comment	Строка	Описание
order_params	Массив	Массив параметров автомобиля
•	Целое	ИД параметра
is_locked	true или false	Автомобиль заблокирован
lock_description	Строка	Причина блокировки
uds_id	Целое	ИД службы ЕДС
car_photo	Base64	Фотография автомобиля

Специальные возвращаемые коды:

Код	Описание
101	Служба ЕДС не найдена
102	Автомобиль с ИД=ID не найден
103	Экипаж на линии, запрещено редактирование полей: марка, модель, краткое наименование, цвет, гос. номер, служба ЕДС.
104	Параметр с ИД=ID не найден или не может быть привязан к автомобилю

Возвращаемые данные в случае успешного выполнения запроса: нет.

Пример:

Запрос:
POST https://ip:port/common_api/1.0/update_car_info 
Signature: <...>
Content-Type: application/json
Content-Length: 104

{
  "car_id":1,
  "code":"CODE",
  "mark":"MARK",
  "model":"MODEL",
  "color":"BLACK",
  "gos_number":"NUMBER",
  "production_year":2000,
  "comment":"COMMENT",
  "order_params":[3,4]
}

Ответ:
{
  "code":0,
  "descr":"OK",
  "data":{}
}

Запрос координат экипажей

Метод: GET

Название запроса: get_crews_coords

Параметры:

Параметры	Тип	Описание
Необязательные параметры
crew_id	Целое	ИД экипажа, по которому нужно вернуть координаты. Если не задано, то будут возвращены координаты всех экипажей на линии.

Специальные возвращаемые коды:

Код	Описание
100	Координаты не найдены

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
crews_coords	Массив	Список координат экипажей
• crew_id	Целое	ИД экипажа
• crew_code	Строка	Позывной экипажа
• coords_time	ГГГГММДДччммсс	Время получения координат
• lat	Дробное	Долгота
• lon	Дробное	Широта
speed	Целое	Скорость движения, км/ч
direction	Целое	Направление движения (0-Север, 90-Восток, 180-Юг, 270-Запад, -1-не задано)
• state_kind	Строка	Тип состояния экипажа. Может принимать значения: • "not_available" — экипаж не на линии • "waiting" — экипаж свободен, ожидает заказы • "on_order" — экипаж на заказе • "on_break" — экипаж на перерыве

Пример:

Запрос:
GET https://ip:port/common_api/1.0/get_crews_coords 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "crews_coords":[
      {
        "crew_id":1,
        "crew_code":"111",
        "coords_time":"20120101101010",
        "lat":11.111111,
        "lon":22.222222,
        "state_kind":"waiting"
     },
     {
        "crew_id":2,
        "crew_code":"222",
        "coords_time":"20120101101010",
        "lat":33.333333,
        "lon":44.444444,
        "state_kind":"on_order"
      }
    ]
  }
}

Запрос:

GET https://ip:port/common_api/1.0/get_crews_coords?crew_id=1 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "crews_coords":[
      {
        "crew_id":1,
        "crew_code":"111",
        "coords_time":"20120101101010",
        "lat":11.111111,
        "lon":22.222222,
        "state_kind":"waiting"
      }
    ]
  }
}

Запрос адресов, содержащих нужную строку

Метод: GET

Название запроса: get_addresses_like

Параметры:

Параметры	Тип	Описание
Обязательные параметры
get_streets	true или false	Искать улицы
get_points	true или false	Искать пункты
get_houses	true или false	Искать дома. Не может быть равно true, если get_streets = true или get_points = true.
street	Строка	Часть названия улицы или пункта, если идет поиск улиц или пунктов, или полное название улицы, если идет поиск домов
Необязательные параметры
house	Строка	Часть номера дома. Нужно только если get_houses = true.
city	Строка	Город, в котором искать адреса
max_addresses_count	Целое	Максимальное количество адресов в ответе
search_in_tm	true или false	Искать адреса в ТМ (по умолчанию = true)
search_in_yandex	true или false	Искать адреса в Яндекс (по умолчанию = false)
search_in_google	true или false	Искать адреса в Google (по умолчанию = false)
search_in_2gis	true или false	Искать адреса в 2GIS (по умолчанию = false)
search_in_tmgeoservice	true или false	Искать адреса в TMGeoService (по умолчанию = false)
search_in_mapmd	true или false	Искать адреса в Map.md (по умолчанию = false)

Специальные возвращаемые коды:

Код	Описание
100	Подходящие адреса не найдены
101	Не указано место для поиска адресов

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
addresses	Массив	Список подходящих адресов
•address_source	Строка	Источник адреса. Может принимать значения: •"tm" — Такси Мастер (адрес из базы данных или из карты) •"yandex" — Яндекс •"google" — Google •"2gis" — 2GIS •"tmgeoservice" — TMGeoService •"mapmd" - Map.md
• street	Строка	Название улицы или пункта
• house	Строка	Номер дома
• kind	Строка	Тип адреса. Может принимать значения: • "street" — улица • "house" — дом • "point" — пункт
• comment	Строка	Комментарий
• coords	Массив	Координаты дома или пункта
• • lat	Дробное	Широта
• • lon	Дробное	Долгота

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_addresses_like?get_streets=true&get_points=true&
get_houses=false&street=STREE 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "addresses":[
      {
        "street":"STREET1",
        "house":"",
        "kind":"street",
        "comment":""
        "coords":{
        "lat":0,
        "lon":0
        }
      },
      {
        "street":"STREET2",
        "house":"",
        "kind":"street",
        "comment":""
        "coords":{
        "lat":0,
        "lon":0
        }
      },
      {
        "street":"POINT_STREET1",
        "house":"",
        "kind":"point",
        "comment":"Point at street STREET1"
        "coords":{
        "lat":53.224656,
        "lon":56.842521
        }
      }
    ]
  }
}

Запрос:

GET https://ip:port/common_api/1.0/get_addresses_like?get_streets=false&get_points=false&
get_houses=true&street=STREET1&house=1&max_addresses_count=10 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "addresses":[
      {
        "street":"STREET1",
        "house":"1",
        "kind":"house",
        "comment":""
      },
      {
        "street":"STREET1",
        "house":"10",
        "kind":"house",
        "comment":""
      },
      {
        "street":"STREET1",
        "house":"11",
        "kind":"house",
        "comment":""
      }
    ]
  }
}

Запрос адресов, содержащих нужную строку 2

Метод: GET

Название запроса: get_addresses_like2

Параметры:

Параметры	Тип	Описание
Обязательные параметры
get_streets	true или false	Искать улицы
get_points	true или false	Искать пункты
get_houses	true или false	Искать дома
address	Строка	Строка для поиска адреса
Необязательные параметры
city	Строка	Города, разделенные запятой, в которых искать адреса
max_addresses_count	Целое	Максимальное количество адресов в ответе
search_in_tm	true или false	Искать адреса в ТМ (по умолчанию = true)
search_in_yandex	true или false	Искать адреса в Яндекс (по умолчанию = false)
search_in_google	true или false	Искать адреса в Google (по умолчанию = false)
search_in_2gis	true или false	Искать адреса в 2GIS (по умолчанию = false)
search_in_tmgeoservice	true или false	Искать адреса в TMGeoService (по умолчанию = false)
search_in_mapmd	true или false	Искать адреса в Map.md (по умолчанию = false)

Специальные возвращаемые коды:

Код	Описание
100	Подходящие адреса не найдены
101	Не указано место для поиска адресов

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
addresses	Массив	Список подходящих адресов
• address_source	Строка	Источник адреса. Может принимать значения: •"tm" — Такси Мастер (адрес из базы данных или из карты) •"yandex" — Яндекс •"google" — Google •"2gis" — 2GIS •"tmgeoservice" — TMGeoService •"mapmd" - Map.md
• city	Строка	Название города
• point	Строка	Название пункта
• street	Строка	Название улицы
• house	Строка	Номер дома
• kind	Строка	Тип адреса. Может принимать значения: • "street" — улица • "house" — дом • "point" — пункт
• comment	Строка	Комментарий
• coords	Массив	Координаты дома или пункта
• • lat	Дробное	Широта
• • lon	Дробное	Долгота

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_addresses_like2?get_streets=true&get_points=true& get_houses=true&address=STR12 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "addresses":[
      {
        "address_source":"tm",
        "kind":"street",
        "city":"CITY ",
        "point":"",
        "street":"STREET",
        "house":"12",
        "comment":"",
        "coords":{
             "lat":11.11111,
             "lon":22.222222 
        }
      },
      {
         "address_source":"tm",
         "kind":"street",
         "city":"CITY ",
         "point":"",
         "street":"STREET",
         "house":"120",
         "comment":"",
         "coords":{
             "lat":11.11111,
             "lon":22.222222 
        }
      }
    ]
  }
}

Поиск ближайшего адреса

Метод: GET

Название запроса: find_nearest_address

Версия ТМ: 3.12

Параметры:

Параметры	Тип	Описание
Обязательные параметры
lat	Дробное	Широта
lon	Дробное	Долгота
Необязательные параметры
radius	Целое	Радиус в метрах
search_in_tm	true или false	Искать адреса в ТМ (по умолчанию = true)
search_in_google	true или false	Искать адреса в Google (по умолчанию = false)
search_in_tmgeoservice	true или false	Искать адреса в TMGeoService (по умолчанию = false)
search_in_mapmd	true или false	Искать адреса в Map.md (по умолчанию = false)
search_in_2gis	true или false	Искать адреса в 2ГИС (по умолчанию = false)

Специальные возвращаемые коды:

Код	Описание
100	Подходящие адреса не найдены
101	Не указано место для поиска адресов

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
address_source	Строка	Источник адреса. Может принимать значения: "tm" — Такси Мастер (адрес из базы данных или из карты) "google" — Google "tmgeoservice" — TMGeoService "2gis" — 2ГИС "mapmd" — Map.md
city	Строка	Название города
point	Строка	Название пункта
street	Строка	Название улицы
house	Строка	Номер дома
kind	Строка	Тип адреса. Может принимать значения: "street" — улица "house" — дом "point" — пункт
comment	Строка	Комментарий
coords	Массив	Координаты дома или пункта
• lat	Дробное	Широта
• lon	Дробное	Долгота

Пример:

Запрос:

GET https://ip:port/common_api/1.0/find_nearest_address?lat=56.850926&lon=53.212706&radius=100&search_in_tm=false&search_in_google=false&search_in_tmgeoservice=true HTTP/1.1
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":
  {
    "address_source":"tmgeoservice",
    "kind":"house",
    "city":"Ижевск",
    "point":"",
    "street":"Пушкинская ул.",
    "house":"206",
    "comment":"",
    "coords":
    {
      "lat":56.850951,
      "lon":53.212822
    }
  }
}

Анализ маршрута

Метод: GET

Название запроса: analyze_route

Параметры:

Параметры	Тип	Описание
Обязательные параметры
source	Строка	Адрес подачи
dest	Строка	Адрес назначения
Необязательные параметры
source_lon	Дробное	Долгота адреса подачи
source_lat	Дробное	Широта адреса подачи
dest_lon	Дробное	Долгота адреса назначения
dest_lat	Дробное	Широта адреса назначения

Параметр source не является обязательным к заполнению, если заданы source_lon и source_lat.

Параметр dest не является обязательным к заполнению, если заданы dest_lon и dest_lat.

Специальные возвращаемые коды:

Код	Описание
100	Адрес подачи не распознан
101	Адрес назначения не распознан
102	Маршрут не распознан

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
source_lat	Дробное	Широта адреса подачи
source_lon	Дробное	Долгота адреса подачи
source_zone_id	Целое	ИД района подачи
dest_lat	Дробное	Широта адреса назначения
dest_lon	Дробное	Долгота адреса назначения
dest_zone_id	Целое	ИД района назначения
city_dist	Дробное	Километраж по городу
country_dist	Дробное	Километраж за городом
source_country_dist	Дробное	Километраж до адреса подачи, если адрес подачи за городом

Пример:

Запрос:

GET https://ip:port/common_api/1.0/analyze_route?source=STREET1,1&dest=STREET2,2&source_lon=
53.153044&source_lat=56.893301&dest_lon=53.218103&dest_lat=56.869759 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "source_lat":11.111111,
    "source_lon":22.222222,
    "source_zone_id":1,
    "dest_lat":33.333333,
    "dest_lon":44.444444,
    "dest_zone_id":2,
    "city_dist":1.1,
    "country_dist":2.2,
    "source_country_dist":3.3
  }
}

Анализ маршрута 2

Метод: POST

Название запроса: analyze_route2

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
addresses	Массив	Массив адресов. Первый элемент — адрес подачи, последний — адрес назначения, между ними — остановки.
• address	Строка	Адрес подачи
• lat	Дробное	Широта адреса
• lon	Дробное	Долгота адреса
Необязательные параметры
get_full_route_coords	true или false	Возвращать координаты точек полного маршрута (по умолчанию false)
crew_group_id	Целое	ИД группы экипажей

Специальные возвращаемые коды:

Код	Описание
100	Маршрут не распознан

Возвращаемые данные в случае успешного выполнения запроса:

Параметры	Тип	Описание
Addresses	Массив	Массив адресов. Первый элемент — адрес подачи, последний — адрес назначения, между ними — остановки.
• lat	Дробное	Широта адреса
• lon	Дробное	Долгота адреса
• zone_id	Целое	Район адреса
• parking_id	Целое	Стоянка адреса
city_dist	Дробное	Километраж по городу
country_dist	Дробное	Километраж за городом
source_country_dist	Дробное	Километраж до адреса подачи, если адрес подачи за городом.
full_route_coords	Массив	Массив координат точек маршрута.
• lat	Дробное	Широта точки
• lon	Дробное	Долгота точки

Пример:

Запрос:

POST /common_api/1.0/analyze_route2 
Host: ip:port
Keep-Alive: 300
Connection: keep-alive
Content-Type: application/json
Content-Length: 243
Signature: <...>

{"get_full_route_coords":true,"addresses":[{"address":"STREET1, 1","lat":11.111111,
"lon":22.222222},{"address":"STREET2, 2","lat":33.333333,"lon":44.444444},
{"address":"STREET3, 3","lat":55.555555,"lon":55.555555},{"address":"STREET4,
4","lat":77.777777,"lon":88.888888}]}



Ответ:
{
  "code":0,
  "descr":"OK",
  "data":{
     "addresses":[
       {
        "lat":11.111111,
        "lon":22.222222,
        "zone_id":1,
        "parking_id":1
       },
       {
        "lat":33.333333,
        "lon":44.444444,
        "zone_id":2,
        "parking_id":2
       }
     ],
     "city_dist":0,
     "country_dist":2.647,
     "source_country_dist":3.412,
     "full_route_coords":[
       {
        "lat":55.833603,
        "lon":37.515537
       },
       {
        "lat":55.832855,
        "lon":37.516315
       },
       {
        "lat":55.833405,
        "lon":37.51799
       },
       ...
    ]
  }
}

Запрос информации о состоянии заказа

Метод: GET

Название запроса: get_order_state

Параметры:

Параметры	Тип	Описание
Обязательные параметры
order_id	Целое	ИД заказа
Необязательные параметры
fields	Строка	Список возвращаемых полей через запятую

Специальные возвращаемые коды:

Код	Описание
100	Заказ не найден

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
order_id	Целое	ИД заказа
state_id	Целое	ИД состояния заказа
state_kind	Строка	Тип состояния заказа. Может принимать значения: • "new_order" — новый заказ • "driver_assigned" — водитель назначен • "car_at_place" — машина подъехала на место • "client_inside" — клиент в машине • "finished" — заказ успешно завершен • "aborted" — заказ прекращен
crew_id	Целое	ИД экипажа
prior_crew_id	Целое	ИД предварительного экипажа
driver_id	Целое	ИД водителя
car_id	Целое	ИД автомобиля
server_time_offset	Целое	Смещение относительно серверного времени
start_time	ГГГГММДДччммсс	Время создания заказа
source_time	ГГГГММДДччммсс	Время подачи
finish_time	ГГГГММДДччммсс	Время завершения заказа
source	Строка	Адрес подачи
source_lat	Строка	Широта адреса подачи
source_lon	Строка	Долгота адреса подачи
destination	Строка	Адрес назначения
destination_lat	Строка	Широта адреса назначения
destination_lon	Строка	Долгота адреса назначения
stops	Массив	Информация по остановкам заказа
• address	Строка	Адрес остановки
• lat	Дробное	Широта адреса остановки
• lon	Дробное	Долгота адреса остановки
trip_distance	Дробное	Фактический километраж
trip_time	Целое	Фактическое время в пути
customer	Строка	Заказчик
passenger	Строка	Пассажир
phone	Строка	Номер телефона
phone_to_dial	Строка	Номер телефона для отзвона
client_id	Целое	ИД клиента
client_name	Строка	Имя клиента
client_group_id	Целое	ИД группы клиента
client_group_name	Строка	Название группы клиента
client_employee_id	Целое	ИД сотрудника клиента
order_crew_group_id	Целое	ИД группы экипажей, которая указана в заказе
tariff_id	Целое	ИД тарифа
car_mark	Строка	Марка автомобиля
car_model	Строка	Модель автомобиля
car_color	Строка	Цвет автомобиля
car_number	Строка	Государственный номер автомобиля
confirmed	Строка	Состояние подтвержденности заказа водителем или оператором. Может принимать значения: • "not_confirmed" — не подтверждено • "confirmed_by_driver" — заказ принят водителем • "confirmed_by_oper" — заказ подтвержден оператором
crew_coords	Массив	Координаты экипажа
• lat	Дробное	Широта
• lon	Дробное	Долгота
order_params	Массив	Массив параметров заказа экипажа
•	Целое	ИД параметра заказа
creation_way	Строка	Способ создания заказа. Может принимать значения: • "operator" — заказ создан оператором • "sms" — заказ создан через смс • "market" — заказ из биржи • "common_api" — заказ создан через api • "t_api" — заказ создан через api • "taxophone" — заказ создан через таксофон с телефона • "driver" — заказ создан водителем • "daily_order" — ежедневный заказ • "taxophone_web" — заказ создан через таксофон с сайта • "unknown" — неизвестный
is_prior	true или false	Предварительный заказ
is_really_prior	true или false	Предварительный заказ на вкладке "Предварительные"
email	Строка	Email для уведомлений
prior_to_current_before_minutes	Целое	Время перехода из предварительного в текущие заказы, мин
flight_number	Строка	Номер рейса
sum	Дробное	Сумма без скидки
total_sum	Дробное	Итоговая сумма заказа
cash_sum	Дробное	Сумма наличными
cashless_sum	Дробное	Сумма безналичными
bonus_sum	Дробное	Сумма бонусами
bank_card_sum	Дробное	Сумма банковской картой
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»
bill	Массив	Чек TMDriver. Данный узел выводится только, если по заказу есть чек
• code	Строка	Код элемента расчета
• text	Строка	Наименование элемента расчета
• value	Строка	Значение элемента расчета (количество)
• sum	Строка	Стоимость элемента расчета
fact_route	Массив	Фактический маршрут по заказу, выводится только если поле fact_route передали в списке фильтра полей fields
• lat	Дробное	Широта точки маршрута
• lon	Дробное	Долгота точки маршрута
• time	ГГГГММДДччммсс	Время данной точки
• speed	Целое	Скорость в данный момент, км/ч
• direction	Целое	Направление движения, градусы (0 - север, 90 - восток, 180 - юг, 270 - запад)
is_auction	true или false	Признак заказа-аукциона
payment_pay_system	Строка	Тип платежной системы ("card", "gpay", "apple_pay", "qr", "sber_pay", либо пусто, если не используется).

Пример:

Запрос: 

GET https://ip:port/common_api/1.0/get_order_state?order_id=1  
Signature: <...> 

Ответ: 

{
  "code":0,
  "descr":"OK",
  "data":{
    "order_id":1,
    "state_id":12,
    "state_kind":"car_at_place",
    "crew_id":1,
    "prior_crew_id":0,
    "driver_id":2,
    "car_id":3,
    "server_time_offset:0,
    "start_time":"20130117125641",
    "source_time":"20130117132617",
    "finish_time":"20130117130343",
    "source":"30 Лет Победы ул. \/Ижевск\/, 4Б",
    "source_lat":56.863613,
    "source_lon":53.186539,
    "destination":"Кирова ул. \/Ижевск\/, 56",
    "destination_lat":56.862202,
    "destination_lon":53.187485,
    "stops":[
      {
        "address":"30 Лет Победы ул. \/Ижевск\/, 8",
        "lat":56.863388,
        "lon":53.184269
      }
    ],
    "trip_distance":10.5,
    "trip_time":20,
    "customer":"Слепаков",
    "passenger":"Слепаков",
    "phone":"8800",
    "client_id":1,
    "client_employee_id":1,
    "order_crew_group_id":1,
    "tariff_id":1,
    "car_mark":"Ауди",
    "car_model":"Q7",
    "car_color":"черный",
    "car_number":"А777АА",   
    "confirmed":"confirmed_by_oper",
    "crew_coords": {
        "lat": 56.833981,
        "lon": 53.220249
    },
    "order_params":[
      1,
      2,
      5
    ],
    "creation_way":"operator",
    "is_prior":true,
    "is_really_prior":false,
    "email":"mail@mail.ru",
    "prior_to_current_before_minutes":30,
    "flight_number":"A-0501/123",
    "sum":50.5,
    "total_sum":80,
    "cash_sum":20.1,
    "cashless_sum":10,
    "bonus_sum":5.2,
    "bank_card_sum":15,
    "attribute_values": [
        {
              "id": 1,
              "bool_value": true
        },
        {
              "id": 2,
              "num_value": 1
        },
        {
              "id": 3,
              "num_value": 10
        },
        {
              "id": 4,
              "str_value": "строка"
        }
    ],
    "bill":
    [
      {
        "code":"BOARDING",
        "text":"Посадка",
        "value":"",
        "sum":"20,00"
      },
      {
        "code":"TRIP_TIME",
        "text":"Общее время",
        "value":"0:00:00",
        "sum":""
      },
      {
        "code":"TRIP_DIST",
        "text":"Общее расстояние",
        "value":"0,00 км",
        "sum":""
      },
      {
        "code":"BEFORE_DISC",
        "text":"Сумма без скидки",
        "value":"",
        "sum":"20,00"
      },
      {
        "code":"AFTER_DISC",
        "text":"Сумма со скидкой",
        "value":"",
        "sum":"20,00"
      },
      {
        "code":"MINIMUM",
        "text":"Минималка",
        "value":"",
        "sum":"60,00"
      }
    ],
    "fact_route":
    [
      {
        "lat":11.111111,
        "lon":22.222222,
        "time":"20130117132617",
        "speed":123,
        "direction":0
      }
    ],
    "is_auction":false,
    "payment_pay_system": "qr"
  }
}

Создание задачи СМС серверу

Метод: POST

Название запроса: send_sms

Параметры:

Параметры	Тип	Описание
Обязательные параметры
phone	Строка, <= 30 символов	Номер телефона
message	Строка	Текст СМС

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса: нет

Пример:

Запрос:

POST /common_api/1.0/send_sms 
Content-Type: application/x-www-form-urlencoded
Content-Length: 33

Signature: <...>

message=SMSText&phone=89050057216

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{}
}

Проверка авторизации

Метод: GET

Название запроса: check_authorization

Параметры:

Параметры	Тип	Описание
Обязательные параметры
login	Строка, <= 60 символов	Логин
password	Строка, <= 60 символов	Пароль

Специальные возвращаемые коды:

Код	Описание
100	Не найден клиент с логином LOGIN и/или неверный пароль

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
client_id	Целое	ИД клиента

Пример:

Запрос:

GET https://ip:port/common_api/1.0/check_authorization?login=LOGIN&password=PASSWORD 

Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "client_id":131
 }
}

Регистрация клиента

Метод: POST

Название запроса: register_client

Параметры:

Параметры	Тип	Описание
Обязательные параметры
name	Строка, <= 60 символов	ФИО
login	Строка, <= 60 символов	Логин
password	Строка, <= 60 символов	Пароль
phones	Строка	Номера телефонов (через запятую)
Необязательные параметры
client_group	Целое	ИД группы клиента
parent_id	Целое	ИД клиента-родителя
address	Строка	Домашний адрес
birthday	ГГГГММДДччммсс	Дата рождения
gender	Строка	Пол. Может принимать значения: • "male" - мужской • "female" - женский
email	Строка	E-mail
use_email_informing	true или false	Использовать E-mail для отправки уведомлений по заказу
comment	Строка	Комментарий
use_own_account	true или false	Использовать собственный счет для оплаты заказов

Специальные возвращаемые коды:

Код	Описание
100	Клиент с ИД=ID имеет такой же номер телефона=PHONE
101	Клиент с логином=LOGIN уже существует
102	Группа клиента с ИД=CLIENT_GROUP не найдена
103	Клиент указанный в качестве родителя с ИД=PARENT_ID не найден
109	Пароль клиента не соответствует политике паролей

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
client_id	Целое	ИД созданного клиента

Пример:

Запрос:

POST https://ip:port/common_api/1.0/register_client 
Signature: <...>
Content-Type: application/x-www-form-urlencoded
Content-Length: 104
name=NAME&phones=88,99&login=LOGIN&password=PASSWORD&birthday=19930218115517&gender=male&address=ADDRESS&client_group=1&parent_id=10&email=mail%40ya.ru&use_email_informing=true&use_own_account=false


Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "client_id":140
  }
}

Регистрация клиента 2

Метод: POST

Название запроса: register_client2

Версия ТМ: 3.12

Параметры в формате JSON:

Параметры	Тип	Описание
Обязательные параметры
name	Строка, <= 60 символов	ФИО
login	Строка, <= 60 символов	Логин
password	Строка, <= 60 символов	Пароль
phones	Массив	Массив телефонов клиента
• phone	Строка	Номер телефона
• is_default	true или false	Признак основного телефона
Необязательные параметры
client_group_id	Целое	ИД группы клиента
parent_id	Целое	ИД клиента-родителя
address	Строка	Домашний адрес
birthday	ГГГГММДДччммсс	Дата рождения
gender	Строка	Пол. Может принимать значения: • "male" - мужской • "female" - женский
email	Строка	E-mail
use_email_informing	true или false	Использовать E-mail для отправки уведомлений по заказу
comment	Строка	Комментарий
use_own_account	true или false	Использовать собственный счет для оплаты заказов
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Специальные возвращаемые коды:

Код	Описание
100	Дублирование номера телефона=PHONE в списке
101	Клиент с логином=LOGIN уже существует
102	Группа клиента с ИД=CLIENT_GROUP не найдена
103	Клиент указанный в качестве родителя с ИД=PARENT_ID не найден
105	Основной телефон может быть только один
106	Клиент должен иметь основной телефон
107	Атрибут с ИД=ID не найден
108	Атрибут с ИД=ID не может быть привязан к клиенту
109	Пароль клиента не соответствует политике паролей

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
client_id	Целое	ИД созданного клиента

Пример:

Запрос:

POST https://ip:port/common_api/1.0/register_client2 HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "name":"NAME",
  "login":"LOGIN",
  "password":"PASSWORD",
  "phones":[
    {
      "phone":"88",
      "is_default":true
    },
    {
      "phone":"99",
      "is_default":false
    }
  ],
  "address":"ADDRESS",
  "gender":"male",
  "birthday":"20000101000000",
  "client_group_id":1,
  "parent_id":10,
  "email":"mail@ya.ru",
  "use_email_informing":true,
  "comment":"TEXT",
  "use_own_account":false,
  "attribute_values":[
    {
      "id":5,
      "bool_value":true
    },
    {
      "id":7,
      "num_value":10
    },
    {
      "id":9,
      "str_value":"TEST"
    }
  ]
}

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "client_id":140
  }
}

Запрос информации по клиенту

Метод: GET

Название запроса: get_client_info

Параметры:

Параметры	Тип	Описание
Обязательные параметры
client_id	Целое	ИД клиента
Необязательные параметры
fields	Строка	Список возвращаемых полей через запятую. Для полей списка сотрудников, запрашиваемого клиента, названия начинаются с "employees.", например: "employees.name"

Специальные возвращаемые коды:

Код	Описание
100	Не найден клиент ИД=CLIENT_ID

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
client_id	Целое	ИД клиента
parent_id	Целое	ИД клиента-родителя
name	Строка	ФИО
number	Строка	Номер договора
address	Строка	Домашний адрес
gender	Строка	Пол. Может принимать значения: • "" - не указан • "male" - мужской • "female" - женский
birthday	ДД.ММ.ГГГГ	Дата рождения
phones	Массив	Массив телефонов клиента
• phone	Строка	Номер телефона клиента
balance	Дробное	Баланс
bonus_balance	Дробное	Бонусный баланс
login	Строка	Логин
password	Строка	Пароль
client_group_id	Целое	ИД группы клиента
tariff_id	Целое	ИД тарифа клиента или группы клиентов
prize_tariff_id	Целое	ИД призового тарифа клиента или группы клиентов
tariff_shift_id	Целое	ИД смены тарифов клиента или группы клиентов
discount_id	Целое	ИД скидки клиента или группы клиентов
prize_discount_id	Целое	ИД призовой скидки клиента или группы клиентов
min_balance	Дробное	Порог, ниже которого не может опускаться баланс
min_balance_for_use_cashless	Дробное	Минимальный баланс для использования безналичного счета
min_bonus_balance_for_use_bonus	Дробное	Минимальный баланс для использования бонусного счета
is_locked	true или false	Клиент заблокирован
lock_description	Строка	Причина блокировки
use_cashless_account	true или false	Признак использования безналичного счета
use_cashless	true или false	Признак использования безналичного расчета по умолчанию. Имеет смысл только при use_cashless_account = true
no_cash_payment	true или false	Признак запрета использования наличных расчетов. Имеет смысл только при use_cashless_account = true и use_cashless = true
remain_prize	Целое	Сколько заказов осталось до призового
email	Строка	E-mail
use_email_informing	true или false	Использовать E-mail для отправки уведомлений по заказу
default_crew_group	Целое	Группа экипажей по умолчанию
use_own_account	true или false	Использовать собственный счет для оплаты заказа
comment	Строка	Комментарий
employees	Массив	Массив сотрудников клиента. Поля аналогичны полям основного клиента, только у сотрудников отсутствует поле employees
accounts	Массив	Массив счетов клиента. Для сотрудников счета возвращаются, только если их явно запросили в фильтре полей "employees.accounts"
• account_kind	Целое	Тип счета: 0 - Основной счет 1- Бонусный счет Остальные - нестандартные счета
• balance	Дробное	Баланс счета клиента
• balance_with_children	Дробное	Баланс счета клиента с учетом вложенных клиентов
attribute_values	Массив	Массив значений атрибутов. Возвращается, только если явно запросили в фильтре полей "attribute_values" или "employees.attribute_values" для сотрудников
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_client_info?client_id=140 

Signature: <...>

Ответ:

{
  "code": 0,
  "descr": "OK",
  "data": {
    "client_id": 20,
    "parent_id": 0,
    "name": "Юр. лицо1",
    "number": "111",
    "address": "Адрес Юр. лицо1",
    "gender": "",
    "birthday": "22.01.2016",
    "phones": [
      "105",
      "123456789",
      "100"
    ],
    "balance": 10,
    "bonus_balance": 333,
    "login": "111",
    "password": "111",
    "client_group_id": 1,
    "tariff_id": 39,
    "prize_tariff_id": 0,
    "tariff_shift_id": 0,
    "discount_id": 2,
    "prize_discount_id": 0,
    "min_balance": 0,
    "min_balance_for_use_cashless": null,
    "min_bonus_balance_for_use_bonus": null,
    "is_locked": false,
    "lock_description": "",
    "use_cashless_account": true,
    "use_cashless": true,
    "remain_prize": 0,
    "email": "Юр. лицо1@ss.ru",
    "use_email_informing": true,
    "default_crew_group": 6,
    "comment": "Сотрудник СВР. Использовать максимальные скидки",
    "employees": [
      {
        "client_id": 323,
        "parent_id": 20,
        "name": "Сотрудник1",
        "number": "111",
        "address": "Адрес Сотрудник1",
        "gender": "",
        "birthday": null,
        "phones": [
          "11221122112211"
        ],
        "balance": 0,
        "bonus_balance": 0,
        "login": "",
        "password": "",
        "client_group_id": 1,
        "tariff_id": 17,
        "prize_tariff_id": 0,
        "tariff_shift_id": 0,
        "discount_id": 2,
        "prize_discount_id": 0,
        "min_balance": 0,
        "min_balance_for_use_cashless": null,
        "min_bonus_balance_for_use_bonus": null,
        "is_locked": false,
        "lock_description": "",
        "use_cashless": true,
        "remain_prize": 0,
        "email": "Сотрудник1@ss.ru",
        "use_email_informing": true,
        "default_crew_group": 6,
        "accounts": [
          {
            "account_kind": 0,
            "balance": 400.00,
            "balance_with_children": 0.00
          },
          {
            "account_kind": 1,
            "balance": 0.00,
            "balance_with_children": 0.00
          },
          {
            "account_kind": 1003,
            "balance": 100.00,
            "balance_with_children": 0.00
          }
        ],
        "attribute_values": [
          {
            "id": 5,
            "bool_value": true
          },
          {
            "id": 4,
            "bool_value": true
          }
        ]
      }
    ],
    "accounts": [
      {
        "account_kind": 0,
        "balance": 2355.00,
        "balance_with_children": 2755.00
      },
      {
        "account_kind": 1,
        "balance": 0.00,
        "balance_with_children": 0.00
      },
      {
        "account_kind": 1003,
        "balance": -20.00,
        "balance_with_children": 80.00
      }
    ],
    "attribute_values": [
      {
        "id": 4,
        "bool_value": true
      }
    ]
  }
}

Запрос информации по клиентам

Метод: GET

Название запроса: get_clients_info

Версия ТМ: 3.5

Параметры:

Параметры	Тип	Описание
Необязательные параметры
text	Строка	Текст для поиска по названию или по номеру договора клиента
max_clients_count	Целое	Максимальное количество клиентов, которое надо вернуть. Если не указано, то 10.
client_group_id	Целое	Фильтр по группе клиентов
parent_id	Целое	Фильтр по вышестоящему подразделению, возвращаются все подчиненные отделы и сотрудники на всю глубину иерархии
fields	Строка	Список возвращаемых полей через запятую. По умолчанию возвращаются поля "name" и "number". Поле "client_id" возвращается всегда

Специальные возвращаемые коды: Нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметры	Тип	Описание
client_id	Целое	ИД клиента
name	Строка	Наименование
number	Строка	Номер договора
parent_id	Целое	ИД клиента-родителя
address	Строка	Домашний адрес
gender	Строка	Пол. Может принимать значения: • "" - не указан • "male" - мужской • "female" - женский
birthday	ДД.ММ.ГГГГ	Дата рождения
phones	Массив	Массив телефонов клиента
• phone	Строка	Номер телефона клиента
balance	Дробное	Баланс
bonus_balance	Дробное	Бонусный баланс
login	Строка	Логин
password	Строка	Пароль
client_group_id	Целое	ИД группы клиента
tariff_id	Целое	ИД тарифа клиента или группы клиентов
prize_tariff_id	Целое	ИД призового тарифа клиента или группы клиентов
tariff_shift_id	Целое	ИД смены тарифов клиента или группы клиентов
discount_id	Целое	ИД скидки клиента или группы клиентов
prize_discount_id	Целое	ИД призовой скидки клиента или группы клиентов
min_balance	Дробное	Порог, ниже которого не может опускаться баланс
min_balance_for_use_cashless	Дробное	Минимальный баланс для использования безналичного счета
min_bonus_balance_for_use_bonus	Дробное	Минимальный баланс для использования бонусного счета
is_locked	true или false	Клиент заблокирован
lock_description	Строка	Причина блокировки
use_cashless_account	true или false	Признак использования безналичного счета
use_cashless	true или false	Признак использования безналичного расчета по умолчанию. Имеет смысл только при use_cashless_account = true
no_cash_payment	true или false	Признак запрета использования наличных расчетов. Имеет смысл только при use_cashless_account = true и use_cashless = true
remain_prize	Целое	Сколько заказов осталось до призового
email	Строка	E-mail
use_email_informing	true или false	Использовать E-mail для отправки уведомлений по заказу
default_crew_group	Целое	Группа экипажей по умолчанию
use_own_account	true или false	Использовать собственный счет для оплаты заказа
comment	Строка	Комментарий
accounts	Массив	Массив счетов клиента
• account_kind	Целое	Тип счета: 0 - Основной счет 1- Бонусный счет Остальные - нестандартные счета
• balance	Дробное	Баланс счета клиента
• balance_with_children	Дробное	Баланс счета клиента с учетом вложенных клиентов
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_clients_info?text=test&max_clients_count=10&client_group_id=1&parent_id=20&fields=name,number HTTP/1.1
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "clients_info":[
      {
        "client_id":390,
        "name":"tester1",
        "number":"001"
      },
      {
        "client_id":394,
        "name":"tester2",
        "number":"002"
      }
    ]
  }
}

Изменение информации по клиенту

Метод: POST

Название запроса: update_client_info

Параметры:

Параметры	Тип	Описание
Обязательные параметры
client_id	Целое	ИД клиента
Необязательные параметры
name	Строка, <= 60 символов	ФИО
login	Строка, <= 60 символов	Логин
password	Строка, <= 60 символов	Пароль
phones	Строка	Номера телефонов (через запятую)
address	Строка	Домашний адрес
birthday	ГГГГММДДччммсс	Дата рождения
gender	Строка	Пол. Может принимать значения: • "male" - мужской • "female" - женский
parent_id	Целое	ИД клиента-родителя
client_group_id	Целое	ИД группы клиента
email	Строка	E-mail
use_email_informing	true или false	Использовать E-mail для отправки уведомлений по заказу
comment	Строка	Комментарий
use_own_account	true или false	Использовать собственный счет для оплаты заказов

Специальные возвращаемые коды:

Код	Описание
100	Клиент с номером телефона=PHONE уже существует
101	Клиент с ИД=ID имеет такой же номер телефона=PHONE
102	Клиент с логином=LOGIN уже существует
103	Группа клиента с ИД=CLIENT_GROUP_ID не найдена
104	Клиент указанный в качестве родителя с ИД=PARENT_ID не найден
109	Пароль клиента не соответствует политике паролей

Возвращаемые данные в случае успешного выполнения запроса: нет

Пример:

Запрос:

POST https://ip:port/common_api/1.0/update_client_info 
Signature: <...>
Content-Type: application/x-www-form-urlencoded
Content-Length: <...>

client_id=140&name=NAME&phones=88,99&login=LOGIN&password=PASSWORD&birthday=20140901000000&gender=male&address=ADDRESS&parent_id=10&client_group_id=3&email=mail%40ya.ru&use_email_informing=true

Ответ:

{
 "code":0,
  "descr":"OK",
  "data":{}
}

Изменение информации по клиенту 2

Метод: POST

Название запроса: update_client_info2

Версия ТМ: 3.12

Параметры в формате JSON:

Параметры	Тип	Описание
Обязательные параметры
client_id	Целое	ИД клиента
Необязательные параметры
name	Строка, <= 60 символов	ФИО
login	Строка, <= 60 символов	Логин
password	Строка, <= 60 символов	Пароль
phones	Массив	Массив телефонов клиента
• phone	Строка	Номер телефона
• is_default	true или false	Признак основного телефона
client_group_id	Целое	ИД группы клиента
parent_id	Целое	ИД клиента-родителя
address	Строка	Домашний адрес
birthday	ГГГГММДДччммсс	Дата рождения
gender	Строка	Пол. Может принимать значения: • "male" - мужской • "female" - женский
email	Строка	E-mail
use_email_informing	true или false	Использовать E-mail для отправки уведомлений по заказу
comment	Строка	Комментарий
use_own_account	true или false	Использовать собственный счет для оплаты заказов
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Специальные возвращаемые коды:

Код	Описание
100	Клиент с ИД=CLIENT_ID не найден
101	Дублирование номера телефона=PHONE в списке
102	Клиент с логином=LOGIN уже существует
103	Группа клиента с ИД=CLIENT_GROUP_ID не найдена
104	Клиент указанный в качестве родителя с ИД=PARENT_ID не найден
105	Основной телефон может быть только один
106	Клиент должен иметь основной телефон
107	Атрибут с ИД=ID не найден
108	Атрибут с ИД=ID не может быть привязан к клиенту
109	Пароль клиента не соответствует политике паролей

Возвращаемые данные в случае успешного выполнения запроса: нет

Пример:

Запрос:

POST https://ip:port/common_api/1.0/update_client_info2 HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "client_id":140,
  "name":"NAME",
  "login":"LOGIN",
  "password":"PASSWORD",
  "phones":[
    {
      "phone":"88",
      "is_default":true
    }
  ],
  "address":"ADDRESS",
  "gender":"male",
  "birthday":"20000101000000",
  "client_group_id":1,
  "parent_id":10,
  "email":"mail@ya.ru",
  "use_email_informing":true,
  "comment":"TEXT",
  "use_own_account":false,
  "attribute_values":[
    {
      "id":7,
      "num_value":5
    },
    {
      "id":9,
      "str_value":null
    }
  ]
}

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{}
}

Запрос текущих заказов

Метод: GET

Название запроса: get_current_orders

Параметры:

Параметры	Тип	Описание
Необязательные параметры
client_id	Целое	ИД клиента
client_employee_id	Целое	ИД сотрудника (только если указан ИД клиента)
phone	Строка, <= 30 символов	Телефон клиента
crew_id	Целое	ИД экипажа
driver_id	Целое	ИД водителя
fields	Строка	Список возвращаемых полей через запятую

Специальные возвращаемые коды:

Код	Описание
100	Не найден клиент ИД=CLIENT_ID
101	Не найден сотрудник клиента ИД=CLIENT_EMPLOYEE_ID

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
id	Целое	ИД заказа
state_id	Целое	ИД состояния заказа
state_kind	Строка	Тип состояния заказа. Может принимать значения: "new_order" — новый заказ "driver_assigned" — водитель назначен "car_at_place" — машина подъехала на место "client_inside" — клиент в машине "finished" — заказ успешно завершен "aborted" — заказ прекращен
crew_id	Целое	ИД экипажа
prior_crew_id	Целое	ИД предварительного экипажа
driver_id	Целое	ИД водителя
car_id	Целое	ИД автомобиля
server_time_offset	Целое	Смещение относительно серверного времени
start_time	ГГГГММДДччммсс	Дата создания заказа
source_time	ГГГГММДДччммсс	Время подачи
source	Строка	Адрес подачи
source_lat	Строка	Широта адреса подачи
source_lon	Строка	Долгота адреса подачи
destination	Строка	Адрес назначения
destination_lat	Строка	Широта адреса назначения
destination_lon	Строка	Долгота адреса назначения
stops	Массив	Информация по остановкам заказа
• address	Строка	Адрес остановки
• lat	Дробное	Широта адреса остановки
• lon	Дробное	Долгота адреса остановки
customer	Строка	Заказчик
passenger	Строка	Пассажир
phone	Строка	Номер телефона
phone_to_dial	Строка	Номер телефона для отзвона
client_id	Целое	ИД клиента
client_name	Строка	Имя клиента
client_group_id	Целое	ИД группы клиента
client_group_name	Строка	Название группы клиента
client_employee_id	Целое	ИД сотрудника клиента
order_crew_group_id	Целое	ИД группы экипажей, которая указана в заказе
tariff_id	Целое	ИД тарифа
car_mark	Строка	Марка автомобиля
car_model	Строка	Модель автомобиля
car_color	Строка	Цвет автомобиля
car_number	Строка	Гос.номер автомобиля
confirmed	Строка	Состояние подтвержденности заказа водителем или оператором. Может принимать значения: "not_confirmed" — не подтверждено "confirmed_by_driver" — заказ принят водителем "confirmed_by_oper" — заказ подтвержден оператором
crew_coords	Массив	Координаты экипажа
• lat	Дробное	Широта
• lon	Дробное	Долгота
order_params	Массив	Массив параметров заказа экипажа. Устарело. Рекомендуется использовать параметр attribute_values. (Возвращается только если в списке фильтра полей fields запросили поле order_params)
•	Целое	ИД параметра заказа
creation_way	Строка	Способ создания заказа. Может принимать значения: • "operator" — заказ создан оператором • "sms" — заказ создан через смс • "market" — заказ из биржи • "common_api" — заказ создан через api • "t_api" — заказ создан через api • "taxophone" — заказ создан через таксофон с телефона • "driver" — заказ создан водителем • "daily_order" — ежедневный заказ • "taxophone_web" — заказ создан через таксофон с сайта • "unknown" — неизвестный
is_prior	true или false	Предварительный заказ
is_really_prior	true или false	Предварительный заказ на вкладке "Предварительные"
email	Строка	Email для уведомлений
prior_to_current_before_minutes	Целое	Время перехода из предварительного в текущие заказы, мин
flight_number	Строка	Номер рейса
sum	Дробное	Сумма без скидки
total_sum	Дробное	Итоговая сумма заказа
cash_sum	Дробное	Сумма наличными
cashless_sum	Дробное	Сумма безналичными
bonus_sum	Дробное	Сумма бонусами
bank_card_sum	Дробное	Сумма банковской картой
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»
bill	Массив	Чек TMDriver. Данный узел выводится только, если по заказу есть чек и если в списке фильтра полей fields запросили поле bill
• code	Строка	Код элемента расчета
• text	Строка	Наименование элемента расчета
• value	Строка	Значение элемента расчета (количество)
• sum	Строка	Стоимость элемента расчета
is_auction	true или false	Признак заказа-аукциона
payment_pay_system	Строка	Тип платежной системы ("card", "gpay", "apple_pay", "qr", "sber_pay", либо пусто, если не используется)

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_current_orders?client_id=140&phone=18 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "order_id":1,
    "state_id":12,
    "state_kind":"car_at_place",
    "crew_id":1,
    "prior_crew_id":0,
    "driver_id":2,
    "car_id":3,
    "server_time_offset:0,
    "start_time":"20130117125641",
    "source_time":"20130117132617",
    "source":"30 Лет Победы ул. \/Ижевск\/, 4Б",
    "source_lat":56.863613,
    "source_lon":53.186539,
    "destination":"Кирова ул. \/Ижевск\/, 56",
    "destination_lat":56.862202,
    "destination_lon":53.187485,
    "stops":[
      {
        "address":"30 Лет Победы ул. \/Ижевск\/, 8",
        "lat":56.863388,
        "lon":53.184269
      }
    ],
    "customer":"Слепаков",
    "passenger":"Слепаков",
    "phone":"8800",
    "client_id":1,
    "client_employee_id":1,
    "order_crew_group_id":1,
    "tariff_id":1,
    "car_mark":"Ауди",
    "car_model":"Q7",
    "car_color":"черный",
    "car_number":"А777АА",   
    "confirmed":"confirmed_by_oper",
    "crew_coords": {
        "lat": 56.833981,
        "lon": 53.220249
    },
    "order_params":[
      1,
      2,
      5
    ],
    "creation_way":"operator",
    "is_prior":true,
    "is_really_prior":false,
    "email":"mail@mail.ru",
    "prior_to_current_before_minutes":30,
    "flight_number":"A-0501/123",
    "sum":50.5,
    "total_sum":80,
    "cash_sum":20.1,
    "cashless_sum":10,
    "bonus_sum":5.2,
    "bank_card_sum":15,
    "attribute_values": [
        {
              "id": 1,
              "bool_value": true
        },
        {
              "id": 2,
              "num_value": 1
        },
        {
              "id": 3,
              "num_value": 10
        },
        {
              "id": 4,
              "str_value": "строка"
        }
    ],
    "bill":
    [
      {
        "code":"BOARDING",
        "text":"Посадка",
        "value":"",
        "sum":"20,00"
      },
      {
        "code":"TRIP_TIME",
        "text":"Общее время",
        "value":"0:00:00",
        "sum":""
      },
      {
        "code":"TRIP_DIST",
        "text":"Общее расстояние",
        "value":"0,00 км",
        "sum":""
      },
      {
        "code":"BEFORE_DISC",
        "text":"Сумма без скидки",
        "value":"",
        "sum":"20,00"
      },
      {
        "code":"AFTER_DISC",
        "text":"Сумма со скидкой",
        "value":"",
        "sum":"20,00"
      },
      {
        "code":"MINIMUM",
        "text":"Минималка",
        "value":"",
        "sum":"60,00"
      }
    ]
        "is_auction":false,
        "payment_pay_system":"qr"
  }
}

Запрос выполненных заказов

Метод: GET

Название запроса: get_finished_orders

Параметры:

Параметры	Тип	Описание
Обязательные параметры
start_time	ГГГГММДДччммсс	Начало периода
finish_time	ГГГГММДДччммсс	Конец периода
Необязательные параметры
Примечание: должен присутствовать хотя бы один параметр из client_id, phone, crew_id, driver_id.
client_id	Целое	ИД клиента
client_employee_id	Целое	ИД сотрудника (только если указан ИД клиента)
phone	Строка, <= 30 символов	Телефон клиента
crew_id	Целое	ИД экипажа
driver_id	Целое	ИД водителя
state_type	Строка	Тип состояния заказа. Может принимать значения: • "all" — все • "finished" — выполненные • "aborted" — прекращенные
state_ids	Строка	Список состояний заказа через точку с запятой, пример: «1;2;3»
fields	Строка	Список возвращаемых полей через запятую

Примечание: должен присутствовать хотя бы один параметр из client_id, phone, crew_id, driver_id.

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
id	Целое	ИД заказа
state_id	Целое	ИД состояния заказа
crew_id	Целое	ИД экипажа
prior_crew_id	Целое	ИД предварительного экипажа
driver_id	Целое	ИД водителя
car_id	Целое	ИД автомобиля
server_time_offset	Целое	Смещение относительно серверного времени
start_time	ГГГГММДДччммсс	Время создания заказа
source_time	ГГГГММДДччммсс	Время подачи
finish_time	ГГГГММДДччммсс	Время завершения заказа
source	Строка	Адрес подачи
source_lat	Дробное	Широта адреса подачи
source_lon	Дробное	Долгота адреса подачи
destination	Строка	Адрес назначения
destination_lat	Дробное	Широта адреса назначения
destination_lon	Дробное	Долгота адреса назначения
stops	Массив	Массив адресов остановок
• address	Строка	Адрес остановки
• lat	Дробное	Широта адреса остановки
• lon	Дробное	Долгота адреса остановки
trip_distance	Дробное	Фактический километраж
trip_time	Целое	Фактическое время в пути
customer	Строка	Заказчик
passenger	Строка	Пассажир
phone	Строка	Номер телефона
phone_to_dial	Строка	Номер телефона для отзвона
client_id	Целое	ИД клиента
client_name	Строка	Имя клиента
client_group_id	Целое	ИД группы клиента
client_group_name	Строка	Название группы клиента
client_employee_id	Целое	ИД сотрудника клиента
order_crew_group_id	Целое	ИД группы экипажей, которая указана в заказе
tariff_id	Целое	ИД тарифа
car_mark	Строка	Марка автомобиля
car_model	Строка	Модель автомобиля
car_color	Строка	Цвет автомобиля
car_number	Строка	Гос.номер автомобиля
order_params	Массив	Массив параметров заказа экипажа. Устарело. Рекомендуется использовать параметр attribute_values. (Возвращается только если в списке фильтра полей fields запросили поле order_params)
•	Целое	ИД параметра заказа
creation_way	Строка	Способ создания заказа. Может принимать значения: • "operator" — заказ создан оператором • "sms" — заказ создан через смс • "market" — заказ из биржи • "common_api" — заказ создан через api • "t_api" — заказ создан через api • "taxophone" — заказ создан через таксофон с телефона • "driver" — заказ создан водителем • "daily_order" — ежедневный заказ • "taxophone_web" — заказ создан через таксофон с сайта • "unknown" — неизвестный
is_prior	true или false	Предварительный заказ
email	Строка	Email для уведомлений
flight_number	Строка	Номер рейса
sum	Дробное	Стоимость заказа без учета скидок (наценок)
total_sum	Дробное	Итоговая стоимость заказа
cash_sum	Дробное	Заплачено наличными
cashless_sum	Дробное	Заплачено с безналичного счета клиента
bonus_sum	Дробное	Заплачено с бонусного счета клиента
bank_card_sum	Дробное	Заплачено банковской картой
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»
bill	Массив	Чек TMDriver. Данный узел выводится только, если по заказу есть чек и если в списке фильтра полей fields запросили поле bill
• code	Строка	Код элемента расчета
• text	Строка	Наименование элемента расчета
• value	Строка	Значение элемента расчета (количество)
• sum	Строка	Стоимость элемента расчета
is_auction	true или false	Признак заказа-аукциона
payment_pay_system	Строка	Тип платежной системы ("card", "gpay", "apple_pay", "qr", "sber_pay", либо пусто, если не используется)

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_finished_orders?start_time=20220405142210&finish_time=20220405142710&fields=state_id,crew_id,prior_crew_id,driver_id,car_id,server_time_offset,start_time,source_time,finish_time,source,source_lat,source_lon,destination,destination_lat,destination_lon,stops,trip_distance,trip_time,customer,passenger,phone,phone_to_dial,client_id,client_name,client_group_id,client_group_name,client_employee_id,order_crew_group_id,tariff_id,order_params,attribute_values,creation_way,is_prior,email,flight_number,sum,total_sum,cash_sum,cashless_sum,bonus_sum,bank_card_sum,car_mark,car_model,car_color,car_number,bill

Ответ:
{
  "code":0,
  "descr":"OK",
  "data":
  {
    "orders":
    [
      {
        "id":47834,
        "state_id":4,
        "crew_id":17,
        "prior_crew_id":0,
        "driver_id":17,
        "car_id":16,
        "server_time_offset":0,
        "start_time":"20220405142418",
        "source_time":"20220405142418",
        "finish_time":"20220405142708",
        "source":"5-Я ЯМСКОГО ПОЛЯ УЛ., 37",
        "source_lat":56.853062,
        "source_lon":53.20715,
        "destination":"ХОДЫНСКАЯ УЛ., 10А",
        "destination_lat":0,
        "destination_lon":0,
        "stops":
        [],
        "trip_distance":10,
        "trip_time":3600,
        "customer":"Client 89872977005",
        "passenger":"",
        "phone":"89872977005",
        "phone_to_dial":"",
        "client_id":43111,
        "client_name":"Client 89872977005",
        "client_group_id":2,
        "client_group_name":"Физические",
        "client_employee_id":0,
        "order_crew_group_id":0,
        "tariff_id":2,
        "order_params":
        [
          28,
          29,
          30,
          55,
          58,
          59,
          62
        ],
        "attribute_values":
        [
          {
            "id":28,
            "num_value":0
          },
          {
            "id":29,
            "num_value":0
          },
          {
            "id":30,
            "num_value":0
          },
          {
            "id":55,
            "num_value":1
          },
          {
            "id":58,
            "num_value":0
          },
          {
            "id":59,
            "num_value":0
          },
          {
            "id":62,
            "num_value":0
          }
        ],
        "creation_way":"operator",
        "is_prior":false,
        "email":"",
        "flight_number":"",
        "sum":100,
        "total_sum":100,
        "cash_sum":50,
        "cashless_sum":40,
        "bonus_sum":10,
        "bank_card_sum":0,
        "car_mark":"Баф",
        "car_model":"Fenix 3346",
        "car_color":"белая",
        "car_number":"а111аа",
        "is_auction":false,
        "payment_pay_system": "qr"
      }
    ]
  }
}

Проведение операции по клиенту

Метод: POST

Название запроса: create_client_operation

Параметры:

Параметры	Тип	Описание
Обязательные параметры
client_id	Целое	ИД клиента
sum	Дробное	Сумма
oper_type	Целое	Тип операции: • "receipt" - приход • "expense" - расход
Необязательные параметры
oper_time	ГГГГММДДччммсс	Время создания операции (если не указано, текущее)
comment	Строка	Комментарий
pay_type	Целое	Тип оплаты: • "cash" - наличный • "nocash" - безналичный
bonus_oper	true или false	Операция по бонусному счёту. Данный параметр устарел - рекомендуется использовать "account_kind"
account_kind	Целое	Тип счета: 0 - Основной счет 1- Бонусный счет Остальные - нестандартные счета

Специальные возвращаемые коды:

Код	Описание
100	Не найден клиент ИД=CLIENT_ID
101	Не найден тип счета ИД=ACCOUNT_KIND

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
oper_id	Целое	ИД операции

Пример:

Запрос:

POST https://ip:port/common_api/1.0/create_client_operation 
Signature: <...>
Content-Type: application/x-www-form-urlencoded
Content-Length: <...>

client_id=112&oper_time=20130221100719&oper_sum=300&oper_type=receipt&pay_type=cash&comment=COMMENT&account_kind=0

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "oper_id":31

  }
}

Запрос операций по клиенту

Метод: GET

Название запроса: get_client_operations

Параметры:

Параметры	Тип	Описание
Обязательные параметры
client_id	Целое	ИД клиента
start_time	ГГГГММДДччммсс	Начало периода
finish_time	ГГГГММДДччммсс	Конец периода
Необязательные параметры
account_kind	Целое	Тип счета: 0 - Основной счет 1- Бонусный счет Остальные - нестандартные счета

Специальные возвращаемые коды:

Код	Описание
100	Не найден клиент ИД=CLIENT_ID
101	Не найден тип счета ИД=ACCOUNT_KIND

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
oper_id	Целое	ИД операции
oper_time	ГГГГММДДччммсс	Время создания операции
sum	Дробное	Сумма
order_id	Целое	Заказ, связанный с операцией
oper_type	Целое	Тип операции: • "receipt" - приход • "expense" - расход
pay_type	Целое	Тип оплаты: • "cash" - наличный • "nocash" - безналичный
account_kind	Целое	Тип счета: 0 - Основной счет 1- Бонусный счет Остальные - нестандартные счета
name	Строка	Наименование
comment	Строка	Комментарий
cancelled_by_oper_id	Целое	ИД операции отмены (для отмененной операции)
cancelled_oper_id	Целое	ИД отмененной операции (для операции отмены)

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_client_operations?client_id=112&start_time=20130201092112&finish_time=20130221092112&account_kind=0 HTTP/1.1
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "operations":[
      {
        "oper_id":111,
        "oper_time":"20130219091328",
        "sum":"21,8",
        "order_id":11800,
        "oper_type":"receipt",
        "pay_type":"cash",
        "account_kind":0,
        "name":"Пополнение счета",
        "comment":"Комментарий",
        "cancelled_by_oper_id":0,
        "cancelled_oper_id":112
      },
      {
        "oper_id":112,
        "oper_time":"20130220112245",
        "sum":"4500",
        "order_id":11801,
        "oper_type":"receipt",
        "pay_type":"cash",
        "account_kind":0,
        "name":"Пополнение счета",
        "comment":"Комментарий"
        "cancelled_by_oper_id":111,
        "cancelled_oper_id":0
      }
    ]
  }
}

Проведение операции по водителю

Метод: POST

Название запроса: create_driver_operation

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
driver_id	Целое	ИД водителя
oper_sum	Дробное	Сумма
oper_type	Строка	Тип операции: • receipt - приход • expense - расход
Необязательные параметры
name	Строка	Наименование операции
oper_time	ГГГГММДДччммсс	Время создания операции (если не задано, текущее)  !! Не используется с ТМ 3.7
comment	Строка	Комментарий
account_kind	Целое	ИД типа счета (0 - основной счет), по умолчанию 0

Специальные возвращаемые коды:

Код	Описание
100	Водитель не найден ИД=DRIVER_ID
101	Не найден тип счета ИД=ACCOUNT_KIND

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
oper_id	Целое	ИД операции

Пример:

Запрос:

POST https://ip:port/common_api/1.0/create_driver_operation 
Signature: <...>
Content-Type: application/json
Content-Length: 99

{
   "driver_id": 1,
   "oper_sum": 10.00,
   "oper_type": "receipt",
   "name": "Пополнение счета",
   "oper_time": "20141210100719",
   "comment": "Комментарий к операции"
    "account_kind": 1
}

Ответ:

{
   "code":0,
   "descr":"OK",
   "data":{
   "oper_id":31
   }
}

Запрос операций по водителю

Метод: GET

Название запроса: get_driver_operations

Параметры:

Параметр	Тип	Описание
Обязательные параметры
driver_id	Целое	ИД водителя
start_time	ГГГГММДДччммсс	Начало периода
finish_time	ГГГГММДДччммсс	Конец периода
Необязательные параметры
account_kind	Целое	ИД типа счета (0 - основной счет), по умолчанию 0

Специальные возвращаемые коды:

Код	Описание
100	Не найден водитель ИД=DRIVER_ID
101	Не найден тип счета ИД=ACCOUNT_KIND

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
oper_id	Целое	ИД операции
oper_time	ГГГГММДДччммсс	Время создания операции
sum	Дробное	Сумма
order_id	Целое	Заказ, связанный с операцией
oper_type	Целое	Тип операции: •"receipt" - приход •"expense" - расход
name	Строка	Наименование
comment	Строка	Комментарий
account_kind	Целое	ИД типа счета
cancelled_by_oper_id	Целое	ИД операции отмены (для отмененной операции)
cancelled_oper_id	Целое	ИД отмененной операции (для операции отмены)

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_driver_operations?
driver_id=112&start_time=20130201092112&finish_time=20130221092112 
Signature: <...>

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "operations":[
      {
        "oper_id":111,
        "oper_time":"20130219091328",
        "sum":"21,8",
        "order_id":11800,
        "oper_type":"receipt",
        "name":"DRIVER_OPERATION_1",
        "comment":"DRIVER_OPERATION_COMMENT_1",
        "account_kind":0,
        "cancelled_by_oper_id":0,
        "cancelled_oper_id":112
      },
      {
        "oper_id":112,
        "oper_time":"20130220112245",
        "sum":"4500",
        "order_id":11801,
        "oper_type":"receipt",
        "name":"DRIVER_OPERATION_2",
        "comment":"DRIVER_OPERATION_COMMENT_2",
        "account_kind":0,
        "cancelled_by_oper_id":111,
        "cancelled_oper_id":0
      }
    ]
  }
}

Назначение динамического приоритета водителю

Метод: POST

Название запроса: create_driver_dyn_priority

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
driver_id	Целое	ИД водителя (должно быть что-то одно: либо driver_id, либо crew_id)
crew_id	Целое	ИД экипажа (должно быть что-то одно: либо driver_id, либо crew_id)
priority	Целое	Приоритет
start_time	ГГГГММДДччммсс	Время начала действия приоритета
finish_time	ГГГГММДДччммсс	Время окончания действия приоритета
name	Строка	Наименование приоритета

Специальные возвращаемые коды:

Код	Описание
100	Водитель не найден ИД=DRIVER_ID
101	Экипаж не найден ИД=CREW_ID
102	Время начала действия приоритета должно быть меньше времени окончания
103	Время действия приоритета уже истекло

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
dyn_priority_id	Целое	ИД созданного динамического приоритета

Пример:

Запрос:
POST https://ip:port/common_api/1.0/create_driver_dyn_priority 
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
   "driver_id": 1,
   "priority": 10,
   "start_time": "20150101100000",
   "finish_time": "20150101200000",
   "name": "За выполнение заказа в отдаленный район"
}

Ответ:

{
   "code":0,
   "descr":"OK",
   "data":{
   "dyn_priority_id":123
   }
}

Задание координат экипажей

Метод: POST

Название запроса: set_crews_coords

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
crew_coords	Массив	Массив координат экипажей
• crew_id	Целое	ИД экипажа
• gps_id	Целое	GPS идентификатор (если не задан ИД экипажа). Данный параметр устарел - не применяется, начиная с версии 3.9
• lat	Дробное	Широта
• lon	Дробное	Долгота
Необязательные параметры
speed	Дробное	Скорость
direction	Целое	Направление движения (0-Север, 90-Восток, 180-Юг, 270-Запад, -1-не задано)

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса: нет

Пример:

Запрос:

POST https://ip:port/common_api/1.0/set_crews_coords HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "crews_coords":[
    {
      "crew_id":1,
      "lat":11.111111,
      "lon":22.222222,
      "speed":66.66,
      "direction":333
    },
    {
      "gps_id":2,
      "lat":33.333333,
      "lon":44.444444
    }
  ]
}

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{}
}

Изменение информации по заказу

Метод: POST

Название запроса: update_order

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
order_id	Целое	ИД заказа
Необязательные параметры
phone	Строка, <= 30 символов	Номер телефона
source_time	ГГГГММДДччммсс	Время подачи
is_prior	true или false	Предварительный заказ
customer	Строка	Заказчик
passenger	Строка	Пассажир
comment	Строка	Комментарий
crew_group_id	Целое	ИД группы экипажей
client_id	Целое	ИД клиента
uds_id	Целое	ИД службы ЕДС
tariff_id	Целое	ИД тариф
addresses	Массив	Массив адресов. Первый элемент — адрес подачи(обязательно), последний — адрес назначения, между ними — остановки.
• address	Строка	Адрес подачи
• lat	Дробное	Широта адреса
• lon	Дробное	Долгота адреса
order_params	Массив	Массив параметров заказа. Устарело. Рекомендуется использовать параметр attribute_values.
•	Целое	ИД параметра заказа
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»
cost_order	Дробное	Сумма заказа
state_id	Целое	ИД состояния заказа
discount_id	Целое	ИД скидки
auto_select_discount	true или false	Автоматически подобрать скидку, если не указана явно
auto_select_tariff	true или false	Автоматически подобрать тариф, если не указан явно
auto_recalc_cost	true или false	Автоматически пересчитать сумму заказа
auto_update_order_params	true или false	Автоматически обновить параметры заказа по клиенту и группе клиента
email	Строка	Email для уведомлений
prior_to_current_before_minutes	Целое	Время перехода из предварительного в текущие заказы, мин
flight_number	Строка	Номер рейса
need_custom_validate	true или false	Использовать специальную проверку перед изменением заказа

Специальные возвращаемые коды:

Код	Описание
100	Заказ не найден
101	Состояние заказа не найдено
102	Тариф не найден
103	Скидка не найдена
104	Группа экипажа не найдена
105	Служба не найдена
106	Клиент не найден
107	Изменение состояния не соответствует необходимым условиям
108	Параметр заказа не найден
109	Атрибут не может быть привязан к заказу
110	Ошибка специальной проверки заказа перед изменением. В ответе будет возвращаться: "data": { "message":"Текст ошибки для пользователя." }
111	Недостаточно средств на безналичном счете клиента в ТМ
112	Для клиента запрещена оплата заказа наличными. Клиент должен максимально использовать в заказе безналичную оплату (оплату с основного счета)

Возвращаемые данные в случае успешного выполнения запроса: нет.

Пример:

POST https://ip:port/common_api/1.0/update_order HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
    "order_id": 12105,
    "phone": "555",
    "source_time": "20141216095044",
    "is_prior": true,
    "auto_select_discount": true,
    "auto_select_tariff": true,
    "auto_recalc_cost": true,
    "auto_update_order_params": true,
    "customer": "Заказчик",
    "passenger": "Пассажир",
    "comment": "Комментарий",
    "crew_group_id": 8,
    "client_id": 30,
    "tariff_id": 33,
    "addresses":[
       {"address":"SOURCE","lat":56.896817,"lon":53.147830},       
       {"address":"STOP1","lat":56.845452,"lon":53.226775},
       {"address":"STOP2"}, 
       {"address":"DESTINATION","lat":56.861230,"lon":53.241870}
    ],
    "cost_order": 200,
    "state_id": 55,
    "discount_id": 1,
    "email" : "mail@mail.ru",
    "prior_to_current_before_minutes":30,
    "flight_number":"Number",
    "need_custom_validate":false,
    "attribute_values": [
      {
            "id": 1,
            "bool_value": true
      },
      {
            "id": 2,
            "num_value": 1
      },
      {
            "id": 3,
            "num_value": 10
      },
      {
            "id": 4,
            "str_value": "строка"
      }
  ]
}

Ответ:
{
  "code":0,
  "descr":"OK",
  "data":{}
}

Анализ телефона

Метод: GET

Название запроса: analyze_phone

Параметры:

Параметр	Тип	Описание
Обязательные параметры
phone	Строка	Номер телефона
Необязательные параметры
search_in_drivers_mobile	true или false	Искать среди телефонов водителей
search_in_clients	true или false	Искать среди телефонов клиентов
search_in_phones	true или false	Искать в справочнике телефонов

Если параметры search_in_drivers_mobile, search_in_clients, search_in_phones не заданы, то поиск телефона будет происходить во всех справочниках.

Специальные возвращаемые коды:

Код	Описание
100	Телефон не найден

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
phone_type	Строка	Может принимать значения: «driver_mobile», «client», «phone».
id	Целое	ИД водителя, клиента, телефона из справочника.
client_employee_id	Целое	ИД сотрудника клиента (если телефон найден среди телефонов клиента)

Пример:

Запрос:

GET /common_api/1.0/analyze_phone?
phone=89501234567&search_in_drivers_mobile=true&search_in_drivers_home=true&search_in_clients=true&
search_in_phones=true 

Host: 127.0.0.1:8089
Keep-Alive: 300
Connection: keep-alive
Signature: 4285286a446064353f4a951b721c54f7

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
  "phone_type":"client",
  "id":1
  "client_employee_id":2
   }
}

Показать сообщение в ТМ

Метод: POST

Название запроса: show_tm_message

Параметры:

Параметр	Тип	Описание
Обязательные параметры
text	Строка	Текст сообщения
Необязательные параметры
type	Строка	Тип сообщения ("warning", "error", "information", "confirmation"), по умолчанию "information"
header	Строка	Заголовок сообщения
timeout	Целое	Скрывать сообщение через, сек. (0 — не скрывать)
users	Массив	Массив пользователей (если не указаны — отправлять всем)
•	Целое	ИД пользователя
color	Строка	Цвет уведомления в формате RGB: #FFFFFF
order_id	Целое	ИД заказа для кнопки открытия карточки в уведомлении
car_id	Целое	ИД автомобиля для кнопки открытия карточки в уведомлении
driver_id	Целое	ИД водителя для кнопки открытия карточки в уведомлении
crew_id	Целое	ИД экипажа для кнопки открытия карточки в уведомлении
client_id	Целое	ИД клиента для кнопки открытия карточки в уведомлении

Специальные возвращаемые коды:

Код	Описание
100	Пользователи для отправки сообщения не найдены

Возвращаемые данные в случае успешного выполнения запроса: нет.

Пример:

Запрос:

POST https://ip:port/common_api/1.0/show_tm_message HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
    "text": "Текст сообщения",
    "type": "warning",
    "users": [
        1,
        2,
        3
    ],
    "header": "Заголовок",
    "timeout": 12,
    "color":"#FFFF80",
    "car_id":55
}


Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{}
}

Запрос списка купленных смен водителей

Метод: GET

Название запроса: get_driver_shifts

Параметры:

Параметр	Тип	Описание
Обязательные параметры
start_time	ГГГГММДДччммсс	Начало периода
finish_time	ГГГГММДДччммсс	Конец периода
Необязательные параметры
driver_id	Целое	ИД водителя
new_shifts	true или false	Включить в ответ новые смены (по умолчанию true)
in_work_shifts	true или false	Включить в ответ смены в работе (по умолчанию true)
finished_shifts	true или false	Включить в ответ выполненные смены (по умолчанию true)
failed_shifts	true или false	Включить в ответ неуспешно завершенные смены (по умолчанию true)
returned_shifts	true или false	Включить в ответ возвращенные смены (по умолчанию false)

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
shifts	Массив	Массив купленных смен
• shift_id	Целое	ИД купленной смены
• driver_id	Целое	ИД водителя
•driver_name	Строка	ФИО водителя
• plan_shift_id	Строка	ИД запланированной смены
• plan_shift_name	Строка	Наименование запланированной смены
• plan_shift_cost	Дробное	Цена смены
• plan_shift_type	Строка	Тип смены («limited» - срочная, «unlimited» - бессрочная)
• plan_shift_start_time	ГГГГММДДччммсс	План-начало смены (для срочных)
• plan_shift_finish_time	ГГГГММДДччммсс	План-конец смены (для срочных)
• plan_shift_length	Целое	План продолжительность смены, ч. (для бессрочных)
• plan_shift_crew_group_id	Целое	ИД первой группы экипажей, которая может купить смену
• plan_shift_crew_groups	Массив	ИД групп экипажей, которые могут купить смену
• shift_state	Строка	Состояние смены («new» - новая, «in_work» - в работе, «finished» - завершена успешно, «failed» - завершена неуспешно)
• buy_time	ГГГГММДДччммсс	Время продажи смены водителю
• is_returned	true или false	Признак возвращенной смены
• return_time	ГГГГММДДччммсс	Время возврата смены
• orders_count	Целое	Количество заказов, выполненных водителем за смену
• orders_sum	Дробное	Сумма заказов, выполненных водителем за смену
• fact_length	Дробное	Фактическая продолжительность смены, ч.

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_driver_shifts?start_time=20140101101010&finish_time=20140101202020 
Signature: <...>


Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "shifts":[
      {
        "shift_id":1,
        "driver_id":1,
        "driver_name":"DRIVER_1",
        "plan_shift_id":1,
        "plan_shift_name":"PLAN_SHIFT_1",
        "plan_shift_cost":100,
        "plan_shift_type":"limited",
        "plan_shift_start_time":"20140101101010",
        "plan_shift_finish_time":"20140101101010",
        "plan_shift_length":null,
        "plan_shift_crew_group_id":1,
        "shift_state":new,
        "buy_time":"20140101101010",
        "is_returned":false,
        "return_time":null,
        "orders_count":10,
        "orders_sum":1000,
        "fact_length":1.2
      },
      {
        "shift_id":2,
        "driver_id":2,
        "driver_name":"DRIVER_2",
        "plan_shift_id":2,
        "plan_shift_name":"PLAN_SHIFT_2",
        "plan_shift_cost":200,
        "plan_shift_type":"unlimited",
        "plan_shift_start_time":null,
        "plan_shift_finish_time":null,
        "plan_shift_length":8,
        "plan_shift_crew_group_id":null,
        "shift_state":new,
        "buy_time":"20140101101010",
        "is_returned":true,
        "return_time":"20140101101010",
        "orders_count":0,
        "orders_sum":0,
        "fact_length":0
      }
    ]
  }
}

Запрос списка запланированных смен водителей

Метод: GET

Название запроса: get_driver_plan_shifts

Параметры:

Параметр	Тип	Описание
Обязательные параметры
start_time	ГГГГММДДччммсс	Начало периода (если включаем в ответ срочные смены)
finish_time	ГГГГММДДччммсс	Конец периода (если включаем в ответ срочные смены)
Необязательные параметры
limited_shifts	true или false	Включить в ответ срочные смены (по умолчанию true)
unlimited_shifts	true или false	Включить в ответ бессрочные смены (по умолчанию true)

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
plan_shifts	Массив	Массив запланированных смен
• plan_shift_id	Целое	ИД запланированной смены
• plan_shift_name	Строка	Наименование запланированной смены
• plan_shift_comment	Строка	Комментарий запланированной смены
• plan_shift_cost	Дробное	Цена смены
• plan_shift_type	Строка	Тип смены («limited» - срочная, «unlimited» - бессрочная)
• plan_shift_start_time	ГГГГММДДччммсс	План-начало смены (для срочных)
• plan_shift_finish_time	ГГГГММДДччммсс	План-конец смены (для срочных)
• plan_shift_length	Целое	План продолжительность смены, ч. (для бессрочных)
• plan_shift_crew_group_id	Целое	ИД первой группы экипажей, которая может купить смену
• plan_shift_crew_groups	Массив	ИД групп экипажей, которые могут купить смену
• max_sell_count	Целое	Максимальное количество продаж смены
• sold_count	Целое	Количество продаж смены

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_driver_plan_shifts?start_time=20140101101010&finish_time=20140101202020 
Signature: <...>


Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{
    "plan_shifts":[
      {
        "plan_shift_id":1,
        "plan_shift_name":"PLAN_SHIFT_1",
        "plan_shift_comment":"PLAN_SHIFT_COMMENT_1",
        "plan_shift_cost":100,
        "plan_shift_type":"limited",
        "plan_shift_start_time":"20140101101010",
        "plan_shift_finish_time":"20140101101010",
        "plan_shift_length":null,
        "plan_shift_crew_group_id":1,
        "max_sell_count":100,
        "sold_count":10
      },
      {
        "plan_shift_id":2,
        "plan_shift_name":"PLAN_SHIFT_2",
        "plan_shift_comment":"PLAN_SHIFT_COMMENT_2",
        "plan_shift_cost":200,
        "plan_shift_type":"unlimited",
        "plan_shift_start_time":null,
        "plan_shift_finish_time":null,
        "plan_shift_length":8,
        "plan_shift_crew_group_id":2,
        "max_sell_count":200,
        "sold_count":20
      }
    ]
  }
}

Продажа смены водителю

Метод: POST

Название запроса: driver_buy_shift

Параметры:

Параметр	Тип	Описание
Обязательные параметры
crew_id	Целое	ИД экипажа
plan_shift_id	Целое	ИД запланированной смены

Специальные возвращаемые коды:

Код	Описание
100	Запланированная смена не найдена
101	Экипаж не найден
102	Водитель не найден
103	Недостаточно денег на счете водителя
104	Водитель уволен либо заблокирован
105	Запланированная смена устарела
106	Не подходит группа экипажа
107	Превышено максимальное число покупок смены
108	Повторная покупка смены
109	Экипажу не назначен атрибут для доступа к смене

Возвращаемые данные в случае успешного выполнения запроса: нет.

Пример:

Запрос:

POST https://ip:port/common_api/1.0/driver_buy_shift 
Signature: <...>
Content-Type: application/x-www-form-urlencoded
Content-Length: 25
crew_id=1&plan_shift_id=1


Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{}
}

Сохранение отзыва клиента

Метод: POST

Название запроса: save_client_feed_back

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
phone	Строка	Телефон
rating	Целое	Рейтинг (от 1 до 5)
text	Строка	Текстовый отзыв
Необязательные параметры
order_id	Целое	ИД заказа
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Допускается указывать либо параметр rating либо text, либо оба параметра.

Специальные возвращаемые коды: нет.

Возвращаемые данные в случае успешного выполнения запроса: нет.

Пример:

Запрос:
POST /common_api/1.0/save_client_feed_back 
Host: 127.0.0.1:8090
Keep-Alive: 300
Connection: keep-alive
Content-Type: application/json
Content-Length: 72
Signature: <...>

{
  "phone":"89123456789",
  "rating":4,
  "text":"test feedback",
  "order_id":100
}
Ответ:
{
  "code":0,
  "descr":"OK",
  "data":{}
}

Поиск экипажей по координатам

Метод: GET

Название запроса: find_crews_by_coords

Параметры:

Параметр	Тип	Описание
Обязательные параметры
lat	Дробное	Широта точки центра поиска
lon	Дробное	Долгота точки центра поиска
radius	Дробное	Радиус поиска, км или мили
Необязательные параметры
crews_without_coords	true или false	Искать экипажи без реальных координат по координатам стоянок
crews_release_in	Целое	Допустимое время до освобождения в зоне поиска, если надо возвращать занятые экипажи (если 0, то искать только свободные экипажи), мин
crew_group_id	Целое	ИД группы экипажей, заказы из которой должны видеть подходящие экипажи
uds_id	Целое	ИД службы ЕДС, к которой должны принадлежать подходящие экипажи
attributes	Строка	Список ИД атрибутов заказа, которыми должны обладать подходящие экипажи (через точку с запятой, пример: «1;2;3»). Устарело. Рекомендуется использовать параметр attribute_values.
attribute_values	Массив	Массив значений атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
waiting_count	Целое	Количество свободных экипажей в зоне поиска
on_order_count	Целое	Количество занятых экипажей, освобождающихся в зоне поиска

Пример:

Запрос:
GET https://ip:port/common_api/1.0/find_crews_by_coords?
lat=11.111111&lon=22.222222&radius=2&crews_release_in=5 
Signature: <...>
Ответ:
{
  "code":0,
  "descr":"OK",
  "data":{
  "waiting_count":5,
  "on_order_count":2
  }
}

Подбор тарифа для заказа

Метод: POST

Название запроса: select_tariff_for_order

Параметры в формате JSON:

Параметр	Тип	Описание
Необязательные параметры
client_id	Целое	ИД клиента
crew_group_id	Целое	ИД группы экипажей
uds_id	Целое	ИД службы ЕДС
source_time	ГГГГММДДччммсс	Время подачи
is_prize	true или false	Призовой заказ
addresses	Массив	Массив координат адресов. Первый элемент — адрес подачи, последний — адрес назначения, между ними — остановки. Заполняется если определены координаты всех адресов.
• lon	Дробное	Долгота адреса
• lat	Дробное	Широта адреса

Специальные возвращаемые коды:

Код	Описание
100	Клиент не найден

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
tariff_id	Целое	Тариф

Пример:

Запрос:
POST https://ip:port/common_api/1.0/select_tariff_for_order 
Signature: <...>
Content-Type: application/json
Content-Length: <...>
{
  "client_id":1,
  "crew_group_id":2,
  "source_time":"20160101100000",
  "is_prize":true
 "addresses": [
      {
            "lat": 11.111111,
            "lon": 22.222222
      },
      {
            "lat": 33.333333,
            "lon": 44.444444
 }
}
Ответ:
{
  "code":0,
  "descr":"OK",
  "data":{
  "tariff_id":2
 }
}

Импорт марок автомобилей в БД

Метод: POST

Название запроса: import_car_marks

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
marks	Массив строк	Импортируемые марки автомобилей

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса: нет

Пример:

Запрос: 

POST https://ip:port/common_api/1.0/import_car_marks 
Signature: <...> 
Content-Type: application/json 
Content-Length: <...> 
{
  "marks": [
    "Mercedes",
    "BMW"
  ]
 } 

Ответ:

 {
  "code":0,
  "descr":"OK",
  "data":{}
 }

Импорт цветов автомобилей в БД

Метод: POST

Название запроса: import_car_colors

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
colors	Массив строк	Импортируемые цвета автомобилей

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса: нет

Пример:

Запрос: 

POST https://ip:port/common_api/1.0/import_car_colors 
Signature: <...> 
Content-Type: application/json 
Content-Length: <...>

 {
  "colors": [
    "красный",
    "синий"
  ]
 }

 Ответ:

 {
  "code":0,
  "descr":"OK",
  "data":{}
 }

Запрос информации по сотруднику клиента

Метод: GET

Название запроса: get_client_employee_info

Параметры:

Параметр	Тип	Описание
Обязательные параметры
client_employee_id	Целое	ИД сотрудника клиента

Специальные возвращаемые коды:

Код	Описание
100	Не найден сотрудник клиента ИД=CLIENT_EMPLOYEE_ID

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
client_employee_id	Целое	ИД сотрудника
client_id	Целое	ИД клиента
name	Строка	ФИО сотрудника
is_deleted	true или false	Признак удаленного сотрудника
email	Строка	E-mail
use_email_informing	true или false	Использовать E-mail для отправки уведомлений по заказу
default_crew_group	Целое	Группа экипажей по умолчанию
phones	Массив	Массив телефонов сотрудника клиента
• phone	Строка	Номер телефона сотрудника

Пример:

Запрос:

GET https://ip:port/common_api/1.0/get_client_employee_info?client_employee_id=10 
Signature: <...> 

Ответ:

 {
  "code":0,
  "descr":"OK",
  "data":{
     "client_employee_id":5,
    "client_id":1,
    "name":"Иванов Иван",
    "is_deleted":false,
    "email":"mail@mail.ru",
    "use_email_informing":true,
    "default_crew_group":1,
    "phones":[
      {
        "phone":"88"
      },
      {
        "phone":"99"
      }
    ]
  }
 }

Создание сотрудника клиента

Метод: POST

Название запроса: create_client_employee

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
client_id	Целое	ИД клиента
name	Строка	ФИО сотрудника
Необязательные параметры
email	Строка	E-mail
use_email_informing	true или false	Использовать E-mail для отправки уведомлений по заказу
phones	Массив	Массив телефонов сотрудника
• phone	Строка	Номер телефона

Специальные возвращаемые коды:

Код	Описание
100	Клиент с ИД=CLIENT_ID не найден
101	Клиент с ИД=ID имеет такой же номер телефона=PHONE

Возвращаемые данные в случае успешного выполнения запроса: нет.

Пример:

Запрос: 

POST https://ip:port/common_api/1.0/create_client_employee 
Signature: <...> 
Content-Type: application/json 
Content-Length: 104

{
  "client_id":10
  "name":"Иванов Иван",
  "email":"mail@mail.ru",
  "use_email_informing":true,
  "phones":[
    {
      "phone":"79999999999",
    },
    {
      "phone":"79999999999",
    }
  ]
 }

 Ответ:
 {
  "code":0,
  "descr":"OK",
  "data":{}
 }

Обновление информации о сотруднике клиента

Метод: POST

Название запроса: update_client_employee_info

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
client_employee_id	Целое	ИД редактируемого сотрудника клиента
Необязательные параметры
name	Строка	ФИО сотрудника
is_deleted	true или false	Признак удаленного сотрудника
email	Строка	E-mail
use_email_informing	true или false	Использовать E-mail для отправки уведомлений по заказу
phones	Массив	Массив телефонов сотрудника
• phone	Строка	Номер телефона

Примечание: запрещено редактировать телефоны удаленного сотрудника.

Специальные возвращаемые коды:

Код	Описание
100	Сотрудник с ИД=CLIENT_EMPLOYEE_ID не найден
101	Клиент с ИД=ID имеет такой же номер телефона=PHONE
102	Запрещено редактирование телефонов удаленного сотрудника

Возвращаемые данные в случае успешного выполнения запроса: нет.

Пример:

Запрос: 

POST https://ip:port/common_api/1.0/update_client_employee_info 
Signature: <...> 
Content-Type: application/json
Content-Length: 104

{
  "client_employee_id":10
  "name":"Иванов Иван",
  "is_deleted":false,
  "email":"mail@mail.ru",
  "use_email_informing":true,
  "phones":[
    {
      "phone":"79999999999",
    },
    {
      "phone":"79999999999",
    }
  ]
 } 

Ответ:
 {
  "code":0,
  "descr":"OK",
  "data":{}
 }

Запрос списка состояний заказа

Метод: GET

Название запроса: get_order_states_list

Параметры: нет

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
order_params	Массив	Список параметров заказа
• id	Целое	ИД параметра
• name	Строка	Название параметра
• state_type	Строка	Тип состояния. Может принимать значения: • "accepted" — заказ принят • "in_work" — заказ в работе • "finished" — заказ выполнен • "aborted" — заказ прекращен

Пример:

Запрос:


GET https://ip:port/common_api/1.0/get_order_states_list 

Signature: <...>

Ответ:


{
 "code":0,
 "descr":"OK",
 "data":{
 "order_params":[
     {
      "id":1,
      "name":"Принят",
      "state_type":"accepted"
     },
     {
      "id":2,
      "name":"В работе",
      "state_type":"in_work"
      },
     ...
                ]
        }
}

Запрос списка состояний экипажа

Метод: GET

Название запроса: get_crew_states_list

Параметры: нет

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
order_params	Массив	Список параметров заказа
• id	Целое	ИД параметра
• name	Строка	Название параметра
• state_type	Строка	Тип состояния. Может принимать значения: • "waiting" — экипаж свободен • "not_available" — экипаж не на линии • "on_order" — экипаж на заказе • "on_break" — экипаж на перерыве

Пример:

Запрос:
GET https://ip:port/common_api/1.0/get_crew_states_list 
Signature: <...>

Ответ:
{
 "code":0,
 "descr":"OK",
 "data":{
 "order_params":[
         {
          "id":1,
          "name":"Свободен",
          "state_type":"waiting"
         },
         {
          "id":2,
          "name":"Не работает",
          "state_type":"not_available"
         },
         ...
               ]
        }
}

Запрос глобальных атрибутов

Метод: GET

Название запроса: get_global_attributes

Версия ТМ: 3.9

Параметры: нет

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
attribute_values	Массив	Массив значений глобальных атрибутов
• id	Целое	Идентификатор атрибута
• bool_value	true или false	Значение, если тип атрибута «Логический»
• num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
• str_value	Строка	Значение, если тип атрибута «Строка»

Пример:

Пример запроса:

GET https://ip:port/common_api/1.0/get_global_attributes

Пример ответа:

{
  "code":0,
  "descr":"OK",
  "data":{
    "global_attributes":[
      {
        "id":123,
        "bool_value":true
      },
      {
        "id":124,
        "num_value":314
      },
      {
        "id":125,
        "str_value": "AAA"
      }
    ]
  }
}

Изменение глобального атрибута

Метод: POST

Название запроса: update_global_attribute

Версия ТМ: 3.9

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
id	Целое	ИД изменяемого атрибута
Необязательные параметры
bool_value	true или false	Значение, если тип атрибута «Логический»
num_value	Дробное	Значение, если тип атрибута: «Число» (непосредственное значение) «Число (выбор из списка)» (непосредственное значение выбранного элемента списка) «Перечисляемый» (значение выбранного элемента перечисления) «Дата» и «Дата/время» (Unix-время, всегда целое число)
str_value	Строка	Значение, если тип атрибута «Строка»

Специальные возвращаемые коды:

Код	Описание
100	Атрибут не найден
101	Атрибут не глобальный

Возвращаемые данные в случае успешного выполнения запроса: нет.

Пример:

Пример запроса:

POST https://ip:port/common_api/1.0/update_global_attribute HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "id": 12,
  "bool_value": true
}

Пример ответа:

{
  "code":0,
  "descr":"OK",
  "data":{}
}

Создание резервирования автомобиля

Метод: POST

Название запроса: create_car_reservation

Версия ТМ: 3.9.46

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
car_id	Целое	ИД автомобиля
driver_id	Целое	ИД водителя
car_reservation_type_id	Целое	ИД типа резервирования
start_time	ГГГГММДД или ГГГГММДДччммсс	Дата или дата/время начала. Если указывается дата без времени, то планируемое время начала резервирования устанавливается исходя из времени начала, указанного в соответствующем типе резервирования
Необязательные параметры
finish_time	ГГГГММДДччммсс	Время окончания резервирования. Если не указано, рассчитывается на основании времени планируемого начала резервирования и продолжительности резервирования, указанного в соответствующем типе резервирования
comment	Строка	Комментарий

Специальные возвращаемые коды:

Код	Описание
100	Не найден автомобиль
101	Не найден водитель
102	Не найден тип резервирования
103	Время начала резервирования должно быть меньше времени завершения
104	Автомобиль уже зарезервирован в указанный период времени
105	Водитель уже имеет зарезервированный автомобиль в указанный период времени

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
car_reservation_id	Целое	ИД резервирования

Пример запроса:

POST https://ip:port/common_api/1.0/create_car_reservation HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "car_id": 1,
  "driver_id": 1,
  "car_reservation_type_id": 1,
  "start_date": "20201231",
  "comment": "COMMENT" 
}

Пример ответа:

{
  "code": 0,
  "descr": "OK",
  "data": {
    "car_reservation_id": 5
  }
}

Создание недоступности автомобиля

Метод: POST

Название запроса: create_car_inaccessibility

Версия ТМ: 3.9.46

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
car_id	Целое	ИД автомобиля
car_inaccessibility_type_id	Целое	ИД типа недоступности
start_time	ГГГГММДДччммсс	Время начала
Необязательные параметры
finish_time	ГГГГММДДччммсс	Время завершения
comment	Строка	Комментарий

Специальные возвращаемые коды:

Код	Описание
100	Не найден автомобиль
101	Не найден тип недоступности
102	Время начала недоступности должно быть меньше времени завершения

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
car_inaccessibility_id	Целое	ИД недоступности

Пример запроса:

POST https://ip:port/common_api/1.0/create_car_inaccessibility HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "car_id": 1,
  "car_inaccesibility_type_id": 1,
  "start_time": "20201231235959",
  "finish_time": "20210101050000",
  "comment": "COMMENT" 
}

Пример ответа:

{
  "code": 0,
  "descr": "OK",
  "data": {
    "car_inaccessibility_id": 5
  }
}

Вызвать системное событие

Метод: POST

Название запроса: run_system_event

Версия ТМ: 3.10

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
system_event_id	Целое	ИД системного события с типом "По запросу CommonAPI"
Необязательные параметры
Произвольный параметр	любой	В запросе можно передавать дополнительные произвольные параметры с любыми названиями и значениями. Эти параметры могут использоваться в системном событии.

Специальные возвращаемые коды:

Код	Описание
100	У системного события тип не "По запросу CommonAPI"
101	Системное событие не найдено
102	Системное событие не активно

Возвращаемые данные в случае успешного выполнения запроса: нет.

Пример запроса:

POST https://ip:port/common_api/1.0/run_system_event HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "system_event_id": 123,
  "custom_param_1": true
  "custom_param_2": 123,
  "custom_param_3": 123.45,
  "custom_param_4": "aaa" 
}

Пример ответа:

{
  "code":0,
  "descr":"OK",
  "data":{}
}

Проверить штраф клиента за отмену заказа

Метод: GET

Название запроса: check_cancel_order_penalty

Версия ТМ: 3.11

Параметры в формате JSON:

Параметр	Тип	Описание
Обязательные параметры
order_id	Целое	ИД заказа
cancel_order_state_id	Целое	ИД состояния заказа, в которое переходит заказ при отмене

Специальные возвращаемые коды:

Код	Описание
100	Не найден заказ ИД=order_id
101	Не найдено состояние заказа ИД=cancel_order_state_id
102	Состояние заказа не соответствует необходимым условиям

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
cancel_order_penalty_sum	Дробное	Величина штрафа, которая будет начислена клиенту в случае отмены заказа или 0, если штрафа нет

Пример запроса:
GET https://ip:port/common_api/1.0/check_cancel_order_penalty?order_id=12345&cancel_order_state_id=12 HTTP/1.1
Signature: <...>

Пример ответа:
{
  "code":0,
  "descr":"OK",
  "data":{
    "cancel_order_penalty_sum":350
  }
}

Запрос трека экипажа

Метод: GET

Название запроса: get_crew_track

Версия ТМ: 3.11

Параметры:

Параметр	Тип	Описание
Обязательные параметры
crew_id	Целое	ИД экипажа
start_time	ГГГГММДДччммсс	Начало периода
finish_time	ГГГГММДДччммсс	Конец периода, должен отличаться о начала периода не более чем на 7 дней

Специальные возвращаемые коды:

Код	Описание
100	Не найден экипаж ИД=crew_id
101	Задан период времени более 7 дней

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
track	Массив	Массив, трек экипажа за период времени
• lat	Дробное	Широта точки маршрута
• lon	Дробное	Долгота точки маршрута
• time	ГГГГММДДччммсс	Время данной точки
• speed	Целое	Скорость в данный момент, км/ч
• direction	Целое	Направление движения, градусы (0 - север, 90 - восток, 180 - юг, 270 - запад)

Пример запроса:

GET https://ip:port/common_api/1.0/get_crew_track?crew_id=1&start_time=20210911120000&finish_time=20210911130000 HTTP/1.1
Signature: <...>

Пример ответа:

{
  "code":0,
  "descr":"OK",
  "data":{
    "track": [
      {
        "lat": 11.111111,
        "lon": 22.222222,
        "time": "20210911120000",
        "speed": 123,
        "direction": 0
      }
    ]
  }
}

Создание фиксированной смены водителя

Метод: POST

Название запроса: create_fixed_driver_shift

Версия ТМ: 3.12

Параметры:

Параметр	Тип	Описание
Обязательные параметры
driver_id	Целое	ИД водителя
start_time	ГГГГММДДччммсс	Время начала
finish_time	ГГГГММДДччммсс	Время завершения

Специальные возвращаемые коды:

Код	Описание
100	Не найден водитель
101	Время начала фиксированной смены должно быть меньше времени завершения
102	Создаваемая смена пересекается по времени с уже существующей сменой данного водителя

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
fixed_driver_shift_id	Целое	ИД фиксированной смены

Пример:

Запрос:

POST https://ip:port/common_api/1.0/create_fixed_driver_shift HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "driver_id": 1,
  "start_time": "20201231235959",
  "finish_time": "20210101050000"
}

Ответ:

{
  "code": 0,
  "descr": "OK",
  "data": {
    "fixed_driver_shift_id": 5
  }
}

Удаление фиксированной смены водителя

Метод: POST

Название запроса: delete_fixed_driver_shift

Версия ТМ: 3.12

Параметры:

Параметр	Тип	Описание
Обязательные параметры
fixed_driver_shift_id	Целое	ИД фиксированной смены водителя

Специальные возвращаемые коды:

Код	Описание
100	Фиксированная смена водителя не найдена

Возвращаемые данные в случае успешного выполнения запроса: нет.

Пример:

Запрос:

POST https://ip:port/common_api/1.0/delete_fixed_driver_shift HTTP/1.1
Signature: <...>
Content-Type: application/x-www-form-urlencoded
Content-Length: <...>

fixed_driver_shift_id=1

Ответ:

{
  "code":0,
  "descr":"OK",
  "data":{}
}

Создание путевого листа

Метод: POST

Название запроса: create_way_bill

Версия ТМ: 3.14

Параметры:

Параметр	Тип	Описание
Обязательные параметры
start_time	ГГГГММДДччммсс	Время начала
finish_time	ГГГГММДДччммсс	Время завершения
driver_id	Целое	ИД водителя
car_id	Целое	ИД автомобиля
Необязательные параметры
number	Строка	Номер путевого листа
comment	Строка	Комментарий

Специальные возвращаемые коды:

Код	Описание
100	Нет лицензии на использование путевых листов
101	Не найден водитель
102	Не найден автомобиль

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
way_bill_id	Целое	ИД созданного путевого листа

Пример:

Запрос:

POST https://ip:port/common_api/1.0/create_way_bill HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "number": "api_123",
  "start_time": "20230508000000",
  "finish_time": "20230509000000",
  "driver_id": 123,
  "car_id": 123,
  "comment": "Комментарий"
}

Ответ:

{
  "code": 0,
  "descr": "OK",
  "data": {
    "way_bill_id": 5
  }
}

Создание осмотра по путевому листу

Метод: POST

Название запроса: create_way_bill_check

Версия ТМ: 3.14

Параметры:

Параметр	Тип	Описание
Обязательные параметры
way_bill_id	Целое	ИД путевого листа (должен быть задан либо ИД либо номер)
way_bill_number	Строка	Номер путевого листа (должен быть задан либо ИД либо номер)
kind	Строка	Тип осмотра ("med/tech")
user_name	Строка	Имя пользователя
success	true или false	Результат осмотра
Необязательные параметры
number	Строка	Номер осмотра
comment	Строка	Комментарий

Специальные возвращаемые коды:

Код	Описание
100	Нет лицензии на использование путевых листов
101	Не найден путевой лист

Возвращаемые данные в случае успешного выполнения запроса: нет

Пример:

Запрос:

POST https://ip:port/common_api/1.0/create_way_bill_check HTTP/1.1
Signature: <...>
Content-Type: application/json
Content-Length: <...>

{
  "way_bill_id": 123,
  "number": "api_med_123",
  "kind": "med",
  "user_name": "Имя",
  "success": true,
  "comment": "Комментарий"
}

Ответ:

{
  "code": 0,
  "descr": "OK",
  "data": {}
}

Описание протокола TMTAPI Версия 1.0

Общее описание протокола

Формат запроса

TM API принимает входящие запросы по протоколу HTTPS. В URI запроса после ip адреса и порта, который будет слушать TM API, должно идти название API (tm_tapi) и версия API.

Пример:

GET https://ip:port/tm_tapi/1.0/get_info_by_phone 

Для получения данных из БД используются запросы типа GET. Для записи данных в БД используются запросы типа POST. В запросе типа GET параметры запроса передаются в URI.

Пример:

GET https://ip:port/tm_tapi/1.0/get_info_by_phone?phone=89058800565&fields=PHONE_TYPE-PHONE_
TO_DIAL&signature=661ce071eeefcb4f7fc8bc1f17bd520b 

В запросе типа POST параметры передаются в теле запроса в формате application/x-www-form- urlencoded.

Пример:

POST https://ip:port/tm_tapi/1.0/change_order_state 
Content-Type: application/x-www-form-urlencoded
Content-Length: 71

order_id=98798&need_state=12&signature=a204c50c7e48f0c6849a87485fe5e171

В любом запросе обязательно с другими полями должно передаваться поле signature. В нем передается MD5 хэш, рассчитанный для строки, которая получается сцеплением строки параметров запроса с секретным ключом. Секретный ключ задается в настройках модуля TMAPI в Такси-Мастер.

Пример:

Запрос:
GET https://ip:port/tm_tapi/1.0/get_info_by_phone?phone=89058800565&fields=PHONE_TYPE
&signature=ef17ea682d09e452af544a5758dba396 

Секретный ключ:
321

Signature = MD5("phone=89058800565&fields=PHONE_TYPE" + "321") = ef17ea682d09e452af544a5758dba396

Формат ответа

TM API всегда возвращает HTTP код 200 ОК. Результат выполнения запроса содержится в теле ответа в формате XML. Общий вид возвращаемого результата:

<response>
<code>Числовой код результата</code>
<descr>Строковое описание результата</descr>
<data>Дополнительная информация</data>
</response>

Существуют общие для всех запросов коды результатов:

Код	Описание
0	Успешное выполнение запроса
1	Неизвестная ошибка
2	Неизвестный тип API
3	API отключено в настройках модуля TM API в Такси-Мастер
4	Не совпадает секретный ключ
5	Неподдерживаемая версия API
6	Неизвестное название запроса
7	Неверный тип запроса GET
8	Не хватает входного параметра (в доп. информации ответа будет название отсутствующего параметра)
9	Некорректный входной параметр (в доп. информации ответа будет название некорректного параметра)
10	Внутренняя ошибка обработки запроса

Описание запросов

Запрос информации по номеру телефона

Метод: GET

Название запроса: get_info_by_phone

Параметры:

Параметр	Тип	Описание
Обязательные параметры
PHONE	Строка, <= 16 символов	Номер телефона
FIELDS	Строка	Список полей, которые необходимо вернуть. Поля перечисляются через символ "-"
signature	Строка	Поле для проверки секретного ключа.

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса: зависит от того какие поля были переданы в поле fields.

Параметр	Тип	Описание
PHONE_TYPE	Целое	Тип телефона звонящего: 1 - если звонит водитель с основного телефона; 2 - если звонит физическое лицо; 3 - если звонит юридическое лицо; 4 - если звонит номер из справочника Телефоны; 5 - если звонит водитель с неосновного телефона; 6 - если звонит ЦОЗ водитель; 0 - неизвестный номер.
PHONE_TO_DIAL	Строка, <= 16 символов	Номер телефона для отзвона по заказу
CREW_ID	Целое	ИД экипажа
IS_PRIOR	0 или 1 (false или true)	Признак предварительного заказа
IS_PRIZE	0 или 1 (false или true)	Признак призового заказа
ORDER_CLIENT_ID	Целое	ИД клиента из заказа
DRIVER_PHONE	Строка, <= 16 символов	Номер телефона водителя
CREW_SYSTEMSTATE	Целое	Состояние экипажа
CLIENT_ID	Целое	ИД клиента
CLIENT_TYPE	Целое	Тип клиента
CATEGORYID	Целое	ИД категории телефона
PHONE_SYSTEM_CATEGORY	Целое	Системное значение категории телефона (0 - обычный, 1 - черный, 2 - белый, 3 - серый)
ORDER_ID	Целое	ИД заказа
DRIVER_ID	Целое	ИД водителя
ORDER_STATE	Целое	Состояние заказа
DRIVER_REMAINDER	Дробное	Баланс счета водителя
DISCOUNTEDSUMM	Строка	Сумма заказа с учетом всех скидок
CREW_GROUP_ID	Целое	ИД группы экипажа (если в заказе указан экипаж, то берется ИД группы экипажа, если нет — из карты заказа)
FIRST_CREW_GROUP_ID	Целое	ИД первой группы экипажа
CLIENT_BALANCE	Дробное	Баланс клиента
DRIVER_TIMECOUNT	Целое	Время пути водителя до адреса подачи в минутах
SOURCE_TIMECOUNT	Целое	Время оставшееся до подачи в минутах
GOSNUMBER	Строка	Государственный номер автомобиля
CAR_COLOR	Строка	Цвет автомобиля
CAR_MARK	Строка	Марка автомобиля
ORDER_COORDS	Строка	Координаты места подачи. Порядок координат: долгота адреса, широта адреса.
CREW_COORDS	Строка	Координаты назначенного экипажа. Порядок координат: долгота адреса, широта адреса.
MARKET_TYPE	Целое	Тип биржи заказов (2 — Яндекс, 3 — ЦОЗ).
ORDERS_COUNT	Целое	Для телефона клиента — количество текущих и предварительных заказов по телефону; для телефона водителя — количество текущих заказов, на которые назначен данный водитель
CLIENT_GROUP_ID	Целое	ИД группы клиента
CLIENT_BONUS_BALANCE	Дробное	Бонусный баланс клиента
AD_LIGHTHOUSE	Строка	Признак наличия шашек. Пустая строка – номер клиента или водителя без экипажа. 1 – есть шашки, 0 – нет шашек.
CREW_STATE	Целое	Состояние экипажа.
SOURCE_TIME	ГГГГММДДччммсс	Дата и время подачи
DRV_SHIFT_START_TIME	ГГГГММДДччммсс	Начало фактической смены водителя
START_USER_SIP_ACCOUNTS	Строка	Список логинов SIP–аккаунтов пользователя, принявшего заказ
CREATION_WAY	Строка	Способ создания заказа (operator, sms, market, common_api, t_api, taxophone, driver, daily_order, taxophone_web, unknown)
CREATOR_TAXI_PHONE	Строка	Телефон службы-создателя для заказов, принятых из ЦОЗ
PERFORMER_TAXI_PHONE	Строка	Телефон службы-исполнителя для заказов, отданных в ЦОЗ
CLIENT_IS_LOCKED	0 или 1 (false или true)	Признак блокировки клиента

Пример:

Запрос:
GET https://ip:port/tm_tapi/1.0/get_info_by_phone?phone=89058800565l&fields=PHONE_TYPE-PHONE_
TO_DIAL-CREW_ID-ORDER_ID&signature=d35ab2765f2968d48c096d5f5327db26 

Ответ:

<response>
  <code>0</code>
  <descr>OK</descr>
  <data>
    <PHONE_TYPE>0</PHONE_TYPE>
    <PHONE_TO_DIAL></PHONE_TO_DIAL>
    <CREW_ID>3</CREW_ID>
    <ORDER_ID>6</ORDER_ID>
    <SOURCE_TIME>20140929134911</SOURCE_TIME>
    <DRV_SHIFT_START_TIME>20141007105050</DRV_SHIFT_START_TIME>
  </data>
</response>

Запрос информации по ИД заказа

Метод: GET

Название запроса: get_info_by_order_id

Параметры:

Параметр	Тип	Описание
Обязательные параметры
ORDER_ID	Целое	ИД заказа
FIELDS	Строка	Список полей, которые необходимо вернуть. Поля перечисляются через символ "-"
signature	Строка	Поле для проверки секретного ключа

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса: зависит от того какие поля были переданы в поле fields.

Параметр	Тип	Описание
DRIVER_TIMECOUNT	Строка, <= 16 символов	Время до подачи в минутах, указанное водителем
CAR_MARK	Строка	Марка автомобиля
CAR_COLOR	Строка	Цвет автомобиля
GOSNUMBER	Строка	Государственный номер автомобиля
CREW_GROUP_ID	Целое	ИД группы экипажа (значение из карты заказа)
FIRST_CREW_GROUP_ID	Целое	ИД первой группы экипажа
IS_PRIOR	0 или 1 (false или true)	Признак предварительного заказа
IS_PRIZE	0 или 1 (false или true)	Признак призового заказа
DISCOUNTEDSUMM	Строка	Сумма заказа с учетом всех скидок
DRIVER_PHONE	Строка, <= 16 символов	Номер телефона водителя
CATEGORYID	Целое	ИД категории телефона
SOURCE_TIMECOUNT	Целое	Время до подачи в минутах
ORDER_COORDS	Строка	Координаты места подачи. Порядок координат: долгота адреса, широта адреса.
CREW_COORDS	Строка	Координаты назначенного экипажа. Порядок координат: долгота адреса, широта адреса.
ORDER_STATE	Целое	ИД состояния заказа
MARKET_TYPE	Целое	Тип биржи заказов (3 — ЦОЗ).
AD_LIGHTHOUSE	Строка	Признак наличия шашек (1 – шашки есть, 0 – шашек нет).
CREW_STATE	Целое	Состояние экипажа
SOURCE_TIME	ГГГГММДДччммсс	Дата и время подачи
START_USER_SIP_ACCOUNTS	Строка	Список логинов SIP–аккаунтов пользователя, принявшего заказ
ORDER_PARAMS	Целое	Список ИД параметров заказа
CREATION_WAY	Строка	Способ создания заказа (operator, sms, market, common_api, t_api, taxophone, driver, daily_order, taxophone_web, unknown)
CREATOR_TAXI_PHONE	Строка	Телефон службы-создателя для заказов, принятых из ЦОЗ
PERFORMER_TAXI_PHONE	Строка	Телефон службы-исполнителя для заказов, отданных в ЦОЗ

Пример:

Запрос:

GET https://ip:port/tm_tapi/1.0/get_info_by_order_id?order_id=60&fields=DRIVER_SOURCETIME-MARKCOLOR-
GOSNUMBER-IS_PRIOR-MOBILE_PHONE-SOURCE_TIME&signature=fdcd04e570443b56176b83f44748dc23


Ответ:

<response>
  <code>0</code>
  <descr>OK</descr>
  <data>
    <DRIVER_SOURCETIME></DRIVER_SOURCETIME>
    <MARK></MARK>
    <COLOR></COLOR>
    <GOSNUMBER></GOSNUMBER>
    <IS_PRIOR></IS_PRIOR>
    <MOBILE_PHONE></MOBILE_PHONE>
    <SOURCE_TIME>20140929134911</SOURCE_TIME>
  </data>
</response>

Смена состояния заказа

Метод: POST

Название запроса: change_order_state

Параметры:

Параметр	Тип	Описание
Обязательные параметры
ORDER_ID	Целое	ИД заказа
NEED_STATE	Целое	Новое состояние заказа
signature	Строка	Поле для проверки секретного ключа

Специальные возвращаемые коды:

Код	Описание
100	Заказ с таким ИД не найден
101	Изменение состояния не соответствует необходимым условиям

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
ORDER_ID	Целое	ИД заказа
NEED_STATE	Целое	Новое состояние заказа

Пример:

Запрос:

POST https://ip:port/tm_tapi/1.0/change_order_state 
Content-Type: application/x-www-form-urlencoded
Content-Length: 71

order_id=18561&need_state=14&signature=3e8107e0c044e55d983db1fbed82fd8c

Ответ:

<response>
  <code>0</code>
  <descr>OK</descr>
  <data>
    <ORDER_ID>18561</ORDER_ID>
    <NEW_STATE>14</NEW_STATE>
  </data>
</response>

Запись пути к файлу разговора в базу данных

Метод: POST

Название запроса: create_record_link

Параметры:

Параметр	Тип	Описание
Обязательные параметры
CALL_ID	Строка, <= 60 символов	ИД звонка (необязателен, если указан PHONE)
PHONE	Строка, <= 16 символов	Номер телефона (необязателен, если указан CALL_ID)
CALL_TYPE	0 или 1	0 — Исходящий, 1 — Входящий
signature	Строка	Поле для проверки секретного ключа
Необязательные параметры
RECORD_DATE	ДДММГГГГччммсс	Дата записи
RECORD_LENGTH	Целое	Продолжительность записи (в секундах)
FILE_PATH	Строка, <=255 символов	Путь к файлу записи
TRANSFERED_TO	Строка,<=30 символов	Номер телефона(линии) на который(ую) был переведен звонок (доп. параметр для CALL_RESULT="transfered")
CALL_RESULT	Строка	Результат звонка, возможны следующие значения: "success" - успешный, "no_answer" - не дозвонились, "answered" - ответили, "missed" - пропущен, "transfered" - переведен, "broke_off" - сброшен, "other_user_answered" - принят другим оператором. Если не задан, то "success"

Специальные возвращаемые коды: нет.

Возвращаемые данные в случае успешного выполнения запроса

Параметр	Тип	Описание
RECORD_ID	Целое	ИД созданной записи

Пример:

Запрос:

POST https://ip:port/tm_tapi/1.0/create_record_link HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Content-Length: <...>

RECORD_DATE=20130122180949&RECORD_LENGTH=215&CALL_ID=12345&PHONE=8987564&FILE_PATH=d%3A%5Ctemp%5CTM%5Ctrunk%5CSource%5CDevUtils%5CTMAPITest%5C&CALL_TYPE=1&CALL_RESULT=no_answer&signature=<...>

Ответ:
<response>
  <code>0</code>
  <descr>OK</descr>
  <data>
    <RECORD_ID>25</RECORD_ID>
  </data>
</response>

Создать новый заказ

Метод: POST

Название запроса: make_new_order

Параметры:

Параметр	Тип	Описание
Обязательные параметры
PHONE	Строка, <= 16 символов	Номер телефона
ORDER_STATE_ID	Целое	ИД состояния заказа
signature	Строка	Поле для проверки секретного ключа
Необязательные параметры
CREWGROUPID	Целое	ИД группы экипажа
TARIF_ID	Целое	ИД тарифа
DISCOUNTEDSUMM	Дробное	Фиксированная сумма за заказ
CUSTOMER	Строка, <=80 символов	Заказчик
SOURCE	Строка, <=80 символов	Адрес подачи
SOURCE_STREET	Целое	ИД улицы подачи
SOURCE_HOUSE	Строка, <=10 символов	Дом подачи
SOURCE_FLAT	Строка, <=10 символов	Квартира подачи
SOURCE_POINT	Целое	ИД пункта подачи
DESTINATION	Строка, <=80 символов	Адрес назначения
DESTINATION_STREET	Целое	ИД улицы назначения
DESTINATION_HOUSE	Строка, <=10 символов	Дом назначения
DESTINATION_FLAT	Строка, <=10 символов	Квартира назначения
DESTINATION_POINT	Целое	ИД пункта назначения
CREWID	Целое	ИД экипажа
SUMM	Дробное	Стоимость заказа без учета скидок (наценок)
STARTUSER	Целое	Пользователь, создавший заказ
STARTTIME	ГГГГММДДччммсс	Дата создания заказа
FINISHUSER	Целое	Пользователь, завершивший заказ
FINISHTIME	ГГГГММДДччммсс	Дата завершения заказа
SOURCE_ZONE	Целое	Район подачи
DESTINATION_ZONE	Целое	Район назначения
SOURCE_PARKING	Целое	Стоянка подачи
DESTINATION_PARKING	Целое	Стоянка назначения
SOURCE_TIME	ГГГГММДДччммсс	Дата подачи
SOURCE_COUNTRY	0 или 1 (false или true)	Признак междугороднего заказа
IS_PRIOR	0 или 1 (false или true)	Признак предварительного заказа
PRIZE	0 или 1 (false или true)	Признак призового заказа
NOTE	Строка, <=80 символов	Примечание
BONUSPOINT	Дробное	Бонусные баллы, начисленные водителю за заказ
DISTANCE	Дробное	Километраж по городу (в километрах)
HOURLY_LEN	Целое	Длительность исполнения почасового заказа (в минутах)
HOURLY_START	ГГГГММДДччммсс	Дата начала отсчета при почасовом заказе
HOURLY_PAY	0 или 1 (false или true)	Признак почасового заказа
PHONE_TO_DIAL	Строка, <=16 символов	Номер телефона для отзвона по заказу
FROMBORDER	0 или 1 (false или true)	Признак заказа "с бордюра"
WAITING_START	ГГГГММДДччммсс	Дата начала ожидания заказчика водителем
WAITING_LENGTH	Целое	Общая длина периода ожидания заказчика водителем (в минутах)
BACKFREE	Целое	Признак применения скидки в 50% на обратный путь
INPUTTIME	ГГГГММДДччммсс	Дата принятия заказа (от даты создания заказа отличается тем, что может быть задана пользователем)
MONEY_RECEIVE	0 или 1 (false или true)	Подтверждение принятия денег наличными
NOTIFY_BEFORE	Целое	Период времени, за который пользователь оповещается о наступлении даты подачи
WANTCREWID	Целое	ИД желаемого экипажа
DISTANCE_COUNTRY	Дробное	Километраж за границами города (в километрах)
DISTANCE_CHECK	0 или 1 (false или true)	Разрешение ручного ввода километража
CLIENTID	Целое	ИД постоянного клиента
INFRA_STATE	Целое	Состояние заявки в исходящей компании колцентра INFRA (1 - заявка передана в исходящую компанию, 2 - отзвон успешно произведен, 3 - занято, 4 - не берут трубку)
INFRA_ORDER	Целое	INFRA-заказ (спец. поле для работы с колцентром компании Инфрател)

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса

Параметр	Тип	Описание
ORDER_ID	Целое	ИД созданного заказа

Пример:

Запрос:

POST https://ip:port/tm_tapi/1.0/make_new_order 
Content-Type: application/x-www-form-urlencoded
Content-Length: 206

PHONE=89058770593&ORDER_STATE_ID=10&DISCOUNTED_SUMM=100&signature=afc947f610eba380df6d0e441b03ddad

Ответ:

<response>
  <code>0</code>
  <descr>OK</descr>
  <data>
    <order_id>27</order_id>
  </data>
</response>

Поиск улицы в базе

Метод: POST

Название запроса: street_search

Параметры:

Параметр	Тип	Описание
Обязательные параметры
PHONE	Строка, <= 16 символов	Номер телефона
CALL_ID	Целое	ИД звонка
VOICE_STREET	Строка, <= 60 символов	Название улицы или пункта, полученное через преобразование голоса в текст
signature	Строка	Поле для проверки секретного ключа

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
CALL_ID	Целое	ИД звонка
PHONE	Строка, <= 16 символов	Номер телефона
STREET_FOUND	0 или 1 (false или true)	Признак того, что улица найдена
STREET_NAME	Строка, <= 60 символов	Наименование улицы или пункта, найденное в базе данных

Пример:

Запрос:
POST https://ip:port/tm_tapi/1.0/street_search 
Content-Type: application/x-www-form-urlencoded
Content-Length: 175

PHONE=89058770593&CALL_ID=56&VOICE_STREET=пушкинск&FIND_STREET=0&API_FIND_STREET=&NUM_HOUSE=&signat
ure=9204a53e0f4842bb623c3a5f7683520a

Ответ:

<response>
  <code>0</code>
  <descr>OK</descr>
  <data>
    <CALL_ID>56</CALL_ID>
    <PHONE>89058770593</PHONE>
    <FIND_STREET>1</FIND_STREET>
    <API_FIND_STREET>Пушкинская</API_FIND_STREET>
  </data>
</response>

Смена состояния заказа по результату автодозвона

Метод: POST

Название запроса: set_request_state

Параметры:

Параметр	Тип	Описание
Обязательные параметры
STATE_ID	Целое	Cостояние заказа до отзвона
PHONE_TYPE	0..2	Признак, что звонили 1- клиенту, 0 – водителю, 2 -диспетчеру
ORDER_ID	Целое	ИД заказа
STATE	Целое (0, 1, 2, 3, 4, 5)	Состояние отзвона (0 – начальное, 1 — в процессе, 2 — успешно, 3 — занято, 4 — нет ответа, 5 — ошибка)
signature	Строка	Поле для проверки секретного ключа

Специальные возвращаемые коды: нет

Возвращаемые данные в случае успешного выполнения запроса: нет

Настройки смены состояний заказа с использованием автодозвона задаются в карточке состояний заказа.

Пример:

Запрос:
POST https://ip:port/tm_tapi/1.0/set_request_state 
Content-Type: application/x-www-form-urlencoded
Content-Length: 71

state_id=7&phone_type=1&order_id=50&state=4&signature=0eb50db401d3540e038fde68eb260333

Ответ:

<response>
   <code>0</code>
   <descr>OK</descr>
</response>

Соединить клиента и водителя

Метод: POST

Название запроса: connect_client_and_driver

Параметры:

Параметр	Тип	Описание
Обязательные параметры
order_id	Целое	ИД заказа
signature	Строка	Поле для проверки секретного ключа

Специальные возвращаемые коды:

Код	Описание
100	Не найден заказ с таким ИД
103	В заказе нет водителя
104	У водителя не определен телефон

Возвращаемые данные в случае успешного выполнения запроса: нет

Пример:

Запрос:

POST https://ip:port/tm_tapi/1.0/connect_client_and_driver 
Content-Type: application/x-www-form-urlencoded
Content-Length: 53

order_id=13&signature=6a4b16da44a495b67eb7af11d51954d4

Ответ:

<response>
   <code>0</code>
   <descr>OK</descr>
</response>

Количество свободных экипажей на линии

Метод: GET

Название запроса: get_free_crews_count

Параметры:

Параметр	Тип	Описание
Обязательные параметры
signature	Строка	Поле для проверки секретного ключа
Необязательные параметры
crew_group_id	Целое	ИД группы экипажа предполагаемого заказа
uds_id	Целое	ИД службы ЕДС предполагаемого заказа

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
COUNT	Целое	Количество свободных экипажей на линии

Пример:

Запрос:
GET https://ip:port/tm_tapi/1.0/get_free_crews_count?
crew_group_id=1&uds_id=1&signature=88ca2091061c3e90123275f2c5df55a6 
Content-Type: application/x-www-form-urlencoded
Ответ:
<response>
<code>0</code>
<descr>OK</descr>
<data>
<COUNT>5</COUNT>
</data>
</response>

Запрос пользователя по логину софтфона

Метод: GET

Название запроса: get_user_by_sip_login

Параметры:

Параметр	Тип	Описание
Обязательные параметры
signature	Строка	Поле для проверки секретного ключа
login	Строка	Логин SIP-аккаунта

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
ID	Целое	ИД пользователя, который использует указанный логин SIP-аккаунта софтфона в данный момент
NAME	Строка	Имя пользователя, который использует указанный логин SIP-аккаунта софтфона в данный момент

Пример:

Запрос:
GET https://ip:port/tm_tapi/1.0/get_user_by_sip_login?
login=LOGIN&signature=9b06455cdfe933e7af12a35a70e9b1c6 
Content-Type: application/x-www-form-urlencoded
Ответ:
<response>
<code>0</code>
<descr>OK</descr>
<data>
<ID>1</ID>
<NAME>ADMINISTRATOR</NAME>
</data>
</response>

Установить режим «Перерыв» для линий софтфона

Метод: POST

Название запроса: set_sip_account_dnd_mode

Параметры:

Параметр	Тип	Описание
Обязательные параметры
dnd	Строка	0 или 1
user_login	Строка	Логин пользователя ТМ
lines	Строка	Список линий, разделенных символом «|»
signature	Строка	Поле для проверки секретного ключа

Специальные возвращаемые коды:

Код	Описание
100	Пользователь с таким логином или линиями не найден.

Возвращаемые данные в случае успешного выполнения запроса: нет

Пример:

Запрос:

POST https://ip:port/tm_tapi/1.0/set_sip_account_dnd_mode 
Content-Type: application/x-www-form-urlencoded
Content-Length: 66

dnd=1&user_login=USER&lines=101%7C102&signature=3e8107e0c044e55d983db1fbed82fd8c

Ответ:

<response>
  <code>0</code>
  <descr>OK</descr>
</response>

Запрос телефонов водителя по позывному экипажа

Метод: GET

Название запроса: get_driver_phones_by_crew_code

Параметры:

Параметр	Тип	Описание
Обязательные параметры
crew_code	Строка	Позывной экипажа

Специальные возвращаемые коды:

Код	Описание
100	Водитель не найден

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
mobile_phone	Строка	Основной телефон водителя
home_phone	Строка	Неосновной телефон водителя

Пример:

Запрос:

GET https://ip:port/tm_tapi/1.0/get_driver_phones_by_crew_code?
crew_code=CODE&signature=6f03bc45d3aa17f7738672180a3ee5de 
Content-Type: application/x-www-form-urlencoded

Ответ:

<response>
<code>0</code>
<descr>OK</descr>
<data>
<mobile_phone>123456789</mobile_phone>
<home_phone>987654321</home_phone>
</data>
</response>

Запрос информации о ключе защиты

Метод: GET

Название запроса: get_key_info

Параметры: нет.

Специальные возвращаемые коды: нет.

Возвращаемые данные в случае успешного выполнения запроса:

Параметр	Тип	Описание
company_name	Строка	Наименование организации
company_id	Целое	ИД организации
tm_server_license_count	Целое	Количество лицензий для TMServer
tm_license_count	Целое	Количество лицензий для TM2
tm_terminal_license_count	Целое	Количество лицензий для терминала
tm_driver_server_license_count	Целое	Количество лицензий для TMDriverServer
tm_driver_license_count	Целое	Количество лицензий для водителей
tm_sms_server_license_count	Целое	Количество лицензий для TMSMSServer

Пример:

Запрос:
GET https://ip:port/tm_tapi/1.0/get_key_info 
Content-Type: application/x-www-form-urlencoded

signature=6f03bc45d3aa17f7738672180a3ee5de

Ответ:

<response>
<code>0</code>
<descr>OK</descr>
<data>
company_name>ООО БИТ-Мастер</company_name>
<company_id>000</company_id>
<tm_server_license_count>1</tm_server_license_count>
<tm_license_count>10</tm_license_count>
<tm_terminal_license_count>1</tm_terminal_license_count>
<tm_driver_server_license_count>1</tm_driver_server_license_count>
<tm_driver_license_count>30</tm_driver_license_count>
<tm_sms_server_license_count>1</tm_sms_server_license_count>
</data>
</response>

Пример формы для заказа такси

Приведенная форма является примером, на основе которого можно построить собственную форму для принятия интернет-заказов. Форму можно использовать либо в исходном варианте, либо применяя запросы TM API. Для того, чтобы данная форма функционировала, необходимо открыть файл в любом текстовом редакторе и указать корректные IP-адрес сервера Такси-Мастер, порт TM API и секретный ключ. Далее вам следует загрузить файл на хостинг.

Форма, представленная в примере, будет выглядеть следующим образом: