Ограничения API-экспорта, интервалы и задержки для больших каталогов

Почему обновление цен через API может занимать больше времени?

Эта статья актуальна, если B2BLIX рассчитала новые цены, но изменения появляются на Pigu, 220.lv, Kaup24.ee или HobbyHall.fi позже ожидаемого.

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

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

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

Количество товаров учитывается по всем подключённым маркетплейсам Pigu Group, а не отдельно для каждого маркетплейса.

Если каталог становится слишком большим для поддерживаемого процесса публикации через API, B2BLIX может переключить вывод обратно на XML. Результаты расчёта XML могут оставаться корректными, даже если публикация через API в реальном времени задерживается или недоступна для всего каталога.

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

Как ограничения на запросы API влияют на экспорт

Pigu устанавливает ограничения на запросы к API. Например, в документации API был указан лимит 500 запросов за 10 секунд для процесса обновления предложений.

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

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

Ограничения API маркетплейса могут изменяться. Актуальную документацию API Pigu следует считать авторитетным источником информации о текущем лимите запросов.

Как размер каталога изменяет интервал экспорта

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

На практике процесс работает следующим образом:

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

Более длительный интервал не обязательно указывает на ошибку. Это может быть ожидаемым результатом обработки большего количества товаров с соблюдением ограничений API.

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

1. Уточните текущий способ экспорта

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

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

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

2. Просмотрите последний отчёт о синхронизации

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

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

3. Проверьте один затронутый товар

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

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

Распространённые причины замедления публикации через API

Общий каталог увеличился. Товары со всех подключённых маркетплейсов влияют на объём, используемый для выбора интервала экспорта.
В рамках одной синхронизации изменилось большое количество цен. Чем больше изменений, тем больше очередь публикации.
API маркетплейса обрабатывает обновления медленнее. B2BLIX должна ждать ответов API маркетплейса и соблюдать его ограничения на запросы.
Экспорт через API ещё выполняется. Расчёт мог завершиться до публикации всех подготовленных обновлений.
Вывод был переключён на XML. Для каталога, превышающего поддерживаемый объём API, вместо прямой публикации через API может использоваться XML.
Проверялась только текущая цена на маркетплейсе. Просмотрите «Отчёты о синхронизации» и «Проверку товара», чтобы определить, возникла ли задержка на этапе расчёта, экспорта или применения изменений маркетплейсом.

Пример

Продавец импортирует товары для 220.lv, Pigu.lt и Kaup24.ee. Объединённый каталог значительно больше количества товаров на любом одном маркетплейсе.

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

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

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

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

При сообщении о постоянной задержке укажите приблизительное общее количество товаров, затронутые маркетплейсы, время соответствующей синхронизации и несколько примеров EAN. Не включайте пароли аккаунта или учётные данные API.