# API Яндекс Go для бизнеса: 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 | нет | Тег заказа |

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

## Нюансы

- Порядок работы: получить токен → настроить центры затрат, роли и сотрудников → `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://yandex.ru/dev/taxi/doc/business-api/concepts/about-docpage/
Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-go-business.md