Как изменить URL поставщика или структуру фида без нарушения экспорта
Узнайте, как заменить URL поставщика или перейти на изменённую структуру XML или JSON, снизив риск пропажи товаров, некорректных значений и неполных экспортов.
Описание: В этом руководстве объясняется, почему существующие сопоставления могут перестать работать после изменения источника поставщика, что проверить перед включением синхронизации и как проверить затронутые экспорты.
Когда следует использовать это руководство
Используйте это руководство, если поставщик предоставил новый 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, цены и остатка. Проверьте всё сопоставленное содержимое и коммерческие поля.
- Проверьте каждое сопоставление вторичного источника. Сделайте это, если поставщик использует отдельный источник обновлений, остатков, цен или содержимого.
- Проверьте связь между основным и вторичным источниками. Убедитесь, что выбранные идентификаторы по-прежнему связывают правильные записи и что два источника по-прежнему имеют достаточное пересечение товаров.
- Проверьте предварительный просмотр сопоставлений. Убедитесь, что отображаемые примеры значений являются реальными значениями товаров и получены из ожидаемых полей.
- Включайте поставщика только после завершения настройки. Дождитесь синхронизации поставщика по настроенному расписанию, а затем выполните описанные ниже проверки товаров и экспортов.
Чтобы изменить источник и проверить его сопоставления, откройте Поставщики. Объяснение процесса настройки поставщика и сопоставления доступно в руководстве Добавление и настройка фида поставщика.
Сопоставления, которые необходимо проверить
Миграция структуры поставщика должна включать полную проверку сопоставлений. Поле, в котором по-прежнему отображается значение, не обязательно сопоставлено с правильным новым местом.
Основной источник
Проверьте все поля, используемые из основного источника поставщика, включая соответствующие идентификаторы, цены, остатки, содержимое товаров, изображения, категории, производителей, размеры и другие сопоставленные атрибуты.
Вторичный источник
Если настроен вторичный источник, отдельно проверьте его путь к товарам и сопоставления. Поставщик может изменить основной каталог, оставив фид обновлений без изменений, или изменить оба источника одновременно.
Связь между источниками
Если основной и вторичный источники связаны, проверьте идентификаторы, используемые для сопоставления их записей. Правильные сопоставления основного и вторичного источников не помогут, если связь между ними больше не соответствует одним и тем же товарам.
Интерпретация финансовых данных и содержимого
Изменение структуры не означает автоматически, что финансовые настройки поставщика необходимо менять. Однако перед тем как оставить эти настройки без изменений, убедитесь, что новый источник по-прежнему использует ту же валюту, обработку НДС, язык содержимого, единицы измерения веса и правила обозначения остатков.
Поиск экспортов, зависящих от поставщика
Проекция экспорта может использовать только выбранных поставщиков из полного каталога B2BLIX. Поставщик напрямую влияет на экспорт, если выбран в настройках поставщиков этого экспорта.
Откройте каждый экспорт, который может использовать этого поставщика, и проверьте флажки выбора поставщиков. Не нужно проверять несвязанные экспорты, в которых поставщик не выбран.
Чтобы проверить это в своей учётной записи, откройте Экспорты. Чтобы разобраться в настройках экспорта, прочитайте руководство Создание и настройка XML-проекций экспорта.
Важно: Отключение поставщика не следует рассматривать как доказательство того, что все ранее сохранённые товары немедленно исчезли из каждого экспорта. Ранее собранные данные каталога могут оставаться доступными в соответствии с настройками актуальности и хранения данных учётной записи. Всегда проверяйте фактический результат экспорта.
Сравнение товаров до и после изменения
После синхронизации поставщика из нового источника найдите EAN, записанные до миграции. Сравнивайте сопоставленные данные, а не только наличие товара.
| Проверка | Что подтвердить |
|---|---|
| EAN | Ожидаемый идентификатор присутствует, действителен и сопоставлен из правильного поля. |
| Цена | Значение присутствует и по-прежнему использует ожидаемую валюту и интерпретацию НДС. |
| Остаток | Количество или значение доступности соответствует новым правилам обозначения остатков у поставщика. |
| Название и описание | Содержимое получено из предусмотренных языковых и исходных полей. |
| Категория и производитель | Исходные значения присутствуют и по-прежнему поддерживают ожидаемые связи и фильтры. |
| Вторичные данные | Основная и вторичная записи связаны с одним и тем же товаром. |
| Экспортируемый XML | Товар присутствует в ожидаемом экспорте с правильными итоговыми значениями. |
Чтобы проверить недавно импортированные данные каталога, откройте Все товары. Подробнее о доступной информации о товарах читайте в руководстве Интерфейс «Все товары».
Проверка зависимых экспортов
Поиск товара в сохранённом каталоге — это только первая проверка. Экспорт всё ещё может исключить его, выбрать другого поставщика, применить преобразование или сформировать другое итоговое значение.
Для каждого экспорта, использующего изменённого поставщика, проверьте несколько образцов EAN в Exports Checker. Просмотрите исходные данные поставщика, выбранного поставщика, сопоставленные атрибуты, результат обработки и итоговые данные XML.
Чтобы проверить это в своей учётной записи, откройте Exports Checker. Чтобы разобраться в отчёте на уровне товара, прочитайте руководство Проверка данных товаров и результатов экспорта с помощью Exports Checker.
Распространённые проблемы после изменения источника
- Товары не импортируются: Полный путь к товарам может указывать на неправильный раздел нового файла.
- Многие товары отсутствуют: Сопоставление EAN может быть пустым, указывать на неправильное поле или получать значения, которые не принимаются как пригодные EAN.
- Цены отсутствуют или некорректны: Расположение поля цены либо интерпретация валюты и НДС у поставщика могут больше не соответствовать новому источнику.
- Остаток становится равным нулю или товар недоступен: Поле остатка или значение его показателей могли измениться.
- Содержимое отсутствует: Сопоставления названия, описания, изображения, категории, производителя или языка могут по-прежнему указывать на старые места.
- Основная и вторичная информация не объединяется: Сопоставление связи может больше не определять один и тот же товар в обоих файлах.
- Товары есть в разделе «Все товары», но нет в экспорте: Экспорт может не включать поставщика, либо на товар могут влиять фильтры и правила обработки этого экспорта.
- В экспорте по-прежнему содержатся старые значения: Синхронизация поставщика и создание экспорта выполняются по независимым расписаниям. Убедитесь, что обе операции успели выполниться с новыми данными.
Пример
Ранее поставщик хранил каждый товар в разделе offer и указывал там его EAN, цену и остаток. Новый источник хранит товары в другом разделе и использует другое расположение поля EAN.
Если заменить только URL, старое сопоставление продолжит искать данные по прежнему пути к товарам. В результате у товаров может отсутствовать сопоставленный EAN, и они могут не попасть в стандартный процесс обработки каталога.
Безопасный подход — отключить поставщика, выбрать новый полный путь к товарам, при необходимости заново сопоставить все поля, проверить связь между основным и вторичным источниками, а затем включить поставщика. После синхронизации найдите несколько ранее записанных EAN и подтвердите их итоговые значения в каждом зависимом экспорте для маркетплейса или веб-сайта.
Что делать дальше
- Оставляйте поставщика отключённым, пока новый источник не станет доступен и полный путь к товарам не будет подтверждён.
- Проверьте все сопоставления основного, вторичного источников и связи между ними.
- Убедитесь, изменились ли финансовые правила и правила работы с содержимым источника.
- Определите зависимые экспорты через настройки выбора поставщиков.
- Включите поставщика и после синхронизации проверьте показательные товары.
- Проверьте те же EAN в Exports Checker для каждого затронутого экспорта.
- Сравните доступность товаров, цены, остатки, содержимое, количество товаров и итоговый XML с контрольными данными, записанными до миграции.
- Продолжайте отслеживать затронутые экспорты после следующих запланированных запусков поставщика и экспорта.
Если образцы товаров и их количество значительно отличаются, снова отключите поставщика и проверьте путь к источнику и сопоставления, прежде чем разрешать изменённым данным поступать в рабочие экспорты.
