Инструкции

Интеграция с Мой склад позволяет:

• выгружать заказы FBS и rFBS в систему учета Мой склад
• выгружать выполненные FBO заказы в МС
• собирать заказ в Ozon при создании отгрузки в МС
• автоматически менять дату отгрузки в заказе, если она изменилась в Ozon
• печатать этикетку из заказа в МС
• автоматически менять статусы заказа в МС
• автоматически создавать входящий платеж для выполненных заказов
• автоматически обрабатывать полученные FBS, FBO возвраты

Для работы с API Мой склад требуется любой платный тариф.

Включите интеграцию с МС.

Укажите логин и пароль.

Заполните ID значений, которые будут подставляться в заказе: юр.лицо, контрагент, проект, склад.

Необходимый id можно посмотреть в URL. Например, при редактировании Вашего юр.лица, id будет после знака «=» https://online.moysklad.ru/app/#MyCompany/edit?id=b6407467-4444-1111-7777-93a7001ab250

Сохраните настройки модуля.

Далее необходимо заполнить ID статусов в МС. Для этого нажмите на кнопку «Загрузить id статусов». Откроется окно с ID Ваших статусов.

Затем нажмите «Загрузить id доп. полей» и заполните ID дополнительных полей в МС: ссылки на этикету, поле даты оплаты.

Если этих полей нет в МС, то необходимо их создать. Нажмите на шестеренку в списке заказов МС.

Откроется боковая панель, где можно создать дополнительные поля для заказа.

Создавать входящий платеж — автоматически создавать входящий платеж к заказу в МС после того, как покупатель получил свой заказ.

Поля для связки товара — укажите, как модуль должен искать товары в МС. В Opencart можно выбрать Артикул или Код товара (модель). В МС Артикул, Код, Внешний код.

Webhook — специальная технология, которая отслеживает изменения в МС. Модуль позволяет это использовать и если ее создать, то при создании отгрузки в МС, модуль «соберет» заказ в Ozon.

Обработка возврата — когда Вы заберете возврат или склад FBO его примет, то модуль автоматически создаст возврат из отгрузки и исходящий платеж, если был входящий.

Начало и конец периода — подробнее в видео.

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

Создавать заказы в Openсart — включите, чтобы заказы из Ozon создавались в Opencart, как обычные заказы.

Обратите внимание, что модуль выгружает только те заказы из Ozon, которые имеют статус «Ожидает сборку».

Далее настройте соответствие статусов Ozon и статусов заказа Opencart.

Если Вы используете Мой склад для товарного учета, то можно не создавать заказы в Opencart. Модуль будет выгружать новые заказы из Ozon сразу в Мой склад.

Цена товара в заказе из OC — опция позволяет при создании заказа устанавливать товару текущую цену магазина, а не по которой он был продан на маркетплейсе.

Для правильной работы модуля и обновления статусов заказа необходимо, повесить на CRON Вашего хостинга ссылки из вкладки «URL»:
«Загрузка/обновление заказов» и «FBS Обновление доставленных заказов».

После экспорта товары попадают в таблицу модуля «Наши товары» со статусом pending. Если товар есть в этой таблице, то он не попадет в следующий экспорт.

Вновь выгрузить товар можно удалив его из этой таблицы нажав на кнопку с круглыми стрелочками. Так же можно выделить несколько товаров и нажать на такую же кнопку вверху страницы.

После экспорта товары проходят модерацию маркетплейсом. Чтобы проверить статус таких товаров нажмите на кнопку с двумя параллельными стрелочками в правом верхнем углу.

Модуль переведет товары прошедшие модерацию в статус processed. Только для них будут выгружаться цены и остатки.

Модерация товаров обрабатывается очередями. Возможные значения параметра:

• pending — товар в очереди на обработку
• imported — товар успешно загружен
• failed — товар загружен с ошибками
• processed — товар создан и готов к продаже

---

Если товары в статусе failed_validation, значит они не прошли модерацию. Такие товары появятся в ЛК, но с ошибками. Нужно исправить ошибки на стороне магазина и повторно выгрузить в Ozon или исправить в ЛК и снова проверить статусы товаров в модуле.

Статус failed означает, что товар не был допущен до модерации. Он не появится в ЛК. Скорее всего не заполнены тип товара для категории или обязательные атрибуты.

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

 

Процесс обновления комиссий и цен выводится на экран. Если этого не происходит, то скорее всего у модуля нет доступа к файлу по пути /system/ozon_seller_process.txt. Обратитесь в ТП хостинга, чтобы они помогли открыть доступ к файлу на сервере. В консоли браузера должны быть успешные запросы к этому файлу с ответом HTTP 200.

Настройте ценообразование товаров на Озоне.

НДС — если используете, то укажите процент.

Фиктивная акция в % — добавляет к товару цену до скидки, которая больше на указанный процент. Рекомендуется указывать не менее 10%. Число должно быть целым.

Надбавки комиссий к цене товаров на FBS и FBO

Логистика — модуль получает стоимость логистики из уже созданной карточки товара на Озоне. Отметьте галочкой, если нужно прибавлять к цене товара.

Комиссия % — комиссия зависит от категории товара. Модуль получает ставку из уже созданной карточки товара на Озоне и вычисляет ее размер из цены товара в ОС. Отметьте галочкой, если нужно прибавлять к цене товара.

Фикс в рублях — прибавить к цене указанное значение. К примеру, обработка FBS отправления.

Последняя миля — прибавлять к товару комиссию за последнюю милю. Рассчитывается из цены товара в ОС. Можно указать максимальный порог цены товара для которого будет действовать опция.

Надбавки к цене суммируются модулем по порядку: Цена = процент от цены в ОС + логистика + фикс + последняя миля от цены в ОС.

Статья Озон: Как формируется стоимость доставки

Дополнительные наценки — можно более детально настроить надбавки или коэффициент к текущей цене в зависимости от цены, диапазона цен, id товара, id производителя, id категории магазина.

Округление цен в Озон — выберите правило округления цен.

Не обновлять цены у товаров — у товаров из этого списка не будут обновляться цены на маркетплейсе.

С версии 2.0.0 модуль поддерживает выгрузку остатков в несколько складов на Ozon.

Чтобы настроить склады перейдите на вкладку «Склады» и нажмите «Добавить».

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

После того, как страница перезагрузится, вернитесь на вкладку «Склады».

Если вы нажали загрузить склады и передумали добавлять — перезагрузите страницу. Иначе склад будет добавлен при сохранении настроек.

Укажите название склада и заполните фильтры по которым будут выгружаться остатки товаров.

В момент выгрузки товаров, модуль проверяет соответствует ли товар указанным в фильтре параметрам и если товар не подходит под условия, то его остаток будет передан как нулевой.

Проверить работу модуля можно по ссылке «Обновление остатков» из вкладки URL.

Вы сопоставили категорию Ozon c категорией магазина. Сопоставили ее атрибуты и настроили справочники. Настроили экспорт. Теперь можно его протестировать.

Если в ЛК у Вас уже есть товары из этой категории, то модуль их перезапишет. Чтобы этого избежать добавьте эти товары в таблицу модуля. Для этого перейдите в «Наши товары» и нажмите на кнопку «Добавить в таблицу товары из Ozon».

Загружаемые товары должны быть без ошибок в ЛК, т.е уже продаваться в Озоне или быть готовы к продаже.

Теперь можно протестировать экспорт.

На вкладке «Экспорт» установите лимит выгрузки в значение 1. Сохраните настройки.

Перейдите на страницу модуля «Экспорт товаров».

В выпадающем списке можно выбрать категорию для экспорта или выгрузить товары сразу из всех категорий.

Если у товара в категории не заполнены обязательные атрибуты, кнопка экспорта не будет активна.

Если в таблице у выгружаемого товара нет значений у атрибутов, а Вы ранее настроили их соответствие, значит забыли их указать в самом товаре.

Если кнопка экспорта доступна, то при ее нажатии товар будет передан в Озон.

Если на вкладке Экспорт включить тест экспорта, то модуль не отправит запрос в Озон, а только выведет его на экран.

ТП Ozon может запросить у Вас этот запрос для проверки, когда будут проблемы с выгрузкой.

После экспорта необходимо проверить статусы товара на странице модуля «Наши товары».

Возможные ошибки возвращаемые Ozon

Выгрузка товаров категория ID … {«code»:3,»message»:»proto: (line 1:40869): invalid value for string type: null«,»details»:[]}

Ошибка указывает на то, что у товара какое-то поле передается значением null. Включите тест экспорта и найдите в запросе это значение, а затем исправьте в товаре. Например, у товара нет фото и в запросе будет следующее:

«primary_image»: null,
«images»: [ null ]

На вкладке «Экспорт» настраиваются параметры экспорта товаров.

Тестирование экспорта — включив эту функцию модуль отобразит передаваемые запросы в Ozon. Полезно для отладки экспорта.

Лимит выгрузки товаров из категории — количество товаров из одной категории, которое будет выгружено в Ozon. Для пробной выгрузки лучше ставить значение 1, если товар выгрузился без ошибок, то значение можно увеличить до 100.

Минимальная цена для экспорта — если цена товара в магазине меньше той, что будет указана в этом поле, то такой товар не попадет в экспорт.

Выгружать описание товара — модуль подготавливает описание товара перед выгрузкой. Будут удалены все теги. В том числе фото и видео.
Вы можете задать свое описание товара по умолчанию всем выгружаемым товарам. Оно заменит описание товара из карточки.

Выгружать атрибуты в описание товара — атрибуты будут выгружены в виде таблицы с описанием товара или без него.

Создавать товары, даже если их нет в наличии — по умолчанию, товары с нулевым остатком не будут созданы в Ozon. Активируйте, если их нужно выгрузить в маркетплейс.

Использовать главную категорию товара — включите, если у товаров в магазине используется главная категория товара. По умолчанию в Опенкарт у товаров нет такой настройки. Вот как она выглядит

Черный список товаров — товары из списка не будут созданы. Если товар уже есть в ЛК, то его остаток будет обнулен.

На вкладке можно указать, товары каких производителей не нужно выгружать в Ozon.

Как и с атрибутами необходимо сопоставить производителей магазина с брендами на маркетплейсе.

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

Нажмите «Сопоставить производителей». Откроется таблица.

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

Если логотип искомого бренда не соответствует, то это одноименный производитель, но не тот который Вам нужен. Если нужного бренда нет в списке, значит его нет в Ozon.

Если в карточке похожего товара на Ozon не отображается логотип, а только текст, то бренд не создан.

В обоих случаях нужно создавать бренд через поддержку Ozon.

После того, как сотрудник службы поддержки сообщит, что бренд создан — скачайте заново список производителей.

Если нужно обновить ранее сохраненное значение в списке, то сначала выберите —очистить—, сохраните, а затем укажите новое значение.

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

После того, как атрибуты были скачаны, они попадут в общий список для всех категорий на вкладке «Атрибуты».

Воспользуйтесь фильтром, чтобы в списке остались атрибуты для конкретной категории и отобразить обязательность для выбранной категории.

В разных категориях могут быть одни и те же атрибуты. Например: цвет, страна, вес и т.д. Их Вы настраиваете один раз.

Сопоставьте атрибуты магазина и маркетплейса.

Если у атрибута есть справочник, сопоставьте характеристики товара из справочника.

В справочнике работает мультивыбор. Например для цвета в магазине черно-красный, можно выбрать значения из справочника Озон — черный и красный.

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

Обязательные для выбранной категории атрибуты будут выделены. Если их не заполнить, то Ozon не загрузит этот товар.

При необходимости можно обновить список атрибутов и справочников с Ozon. Для этого нажмите красную кнопку внизу страницы. Модуль загрузит новые атрибуты и обновит старые для всех категорий. Ваши настройки не пропадут.

Осталось сопоставить производителей и настроить экспорт для пробной выгрузки товара.

После того, как Вы настроили основную вкладку, можно приступать к настройке выгрузки товаров. Первым делом необходимо сопоставить категории магазина и Ozon.

Перейдите на вкладку «Категории» и скачайте список категорий, нажав на соответствующую кнопку.

Модуль загрузит все названия категорий, страница перезагрузится.

Вернитесь на вкладку и нажмите на плюсик.

Сопоставьте категории магазина и Ozon. Сохраните настройки модуля.

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

Для вновь добавленной категорий всегда нужно скачивать ее атрибуты.

Операция может занять длительное время. Ожидайте окончания процесса.

После загрузки атрибутов под названием категории магазина появится настройка типа товаров этой категории.

Укажите тип товара в выпадающем списке под категорией магазина.

Если тип товара соответствует атрибутам, то модуль дает возможность это использовать:

• Выберите «тип товара соответствует атрибутам», сохраните настройки.
• Появится кнопка настройки под этим выпадающим списком, где можно сопоставить значения.

• Можно указать несколько атрибутов магазина для типа товара используя ++.
• Пример: Тип товара: Велокрыло, ему соответствуют атрибуты в вашем магазине «Переднее++Заднее».

Обратите внимание: если нужно скорректировать это сопоставление типа и атрибута, то сначала удалите «Переднее++Заднее», сохраните изменения и только затем вставьте «Переднее++Заднее++Универсальное».

Укажите размеры и вес по умолчанию для товаров этой категории.

Если в карточке товара на вкладке «Данные» они не заполнены, то модуль будет использовать указанные Вами значения по умолчанию.

Сохраните изменения и перейдите к настройке атрибутов для этой категории.

Рекомендую выгружать товары по категориям.
Сначала добавляете в модуль одну категорию. Выгружаете все ее товары в Ozon. Затем добавляете вторую и так далее.