Каталог товаров
Раздел: Общие возможности
Что это
Каталог товаров — список всех карточек кабинета Wildberries, который «Оптима» хранит у себя и регулярно обновляет. Для каждой карточки в нём есть артикул WB (nmId), артикул продавца, название, бренд, фото и снимок цены: базовая цена, скидка продавца, цена со скидкой и скидка WB Клуба.
Каталог общий для всех модулей «Оптимы», поэтому один и тот же список товаров видят:
- экран «Цены» и экран «Репрайсер»;
- переключатель «Бренд» в шапке приложения — список брендов собирается из карточек каталога;
- поле выбора товаров (SKU) в формах A/B-тестов, генерации контента, ИИ-помощника, ИИ-агента и списков товаров РНП;
- фото товаров в аналитике РНП.
Отдельного раздела «Каталог» в боковом меню нет: каталог виден через перечисленные экраны.
Как пользоваться
Найти товар
На экранах «Цены» и «Репрайсер» и в поле выбора товаров работает поиск по названию, артикулу продавца или nmId — по части строки, без учёта регистра. На экране «Цены» каталог можно также сортировать и фильтровать по наличию скидки.
Запустить синхронизацию вручную
Если каталог кабинета пуст (например, кабинет только что подключён), в поле выбора товаров появится кнопка «Синхронизировать каталог». Она запускает полную синхронизацию: сначала карточки, затем цены. Пока синхронизация идёт, рядом показывается «Синхронизация каталога…»; по завершении — число карточек и время последнего обновления цен. Повторное нажатие во время синхронизации новую не запускает — появится сообщение «Синхронизация каталога уже выполняется.».
Как обновляются данные
| Что | Когда | Источник в Wildberries |
|---|---|---|
| Карточки: название, бренд, артикул продавца, фото | Ежедневно в 04:00 МСК | Content API, список карточек |
| Цены и скидки | Каждые 30 минут | API цен и скидок, список товаров с ценами |
| Карточки и цены целиком | При подключении кабинета и при смене его API-ключа | оба источника, сначала карточки |
| Карточки и цены целиком | По кнопке «Синхронизировать каталог» | оба источника, сначала карточки |
Плановая синхронизация идёт только для активных кабинетов. Цены обновляются только у карточек, которые уже есть в каталоге, поэтому при первичном наполнении сначала загружаются карточки, а потом цены.
Ограничения
- Цена — снимок, а не живое значение. Между синхронизациями (до 30 минут) цена в каталоге может отличаться от текущей цены на Wildberries, в том числе после изменения цены через «Оптиму».
- У товаров с разными ценами по размерам в каталоге показывается минимальная цена среди размеров — та, что видна покупателю как цена «от».
- Фото — первое (главное) фото карточки.
- Новая карточка, созданная в Wildberries, появится после ближайшей ежедневной синхронизации (или после ручного запуска). Цена по ней приходит отдельно, поэтому какое-то время товар может отображаться без цены.
- Кнопка ручной синхронизации есть только в поле выбора товаров и только при пустом каталоге; в остальных случаях синхронизацию можно запустить через API.
- Защитный предел одной синхронизации — около 100 тысяч карточек; при упоре в него хвост каталога не загружается (это фиксируется в журналах сервера).
- Каталог виден только по кабинетам, к которым у вас есть доступ.
Связанные страницы
Для интеграторов
POST /catalog/sync(wbAccountIdв теле) — поставить полную синхронизацию кабинета, ответ202сjobIdи признакомalreadyRunning.GET /catalog/sync/status?wbAccountId=…—state(idle,running,error),productCount,lastSyncAt(последний синк цен),errorMessage.GET /catalog/products— каталог кабинета (то же, чтоGET /pricing/products):brandId,q(до 200 символов),discount,sort(name,price,discountPercent,discountedPrice,updatedAt),sortDir, пагинация.GET /brands— бренды кабинета.- Источники WB:
POST /content/v2/get/cards/list(страницы по 100 карточек) иGET /api/v2/list/goods/filter(страницы по 1000 товаров). Очередьcatalog-sync. - Справочник: API. Решения: ADR-0052, ADR-0059.