Тестер синхронизации и структура файла Google Sheets
Тестер синхронизации проверяет, имеет ли файл товаров Google Sheets правильную структуру, и показывает, как B2BLIX обработает небольшое количество товаров. Он создаёт тестовый XML-результат без прямой публикации цен на маркетплейсе.
Для чего используется тестер синхронизации
Тестер синхронизации — это инструмент подготовки для продавцов, которые хотят проверить файл товаров перед настройкой регулярной синхронизации.
Вы можете создать небольшой документ Google Sheets с реальными или типичными товарами, указать его URL и один раз запустить процесс расчёта BuyBox. B2BLIX считывает переданные данные о товарах, использует доступную найденную информацию о маркетплейсах и настроенные вами правила BuyBox, а затем подготавливает XML-файл с рассчитанными результатами.
Эта страница особенно полезна, если вам нужно:
- Проверить правильность названий столбцов и структуры файла.
- Понять значение каждого поддерживаемого поля товара.
- Протестировать общие цены и цены для отдельных маркетплейсов.
- Проверить минимальные и максимальные ограничения цены.
- Протестировать правила исключения или нестандартные ситуации с товарами.
- Просмотреть результат в XML перед настройкой регулярной синхронизации.
Обычно тестер используется до добавления окончательного источника товаров в разделе Настройки синхронизации. После настройки и успешного запуска регулярной синхронизации использовать тестер следует только с особой осторожностью.
Важно: запуск теста не отправляет цены напрямую в Pigu, 220.lv, Kaup24.ee или HobbyHall.fi. Однако тест может обновить созданный общедоступный XML-файл по тому же фиксированному URL. Не запускайте тест, если этот URL XML подключён к работающему маркетплейсу или другой системе, поскольку подключённая система может получить временные тестовые данные.
Что можно сделать на этой странице
- Открыть эталонный документ Google Sheets с ожидаемой структурой.
- Указать URL собственного файла товаров в Google Sheets.
- Выбрать способ отображения исходных и рассчитанных цен в XML-выводе.
- Просмотреть допустимые названия полей и альтернативные названия столбцов.
- Запустить разовый тест синхронизации.
- Создать XML-файл с обработанными товарами и рассчитанными ценами.
- Просмотреть созданный результат в процессе формирования отчёта о синхронизации.
Тест выполняет реальную процедуру расчёта, однако рассчитанная или экспортированная цена автоматически не становится действующей ценой на маркетплейсе. Цена становится действующей только в том случае, если внешняя интеграция использует созданный результат, а маркетплейс принимает и применяет эту цену.
Основные поля и элементы управления
| Поле или элемент управления | Значение | Когда использовать |
|---|---|---|
| URL Google Sheets | Адрес документа Google Sheets с товарами, которые вы хотите протестировать. | Вставьте URL после подготовки таблицы с поддерживаемыми названиями столбцов. Убедитесь, что B2BLIX может получить доступ к документу по указанному URL. |
| Режим скидки | Определяет, как переданная и рассчитанная цены будут представлены в XML-выводе. | Включите его, если хотите сохранить в XML переданную цену как исходную, а рассчитанную цену показать как цену со скидкой. |
| Открыть пример: Google Sheets | Открывает эталонную таблицу с ожидаемой структурой. | Используйте перед созданием собственного документа или при проверке написания и порядка столбцов. |
| Таблица атрибутов | Содержит основное допустимое название поля, поддерживаемые альтернативы и краткое описание. | Используйте её при создании названий столбцов в документе Google Sheets. |
| Запустить тест | Считывает переданную таблицу, обрабатывает товары, применяет доступные настройки BuyBox и создаёт результат теста. | Используйте после проверки URL источника, идентификаторов товаров, цен, ограничений и региональных значений. |
Как подготовить документ Google Sheets
Используйте одну строку для каждого товара. В первой строке должны находиться названия поддерживаемых атрибутов.
Тестер принимает основные названия атрибутов, отображаемые на странице, а для некоторых полей — альтернативные названия. Используйте написание в точности как указано. Не добавляйте пробелы и не изменяйте символы подчёркивания и дефисы, если соответствующий вариант не указан в списке альтернатив.
На странице не отмечены все возможные столбцы, обязательные для заполнения. На практике основным значением для сопоставления товара является EAN или GTIN. Добавьте остальные поля, необходимые для тестируемой ситуации.
Идентификатор товара должен соответствовать товару, который существует в предложениях продавца на маркетплейсе и был найден B2BLIX. Неизвестный или неверный EAN может помешать сопоставлению товара с доступной информацией о маркетплейсе.
Суффиксы маркетплейсов
Для нескольких групп полей поддерживаются как общее значение, так и значение для одного конкретного маркетплейса. Маркетплейс определяется суффиксом в конце названия столбца.
| Суффикс | Маркетплейс | Пример поля |
|---|---|---|
| _lv | 220.lv в Латвии | price_lv |
| _lt | Pigu.lt в Литве | price_lt |
| _ee | Kaup24.ee в Эстонии | price_ee |
| _fi | HobbyHall.fi в Финляндии | price_fi |
Как работают общие значения и значения для маркетплейсов
Поле без суффикса маркетплейса используется как общее значение для всех поддерживаемых маркетплейсов. Поле для конкретного маркетплейса заменяет общее значение только для своего маркетплейса.
Например, предположим, что строка товара содержит:
| Столбец | Значение |
|---|---|
price |
100 |
price_lv |
90 |
Фактически переданные цены будут следующими:
- Латвия: 90, поскольку
price_lvзаменяет общее значение. - Литва: 100 из поля
price. - Эстония: 100 из поля
price. - Финляндия: 100 из поля
price.
Тот же принцип применяется к:
- Часам получения или доставки.
- Ценам до скидки.
- Ценам после скидки.
- Минимально допустимым ценам.
- Максимально допустимым ценам.
Не нужно повторять одно и то же значение во всех четырёх столбцах маркетплейсов. Укажите общее значение и добавьте только отличающиеся региональные значения.
Поля идентификации товара
| Атрибут | Допустимая альтернатива | Значение и использование |
|---|---|---|
ean |
gtin |
Основной идентификатор товара, используемый для сопоставления переданной строки с товаром на маркетплейсе. EAN должен соответствовать товару, доступному в предложениях продавца в Pigu Group и известному B2BLIX. |
sku |
sku |
Идентификатор Stock Keeping Unit продавца. Он может использоваться как дополнительная ссылка или значение для проверки товара. Он не заменяет EAN, если для сопоставления товара требуется EAN. |
Поле остатка
| Атрибут | Допустимая альтернатива | Значение и использование |
|---|---|---|
stock | stock | Доступное количество товара. Укажите целое число, например |
Значение 0 означает, что в данный момент товар отсутствует. Внимательно проверяйте остатки при тестировании вывода, который может быть прочитан другой системой.
Поля часов получения и доставки
Эти поля описывают время доставки или получения товара для поддерживаемых маркетплейсов.
| Атрибут | Допустимая альтернатива | Применяется к |
|---|---|---|
collectionhours | collection_hours | Общее значение для всех маркетплейсов, если оно не переопределено. |
collectionhours_lv | collection_hours_lv | Только Латвия. |
collectionhours_lt | collection_hours_lt | Только Литва. |
collectionhours_ee | collection_hours_ee | Только Эстония. |
collectionhours_fi | collection_hours_fi | Только Финляндия. |
Используйте общее поле, если время доставки одинаково на всех рынках. Добавьте поле конкретного маркетплейса, если в одной стране время доставки отличается.
Поля цены до скидки
Эти поля содержат переданную цену товара до применения скидок. Общее значение используется для всех маркетплейсов, если не указано региональное значение.
| Атрибут | Допустимые альтернативы | Применяется к |
|---|---|---|
price | price_before_discount, price-before-discount | Общая цена для всех маркетплейсов, если она не переопределена. |
price_lv | price_before_discount_lv, price-before-discount-lv | Только Латвия. |
price_lt | price_before_discount_lt, price-before-discount-lt | Только Литва. |
price_ee | price_before_discount_ee, price-before-discount-ee | Только Эстония. |
price_fi | price_before_discount_fi, price-before-discount-fi | Только Финляндия. |
Эта переданная цена является входными данными. Она не обязательно будет итоговой рекомендуемой ценой, поскольку во время теста B2BLIX может применить настроенную стратегию ценообразования и ограничения безопасности.
Поля цены после скидки
Эти поля представляют переданную цену товара со скидкой. Они также определяют интерпретацию информации о цене при использовании режима скидки.
| Атрибут | Допустимые альтернативы | Применяется к |
|---|---|---|
price_after_discount | price_after_discount, price-after-discount | Общая цена со скидкой, если она не переопределена. |
price_after_discount_lv | price_after_discount_lv, price-after-discount-lv | Только Латвия. |
price_after_discount_lt | price_after_discount_lt, price-after-discount-lt | Только Литва. |
price_after_discount_ee | price_after_discount_ee, price-after-discount-ee | Только Эстония. |
price_after_discount_fi | price_after_discount_fi, price-after-discount-fi | Только Финляндия. |
Поля минимальной цены
Минимальная цена — это наименьшая разрешённая цена товара. Она защищает продавца от снижения рассчитанной цены ниже выбранного ограничения.
| Атрибут | Значение |
|---|---|
min | Общая минимальная цена для всех маркетплейсов, если она не переопределена. |
min_lv | Минимально допустимая цена для Латвии. |
min_lt | Минимально допустимая цена для Литвы. |
min_ee | Минимально допустимая цена для Эстонии. |
min_fi | Минимально допустимая цена для Финляндии. |
Безопасность цены: проверьте каждую минимальную цену перед запуском теста. Минимальные значения на уровне товара являются важными ограничениями безопасности и могут влиять на рассчитанный результат для каждого маркетплейса.
Поля максимальной цены
Максимальная цена — это наибольшая разрешённая цена товара. Она ограничивает возможное повышение рассчитанной цены.
| Атрибут | Значение |
|---|---|
max | Общая максимальная цена для всех маркетплейсов, если она не переопределена. |
max_lv | Максимально допустимая цена для Латвии. |
max_lt | Максимально допустимая цена для Литвы. |
max_ee | Максимально допустимая цена для Эстонии. |
max_fi | Максимально допустимая цена для Финляндии. |
Убедитесь, что минимальные и максимальные значения образуют разумный допустимый диапазон. При подготовке рассчитанных цен тестер использует эти ограничения вместе с настроенными правилами BuyBox.
Как режим скидки изменяет XML-вывод
Режим скидки не включает и не отключает сам расчёт BuyBox. Он изменяет размещение исходной переданной цены и рассчитанной цены в полях цен XML.
| Режим скидки | Цена до скидки | Цена после скидки |
|---|---|---|
| Включён | Исходная цена, переданная в файле источника. | Цена, рассчитанная B2BLIX. |
| Отключён | Цена, рассчитанная B2BLIX. | Цена, рассчитанная B2BLIX. |
Включите режим скидки, если принимающая система должна видеть как исходную цену, так и меньшую или иным образом скорректированную рассчитанную цену. Оставьте его отключённым, если оба поля цен XML должны содержать рассчитанное значение.
Что происходит после нажатия кнопки «Запустить тест»
Тестер выполняет разовую процедуру синхронизации:
- B2BLIX открывает переданный документ Google Sheets.
- Считываются строки товаров и поддерживаемые поля.
- Товары сопоставляются с использованием доступных идентификаторов, прежде всего EAN или GTIN.
- Для расчёта используется доступная найденная информация о маркетплейсах.
- При необходимости применяются настроенные вами правила BuyBox, исключения и ограничения цен.
- Создаётся XML-результат с обработанными данными товаров и рассчитанными ценами.
- Результат можно просмотреть в процессе формирования отчёта о синхронизации.
Маркетплейс по-прежнему определяет, какой продавец получит BuyBox. Результат теста показывает расчёт B2BLIX; он не гарантирует позицию в BuyBox, заказ, доход или прибыль.
Как интерпретировать созданный XML
В XML переданные строки сгруппированы как отдельные товары. Каждый товар может содержать свой идентификатор, SKU, остаток и отдельные поля цен для Латвии, Литвы, Эстонии и Финляндии.
Например, результат может содержать отдельные элементы для:
- GTIN товара.
- SKU продавца.
- Переданного количества товара.
- Цены до скидки для каждого маркетплейса.
- Рассчитанной цены после скидки для каждого маркетплейса.
XML является выходным документом. Его следует проверить до подключения общедоступного URL к маркетплейсу или другой рабочей системе.
Рекомендуемый безопасный процесс
- Откройте пример документа Google Sheets.
- Создайте отдельную тестовую таблицу вместо использования полного рабочего источника.
- Добавьте небольшое количество товаров с известными EAN.
- Убедитесь, что товары уже есть в предложениях на ваших маркетплейсах и найдены B2BLIX.
- Добавьте текущую цену, остаток и необходимую информацию о доставке.
- Тщательно проверьте и добавьте минимальные и максимальные цены.
- Используйте общие значения для всех рынков и добавляйте региональные столбцы только для исключений.
- Выберите подходящий режим скидки.
- Убедитесь, что общедоступный тестовый URL XML не подключён к рабочему получателю.
- Запустите тест и проверьте созданный XML.
- Сравните результат со значениями источника и настроенными правилами BuyBox.
- После успешного тестирования настройте реальный источник и вывод в разделе «Настройки синхронизации».
Распространённые ошибки
- Запуск тестера, когда созданный XML используется рабочей интеграцией. Временные тестовые товары и цены могут заменить содержимое, которое считывает эта интеграция.
- Использование EAN, который отсутствует в списках или не найден. B2BLIX может не суметь связать строку с ожидаемой информацией о товаре на маркетплейсе.
- Изменение написания столбца. Используйте основное название атрибута или одну из перечисленных альтернатив в точности.
- Ожидание, что общее значение заменит региональное. Поле, например
price_lv, имеет приоритет надpriceдля Латвии. - Ввод остатка в виде текста или десятичного значения. Остаток следует указывать как целое количество.
- Использование непроверенных минимальных и максимальных цен. Неверные ограничения могут привести к результатам, которые не соответствуют предполагаемому диапазону цен продавца.
- Неправильное понимание режима скидки. Он изменяет представление исходной и рассчитанной цен в XML, но сам по себе не публикует скидку.
- Предположение, что созданный XML уже доступен в рабочем режиме. Результат не публикуется на маркетплейсе, если другая настроенная система не считывает и не применяет его.
- Немедленное тестирование полного каталога. Начните с нескольких типичных товаров, чтобы было проще проверить исходные данные и результаты расчёта.
Пример использования
Продавец хочет протестировать один товар, представленный на всех четырёх маркетплейсах. Обычная переданная цена составляет 100, но цена для Латвии должна быть равна 90. Допустимый диапазон цен — от 80 до 120.
| Столбец | Пример значения | Назначение |
|---|---|---|
ean | 123456789 | Сопоставляет строку с товаром, известным B2BLIX. |
sku | TEST-001 | Указывает внутреннюю ссылку продавца на товар. |
stock | 5 | Задаёт доступное количество в тестовом выводе. |
price | 100 | Задаёт общую переданную цену. |
price_lv | 90 | Заменяет общую цену для Латвии. |
min | 80 | Задаёт общую минимально допустимую цену. |
max | 120 | Задаёт общую максимально допустимую цену. |
Во время теста для Латвии исходным значением будет региональная цена 90. Литва, Эстония и Финляндия используют общее значение 100. Затем B2BLIX оценивает товар с учётом настроенных правил BuyBox и сохраняет каждый рассчитанный результат в пределах доступных минимального и максимального ограничений.
Продавец может проверить полученный XML, убедиться, что замена цены для Латвии применена правильно, и проверить, что рекомендуемые цены остаются в заданном диапазоне, прежде чем перенести источник товаров в регулярную синхронизацию.
