Wildberries. Заполнение карточек товаров. Как получить значение справочников?
Wildberries. Заполнение карточек товаров. Как получить значение справочников?
При программном создании карточек номенклатуры я столкнулся с тем, что документация (https://suppliers-portal.wildberries.ru/nsf/front/new-spec-micro-frontend/_assets/pkg_card_DOC.md) скромно умалчивает о важных аспектах получения справочников, без которых не создать карточку. Все примеры рабочие, если не открываются из документа, скопируйте в строку браузера.
Начнём с начала, сперва нужно получить поля объектов по ключевому слову:
1. Сперва нужно получить объект: https://content-suppliers.wildberries.ru/ns/characteristics-configurator-api/content-configurator/api/v1/config/get/object/list?pattern=Кроссовки&lang=ru &lang=ru . Обратите внимание на множественное число. Я долго пытался получить информацию по объекту Ложка и ничего не находил, нужно было писать Ложки. Язык поиска указываем обязательно &lang=ru.
Если угадали слово поиска, получаем это {
"additionalErrors": null,
"data": {
"Кроссовки": {
"name": "Кроссовки",
"parent": "Обувь"
}
},
Кроссовки это ключевое слово, с ним будем работать. Если слов несколько, то нужно выбрать нужное, смотри запрос «Ложки»
2. Нужно получить поля объектов:
name это то слово которое мы получили/выбрали в п1. В ответ получаем это:
{
"additionalErrors": null,
"data": {
"name": "Кроссовки",
"parent": "Обувь",
"addin": [
{
"isAvailable": true,
"required": true,
"useOnlyDictionaryValues": true,
"type": "Бренд",
"dictionary": "/brands"
},
{
"isAvailable": true,
"required": false,
"useOnlyDictionaryValues": false,
"type": "Описание"
},
{
"isAvailable": true,
"required": true,
"useOnlyDictionaryValues": true,
"maxCount": 10,
"type": "Комплектация",
"dictionary": "/contents"
},
…
Это свойства каждого поля:
- type": "Бренд" - это имя свойства
- "required": true - заполнение обязательно
- "useOnlyDictionaryValues": true – заполнение только из словаря, тут немного не точно, некоторые значения, в частности бренд можно заполнять не из словаря
- "dictionary": "/brands" – имя справочника из которого выбираем значения
- "isNumber": true, - значение число
- "units": [ "г" ] – единица измерения
Сперва идут свойства карточки товара, в структуре "nomenclature": { свойства номенклатуры, в структуре "variation": { свойства вариации (размера)
Все, список всех справочников можно получить (как сказано в документации)
Но в документации не сказано, как получать значения из этих справочников:
Предмет это то слово, которое было с п1 и никак иначе
В некоторых справочниках (небольших) можно не указывать параметры:
В других нужно указать предмет, и тут начинаются чудеса: в каждом справочнике параметры нужно указывать по-разному, и в документации я этого не нашёл
/tnved?lang=ru&pattern=&subject=Слово
/ext – тут указываем имя свойства из п2 и желательно подстроку
Для размера указываем ещё и пол, если в свойствах карточки размер обязателен
Очень позабавил справочник комплектация «/contents» если без параметров он выдаёт первые 10 элементов, которые совсем не нужны. Обязательно указываем параметр «pattern» и желательно «top»
Вступайте в нашу телеграмм-группу Инфостарт
Вы можете заказать платную адаптацию этой статьи под ваши задачи на «Бирже заказов».
- 0% комиссии — оплата напрямую исполнителю;
- Исполнители любого масштаба — от отдельных специалистов до команд под проект;
- Прямой обмен контактами между заказчиком и исполнителем;
- Безопасная сделка — при необходимости;
- Рейтинги, кейсы и прозрачная система откликов.
См. также
67620 руб.
22.03.2021 313552 2603 2186
23.01.2023 82727 785 user1468243 212
28800 руб.
12.05.2021 123662 1073 274
5490 руб.
12.08.2021 48524 654 71
6000 руб.
11.12.2019 68100 1163 3
6000 руб.
26.11.2020 51323 865 4