Начало работы с B2BLIX Feed

Это руководство поможет вам выполнить первую полную настройку B2BLIX Feed: подключить одного поставщика, импортировать его товары, создать XML-экспорт, сгенерировать файл и проверить результат.

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

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

Перед началом работы

Активируйте B2BLIX Feed в своей учётной записи B2BLIX и подготовьте данные, необходимые для доступа к первой ленте поставщика.

Обычно вам понадобятся:

• Рабочий URL-адрес источника XML или JSON.
• Разрешение на загрузку и обработку данных поставщика.
• Учётные данные для аутентификации или заголовки запроса, если они требуются.
• Валюта, используемая в ценах поставщика.
• Подтверждение того, включён ли НДС в выбранные цены.
• Применимая ставка НДС.
• Основной язык контента товаров.
• Единица измерения веса, используемая в источнике.
• Информация о частоте обновления файла поставщиком.

Перед добавлением вручную откройте URL-адрес источника. Убедитесь, что он возвращает ожидаемые данные XML или JSON, а не страницу с ошибкой, страницу входа или посторонний документ.

Храните данные доступа к поставщику в тайне: URL-адреса источников могут содержать идентификаторы клиентов или токены доступа. Не публикуйте URL-адреса поставщиков, пароли, заголовки запросов или созданные закрытые ссылки на экспорт.

1. Добавьте первого поставщика

Откройте Поставщики и нажмите Добавить нового поставщика.

Также можно открыть форму поставщика напрямую: Добавить нового поставщика.

Введите название поставщика

Используйте название, которое останется понятным, когда у вас появится несколько поставщиков. Например, Название поставщика — основной каталог будет полезнее, чем «Лента 1» или «Новый поставщик».

Добавьте основной источник

Основной источник — это главный каталог поставщика. Обычно он содержит полные записи о товарах, включая такие данные, как:

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

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

Определите, нужен ли дополнительный источник

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

• Один источник: Укажите полную ленту в качестве основного источника, а дополнительный источник оставьте пустым.
• Два источника: Используйте полный каталог как основной источник, а файл обновлений цены и наличия — как дополнительный.

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

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

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

2. Настройте интерпретацию данных поставщика в B2BLIX

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

Оставьте поставщика отключённым на время настройки

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

Заполните финансовые настройки

• Страна: Выберите страну поставщика.
• Валюта: Выберите валюту, фактически используемую сопоставленной ценой из источника.
• НДС включён: Укажите, включает ли выбранная цена из источника НДС.
• Ставка НДС: Введите значение в формате, указанном интерфейсом. Например, интерфейс может использовать значение 1.20 для ставки НДС 20%.

Внимательно проверьте цену источника: Файл поставщика может содержать цены без НДС, с НДС, рекомендованные, исходные или со скидкой. Настройки валюты и НДС должны описывать поле, которое вы фактически сопоставите с полем Цена.

Заполните настройки контента

• Язык контента по умолчанию: Выберите язык, используемый в названиях и описаниях.
• Единица веса: Выберите граммы или килограммы в соответствии с данными источника.
• Разрешить товары без категории: Определите, могут ли товары без определённой категории временно оставаться со значением «Без категории».
• Принудительно установить нулевой остаток: Определите, как долго отсутствующий товар может оставаться необнаруженным, прежде чем его остаток будет изменён на ноль.
• Максимальный срок отсутствия: Определите, как долго отсутствующий товар может храниться до удаления.

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

Выберите частоту синхронизации

Выберите ненулевую частоту синхронизации для каждого настроенного источника. Доступные интервалы могут включать каждые 30 минут, каждый час, каждые 2, 3, 6, 12 или 24 часа.

Для простой первой проверки может подойти интервал в один час, если поставщик разрешает ежечасную загрузку. Однако:

• Не выбирайте интервал 30 минут, если поставщик не обновляет файл настолько часто и не разрешает такую частоту загрузки.
• Для большого основного каталога может потребоваться более длительный интервал — например, каждые 6, 12 или 24 часа.
• Небольшой дополнительный источник цен и наличия обычно можно синхронизировать чаще, чем основной каталог.
• Более частая синхронизация не создаёт более новые данные, если поставщик обновляет источник реже.
• Загрузка данных поставщика является операцией, зависящей от использования, поэтому частота может влиять на использование учётной записи.

3. Сопоставьте основной источник поставщика

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

Нажмите Создать сопоставление для основного источника.

Выберите путь к товару

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

Выберите путь, который:

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

Например, если путь catalog/products/product повторяется тысячи раз и каждый соответствующий элемент содержит один полный товар, вероятно, это правильный путь.

Сопоставьте обязательные поля товара

Для полезной первоначальной настройки сопоставьте как минимум:

• EAN
• SKU или идентификатор товара поставщика
• Название
• Цена
• Наличие
• Категория

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

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

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

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

4. Сопоставьте и свяжите дополнительный источник, если он используется

Пропустите этот шаг, если поставщик использует только один источник.

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

• Стабильный идентификатор, используемый для связывания записей источников.
• Цену.
• Наличие.
• Другие значения, которые должен обновлять дополнительный источник.

Затем откройте сопоставление Связь. Выберите соответствующий идентификатор в основном и дополнительном источниках.

Подходящим полем связи может быть:

• EAN.
• SKU поставщика.
• Стабильный идентификатор товара поставщика.

Значения должны совпадать в обоих файлах. Выбор EAN в основном источнике и SKU в дополнительном не сработает, если эти два поля действительно не содержат одинаковое значение.

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

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

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

5. Включите поставщика и запустите первый запланированный импорт

После проверки настроек и выполнения всех отображаемых задач сопоставления:

1. Измените значение Статус на Включён.
2. Убедитесь, что для каждого настроенного источника указана ненулевая частота синхронизации.
3. Нажмите Обновить поставщика.

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

Синхронизация поставщика и создание экспорта не зависят друг от друга. На этом этапе вы ожидаете поступления данных поставщика в сохранённый каталог B2BLIX; экспорт ещё не создан.

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

6. Убедитесь, что товары импортированы

Откройте Все товары.

Отфильтруйте список по новому поставщику или найдите несколько известных EAN. Проверьте:

• Название товара.
• EAN и SKU.
• Цену поставщика.
• Количество товара на складе.
• Категорию.
• Сведения о последнем обнаружении или синхронизации.

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

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

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

Инструкции по странице см. в руководстве Интерфейс «Все товары». Требования к EAN и категориям описаны в руководстве Как работают обязательные поля товаров и сопоставление категорий.

7. Создайте первый XML-экспорт

После подтверждения правильности сохранённых товаров поставщика откройте Экспорты и нажмите Добавить новый экспорт.

Также можно напрямую открыть Добавить новый экспорт.

Заполните общие настройки экспорта

1. Введите понятное Название, желательно основанное на месте назначения.
2. Выберите XML в качестве формата.
3. Выберите ненулевую Частоту.
4. Выберите необходимый способ Выбора контента.
5. Выберите настроенного поставщика.
6. Введите Маржу по умолчанию поставщика.
7. Нажмите Создать.

Выберите частоту экспорта

Частота экспорта определяет, как часто B2BLIX создаёт новый XML-файл на основе последних данных каталога. Доступные интервалы могут включать каждые 30 минут, каждый час, каждые 2 или 3 часа.

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

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

Выберите контент

Если в экспорте используется только один поставщик, выбор контента обычно не влияет на первый результат. Если несколько поставщиков впоследствии будут предоставлять один и тот же EAN:

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

Задайте маржу по умолчанию

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

• 1.0 сохраняет цену без изменений.
• 1.1 добавляет 10%.
• 1.2 добавляет 20%.

Предупреждение о марже: Введите множитель, а не процент целым числом. Значение 20 не означает маржу 20%.

Полное описание интерфейса экспорта см. в руководстве Экспорты: создание и настройка проекций XML-экспорта.

8. Добавьте простой фильтр экспорта

Найдите новый экспорт в списке «Экспорты» и откройте Изменить фильтр.

Фильтр экспорта определяет, какие товары каталога могут попасть в шаблон экспорта и сгенерированный XML.

Для базового первого экспорта создайте следующее условие:

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

Для экспорта цены продажи также можно добавить:

Свяжите условия EAN и цены оператором И, чтобы оба условия должны были выполняться.

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

Подробные сведения о логике И/ИЛИ и исключениях см. в руководстве Как работают фильтры экспорта и исключения товаров.

9. Определите, нужны ли преобразования

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

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

• Создать цену для конкретного места назначения.
• Применить расширенные правила маржи для категорий или товаров.
• Округлять цены.
• Изменять значения наличия.
• Удалять HTML из описаний.
• Переводить названия или описания.
• Создавать новые атрибуты для XML-шаблона.

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

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

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

10. Создайте шаблон XML-экспорта

Вернитесь к списку «Экспорты» и откройте Изменить шаблон.

Шаблон определяет, как выбранные данные о товарах записываются в сгенерированный XML. Он задаёт:

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

Задайте путь к товару

Используйте повторяющийся путь к товару, требуемый местом назначения. Например, простая структура может использовать:

products > product

В такой структуре один элемент product создаётся для каждого товара, прошедшего фильтр экспорта.

Добавьте выходные поля

Простой тестовый шаблон может включать:

Нажмите Добавить атрибут для каждого дополнительного поля и нажмите Обновить, когда шаблон будет готов.

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

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

Полные рекомендации по планированию шаблона см. в руководстве Как преобразовать спецификацию XML места назначения в шаблон экспорта B2BLIX.

11. Создайте первый XML-файл

Вернитесь к списку «Экспорты» и откройте Изменить для своего экспорта.

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

• Выбран правильный поставщик.
• Маржа по умолчанию указана правильно.
• Частота экспорта больше нуля.
• Фильтр и шаблон сохранены.

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

После создания в разделе Изменить отображается общедоступный URL экспорта XML. Этот адрес остаётся связанным с данной проекцией экспорта.

Проверьте:

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

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

12. Проверьте отдельные товары в Exports Checker

Откройте Exports Checker.

1. Введите полный EAN известного товара.
2. Выберите новый экспорт.
3. Нажмите Найти.
4. Подождите примерно одну-две минуты, пока будет подготовлен отчёт.

Проверьте:

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

Проверьте несколько типичных товаров, включая:

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

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

13. Подключите проверенный URL XML к месту назначения

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

Внешнее место назначения определяет:

• Когда оно загружает XML.
• Как оно проверяет поля.
• Какие товары принимает или отклоняет.
• Когда принятая информация становится видимой.

Сам факт создания B2BLIX ожидаемого XML не подтверждает, что место назначения загрузило, приняло или опубликовало его.

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

Краткий путь устранения неполадок

Итоговый контрольный список настройки

• B2BLIX Feed активирован.
• URL-адрес источника поставщика открывается и возвращает ожидаемый XML или JSON.
• Настройки валюты и НДС поставщика правильно описывают сопоставленную цену.
• Язык контента и единица веса указаны правильно.
• Основной путь к товару представляет отдельные полные товары.
• EAN, цена, наличие, название и категория сопоставлены правильно.
• Дополнительный источник и сопоставление связи настроены, если используются два источника.
• Поставщик включён, а для каждого настроенного источника указана ненулевая частота.
• Первая синхронизация поставщика завершена.
• Типичные товары отображаются в разделе «Все товары» и содержат корректные данные.
• В экспорт включён нужный поставщик.
• Маржа по умолчанию введена как множитель.
• Для экспорта задана ненулевая частота создания.
• Фильтр экспорта содержит как минимум необходимое условие EAN.
• На время первой проверки ненужные преобразования и скидки отключены.
• XML-шаблон соответствует требуемой структуре места назначения.
• Ручная синхронизация экспорта завершена.
• Общедоступный URL XML открывается и содержит ожидаемые товары.
• Типичные EAN проверены в Exports Checker.
• XML проверен до подключения к рабочему месту назначения.

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