THE UNION HOUSE / Документация

Подключение магазина

Сейчас подключение проходит вместе с командой UnionStandard: вы выпускаете API-токены в кабинетах маркетплейсов, мы подключаем магазин и открываем вам доступ. Обычно от вас нужно 15–20 минут.

Вход в кабинет — через Яндекс ID на заранее разрешённый адрес почты. Токены в интерфейс UnionStandard не вводятся: их принимает менеджер по защищённому каналу.

Что подготовить

МаркетплейсТокенЗачем
WildberriesПерсональный токен API из кабинета продавцаФинансы, заказы/маркетплейс, продвижение; при наличии — статистика и аналитика для воронки
OzonSeller API: Client ID + ключФинансы, заказы FBO/FBS, товары, отчёты
OzonPerformance API: Client ID + SecretСтатистика рекламных кампаний

Если продаёте только на одной площадке — нужны токены только для неё. Магазины Ozon подключаются поэтапно: уточните у менеджера, какие разделы уже доступны.

1. Wildberries

  1. В личном кабинете продавца WB откройте раздел с доступами к API и создайте новый токен.
  2. Отметьте категории доступа:

Если в кабинете есть отдельные категории для статистики и аналитики (воронка продаж), включите и их — так будут доступны выкупы и воронка.

  1. Для анализа достаточно режима чтения. Если планируете A/B-тесты рекламы, токен должен разрешать запись в категории «Продвижение»: тест поочерёдно включает и ставит на паузу две ваши кампании.
  2. Скопируйте токен сразу — WB показывает его один раз.

Точные названия пунктов и режимов смотрите в кабинете WB: площадка время от времени их переименовывает.

2. Ozon: Seller API

  1. В личном кабинете продавца Ozon откройте настройки API-ключей и создайте новый ключ.
  2. Нужен доступ по смыслу к финансам, заказам FBO и FBS, товарам и отчётам. Если не уверены в названии роли — выберите роль с полным чтением данных магазина и уточните у менеджера.
  3. Передайте Client ID и сам API-ключ.

3. Ozon: Performance API

Рекламная статистика Ozon выдаётся отдельно от Seller API.

  1. В кабинете Ozon откройте раздел рекламы (Performance) и создайте API-доступ.
  2. Передайте Client ID и Client Secret.

Точные названия разделов сверяйте с кабинетом Ozon.

4. Как передать токены

5. Вход в кабинет

  1. Сообщите менеджеру адрес почты Яндекса, с которой будете входить. Доступ выдаётся на конкретный адрес.
  2. Откройте кабинет UnionStandard и войдите через Яндекс ID.
  3. Вы увидите только свои магазины. Если вход отклонён — почта ещё не в списке; напишите менеджеру.

6. Первые шаги после подключения

  1. Подождите первую загрузку. Что уже загружено — в разделе Полнота данных.
  2. Заполните себестоимость, налог и свои расходы в Настройках. Без себестоимости прибыль помечается как неполная — см. юнит-экономику и P&L.
  3. Прочитайте коротко про финансовый леджер — так проще понимать, откуда цифры.
  4. Откройте Быстрый старт.

Если что-то пошло не так

СимптомЧто сделать
В отчётах пусто или «—»Проверьте Полноту данных; если период не загружен — напишите менеджеру
Нет рекламыВозможно, у токена нет доступа к продвижению или не передан Performance API
Токен истёк или отозванВыпустите новый и передайте тем же защищённым каналом
Цифры «не как в кабинете»Сначала леджер и раздел «Почему цифра может отличаться» в P&L