Как подготовить, протестировать и подключить экспорт для маркетплейса

В этом руководстве описан рекомендуемый рабочий процесс запуска экспорта B2BLIX Feed без замены существующего фида до проверки нового результата.

Когда следует использовать это руководство

Используйте это руководство при подготовке нового экспорта B2BLIX Feed для маркетплейса, интернет-магазина, платформы сравнения цен или другой системы, принимающей данные о товарах в формате XML.

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

Краткий ответ

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

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

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

Как работает процесс экспорта

Сначала B2BLIX импортирует данные поставщиков и сопоставляет их с единым каталогом товаров. Затем экспорт создаёт отдельное представление этого каталога для конкретного назначения.

Каждый экспорт может использовать собственные:

• поставщиков и набор товаров
• фильтры экспорта
• маржу или коэффициенты поставщиков по умолчанию
• правила преобразования данных
• атрибуты, специфичные для назначения
• структуру XML
• расписание формирования

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

Сформированный XML — это результат, подготовленный B2BLIX. Внешняя платформа отдельно определяет, когда загружать файл, как проверять данные и будут ли товары приняты или опубликованы.

1. Убедитесь, что данные поставщиков готовы

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

• Проверьте, что необходимые поставщики включены, а их исходные файлы доступны.
• Проверьте страну поставщика, валюту, обработку НДС, язык контента и единицу измерения веса.
• Убедитесь, что правильные исходные поля сопоставлены с полями EAN, цена, остаток, название и категория.
• Проверьте, что у показательных товаров указаны пригодные для использования значения EAN.
• Проверьте связи категорий, если назначение требует корректных категорий.
• Убедитесь, что первая синхронизация с поставщиком завершена и товары отображаются в каталоге.

Товар без пригодного для использования EAN не попадает в стандартный процесс обработки товаров B2BLIX. Если товары отсутствуют, перед проверкой самого экспорта проверьте сопоставление EAN.

Чтобы проверить настройки поставщиков в аккаунте, откройте Поставщики.
Чтобы разобраться в настройках поставщика и процессе сопоставления, прочитайте руководство Добавление и настройка фида поставщика.

2. Создайте экспорт для конкретного назначения

Создайте отдельный экспорт для маркетплейса или другого назначения. Не изменяйте рабочий производственный экспорт, пока новая конфигурация ещё проходит проверку.

На начальном этапе настройки проверьте:

• название и статус экспорта
• поставщиков, включённых в экспорт
• маржу или коэффициент поставщика по умолчанию
• категории и производителей, которых следует включить
• фильтры товаров
• назначенные правила преобразования
• атрибуты XML и структуру товара, требуемые назначением
• частоту формирования экспорта

Чтобы создать или проверить экспорт, откройте Экспорты.
Чтобы ознакомиться с доступными настройками экспорта, прочитайте руководство Создание и настройка проекций экспорта XML.

3. Добавляйте только правила, необходимые для этого назначения

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

Перед включением правила проверьте:

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

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

Чтобы создать или проверить правила обработки, откройте Правила преобразования данных.
Объяснение условий, преобразований и приоритетов приведено в руководстве Правила преобразования данных.

4. Протестируйте показательные товары

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

В полезную тестовую группу могут входить:

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

Для каждого EAN проверьте исходные данные поставщика, выбранного поставщика, сопоставленные атрибуты, фильтры, расчёты, применённые преобразования, итоговые значения и соответствующий фрагмент XML.

Чтобы протестировать товары в аккаунте, откройте Проверка экспорта.
Подробнее об отчёте на уровне товара читайте в руководстве Проверка экспорта: просмотр данных товара и результатов экспорта.

5. Проверьте весь сформированный XML

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

Проверьте, что:

• XML полностью открывается и не обрывается.
• Документ содержит ожидаемые путь к товарам и структуру.
• Присутствуют обязательные поля назначения.
• Цены и значения остатков имеют ожидаемый формат.
• Файл содержит разумное количество товаров.
• В файле отсутствуют товары, которые следует исключить.
• Включённые товары имеют положительный остаток и корректно заполненные обязательные поля.
• В результате не остались тестовые или временные резервные значения.

Технически корректный XML не гарантирует автоматическое принятие файла каждым маркетплейсом. Имена полей, обязательные значения, правила категорий и структура товаров также должны соответствовать текущим требованиям назначения к импорту.

6. Подключите проверенный экспорт к назначению

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

При замене существующего фида:

1. Сохраните копию предыдущей конфигурации или URL фида.
2. Снова сформируйте новый экспорт B2BLIX.
3. Выполните финальную проверку цен, остатков, количества товаров и обязательных полей.
4. Замените URL фида в аккаунте назначения.
5. Убедитесь, что назначение успешно загружает и обрабатывает файл.
6. После завершения импорта проверьте несколько товаров на стороне назначения.

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

Распространённые причины проблем при запуске

Товар доступен в B2BLIX, но отсутствует в экспорте

Товар мог быть удалён фильтром экспорта, иметь нулевой остаток, не иметь обязательного сопоставленного значения или не соответствовать условию для конкретного назначения. Проверьте EAN товара в разделе «Проверка экспорта».

Товар есть в XML, но отсутствует на маркетплейсе

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

Экспортированная цена отличается от ожидаемой

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

В экспорте меньше товаров, чем ожидалось

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

Назначение не может прочитать фид

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

Пример проверки перед запуском

Предположим, что экспорт для маркетплейса включает трёх поставщиков. Один тестовый товар доступен у двух поставщиков с одинаковым EAN.

• Поставщик A предлагает более низкую исходную цену, но использует больший коэффициент поставщика.
• Поставщик B предлагает более высокую исходную цену, но для него применяется меньшая наценка.
• Активное преобразование добавляет фиксированную сумму к товарам этой категории.

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

Что делать дальше

1. Убедитесь, что сопоставления поставщиков и обязательные значения EAN указаны правильно.
2. Создайте отдельный экспорт для назначения.
3. Начните с простых фильтров и преобразований.
4. Протестируйте показательные EAN в разделе «Проверка экспорта».
5. Проверьте весь сформированный XML.
6. Подключайте URL экспорта только после стабилизации результата.
7. Проверьте первый импорт на стороне назначения и несколько товаров, опубликованных на платформе.
8. Постепенно расширяйте экспорт после того, как разберётесь с первоначальным рабочим процессом.