OZON: цены и остатки

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

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

Видно до отправки, а не после

Главный экран — таблица «что уйдёт на Ozon по каждому варианту». В одной строке: товар и его артикул, остаток в магазине и остаток, который получит Ozon; цена в магазине и цена, которая получит Ozon после наценки и округления; зачёркнутая цена; что было отправлено в прошлый раз и когда. Строка, которая в этот прогон не уйдёт, прямо говорит почему: «у варианта не заполнен артикул», «артикула нет в кабинете Ozon», «карточка на Ozon в архиве», «товар не опубликован в магазине».

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

Пробный режим

Плагин ставится с включённым пробным режимом: он считает всё до конца и показывает готовую таблицу, но в Ozon не отправляет ничего. Наценка, округление, страховой запас и сопоставление проверяются на своих товарах и своих цифрах — до первой настоящей выгрузки, а не на живой витрине. Отметка снимается в настройках одним щелчком, когда таблица устраивает.

Сопоставление по артикулу

Ozon знает товар по артикулу продавца — полю offer_id. Кнопка «Сверить с Ozon» забирает список карточек кабинета и раскладывает ассортимент: что нашлось, чего на Ozon нет, у каких вариантов артикул задублирован, у каких его нет вовсе. Дубль — частая и незаметная беда: два варианта с одним артикулом молча перетирали бы остаток друг друга, поэтому плагин их не выгружает, а показывает отдельной вкладкой. Артикулом можно считать не только поле «артикул», но и идентификатор варианта или идентификатор товара — как заведено в вашем кабинете.

Остаток берётся по всему магазину или с одного выбранного склада — если торговля на Ozon идёт со склада, который не делится с витриной. Из остатка вычитается страховой запас: столько штук плагин не показывает на Ozon, чтобы последняя единица не продалась дважды. Есть потолок остатка и отдельное значение для товаров, у которых учёт не ведётся, — Ozon поля «сколько угодно» не знает, ему нужно число.

Правило «снимать с продажи при остатке меньше N» отправляет на Ozon ноль: товар перестаёт продаваться, но карточка остаётся живой со всей своей историей и отзывами — как только остаток вернётся, продажи пойдут снова.

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

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

По расписанию

Выгрузка запускается сама с выбранным интервалом — от получаса до суток. За один прогон уходит столько товаров, сколько выдержит хостинг; плагин начинает с тех, которых дольше всех не обновлял, так что за несколько прогонов очередь проходит целиком. Ozon ограничивает частоту обращений — не чаще одного изменения остатка по товару в полминуты и не больше десяти изменений цены в час; плагин эти пределы соблюдает и не тратит их впустую: значение, которое Ozon уже знает, повторно не отправляется.

Что уйдёт и что нет, видно в таблице до прогона. Как включить расписание на хостинге — написано прямо в рабочем месте, отдельно искать в документации не нужно.

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

Client-Id и Api-Key. Чем сопоставлять товары. Склад Ozon для остатков — его номер показывает кнопка «Проверить связь и узнать номера складов», в личном кабинете Ozon этот номер сотруднику взять негде. Остатки: откуда брать, страховой запас, потолок, значение для товаров без учёта, порог снятия с продажи. Цены: наценка, округление, зачёркнутая цена, нижняя граница, ставка НДС. Выгружать ли только опубликованные товары. Пробный режим. Расписание: включение, интервал, число товаров за прогон.

Что нужно для работы

Кабинет продавца Ozon и ключ Seller API («Настройки» → «Seller API») с правами на товары и цены. Товарные карточки на Ozon должны быть уже заведены, а их артикул продавца — совпадать с тем, что выбрано в настройках плагина. Для выгрузки остатков нужен склад продавца — схемы FBS или realFBS; по схеме FBO остатками распоряжается сам Ozon, и выгружать их неоткуда. Плагин обращается только к api-seller.ozon.ru.

Совместимость

Shop-Script 9.4.1 и новее, интерфейс Webasyst 2.0; поддержан и старый интерфейс 1.3;

локализация: русский, английский;

тёмная тема панели управления поддержана: цвета берутся из переменных бэкенд-темы;

проверено на ширинах экрана от 390 px — на телефоне таблица и кнопки работают так же, как на компьютере;

на витрину магазина плагин не влияет: он живёт только в панели управления и ничего в товарах не меняет.

Вопросы и пожелания — через форму обратной связи разработчика.