Как изменить URL или структуру фида поставщика, не нарушив экспорты

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

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

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

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

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

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

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

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

Почему старое сопоставление может стать недействительным

B2BLIX считывает информацию о товарах из определённых мест в структуре XML- или JSON-фида поставщика. При настройке поставщика эти места связываются со стандартными полями B2BLIX.

Например, старый источник может хранить идентификатор товара в поле EAN. В новом источнике это поле может называться barcode или находиться в другом разделе товара. Старое сопоставление продолжит искать значение в прежнем месте и поэтому может получить пустое значение.

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

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

Подготовка перед изменением поставщика

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

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

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

Безопасное изменение источника поставщика

Отключите поставщика. Это снижает риск синхронизации частично настроенного источника во время изменения путей и сопоставлений.
Замените URL источника или конфигурацию источника. Проверьте соответствующие настройки аутентификации и запросов, но не публикуйте и не передавайте другим частные URL поставщика, учётные данные или заголовки.
Проверьте полный путь к товарам. Убедитесь, что B2BLIX считывает повторяющийся элемент, представляющий один полный товар.
Проверьте все сопоставления основного источника. Не ограничивайтесь проверкой EAN, цены и остатка. Просмотрите весь сопоставленный контент и коммерческие поля.
Проверьте все сопоставления дополнительного источника. Это необходимо, если поставщик использует отдельный источник обновлений, остатков, цен или контента.
Проверьте подключение основного источника к дополнительному. Убедитесь, что выбранные идентификаторы по-прежнему связывают правильные записи и что в двух источниках сохраняется разумное пересечение товаров.
Проверьте предварительный просмотр сопоставлений. Убедитесь, что отображаемые примеры значений являются реальными значениями товаров и получены из ожидаемых полей.
Включайте поставщика только после завершения настройки. Разрешите поставщику синхронизироваться согласно настроенному расписанию, а затем начните проверки товаров и экспортов, описанные ниже.

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

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

Сопоставления, которые необходимо проверить

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

Основной источник

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

Дополнительный источник

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

Подключение источников

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

Интерпретация финансовых данных и контента

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

Поиск экспортов, зависящих от поставщика

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

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

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

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

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

Сравнение товаров до и после изменения

После синхронизации поставщика из нового источника найдите EAN, записанные до миграции. Сравнивайте сопоставленные данные, а не только наличие товара.

Проверка	Что нужно подтвердить
EAN	Ожидаемый идентификатор присутствует, действителен и сопоставлен с правильным полем.
Цена	Значение присутствует и по-прежнему использует ожидаемую валюту и трактовку НДС.
Остаток	Количество или значение доступности соответствует новым правилам обозначения остатков у поставщика.
Название и описание	Контент получен из предусмотренных языковых и исходных полей.
Категория и производитель	Исходные значения присутствуют и по-прежнему поддерживают ожидаемые связи и фильтры.
Дополнительные данные	Основная и дополнительная записи связаны с одним и тем же товаром.
Экспортированный XML	Товар присутствует в ожидаемом экспорте с правильными итоговыми значениями.

Чтобы проверить вновь импортированные данные каталога, откройте Все товары. Подробнее о доступной информации о товарах см. в руководстве Интерфейс всех товаров.

Проверка зависимых экспортов

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

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

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

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

Товары не импортируются: Полный путь к товарам может указывать не на тот раздел нового файла.
Многие товары отсутствуют: Сопоставление EAN может быть пустым, указывать не на то поле или получать значения, которые не принимаются как пригодные EAN.
Цены отсутствуют или указаны неверно: Расположение поля цены либо трактовка валюты и НДС у поставщика могут больше не соответствовать новому источнику.
Остаток становится нулевым или товар недоступен: Поле остатков или значение его показателей могло измениться.
Контент отсутствует: Сопоставления названия, описания, изображения, категории, производителя или языка могут по-прежнему указывать на старые места.
Основная и дополнительная информация не объединяется: Сопоставление подключения может больше не определять один и тот же товар в обоих файлах.
Товары есть в разделе «Все товары», но нет в экспорте: Экспорт может не включать поставщика, или на товар могут влиять фильтры и правила обработки этого экспорта.
В экспорте по-прежнему содержатся старые значения: Синхронизация поставщика и создание экспорта выполняются по независимым расписаниям. Убедитесь, что обе операции успели выполниться с новыми данными.

Пример

Раньше поставщик хранил каждый товар в разделе offer и указывал там его EAN, цену и остаток. В новом источнике товары хранятся в другом разделе, а EAN находится в другом поле.

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

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

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

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

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