Как передать карточки и остатки внешнего прайса в Ozon

У Ozon две отдельные задачи: передать данные карточек и обновить количество на складе Ozon. Сначала создайте внешний набор в профиле Ozon и проверьте связь профиля с нужным кабинетом продавца.

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

Настроить поля карточки

1. В наборе данных на вкладке «Общее» нажмите «Настроить параметры Ozon».
2. На вкладке «Базовые» заполните шаблоны обязательных полей: Offer ID, название, цену, длину, ширину, высоту, вес и единицы измерения.
3. Настройте изображения и остальные нужные поля.
4. Вставляйте значения из каталога подстановок выбранного прайса.
5. Нажмите «Применить», затем «Сохранить» в основном окне набора.

Offer ID должен быть постоянным и отличать товар в кабинете продавца. Для него можно использовать подстановку стабильного ID строки внешнего прайса. Не подставляйте цену или другое изменяющееся значение.

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

Цена может учитывать коэффициенты набора, если в шаблоне используется подстановка выбранного поля цены.

Настроить характеристики и дополнительные поля

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

На вкладке «Атрибуты» можно задать характеристики для всего набора: выбрать атрибут из каталога Ozon или указать его ID, затем настроить значение. Для справочных атрибутов используйте выбор допустимого значения. Проверьте, что выбранные категория и тип подходят товарам набора.

Приоритет определяет, какое значение использовать при наличии обоих: «Товар, затем датасет» или «Датасет, затем товар». Здесь «датасет» означает текущий набор данных.

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

После настройки нажмите «Применить» и сохраните основной набор.

Проверить карточки без отправки

На вкладке «Общее» доступны:

• «Проверить первые 50» — быстрая проверка части набора;
• «Проверить весь датасет» — проверка всех подходящих строк;
• «Отменить проверку» — остановка текущей проверки.

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

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

Успешная локальная проверка показывает готовность данных к отправке. Результат их обработки на стороне Ozon проверяется после реальной передачи.

Передать одну карточку

1. Сохраните настройки основного набора.
2. На вкладке «Данные» выберите нужную строку.
3. В контекстном меню нажмите «Передать карточку в Ozon».
4. Проверьте подтверждение и подтвердите отправку.
5. Дождитесь результата обработки. Во время операции доступна «Отменить отправку».

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

Описанная команда отправляет одну выбранную карточку. Обновление прайса и отправка карточки — отдельные действия.

Подготовить передачу остатков

Передача остатков не запустится, пока не выполнены три условия — даже если карточки вы не отправляете:

• в параметрах Ozon набора на вкладке «Базовые» задан шаблон Offer ID: по нему остаток связывается с карточкой;
• в настройках API профиля Ozon заполнены «Client ID» и «Api-Key»;
• там же в блоке «Склад и Offer ID» выбран «Склад», на который передаются остатки.

Затем в основном окне набора найдите блок «Остатки Ozon»:

1. Включите «Передавать остатки в Ozon».
2. Заполните «Шаблон количества» подстановкой нужного поля прайса.
3. Если именно количество поставщика должно определять остаток в Ozon, отметьте «Количество прайса является источником истины для Ozon».
4. При необходимости включите «Обнулять строки, исчезнувшие из прайса».
5. Нажмите «Сохранить» в основном окне набора.

Количество должно быть целым неотрицательным числом. Пустое, дробное, отрицательное или нечисловое значение исключает строку из передачи, а не превращает её в ноль.

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

Обнуление исчезнувших позиций

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

Проверить план и передать остатки

1. Убедитесь, что прайс успешно обновлён, а настройки набора сохранены.
2. Нажмите «Показать план без отправки».
3. Проверьте позиции, количества, пропуски и запланированные обнуления.
4. Если результат верен, нажмите «Передать остатки в Ozon».
5. Прочитайте и подтвердите сообщение перед отправкой.
6. Дождитесь результата и проверьте принятые и отклонённые позиции.

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

Для внешнего прайса передача остатков выполняется вручную этими действиями. Расписание обновления самого прайса её не запускает.

Где искать ошибки

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

У остатков проверяйте итог операции: число позиций в плане, обнуления, локальные пропуски, принятые и отклонённые Ozon значения. Если настройка исправлена, сохраните набор перед повторной отправкой.