Настройка профиля выгрузки товаров на площадку Ozon.Ru

Рабочий формат в модуле сейчас — Ozon (API) (в коде — API 2024). Отдельного формата «Ozon.Ru API остатки» больше нет: остатки и цены включаются режимом в том же плагине.

Остаток «не как в кабинете» разбирайте по статье Остатки Ozon не как на сайте — превью не равно отправке, updated смотрят в логе.

Актуальный сценарий (Ozon API)

1. Ключи

Создайте профиль, плагин Ozon.Ru, формат Ozon (API).
Client ID и API Key: кабинет продавца.
Кнопка «Проверить доступ» на вкладке общих настроек. Сохраните профиль.

2. Категории и атрибуты

Выбор категорий Ozon обязателен. После сопоставления разделов сайта нажмите «Применить», затем загрузите атрибуты категорий (процесс длинный).
Для каждой выбранной категории заполните обязательные атрибуты (они появляются внизу списка полей). Без этого выгрузка карточки невозможна.
То, что в модуле называется категорией, на Ozon — связка «категория + тип».

3. Два (или три) профиля, один offer_id

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

Поле offer_id во всех профилях одного кабинета должно совпадать. Остатки принимаются, когда статус товара на Ozon — processed.

Если в кабинете есть склады FBS/Express — галка «Выгружать остатки по складам», «Добавить все склады», для каждого склада своё поле stock_…. Общий stock при складах модуль не отправляет.

4. Лог и отладка

Вкладка «Лог и история». Отладка включается в профиле («Режим отладки для данного профиля»), затем «Применить» и один прогон.
Глобальная отладка в настройках модуля для этого формата не нужна и мешает логам других профилей.

Список задач внизу вкладки при режиме «только остатки» может быть пустым — это норма. Задача Ozon создаётся при выгрузке карточки.

Вкладка «Диагностика» в профиле: карточка, остатки FBS по складам, лимиты, запись одной позиции — без полного прогона.

5. Учитель и описание формата

В профиле есть краткий урок по Ozon и длинный текст на вкладке формата (методы API, статусы, нюансы). Меню «Справка» пока ещё может вести на эту же страницу.

Исторический сценарий (сохраняем как было)

Ниже — прежний текст статьи. Он описывает форматы «Ozon.Ru API» / «Ozon.Ru API остатки», загрузку свойств для OZON.RU API v2, тестовый get_categories.php на классе OzonRuGeneral и глобальный «Режим отладки» в настройках модуля. Это не удаляем: на старых профилях и старых версиях модуля шаги ещё встречаются.

Создание профиля (как в прежней статье)

Создаём новый профиль, выбираем плагин «Ozon.Ru» и формат «Ozon.Ru API».

Есть 2 формата:

• Первый отвечает за первоначальное создание товара в Ozon.Ru и обновление его описания и характеристик.
• Второй «Ozon.Ru API остатки» отвечает за обновление цен и остатков.

Вводим Client Id и API key из настроек личного кабинета Ozon.Ru. Посмотреть их можно на странице https://seller.ozon.ru/settings/api-keys

Настройка выгрузки инфоблоков

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

Внимание! Есть вариант сопоставления разделов через свойство элемента инфоблока (читайте пункт «Указание раздела Ozon.Ru через свойство товара»).

Внимание! Эти действия проводятся после заполнения Client Id и API key на первой вкладке (Общие настройки).

В открытом окне нужно сопоставить категории нижнего уровня (в которых есть товары), те, которые вы планируете выгружать на площадку.

Важно! Далее, если вы используете профиль «OZON.RU API v2», необходимо запустить загрузку свойств на вкладке «Поля разделов Ozon» (действия только для профиля v2). Если в процессе эксплуатации профиля вы сопоставите новый раздел, вам необходимо снова запустить загрузку свойств на вкладке «Поля разделов Ozon».

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

Важно! Не все поля являются множественными. Узнать это вы можете в подсказке «?».

В жёлтых треугольниках отображаются возможные варианты; значение, которое подставляется, должно быть одним из вариантов. Если варианты «mm (миллиметры), cm (сантиметры), in (дюймы)», то должно подставиться «mm» или «cm». Не «см»!

Применить изменения.

Первоочередная синхронизация товаров с ozon.ru

Если у вас уже есть товары на Озоне, вы можете сопоставить товары площадки с товарами сайта. Если таковых не имеется, можно перейти к следующему шагу. Для сопоставления значение поля «Идентификатор offer_id» должно быть равно полю «Артикул» на площадке.

Запуск выгрузки

После выгрузки во вкладке «Лог и история» можно узнать об ошибках выгрузки.

Обновление статуса выгрузки товаров

Через несколько минут можно узнать статус выгрузки товаров. Вкладка «Статус импорта товаров».

Обновление остатков и цен

Для обновления цен и остатков товаров необходимо создать новый профиль. Первый профиль установит цену только первоначально. Далее заполняются поля на вкладке «Настройки инфоблоков».

Важно! Поле «Идентификатор offer_id» должно быть аналогичным значению первого профиля.

Важно! Задать наличие товару возможно только после того, как статус товара сменился на «processed» (Обработан)!

Указание раздела Ozon.Ru через свойство товара

Если структура разделов сайта не позволяет сопоставить их с разделами Ozon.Ru, есть возможность указания раздела через свойство товара.

Создаём свойство элемента инфоблока типа «список», например с кодом OZON_SECTION. В значения списка заносим разделы Ozon.Ru, необходимые для ваших товаров.

Откуда взять названия разделов? Можно создать тестовый php-файл, например get_categories.php, в нём разместить код и заменить значение переменной $intProfileID под ваш профиль:

require($_SERVER["DOCUMENT_ROOT"] . "/bitrix/modules/main/include/prolog_before.php");
\Bitrix\Main\Loader::includeModule('acrit.exportproplus');
$strModuleId = 'acrit.exportproplus';
$intProfileID = 1; // ID профиля, в котором прописаны ключи доступа к ozon.ru

\Acrit\Core\Export\Exporter::getInstance($strModuleId)->findPlugins();
$ob = new \Acrit\Core\Export\Plugins\OzonRuGeneral($strModuleId);
$result = $ob->getCategoriesList($intProfileID);
print_r($result);

Для лучшей читабельности print_r можно обернуть в html-тег pre.

В настройках профиля выгрузки, вкладка «Общие настройки», устанавливаем галку «Название раздела из свойства товара». В настройках инфоблоков для поля раздела указываем созданное свойство. После «применения» профиля появятся поля, необходимые к заполнению (указанных вами разделов Ozon.Ru).

Расширенная отладка выгрузки (глобальная, как было)

Если товары не выгружаются, можно включить режим отладки. Для этого нужно перейти на страницу «настройки» модуля, поставить галку на опции «Режим отладки», сохранить настройки.

При последующей выгрузке в логе вы увидите больше информации (только если будут доступны товары для выгрузки; например фильтром вы можете запретить выгрузку всех товаров).

Блок «error» — это ошибка, которую вернул Ozon. Ниже будет блок items — это товары, которые выгружаются на Озон; необходимо проверить заполненность всех обязательных полей (обязательность смотреть на вкладке настройки инфоблоков, поля помеченные *) и свойств (блок [attributes]).

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

Если в [value] стоит цифровое id, значит значение сайта правильно сопоставилось со значением варианта Озон.

Важно! Для разных разделов допустимые значения Озон могут отличаться.

Поле category_id тоже обязательное; если оно не заполнено, товар не выгрузится.

Для текущего формата API 2024 предпочтительна отладка в профиле, см. актуальный сценарий выше и статью Остатки Ozon не как на сайте.

Назад в раздел