Инструкции

Установка модуля интеграции Ozon Seller на Opencart

Разархивируйте архив с модулем.

Зайдите в папку с Вашей версией магазина: 2.1, 2.3 или 3.0.

В папке upload находятся 3 подпапки: admin, catalog, system. Загрузите их в корень сайта на хостинге.

После установки обновите модификаторы Opencart.

Перейдите на страницу расширений магазина и найдите в списке установленных модулей CDL Ozon Seller. Нажмие на плюс.

Установка модуля завершена.

403 Forbidden при тестировании запросов от Маркета

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

Ошибка указывает на то, что доступ к модулю не предоставлен, т.к проверка Authorization токена не удалась. Скорее всего Ваш сервер вырезает этот ключ из массива заголовков.

Чтобы решить эту проблему попробуйте добавьте в файл htaccess один из трех вариантов.

Первый способ:

В более ранних версиях Apache внесите в самом начале .htaccess

#CDL Market
RewriteEngine on

RewriteCond %{HTTP:Authorization} ^(.*)
RewriteRule ^(.*) — [E=HTTP_AUTHORIZATION:%1]

Второй способ:

Просто добавьте
RewriteRule .* — [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]

Третий способ:

В режиме CGI и Apache 2.4.13 и старше для включения передачи заголовка внесите: CGIPassAuth On

Самопроверка работы с API

После того, как Вы связали товары, настроили цены, нужно обязательно произвести самопроверку работы с заказами в ЛК Маркета.

Перейдите в ЛК в Настройки — Отладка и выполните все задания из списка.

Обработайте тестовые заказы в модуле

После успешной отладки можете выгружать остатки и начинать работу на Маркете.

Базовая настройка модуля

На основной вкладке модуля настраивается подключение к Яндекс Маркету.

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

— добавьте свои магазины с Маркета. Заполняемые данные можно посмотреть в ЛК маркетплейса на странице Настройки — Настройки API.

  1. Способ работы укажите через API
  2. Скопируйте номер кампании
  3. Сгенерируйте и скопируйте авторизационный токен
  4. Способ авторизации выберите — HEADER.
  5. URL для запросов API — укажите ссылку из вкладки модуля URL.
  6. Способ обновления данных об остатках — укажите через API со своего сервера

Настройте склад в ЛК Маркета и скопируйте в модуль ID склада.

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

Связывать товары — по какому полю искать товары в Opencart.

Настройте статусы на следующей вкладке модуля, если нужно создавать заказы в Opencart.

После того, как все настроили, перейдите на страницу модуля Наши товары и свяжите товары из своего ЛК Маркета с товарами в Opencart. В пробной версии модуля можно связать только первые 100 товаров.

На странице модуля Цены настройте и обновите их на Маркете.

Перед тем, как настраивать остатки, добавьте вручную остаток одному товару и пройдите самопроверку работы с заказами.

Загрузка товаров из Ozon в Маркет

В API Маркета не реализована работа с атрибутами товара, поэтому я не стал добавлять экспорт товаров из Opencart.
Если Вы уже продаете на Озоне или других маркетплейсах, тогда есть возможность загрузить оттуда товары в Яндекс Маркет. При этом подтянутся все атрибуты товара. Разберем на примере Озон.

Обратите внимание, что если у Вас несколько интернет-магазинов и Вы хотите разделить товары по кабинетам, а не по магазинам внутри кабинета, то нужно регистрировать новый кабинет по этой ссылке: https://partner.market.yandex.ru/welcome/partners

На Маркете перейдите в Настройки — Интеграции. Добавьте ранее созданные в ЛК Озон ClientID и API-ключ.

Укажите какие товары нужно добавить из ЛК Озон

После того, как товары загрузятся в общий каталог, нужно привязать их к конкретному магазину

После этого можно переходить к связке товаров в модуле

Установка модуля интеграции с Яндекс Маркет на Opencart

Разархивируйте архив с модулем.

Загрузите папки catalog и system в корень вашего сайта. Они универсальные для всех версий Opencart.

Зайдите в папку admin_for_* для вашей версии Opencart и загрузите папку admin в корень вашего сайта.

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

Установка завершена.

Вопрос — ответ. Интеграция Ozon Seller c Opencart

Как происходит обновление цен?

Для обновления цен на Озоне необходимо пройти по ссылке «Обновление цен» из вкладки URL. Модуль выгрузит цены для тех товаров, что находятся в таблице «Наши товары» и имеют статус processed.  Ценообразование настраивается на вкладке «Цены». Обратите внимание, что цены на Озоне обновляются с задержкой 20-30 минут. Вы можете настроить CRON на хостинге, чтобы автоматизировать этот процесс.

Как происходит обновление остатков?

Для обновления остатков на Озоне необходимо пройти по ссылке «Обновление остатков» из вкладки URL. Модуль выгрузит остатки для тех товаров, что находятся в таблице «Наши товары» и имеют статус processed.

На вкладке «Склады» можно настроить фильтр для каждого склада в Озон. По нему модуль будет определять выгрузить на склад текущий остаток товара или нулевой.

Обратите внимание, что остатки на Озоне обновляются с задержкой 5-10 минут. Вы можете настроить CRON на хостинге, чтобы автоматизировать этот процесс.

У меня не обновляются цены или остатки

Возможные проблемы:

  • Вы не обновили статусы у товаров на странице «Наши товары» после экспорта. Нажмите на кнопку с параллельными стрелками в правом верхнем углу.
  • Вы обновили статусы товаров, но их статус не processed. Только у товаров в статусе processed обновляются цены и остатки.

Возможно товары выгрузились в Озон с ошибками. Исправьте ошибки и повторите экспорт.

Возможно статусы товаров зависли в posting, processing, pending или imported. Тогда они еще не успели пройти модерацию, либо произошел сбой на Озоне. Попробуйте повторить экспорт.

  • Если статус товара processed, но цены или остатки не обновляются. Включите тест экспорта, пройдите по ссылке. Модуль отобразит запрос. Пришлите мне в ЛС на форуме этот запрос.

Как включить тест экспорта

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

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

История обновлений модуля Ozon Seller для Opencart

v2.4.3
ВНИМАНИЕ! Для обновления до версии 2.4.3 необходимо залить файлы на сервер, обновить модификаторы и пройти по ссылке ниже. Проверить настройки модуля и сохранить их.
Для 2.1:
https://ваш-сайт.ru/index.php?route=module/ozon_seller/update243
Для 2.3-3.0:
https://ваш-сайт.ru/index.php?route=extension/module/ozon_seller/update243

— на вкладке экспорт можно включить обновление остатков у отключенных товаров.
— исправил получение производителей из Озон.
— исправил ошибки в списке атрибутов.
— теперь модуль получает из карточки товара Озон процент комиссии на категорию и стоимость логистики. Фикс за обработку отправления по прежнему указываете вручную. Последняя миля и % рассчитываются из цены в ОС.
— чтобы получить комиссии на товар, нужно нажать на соответствующую кнопку на странице Наши товары.
— подсвечиваются цены Озон с индексом более 1.1.
— выгрузить цены можно на странице Наши товары.
— исправил обновление статусов товара.

v2.4.2
— немного ускорил загрузку модуля при большом количестве атрибутов в магазине.
— Озон изменил поле в котором хранилась дата заказа, из-за чего год заказа стал 1970.
— теперь если в карточке товара ОС указано несколько категорий и одна из них есть в черном списке склада, будет передан нулевой остаток этого товара.
— из складов убран фильтр по объемному весу.
— на вкладке экспорт можно задать описание для всех товаров по умолчанию.
— обновлен протокол для метода получения товаров с Озон.

v2.4.1
— для товаров на FBO и FBS можно задавать разные наценки. Модуль определяет правило наценки по количеству товара на складах, что отображаются на странице Наши товары. Если у товара есть остаток на FBO, то будут применены наценки для FBO. В ином случае для FBS. Если Вам не нужно разделять цены, заполните наценки одинаково для FBO и FBS. Правило: «Дополнительные наценки» — применяется ко всем товарам, не зависимо от метода продаж.

v2.4.0
**********
ВНИМАНИЕ! Для обновления до версии 2.4.0 необходимо залить файлы на сервер, обновить модификаторы и пройти по ссылке ниже. Проверить настройки модуля и сохранить их.
Для 2.1:
https://ваш-сайт.ru/index.php?route=module/ozon_seller/update240
Для 2.3-3.0:
https://ваш-сайт.ru/index.php?route=extension/module/ozon_seller/update240
**********
— обновлены старые методы API на новые.
— на странице Наши товары отображается цена в ОС, цена в Ozon, остаток и комиссии для FBS и FBО. Обновление данных происходит при обновлении остатков и цен модулем.
— на вкладке Заказы ОС можно задавать фамилию покупателя по умолчанию. Если поле пустое, то будет подставлен номер заказа.

v2.3.4
— исправил цикличную смену статуса в ОС для возвратных заказов.
— мелкие исправления.

v2.3.3 от 25.05
— исправление в обработке отчета для МС, если заказов в отчете больше 1000.

v2.3.2 от 18.05.2022
— больше не нужно каждый раз сохранять модуль при сопоставлении атрибута магазина с атрибутом Озон для открытия всплывающего окна справочника Озон. Теперь можно сохранится уже после настройки всех атрибутов.
— оптимизирована загрузки всплывающего окна справочника атрибутов Озон.
— исправлен экспорт товаров из всех категорий
— ускорил в несколько раз загрузку админки модуля при большом количестве категорий в магазине.

v2.3.1 от 21.04.2022
— если отключили товар в OC и он есть в таблице Наши товары, то в Озон будет передаваться нулевой остаток.
— добавлены атрибуты «Название цвета» и «Объединить на одной карточке». Чтобы их загрузить нажмите «Заново загрузить атрибуты Озон» на вкладке «Атрибуты».
— Rich-контент обновлен до версии 0.3.

v2.3.0 от 20.03.2022
Порядок обновления: удалите модификатор модуля из списка установленных модификаторов. Загрузите обновление на хостинг и обновите модификаторы. Проверьте настройки модуля и сохраните их.
— добавлена таблица экспорта товара, как в модуле WB.
— если тип товара соответствует атрибутам, то будет выгружен и создан в Озон только тот товар, у которого есть значение этого атрибута.
— изменен расчет комиссии Озон за магистраль и последнюю милю.

v2.2.7 от 30.02.2022 — обнуление фиктивной акции. исправил ошибку при которой заказ мог не создаваться в МС. Мелкие улучшения.

v2.2.6 от 30.01.2022 — на вкладке экспорт добавлена опция использовать главные категории товара или нет.

v2.2.5 от 27.01.2022 — Ozon изменил API в фин.отчете. Исправлена ошибка которая могла возникать при экспорте товара, если у вас нет главных категорий.

v2.2.4 от 21.01.2022 — улучшена работа наценок. Теперь модуль сначала учитывает главную категорию товара в Opencart и если она не указана в товаре, то берет первую в списке на вкладке связи.

v2.2.3 от 10.01.2022 — добавлен статус заказа «Возвращается» на странице заказов.

v2.2.2 от 06.01.2022 — исправил ошибку которая могла возникать при обновлении остатков, если были установлены фильтры по цене. Изменил порядок применения неценок: сначала модуль прибавит к цене товара надбавки, затем магистраль, фикс, последнюю милю и процент.;

v2.2.1 от 23.12.2021 — исправил ошибку которая могла возникать при обновлении остатков, если фактический остаток товара в магазине был отрицательный. добавил ограничение по максимальному количеству передаваемых картинок товара 14шт.

v2.2.0 от 19.12.2021 — добавил на вкладке экспорт возможность указать минимальную стоимость товара для попадания в экспорт. исправил ошибку в обновлении остатков для OC 3.0.

v2.1.1 от 15.12.2021 — озон увеличил длину id новых складов, что стало приводить к ошибке обновление остатков. исправил ошибку в опции Не обновлять остатки у товаров.

v2.1.0 от 13.12.2021 — добавил в склады фильтр по категориям. добавил вкладку цены и дополнительные наценки в зависимости от цены, диапазона цен, id товара, id производителя, id категории. Возможность указать товары которым не нужно обновлять остатки. Разделил обновление остатков и цен на разные ссылки в URL.

v2.0.0 от 15.11.2021 — выгрузка остатков на несколько складов с фильтрацией товаров по производителю, цене, весу, объемному весу, минимальному остатку, а также по черному и белому списку. Возможность обнуления остатков на конкретном складе. Добавлен черный список цен на вкладке — экспорт. У товаров из этого списка не будут выгружаться цены в Ozon. Для МС добавил поле — канал продаж.

v1.9.3 от 03.11.2021 — изменил логику проверки статусов товара.

v1.9.2 от 01.11.2021 — ozon изменил запрос на получение товара. добавлен UPC в настройки атрибутов.

v1.9.1 от 26.10.2021 — улучшение обрабоки возвратов в МС. улучшения в работе со справочником атрибутов Озон.

v1.9.0 от 20.10.2021 — добавлен модификатор, выводящий быстрые ссылки к модулю в боковой панели. На основной вкладке появилась опция позволяющая автоматически подтверждать акт и ттн, а так-же загружать их на ваш сервер для своевременной печати. Исправлена ошибка: не обновлялись остатки, если были отрицательные значения. Исправление при создании заказа в Opencart для rfbs и fbs. На вкладке экспорт появилась опция Создавать товар в Озон, даже если его нет в наличии. Из ссылки цен и остатков убран функционал проверки статусов товара. Теперь статусы товара обновляются на странице Наши товары.

v1.8.1 от 30.09.2021 — исправлена ошибка из v1.8.0 при создания заказов в OC. На вкладке Экспорт добавлена настройка — Округления цены товара в Озоне. На вкладке Заказы OC добавлена настройка — Цена товара в заказе из Опенкарт.

v1.8.0 от 26.09.2021 — на странице Ниши товары появилась кнопка — добавить в таблицу товары из Озон. При нажатии модуль получит все Ваши товары из Озона и если какого-то нет в таблице, то он добавит их, как будто вы выгрузили их через модуль.
Добавлено получение заказов rFBS и создание их в Opencart.

v1.7.0 от 20.09.2021 — обновление остатков до версии API 2.0. Теперь на вкладке экспорт необходимо указать склад на который будут выгружаться остатки. Теперь можно удалить из таблицы экспорта все товары с определенным статусом и таким образом перевыгрузить их в Озон. Подправил НДС. Имя модуля CDL Ozon Seller.

v1.6.0 от 12.09.2021 — добавлена настройка НДС, фиктивная акция, черный список товаров. Добавлен обязательный атрибут Название модели. Во вкладке атрибуты нужно нажать красную кнопку внизу списка атрибутов и настроить значние этого атрибута. Примите во внимание, что в некоторых категориях, Озон добавляет к названию товара значение этого атрибута.

v1.5.1 от 10.09.2021 — исправлено дублирование атрибутов при выгрузке товаров в Озон, если в Opencart несколько языков.

v1.5.0 от 09.09.2021 — можно создавать заказы в Opencart. Другие изменения по просьбам пользователей.

v1.4.0 от 07.09.2021 — изменения в выгрузке главного фото товара в соответствии с новыми инструкциями Озон.

v1.3.1 от 05.09.2021 — добавлена возможность присвоить атрибутам Озон поля OpenCart (артикул и модель). Убрана возможность создавать FBS заказы в МС за минусом комиссии Озон.

v1.3.0 от 29.08.2021 — автоматизация возвратов FBS и FBO. Автоматически будет создан возврат в МС, когда вы заберете его из Озона или Озон примет его на свой склад FBO. Если была оплата — будет создан исходящий платеж. В описание возврата будет вставлен его нижний штрих-код и причина возврата. Добавлено округление копеек до рубля в озон при их обновлении. Округление копеек в заказе МС до сотых. Другие исправления по обращениям от пользователей модуля. Обновление метода получения атрибутов до новой версии API.
После обновления, у Вас пропадут ранее заполненные сопоставления характеристик в справочниках у которых было выбрано более двух значений. Необходимо проверить справочники и дополнить их.

v1.2.0 от 09.08.2021 — поиск значений атрибутов с автодополнением. Можно выбирать несколько значений атрибутов. Поправил создание заказов для 3.0.

v1.1.1 от 05.08.2021 — теперь для модуля значение атрибута с разным регистром равны (черный = Черный).

v1.1.0 от 04.08.2021 — для перехода на эту версию необходимо выполнить ряд действий (см.сообщение в теме модуля). Исправлено отображение обязательности атрибутов. Теперь фильтр атрибутов с выпадающим списком категорий. Исправлено создание заказов из Озон, если не работаете с МС. Добавлена возможность обновлять атрибуты с Озона.

v1.0.0 от 03.08.2021 — управление заказами Озон из Opencart (просмотр, сборка, печать этикетки). Заказы в самом Opencart не создаются. Исправлена ошибка c выгрузкой главного фото товара, если есть дополнительные.

v0.9.6 от 29.07.2021 — добавлена версия для 3.0. Исправлена ошибка image_absent при импорте товара.

v0.9.5 от 28.07.2021 — выбор привязки товара в Мой склад и Opencart на вкладке Мой склад. Изменения в загрузке списка производителей. Теперь нужно выбрать категорию для которой загружаете список производителей.

v0.9.4 от 24.07.2021 — исправлена ошибка при загрузке атрибутов на php 5.6. Добавлен выбор привязки по артикулу или коду товара на главной вкладке. Другие улучшения в коде.

v0.9.3 от 20.07.2021 — не большие улучшения в аннотациях и загрузке товара в Ozon

v0.9.2 от 08.07.2021 — исправления в алгоритме создания заказов в МС.

v0.9.1 от 06.07.2021 — добавлена выгрузка заказов FBO в МС. Создаются только выполненные заказы. Можно вычитать комиссию озон на продажу, доставку, последнюю милю для каждого товара.

Вкладка «URL»

Переходя по ссылке запускается процесс модуля соответствующий названию.

Обновление остатков — передаются текущие остатки из Opencart в Ozon. Информация на маркетплейсе подгружается не сразу.

Обновление цен — будут обновлены цены в Ozon. Информация на маркетплейсе подгружается не сразу.

Цены и остатки обновляются только у товаров в статусе processed из таблицы модуля «Наши товары»

Загрузка/обновление заказов FBS — получение новых заказов из Ozon обновление ранее созданных, кроме выполненных.

Загрузка выполненных заказов FBO — получение только выполненных заказов по модели FBO.

Обновление доставленных заказов — проверка доставляемых заказов и перевод их в завершающий статус.

Данные ссылки не являются фидом и их не нужно указывать в ЛК Ozon.

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

Пример задания: wget -O /dev/null -t 1 -q 'https://ссылка'

Рекомендации:

  • Цены, остатки — 30 минут
  • Загрузка/обновление заказов FBS — 10 минут
  • Загрузка выполненных заказов FBO — 1 раз в день
  • Обновление доставленных заказов — 1 раз в день

Вкладка «Заказы FBO» в интеграции Ozon c Opencart

Модуль позволяет загружать выполненные заказы по модели FBO.

Для их получения используется отдельная ссылка на вкладке URL.

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

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

ID cклада FBO в МС — заполняйте, если используете интеграцию с МС. У Вас может быть отдельный склад в МС для FBO товаров, куда Вы их перемещаете после поставки на склад Ozon. Укажите ID склада МС.

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

Обработка возврата — автоматически создавать возврат из отгрузки после того, как склад FBO его примет. Так же будет создан исходящий платеж при наличии оплаты в МС. Статус заказа в МС будет изменен согласно настройке — «Статус полученного возврата», на вкладке «Заказы МС». Если Вы не используете МС, то модуль просто изменит статус заказа на Отменено в списке заказов Озон.

Вкладка «Заказы МС»

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

  • выгружать заказы 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 его примет, то модуль автоматически создаст возврат из отгрузки и исходящий платеж, если был входящий.

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