Ограничения и интервалы экспорта 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 маркетплейса могут меняться. Актуальную документацию Pigu API следует считать авторитетным источником последних ограничений на запросы.

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

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.