Синхронизация через XML или API: какой способ экспорта выбрать?

Какой способ экспорта выбрать

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

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

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

Выбирайте XML, если у вас большой каталог или необходимо отправлять информацию о товарах массово.
Выбирайте API, если у вас небольшой каталог и нужны прямые обновления без ожидания, пока Pigu заберёт XML-файл.
Рассмотрите API как резервный вариант, если обработка XML в Pigu задерживается или, по всей видимости, приостановлена.

Для очень больших каталогов синхронизация через API может не справляться с объёмом данных достаточно эффективно. В некоторых случаях при большом объёме B2BLIX может переключить аккаунт с API на XML. В этом случае необходимо также обновить соответствующую конфигурацию экспорта в аккаунте продавца Pigu.

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

Как работает синхронизация через XML

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

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

XML обычно подходит для:

Больших каталогов товаров.
Массовых обновлений на одном или нескольких маркетплейсах.
Передачи в одном фиде информации о ценах, остатках и времени выдачи.
Аккаунтов, в которых доставка через API неэффективна из-за количества товаров.

Как работает синхронизация через API

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

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

API обычно подходит для:

Небольших каталогов.
Прямого обновления цен.
Ситуаций, когда обработка XML в Pigu необычно долго выполняется или приостановлена.
Обновления остатков или времени выдачи, если такие настройки API доступны в аккаунте.

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

Сравнение XML и API

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

Что проверить в аккаунте

1. Проверьте текущий тип экспорта

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

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

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

2. Проверьте размер каталога

Учитывайте общее количество отправляемых товаров и количество включённых маркетплейсов. Каталог, который эффективно обрабатывается через API для одного маркетплейса, может оказаться слишком большим, если те же товары обрабатываются на нескольких маркетплейсах.

Если в вашем каталоге десятки тысяч товаров, XML обычно является более подходящим способом массовой передачи данных.

3. Проверьте, какую информацию необходимо обновлять

Убедитесь, что вам необходимо передавать:

Только цены.
Цены и остатки.
Цены, остатки и время выдачи.

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

4. При использовании XML проверьте общедоступный URL фида

Для синхронизации через XML необходимо, чтобы Pigu получал правильный общедоступный URL B2BLIX. Если тип экспорта был изменён с API на XML, убедитесь, что адрес XML также настроен на стороне Pigu.

Персональный адрес XML доступен в разделе Настройки синхронизации, если настроен экспорт XML.

5. Проверьте последний результат синхронизации

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

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

Распространённые сценарии

У вас очень большой каталог

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

Pigu не обрабатывает XML-файл

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

Вам необходимо передавать в экспорте остатки и время выдачи

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

Способ экспорта изменился автоматически

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

Пример

Продавец синхронизирует примерно 30 000 товаров на трёх маркетплейсах. Передача через API становится неподходящей для такого объёма, поэтому экспорт переключается на XML.

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

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

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