Экспорты: создание и настройка проекций XML-экспорта

Для чего используется раздел «Экспорты»

B2BLIX хранит обработанные данные о товарах от подключенных поставщиков в единой базе каталога. Раздел «Экспорты» позволяет создавать независимые представления этого каталога для разных направлений.

Например, можно создать:

• Экспорт для веб-сайта с отдельными наценками для сайта.
• Отдельный экспорт для маркетплейса с другими правилами учета остатков и цен.
• Экспорт только электроники для платформы сравнения цен.
• Еще один экспорт только с товарами категории «Мода» и другой структурой XML.

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

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

Как обрабатываются данные экспорта

Конфигурация экспорта выполняется в следующей общей последовательности:

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

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

Что можно делать в разделе «Экспорты»

• Создавать несколько XML-экспортов из одной базы товаров.
• Выбирать поставщиков, участвующих в каждом экспорте.
• Задавать стандартные наценки для отдельных поставщиков.
• Выбирать способ определения содержимого, если один и тот же EAN доступен у нескольких поставщиков.
• Фильтровать включаемые товары.
• Включать правила преобразования данных и задавать их приоритет.
• Добавлять рекламные скидки для выбранных товаров.
• Определять поля и структуру XML-файла.
• Просматривать публичный URL экспорта.
• Запускать синхронизацию экспорта вручную.
• Просматривать сведения о последнем отчете в списке экспортов.

Создание нового экспорта

Откройте раздел Экспорты и выберите Добавить новый экспорт. Заполните общие настройки, выберите нужных поставщиков и нажмите Создать.

Поля начального экспорта

Поле или элемент управления	Что означает	Что проверить
Название	Понятное название экспорта.	Используйте название, связанное с назначением, например «Веб-сайт», «Marketplace LT» или «Лента электроники для сравнения цен».
Формат	Формат выходного файла.	В текущих экспортах используется XML.
Частота	Как часто B2BLIX объединяет последние доступные данные каталога и формирует этот экспорт.	Доступные интервалы экспорта могут включать 30 минут, 1 час, 2 часа и 3 часа. Это расписание не зависит от расписаний синхронизации поставщиков.
Выбор содержимого	Выбирает поставщика, из которого берется содержимое товара, если один и тот же EAN предоставляют несколько поставщиков.	Выберите способ, соответствующий требованиям к содержимому.
Флажок поставщика	Включает или исключает поставщика из этой проекции экспорта.	Убедитесь, что выбраны только нужные поставщики.
Стандартная наценка	Множитель, применяемый к исходной цене поставщика.	Например, цена 100 EUR при наценке 1.2 становится равной 120 EUR.
Создать	Создает проекцию экспорта с введенными настройками.	После создания продолжите настройку фильтра, преобразований, скидок и шаблона.

Варианты выбора содержимого

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

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

Стандартные наценки

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

Более точные наценки для категорий или отдельных товаров можно настроить после завершения базовой настройки экспорта.

Предупреждение о ценах: Наценка является множителем, а не процентом, введенным целым числом. Например, используйте 1.2, чтобы изменить 100 EUR на 120 EUR. Неверное значение может значительно изменить все цены этого поставщика.

Список экспортов

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

Столбец или действие	Назначение
Название	Понятное название экспорта.
Формат	Выбранный формат вывода, в настоящее время XML.
Частота	Интервал автоматического формирования экспорта.
Поставщики	Количество поставщиков, выбранных для экспорта.
Изменить	Повторно открывает общие настройки экспорта. На этой странице также доступны публичный XML-URL и действие ручной синхронизации.
Изменить фильтр	Определяет, какие товары могут попасть в экспорт.
Преобразования	Выбирает правила преобразования, используемые этим экспортом, и задает их приоритет.
Скидки	Применяет скидки на основе коэффициента к указанным кодам EAN.
Изменить шаблон	Определяет путь XML, названия выходных атрибутов и сопоставленные значения.
Последний отчет	Показывает последние доступные сведения об отчете для экспорта.

Публичный URL и ручная синхронизация

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

Синхронизацию также можно запустить вручную из настроек экспорта. Это удобно после завершения или изменения конфигурации и перед передачей URL другой системе.

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

Настройка фильтра экспорта

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

Поля фильтра

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

• EAN и SKU.
• Название и описание.
• Цена и остаток.
• Изображения.
• Категория и ID категории.
• Производитель или бренд.
• Вес, размеры и цвет.
• Название поставщика.

Операторы фильтра

Оператор	Значение
Равно (=)	Поле должно точно соответствовать введенному значению. При сравнении текста регистр букв не учитывается.
Не равно (!=)	Поле не должно соответствовать введенному значению. При сравнении текста регистр букв не учитывается.
Содержит	Введенный текст должен встречаться внутри поля. При сравнении текста регистр букв не учитывается.
Не содержит	Введенный текст не должен встречаться внутри поля.
В списке	Поле должно соответствовать одному из значений списка. Разделяйте значения списка точками с запятой, например 1;2;3.
Не в списке	Поле не должно соответствовать ни одному значению списка, разделенного точками с запятой.
Пусто	Поле не должно содержать значения.
Не пусто	Поле должно содержать значение.
Больше (>)	Числовое поле должно быть больше введенного значения.
Больше или равно (>=)	Числовое поле должно быть равно введенному значению или больше него.
Меньше (<)	Числовое поле должно быть меньше введенного значения.
Меньше или равно (<=)	Числовое поле должно быть равно введенному значению или меньше него.

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

Понимание операторов AND и OR

AND означает, что все связанные условия должны быть истинными.

Например:

• Категория содержит «Электроника»
• AND Цена больше 10
• AND Остаток больше 0

Товар включается только при выполнении всех трех условий.

OR означает, что истинным может быть хотя бы одно из связанных условий.

Например:

• Производитель равен «Бренд A»
• OR Производитель равен «Бренд B»

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

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

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

Включение всех подходящих товаров

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

Для явного правила, соответствующего товарам с доступным EAN, используйте:

• Поле: EAN
• Оператор: Не пусто

Затем нажмите Обновить.

Выбор правил преобразования и настройка их приоритета

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

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

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

Как несколько совпавших правил могут повлиять на один товар

Предположим, для экспорта включены два правила:

1. Если остаток больше 10, увеличить цену на 10%.
2. Если остаток больше 20, увеличить цену на 20%.

Товар с остатком больше 20 соответствует обоим условиям.

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

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

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

Пользовательские атрибуты преобразования

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

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

Настройка скидок на товары

Раздел «Скидки» применяет коэффициент к выбранным значениям товаров на основе списка кодов EAN. Он предназначен для отдельных рекламных групп товаров после выполнения предыдущих расчетов и преобразований экспорта.

Поле или элемент управления	Что означает
Значение скидки	Множитель или коэффициент, применяемый к выбранному значению. Например, 0.8 изменяет цену до 80% от рассчитанного значения, что соответствует снижению на 20%.
Список кодов EAN	Товары, к которым применяется эта скидка. Вводите по одному EAN в каждой строке.
Применить к следующим столбцам	Выбирает значение, на которое влияет коэффициент. В представленном интерфейсе доступен переключатель для цены.
Добавить правило	Добавляет еще одну группу скидки со своим коэффициентом и списком EAN.
Удалить	Удаляет эту группу скидки.
Обновить	Сохраняет конфигурацию скидок.

Например, можно создать одно правило со значением 0.9 для товаров со скидкой 10% и другое правило со значением 0.7 для другой группы товаров со скидкой 30%.

Предупреждение о скидках: Значение 0.8 не означает скидку 80%. Оно означает, что сохраняется 80% рассчитанного значения. Перед сохранением проверьте коэффициент и каждый вставленный EAN.

Определение шаблона экспорта

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

Поле или элемент управления	Что означает	Пример
Путь	Определяет расположение каждого товара в иерархии XML.	items > item или root > products > product
Название атрибута	Название поля или элемента, которое появляется в экспортируемом XML.	ean, price, stock, title
Динамическое значение	Известный системе атрибут или пользовательский атрибут преобразования, используемый для заполнения выходного поля.	EAN, Price, Stock, Title, price_for_website
Значение по умолчанию	Необязательное резервное значение, используемое, если выбранное динамическое значение отсутствует или пусто.	Фиксированное резервное значение, требуемое местом назначения
Добавить атрибут	Добавляет еще одно выходное поле в запись товара XML.	Добавьте производителя, категорию, описание или другое поддерживаемое значение.
Элемент удаления	Удаляет строку атрибута из шаблона.	Удалите поле, которое не требуется месту назначения.
Обновить	Сохраняет XML-шаблон.	Используйте после проверки полного сопоставления.

Названия атрибутов и динамические значения — это разные элементы

Название атрибута — это то, что принимающая система видит в XML. Динамическое значение — это источник данных в B2BLIX.

Например:

Название атрибута XML	Сопоставленное динамическое значение
ean	EAN
price	Price
stock	Stock
title	Title
price_for_website	price_for_website, созданный правилом преобразования

Выходное название не обязано совпадать с внутренним названием атрибута. Оно должно соответствовать структуре, которую ожидает система, считывающая XML.

Значения по умолчанию

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

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

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

Проверка созданного XML-файла

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

В примере каждый товар содержит поля:

• EAN.
• Цена.
• Остаток.
• Название.
• Пользовательское значение price_for_website.

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

Рекомендуемый безопасный порядок работы

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

Распространенные ошибки

• Выбор неправильных поставщиков: в экспорт могут попасть товары ненужного поставщика, а требуемые товары могут отсутствовать.
• Ввод процента вместо множителя: наценка 1.2 означает увеличение на 20%. Скидка 0.8 сохраняет 80% значения.
• Путаница между выбором цены и выбором содержимого: выбор содержимого определяет источник данных о товаре, если доступны дубликаты EAN.
• Слишком широкий фильтр: в итоговый файл могут попасть товары, не предназначенные для места назначения.
• Слишком строгий фильтр: одно неверное условие AND может исключить все товары группы.
• Использование запятых с операторами «В списке» или «Не в списке»: несколько значений необходимо разделять точками с запятой.
• Использование числовых операторов для текстовых полей: нечисловые значения считаются равными нулю.
• Последовательное применение нескольких правил изменения цены: несколько совпавших преобразований могут привести к большему изменению цены, чем ожидалось.
• Неверный приоритет правил: более поздний расчет может получить значение, уже измененное предыдущим правилом.
• Отсутствие настройки «Остановить при совпадении»: последующие правила все еще могут повлиять на товар после совпадения с предыдущим правилом.
• Ожидание неактивного пользовательского атрибута в шаблоне: сначала необходимо включить создающее его преобразование для экспорта.
• Вставка списка EAN для скидки в неверном формате: вводите по одному EAN в каждой строке.
• Использование небезопасных значений по умолчанию: фиксированные значения остатка или цены могут скрыть отсутствие исходных данных.
• Изменение шаблона без проверки требований места назначения: корректные значения товаров все равно могут быть отклонены при неверной структуре XML.
• Отсутствие повторного формирования экспорта: если результат нужно проверить сразу, запустите синхронизацию вручную.

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

У продавца есть несколько подключенных поставщиков, и он хочет подготовить XML-ленту для веб-сайта.

1. Создайте новый экспорт с названием На веб-сайт.
2. Выберите XML и частоту формирования 1H.
3. Выберите нужный способ определения содержимого.
4. Выберите поставщиков, товары которых могут отображаться на веб-сайте.
5. Установите стандартную наценку 1.2 для выбранных поставщиков, если требуется наценка 20%.
6. Создайте фильтр экспорта. Для всех товаров с корректным идентификатором используйте условие EAN не пусто. Добавьте условия по категории или остатку, если веб-сайт должен получать только меньшую группу товаров.
7. Включите необходимые правила преобразования цен, остатков и содержимого. Расставьте их приоритеты и решите, где требуется параметр Остановить при совпадении.
8. Если выбранные товары участвуют в акции, добавьте их коды EAN в правило скидки с нужным коэффициентом.
9. Настройте XML-шаблон с такими полями, как ean, price, stock, title и пользовательский атрибут price_for_website.
10. Сохраните шаблон, запустите синхронизацию вручную и проверьте несколько записей о товарах по публичному XML-URL.

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