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

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

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

1. Запроси заказы за период: GET /2.0/orders/list с since_datetime и till_datetime (формат YYYY-MM-DDThh:mm:ss±hh:mm), sorting_field = finished_date, limit и offset. Для одного сотрудника — user_id.
2. Листай страницы, пока offset не превысит total_amount из ответа.
3. Стоимость с НДС, водителя и маршрут по конкретной поездке отдаёт GET /2.0/orders/info с order_id — поля cost, cost_with_vat, performer, source, destination.

```python
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://mcp-everything.ru/integrations/yandex-go-business/scenarios/zakazat-taksi-sotrudniku.md)
- [Завести нового сотрудника](https://mcp-everything.ru/integrations/yandex-go-business/scenarios/zavesti-novogo-sotrudnika.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