API Яндекс Go для бизнеса: Завести нового сотрудника

Сценарий из mcp-everything. Актуально на 2026-10-24.

Онбординг: новый сотрудник из 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"}]
      }'

Базовые 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-токен>

Методы сценария

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	нет	Сколько записей пропустить

Нюансы

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

Другие сценарии

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

---

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