Business и кампании
Подключение хранит Business ID и найденные campaign магазинов. Заказы читаются на business-level, затем связываются с точной кампанией. Capability-профиль показывает доступные операции каждого подключения.
Управление Яндекс Маркетом для селлера
Oborot связывает business и campaign Яндекс Маркета с магазинами селлера. Команда получает общую аналитику, точные статусы заказов, два поддерживаемых режима остатков и безопасные действия по FBS, Express и DBS.
Контракт проверен 28 августа 2026 года
FBS, Express и DBS
Перед сменой статуса Oborot повторно читает заказ и сверяет campaign ID, order ID, status и substatus. Разрешённый переход или отмена выполняется durable job и подтверждается итоговым ответом площадки.
Два режима остатков
Partner warehouse работает с отдельными складами FBS, DBS и Express. Grouped использует объединённые группы складов кампании. Режим выбирается явно и хранится в настройках подключения.
Финансы и ярлыки
Статистика заказов загружает платежи, субсидии, возвраты и комиссии с правильным знаком. После READY_TO_SHIP менеджер получает официальный PDF-ярлык A9 по точному заказу.
Модель доступа
Business ID задаёт область подключения
Яндекс Маркет разделяет бизнес, кампании и склады. При подключении селлер указывает Business ID и API-ключ с нужными правами. Discover проверяет доступ, получает магазины и сохраняет их как tenant-scoped сущности. Ключ остаётся в зашифрованном IntegrationSecret, настройки содержат только несекретные идентификаторы и выбранный режим складов.
Validate и discover обновляют capabilities из текущего адаптера. Если Маркет открыл новую безопасную read или write возможность, существующее подключение получает её после повторной проверки. Ошибка ключа переводит соединение в auth_expired. Временная ошибка отдельного endpoint создаёт degraded status и retry, сохраняя данные других магазинов и ресурсов.
Заказы
Статус сверяется до и после команды
Операционные заказы загружаются через business-level API с pageToken. Сумма позиции учитывает payment и cashback. Provider value относится ко всему count, поэтому адаптер рассчитывает цену единицы делением на количество. Исходные status и substatus сохраняются рядом с общим lifecycle для отчётов и разбора спорной операции.
Для FBS, Express и DBS общий command поддерживает подготовку к отгрузке и допустимую отмену. Адаптер читает точный заказ перед записью, сверяет кампанию, статус и этап, затем проверяет итог. Повтор уже выполненного перехода завершается идемпотентно. После READY_TO_SHIP официальный PDF A9 возвращается с no-store и проверенной сигнатурой.
Остатки
Режим склада выбирается осознанно
Partner warehouse читает и обновляет предложения на отдельных складах бизнеса. Этот режим подходит FBS, DBS и Express, когда остаток должен относиться к точному warehouse. Grouped работает через кампанию и объединённые группы складов. Форма подключения показывает активный вариант, а изменение доступа сохраняет выбор и запускает проверку capabilities.
Количество AVAILABLE используется напрямую. Если API передал FIT и FREEZE, доступный остаток рассчитывается как FIT минус FREEZE. Команда записи требует точное предложение, склад или группу, optimistic version и idempotency key. Worker вызывает только endpoint выбранного режима, поэтому данные partner warehouse не смешиваются с grouped inventory.
Отчётность
Платежи и комиссии получают правильный знак
Финансовый поток запрашивает статистику заказов по каждой кампании. Платежи и субсидии сохраняются положительными операциями, возвраты и комиссии отрицательными. Валюта RUR нормализуется в RUB, а внешние ID строятся детерминированно. Повтор страницы обновляет существующую операцию и не создаёт вторую сумму.
Oborot сопоставляет завершённый заказ с начислениями, себестоимостью и рекламным расходом. Отчёт показывает оборот, деньги продавца, contribution, прибыль после рекламы, ROAS и ДРР. Непривязанная финансовая операция, товар без cost или расход другой валюты получает отдельный сигнал и исключается из недостоверного итогового расчёта.
Что проверить перед запуском
- Создать API-ключ и подтвердить правильный Business ID.
- Сверить найденные кампании и магазины после discovery.
- Выбрать partner warehouse или grouped по реальной складской схеме.
- Проверить один FBS или DBS заказ и допустимый переход статуса.
- Скачать PDF A9 и сверить финансовую статистику закрытого периода.
Границы API
Площадка остаётся источником факта
Методы Яндекс Маркета зависят от модели бизнеса, кампании, схемы исполнения и прав ключа. Oborot показывает действие только при подтверждённой capability. Перед записью сервер повторно проверяет организацию, право сотрудника, версию сущности и актуальный provider state.
Режим остатков является частью подключения и не выбирается автоматически по первой найденной записи. Переключение требует проверки тестового товара. Финансовые суммы разных валют остаются раздельными до появления подтверждённого курса на дату операции.
Telegram-first
Подключите первый магазин
Telegram подтвердит личность. Для новой компании Oborot запросит название и адрес, создаст отдельное рабочее пространство и откроет подключение магазина. Токен площадки хранится в зашифрованном хранилище.