Раздел «Магазины»: подключение и синхронизация

В разделе «Магазины» подключаются кабинеты маркетплейсов и запускается загрузка данных. Здесь же видно, когда последний раз приходили свежие цифры.

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

«Добавить магазин» → выбор площадки → название (любое, для себя) и ключ доступа. Сразу после сохранения запускается первая загрузка.

• Wildberries — один API-токен продавца. Как его создать и какие категории отметить, — в статье «API-токен Wildberries».
• Ozon — пара Client-Id и Api-Key из Seller API. Какую роль выбрать при создании ключа и почему пропущенная роль ломает расчёт тихо, — в статье «Ключ Ozon Seller API».
• Яндекс.Маркет — один ключ Partner API. Номера кабинета и магазинов вводить не нужно: сервис читает их по самому ключу. Как его создать и какие доступы отметить, — в статье «Ключ Яндекс.Маркета».
• Авито — пара client_id и client_secret: её выдаёт сам кабинет Авито в разделе для работы с API, ждать активации не нужно. Номер кабинета вводить не нужно — сервис читает его по самим ключам.

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

Ключ можно проверить прямо в форме, не сохраняя магазин: сервис скажет, живой ли он и какой это кабинет. Опечатка так находится сразу, а не через час пустых отчётов.

Синхронизация

Кнопка «Синхронизировать» забирает данные из кабинета: у Wildberries — заказы, продажи, отчёт о реализации, удержания, остатки и расходы на рекламу; у Ozon — отправления FBO и FBS, начисления, товары, остатки и статистику рекламы; у Яндекс.Маркета — заказы всех витрин с их услугами, отчёты по услугам и взаиморасчётам, товары, остатки и буст продаж; у Авито — заказы вместе с удержанием площадки, товары, остатки объявлений и списания кабинета за период (продвижение и тарифы). На карточке магазина видно статус и время последней загрузки.

• Wildberries: история рекламы набирается за несколько дней. Списания с рекламного счёта площадка отдаёт короткими периодами и не чаще раза в час, поэтому одна синхронизация забирает свежий месяц, а более старые — следующие. Пока история добирается, магазин может быть помечен «Обновлено частично»: расходы за последние недели уже учтены, за более ранние — подтянутся сами.
• Маркет: одна синхронизация забирает все витрины кабинета. FBY, FBS, DBS и Экспресс — это способы размещения одного кабинета, а не отдельные магазины: подключается кабинет целиком и занимает один слот.
• Маркет: услуги за период приезжают отчётами, и не мгновенно. Часть денег площадка отдаёт не вместе с заказом, а отдельными файлами, которые строятся по запросу — не чаще раза в две минуты на кабинет. Поэтому вторая синхронизация подряд может вернуть отчёты не сразу: заказы обновятся, а услуги подтянутся следующим разом. Это ход работы, а не ошибка.
• Ozon: первая загрузка идёт заметно дольше. Начисления Ozon отдаёт по одному дню за запрос, а окно загрузки — 90 дней, поэтому синхронизация выполняется в фоне: страницу можно закрыть, статус обновится сам.
• Ozon: расходы приходят с задержкой. Комиссия и логистика по свежим отправлениям появляются через несколько дней после доставки — в самом отправлении их нет вовсе. Пока начисление не пришло, прибыль по такому заказу считается без него.
• Комиссия и логистика приходят понедельно. Wildberries отдаёт отчёт о реализации раз в неделю, поэтому по свежим заказам суммы уточняются позже — это нормальный ход, а не сбой.
• «Обновлено частично» — часть данных не приехала. Заказы загрузились, а какой-то отдельный источник площадка в этот раз не отдала целиком: например отчёт о реализации, остатки, расходы на рекламу или часть заказов за период. Карточка магазина прямо называет, чего не хватило. Если пропущенное влияет на деньги, суммы уточнятся ближайшим обновлением сами — делать ничего не нужно.
• После долгого перерыва «частично» держится несколько дней. Если магазин не обновлялся месяцами, данные за прошлые месяцы догружаются по частям — площадки не отдают такой период разом. Каждую ночь добирается очередной кусок, пометка уходит сама, когда догрузка закончится. В остальных случаях пометка снимается ближайшим удачным обновлением; если она держится несколько дней подряд без перерыва в работе магазина, напишите в поддержку.
• Ручное обновление — до 8 раз в сутки. Данные и так подтягиваются автоматически; кнопка «Обновить» — на случай, когда нужно прямо сейчас. Просмотр уже загруженных отчётов не ограничен. Попытка, на которой площадка ответила «слишком много запросов», в счёт не идёт — данных она не привезла.
• Обновление идёт в фоне — страницу можно закрыть. Нажали «Обновить» — карточка сразу показывает «Идёт синхронизация» и дальше обновляется сама. Загрузка может занять несколько минут: площадки отдают отчёты по частям и ограничивают частоту запросов. Ждать на странице не нужно — вернитесь позже, статус и цифры будут уже новые.
• Несколько магазинов обновляются по очереди. Wildberries считает частоту запросов по продавцу целиком, а не по отдельному кабинету: пока идёт загрузка одного магазина, кнопка у остальных недоступна, и после её окончания нужна ещё минута. Если запустить всё разом, Wildberries закроет доступ сразу ко всем кабинетам — на часы.
• «Ошибка» — карточка называет причину. Обновление не прошло, и рядом со статусом написано, что именно случилось: площадка не приняла ключ, временно ограничила доступ, не ответила вовремя или сбой произошёл на нашей стороне. Менять ключ нужно только в первом случае — там карточка прямо зовёт это сделать. В остальных данные не потеряны: их доберёт ближайшее обновление, делать ничего не нужно.
• «Слишком много запросов» — Wildberries ограничивает частоту обращений. Подождите минуту и повторите.
• «Wildberries закрыл доступ до 14:35 МСК» — площадка отказала и сама назвала время, когда снова можно (везде в кабинете время московское). Пока оно не наступило, кнопка «Обновить» недоступна у всех магазинов этого продавца: лимит у Wildberries общий на все кабинеты, и повторные попытки его только продлевают. Менять ключ не нужно — это не поломка магазина. Данные не потеряются: автоматическое обновление доберёт их, как только срок истечёт.
• «Ozon закрыл доступ до 14:35 МСК», «Яндекс.Маркет закрыл доступ до 14:35 МСК», «Авито закрыл доступ до 14:35 МСК» — то же самое и с теми же последствиями, но с одним отличием: у этих площадок частота считается по кабинету, а не по продавцу. Недоступной становится кнопка только у того магазина, которому отказали, — соседние обновляются как обычно.

Замена ключа доступа

Токены Wildberries выдаются на ограниченный срок. Когда срок вышел или токен отозван, синхронизация начнёт возвращать ошибку. Создайте новый токен и нажмите «Заменить токен» в карточке магазина. Данные при этом сохраняются: заказы, закупочные цены и история никуда не денутся — подтянутся только недостающие записи. Новый токен должен быть от того же кабинета Wildberries; чтобы подключить другой кабинет, добавьте отдельный магазин.

Ждать ошибки не нужно: срок действия токена виден в карточке магазина строкой «Токен», а за 10 дней до его окончания «В плюсе» показывает предупреждение вверху кабинета и присылает письмо. Как только новый токен сохранён, предупреждение и письма прекращаются сами — отключать ничего не нужно.

У магазина Ozon то же самое делает кнопка «Заменить ключ» на карточке: там меняется пара Client-Id / Api-Key и там же добавляются или убираются ключи рекламного кабинета. Новая пара должна быть от того же кабинета Ozon.

У магазина Яндекс.Маркета — кнопка «Заменить ключ»: вставляется новый ключ Partner API, и он должен быть от того же кабинета. Заказы, закупочные цены и история остаются на месте.

У магазина Авито — кнопка «Заменить ключи»: вводятся обе строки, client_id и client_secret, и пара должна быть от того же кабинета Авито. Данные при этом сохраняются.

Пауза магазина

Если магазин временно не нужен, его не обязательно удалять — поставьте на паузу кнопкой на карточке. Магазин на паузе перестаёт синхронизироваться и не попадает в отчёты, на дашборд и в остатки, но все его данные остаются на месте и вернутся, когда вы его включите.

Налоги и взносы на странице «Налоги» и движение денег в разделе «Деньги» продажи такого магазина до паузы учитывают по-прежнему — так же, как и удалённого: доход с них вы уже получили, и налог с него платится.

Одно исключение — прочие расходы, привязанные к этому магазину: пока он на паузе, отчётов по нему нет, и такой расход считается общим — делится между оставшимися магазинами по выручке. Когда включите магазин обратно, расход снова станет его. Если платить за отключённый кабинет вы перестали, поставьте у расхода дату окончания.

Дни, пока магазин стоял на паузе, мы подберём по-разному в зависимости от площадки. Ozon и Яндекс.Маркет отдают историю глубже трёх месяцев, поэтому после включения ближайшая синхронизация догонит пропущенное — до года назад. Wildberries догнать нечем: его API хранит данные только 90 дней и всё, что старше, не отдаёт вовсе. Если магазин WB был выключен дольше трёх месяцев, за этот промежуток цифр не будет. У Авито тот же предел, только шире: заказы приходят примерно за полгода назад, и более давние площадка не отдаёт — паузу длиннее этого срока не догнать и по нему.

Главное, ради чего пауза нужна: подписку можно уменьшить. Оплата считается по работающим магазинам, поэтому выключив лишние, вы платите за меньшее число — в поддержку писать не нужно.

• включить магазин обратно можно через 7 дней после паузы — или сразу, если увеличите число магазинов в подписке;
• для включения нужен свободный оплаченный слот: если все заняты, поставьте на паузу другой магазин или добавьте магазин в подписку;
• слот кабинета пауза не освобождает: подключить вместо выключенного магазина другой кабинет не выйдет — это то же правило, что и при удалении.

Когда подписка заканчивается, магазины выключаются автоматически: так вы сможете вернуться на меньшее их число, не разбираясь, что кому мешает. Такие магазины помечены отдельно, ждать 7 дней для них не нужно, а после оплаты они включаются сами — если все влезают в оплаченное число. Если не влезают, выберите нужные сами: угадывать за вас, какой магазин главный, мы не будем.

Учитывать ли остатки со своих складов

В карточке каждого магазина есть переключатель «Учитывать остатки со своих складов» — он включён по умолчанию. Количество товара на складе маркетплейса площадка считает сама, а количество на вашем складе (схемы FBS, rFBS, DBS, Экспресс) знает только с ваших слов. Если вы ведёте эти цифры неточно, выключите переключатель: такие остатки перестанут попадать в «Заморожено в товаре», в оборачиваемость и в блок «Запас по схемам».

Удаление магазина

Удалённый магазин исчезает из списка, из отчётов и с дашборда и перестаёт обновляться. Платить за него больше не нужно: в оплаченных магазинах он не считается. Накопленная история при этом сохраняется — заказы, начисления, удержания и реклама остаются на месте.

Если магазин нужен «на потом», удобнее пауза: она не требует заново вводить ключ доступа. Закупочные цены не теряются ни при том, ни при другом — они общие для аккаунта и к магазину не привязаны. Если кабинет ваш, но привязан к аккаунту, доступ к которому потерян, — напишите в поддержку, отвяжем.