Dodo IS API: Собрать ежедневный отчёт по выручке пиццерий

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

Отчёт для партнёра-франчайзи: выручка каждой пиццерии по дням и каналам продаж — в таблицу, BI или чат.

Создай приложение в кабинете разработчика Dodo IS и получи токен по OAuth 2.0 Authorization Code: https://auth.dodois.io/connect/authorize, затем https://auth.dodois.io/connect/token. Запроси scopes shared, user.role:read и offline_access, чтобы получать refresh_token и не просить вход каждый день.
Узнай ID своих заведений: GET /units с countryId (например, RU) и businessId. Пагинация — skip и take.
Запроси продажи: GET /finances/sales/units/daily с units (UUID через запятую без пробелов), fromDate и toDate. Данные агрегированы по дням, каналам продаж (Delivery, Dine-in, Takeaway), источникам заказа и способам оплаты.
Базовый URL зависит от страны и бренда: для Додо Пиццы в России — https://api.dodois.io/dodopizza/ru, для Drinkit — https://api.dodois.io/drinkit/ru.

API=https://api.dodois.io/dodopizza/ru

curl -G "$API/units" -H "Authorization: Bearer $DODO_TOKEN" \
  -d countryId=RU -d businessId=<businessId> -d take=100

curl -G "$API/finances/sales/units/daily" -H "Authorization: Bearer $DODO_TOKEN" \
  -d units=<unit_uuid_1>,<unit_uuid_2> -d fromDate=2026-10-01 -d toDate=2026-10-23

Базовые URL

Боевой (Россия, Додо Пицца): https://api.dodois.io/dodopizza/ru
Боевой (Россия, Drinkit): https://api.dodois.io/drinkit/ru
Тестовый (mock-сервер): https://stoplight.io/mocks/dodo-brands/dodo-is/51665679
Для других стран: https://api.dodois.io/dodopizza/{kz,by,kg,uz,tj}

Авторизация

Тип: OAuth 2.0

OAuth 2.0 Authorization Code. Приложение создаётся в личном кабинете разработчика; токен передаётся в заголовке Authorization: Bearer <token>.

Авторизация: https://auth.dodois.io/connect/authorize
Токен и обновление: https://auth.dodois.io/connect/token

Основные scopes: shared, orders, accounting:read, deliverystatistics, sales, stopsales, staffmembers:read, staffshifts:read, unit:read, user.role:read, offline_access (получение refresh_token).

Методы сценария

GET /units — Информация о заведениях

Scope: shared.

Параметр	Где	Тип	Обяз.	Описание
`countryId`	query	string	да	Страна в формате ISO 3166-1 alpha-2
`businessId`	query	string	да	ID бизнеса (UUID)
`unitTypes`	query	string	нет	Типы заведений
`unitStates`	query	string	нет	Состояние заведения
`units`	query	string	нет	Заведения (UUID)
`organizations`	query	string	нет	Организации (UUID)
`skip`	query	integer	нет	Сколько записей пропустить, по умолчанию 0
`take`	query	integer	нет	Сколько записей выбрать, по умолчанию 100, максимум 1000

GET /finances/sales/units/daily — Дневные продажи по заведениям

Агрегировано по дням, каналам продаж (Delivery, Dine-in, Takeaway), источникам заказа и методам оплаты. Scope: shared.

Параметр	Где	Тип	Обяз.	Описание
`units`	query	string	да	Заведения (UUID)
`fromDate`	query	string	да	Дата начала, ISO 8601
`toDate`	query	string	да	Дата конца, ISO 8601

Нюансы

Постраничные методы: увеличивайте skip на число полученных записей, пока в ответе не придёт isEndOfListReached = true.
Списки UUID (units и др.) — через запятую без пробелов; во многих методах не больше 30 заведений за запрос.
Доступ к данным ограничен ролями пользователя и его заведениями — scope user.role:read нужен почти везде.
Также есть Auth API (заведения и роли пользователя по токену) и Marketplace API (доступ пользователя к платным функциям приложения).
Статус работы API: https://status.dodois.io/.

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

Если этого недостаточно — официальная документация: https://docs.dodois.io/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/dodo-is.md