Ответ 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 | нет | Тег заказа |
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), промокодов, автопарка, заказов Еды, операций Заправок и командировок.Если этого недостаточно — официальная документация: https://yandex.ru/dev/taxi/doc/business-api/concepts/about-docpage/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-go-business.md