Документация по использованию API RBTaxi 3.0

API реализованы на HTTP протоколе. Входом всегда является POST запрос. Выходом — JSON или XML тело.

Адрес интерфейса: https://api.rbtaxi.ru/v3/

Ответ всегда в UTF-8

Авторизация

Каждое обращение к API сопровождает процесс идентификации пользователя. Он необходим для разграничения прав доступа. Другими словами API для пользователей-диспетчеров отличаются от API для пользователей-директоров и Вы всегда сможете проследить, какой пользователь делал тот или иной запрос к API.

Для идентификации пользователя в системе необходимо в запросе передать параметр key:

Параметр Тип Описание
key string API v3 ключ
format string формат ответа JSON или XML
  • Доступные значения
  • xml
  • json (по умолчанию)
Здесь и далее жирным выделены обязательные для передачи параметры
Ключ для API v3 доступен директорам компании в редакторе диспетчера (Кабинет → Диспетчеры → выбор нужного диспетчера)
Пример HTTP POST-запроса:
POST /v3 HTTP/1.1
Host: api.rbtaxi.ru
User-Agent: MegaTaxi UserAgent v1.0
Connection: Keep-Alive
Content-type: application/x-www-form-urlencoded
Content-Length: 52

key=MTI6OjUwMGY2ODViYjJjMWZlMDJlOWUwMDJiYjcyODg0MWM3
// Все POST параметры передаются после пустой строки./

В данном примере запрос приходит от пользователя зарегистрированого ключем MTI6OjUwMGY2ODViYjJjMWZlMDJlOWUwMDJiYjcyODg0MWM3.

Ответ сервера, если переданы неверные значения пары логин/пароль
{
	result: null,
	error: {
		key: "WRONG_API_KEY",
	}
}

Коды ошибок

Параметр Описание
NOT_EMPTY обязательное поле
EMAIL неверное формат почты
EMAIL_NOT_RU почта должна быть в зоне .ru
EMAIL_IS_ACTIVE указанный адрес уже есть в системе
WRONG_ID неверный id
PHONE неверное значение телефона
MANDATORY обязательное для заполнения
ACCESS_DENIED доступ запрещен
BALANCE недостаточно средств
COMPANY_BALANCE недостаточно средств на счету компании
AGGREGATOR_COMPANY_BALANCE недостаточно средств на счету таксокомпании
ONLY_NUMBER только цифры
NOT_BELOW_ZERO значение должно быть больше либо равно 0
ONLY_POSITIVE_NUMBER число должно быть больше 0
YOUNG младше 18
NO_CHANGE нет изменений
UNIQUE должно быть уникальным
WRONG_SYMBOL недопустимые символы
WRONG_FORMAT неверный формат
WRONG_VALUE неверное значение
WRONG_PARAMS недопустимые параметры
WRONG_PASSWORD минимальная длина 5 символов
WRONG_DATE_FORMAT неверный формат даты
WRONG_URL неверный формат адреса сайта
WRONG_PERCENT неверное процентное значение
WRONG_TIME_FORMAT неверный формат времени
WRONG_API_KEY WRONG_API_KEY
WRONG_METHOD неверный метод
VAR_NOT_FOUND значение не найдено
CITY_NOT_FOUND город не найден
AUTOCLASS_NOT_FOUND класс авто не найден
TYPE_NOT_FOUND тип не найден
FILE_NOT_FOUND файл не найден
PERMISSION_DENIED доступ запрещен
SELECT_COLOR выберите цвет из списка
UNKNOWN неизвестная ошибка
BLOCK Ваш аккаунт заблокирован
CURL Ошибка cURL
JSON Ошибка JSON
ORDER_NOT_MY Вы не являетесь автором/исполнителем заказа
ORDER_AUTHOR Вы являетесь автором заказа
ORDER_NOT_FOUND заказ не найден
ORDER_COMPANY_NOT_SINGER Вы не являетесь исполнителем заказа
ORDER_WRONG_STATUS неверный статус заказа
ORDER_WRONG_PERCENT неверный процент по заказу
ORDER_DEADLINE время меньше текущего
ORDER_EXTRA_DEADLINE большой промежуток времени для срочного заказа
ORDER_OPTION_NOT_FOUND опция не найдена
ORDER_WRONG_OPTION опция не может быть выбрана
ORDER_AUTO_EMPTY для проставления статуса необходимо назначить водителя или указать автомобиль
ORDER_DUPLICATE_EXTERNAL_ID заказ с указанным externalId уже есть
ORDER_WRONG_PERCENT_START превышен максимально допустимый процент
ORDER_ONLY_DRIVER заказ только для водителей
ORDER_STATUS_WORK заказ находится в работе
ORDER_STATUS_DONE заказ выполнен
ORDER_STATUS_AUCTION начались торги
ORDER_ANOTHER_CITY заказ из другого города
ORDER_WRONG_ADDRESS_CITY не найден город спутник
ORDER_REFUSED заказ уже был получен ранее, но Вы отказались от его исполнения
ORDER_RATE_NOT_SET ставка за заказ не сделана
ORDER_AUCTION_FINISH торги окончены
ORDER_CANCEL_COMPANY Ваша компания находится в запрете
ORDER_WRONG_MIN_PRICE сумма не может быть меньше минимальной
ORDER_WRONG_MAX_PRICE_BEZNAL сумма не может быть более 5000р
ORDER_WRONG_MIN_PRICE_BEZNAL сумма не может быть более 500р
ORDER_NOT_PERMISSION_PRICE_BEZNAL у вас нет прав на добавление -безнал
ORDER_LAST_RATE Ваша ставка последняя
ORDER_DRIVER_OTHER_RATE Вы сделали ставку за другой заказ
ORDER_COMMENT_REQUIRED при изменении цены заполните комментарий
ORDER_LESS_THEN_MIN_BEZNAL Минимальная сумма для безналичного заказа 100 руб
ORDER_MAX_MINUS_BEZNAL Сумма заказа меньше -безнал
ORDER_BEWARE_ISSET есть жалоба на клиента
ORDER_ALREADY_CANCEL уже отказывались от заказа
ORDER_PHONE_ENCODE_DISABLED шифрование номера телефона отключено
ORDER_CHANGED_WHEN_RATE Заказ был изменён в процессе взятия, повторите попытку
ORDER_DONE_EDIT_TIME_OVER время изменение заказа истекло
ORDER_DONE_EDIT_ACTIVE по данному заказу есть активные запросы на изменения
ORDER_DONE_EDIT_NOT_DONE заказ не выполнен
ORDER_DONE_EDIT_CANT_CHANGE_TYPE тип данного заказа не может быть изменен
DRIVER_NOT_FOUND водитель не найден
DRIVER_AUTOCLASS_FAILS автокласс не соответствует
DRIVER_OPTION_FAILS опции не соответствуют
DRIVER_ORDER_NOT_DONE имеет незакрытые заказы
DRIVER_CANT_TAKE_RBT_ORDER водитель не может выполнять биржевые заказы
DRIVER_CANT_TAKE_MY_ORDER водитель не может выполнять заказы своей компании
DRIVER_WRONG_AUTOCLASS неверный автокласс
DRIVER_NOT_MANY_ORDER Вы не можете брать несколько заказов одновременно
DRIVER_WRONG_AUTO_AGE неверно указан возраст автомобиля
DRIVER_CANT_TAKE нельзя взять этот заказ
DRIVER_CANCEL автор запретил Вам брать свои заказы
GROUP_GLOBAL_NOT_LEAVE Вы не можете покинуть глобальную группу
COMPANY_NOT_FOUND компания не найдена
COMPANY_WAS_DELETE компания удалена
COMPANY_WAS_BANNED компания забанена
COMPANY_SAME_INN ИНН компаний совпадает
USER_NOT_FOUND пользователь не найден
USER_WRONG_AGE неверно указан возраст
USER_LIMIT_OVERDRAWN превышен лимит пользователей
ABUSE_NOT_PERMISSION_CREATE Вы не можете выставить спор по данному заказу
ABUSE_STATUS_NOT_PERMISSION слово передано другой компании
ABUSE_WAS_CANCEL спор был отменен ранее
CLIENT_DUPLICATE_PHONE клиент с таким номером телефона уже есть
EXCHANGE_BLOCKED_BANNED Биржа недоступна: Ваша компания заблокирована
EXCHANGE_BLOCKED_BALANCE Биржа заблокирована: недостаточно средств на счету
EXCHANGE_BLOCKED_BEZNAL Биржа заблокирована: есть незакрытые заказы
EXCHANGE_BLOCKED_ORDER Биржа заблокирована: есть незакрытые заказы
EXCHANGE_BLOCKED_DONE_EDIT Биржа заблокирована: есть запросы изменения
EXCHANGE_BLOCKED_ABUSE Биржа заблокирована: есть неоплаченные штрафы
TARIF_LAST_IN_FORM Это последний тариф в форме, чтобы продолжить - удалите его из формы или добавьте другие тарифы
CHAT_MESSAGE_TOO_LONG Максимальная длина одного сообщения 1000 символов
CHAT_MESSAGE_TOO_SHORT Минимальная длина одного сообщения 5 символов
TAXIMETER_ADDRESS_GEOCODE Не удалось геокодировать один из адресов
TAXIMETER_ROUTER_ERROR Внутренняя ошибка роутера
TAXIMETER_ROUTER_STATUS Неверный ответ роутера
AUTOCLASS_MANDATORY Выберите хотя бы один класс авто
AUTOCLASS_WRONG_AUTO Авто не подходит под заказ
AGGREGATOR_WRONG_STATUS Компания не приняла условия сотрудничества
AGGREGATOR_PAY_DATE_7_DAY До конца платежного периода осталось более 7 дней
ATTEMPT_COUNT Превышено количество попыток
REQUEST_ERROR Ошибка запроса к серверу
EMPTY_URL Ошибка запроса к серверу
MIN_LENGTH_5 Минимальная длина - 5 символов
RUNTEL_INTEGRATION_ERROR Ошибка интеграции с Runtel
RUNTEL_API_KEY_NOT_SET Не задан API-ключ
MAX_LENGTH_400 Максимальная длина 400 символов
MAX_LENGTH_100 Максимальная длина 100 символов
MAX_LENGTH_30 Максимальная длина 30 символов
MOUTPUT_LAST_TEMPLATE Нельзя удалить последний шаблон

Заказы

Добавление заказа

/v3/order/add

Параметр Тип Описание
city int город
  • 1 – Москва
  • 2 – Санкт-Петербург
  • 4 – Екатеринбург
  • 5 – Нижний Новгород
  • 11 – Уфа
  • 16 – Краснодарский край
  • 19 – Красноярск
  • 22 – Мурманск
  • 23 – Новосибирск
  • 24 – Республика Крым
  • 25 – Казань
  • 26 – Тюмень
  • 27 – Ставропольский край
  • 28 – Анталья
  • 29 – Центральное Черноземье
  • 30 – Липецк
phone string телефон клиента
  • (999) 999-99-99
  • 9999999999
countryCode string Код страны (если не заполнено, то по умолчанию 7 Россия)
phoneExtension string Добавочный номер телефона
name string имя клиента
deadline string время подачи
  • ДД.ММ.ГГГГ ЧЧ:ММ:00 - секунды будут обнулены
extra int (1/0) отмечает заказ срочным
  • время до подачи не может превышать 60мин
  • заказ будет доступен без торгов
autoclass string класс автомобиля
  • 1 – Комфорт
  • 2 – Бизнес
  • 3 – Универсал
  • 4 – Эконом
  • 5 – Минивэн
  • 6 – Микроавтобус
tarifType string тип расчета по заказу
  • fix – фиксированная стоимость
  • id – сохраненный тариф
  • min – тариф с поминутной оплатой
  • km – тариф с километровой оплатой
tarifId1 int ID сохраненного тарифа
только для tarifType=id
tarifFix1 int цена заказа
только для tarifType=fix или tarifType=id
tarifCustom1 array произвольный тариф
  • [320,20,10,1] (320 за 20 мин поездки + 10 за 1 мин)
  • [320,20,10,1] (300 за 20 км поездки + 10 за 1 км)
только для tarifType=min или tarifType=km
priceBeznal int сумма, которая будет доплачена (или возвращена если priceBeznal < 0) по безналу после закрытия заказа
street2 array список улиц поездки
home2 array список домов поездки
block2 array список корпусов поездки
build2 array список строений поездки
porch2 array список подъездов поездки
latitude array список широты адресов
longitude array список долготы адресов
option[smoking] int (1/0) Курить
option[nosmoking] int (1/0) Не курить
option[english] int (1/0) Водитель со знанием английского
option[animal] int (1/0) Пассажир с животным
option[card] int (1/0) Терминал для кредитных карт
option[baggage]1 int (1/0) Клиент с багажом
option[ski] int (1/0) Клиент с лыжами/сноубордом
option[unmarked] int (1/0) Машина без знаков такси
только для tarifType=fix
option[beznal] int (1/0) Заказ оплачивается безналично
option[noadv] int (1/0) Машина без рекламы
option[radio]1 int (1/0) Радио
option[kid]1 int (1/0) Детское кресло
option[flight]1 int (1/0) Отследить рейс
option[nameplate]1 int (1/0) Встреча с табличкой
option[delivery]1 int (1/0) Доставка
radioVal string какое радио следует включить в машине на время поездки
только для option[radio]=1
baggageText string Описание багажа
только для option[baggage]=1
baggageBig int (1/0) Негабаритный багаж
только для option[baggage]=1
kidType string|array Тип детского удерживающего устройства
  • сradle – Люлька
  • chair – Кресло
  • booster – Бустер
kidYear int|array Возраст ребенка
если необходимо указать возвраст ребенка для нескольких опций: kidYear[]=1&kidYear[]=2 (первая опция на 1 год, вторая на 2 года) только для option[kid]=1
kidWeight int|array Вес ребенка
если необходимо указать возвраст ребенка для нескольких опция: kidWeight[]=12&kidWeight[]=14 (первая опция на 12 кг, вторая на 14 кг) только для option[kid]=1
flightNumber string номер рейса
только для option[flight]=1
deliveryLift int (1/0) Подъем на этаж, только для option[delivery]
deliveryPhone string Номер телефона грузополучателя, только для option[delivery]=1
deliveryFloor string Этаж, только для deliveryLift=1
deliveryFlat string Квартира, только для deliveryLift=1
nameplateText string текст на табличке
только для option[nameplate]=1
metro string ближайшее метро к адресу подачи
comment string комментарий к заказу
  • 160 символов
note string примечание к заказу
rbt int (1/0) область видимости заказа
onlyDriver int (1/0) заказ доступен только водителям
groupList array определяет список групп которому доступен заказ
только для rbt=1
myClient int (1/0) телефон доступен только своим водители
smsOff int (1/0) не отправлять смс-уведомления клиенту по текущему заказу
allClient3 int (1/0) телефон доступен всем водители
assignType int ID-водителя, для назначения водителя
percentStart int начальный процент по заказу
значение должно находиться в диапазоне 0..29
  • 0 – номинал -9%
  • 9 – номинал
  • 29 – номинал +20%

При добавлении и редактировании заказа учитывается опция Горящие заказы
atype4 string тип автомобиля
  • taxi – Такси
  • fraht – Фрахта (по умолчанию, если не передан параметр)
externalId string ID заказа в Вашей системе (только для добавления заказа)
  • 1. параметр требует передачи дополнительного параметра
  • 2. необходимо указать не менее двух и не более пяти адресов
  • 3. данный параметр отменяет действие параметра myClient
  • 4. если передано значение fraht, то поле name становится обязательным
Ответ при успешном добавлении заказа
{
	error: "",
	id: 2528334
}

Изменение заказа

/v3/order/edit

Параметр Тип Описание
id int ID заказа, который нужно изменить

Другие параметры метода см. Добавление заказа

Отправка на биржу

/v3/order/to_rbt

Параметр Тип Описание
order int ID заказа, который нужно отправить на биржу
action string подустимые значения
  • add – добавить
  • remove – снять

Показать телефон клиента

/v3/order/show_phone

Параметр Тип Описание
order int ID заказа
Ответ
{
	error: null,
	name: "Иван",
	phone: 0000000000
}

Информация

/v3/order/info

Параметр Тип Описание
id int ID заказа, по которому нужна информация
cut string Обрезает возвращаемые данные
  • update – Вернет последнее время обновления и статус
  • singer – Вернет информацию по исполнителю
Расшифровка полей
{
	id: 2528317,	// id заказа
	user: 815,		// id пользователя, который добавил заказ
	company: 4,		// id компании-автора заказа
	date: "2014-12-12 14:59:16",
	beware: [ ],	// жалобы на заказ
	blacklist: [	// телефон клиента в черном списке
		{
			company: 11,
			date: "2012-12-12 13:24:59",
			comment: "Отказался скидываться на бензин"
		},
		{
			company: 67,
			date: "2014-03-21 12:19:34",
			comment: "Мусорит в салоне"
		}
	],
	city: 1,			// город
	status: "start",	// статус
	statusChar: "",		// под-статус
	rbt: 1,				// виден ли заказ на бирже
	name: "Василий",	// имя клиента
	comment: "Произвольный заказ с весьма зауреадным комментарием.",
	price: 0,			// цена для заказов "Фикс"
	priceBeznal: 0,		// сумма, которая будет перечислена по безналу, после закрытия
	priceDone: 0,		// сумма поездки после закрытия заказа
	priceOption: [ ],	// цены опций
	tarifId: 0,			// id-тарифа
	tarifData: "[]",		// данные по тарифу
	tarif: "320/20/10/1",	// тариф
	utype: "min",			// тип тарификации мин/км
	percent: 10,			// текущий % по заказу
	percentPartner: 8,		// % полученный автором
	deadline: "2014-12-16 11:43:54",	// время подачи
	deadlineChanged: "0000-00-00 00:00:00",
	route: [	// маршрут
		{
			street: "пер. Верхний Михайловский",	// улица
			home: 32,				// дом
			block: "",				// корпус
			build: "",				// строение
			porch: "",				// подъезд
			client: "0000-00-00 00:00:00",		// во сколько водитель подъехал
			clientMove: "0000-00-00 00:00:00",	// во сколько выехал с клиентом
			address: "пер. Верхний Михайловский, д. 32"	// полный адрес
		},
		{
			street: "ул. Вавилова",
			home: 37,
			block: "",
			build: "",
			porch: "",
			client: "0000-00-00 00:00:00",
			clientMove: "0000-00-00 00:00:00",
			address: "ул. Вавилова, д. 37"
		}
	],
	auction: [ ],
	phone: 3261786322,	// телефон клиента
	phoneExtension: 123, // добавочный номер
	countryCode: 7,		// код страны
	metro: "",			// ближайшее метро
	update: "2014-12-12 14:59:17",
	singer: 0,		// id исполнителя заказа
	companySinger: 0,	// id компании-исполнителя заказа
	driver: 0,		// id водитедя исполняющего заказ
	showPhone: 0,		// телефон клиента показан
	autoclass: 1,		// класс авто
	latitude: 59.928429,
	longitude: 30.328885,
	takeCompany: [ ],
	abuse: null,
	auto: { // информация об автомобиле
		gnumber: "Х876ЕЕ777",
		abrand: "Skoda",
		amodel: "Fabia",
		acolor: "зелёный",
		ayear: 2011,
		phone: 9269999999
	},
	driverPosition: { // координаты авто
		latitude: 55.704427,
		longitude: 37.605413,
		lastGeo: "2016-03-09 14:03:47" // время последней координаты
	},
	auctionLastUser: 0,
	auctionLastCompany: 0,
	nextStatus: "move",	// какой статус ожидается
	cancel: false,		// запрещено ли брать заказа
	source: "beta",
	option: {			// список опций
		english: 0,
		animal: 0,
		card: 0,
		baggage: 0,
		nosmoking: 0,
		smoking: 0,
		ski: 0,
		unmarked: 0,
		beznal: 0,
		noadv: 0,
		marked: 0,
		radio: 0,
		kid: 0
	},
	optionVal: [ ],					// дополнительные значения по опциям
	done: "0000-00-00 00:00:00",	// во сколько закрыт
	husky: 0,
	huskycode: "",
	geoDecoded: 1,
	type: "tarif",
	archive: false,
	allClient: 1,
	myClient: 1,
	auctionStart: -62169993017,
	auctionTime: 1,
	externalId: "",
	log: [
		{
			company: 4,
			user: 3,
			level: "director",
			date: "2015-06-26 11:47:07",
			status: "start",
			comment: ""
		},
		{
			company: 4,
			user: 3,
			level: "director",
			date: "2015-06-26 11:47:39",
			status: "move",
			comment: {
				gnumber: "рн375о99",
				abrand: "Aston Martin",
				amodel: "Rapide",
				acolor: "бежевый",
				ayear: 2012,
				phone: 1
			}
		},
		{
			company: 4,
			user: 3,
			level: "director",
			date: "2015-06-26 11:47:39",
			status: "client",
			comment: ""
		},
		{
			company: 4,
			user: 3,
			level: "director",
			date: "2015-06-26 11:47:40",
			status: "client-move",
			comment: ""
		},
		{
			company: 4,
			user: 3,
			level: "director",
			date: "2015-06-26 11:47:42",
			status: "done",
			comment: 350
		}
	]
}

Закрытие

/v3/order/done

Параметр Тип Описание
id int ID заказа, который нужно закрыть
price int сумма

Удаление

/v3/order/delete

Параметр Тип Описание
id int ID заказа, который нужно закрыть
comment string причина удаления

Восстановление

/v3/order/restore

Параметр Тип Описание
id int ID заказа, который нужно восстановить

Отказ

/v3/order/cancel

Параметр Тип Описание
id int ID заказа, от которого нужно отказаться
action string отказаться с удалением или без
  • delete – удалить заказ
  • cancel – вернуть в биржу
comment string причина отказа от заказа

Простановка статусов

/v3/order/next_status

Для проставления статуса заказу, необходимо назначить водителя либо внести информацию об авто

Параметр Тип Описание
order int ID заказа
status string Статус заказа
  • move – Водитель едет к клиенту
  • client – Машина подана
  • client-move – Машина в пути с клиентом к месту назначения
Ответ если отсуствует информация об авто
{
	error: "wrong auto",
	status:"move"
}
Ответ при неверно переданном статусе
{
	error: "wrong status",
	status: "move"
}

Статусы заказов

Статус
(status)		 Под-статус
(statusChar)		 Описание
start Заказ создан
start cancel Отказ от заказа с возвратом в обменник
start delete Отказ от заказа с удалением
start restore Восстановление заказа после отказа
auction За заказ идут торги
auction no-auction Заказ взят без торгов
work start Заказ взят
work move Движение к клиенту
work client Ожидание клиента
work client-move Движение с клиентом
work done Заказ завершен, ожидание оплаты
done Заказ завершен и оплачен
delete Заказ удалён

Назначение водителю / указание авто

/v3/order/assign

Параметр Тип Описание
order int ID заказа, который нужно назначить
driver int ID водителя, кому нужно назначить
abrand1 string марка авто
amodel1 string модель авто
gnumber1 string гос. номер
acolor1 string цвет авто2
  • 1. указывается в случае если информация об авто не соответствует информации из профиля водителя
  • 2. см. параметр acolor в методе Добавление водителя

Список заказов

/v3/order/list

Параметр Тип Описание
cut string Обрезает возвращаемые данные
  • update – Вернет последнее время обновления и статус
Ответ
[
	{
		id: 2528335,
		user: 815,
		company: 4,
		date: "2014-12-16 15:36:05",
		beware: [],
		blacklist: [],
		city: 1,
		status: "start",
		statusChar: "",
		rbt: 1,
		name: "Василий",
		comment: "Произвольный заказ с весьма зауреадным комментарием.",
		price: 0,
		priceBeznal: 0,
		priceDone: 0,
		priceOption: [],
		tarifId: 0,
		tarifData: {
			city: 1,
			dayFrom: "07:00",
			dayTo: "21:00",
			kad: [
				10,
				1
			],
			outcity: [
				30,
				1
			],
			outcityGiving: [
				"",
				1
			],
			english: 100,
			animal: 150,
			kid: "",
			baggage: "",
			ski: ""
		},
		tarif: "320/20/10/1",
		utype: "km",
		percent: 9,
		deadline: "2014-12-18 16:21:00",
		deadlineChanged: "0000-00-00 00:00:00",
		route: [
			{
				street: "ул. Арбат",
				home: 59,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Арбат, д. 59"
			},
			{
				street: "ул. Медынская",
				home: 39,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Медынская, д. 39"
			}
		],
		auction: [],
		phone: 4067278144,
		phoneExtension: 123,
		countryCode: 7,
		metro: "",
		update: "2014-12-16 15:36:07",
		singer: 0,
		companySinger: 0,
		driver: 0,
		showPhone: 0,
		autoclass: 1,
		latitude: 55.747343,
		longitude: 37.585233,
		takeCompany: [],
		abuse: null,
		auto: { // информация об автомобиле
			gnumber: "Х876ЕЕ777",
			abrand: "Skoda",
			amodel: "Fabia",
			acolor: "зелёный",
			ayear: 2011,
			phone: 9269999999
		},
		driverPosition: { // координаты авто
			latitude: 55.704427,
			longitude: 37.605413,
			lastGeo: "2016-03-09 14:03:47" // время последней координаты
		},
		auctionLastUser: 0,
		auctionLastCompany: 0,
		nextStatus: "move",
		cancel: false,
		source: "beta",
		option: {
			english: 0,
			animal: 0,
			card: 0,
			baggage: 0,
			nosmoking: 0,
			smoking: 0,
			ski: 0,
			unmarked: 0,
			beznal: 0,
			noadv: 0,
			marked: 0,
			radio: 0,
			kid: 0
		},
		optionVal: [],
		done: "0000-00-00 00:00:00",
		husky: 0,
		huskycode: "",
		geoDecoded: 1,
		type: "tarif",
		archive: false,
		allClient: 1,
		myClient: 1,
		auctionStart: -62169993017,
		auctionTime: 1
	},
	{
		id: 2528336,
		user: 815,
		company: 4,
		date: "2014-12-16 15:36:05",
		beware: [],
		blacklist: [],
		city: 1,
		status: "start",
		statusChar: "",
		rbt: 1,
		name: "Акакий",
		comment: "Произвольный заказ с весьма зауреадным комментарием.",
		price: 0,
		priceBeznal: 0,
		priceDone: 0,
		priceOption: [],
		tarifId: 0,
		tarifData: {
			city: 1,
			dayFrom: "07:00",
			dayTo: "21:00",
			kad: [
				10,
				1
			],
			outcity: [
				30,
				1
			],
			outcityGiving: [
				"",
				1
			],
			english: 100,
			animal: 150,
			kid: "",
			baggage: "",
			ski: ""
		},
		tarif: "320/20/10/1",
		utype: "min",
		nominal: 1,
		percentEnd: 0,
		percentStart: 9,
		deadline: "2014-12-22 06:54:00",
		deadlineChanged: "0000-00-00 00:00:00",
		route: [
			{
				street: "ул. Тверская",
				home: 15,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Тверская, д. 15"
			},
			{
				street: "ул. Плеханова",
				home: 48,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Плеханова, д. 48"
			}
		],
		auction: [],
		phone: 3457807273,
		metro: "",
		update: "2014-12-16 15:36:07",
		singer: 0,
		companySinger: 0,
		driver: 0,
		showPhone: 0,
		autoclass: 4,
		latitude: 55.76174,
		longitude: 37.608311,
		takeCompany: [],
		abuse: null,
		auto: null,
		auctionLastUser: 0,
		auctionLastCompany: 0,
		nextStatus: "move",
		cancel: false,
		source: "beta",
		option: {
			english: 0,
			animal: 0,
			card: 0,
			baggage: 0,
			nosmoking: 0,
			smoking: 0,
			ski: 0,
			unmarked: 0,
			beznal: 0,
			noadv: 0,
			marked: 0,
			radio: 0,
			kid: 0
		},
		optionVal: [],
		done: "0000-00-00 00:00:00",
		husky: 0,
		huskycode: "",
		geoDecoded: 1,
		type: "tarif",
		archive: false,
		allClient: 1,
		myClient: 1,
		auctionStart: -62169993017,
		auctionTime: 1
	},
	{
		id: 2528337,
		user: 6,
		company: 6,
		date: "2014-12-16 15:36:20",
		beware: [],
		blacklist: [],
		city: 1,
		status: "start",
		statusChar: "",
		rbt: 1,
		name: "Пафнутий",
		comment: "Произвольный заказ с весьма зауреадным комментарием.",
		price: 0,
		priceBeznal: 0,
		priceDone: 0,
		priceOption: [],
		tarifId: 0,
		tarifData: [],
		tarif: "320/20/10/1",
		utype: "min",
		nominal: 1,
		percentEnd: 0,
		percentStart: 9,
		deadline: "2014-12-20 19:52:00",
		deadlineChanged: "0000-00-00 00:00:00",
		route: [
			{
				street: "ул. Плеханова",
				home: 25,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Плеханова, д. 25"
			},
			{
				street: "ул. Тверская",
				home: 42,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Тверская, д. 42"
			}
		],
		auction: [],
		phone: "",
		metro: "",
		update: "2014-12-16 15:36:21",
		singer: 0,
		companySinger: 0,
		driver: 0,
		showPhone: 0,
		autoclass: 1,
		latitude: 55.744272,
		longitude: 37.767043,
		takeCompany: [],
		abuse: null,
		auto: null,
		auctionLastUser: 0,
		auctionLastCompany: 0,
		nextStatus: "move",
		cancel: false,
		source: "beta",
		option: {
			english: 0,
			animal: 0,
			card: 0,
			baggage: 0,
			nosmoking: 0,
			smoking: 0,
			ski: 0,
			unmarked: 0,
			beznal: 0,
			noadv: 0,
			marked: 0,
			radio: 0,
			kid: 0
		},
		optionVal: [],
		done: "0000-00-00 00:00:00",
		husky: 0,
		huskycode: "",
		geoDecoded: 1,
		type: "tarif",
		archive: false,
		allClient: 1,
		myClient: 1,
		auctionStart: -62169993017,
		auctionTime: 1
	},
	{
		id: 2528338,
		user: 6,
		company: 6,
		date: "2014-12-16 15:36:20",
		beware: [],
		blacklist: [],
		city: 1,
		status: "start",
		statusChar: "",
		rbt: 1,
		name: "Еремей",
		comment: "Произвольный заказ с весьма зауреадным комментарием.",
		price: 0,
		priceBeznal: 0,
		priceDone: 0,
		priceOption: [],
		tarifId: 0,
		tarifData: [],
		tarif: "320/20/10/1",
		utype: "min",
		nominal: 1,
		percentEnd: 0,
		percentStart: 9,
		deadline: "2014-12-18 03:08:00",
		deadlineChanged: "0000-00-00 00:00:00",
		route: [
			{
				street: "ул. Плеханова",
				home: 24,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Плеханова, д. 24"
			},
			{
				street: "ул. Молодогвардейская",
				home: 23,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Молодогвардейская, д. 23"
			}
		],
		auction: [],
		phone: "",
		metro: "",
		update: "2014-12-16 15:36:21",
		singer: 0,
		companySinger: 0,
		driver: 0,
		showPhone: 0,
		autoclass: 2,
		latitude: 55.741348,
		longitude: 37.76742,
		takeCompany: [],
		abuse: null,
		auto: null,
		auctionLastUser: 0,
		auctionLastCompany: 0,
		nextStatus: "move",
		cancel: false,
		source: "beta",
		option: {
			english: 0,
			animal: 0,
			card: 0,
			baggage: 0,
			nosmoking: 0,
			smoking: 0,
			ski: 0,
			unmarked: 0,
			beznal: 0,
			noadv: 0,
			marked: 0,
			radio: 0,
			kid: 0
		},
		optionVal: [],
		done: "0000-00-00 00:00:00",
		husky: 0,
		huskycode: "",
		geoDecoded: 1,
		type: "tarif",
		archive: false,
		allClient: 1,
		myClient: 1,
		auctionStart: -62169993017,
		auctionTime: 1
	},
	{
		id: 2528339,
		user: 12,
		company: 11,
		date: "2014-12-16 15:36:52",
		beware: [],
		blacklist: [],
		city: 1,
		status: "start",
		statusChar: "",
		rbt: 1,
		name: "Илья",
		comment: "Произвольный заказ с весьма зауреадным комментарием.",
		price: 0,
		priceBeznal: 0,
		priceDone: 0,
		priceOption: [],
		tarifId: 0,
		tarifData: [],
		tarif: "320/20/10/1",
		utype: "min",
		nominal: 1,
		percentEnd: 0,
		percentStart: 9,
		deadline: "2014-12-16 17:11:00",
		deadlineChanged: "0000-00-00 00:00:00",
		route: [
			{
				street: "ул. Котляковская",
				home: 10,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Котляковская, д. 10"
			},
			{
				street: "ул. Медынская",
				home: 44,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Медынская, д. 44"
			}
		],
		auction: [],
		phone: "",
		metro: "",
		update: "2014-12-16 15:36:54",
		singer: 0,
		companySinger: 0,
		driver: 0,
		showPhone: 0,
		autoclass: 4,
		latitude: 55.643978,
		longitude: 37.640452,
		takeCompany: [],
		abuse: null,
		auto: null,
		auctionLastUser: 0,
		auctionLastCompany: 0,
		nextStatus: "move",
		cancel: false,
		source: "beta",
		option: {
			english: 0,
			animal: 0,
			card: 0,
			baggage: 0,
			nosmoking: 0,
			smoking: 0,
			ski: 0,
			unmarked: 0,
			beznal: 0,
			noadv: 0,
			marked: 0,
			radio: 0,
			kid: 0
		},
		optionVal: [],
		done: "0000-00-00 00:00:00",
		husky: 0,
		huskycode: "",
		geoDecoded: 1,
		type: "tarif",
		archive: false,
		allClient: 1,
		myClient: 1,
		auctionStart: -62169993017,
		auctionTime: 1
	},
	{
		id: 2528340,
		user: 12,
		company: 11,
		date: "2014-12-16 15:36:53",
		beware: [],
		blacklist: [],
		city: 1,
		status: "start",
		statusChar: "",
		rbt: 1,
		name: "Илья",
		comment: "Произвольный заказ с весьма зауреадным комментарием.",
		price: 0,
		priceBeznal: 0,
		priceDone: 0,
		priceOption: [],
		tarifId: 0,
		tarifData: [],
		tarif: "320/20/10/1",
		utype: "min",
		nominal: 1,
		percentEnd: 0,
		percentStart: 9,
		deadline: "2014-12-20 13:31:00",
		deadlineChanged: "0000-00-00 00:00:00",
		route: [
			{
				street: "ул. Тверская",
				home: 27,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Тверская, д. 27"
			},
			{
				street: "ул. Плеханова",
				home: 78,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Плеханова, д. 78"
			}
		],
		auction: [],
		phone: "",
		metro: "",
		update: "2014-12-16 15:36:53",
		singer: 0,
		companySinger: 0,
		driver: 0,
		showPhone: 0,
		autoclass: 2,
		latitude: 55.768005,
		longitude: 37.598052,
		takeCompany: [],
		abuse: null,
		auto: null,
		auctionLastUser: 0,
		auctionLastCompany: 0,
		nextStatus: "move",
		cancel: false,
		source: "beta",
		option: {
			english: 0,
			animal: 0,
			card: 0,
			baggage: 0,
			nosmoking: 0,
			smoking: 0,
			ski: 0,
			unmarked: 0,
			beznal: 0,
			noadv: 0,
			marked: 0,
			radio: 0,
			kid: 0
		},
		optionVal: [],
		done: "0000-00-00 00:00:00",
		husky: 0,
		huskycode: "",
		geoDecoded: 1,
		type: "tarif",
		archive: false,
		allClient: 1,
		myClient: 1,
		auctionStart: -62169993017,
		auctionTime: 1
	},
	{
		id: 2528341,
		user: 12,
		company: 11,
		date: "2014-12-16 15:36:53",
		beware: [],
		blacklist: [],
		city: 1,
		status: "start",
		statusChar: "",
		rbt: 1,
		name: "Василий",
		comment: "Произвольный заказ с весьма зауреадным комментарием.",
		price: 0,
		priceBeznal: 0,
		priceDone: 0,
		priceOption: [],
		tarifId: 0,
		tarifData: [],
		tarif: "320/20/10/1",
		utype: "km",
		nominal: 1,
		percentEnd: 0,
		percentStart: 9,
		deadline: "2014-12-18 23:01:00",
		deadlineChanged: "0000-00-00 00:00:00",
		route: [
			{
				street: "ул. Медынская",
				home: 22,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Медынская, д. 22"
			},
			{
				street: "ул. Плеханова",
				home: 35,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Плеханова, д. 35"
			}
		],
		auction: [],
		phone: "",
		metro: "",
		update: "2014-12-16 15:36:54",
		singer: 0,
		companySinger: 0,
		driver: 0,
		showPhone: 0,
		autoclass: 2,
		latitude: 55.58382,
		longitude: 37.645492,
		takeCompany: [],
		abuse: null,
		auto: null,
		auctionLastUser: 0,
		auctionLastCompany: 0,
		nextStatus: "move",
		cancel: false,
		source: "beta",
		option: {
			english: 0,
			animal: 0,
			card: 0,
			baggage: 0,
			nosmoking: 0,
			smoking: 0,
			ski: 0,
			unmarked: 0,
			beznal: 0,
			noadv: 0,
			marked: 0,
			radio: 0,
			kid: 0
		},
		optionVal: [],
		done: "0000-00-00 00:00:00",
		husky: 0,
		huskycode: "",
		geoDecoded: 1,
		type: "tarif",
		archive: false,
		allClient: 1,
		myClient: 1,
		auctionStart: -62169993017,
		auctionTime: 1
	}
]

Обновление записи разговора

/v3/order/voice_update/

Только для компаний агрегаторов

Параметр Тип Описание
order int ID заказа
voice string ID разговора в Вашей системе
company int ID компании к которой относится звонок
phone string Телефон клиента
time int Продолжительность разговора в секундах
incoming int (1/0) Входящий звонок

Смена типа оплаты с безналичного на наличный

/v3/order/to_cash

Изменение типа оплаты заказа с безналичного на наличный во время выполнения заказа. Данный метод доступен только для автора заказа.

Параметр Тип Описание
order int ID заказа

Грузы

Добавление груза

/v3/cargo/add

Параметр Тип Описание
city int город
  • 1 – Москва
  • 2 – Санкт-Петербург
  • 4 – Екатеринбург
  • 5 – Нижний Новгород
  • 11 – Уфа
  • 16 – Краснодарский край
  • 19 – Красноярск
  • 22 – Мурманск
  • 23 – Новосибирск
  • 24 – Республика Крым
  • 25 – Казань
  • 26 – Тюмень
  • 27 – Ставропольский край
  • 28 – Анталья
  • 29 – Центральное Черноземье
  • 30 – Липецк
phone string телефон клиента
  • (999) 999-99-99
  • 9999999999
name string имя клиента
deadline string время подачи
  • ДД.ММ.ГГГГ ЧЧ:ММ:СС
duration int 1-12 продолжительность перевозки (в часах, по умолчанию - 1)
autoclass string класс автомобиля
  • 1 – Любой
  • 2 – Тент
  • 3 – Борт
  • 4 – Фургон
  • 5 – Только грузчики
tarifType string тип расчета по грузу
  • fix – фиксированная стоимость
  • id – сохраненный тариф
  • min – тариф с повременной оплатой
tarifId1 int ID сохраненного тарифа
только для tarifType=id
tarifFix1 int цена перевозки груза
только для tarifType=fix или tarifType=id
tarifCustom1 array произвольный тариф
  • [1000,2,600] (1000 за 2 часа поездки + 600 за 1 час)
только для tarifType=min
priceBeznal int сумма, которая будет доплачена (или возвращена если priceBeznal < 0) по безналу после закрытия заказа
addressCity2 array список городов спутников поездки
значение данного параметра ID города из базы ФИАС (справочник доступен в API)
street2 array список улиц поездки
home2 array список домов поездки
block2 array список корпусов поездки
build2 array список строений поездки
porch2 array список подъездов поездки
latitude array список широты адресов
longitude array список долготы адресов
option[loadinglift] int (1/0) гидроборт
option[refrigerator] int (1/0) рефрижератор
option[pass] int (1/0) пропуск в центр
option[shipmen] int 1-6|driverhelp количество необходимых грузчиков или необходима помощь водителя для driverhelp
refrigeratorFrom int температура "от" в рефрижераторе (только для option[refrigerator]=1)
refrigeratorTo int температура "до" в рефрижераторе (только для option[refrigerator]=1)
metro string ближайшее метро к адресу подачи
comment string комментарий к грузу
  • 160 символов
note string примечание к грузу
rbt int (1/0) область видимости груза
onlyDriver int (1/0) груз доступен только водителям
groupList array определяет список групп которому доступен груз
только для rbt=1
myClient int (1/0) телефон доступен только своим водители
allClient3 int (1/0) телефон доступен всем водители
assignType int ID-водителя, для назначения водителя
percentStart int начальный процент по грузу
значение должно находиться в диапазоне 0..29
  • 0 – номинал -9%
  • 9 – номинал
  • 29 – номинал +20%
externalId string ID груза в Вашей системе (только для добавления груза)
  • 1. параметр требует передачи дополнительного параметра
  • 2. необходимо указать не менее двух и не более пяти адресов
  • 3. данный параметр отменяет действие параметра myClient
Ответ при успешном добавлении груза
{
	error: "",
	id: 2528334,
	data: {
		id: 2528334,
		user: 815,
		company: 4,
		date: "2014-12-15 14:48:17",
		beware: [ ],
		blacklist: [
			{
				company: 11,
				date: "2012-12-12 13:24:59",
				comment: "Отказывается платить за опции"
			},
			{
				company: 4,
				date: "2014-03-21 12:19:34",
				comment: "Водитель ждал больше часа"
			}
		],
		city: 1,
		status: "start",
		statusChar: "",
		rbt: 1,
		name: "Василий",
		comment: "",
		price: 0,
		priceBeznal: 30,
		priceDone: 0,
		priceOption: [ ],
		tarifId: 0,
		tarifData: {
			city: 1,
			dayFrom: "07:00",
			dayTo: "21:00",
			kad: [
				10,
				1
			],
				outcity: [
				30,
			1
			],
			outcityGiving: [
				"",
				1
			],
		},
		tarif: "320/20/10/1",
		utype: "min",
		nominal: 1,
		percentEnd: 0,
		percentStart: 9,
		deadline: "2014-12-22 20:00:00",
		deadlineChanged: "0000-00-00 00:00:00",
		route: [
			{
				street: "Плеханова",
				home: "1",
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "Лукинская, д. 1"
			},
			{
				street: "Молодогвардейская",
				home: "19",
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "Молодогвардейская, д. 19"
			}
		],
		auction: [ ],
		phone: 1234567890,
		metro: "",
		update: "2014-12-15 14:48:17",
		singer: 0,
		companySinger: 0,
		driver: 0,
		showPhone: 0,
		autoclass: 4,
		latitude: 0,
		longitude: 0,
		takeCompany: [ ],
		abuse: null,
		auto: null,
		auctionLastUser: 0,
		auctionLastCompany: 0,
		nextStatus: "move",
		cancel: false,
		source: "beta",
		option: {
		},
		optionVal: {
			kid: {
				year: 3,
				weight: 24
			}
		},
		done: "0000-00-00 00:00:00",
		husky: 0,
		huskycode: "",
		geoDecoded: 0,
		type: "tarif",
		archive: false,
		allClient: 1,
		myClient: 1,
		auctionStart: -62169993017,
		auctionTime: 1
	}
}

Изменение груза

/v3/cargo/edit

Параметр Тип Описание
id int ID груза, который нужно изменить

Другие параметры метода см. Добавление груза

Отправка на биржу

/v3/cargo/to_rbt

Параметр Тип Описание
cargo int ID груза, который нужно отправить на биржу
action string подустимые значения
  • add – добавить
  • remove – снять

Показать телефон клиента

/v3/cargo/show_phone

Параметр Тип Описание
cargo int ID груза
Ответ
{
	error: null,
	name: "Иван",
	phone: 0000000000
}

Информация

/v3/cargo/info

Параметр Тип Описание
id int ID груза, по которому нужна информация
cut string Обрезает возвращаемые данные
  • update – Вернет последнее время обновления и статус
  • singer – Вернет информацию по исполнителю
Расшифровка полей
{
	id: 2528317,	// id груза
	user: 815,		// id пользователя, который добавил груз
	company: 4,		// id компании-автора груза
	date: "2014-12-12 14:59:16",
	beware: [ ],	// жалобы на груз
	blacklist: [	// телефон клиента в черном списке
		{
			company: 11,
			date: "2012-12-12 13:24:59",
			comment: "Отказался скидываться на бензин"
		},
		{
			company: 67,
			date: "2014-03-21 12:19:34",
			comment: "Мусорит в салоне"
		}
	],
	city: 1,			// город
	status: "start",	// статус
	statusChar: "",		// под-статус
	rbt: 1,				// виден ли груз на бирже
	name: "Василий",	// имя клиента
	comment: "Произвольный груз с весьма зауреадным комментарием.",
	price: 0,			// цена для грузов с оплатой "Фикс"
	priceBeznal: 0,		// сумма, которая будет перечислена по безналу, после закрытия
	priceDone: 0,		// сумма поездки после закрытия заказа
	priceOption: [ ],	// цены опций
	tarifId: 0,			// id-тарифа
	tarifData: "[]",		// данные по тарифу
	tarif: "320/20/10/1",	// тариф
	utype: "min",			// тип тарификации мин/км
	percent: 10,			// текущий % по грузу
	percentPartner: 8,		// % полученный автором
	deadline: "2014-12-16 11:43:54",	// время подачи
	deadlineChanged: "0000-00-00 00:00:00",
	route: [	// маршрут
		{
			street: "пер. Верхний Михайловский",	// улица
			home: 32,				// дом
			block: "",				// корпус
			build: "",				// строение
			porch: "",				// подъезд
			client: "0000-00-00 00:00:00",		// во сколько водитель подъехал
			clientMove: "0000-00-00 00:00:00",	// во сколько выехал с клиентом
			address: "пер. Верхний Михайловский, д. 32"	// полный адрес
		},
		{
			street: "ул. Вавилова",
			home: 37,
			block: "",
			build: "",
			porch: "",
			client: "0000-00-00 00:00:00",
			clientMove: "0000-00-00 00:00:00",
			address: "ул. Вавилова, д. 37"
		}
	],
	auction: [ ],
	phone: 3261786322,	// телефон клиента
	metro: "",			// ближайшее метро
	update: "2014-12-12 14:59:17",
	singer: 0,		// id перевозчика груза
	companySinger: 0,	// id компании-исполнителя заказа
	driver: 0,		// id водитедя исполняющего грузоперевозку
	showPhone: 0,		// телефон клиента показан
	autoclass: 1,		// класс авто
	latitude: 59.928429,
	longitude: 30.328885,
	takeCompany: [ ],
	abuse: null,
	auto: { // информация об автомобиле
		gnumber: "Х876ЕЕ777",
		abrand: "Skoda",
		amodel: "Roomster",
		acolor: "зелёный",
		ayear: 2011,
		phone: 9269999999
	},
	driverPosition: { // координаты авто
		latitude: 55.704427,
		longitude: 37.605413,
		lastGeo: "2016-03-09 14:03:47" // время последней координаты
	},
	auctionLastUser: 0,
	auctionLastCompany: 0,
	nextStatus: "move",	// какой статус ожидается
	cancel: false,		// запрещено ли брать груз
	source: "beta",
	option: {},			// список опций
	optionVal: [ ],					// дополнительные значения по опциям
	done: "0000-00-00 00:00:00",	// во сколько закрыт
	husky: 0,
	huskycode: "",
	geoDecoded: 1,
	type: "tarif",
	archive: false,
	allClient: 1,
	myClient: 1,
	auctionStart: -62169993017,
	auctionTime: 1,
	externalId: "",
	log: [
		{
			company: 4,
			user: 3,
			level: "director",
			date: "2015-06-26 11:47:07",
			status: "start",
			comment: ""
		},
		{
			company: 4,
			user: 3,
			level: "director",
			date: "2015-06-26 11:47:39",
			status: "move",
			comment: {
				gnumber: "рн375о99",
				abrand: "Aston Martin",
				amodel: "Rapide",
				acolor: "бежевый",
				ayear: 2012,
				phone: 1
			}
		},
		{
			company: 4,
			user: 3,
			level: "director",
			date: "2015-06-26 11:47:39",
			status: "client",
			comment: ""
		},
		{
			company: 4,
			user: 3,
			level: "director",
			date: "2015-06-26 11:47:40",
			status: "client-move",
			comment: ""
		},
		{
			company: 4,
			user: 3,
			level: "director",
			date: "2015-06-26 11:47:42",
			status: "done",
			comment: 350
		}
	]
}

Закрытие

/v3/cargo/done

Параметр Тип Описание
id int ID груза, который нужно закрыть
price int сумма

Удаление

/v3/cargo/delete

Параметр Тип Описание
id int ID груза, который нужно закрыть
comment string причина удаления

Восстановление

/v3/cargo/restore

Параметр Тип Описание
id int ID груза, который нужно восстановить

Отказ

/v3/cargo/cancel

Параметр Тип Описание
id int ID груза, который нужно восстановить
action string отказаться с удалением или без
  • delete – удалить груз
  • cancel – вернуть в биржу
comment string причина отказа от груза

Простановка статусов

/v3/cargo/next_status

Для проставления статуса грузу, необходимо назначить водителя либо внести информацию об авто

Параметр Тип Описание
cargo int ID груз
status string Статус заказа
  • move – Водитель едет к клиенту
  • client – Машина подана
  • client-move – Машина в пути с клиентом к месту назначения
Ответ если отсуствует информация об авто
{
	error: "wrong auto",
	status:"move"
}
Ответ при неверно переданном статусе
{
	error: "wrong status",
	status: "move"
}

Статусы груза

Статус
(status)		 Под-статус
(statusChar)		 Описание
start Заказ создан
start cancel Отказ от заказа с возвратом в обменник
start delete Отказ от заказа с удалением
start restore Восстановление заказа после отказа
auction За заказ идут торги
auction no-auction Заказ взят без торгов
work start Заказ взят
work move Движение к клиенту
work client Ожидание клиента
work client-move Движение с клиентом
work done Заказ завершен, ожидание оплаты
done Заказ завершен и оплачен
delete Заказ удалён

Назначение водителю / указание авто

/v3/cargo/assign

Параметр Тип Описание
cargo int ID груза, который нужно назначить
driver int ID водителя, кому нужно назначить
abrand1 string марка авто
amodel1 string модель авто
gnumber1 string гос. номер
acolor1 string цвет авто2
  • 1. указывается в случае если информация об авто не соответствует информации из профиля водителя
  • 2. см. параметр acolor в методе Добавление водителя

Список грузов

/v3/cargo/list

Параметр Тип Описание
cut string Обрезает возвращаемые данные
  • update – Вернет последнее время обновления и статус
Ответ
[
	{
		id: 2528335,
		user: 815,
		company: 4,
		date: "2014-12-16 15:36:05",
		beware: [],
		blacklist: [],
		city: 1,
		status: "start",
		statusChar: "",
		rbt: 1,
		name: "Василий",
		comment: "Произвольный груз с весьма зауреадным комментарием.",
		price: 0,
		priceBeznal: 0,
		priceDone: 0,
		priceOption: [],
		tarifId: 0,
		tarifData: {
			city: 1,
			dayFrom: "07:00",
			dayTo: "21:00",
			kad: [
				10,
				1
			],
			outcity: [
				30,
				1
			],
			outcityGiving: [
				"",
				1
			]
		},
		tarif: "320/20/10/1",
		utype: "km",
		percent: 9,
		deadline: "2014-12-18 16:21:00",
		deadlineChanged: "0000-00-00 00:00:00",
		route: [
			{
				street: "ул. Арбат",
				home: 59,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Арбат, д. 59"
			},
			{
				street: "ул. Медынская",
				home: 39,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Медынская, д. 39"
			}
		],
		auction: [],
		phone: 4067278144,
		metro: "",
		update: "2014-12-16 15:36:07",
		singer: 0,
		companySinger: 0,
		driver: 0,
		showPhone: 0,
		autoclass: 1,
		latitude: 55.747343,
		longitude: 37.585233,
		takeCompany: [],
		abuse: null,
		auto: { // информация об автомобиле
			gnumber: "Х876ЕЕ777",
			abrand: "Skoda",
			amodel: "Fabia",
			acolor: "зелёный",
			ayear: 2011,
			phone: 9269999999
		},
		driverPosition: { // координаты авто
			latitude: 55.704427,
			longitude: 37.605413,
			lastGeo: "2016-03-09 14:03:47" // время последней координаты
		},
		auctionLastUser: 0,
		auctionLastCompany: 0,
		nextStatus: "move",
		cancel: false,
		source: "beta",
		option: {},
		optionVal: [],
		done: "0000-00-00 00:00:00",
		husky: 0,
		huskycode: "",
		geoDecoded: 1,
		type: "tarif",
		archive: false,
		allClient: 1,
		myClient: 1,
		auctionStart: -62169993017,
		auctionTime: 1
	},
	{
		id: 2528336,
		user: 815,
		company: 4,
		date: "2014-12-16 15:36:05",
		beware: [],
		blacklist: [],
		city: 1,
		status: "start",
		statusChar: "",
		rbt: 1,
		name: "Акакий",
		comment: "Произвольный груз с весьма зауреадным комментарием.",
		price: 0,
		priceBeznal: 0,
		priceDone: 0,
		priceOption: [],
		tarifId: 0,
		tarifData: {
			city: 1,
			dayFrom: "07:00",
			dayTo: "21:00",
			kad: [
				10,
				1
			],
			outcity: [
				30,
				1
			],
			outcityGiving: [
				"",
				1
			]
		},
		tarif: "320/20/10/1",
		utype: "min",
		nominal: 1,
		percentEnd: 0,
		percentStart: 9,
		deadline: "2014-12-22 06:54:00",
		deadlineChanged: "0000-00-00 00:00:00",
		route: [
			{
				street: "ул. Тверская",
				home: 15,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Тверская, д. 15"
			},
			{
				street: "ул. Плеханова",
				home: 48,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Плеханова, д. 48"
			}
		],
		auction: [],
		phone: 3457807273,
		metro: "",
		update: "2014-12-16 15:36:07",
		singer: 0,
		companySinger: 0,
		driver: 0,
		showPhone: 0,
		autoclass: 4,
		latitude: 55.76174,
		longitude: 37.608311,
		takeCompany: [],
		abuse: null,
		auto: null,
		auctionLastUser: 0,
		auctionLastCompany: 0,
		nextStatus: "move",
		cancel: false,
		source: "beta",
		option: {},
		optionVal: [],
		done: "0000-00-00 00:00:00",
		husky: 0,
		huskycode: "",
		geoDecoded: 1,
		type: "tarif",
		archive: false,
		allClient: 1,
		myClient: 1,
		auctionStart: -62169993017,
		auctionTime: 1
	},
	{
		id: 2528337,
		user: 6,
		company: 6,
		date: "2014-12-16 15:36:20",
		beware: [],
		blacklist: [],
		city: 1,
		status: "start",
		statusChar: "",
		rbt: 1,
		name: "Пафнутий",
		comment: "Произвольный груз с весьма зауреадным комментарием.",
		price: 0,
		priceBeznal: 0,
		priceDone: 0,
		priceOption: [],
		tarifId: 0,
		tarifData: [],
		tarif: "320/20/10/1",
		utype: "min",
		nominal: 1,
		percentEnd: 0,
		percentStart: 9,
		deadline: "2014-12-20 19:52:00",
		deadlineChanged: "0000-00-00 00:00:00",
		route: [
			{
				street: "ул. Плеханова",
				home: 25,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Плеханова, д. 25"
			},
			{
				street: "ул. Тверская",
				home: 42,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Тверская, д. 42"
			}
		],
		auction: [],
		phone: "",
		metro: "",
		update: "2014-12-16 15:36:21",
		singer: 0,
		companySinger: 0,
		driver: 0,
		showPhone: 0,
		autoclass: 1,
		latitude: 55.744272,
		longitude: 37.767043,
		takeCompany: [],
		abuse: null,
		auto: null,
		auctionLastUser: 0,
		auctionLastCompany: 0,
		nextStatus: "move",
		cancel: false,
		source: "beta",
		option: {},
		optionVal: [],
		done: "0000-00-00 00:00:00",
		husky: 0,
		huskycode: "",
		geoDecoded: 1,
		type: "tarif",
		archive: false,
		allClient: 1,
		myClient: 1,
		auctionStart: -62169993017,
		auctionTime: 1
	}
]

Список биржевых грузов

/v3/cargo/exchange

Параметр Тип Описание
Ответ
[
	{
		id: 2528335,
		user: 815,
		company: 4,
		date: "2014-12-16 15:36:05",
		beware: [],
		blacklist: [],
		city: 1,
		status: "start",
		statusChar: "",
		rbt: 1,
		name: "Василий",
		comment: "Произвольный груз с весьма зауреадным комментарием.",
		price: 0,
		priceBeznal: 0,
		priceDone: 0,
		priceOption: [],
		tarifId: 0,
		tarifData: {
			city: 1,
			dayFrom: "07:00",
			dayTo: "21:00",
			kad: [
				10,
				1
			],
			outcity: [
				30,
				1
			],
			outcityGiving: [
				"",
				1
			]
		},
		tarif: "320/20/10/1",
		utype: "km",
		percent: 9,
		deadline: "2014-12-18 16:21:00",
		deadlineChanged: "0000-00-00 00:00:00",
		route: [
			{
				street: "ул. Арбат",
				home: 59,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Арбат, д. 59"
			},
			{
				street: "ул. Медынская",
				home: 39,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Медынская, д. 39"
			}
		],
		auction: [],
		phone: 4067278144,
		metro: "",
		update: "2014-12-16 15:36:07",
		singer: 0,
		companySinger: 0,
		driver: 0,
		showPhone: 0,
		autoclass: 1,
		latitude: 55.747343,
		longitude: 37.585233,
		takeCompany: [],
		abuse: null,
		auto: null,
		auctionLastUser: 0,
		auctionLastCompany: 0,
		nextStatus: "move",
		cancel: false,
		source: "beta",
		option: {},
		optionVal: [],
		done: "0000-00-00 00:00:00",
		husky: 0,
		huskycode: "",
		geoDecoded: 1,
		type: "tarif",
		archive: false,
		allClient: 1,
		myClient: 1,
		auctionStart: -62169993017,
		auctionTime: 1
	},
	{
		id: 2528336,
		user: 815,
		company: 4,
		date: "2014-12-16 15:36:05",
		beware: [],
		blacklist: [],
		city: 1,
		status: "start",
		statusChar: "",
		rbt: 1,
		name: "Акакий",
		comment: "Произвольный груз с весьма зауреадным комментарием.",
		price: 0,
		priceBeznal: 0,
		priceDone: 0,
		priceOption: [],
		tarifId: 0,
		tarifData: {
			city: 1,
			dayFrom: "07:00",
			dayTo: "21:00",
			kad: [
				10,
				1
			],
			outcity: [
				30,
				1
			],
			outcityGiving: [
				"",
				1
			]
		},
		tarif: "320/20/10/1",
		utype: "min",
		nominal: 1,
		percentEnd: 0,
		percentStart: 9,
		deadline: "2014-12-22 06:54:00",
		deadlineChanged: "0000-00-00 00:00:00",
		route: [
			{
				street: "ул. Тверская",
				home: 15,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Тверская, д. 15"
			},
			{
				street: "ул. Плеханова",
				home: 48,
				block: "",
				build: "",
				porch: "",
				client: "0000-00-00 00:00:00",
				clientMove: "0000-00-00 00:00:00",
				address: "ул. Плеханова, д. 48"
			}
		],
		auction: [],
		phone: 3457807273,
		metro: "",
		update: "2014-12-16 15:36:07",
		singer: 0,
		companySinger: 0,
		driver: 0,
		showPhone: 0,
		autoclass: 4,
		latitude: 55.76174,
		longitude: 37.608311,
		takeCompany: [],
		abuse: null,
		auto: null,
		auctionLastUser: 0,
		auctionLastCompany: 0,
		nextStatus: "move",
		cancel: false,
		source: "beta",
		option: {},
		optionVal: [],
		done: "0000-00-00 00:00:00",
		husky: 0,
		huskycode: "",
		geoDecoded: 1,
		type: "tarif",
		archive: false,
		allClient: 1,
		myClient: 1,
		auctionStart: -62169993017,
		auctionTime: 1
	}
]

Список обновлений

/v3/cargo/refresh

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

Ответ
[
	{
		id: 9187137,
		update: "2015-03-04 12:54:07",
		status: "start",
		statusChar: ""
	},
	{
		id: 9187138,
		update: "2015-03-04 15:15:20",
		status: "start",
		statusChar: ""
	}
]

Ставка

/v3/cargo/rate

Если за время работы запроса ставка была перебита, в ответе будет указан % за который можно будет взять груз

Параметр Тип Описание
id int ID груз, за который делается ставка
percent int ставка
Ответ (указан неверный %)
{
	percent: 14,
	status: "auction",
	error: "ORDER_WRONG_PERCENT"
}
Ответ
{
	error: ""
}

Запросы изменения заказов

Список всех запросов изменений

/v3/order_change/list

Возвращает полный список запросов изменения стоимостей и типов оплаты заказов

Пример ответа
[
	{
		"order": 13895607,
		"type": "price",		// смена стоимости
		"status": "accept",		// wait || accept || cancel
		"value": 2000,
		"date": "2016-10-05 14:49:38",
		"atype": "order"		// order || cargo
	},
	{
		"order": 13895607,
		"type": "beznal",		// смена типа оплаты
		"status": "wait",
		"value": 0,
		"date": "2016-10-05 14:56:34",
		"atype": "order"
	},
	...
]

Список запросов изменений по заказу

/v3/order_change/info

Возвращает список запросов изменения стоимостей и типов оплаты заказов по конкретному заказу

Параметр Тип Описание
id int ID заказа, по которому нужно получить список запросов
Пример ответа
[
	{
		"order": 13895607,
		"type": "price",		// смена стоимости
		"status": "accept",		// wait || accept || cancel
		"value": 2000,
		"date": "2016-10-05 14:49:38",
		"atype": "order"		// order || cargo
	},
	{
		"order": 13895607,
		"type": "beznal",		// смена типа оплаты
		"status": "wait",
		"value": 0,
		"date": "2016-10-05 14:56:34",
		"atype": "order"
	},
	...
]

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

/v3/order_change/price

Запрашивает смену стоимости заказа

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

Если автор и исполнитель заказа одна и та же компания - изменения вступают в силу сразу

Если автор и исполнитель заказа разные компании - изменения вступают в силу только после согласия другой стороны

Параметр Тип Описание
order int ID заказа, которому необходимо запросить смену стоимости
price int Желаемая стоимость заказа

Запрос изменения типа оплаты заказа

/v3/order_change/type

Запрашивает смену типа оплаты заказа

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

Если автор и исполнитель заказа одна и та же компания - изменения вступают в силу сразу

Если автор и исполнитель заказа разные компании - изменения вступают в силу только после согласия другой стороны

Параметр Тип Описание
order int ID заказа, которому необходимо смену типа оплаты

Тарифы

Информация

/v3/tarif/info/

Возвращает информацию по тарифу

Параметр Тип Описание
id int ID тарифа, по которому нужна информация
Ответ
{
	"id"           : 26931,
	"company"      : 4,
	"user"         : 815,
	"city"         : 1,
	"name"         : "Э-К-Б День",
	"autoclass"    : [4, 1, 2],
	"type"         : "tarif",
	"utype"        : "min",
	"waiting"      : [10, 10, 1],
	"moving"       : [320, 20, 10, 1],
	"price"        : 0,
	"kad"          : [22, 1],
	"outcity"      : [33, 1],
	"outcityGiving": [20, 1],
	"daytime"      : "day",
	"english"      : 120,
	"kid"          : 100,
	"animal"       : 400,
	"baggage"      : 50,
	"ski"          : 0,
	"nameplate"    : 0,
	"smoking"      : 0,
	"del"          : 0,
	"block"        : 0,
	"transfer"     : {
		"4"                   : {
			"32": 1200,
			"34": 1300
		},
		"32"                  : {
			"4" : 1200,
			"12": 1100
		},
		"34"                  : {
			"4" : 1300,
			"12": 1100
		},
		"12"                  : {
			"32": 1100,
			"34": 1100
		},
		"airportWaiting"      : [60, 10, 1],
		"airport-option"      : 0,
		"trainWaiting"        : [30, 10, 1],
		"train-option"        : 0,
		"airport-train-option": 0
	}
}

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

/v3/tarif/list/

Возвращает список активных тарифов

Параметр Тип Описание
city int ID-города1
block int (1/0) заблокированные тарифы в ответе
Ответ
[
	{
		"id"           : 26931,
		"company"      : 4,
		"user"         : 815,
		"city"         : 1,
		"name"         : "Э-К-Б День",
		"autoclass"    : [4, 1, 2],
		"type"         : "tarif",
		"utype"        : "min",
		"waiting"      : [10, 10, 1],
		"moving"       : [320, 20, 10, 1],
		"price"        : 0,
		"kad"          : [22, 1],
		"outcity"      : [33, 1],
		"outcityGiving": [20, 1],
		"daytime"      : "day",
		"english"      : 120,
		"kid"          : 100,
		"animal"       : 400,
		"baggage"      : 50,
		"ski"          : 0,
		"nameplate"    : 0,
		"smoking"      : 0,
		"del"          : 0,
		"block"        : 0,
		"transfer"     : {
			"4"                   : {
				"32": 1200,
				"34": 1300
			},
			"32"                  : {
				"4" : 1200,
				"12": 1100
			},
			"34"                  : {
				"4" : 1300,
				"12": 1100
			},
			"12"                  : {
				"32": 1100,
				"34": 1100
			},
			"airportWaiting"      : [60, 10, 1],
			"airport-option"      : 0,
			"trainWaiting"        : [30, 10, 1],
			"train-option"        : 0,
			"airport-train-option": 0
		}
	},
	{
		"id"           : 26932,
		"company"      : 4,
		"user"         : 815,
		"city"         : 1,
		"name"         : "Э-Б Ночь",
		"autoclass"    : [4, 2],
		"type"         : "tarif",
		"utype"        : "min",
		"waiting"      : [10, 10, 1],
		"moving"       : [420, 20, 15, 1],
		"price"        : 0,
		"kad"          : [10, 1],
		"outcity"      : [30, 1],
		"outcityGiving": [],
		"daytime"      : "night",
		"english"      : 100,
		"kid"          : 0,
		"animal"       : 150,
		"baggage"      : 0,
		"ski"          : 0,
		"nameplate"    : 0,
		"smoking"      : 0,
		"del"          : 0,
		"block"        : 0,
		"transfer"     : {
			"4"                   : {"32": 1200},
			"32"                  : {
				"4" : 1200,
				"12": 1100
			},
			"12"                  : {"32": 1100},
			"airportWaiting"      : [60, 10, 1],
			"airport-option"      : 0,
			"trainWaiting"        : [60, 10, 1],
			"train-option"        : 0,
			"airport-train-option": 0
		}
	},
	{
		"id"           : 26934,
		"company"      : 4,
		"user"         : 815,
		"city"         : 1,
		"name"         : "Бизнес",
		"autoclass"    : [2],
		"type"         : "tarif",
		"utype"        : "min",
		"waiting"      : [15, 15, 1],
		"moving"       : [500, 15, 40, 2],
		"price"        : 0,
		"kad"          : [10, 1],
		"outcity"      : [30, 1],
		"outcityGiving": [],
		"daytime"      : "all",
		"english"      : 100,
		"kid"          : 0,
		"animal"       : 150,
		"baggage"      : 0,
		"ski"          : 0,
		"nameplate"    : 0,
		"smoking"      : 0,
		"del"          : 0,
		"block"        : 0,
		"transfer"     : {
			"airportWaiting"      : [60, 20, 1],
			"airport-option"      : 0,
			"trainWaiting"        : [30, 20, 1],
			"train-option"        : 0,
			"airport-train-option": 0
		}
	},
	{
		"id"           : 26935,
		"company"      : 4,
		"user"         : 1031,
		"city"         : 1,
		"name"         : "Минивэн тариф",
		"autoclass"    : [4, 5],
		"type"         : "tarif",
		"utype"        : "min",
		"waiting"      : [1, 1, 1],
		"moving"       : [200, 1, 10, 1],
		"price"        : 0,
		"kad"          : [10, 1],
		"outcity"      : [30, 1],
		"outcityGiving": [],
		"daytime"      : "",
		"english"      : 100,
		"kid"          : 0,
		"animal"       : 150,
		"baggage"      : 0,
		"ski"          : 0,
		"nameplate"    : 0,
		"smoking"      : 0,
		"del"          : 0,
		"block"        : 0,
		"transfer"     : {
			"airportWaiting"      : [0, 0, 0],
			"airport-option"      : 0,
			"trainWaiting"        : [0, 0, 0],
			"train-option"        : 0,
			"airport-train-option": 0
		}
	}
]

Компания

Список компаний

/v3/company/list/

Пример списка компаний
{
	1: {
		id: 1,			// id компании
		name: "Служба 918",	// название компании
		city: 1,		// город в котором работает компания
		phone: 3452345354,	// телефон компании
		pphone: 3546456455, 	// телефон для партнеров
		inn: 5906097015         // ИНН компании
		delete: 0,		// удалена ли компания или нет
	},
	2: {
		id: 2,
		name: "РБТакси",
		city: 1,
		phone: "",
		pphone: "",
		inn: 5906097016
		delete: 0,
	},
	4: {
		id: 4,
		name: "2Товарища2",
		city: 1,
		phone: 4952733908,
		pphone: 4561234567,
		inn: 5906097015
		delete: 0,
	}
}

Своя компания

/v3/company/my/

Пример ответа
{
  "id": 4,
  "name": "2Товарища",
  "text": "",
  "phone": 4991234567,
  "pphone": 4951234567,
  "dphone": "",
  "balance": 3600.15,
  "ctype": "taxi",
  "city": 1,
  "tarif": "Текст с описанием тарифов",
  "globalTarif": [],
  "percentStart": 0, // номинал по умолчанию
  "percentReduce": 0
}

Споры

Список

/v3/abuse/list/

Возвращает список споров компании, отсортированных по дате создания (по-уменьшению)

Если указан период больше недели, то дата end будет автоматически изменена до start + 1 неделя

Параметр Тип Описание
start date с какой даты
  • ДД.ММ.ГГГГ (по умолчанию: вчера (22.04.2024))
end date по какую дату
  • ДД.ММ.ГГГГ (по умолчанию: сегодня (23.04.2024))
Пример ответа
[
	{
		"id": 2044,							// id-спора
		"item": "order",					// предмет спора order-заказ такси или cargo-груз
		"itemId": 13897150,					// id-заказа, по которому ведется спор
		"from": 11,							// id-компании, автора спора
		"to": 4,							// id-компании ответчика
		"fineType": "",						// тип спора
		"status": "wait_f",					// статус спора
		"date": "2017-03-23 14:41:31",		// дата создания спора
		"update": "2017-03-23 15:31:56",	// дата обновления спора
		"view": 0,
		"comment": [						// комментарии по спору
			{
				"abuse": 2044,
				"company": 11,				// id-автора комментария
				"text": "",
				"files": [],
				"action": "add",
				"date": "2017-03-23 14:41:31"
			},
			{
				"abuse": 2044,
				"company": 11,
				"text": "Опаздание более 10 мнут",	// текст комментария
				"files": [							// список приложенных файлов
					{
						"id": 353,
						"mime": "audio/mpeg; charset=binary",			// mime-type файла
						"url": "https:\\static.rbtaxi.ru/file/get/1"	// ссылка на файл
					},
					{
						"id": 354,
						"mime": "audio\/mpeg; charset=binary",
						"url": "https:\\static.rbtaxi.ru/file/get/2"
					}
				],
				"action": "comment",
				"date": "2017-03-23 14:41:31"
			},
			{
				"abuse": 2044,
				"user": 815,
				"company": 4,
				"text": "Вот записи разговоров",
				"files": [
					{
						"id": 355,
						"mime": "audio/mpeg; charset=binary",
						"url": "https://static.rbtaxi.ru/file/get/3"
					},
					{
						"id": 356,
						"mime": "audio/mpeg; charset=binary",
						"url": "https:\\static.rbtaxi.ru/file/get/4"
					}
				],
				"action": "comment",
				"date": "2017-03-23 15:31:56"
			}
		],
		"fine": [	// список штрафов по спору
			{
				"abuse": 2044,
				"fine": 46,
				"price": 300,									// сумма штрафа
				"status": "",									// статус штрафа
				"fine_text": "Заказ удален Владельцем Заказа"	// причина штрафа
			}
		],
		"driver": [],
		"driverPaid": []
	},
	...
]
Статусы спора
	[
		'add'		=> 'Выставлен спор',
		'new'		=> 'Ожидание ответчика',
		'wait_f'	=> 'Ожидание истца',
		'wait_a'	=> 'Ожидание администрации',
		'done'		=> 'Удовлетворён',
		'cancel'	=> 'Отменён'
	]
Тип спора
	[
		''		=> 'Не определен',
		'regular'	=> 'Обычный заказ',
		'beznal'	=> 'Аэропорт/Вокзал/Безнал',
	]
Статусы штрафа
	[
		''		=> 'Не определен',
		'done'		=> 'Выполнен',
		'cancel'	=> 'Сорван',
	]

КЛИЕНТЫ

Список

/v3/client/list/

Возвращает список клиентов компании, отсортированных по дате последней поездки за определённый промежуток времени, но не более 1000 записей.

Параметр Тип Описание
from date дата начала выборки
  • ДД.ММ.ГГГГ (по умолчанию: текущая дата - 30 дней)
to date дата окончания выборки
  • ДД.ММ.ГГГГ (по умолчанию: текущая дата)
del int (1/0) удалённые клиенты
Пример ответа
[
	{
		"id": 100464,				// id клиента
		"code": 506,				// код оператора
		"number": 8252252,			// номер телефона
		"phone": 5068252252,			// код оператора и номер телефона
		"company": 4,				// id компании
		"name": "Алексей",			// имя клиента
		"comment": "",				// комментарий
		"delete": 0,				// удалён ли клиент
		"countDone": 30,			// количество завершенных заказов
		"countDel": 146,			// количество удалённых заказов
		"countRbt": 13,				// количество биржевых заказов
		"sum": 15850,				// сумма всех поездок
		"avg": 528.33,				// средняя цена поездки
		"lastOrder": "2016-01-12 10:41:05",	// последняя поездка
		"lastOrderId": 9930189,			// id последнего заказа
		"black": 0,				// добавлен ли в чёрный список
		"blackComment": null 			// причина
	},
	{
		"id": 111711,
		"code": 192,
		"number": 8960544,
		"phone": 1928960544,
		"company": 4,
		"name": "Андрей",
		"comment": "",
		"delete": 0,
		"countDone": 0,
		"countDel": 1,
		"countRbt": 0,
		"sum": 0,
		"avg": 0,
		"lastOrder": "2016-01-11 13:35:35",
		"lastOrderId": 9930105,
		"black": 0,
		"blackComment": null
	},

	...
]

Проверка телефона клиента

/v3/client/black/

Проверяет телефон клиента на наличие негативных отзывов от компаний

Параметр Тип Описание
phone string номер телефона
  • (999) 999-99-99
  • 9999999999
Пример ответа компаний
[
	{
		comment: "Пытается 'договорится' с водителем",
		date: "2014-03-21 12:19:34"
	},
	{
		comment: "Не платит за опции",
		date: "2012-12-12 13:24:59"
	}
]

ВОДИТЕЛИ

Добавление водителя

/v3/driver/add/

Параметр Тип Описание
nick string позывной водителя
name string имя
surname string фамилия
middlename string отчество
birthday date дата рождения
  • ДД.ММ.ГГГГ
pserial string серия паспорта
pnumber string номер паспорта
pwhen date дата выдачи паспорта
  • ДД.ММ.ГГГГ
phone string номер телефона
pwho string кем выдан паспорт
abrand string марка автомобиля
amodel string модель автомобиля
gnumber string гос номер автомобиля
ayear string год выпуска автомобиля
acolor string цвет автомобиля
допустимые значение:
  • 1 – бежевый
  • 2 – белый
  • 3 – голубой
  • 4 – жёлтый
  • 5 – зелёный
  • 6 – золотой
  • 7 – коричневый
  • 8 – красный
  • 9 – оранжевый
  • 10 – пурпурный
  • 11 – розовый
  • 12 – серебристый
  • 13 – серый
  • 14 – синий
  • 15 – фиолетовый
  • 16 – чёрный
autoclass array автоклассы, доступные водителю
допустимые значения
  • 4 – Эконом
  • 1 – Комфорт
  • 2 – Бизнес
  • 3 – Универсал
  • 5 – Минивэн
  • 6 – Микроавтобус
english int (1/0) водитель знает английский
animal int (1/0) водитель готов возить животных
card int (1/0) есть терминал для оплаты банковскими картами
nosmoking int (1/0) водитель не курит
smoking int (1/0) водитель курит или переносит табачный дым
beznal int (1/0) может брать безналичные заказы
kid int (1/0) есть детское кресло
password1 string пароль
my int (1/0) водитель может брать заказы компании
rbt int (1/0) водитель может брать биржевые заказы
manyOrders int (1/0) водитель может брать несколько заказов
noforum int (1/0) запретить доступ на форум
nominal int номинал для своих заказов
nominalRbt int водитель для биржевых заказов
min int (1/0) порог взятия обычных заказов
minBeznal int (1/0) порого взятия безналичных заказов
authPay int (1/0) тип списания абонентское платы
  • true – ежедневная
  • false – за взятие заказа
authprice2 int ежедневная абонентская плата
dayprice2 int абонентская плата за взятие заказа
inn string ИНН
atype3 string Тип деятельности
  • taxi – Услуга такси
  • fraht – Договор фрахтования (по умолчанию, если не передан параметр)
licenseRegion string Регион разрешения
license string Номер разрешения
  • 1. обязательное поле только в случае добавления
  • 2. обязательные параметры при передаче соответствующего authPay
  • 3. если передано значение taxi, то поле licenseRegion и license становятся обязательными
Ответ при успешном добавлении водителя
{
	error: null,
	id: 4442	// id является логином водителя для авторизации в мобильной версии РБТакси
}

Редактирование водителя

/v3/driver/edit/

Параметр Тип Описание
id int id водителя

Другие параметры метода см. Добавление водителя

Ответ при успешном редактировании водителя
{
	error: null,
}

Информация о водителе

/v3/driver/info/

Параметр Тип Описание
id int id водителя
Ответ
{
	"id": 970,
	"email": "",
	"phone": 1110215441,
	"phone2": "",
	"name": "Алексей",
	"middlename": "Семенович",
	"surname": "Иванов",
	"company": 4,
	"level": "driver",
	"dayprice": 23,
	"authprice": 0,
	"forum": 3,
	"status": "",
	"messageCount": 0,
	"avatar": 0,
	"birthday": "",
	"date": "0000-00-00 00:00:00",
	"update": "2016-01-12 09:40:46",
	"del": 0,
	"nick": "Трин‎‎",
	"naym": "sdelka",
	"nominal": 0,
	"min": 0,
	"autoclass": [
		1, 4
	],
	"my": 1,
	"rbt": 0,
	"pserial": "‎‎",
	"pnumber": "‎‎",
	"pwho": "",
	"pwhen": "31.10.2030",
	"inn": "",
	"gnumber": "В565РУ197",
	"abrand": "Audi",
	"amodel": 100,
	"acolor": "белый",
	"ayear": 2012,
	"weight": 0,
	"volume": 0,
	"english": 1,
	"animal": 1,
	"kid": 1,
	"terminal": 0,
	"card": 0,
	"nosmoking": 0,
	"smoking": 1,
	"beznal": 1,
	"driverhelp": 0,
	"pass": 0,
	"loadinglift": 0,
	"refrigerator": 0,
	"profile": false,
	"sort": 2,
	"block": 0,
	"adresd": 1,
	"atype": "fraht",
	"license": "",
	"licenseRegion": "",
	"inform": 1,
	"sound": 1,
	"noforum": 0,
	"latitude": 0,
	"longitude": 0,
	"balance": -3067.4,
	"freeze": 0,
	"authPay": 0,
	"nominalRbt": 10,
	"orderFee": 0,
	"minBeznal": 0,
	"pcode1": 926,
	"pnumber1": 9015736,
	"pcode2": "",
	"pnumber2": "",
	"smsOff": 0,
	"manyOrders": 1,
	"sortBy": "desc",
	"nightMode": "auto",
	"lastGeo": "2015-09-06 00:31:12",
	"photoSts": 0,
	"photoAuto1": 0,
	"photoAuto2": 0,
	"photoInterior1": 0,
	"photoInterior2": 0,
	"photoDriverLicense": 0,
	"rbtApprove": "",
	"rbtApproveCancelComment": "",
	"rbtApproveDate": "0000-00-00 00:00:00"
}

Изменение баланса

/v3/driver/money/

Параметр Тип Описание
id int id водителя
price int сумма пополнения/списания
натуральное число
comment string текст комментария
type int id водителя
допустимые значения:
  • 1 – Изменение баланса
  • 2 – Штраф
  • 3 – Другое
action string id водителя
допустимые значения:
  • credit – Зачислить средства
  • debit – Списать средства
Ответ при успешном запросе
{
	error: null
}

Удаление водителя

/v3/driver/delete/

Параметр Тип Описание
id int id водителя
Ответ при успешном удалении водителя
{
	error: null,
}

Блокировка водителя

/v3/driver/block/

Параметр Тип Описание
id int id водителя
block int (1/0)
  • true – заблокировать
  • false – разблокировать
Ответ при успешной блокировке водителя
{
	error: null,
}

Список водителей

/v3/driver/list/

Ответ
[
	{
		"id": 970,
		"email": "",
		"phone": 1110215441,
		"phone2": "",
		"name": "Алексей",
		"middlename": "Семенович",
		"surname": "Иванов",
		"company": 4,
		"level": "driver",
		"dayprice": 23,
		"authprice": 0,
		"forum": 3,
		"status": "",
		"messageCount": 0,
		"avatar": 0,
		"birthday": "",
		"date": "0000-00-00 00:00:00",
		"update": "2016-01-12 09:40:46",
		"del": 0,
		"nick": "Трин‎‎",
		"naym": "sdelka",
		"nominal": 0,
		"min": 0,
		"autoclass": [
			1, 4
		],
		"my": 1,
		"rbt": 0,
		"pserial": "‎‎",
		"pnumber": "‎‎",
		"pwho": "",
		"pwhen": "31.10.2030",
		"inn": "",
		"gnumber": "В565РУ197",
		"abrand": "Audi",
		"amodel": 100,
		"acolor": "белый",
		"ayear": 2012,
		"weight": 0,
		"volume": 0,
		"english": 1,
		"animal": 1,
		"kid": 1,
		"terminal": 0,
		"card": 0,
		"nosmoking": 0,
		"smoking": 1,
		"beznal": 1,
		"driverhelp": 0,
		"pass": 0,
		"loadinglift": 0,
		"refrigerator": 0,
		"profile": false,
		"sort": 2,
		"block": 0,
		"adresd": 1,
		"atype": "fraht",
		"license": "",
		"licenseRegion": "",
		"inform": 1,
		"sound": 1,
		"noforum": 0,
		"latitude": 0,
		"longitude": 0,
		"balance": -3067.4,
		"freeze": 0,
		"authPay": 0,
		"nominalRbt": 10,
		"orderFee": 0,
		"minBeznal": 0,
		"pcode1": 926,
		"pnumber1": 9015736,
		"pcode2": "",
		"pnumber2": "",
		"smsOff": 0,
		"manyOrders": 1,
		"sortBy": "desc",
		"nightMode": "auto",
		"lastGeo": "2015-09-06 00:31:12",
		"photoSts": 0,
		"photoAuto1": 0,
		"photoAuto2": 0,
		"photoInterior1": 0,
		"photoInterior2": 0,
		"rbtApprove": "",
		"rbtApproveCancelComment": "",
		"rbtApproveDate": "0000-00-00 00:00:00"
	},
	{
		"id": 819,
		"email": "",
		"phone": 1121211122,
		"phone2": "",
		"name": "qwe33",
		"middlename": "qwe33",
		"surname": 323,
		"company": 4,
		"level": "driver",
		"dayprice": 23,
		"authprice": 15,
		"forum": 0,
		"status": "",
		"messageCount": 0,
		"avatar": 317,
		"birthday": "",
		"date": "0000-00-00 00:00:00",
		"update": "2016-03-10 08:52:32",
		"del": 0,
		"nick": "fbi 228‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ 2‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎",
		"naym": 0,
		"nominal": 12,
		"min": 0,
		"autoclass": [
			4,1,2,3,5
		],
		"my": 1,
		"rbt": 1,
		"pserial": "‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎",
		"pnumber": "‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎",
		"pwho": "",
		"pwhen": "",
		"inn": "",
		"gnumber": "КУ33977",
		"abrand": "Kia",
		"amodel": "Besta",
		"acolor": "белый",
		"ayear": 2000,
		"weight": 100,
		"volume": 1,
		"english": 1,
		"animal": 1,
		"kid": 1,
		"terminal": 1,
		"card": 1,
		"nosmoking": 1,
		"smoking": 1,
		"beznal": 1,
		"driverhelp": 0,
		"pass": 0,
		"loadinglift": 0,
		"refrigerator": 0,
		"profile": {
			"id": 76,
			"user": 819,
			"agent": "Mozilla\/5.0 (Windows NT 10.0; WOW64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/48.0.2564.103 Safari\/537.36",
			"template": "mobile",
			"javascript": 1,
			"ajax": 1,
			"geo": 1,
			"audio": 1,
			"resolution": "",
			"date": "2011-09-19 14:49:30",
			"ip": "85.90.102.139"
		},
		"sort": 1,
		"block": 0,
		"adresd": 0,
		"atype": "fraht",
		"license": "",
		"licenseRegion": "",
		"inform": 0,
		"sound": 1,
		"noforum": 0,
		"latitude": 0,
		"longitude": 0,
		"balance": 988.37,
		"freeze": 0,
		"authPay": 1,
		"nominalRbt": 12,
		"orderFee": 0,
		"minBeznal": 0,
		"pcode1": 112,
		"pnumber1": 1211122,
		"pcode2": "",
		"pnumber2": "",
		"smsOff": 0,
		"manyOrders": 1,
		"sortBy": "asc",
		"nightMode": "auto",
		"lastGeo": "2016-03-10 16:18:28",
		"photoSts": 35,
		"photoAuto1": 9,
		"photoAuto2": 43,
		"photoInterior1": 36,
		"photoInterior2": 44,
		"rbtApprove": "approve",
		"rbtApproveCancelComment": "",
		"rbtApproveDate": "2016-03-03 15:41:10"
	},
	...
]

СЕРВИСЫ

Таксометр

/v3/service/taximeter

Таксометр позволяет рассчитать параметры и стоимость поездки с учетом указанного тарифа

Параметр Тип Описание
id 1 int Идентификатор заказа
order[option][kid] int (1/0) Детское кресло
order[option][animal] int (1/0) Перевозка животных
order[option][english] int (1/0) Водитель со знанием английского
order[option][nameplate] int (1/0) Встреча с табличкой
order[option][baggage] int (1/0) Клиент с багажем
order[option][ski] int (1/0) Клиент с лыжами/сноубордом
order[city]1 int ID-города заказа
order[deadline] string время подачи
  • ДД.ММ.ГГГГ ЧЧ:ММ:СС
order[done] string время завершение поездки (для расчета до текущего момента, следует передать текущее время)
order[type] string тип заказа
  • tarif – тарифный
  • fix – с фиксированной ценной
order[utype] string тип тарификации
  • min – поминутный
  • km – километровый
track 1 array/string массив точек маршрута 
[
	 // [ширина, долгота, время координаты]
	[55.732661,37.442993,"2015-03-21 10:30:22"],
	[55.646326,37.342478,"2015-03-21 10:49:07"]
]
или в JSON формате
route 1 array массив адресов маршрута 
route[]=Лукинская, 5с1
route[]=Новолучанская, 12к4
tarif[city]2 int ID-города
tarif[kad] array цена движение по окружной дороге (МКАД, КАД)
  • [10/1] (10 за 1 км)
tarif[outcity] array цена поездки за город
  • [10/1] (10 за 1 км)
tarif[outcityGiving] array цена подачи за город
  • [10/1] (10 за 1 км)
tarif[english] int цена опции "водитель со знанием английского"
tarif[animal] int цена опции "перевозка животных"
tarif[kid] int (1/0) цена опции "детское кресло"
tarif[baggage] int (1/0) цена опции "клиент с богажем"
tarif[ski] int (1/0) цена опции "перевозка лыж/сноуборда"
tarif[type] string тип тарифа
  • tarif – тарифный
  • fix – с фиксированной ценной
tarif[utype] string тип тарификации
  • min – поминутный
  • km – километровый
tarif[moving] array цена поездки
  • [320,20,10,1] (320 за 20 мин поездки + 10 за 1 мин)
tarif[waiting] array цена ожидания
  • [10,10,1] (10 мин бесплатно, 10 за 1 мин ожидания)
tarif[price] int цена поздки
tarif[ski] int (1/0) цена опции "перевозка лыж/сноуборда"
tarif[transfer]3 array цена трансферов, массив вида 
[
	‹id-места отправленя› : [
		‹id-места назначения› : 1200, // 1200  за трансфер
	]
]
tarif[transfer][airportWaiting] array цена ожидания в аэропорту
  • [60,10,1] (см. цена ожидания)
tarif[transfer][trainWaiting] array цена ожидания на вокзале
  • [60,10,1] (см. цена ожидания)
Пример запроса
key=<Ваш ключ>
track=[[55.70553,37.611286,"2015-07-23 16:45:00"],[55.70449,37.612234,"2015-07-23 16:45:00"],
[55.705065,37.616282,"2015-07-23 16:45:00"],[55.705129,37.616535,"2015-07-23 16:45:00"],
[55.705279,37.616837,"2015-07-23 16:45:00"],[55.705295,37.616989999999994,"2015-07-23 16:45:00"],
[55.705282,37.61710599999999,"2015-07-23 16:45:00"],[55.705251,37.61720499999999,"2015-07-23 16:45:00"],
[55.705194999999996,37.617276999999994,"2015-07-23 16:45:00"],[55.704758,37.617366,"2015-07-23 16:45:00"],
[55.704715,37.617363,"2015-07-23 16:45:00"],[55.704519,37.617283,"2015-07-23 16:45:00"],
[55.704308999999995,37.617136,"2015-07-23 16:45:00"],[55.704111,37.616919,"2015-07-23 16:45:00"],
[55.703295999999995,37.615683000000004,"2015-07-23 16:45:00"],[55.702901999999995,37.615144,"2015-07-23 16:45:00"],
[55.702662999999994,37.614881000000004,"2015-07-23 16:45:00"],[55.702465,37.614743000000004,"2015-07-23 16:45:00"],
[55.702416,37.614719,"2015-07-23 16:45:00"],[55.702339,37.614711,"2015-07-23 16:45:00"],
[55.702088,37.61477,"2015-07-23 16:45:00"],[55.701815,37.614898,"2015-07-23 16:45:00"],
[55.701505000000004,37.615142,"2015-07-23 16:45:00"],[55.70142500000001,37.6154,"2015-07-23 16:45:00"],
[55.70141100000001,37.615581,"2015-07-23 16:45:00"],[55.70143600000001,37.615744,"2015-07-23 16:45:00"],
[55.70151500000001,37.615938,"2015-07-23 16:45:00"],[55.703174000000004,37.617102,"2015-07-23 16:45:00"],
[55.703275000000005,37.617082,"2015-07-23 16:45:00"],[55.70332500000001,37.617055,"2015-07-23 16:45:00"],
[55.703368000000005,37.617008,"2015-07-23 16:45:00"],[55.703397,37.616946,"2015-07-23 16:45:00"],
[55.703492000000004,37.616537,"2015-07-23 16:45:00"],[55.703512,37.616351,"2015-07-23 16:45:00"],
[55.703486000000005,37.616214,"2015-07-23 16:45:00"],[55.70342300000001,37.616102,"2015-07-23 16:45:00"],
[55.70271600000001,37.615275999999994,"2015-07-23 16:45:00"],
[55.70247200000001,37.61493299999999,"2015-07-23 16:45:00"],[55.702281000000006,37.61460399999999,"2015-07-23 16:45:00"],
[55.70185200000001,37.61366199999999,"2015-07-23 16:45:00"],[55.70163200000001,37.61309999999999,"2015-07-23 16:45:00"],
[55.70126700000001,37.612000999999985,"2015-07-23 16:45:00"],[55.70120500000001,37.61164499999999,"2015-07-23 16:45:00"],
[55.70114100000001,37.61111199999999,"2015-07-23 16:45:00"],[55.70110400000001,37.61047299999999,"2015-07-23 16:45:00"],
[55.701102000000006,37.609818999999995,"2015-07-23 16:45:00"],[55.70112,37.60940599999999,"2015-07-23 16:45:00"],
[55.701170000000005,37.60883199999999,"2015-07-23 16:45:00"],[55.701247,37.608281999999996,"2015-07-23 16:45:00"],
[55.701354,37.60773999999999,"2015-07-23 16:45:00"],[55.701513,37.60716599999999,"2015-07-23 16:45:00"],
[55.702415,37.60441199999999,"2015-07-23 16:45:00"],[55.702818,37.60310399999999,"2015-07-23 16:45:00"],
[55.704187,37.597881999999984,"2015-07-23 16:45:00"],[55.705439999999996,37.59337099999998,"2015-07-23 16:45:00"],
[55.706179,37.59082499999998,"2015-07-23 16:45:00"],[55.706808,37.588822999999984,"2015-07-23 16:45:00"],
[55.707037,37.58793799999999,"2015-07-23 16:45:00"],[55.707099,37.58777099999999,"2015-07-23 16:45:00"],
[55.70737,37.58716599999999,"2015-07-23 16:45:00"],[55.708047,37.58588599999999,"2015-07-23 16:45:00"],
[55.709082,37.58405899999999,"2015-07-23 16:45:00"],[55.709745000000005,37.583094999999986,"2015-07-23 16:45:00"],
[55.711456000000005,37.58067399999999,"2015-07-23 16:45:00"],[55.713503,37.578169999999986,"2015-07-23 16:45:00"],
[55.71513,37.575833999999986,"2015-07-23 16:45:00"],[55.715304,37.57564399999998,"2015-07-23 16:45:00"],
[55.715424000000006,37.57548099999998,"2015-07-23 16:45:00"],[55.715711000000006,37.57499099999998,"2015-07-23 16:45:00"],
[55.716342000000004,37.573757999999984,"2015-07-23 16:45:00"],[55.716664,37.573064999999986,"2015-07-23 16:45:00"],
[55.717153,37.57187099999999,"2015-07-23 16:45:00"],[55.717394000000006,37.571201999999985,"2015-07-23 16:45:00"],
[55.71761800000001,37.57051199999999,"2015-07-23 16:45:00"],[55.71863600000001,37.56722999999999,"2015-07-23 16:45:00"],
[55.71913800000001,37.565541999999986,"2015-07-23 16:45:00"],[55.71914700000001,37.56538599999999,"2015-07-23 16:45:00"],
[55.71913500000001,37.56523699999999,"2015-07-23 16:45:00"],[55.71910400000001,37.56511599999999,"2015-07-23 16:45:00"],
[55.71902600000001,37.56499099999999,"2015-07-23 16:45:00"],[55.718920000000004,37.56492599999999,"2015-07-23 16:45:00"],
[55.718863000000006,37.56490699999999,"2015-07-23 16:45:00"],[55.718776000000005,37.56490499999999,"2015-07-23 16:45:00"],
[55.718692000000004,37.56494699999999,"2015-07-23 16:45:00"],[55.718619000000004,37.56503099999999,"2015-07-23 16:45:00"],
[55.718569,37.56515399999999,"2015-07-23 16:45:00"],[55.718339,37.566086999999996,"2015-07-23 16:45:00"],
[55.71821,37.56654699999999,"2015-07-23 16:45:00"],[55.717915,37.56752699999999,"2015-07-23 16:45:00"],
[55.717714,37.56812299999999,"2015-07-23 16:45:00"],[55.717638,37.56827799999999,"2015-07-23 16:45:00"],
[55.717574,37.56836799999999,"2015-07-23 16:45:00"],[55.717509,37.56837999999999,"2015-07-23 16:45:00"],
[55.717432,37.56835499999999,"2015-07-23 16:45:00"],[55.717211,37.568164999999986,"2015-07-23 16:45:00"],
[55.716654999999996,37.567376999999986,"2015-07-23 16:45:00"],[55.715936,37.56673799999999,"2015-07-23 16:45:00"],
[55.714501999999996,37.56478399999999,"2015-07-23 16:45:00"],[55.711217999999995,37.56036499999999,"2015-07-23 16:45:00"],
[55.70950199999999,37.55798099999999,"2015-07-23 16:45:00"],[55.70923299999999,37.55764299999999,"2015-07-23 16:45:00"],
[55.70728599999999,37.55499999999999,"2015-07-23 16:45:00"],[55.70596599999999,37.55320499999999,"2015-07-23 16:45:00"],
[55.70546899999999,37.55257299999999,"2015-07-23 16:45:00"],[55.70197499999998,37.54782399999999,"2015-07-23 16:45:00"],
[55.699660999999985,37.54460399999999,"2015-07-23 16:45:00"],[55.693722999999984,37.53656899999999,"2015-07-23 16:45:00"],
[55.693322999999985,37.535934999999995,"2015-07-23 16:45:00"],[55.68849199999998,37.527274999999996,"2015-07-23 16:45:00"],
[55.67690599999998,37.506446,"2015-07-23 16:45:00"],[55.67354299999998,37.50037,"2015-07-23 16:45:00"],
[55.66997099999998,37.493967,"2015-07-23 16:45:00"],[55.66949899999998,37.49304,"2015-07-23 16:45:00"],
[55.66926599999998,37.492535000000004,"2015-07-23 16:45:00"],[55.668692999999976,37.491191,"2015-07-23 16:45:00"],
[55.66827799999998,37.490103,"2015-07-23 16:45:00"],[55.66763399999998,37.488212,"2015-07-23 16:45:00"],
[55.66724799999998,37.487258999999995,"2015-07-23 16:45:00"],[55.66682399999998,37.486360999999995,"2015-07-23 16:45:00"],
[55.666452999999976,37.485707,"2015-07-23 16:45:00"],[55.666075999999975,37.485118,"2015-07-23 16:45:00"],
[55.665681999999975,37.484613,"2015-07-23 16:45:00"],[55.665121999999975,37.483957000000004,"2015-07-23 16:45:00"],
[55.664662999999976,37.48352800000001,"2015-07-23 16:45:00"],[55.66426599999998,37.48319800000001,"2015-07-23 16:45:00"],
[55.663827999999974,37.48289300000001,"2015-07-23 16:45:00"],[55.66325799999997,37.48255800000001,"2015-07-23 16:45:00"],
[55.66264799999997,37.48227300000001,"2015-07-23 16:45:00"],[55.66208599999997,37.48204900000001,"2015-07-23 16:45:00"],
[55.66087799999997,37.48164300000001,"2015-07-23 16:45:00"],[55.65383299999997,37.47957200000001,"2015-07-23 16:45:00"],
[55.65343599999997,37.47947300000001,"2015-07-23 16:45:00"],[55.653175999999974,37.479433000000014,"2015-07-23 16:45:00"],
[55.65274899999997,37.47940400000002,"2015-07-23 16:45:00"],[55.65234699999997,37.47941500000002,"2015-07-23 16:45:00"],
[55.65180799999997,37.479489000000015,"2015-07-23 16:45:00"],[55.65094399999997,37.479689000000015,"2015-07-23 16:45:00"],
[55.65074399999997,37.479711000000016,"2015-07-23 16:45:00"],[55.65031799999997,37.479723000000014,"2015-07-23 16:45:00"],
[55.64985799999997,37.47968700000001,"2015-07-23 16:45:00"],[55.649665999999975,37.47964200000001,"2015-07-23 16:45:00"],
[55.649521999999976,37.47958600000001,"2015-07-23 16:45:00"],[55.649313999999976,37.47946600000001,"2015-07-23 16:45:00"],
[55.64915199999997,37.47933800000001,"2015-07-23 16:45:00"],[55.64861999999997,37.47882600000001,"2015-07-23 16:45:00"],
[55.648340999999974,37.47851500000001,"2015-07-23 16:45:00"],[55.647456999999974,37.47731600000001,"2015-07-23 16:45:00"],
[55.64729799999998,37.47705800000001,"2015-07-23 16:45:00"],[55.64698999999998,37.476499000000004,"2015-07-23 16:45:00"],
[55.64689699999998,37.47637100000001,"2015-07-23 16:45:00"],[55.64667299999998,37.476121000000006,"2015-07-23 16:45:00"],
[55.64297199999998,37.46817000000001,"2015-07-23 16:45:00"],[55.64155099999998,37.46522600000001,"2015-07-23 16:45:00"],
[55.64085099999998,37.46371500000001,"2015-07-23 16:45:00"],[55.63997999999998,37.46170200000001,"2015-07-23 16:45:00"],
[55.63961699999998,37.46079800000001,"2015-07-23 16:45:00"],[55.63893599999998,37.45934500000001,"2015-07-23 16:45:00"],
[55.63710099999998,37.45559100000001,"2015-07-23 16:45:00"],[55.63533399999998,37.45173400000001,"2015-07-23 16:45:00"],
[55.63442799999998,37.44953400000001,"2015-07-23 16:45:00"],[55.63326499999998,37.44629100000001,"2015-07-23 16:45:00"],
[55.63260799999998,37.444097000000006,"2015-07-23 16:45:00"],[55.63168799999998,37.440630000000006,"2015-07-23 16:45:00"],
[55.63088099999998,37.437444000000006,"2015-07-23 16:45:00"],[55.62810799999998,37.42683900000001,"2015-07-23 16:45:00"],
[55.62816699999998,37.42612000000001,"2015-07-23 16:45:00"],[55.62826899999998,37.425697000000014,"2015-07-23 16:45:00"],
[55.62916499999998,37.42327200000001,"2015-07-23 16:45:00"],[55.62961599999998,37.42214400000001,"2015-07-23 16:45:00"],
[55.629903999999975,37.42163200000001,"2015-07-23 16:45:00"],[55.63040699999998,37.42124800000001,"2015-07-23 16:45:00"],
[55.63044299999998,37.42116400000001,"2015-07-23 16:45:00"],[55.63084799999998,37.420831000000014,"2015-07-23 16:45:00"],
[55.63115499999998,37.42064300000001,"2015-07-23 16:45:00"],[55.63191699999998,37.420389000000014,"2015-07-23 16:45:00"],
[55.63211099999998,37.420299000000014,"2015-07-23 16:45:00"],[55.63225299999998,37.420212000000014,"2015-07-23 16:45:00"],
[55.63240399999998,37.42006700000001,"2015-07-23 16:45:00"],[55.63251599999998,37.41991100000001,"2015-07-23 16:45:00"],
[55.63265799999998,37.41965300000001,"2015-07-23 16:45:00"],[55.63274699999998,37.419373000000014,"2015-07-23 16:45:00"],
[55.63279599999998,37.41899200000002,"2015-07-23 16:45:00"],[55.63295299999998,37.41265100000002,"2015-07-23 16:45:00"],
[55.63295099999998,37.41234100000002,"2015-07-23 16:45:00"],[55.632928999999976,37.41214000000002,"2015-07-23 16:45:00"],
[55.63289699999998,37.41196600000002,"2015-07-23 16:45:00"],[55.63285199999998,37.411824000000024,"2015-07-23 16:45:00"],
[55.63277499999998,37.41165000000002,"2015-07-23 16:45:00"],[55.63270299999998,37.411553000000026,"2015-07-23 16:45:00"],
[55.63262899999998,37.411500000000025,"2015-07-23 16:45:00"],[55.63161299999998,37.411019000000024,"2015-07-23 16:45:00"],
[55.63133399999998,37.41086000000003,"2015-07-23 16:45:00"],[55.63126699999998,37.41078600000003,"2015-07-23 16:45:00"],
[55.63121199999998,37.41069100000003,"2015-07-23 16:45:00"],[55.63116699999998,37.410605000000025,"2015-07-23 16:45:00"],
[55.63112899999997,37.41047200000003,"2015-07-23 16:45:00"],[55.63108799999997,37.40981800000003,"2015-07-23 16:45:00"],
[55.63098399999997,37.40469700000003,"2015-07-23 16:45:00"],[55.63094099999997,37.403291000000024,"2015-07-23 16:45:00"],
[55.63092199999997,37.40229300000002,"2015-07-23 16:45:00"],[55.63092999999997,37.40176800000002,"2015-07-23 16:45:00"],
[55.63095999999997,37.40118000000002,"2015-07-23 16:45:00"],[55.63100899999997,37.400629000000016,"2015-07-23 16:45:00"],
[55.63212199999997,37.39107600000002,"2015-07-23 16:45:00"],[55.63219699999997,37.390613000000016,"2015-07-23 16:45:00"],
[55.63227899999997,37.39038200000002,"2015-07-23 16:45:00"],[55.63235799999997,37.39021800000002,"2015-07-23 16:45:00"],
[55.63255199999997,37.38993300000002,"2015-07-23 16:45:00"],[55.637801999999965,37.38255200000002,"2015-07-23 16:45:00"],
[55.639614999999964,37.38002800000002,"2015-07-23 16:45:00"],[55.63984699999996,37.37978000000002,"2015-07-23 16:45:00"],
[55.63999499999996,37.37975100000002,"2015-07-23 16:45:00"],[55.639886999999966,37.37496100000002,"2015-07-23 16:45:00"],
[55.63992499999997,37.37413100000002,"2015-07-23 16:45:00"],[55.63991299999997,37.37154100000002,"2015-07-23 16:45:00"],
[55.63985399999997,37.368672000000025,"2015-07-23 16:45:00"],[55.63985799999997,37.368219000000025,"2015-07-23 16:45:00"],
[55.63988499999997,37.36797000000003,"2015-07-23 16:45:00"],[55.63992199999997,37.367802000000026,"2015-07-23 16:45:00"],
[55.64012999999997,37.36738100000002,"2015-07-23 16:45:00"],[55.64139499999997,37.364946000000025,"2015-07-23 16:45:00"],
[55.641938999999965,37.36395100000002,"2015-07-23 16:45:00"],[55.64335099999997,37.361265000000024,"2015-07-23 16:45:00"],
[55.643379999999965,37.361110000000025,"2015-07-23 16:45:00"],[55.643382999999965,37.360969000000026,"2015-07-23 16:45:00"],
[55.64333299999996,37.360637000000025,"2015-07-23 16:45:00"],[55.64323799999996,37.36043900000003,"2015-07-23 16:45:00"],
[55.64184499999996,37.358101000000026,"2015-07-23 16:45:00"],[55.643731999999964,37.354553000000024,"2015-07-23 16:45:00"],
[55.64547499999996,37.35122800000003,"2015-07-23 16:45:00"],[55.64568099999996,37.35068700000003,"2015-07-23 16:45:00"],
[55.64578299999996,37.35037400000003,"2015-07-23 16:45:00"],[55.64593999999996,37.34974200000003,"2015-07-23 16:45:00"],
[55.64602999999996,37.34924000000003,"2015-07-23 16:45:00"],[55.64616399999996,37.34808000000003,"2015-07-23 16:45:00"],
[55.64624699999996,37.34753800000003,"2015-07-23 16:45:00"],[55.64643799999996,37.346557000000026,"2015-07-23 16:45:00"],
[55.64658699999996,37.34611600000002,"2015-07-23 16:45:00"],[55.64641199999996,37.345814000000026,"2015-07-23 16:45:00"],
[55.646438999999965,37.34567500000003,"2015-07-23 16:45:00"],[55.64644399999997,37.34552800000003,"2015-07-23 16:45:00"],
[55.64644399999997,37.34476500000003,"2015-07-23 16:45:00"],[55.64656999999997,37.344761000000034,"2015-07-23 16:45:00"],
[55.64663099999997,37.34472300000003,"2015-07-23 16:45:00"],[55.64683699999997,37.34432000000003,"2015-07-23 16:45:00"],
[55.64686699999997,37.34423800000003,"2015-07-23 16:45:00"],[55.646876999999975,37.34412900000003,"2015-07-23 17:25:29"]]&
order[city]=1&
order[deadline]=2015-07-23 16:45:00&
order[done]=2015-07-23 17:25:29&
order[type]=tarif&
tarif[city]=1&
tarif[dayFrom]=07:00&
tarif[dayTo]=21:00&
tarif[kad][]=&
tarif[kad][]=&
tarif[outcity][]=&
tarif[outcity][]=&
tarif[outcityGiving][]=&
tarif[outcityGiving][]=&
tarif[english]=100&
tarif[animal]=150&
tarif[kid]=150&
tarif[baggage]=50&
tarif[ski]=&
tarif[waiting][]=0&
tarif[waiting][]=0&
tarif[waiting][]=0&
tarif[nameplate]=100&
tarif[moving][]=320&
tarif[moving][]=20&
tarif[moving][]=10&
tarif[moving][]=1&
tarif[type]=tarif&
tarif[utype]=min&
Пример запроса на php
$data = array(
	'key'	=> 'Ваш ключ',
	'order'	=> array(
		'option'	=> array('kid' => 1, 'animal' => 1),
		'city'		=> 1,
		'deadline'	=> date('d.m.Y H:i'),
		'done'		=> date('d.m.Y H:i', strtotime('+ 1hour')),
		'type'		=> 'tarif',
		'utype'		=> 'km',
	),
	'route'	=> array('г Москва, Ленинский пр-кт д 22', 'г Москва, ул. Грина 14'),
	'tarif'	=> array(
		'moving'	=> array(200, 1, 25, 1),
		'waiting'	=> array(10, 10, 1),
		'outcity'	=> array(0, 1),
		'type'		=> 'tarif',
		'utype'		=> 'km'
	),
);

$c = curl_init();
curl_setopt($c, CURLOPT_URL, 'https://api.rbtaxi.ru/v3/service/taximeter');
curl_setopt($c, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($c, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($c, CURLOPT_RETURNTRANSFER, TRUE);

$result = curl_exec($c);
curl_close($c);
Ответ
{
	"route":
	{
		"distance":12.239,			// суммарная дистация по заказу с подачей
		"outcity_distance":1.304823,		// дистанция поздки за город
		"moving_distance":9.433434,		// дистанция поездки (без подачи)
		"kad_distance":2.123434,		// дистанция поездки по окружной
		"giving_distance":1.304823,		// дистанция подачи
		"giving_outcity_distance":1.304823,	// дистанция подачи за город
		"warning_distance":0.2342346,		// дистанция с большой погрешносьтю (не учитывается при расчетах)
		"time":2137,				// суммарное время поздки с подачей
		"moving_time":1703,			// время поздки
		"waiting_time":
		{
			"waiting":361,	// время ожидания при подаче
			"moving":57	// время ожидания на промежуточных точках
		},
		"start_time":"2015-03-21 11:39:43",
		"end_time":"2015-03-21 11:39:43",
		"start_region":false,	// информация о точке отправления (для трансферов)
		"end_region":false,	// информация о точке прибытия (для трансферов)
		"script_time":0.0013179779052734
	},
	"sum":{
		"moving":640,	// цена поездки
		"waiting":35,	// цена ожидания
		"outcity":120,	// цена поздки за город
		"giving":60,	// цена подачи
		"kad":60,	// цена поздки по окружной
		"option":0,	// цена опций
		"sum":905,	// сумма за заказ
		"transfer_sum":0,	// сумма трансфера
		"script_time":6.3180923461914e-5
	}
}

Список трансферов

/v3/service/transfer

Список трансферов по городам

Ответ

{
	"1": [ // id города
		{"id":1,"name":"Троицкий","abbr":"Троицкий","type":"district"},
		{"id":2,"name":"Новомосковский","abbr":"Новомосковский","type":"district"},
		{"id":3,"name":"Зеленоградский","abbr":"ЗелАО","type":"district"},
		{"id":4,"name":"Юго-Западный","abbr":"ЮЗАО","type":"district"}
	]
}

Список городов спутников

/v3/service/city_near

Ответ
8: {
	name: "Омск",
	fias: 31572,
	fiasNear: {
		11911: "Исилькуль",
		31572: "Омск",
		43734: "Калачинск",
		65678: "Называевск",
		79237: "Тюкалинск",
		79238: "Тара"
	}
},

Список марок/моделей

/v3/service/car_auto_brand

Список марок/моделей т.с. в нашем классификаторе

Ответ
{
    ...
    "Land Rover": [
        "Defender",
        "Defender 110",
        "Defender 130",
        "Defender 90",
        "Discovery",
        "Discovery Sport",
        "Freelander",
        "Range Rover",
        "Range Rover Evoque",
        "Range Rover Sport",
        "Series I",
        "Series II",
        "Series III"
    ],
    ...
}

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

/v3/service/ping

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

Ответ
["pong"]

ДВУХСТОРОННЕЕ API

Общие Сведения

Двухстороннее API предназначена для более тесной интеграции РБТакси со сторонним ПО.

Основные возможности:

1. Оповещение об изменении статуса заказа

2. Оповещение о начале торгов

3. Оповещение о указании информации об автомобиле

4. Оповещение о закрытии заказа

5. Оповещение об отказе от выполнения заказа

В момент изменения заказа (см. Основные возможности) двухстороннее API делает POST запрос на указанный, в настройках компании URL с информацией об изменениях.

Запрос к URL, указанному в настройках компании считается успешным, если получен HTTP-заголовок ответа "200 OK"

Если API стороннего ПО не ответило или заголовок ответа отличается от "200 ОК", система повторит запрос через некоторое время. Запрос будет повторен 3 раз, после чего прекратит попытки и интеграция будет приостановлена

Использование двухстороннего API позволяет отказаться от использования технологии поллинга для запроса информации по заказу.


Для использования двухстороннего API нужно указать соответствующий URL на странице настроек компании

Начало аукциона

Параметр Тип Описание
type string order/auctionStart
date datetime время, когда произошло событие
id int id заказа в РБТакси
externalId string id заказа во внешнем ПО

Взятие заказа

Параметр Тип Описание
type string order/get
date datetime время, когда произошло событие
id int id заказа в РБТакси
externalId string id заказа во внешнем ПО
singerType string Исполнитель заказа
  • driver – Водитель
  • manager – Диспетчер
company int id компании автора
companySinger int id компании, взявшей заказ
percent int %, за который заказ взят

Простановка статуса

Параметр Тип Описание
type string order/status
date datetime время, когда произошло событие
id int id заказа в РБТакси
externalId string id заказа во внешнем ПО
status string статус заказа
statusChar string статус поездки

Информация об автомобиле

Параметр Тип Описание
type string order/auto
date datetime время, когда произошло событие
id int id заказа в РБТакси
externalId string id заказа во внешнем ПО
gnumber string Гос. номер автомобиля
abrand string Марка автомобиля
amodel string Модель автомобиля
acolor string Цвет автомобиля
phone string Телефон водителя

Просмотр телефона клиента

Параметр Тип Описание
type string order/showPhone
date datetime время, когда произошло событие
id int id заказа в РБТакси
externalId string id заказа во внешнем ПО

Отказ от заказа

Параметр Тип Описание
type string order/cancel
date datetime время, когда произошло событие
id int id заказа в РБТакси
externalId string id заказа во внешнем ПО
action string cancel (от заказа отказались и вернули в биржу) или delete (от заказа отказались и удалили)
comment string комментарий причина отказа

Удаление заказа

Параметр Тип Описание
type string order/delete
date datetime время, когда произошло событие
id int id заказа в РБТакси
externalId string id заказа во внешнем ПО
comment string комментарий причина отказа

Закрытие заказа

Параметр Тип Описание
type string order/done
date datetime время, когда произошло событие
id int id заказа в РБТакси
externalId string id заказа во внешнем ПО
action string done - заказ закрыт или request - запрос закрытия заказа с безналичным рассчетом
price int сумма по заказу
comment string основание для изменения цены безналичного заказа (только для action = request)
phone string телефон клиента