# 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 — общее число сотрудников.

```bash
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://mcp-everything.ru/integrations/yandex-go-business/scenarios/zakazat-taksi-sotrudniku.md)
- [Выгрузить поездки за месяц](https://mcp-everything.ru/integrations/yandex-go-business/scenarios/vygruzit-poezdki-za-mesyats.md)
- [Отменить заказ такси](https://mcp-everything.ru/integrations/yandex-go-business/scenarios/otmenit-zakaz-taksi.md)

---

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