API Яндекс Go для бизнеса API

Отрасль: Путешествия и транспорт. Актуально на 2026-10-24.

API для корпоративных клиентов Яндекс Go: управление сотрудниками, центрами затрат, лимитами, департаментами и районами, заказ корпоративного такси (оценка стоимости, создание, отслеживание, отмена), список заказов и отчёты, промокоды, а также данные по другим сервисам (Еда, Заправки, командировки). Версия API 2.0. Вопросы по интеграции — corptaxi-api@yandex-team.ru.

Сценарии

Заказать такси сотруднику

Заказ корпоративного такси из своей системы: офис-менеджер или бот вызывает машину на нужный адрес.

1. Получи OAuth-токен в Кабинете Корпоративного Клиента («Профиль компании» → «Получить токен») и передавай его в заголовке Authorization: Bearer <токен>. Если по токену доступно несколько кабинетов, добавляй X-YaTaxi-Selected-Corp-Client-Id — список доступных даёт GET /2.0/auth/list.
2. Узнай стоимость: POST /2.0/orders/routestats с route — точками [долгота, широта] (не меньше двух) — и user_id сотрудника. В ответе service_levels с ценой и временем подачи по тарифам и offer для заказа.
3. Создай заказ: POST /2.0/orders/create с user_id, route (geopoint и fullname — адрес), class (тариф), offer и заголовком X-Idempotency-Token — новым UUID на каждый заказ. Для предзаказа — due_date.
4. Ответ 406 значит, что оффер устарел: заново вызови routestats. При 500 заказ мог создаться — повтори запрос с тем же X-Idempotency-Token, дубля не будет.
5. Следи за машиной: GET /2.0/orders/progress с order_id — status, time_left_raw (секунд до прибытия) и vehicle.location. Учти: в vehicle.location порядок [широта, долгота], обратный route.

import uuid, requests

API = "https://b2b-api.go.yandex.ru/integration/2.0"
H = {"Authorization": "Bearer <OAuth-токен>", "X-YaTaxi-Selected-Corp-Client-Id": "<client_id>"}
route = [[37.5880, 55.7340], [37.6173, 55.7558]]          # [долгота, широта]

est = requests.post(f"{API}/orders/routestats", headers=H,
                    json={"route": route, "user_id": "<user_id>"}).json()
level = next(l for l in est["service_levels"] if l["class"] == "business")

order = requests.post(f"{API}/orders/create",
                      headers={**H, "X-Idempotency-Token": str(uuid.uuid4())},
                      json={"user_id": "<user_id>", "class": "business", "offer": est["offer"],
                            "route": [{"geopoint": route[0], "fullname": "Москва, ул. Льва Толстого, 16"},
                                      {"geopoint": route[1], "fullname": "Москва, Красная площадь"}],
                            "comment": "Подъезд со двора"}).json()

progress = requests.get(f"{API}/orders/progress", headers=H,
                        params={"order_id": order["order_id"]}).json()
print(progress["status"], progress.get("time_left_raw"))

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

Онбординг: новый сотрудник из HR-системы сразу получает доступ к корпоративному такси с нужным центром затрат и лимитом.

1. Возьми ID центра затрат: GET /2.0/cost_centers/list (limit, offset).
2. Создай сотрудника: POST /2.0/users с fullname, phone в международном формате (+79001234567), is_active = true, cost_centers_id и nickname — ID сотрудника в твоей системе, чтобы потом сопоставлять записи.
3. Лимиты передай в limits: limit_id ранее созданного лимита и service (taxi, eats2, drive и т. д.).
4. Проверить и сверить список можно через GET /2.0/users: страницы листаются по next_cursor, total_amount — общее число сотрудников.

curl -X POST https://b2b-api.go.yandex.ru/integration/2.0/users \
  -H "Authorization: Bearer $YAGO_TOKEN" -H 'Content-Type: application/json' \
  -d '{
        "fullname": "Иван Петров",
        "phone": "+79001234567",
        "is_active": true,
        "email": "i.petrov@example.ru",
        "nickname": "EMP-1042",
        "cost_centers_id": "<cost_center_id>",
        "limits": [{"limit_id": "<limit_id>", "service": "taxi"}]
      }'

Выгрузить поездки за месяц

Сверка расходов: все поездки за период — в бухгалтерию или отчёт по подразделениям.

1. Запроси заказы за период: GET /2.0/orders/list с since_datetime и till_datetime (формат YYYY-MM-DDThh:mm:ss±hh:mm), sorting_field = finished_date, limit и offset. Для одного сотрудника — user_id.
2. Листай страницы, пока offset не превысит total_amount из ответа.
3. Стоимость с НДС, водителя и маршрут по конкретной поездке отдаёт GET /2.0/orders/info с order_id — поля cost, cost_with_vat, performer, source, destination.

import requests

API = "https://b2b-api.go.yandex.ru/integration/2.0"
H = {"Authorization": "Bearer <OAuth-токен>"}
params = {"since_datetime": "2026-10-01T00:00:00+03:00", "till_datetime": "2026-10-31T23:59:59+03:00",
          "sorting_field": "finished_date", "sorting_direction": 1, "limit": 100, "offset": 0}
orders = []
while True:
    page = requests.get(f"{API}/orders/list", headers=H, params=params).json()
    orders += page["items"]
    params["offset"] += params["limit"]
    if params["offset"] >= page["total_amount"]:
        break
print(len(orders))

Отменить заказ такси

Сотрудник передумал ехать — отменяем заказ по правилам, которые сейчас действуют.

1. Узнай допустимые правила отмены: GET /2.0/orders/info с order_id — поле cancel_rules (free, paid или minimal).
2. Отмени: POST /2.0/orders/cancel с order_id в строке запроса и state из cancel_rules в теле. Ответ — {"status": "cancelled"}.
3. Если доступна только платная отмена, предупреди сотрудника до вызова: деньги спишутся с корпоративного счёта.

curl -X POST "https://b2b-api.go.yandex.ru/integration/2.0/orders/cancel?order_id=<order_id>" \
  -H "Authorization: Bearer $YAGO_TOKEN" -H 'Content-Type: application/json' \
  -d '{"state": "free"}'

Базовые URL

• Боевой: https://b2b-api.go.yandex.ru/integration

Авторизация

Тип: OAuth 2.0

OAuth-токен получают в Кабинете Корпоративного Клиента: «Профиль компании» → «Получить токен» → вход на oauth.yandex.ru. Токен действует ограниченное время, затем его нужно получить заново.

Если по токену доступно несколько кабинетов, во всех запросах передаётся заголовок X-YaTaxi-Selected-Corp-Client-Id с ID клиента из профиля компании.

Authorization: Bearer <OAuth-токен>

Методы

GET /2.0/auth/list — Клиенты, доступные по токену

В ответе clients[]: client_id, name, role.

POST /2.0/users — Создание сотрудника

Параметр	Где	Тип	Обяз.	Описание
X-YaTaxi-Selected-Corp-Client-Id	header	string	нет	ID клиента (обязателен при нескольких клиентах)
fullname	body	string	да	Полное имя (может быть пустой строкой)
phone	body	string	да	Телефон в международном формате, например +79001234567
is_active	body	boolean	да	Активен ли сотрудник
email	body	string	нет	Email
cost_centers_id	body	string	нет	ID центра затрат
nickname	body	string	нет	Краткое имя (ID во внешней системе)
department_id	body	string	нет	ID департамента
limits	body	array	нет	Месячные лимиты по сервисам
limits[].limit_id	body	string	да	ID ранее созданного лимита
limits[].service	body	string	да	taxi, eats2, grocery, drive, tanker, cargo, travel, scooters
documents	body	array	нет	Документы сотрудника (document_type обязателен)

GET /2.0/users — Список сотрудников

Сортировка по времени создания, по возрастанию. В ответе: items, cursor, next_cursor, limit, total_amount.

Параметр	Где	Тип	Обяз.	Описание
limit	query	integer	нет	Число записей, по умолчанию 100
cursor	query	string	нет	next_cursor из предыдущего ответа (для следующих страниц)

GET /2.0/cost_centers/list — Центры затрат

Параметр	Где	Тип	Обяз.	Описание
limit	query	integer	нет	По умолчанию 100
offset	query	integer	нет	Сколько записей пропустить

POST /2.0/orders/routestats — Стоимость и оффер на поездку

Если передан user_id и в route не меньше двух точек, возвращается offer для создания заказа. В ответе: offer, service_levels (class, price, is_fixed_price, estimated_waiting), toll_roads.

Параметр	Где	Тип	Обяз.	Описание
Accept-Language	header	string	нет	Язык: ru, en и др.
route	body	array	да	Точки маршрута [[долгота, широта], ...]
user_id	body	string	нет	ID сотрудника
requirements	body	object	нет	Требования к поездке (доступные — в GET /2.0/zoneinfo)
use_toll_roads	body	boolean	нет	Разрешить платные дороги, по умолчанию false

POST /2.0/orders/create — Создание заказа такси

Ответ 200 — order_id; 406 — оффер неактуален (code, message). При ответе 500 заказ мог быть создан — повторите запрос с тем же токеном идемпотентности.

Параметр	Где	Тип	Обяз.	Описание
X-Idempotency-Token	header	string	да	UUID; один токен — один заказ
user_id	body	string	да	ID сотрудника
route	body	array	да	Точки маршрута: geopoint ([долгота, широта]), fullname (адрес)
class	body	string	да	Тариф
offer	body	string	нет	ID оффера из routestats
due_date	body	string	нет	Время подачи YYYY-MM-DDThh:mm:ss±hh:mm
requirements	body	object	нет	Требования к заказу
cost_center_values	body	array	нет	Значения полей центров затрат: id, title, value
comment	body	string	нет	Комментарий водителю
order_tag	body	string	нет	Тег заказа

GET /2.0/orders/progress — Отслеживание заказа

В ответе: status, time_left_raw (секунд до прибытия или окончания), vehicle.location.

Параметр	Где	Тип	Обяз.	Описание
order_id	query	string	да	ID заказа

GET /2.0/orders/info — Информация о заказе

В ответе: id, user_id, class, status, due_date, finished_date, performer (водитель и автомобиль), source, destination, cancel_rules, cost, cost_with_vat.

Параметр	Где	Тип	Обяз.	Описание
order_id	query	string	да	ID заказа

POST /2.0/orders/cancel — Отмена заказа

Ответ: {"status": "cancelled"}.

Параметр	Где	Тип	Обяз.	Описание
order_id	query	string	да	ID заказа
state	body	string	нет	Правило отмены из cancel_rules: free, paid, minimal

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

POST http://b2b-api.go.yandex.ru/integration/2.0/orders/cancel?order_id=191...280
...
Authorization: Bearer <OAuth-token>
X-YaTaxi-Selected-Corp-Client-Id: <client-id>
 {
 "state": "free"
 }

GET /2.0/orders/list — Список заказов клиента

В ответе: items, limit, offset, total_amount.

Параметр	Где	Тип	Обяз.	Описание
limit	query	integer	нет	По умолчанию 100
offset	query	integer	нет	Сколько записей пропустить
user_id	query	string	нет	Фильтр по сотруднику
sorting_field	query	string	нет	due_date (по умолчанию) или finished_date
sorting_direction	query	integer	нет	1 — по возрастанию, -1 — по убыванию (по умолчанию)
since_datetime	query	string	нет	Начало периода YYYY-MM-DDThh:mm:ss±hh:mm
till_datetime	query	string	нет	Конец периода

Нюансы

• Порядок работы: получить токен → настроить центры затрат, роли и сотрудников → routestats → orders/create → orders/progress/orders/info → при необходимости orders/cancel.
• Координаты в route и geopoint — в порядке [долгота, широта]; в vehicle.location ответа — [широта, долгота] (см. примеры документации).
• Для отмены передайте state из cancel_rules метода orders/info.
• Также есть методы департаментов и их лимитов, районов (geo_restrictions), информации о зоне (zoneinfo), промокодов, автопарка, заказов Еды, операций Заправок и командировок.
• Для заказа доставки есть отдельный API доставки (cargo API).

Ошибки

Код	Описание
400	Неизвестный параметр или недопустимое значение
401	Неверный OAuth-токен
403	SELECT_CLIENT_HEADER_REQUIRED — не передан X-YaTaxi-Selected-Corp-Client-Id; SELECTED_CLIENT_ACCESS_DENIED — нет доступа к указанному клиенту
404	Заказ не найден
406	Оффер неактуален
409	Конфликт
500	Ошибка сервера (заказ мог быть создан)

Источники

• API Яндекс Go для бизнеса
• Введение
• Начало работы
• Запросы к сервису API 2.0
• Создание заказа
• Стоимость поездки
• Отмена заказа
• Создание сотрудника

---

Если этого недостаточно — официальная документация: https://yandex.ru/dev/taxi/doc/business-api/concepts/about-docpage/ JSON: https://mcp-everything.ru/api/integrations/yandex-go-business. MCP: https://mcp-everything.ru/mcp