Вернуться ко всем руководствам

Как устранить проблемы с синхронизацией данных API, остатков и часов самовывоза

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

Когда это руководство актуально

Используйте это руководство, если вы столкнулись с одной или несколькими из следующих ситуаций:

  • Значение Экспортировано пустое после изменения метода вывода с XML на API.
  • На странице «Статистика» отображается Данные API = 0 или предупреждение, связанное с API.
  • Остатки или часы самовывоза не обновляются через API.
  • Общедоступные данные маркетплейса доступны, но данные API не были получены.
  • Синхронизация выполняется дольше, чем ожидалось.

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

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

Если на странице «Статистика» отсутствуют данные API, сначала проверьте Учётные данные доступа. Если данные указаны правильно, проверьте интервал синхронизации, просмотрите последние отчёты о синхронизации и запустите синхронизацию вручную.

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

Почему при синхронизации через API значение «экспортировано» может быть пустым

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

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

Не используйте пустой столбец «Экспортировано» как единственный признак проблемы с API. Вместо этого проверьте:

  • Успешно ли завершился отчёт о синхронизации.
  • Были ли получены и обработаны товары.
  • Настроен ли для аккаунта метод вывода через API.
  • Сохранены ли действительные учётные данные доступа к API.
  • Появляются ли данные API в разделе «Статистика» после обработки.

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

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

1. Определите, связана ли проблема с данными API или данными маркетплейса

B2BLIX хранит разные типы информации отдельно:

  • Веб-данные — информация о маркетплейсах, полученная в результате наблюдения.
  • Данные API — информация, полученная через подключённый аккаунт API.
  • Импортированные данные поступают из настроенного источника товаров.
  • Рассчитанные данные — результат, полученный по правилам BuyBox.

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

Чтобы сравнить доступные данные аккаунта, войдите в аккаунт и откройте Статистику. Объяснение показателей приведено в руководстве Панель статистики: понимание показателей аккаунта.

Пример панели статистики с карточками для 220.lv, Pigu.lt, Kaup24.ee и HobbyHall.fi
Панель статистики помогает определить, собираются ли данные API для подключённых маркетплейсов.

2. Проверьте и сохраните учётные данные доступа повторно

Недействительные, просроченные или неправильно сохранённые учётные данные могут помешать B2BLIX получать данные API. Это может привести к появлению значения Данные API = 0 или предупреждения API на странице «Статистика».

  1. Откройте раздел Учётные данные доступа.
  2. Убедитесь, что обязательные поля логина, пароля и токена содержат правильные актуальные значения.
  3. Не удаляйте и не заменяйте значение, если вы не проверили правильность соответствующих учётных данных.
  4. Нажмите Обновить, чтобы снова сохранить учётные данные.
  5. Запустите новую синхронизацию и проверьте результат.

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

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

3. Проверьте настройки синхронизации

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

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

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

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

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

Обратите внимание на следующие признаки:

  • Товары не получены: проверьте настроенный источник товаров и его доступность.
  • Товары получены, но не обработаны: проверьте исключения, обязательные идентификаторы и сообщения отчёта.
  • Обработка всё ещё выполняется: большая партия обновлений может ожидать обработки в очереди.
  • Отчёт завершён, но значение «Экспортировано» пустое: убедитесь, что аккаунт использует вывод через API, а не через XML.
  • Отчёт завершён, но данные API по-прежнему равны нулю: ещё раз проверьте и повторно сохраните учётные данные доступа.

5. Запустите синхронизацию вручную

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

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

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

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

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

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

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

Симптом Возможная причина Что проверить
Значение «Экспортировано» пустое Аккаунт использует вывод через API, а не XML-экспорт Проверьте метод вывода и полный отчёт о синхронизации
Данные API равны нулю Учётные данные недействительны, устарели или сохранены неправильно Проверьте учётные данные доступа и нажмите «Обновить»
Веб-данные есть, но данные API отсутствуют Мониторинг маркетплейса работает, но подключение к API не синхронизировано Проверьте учётные данные, настройки синхронизации и отчёты
Остатки или часы самовывоза не меняются Исходные данные устарели, интервал неактивен или обновление всё ещё обрабатывается Проверьте источник, интервал, последний отчёт и статус обработки
Синхронизация остаётся в процессе Большое количество обновлений создало очередь Отслеживайте текущий отчёт вместо повторного запуска процессов
Затронуты только некоторые товары Проблема может быть связана с данными или идентификаторами отдельных товаров Проверьте EAN затронутого товара в разделе «Проверка товара»

Пример

Продавец меняет метод вывода с XML на API. В следующем отчёте указано, что импортировано 2 000 товаров, но поле Экспортировано пустое.

Это автоматически не означает, что синхронизация завершилась с ошибкой, поскольку рабочий процесс API не формирует такой же итог по экспортированным единицам, как XML-файл. Продавцу следует проверить статус отчёта и страницу «Статистика». Если в разделе «Статистика» отображается Данные API = 0, следующим шагом будет проверка учётных данных доступа, нажатие кнопки Обновить и запуск ещё одной синхронизации.

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

  1. Убедитесь, что аккаунт использует вывод через XML или API.
  2. Проверьте раздел «Статистика», чтобы определить, отсутствуют ли веб-данные, данные API или оба типа данных.
  3. Проверьте и повторно сохраните учётные данные доступа.
  4. Убедитесь, что интервал синхронизации и настройки вывода через API активны.
  5. Просмотрите последний отчёт о синхронизации перед запуском нового процесса.
  6. После сохранения исправленных настроек выполните одну синхронизацию вручную.
  7. Используйте раздел «Проверка товара», если проблема затрагивает определённые EAN, а не весь аккаунт.

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