Синхронизация через XML и API: какой метод экспорта выбрать?
Узнайте, когда использовать экспорт через XML или API, чем отличаются эти методы и что проверить перед изменением настроек синхронизации B2BLIX.
Выбор подходящего метода экспорта
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 отправляет обновления напрямую, без ожидания загрузки XML-файла со стороны Pigu. Обычно она предназначена для небольшого количества товаров и прямого обновления цен.
В некоторых конфигурациях аккаунта также могут отображаться варианты 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.
После этого продавцу следует открыть настройки синхронизации, скопировать предоставленный XML URL, настроить этот URL в аккаунте Pigu и проверить следующий отчет о синхронизации. Pigu будет загружать и обрабатывать товары пакетно вместо получения тысяч отдельных обновлений через API.
Что делать дальше
- Откройте настройки синхронизации и подтвердите текущий тип экспорта.
- Проверьте общее количество товаров и включенные маркетплейсы.
- Убедитесь, нужны ли вам только цены или также остатки и часы получения.
- Если используется XML, проверьте, что в Pigu указан правильный общедоступный URL фида.
- Запустите следующую синхронизацию или дождитесь ее выполнения и проверьте результат в отчетах о синхронизации.
- Проверьте ограниченный набор товаров, прежде чем использовать новый метод для всего каталога.
