API Яндекс Go для бизнеса: Выгрузить поездки за месяц

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

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

Запроси заказы за период: GET /2.0/orders/list с since_datetime и till_datetime (формат YYYY-MM-DDThh:mm:ss±hh:mm), sorting_field = finished_date, limit и offset. Для одного сотрудника — user_id.
Листай страницы, пока offset не превысит total_amount из ответа.
Стоимость с НДС, водителя и маршрут по конкретной поездке отдаёт 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))

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

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).

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

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