Настройки синхронизации: настройка импорта товаров и экспорта цен

Для чего нужна страница настроек синхронизации

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

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

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

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

Что можно делать на этой странице

• Указать URL, по которому B2BLIX должен загружать данные о товарах.
• Выбрать XML, CSV или Google Spreadsheets в качестве формата источника.
• При необходимости указать данные базовой аутентификации для защищённого источника.
• Выбрать периодичность запуска процесса синхронизации.
• Выбрать XML или один из поддерживаемых способов экспорта через API.
• Включить или отключить режим скидки.
• Сохранить конфигурацию синхронизации.
• Запустить синхронизацию немедленно, не дожидаясь следующего запланированного интервала.
• Скопировать персональный публичный URL XML, если выбран экспорт XML.
• Просмотреть распознанные атрибуты импорта и их альтернативные названия.

Основные поля и элементы управления

Настройки импорта

URL источника данных

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

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

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

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

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

Формат данных

Выберите формат, соответствующий источнику:

• XML: Используйте этот вариант, если источник предоставляет товары в виде структурированных XML-элементов.
• CSV: Используйте этот вариант для текстового файла в виде таблицы, содержащего по одному товару в строке.
• Google Spreadsheets: Используйте этот вариант, если информация о товарах хранится в общей таблице Google.

Неправильный формат может помешать корректной интерпретации источника, даже если сам URL доступен.

Периодичность синхронизации

Интервал синхронизации определяет, как часто B2BLIX выполняет полную процедуру синхронизации:

1. Загружает последние данные о товарах из источника.
2. Сопоставляет и оценивает импортированные товары.
3. Рассчитывает цены в соответствии с настроенными правилами BuyBox и ограничениями безопасности.
4. Подготавливает выбранный XML- или API-результат.

Доступны следующие интервалы:

• Никогда
• 30 минут
• 1 час
• 2 часа
• 3 часа

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

Стратегии на основе последней опубликованной цены

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

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

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

Настройки экспорта

XML

Вариант XML создаёт файл с товарами, организованный в соответствии с поддерживаемой структурой ценового XML Pigu. Файл доступен по персональному публичному URL.

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

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

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

После подключения источника XML общий процесс выглядит следующим образом:

1. B2BLIX загружает ваш источник с выбранным интервалом синхронизации.
2. B2BLIX рассчитывает результат и обновляет XML-файл.
3. Pigu получает XML в соответствии со своим расписанием импорта.
4. Pigu обрабатывает и применяет принятые обновления.

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

API

Стандартный вариант API планирует передачу рассчитанных изменений цен через поддерживаемую интеграцию Pigu.

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

API с остатками и часами выдачи

Вариант API (с остатками и часами выдачи) передаёт расширенный набор обновлений товаров. Помимо информации о ценах, он включает данные об остатках и часах выдачи, если они поддерживаются и предоставлены.

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

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

Режим скидки

Pigu поддерживает стандартную цену и цену после скидки. B2BLIX называет их ценой до скидки и ценой после скидки.

Если режим скидки отключён

Рассчитанная цена B2BLIX помещается в оба выходных поля:

• Цена до скидки: рассчитанная цена
• Цена после скидки: рассчитанная цена

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

Если режим скидки включён

Исходная и рассчитанная цены сохраняются отдельно:

• Цена до скидки: исходная переданная стандартная цена
• Цена после скидки: новая рассчитанная цена B2BLIX

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

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

Структура импортируемого файла

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

В XML-источниках товары должны быть представлены повторяющимися элементами product, item или row. Распознаваемые атрибуты размещаются внутри каждого элемента товара.

<item>
<ean>1234567890123</ean>
<price>24.99</price>
<min>22.00</min>
<max>28.00</max>
</item>

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

Атрибуты, распознаваемые системой

Правило для часов выдачи: Значение по умолчанию collectionhours применяется только к XML-экспорту. Если для Латвии, Литвы, Эстонии или Финляндии нужны разные значения, укажите соответствующие атрибуты для конкретного маркетплейса. Не объединяйте значение по умолчанию со значениями часов выдачи для отдельных маркетплейсов.

Как безопасно использовать эту страницу

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

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

Что происходит после сохранения

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

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

1. получит источник по сохранённому URL;
2. интерпретирует его с использованием выбранного формата данных;
3. обработает импортированные товары с текущими настройками BuyBox;
4. применит доступные минимальные и максимальные ограничения цен;
5. подготовит XML- или API-результат;
6. запишет информацию о запуске в отчёты о синхронизации.

Используйте Запустить синхронизацию, если нужно немедленно начать этот процесс.

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

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

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

Пример использования

Продавец хранит данные о товарах в Google Spreadsheets. Таблица содержит столбцы EAN, SKU, текущая цена, минимальная цена, максимальная цена и остаток.

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

После этого B2BLIX обновляет XML с выбранным интервалом синхронизации. Pigu получает и обрабатывает файл в соответствии со своим расписанием.