Как подключить и использовать XML-ленту B2BLIX в Pigu

Когда актуально это руководство

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

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

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

Откройте Настройки синхронизации в своей учётной записи B2BLIX и скопируйте адрес, указанный в разделе Ваш общедоступный URL.

Затем войдите в учётную запись продавца Pigu, откройте раздел Товары, выберите Импорт остатков и цен, добавьте источник импорта HTTPS-ссылка, вставьте URL B2BLIX, при необходимости подтвердите сопоставление полей и сохраните импорт.

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

Важно: Подключение XML-ленты может повлиять на актуальные остатки и цены после того, как Pigu импортирует и примет данные. Перед подключением большого каталога проверьте XML и несколько товаров. Цена, рассчитанная или экспортированная B2BLIX, не обязательно становится актуальной до тех пор, пока Pigu не обработает и не применит её.

Как работает подключение XML

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

1. B2BLIX импортирует последние сведения о товарах из настроенного источника, например Google Sheets или другой поддерживаемой ленты.
2. Сервис оценивает товары с учётом доступных данных маркетплейсов, ваших настроек ценообразования, а также применимых минимальных и максимальных ограничений цены.
3. B2BLIX подготавливает совместимый с Pigu XML-файл, содержащий полученные данные об остатках и ценах.
4. Последняя версия файла остаётся доступной по постоянному общедоступному XML-URL.
5. Pigu считывает файл по этому URL в соответствии со своим процессом импорта.

Формирование XML-файла внутри B2BLIX не уведомляет Pigu автоматически о его существовании. Необходимо добавить общедоступный URL в качестве источника импорта в учётной записи Pigu.

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

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

1. Найдите общедоступный XML-URL

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

Найдите раздел Ваш общедоступный URL и скопируйте полный адрес. Используйте в Pigu именно этот URL. Он должен оставаться неизменным, чтобы Pigu могла продолжать получать новые версии файла.

2. Откройте и проверьте XML

Откройте общедоступный URL в браузере или скачайте файл. Убедитесь, что он успешно загружается и содержит записи о товарах.

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

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

3. Проверьте несколько EAN в проверке товаров

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

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

Как добавить XML-ленту B2BLIX в Pigu

1. Войдите в учётную запись продавца Pigu.
2. Откройте раздел Товары.
3. Откройте меню Импорт в верхней левой части страницы.
4. Выберите Импорт остатков и цен.
5. Выберите Источник импорта. Если этот пункт не отображается сразу, откройте меню с тремя точками и выберите его там.
6. Выберите HTTPS-ссылка в качестве типа источника.
7. Вставьте полный общедоступный XML-URL B2BLIX.
8. Проверьте сопоставление атрибутов XML, если Pigu попросит сопоставить импортированные поля с атрибутами Pigu.
9. Нажмите Подтвердить или сохраните источник импорта.

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

Какие данные включены в XML

Сформированный XML основан на информации о товарах, импортированной в B2BLIX. В зависимости от источника и конфигурации он может содержать такие данные, как:

• EAN или GTIN, используемый для идентификации товара.
• SKU, используемый как внутренний идентификатор товара.
• Остаток или сведения о доступности.
• Цены для отдельных маркетплейсов.
• Рассчитанные цены, если в B2BLIX доступен расчёт цены.
• Дополнительные поддерживаемые поля маркетплейсов, переданные источником импорта.

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

Почему SKU и EAN могут совпадать

Если в источнике нет столбца sku, B2BLIX использует обязательное значение ean в качестве резервного SKU. В такой ситуации совпадение значений SKU и EAN в XML является ожидаемым.

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

Почему может отсутствовать поле для отдельного маркетплейса

XML может содержать только поддерживаемую информацию о товарах, которая доступна в вашем источнике или формируется настроенным процессом B2BLIX.

Например, если отсутствует обязательное поле, такое как collectionhours_*, сначала добавьте соответствующее поле в исходную Google Sheet или ленту данных. Затем запустите следующую синхронизацию или дождитесь её выполнения и проверьте заново сформированный XML.

Распространённые причины, по которым подключение не работает

• URL был сформирован, но не добавлен в Pigu. B2BLIX не может заставить Pigu читать XML, пока URL не будет настроен как источник импорта Pigu.
• Выбран неправильный тип импорта Pigu. Используйте процесс импорта остатков и цен, а не рассматривайте ленту B2BLIX как полную ленту каталога товаров.
• Сопоставление полей XML не было завершено. Если Pigu запрашивает сопоставление атрибутов, проверьте и подтвердите его перед сохранением источника.
• Общедоступный URL скопирован неправильно. Откройте вставленный URL отдельно и убедитесь, что он загружает ожидаемый XML.
• В исходном источнике товаров отсутствует обязательное значение. Добавьте поле в Google Sheet или ленту, используемую B2BLIX, а не непосредственно в сформированный XML.
• SKU и EAN совпадают. Обычно это означает, что отдельный SKU не был передан. Если нужны разные значения, добавьте поле sku.
• Новая синхронизация ещё не завершилась. Общедоступный файл содержит результат, сформированный во время синхронизации. Перед ожиданием изменения данных проверьте последний запуск.
• Pigu ещё не обработала последнюю версию файла. XML уже может содержать новое значение, пока на маркетплейсе отображается прежняя цена.

Как проверить завершённое обновление

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

Также можно открыть Отчёты о синхронизации. Объяснение статусов отчётов и сведений об обработке см. в руководстве Отчёты о синхронизации: просмотр результатов импорта, расчёта BuyBox и экспорта.

Эти проверки помогают определить, на каком этапе остановился процесс:

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

Пример

В вашем источнике есть товар с EAN 4770000000001, SKU ABC-101, количеством на складе 5 и необходимой информацией о цене.

Во время синхронизации B2BLIX оценивает товар и подготавливает рассчитанную цену 19.99 EUR. Сформированный XML содержит EAN, SKU, количество на складе и экспортированную цену.

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

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

1. Убедитесь, что экспорт XML настроен в разделе «Настройки синхронизации» B2BLIX.
2. Откройте общедоступный XML-URL и проверьте небольшую выборку товаров.
3. Проверьте те же EAN в проверке товаров.
4. Добавьте URL в Pigu в разделе Товары → Импорт остатков и цен.
5. Выполните запрошенное сопоставление полей и подтвердите источник импорта.
6. Проверьте первую завершённую синхронизацию и импорт в Pigu, прежде чем расширять процесс на большой каталог.

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