Skip to content
This repository has been archived by the owner on Sep 11, 2024. It is now read-only.

WildberriesAPI

Jump to bottom
Nikita Elfimov edited this page Feb 3, 2022 · 1 revision

26.08.2021

Описание работы Content API

Для кого документ:

Документ описывает основные методы необходимые для работы с карточкой товара

Документация в swagger API

https://suppliers-api.wildberries.ru/swagger/index.html#/Card

Для начала работ обязательно необходимо убедится чтоб Вы входили на https://suppliers-portal.wildberries.ru/ в качестве поставщика со своим номером телефона. В личном кабинете поставщика номер телефона должен быть связан с поставщиком иначе доступа для работы с карточками товара не будет.

Всё взаимодействие ведётся в рамках протокола json-rpc

Номер телефона должен быть связан также с учётной записью на сайте https://www.wildberries.ru/

Особенности работы системы:

  1. Тестового окружения для поставщиков не предусмотрено. Все карточки сразу создаются в продуктовой среде. В случае ошибок, для исправления которых нет методов в API можно обращаться в службу поддержки с темой Заявка на API Content
  2. Цены для карточек указываются на момент создания, это требование системы. Изменение цен происходит в разделе "Цены и скидки". Также можно воспользоваться API

Аутентификация с помощью токена

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

Раздел и генерация токена доступна только владельцу аккаунта.

Указать имя токена и нажать кнопку Сгенерировать токен Вам будет предоставлен токен для работы с API. Его следует оправлять в заголовке Authorization во всех запроса работы. Время жизни токена не ограничено, но его можно отозвать.

Пример:

POST https://suppliers-api.wildberries.ru/card/cardByImtID
Content-Type: application/json
Authorization: eyJhbGciOiJIUznR5cCI6IkpXVCJ9.eyJhY2Nlc3NJRCI6IjNlOTA1ZmEyLWNFjMy1iZWZjLTM3YmMwMTNlZTNjNSJ9.MGymMDsOb8o7

{
    "id": "4cdf17da-5e7b-4c56-9531-7437d44a13fb",
    "jsonrpc": "2.0",
    "params": {
        // Идентификатор карточки. Можно получить методом "List", который рассмотрен ниже.
        "imtID": 0
    }
}

Описание процесса создания карточки товара

Перед началом работы, если есть необходимость в изучении API на примере — можно посмотреть принцип работы https://suppliers-portal.wildberries.ru/goods/products-card/.

Все запросы идентичны и отличаются лишь заголовками и URL

Создание карточки/карточек товаров.

Для создания карточек существует 2 метода:

Create. https://suppliers-api.wildberries.ru/card/create

Описание: метод позволяет создать одну новую карточку товара.

Тело запроса выглядит следующим образом:

   {
        // Идентификатор отправляемого запроса. Служит для сопоставления ответа отправленному запросу. Необходимо генерировать уникальные идентификаторы для каждого запроса. Во избежание пересечений с другими поставщиками, рекомендуется избегать простых идентификаторов, таких как 1, 2, 3 и т.д.
        "id": "8a41f7a8-6ed1-4910-bbd3-ac83e214ec81",                                                    
        // Версия протокола. Всегда должна быть "2.0".
        "jsonrpc": "2.0",                                           
        // Параметры.
        "params": {                                                 
            "card": {                                             
                    // Страна проиводитель. 
                    "countryProduction": "string",                      
                    // Категория товара (Джинсы, Книги и другие).
                    "object": "string",            
                    // Артикул поставщика.
                    "supplierVendorCode": "string",
                    // Структура, содержащая характеристики карточки, общие для всех номенклатур и размеров.
                    "addin": [                                          
                        {
                            // Название характеристики. Пример: "Бренд"
                            "type": "string",                           
                            // Массив значений характеристики. У характеристик, содержащих одно значение, массив будет содержать только 1 элемент. Пример: "{"type": "Бренд", "params": [{"value": "Имя_бренда"}]}".
                            "params": [                                 
                                {
                                    // Численное значение характеристики.
                                    "count": 0,                         
                                    // Единицы измерения характеристики ("см", "%" и другие).
                                    "units": "string",                  
                                    // Текстовое значение характеристики ("Имя_бренда").
                                    "value": "string"                   
                                }
                            ]
                        }
                    ],
                    // Массив номенклатур товара. 
                    "nomenclatures": [                                  
                        {
                            // Артикул товара.
                            "vendorCode": "string",                     
                            // Массив вариаций товара. Одна цена - один размер - одна вариация.
                            "variations": [                             
                                {
                                    // Штрихкод товара.
                                    "barcode": "string",                
                                    // Структура, содержащая характеристики конкретной вариации товара.
                                    "addin": [                               
                                        {
                                            // Название характеристики.
                                            "type": "string",           
                                            // Массив значений характеристики. У характеристик, содержащих одно значение, массив будет содержать только 1 элемент. Пример: "{"type": "Размер", "params": [{"value": "S"}]}".
                                            "params": [                  
                                                {
                                                    // Численное значение характеристики.
                                                    "count": 0,      
                                                    // Единицы измерения характеристики.
                                                    "units": "string",  
                                                    // Текстовое значение характеристики.
                                                    "value": "string"   
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ],
                            // Структура, содержащая характеристики конкретной номенклатуры.
                            "addin": [                                  
                                {
                                    // Название характеристики
                                    "type": "string",                   
                                    // Массив значений характеристики. У характеристик, содержащих одно значение, массив будет содержать только 1 элемент. Пример: "{"type": "Основной цвет", "params": [{"value": "Красный"}]}".
                                    "params": [                          
                                        {
                                            // Численное значение характеристики.
                                            "count": 0,                 
                                            // Единицы измерения характеристики.
                                            "units": "string",          
                                            // Текстовое значение характеристики.
                                            "value": "string"           
                                        }
                                    ]
                                }
                            ]
                        }
                    ]
                } 
        }
    }

Пример запроса:

POST https://suppliers-api.wildberries.ru/card/create
Content-Type: application/json
Authorization: {{token}}

{
  "params": {
    "card": {
      "countryProduction": "Россия",
      "object": "Джинсы",
      "addin": [
        {
          "type": "Состав",
          "params": [
            {
              "value": "хлопок",
              "count": 100
            }
          ]
        },
        {
          "type": "Бренд",
          "params": [
            {
              "value": "ЛОГОС"
            }
          ]
        },
        {
          "type": "Комплектация",
          "params": [
            {
              "value": "Джинсы - 1 шт"
            }
          ]
        },
        {
          "type": "Тнвэд",
          "params": [
            {
              "value": "6203411000"
            }
          ]
        },
        {
          "type": "Пол",
          "params": [
            {
              "value": "Мужской"
            }
          ]
        }
      ],
      "nomenclatures": [
        {
          "vendorCode": "bluee-123",
          "variations": [
            {
              "barcode": "2001925979004",
              "addin": [
                {
                  "type": "Розничная цена",
                  "params": [
                    {
                      "count": 2222
                    }
                  ]
                },
                {
                  "type": "Размер",
                  "params": [
                    {
                      "value": "56"
                    }
                  ]
                },
                {
                  "type": "Рос. размер",
                  "params": [
                    {
                      "value": "42"
                    }
                  ]
                }
              ]
            }
          ],
          "addin": [
            {
              "type": "Фото",
              "params": []
            },
            {
              "type": "Фото360",
              "params": []
            },
            {
              "type": "Видео",
              "params": []
            }
          ]
        }
      ]
    }
  },
  "jsonrpc": "2.0",
  "id": "json-rpc_8"
}

Ответ:

{"id":"8a41f7a8-6ed1-4910-bbd3-ac83e214ec81","jsonrpc":"2.0","result":{}}

BatchCreate

https://suppliers-api.wildberries.ru/card/batchCreate Описание: метод позволяет создавать сразу много карточек.

Тело запроса выглядит следующим образом:

POST https://suppliers-api.wildberries.ru/card/batchCreate
Content-Type: application/json
Authorization: {{token}}

{
  "id": "30d03c9e-809b-5c5d-84d3-f9a43c79f5d9",
  "jsonrpc": "2.0",
  "params": {
    "card": [
      {
        "countryProduction": "Россия",
        "object": "Джинсы",
        "addin": [
          {
            "type": "Состав",
            "params": [
              {
                "value": "хлопок",
                "count": 100
              }
            ]
          },
          {
            "type": "Бренд",
            "params": [
              {
                "value": "ЛОГОС"
              }
            ]
          },
          {
            "type": "Комплектация",
            "params": [
              {
                "value": "Джинсы - 1 шт"
              }
            ]
          },
          {
            "type": "Тнвэд",
            "params": [
              {
                "value": "6203411000"
              }
            ]
          },
          {
            "type": "Пол",
            "params": [
              {
                "value": "Мужской"
              }
            ]
          }
        ],
        "nomenclatures": [
          {
            "vendorCode": "bluee-123",
            "variations": [
              {
                "barcode": "2001925979004",
                "addin": [
                  {
                    "type": "Розничная цена",
                    "params": [
                      {
                        "count": 2222
                      }
                    ]
                  },
                  {
                    "type": "Размер",
                    "params": [
                      {
                        "value": "56"
                      }
                    ]
                  },
                  {
                    "type": "Рос. размер",
                    "params": [
                      {
                        "value": "42"
                      }
                    ]
                  }
                ]
              }
            ],
            "addin": [
              {
                "type": "Фото",
                "params": []
              },
              {
                "type": "Фото360",
                "params": []
              },
              {
                "type": "Видео",
                "params": []
              }
            ]
          }
        ]
      }
    ]
  }
}

Ответ:

{"id":"30d03c9e-809b-5c5d-84d3-f9a43c79f5d9","jsonrpc":"2.0","result":{}}

ADDIN Addin - структура, хранящая в себе характеристики товаров, которые могут различаться у разных категорий товаров. Она состоит из следующих полей:

"type" - название характеристики товара
"params" - массив значений характеристики

params, в свою очередь, содержит следующие поля для более удобного хранения характеристик:

"value" - текстовое значение характеристики
"count" - числовое значение характеристики
"units" - единицы измерения характеристики

Все характеристики для определённой категории товаров можно получить, совершив следующий запрос:

GET https://suppliers-api.wildberries.ru/api/v1/config/get/object/translated?name=Кроссовки
Authorization: {{token}}

В результате в формате json вернётся список характеристик данной категории товаров (в примере используется категория Кроссовки) и требования к ним. Получение списка возможных категорий товаров будет описано ниже в пункте “Поиск ключа объекта”. Некоторые характеристики требуется заполнять из словарных значений. Для получения списка возможных значений характеристик используется следующий запрос:

GET https://suppliers-api.wildberries.ru/api/v1/directory/brands?pattern=nike&top=50
Authorization: {{token}}

В данном запросе имеется 3 параметра: pattern позволяет указать шаблон для поиска значения характеристики; lang - обязательный параметр, на данный момент используется только ru; top - ограничение по количеству объектов, если не указано - 10 шт.

Список всех доступных категорий можно получить запросом

GET https://suppliers-api.wildberries.ru/api/v1/config/get/object/all?top=10000
Authorization: {{token}}

Получение карточки/карточек.

Для получения карточек существует метод:

CardByImtID. https://suppliers-api.wildberries.ru/card/cardByImtID

Описание: метод позволяет получить карточку поставщика с указанным ID. Тело запроса выглядит следующим образом:

{
        "id": "4cdf17da-5e7b-4c56-9531-7437d44a13fb",
        "jsonrpc": "2.0", 
        "params": {
            // Идентификатор карточки. Можно получить методом "List", который рассмотрен ниже.
            "imtID": 0    
        }
}

Ответ:

{
  "id": "4cdf17da-5e7b-4c56-9531-7437d44a13fb",
  "jsonrpc": "2.0",
  "result": {
    "card": {
      "id": "2d1e2646-ba13-52cd-8bec-3210b8302b7f",
      "imtId": 18907504,
      "userId": 0,
      "imtSupplierId": 0,
      "object": "Джинсы",
      "parent": "Одежда",
      "countryProduction": "Россия",
      "supplierVendorCode": "",
      "addin": [
        {
          "type": "Бренд",
          "params": [
            {
              "value": "ЛОГОС"
            }
          ]
        },
        {
          "type": "Пол",
          "params": [
            {
              "value": "Мужской"
            }
          ]
        },
        {
          "type": "Описание",
          "params": [
            {
              "value": ""
            }
          ]
        },
        {
          "type": "Тнвэд",
          "params": [
            {
              "value": "6203411000"
            }
          ]
        },
        {
          "type": "Состав",
          "params": [
            {
              "value": "хлопок",
              "count": 100,
              "units": "%"
            }
          ]
        },
        {
          "type": "Комплектация",
          "params": [
            {
              "value": "Джинсы - 1 шт"
            }
          ]
        }
      ],
      "nomenclatures": [
        {
          "id": "07a1f28a-a8f7-4501-94ea-ef2bf65eae01",
          "nmId": 25626080,
          "vendorCode": "bluee-123",
          "variations": [
            {
              "id": "8d140bf8-d9ca-4864-857c-01167920b267",
              "chrtId": 59602201,
              "barcode": "2001925979004",
              "addin": [
                {
                  "type": "Размер",
                  "params": [
                    {
                      "value": "56"
                    }
                  ]
                },
                {
                  "type": "Рос. размер",
                  "params": [
                    {
                      "value": "42"
                    }
                  ]
                }
              ],
              "errors": null
            }
          ],
          "addin": [
            {
              "type": "Коллекция",
              "params": [
                {
                  "value": "Базовая коллекция"
                }
              ]
            }
          ]
        }
      ],
      "createdAt": "2021-03-30T15:32:45.39408587Z",
      "updatedAt": "2021-03-30T15:32:45.39408587Z",
      "uploadID": "00000000-0000-0000-0000-000000000000"
    }
  }
}

Обновление карточки.

Create. https://suppliers-api.wildberries.ru/card/update

Описание: метод позволяет обновить одну карточку товара.

Для того чтобы обновить карточку предпочтительнее, запросить её из сервиса методом /card/cardByImtID и в уже полученной структуре менять поля. Пример тела для обновление карточки:

{
  "params": {
    "card": {
      "id": "2d1e2646-ba13-52cd-8bec-3210b8302b7f",
      "imtId": 18907504,
      "countryProduction": "Россия",
      "object": "Джинсы",
      "addin": [
        {
          "type": "Бренд",
          "params": [
            {
              "value": "ЛОГОС"
            }
          ]
        },
        {
          "type": "Комплектация",
          "params": [
            {
              "value": "Джинсы - 1 шт"
            }
          ]
        },
        {
          "type": "Тнвэд",
          "params": [
            {
              "value": "6203411000"
            }
          ]
        },
        {
          "type": "Состав",
          "params": [
            {
              "value": "хлопок перкаль",
              "count": 100
            }
          ]
        },
        {
          "type": "Пол",
          "params": [
            {
              "value": "Мужской"
            }
          ]
        },
        {
          "type": "Ключевые слова",
          "params": [
            {
              "value": "Слово1"
            },
            {
              "value": "слово2"
            }
          ]
        }
      ],
      "nomenclatures": [
        {
          "nmId": 25626080,
          "vendorCode": "bluee-123",
          "variations": [
            {
              "barcode": "2001925979004",
              "chrtId": 59602201,
              "addin": [
                {
                  "type": "Розничная цена",
                  "params": [
                    {
                      "count": 0
                    }
                  ]
                },
                {
                  "type": "Размер",
                  "params": [
                    {
                      "value": "56"
                    }
                  ]
                },
                {
                  "type": "Рос. размер",
                  "params": [
                    {
                      "value": "42"
                    }
                  ]
                }
              ]
            }
          ],
          "addin": [
            {
              "type": "Коллекция",
              "params": [
                {
                  "value": "Базовая коллекция"
                }
              ]
            },
            {
              "type": "Фото",
              "params": []
            },
            {
              "type": "Фото360",
              "params": []
            },
            {
              "type": "Видео",
              "params": []
            }
          ]
        }
      ]
    }
  },
  "jsonrpc": "2.0",
  "id": "e7ba66f5-bdde-48b5-9e14-ea6a285bf57"
}

Ответ:

{"id":"e7ba66f5-bdde-48b5-9e14-ea6a285bf57","jsonrpc":"2.0","result":{}}

Удаление номенклатуры

Метод POST https://suppliers-api.wildberries.ru/card/deleteNomenclature

Описание: метод позволяет удалить номенклатуру из карточки поставщика с указанным ID. Тело запроса выглядит следующим образом:

{
        "id": "1",
        "jsonrpc": "2.0", 
        "params": {
            // Идентификатор номенклатуры. 
            "nomenclatureID": 0  
        }
}

Пример запроса:

POST https://suppliers-api.wildberries.ru/card/deleteNomenclature
Content-Type: application/json
Authorization: {{token}}

{
    "id": "1",
    "jsonrpc": "2.0",
    "params": {
    "nomenclatureID": 12862200
    }
}

Ответ

{
  "id": "1",
  "jsonrpc": "2.0",
  "result": {}
}

List. https://suppliers-api.wildberries.ru/card/list

Описание: метод позволяет получить список карточек по указанным параметрам. Фильтрация позволяет исключить из итогового списка карточек те, в которых указанное поле column содержит значение excludedValues. Поиск позволяет оставить в итоговом списке карточек только те, у которых поле column имеет значение search, если это число, если это строка, то значение поля начинается с search. Сортировка позволяет отсортировать список по полю column в порядке order. query содержит значения limit и offset который указывают соответственно на максимальное количество карточек, которые надо вывести и на количество карточек, которые с самого начала списка нужно пропустить. Наименования полей соответствуют пути до этого поля через точку. Так, например, чтобы добраться до поля barcode, понадобится путь nomenclatures.variations.barcode. Исключения - параметры, лежащие внутри структуры addin. Чтобы добраться до них, требуется в пути после addin через точку указать type этого параметра. Например, чтобы получить бренд, потребуется путь addin.Бренд. Бренд написан с большой буквы, так как type был написан тоже с большой. Тело запроса выглядит следующим образом:

    {
        "id": "1",
        "jsonrpc": "2.0",
        "params": {
            "filter": {
                // Поиск в соответсвии с условиями запроса
                "find": [
                  {
                    "column": "imtId", // поиск по ИМТ id (Доступные поля для поискаописаны ниже )
                    "search": 19247 // значение типа int
                  }
                ],
                // Сортировка по указанному полю в указанном порядке.
                "order": {                                                      
                    "column": "createdAt",
                    "order": "asc"
                }
            },
            // Пагинация. Вывести максимум 10 карточек после пропуска 20. Выведутся карточки с 20 по 30 из тех, которые соотетствуют фильтру.
            "query": {                                                          
                "limit": 10,
                "offset": 20
            },
            "withError": true // параметр указывающий, что вернуться только карточки в которых есть ошибки, которые не удалось создать. Параметр не обязательный, если его не указывать вернуться только созадныне карточки.
        }
    }

В результате вышеприведённого запроса нам вернутся все карточки поставщика 00000000-0000-0000-0000-000000000000, среди которых не будет карточек с красными цветами и джинс, у всех карточек будут товары с размером “M”. И все эти карточки будут отсортированы по дате создания в порядке возрастания (сначала старые).

Поля доступные поля для использования в "find"

{
    "column": "imtId", // поиск по ИМТ id 
    "search": 19247 // значение типа int или массив значений [123,54656,4323]
}
{
    "column": "nomenclatures.nmId", // поиск по NM id
    "search": 19247 // значение типа int или массив значений [123,54656,4323]
}
{
    "column": "nomenclatures.variations.chrtId", // поиск по chrtId
    "search": 60570035 // значение типа int или массив значений [123,54656,4323]
}
{
    "column": "nomenclatures.variations.barcode", // поиск по баркоду
    "search": "2002126418002" // значение типа string или массив значений ["2002126418002","2002126418003"]
}
{
    "column": "nomenclatures.vendorCode", // поиск по артикулу
    "search": "11" // значение типа string или массив значений ["11","12"]
}
{
    "column": "object", // поиск по предмету
    "search": "Кофе молотый" // значение типа string или массив значений ["Кофе молотый","Носки"]
}

Пример запроса:

POST https://suppliers-api.wildberries.ru/card/list
Content-Type: application/json
Authorization: {{token}}

{
  "id": "11",
  "jsonrpc": "2.0",
  "params": {
    "filter": {
      "order": {
        "column": "updatedAt",
        "order": "desc"
      }
    },
    "query": {
      "limit": 1,
      "offset": 0
    }
  }
}

Ответ

{
  "id": "11",
  "jsonrpc": "2.0",
  "result": {
    "cards": [
      {
        "id": "e7ba66f5-bdde-48b5-9e14-ea6a285bf57",
        "imtId": 1403347,
        "userId": 1,
        "imtSupplierId": 8759,
        "object": "Свитшоты",
        "countryProduction": "Китай",
        "supplierVendorCode": "артикулдлясвитшотов",
        "addin": [
          {
            "type": "Состав",
            "params": [
              {
                "value": "хлопок"
              }
            ]
          },
          {
            "type": "Тнвэд",
            "params": [
              {
                "value": "610590900"
              }
            ]
          },
          {
            "type": "Бренд",
            "params": [
              {
                "value": "WB"
              }
            ]
          },
          {
            "type": "Комплектация",
            "params": [
              {
                "value": "Свитшот базовый"
              }
            ]
          },
          {
            "type": "Пол",
            "params": [
              {
                "value": "Женский"
              }
            ]
          },
          {
            "type": "Ключевые слова",
            "params": [
              {
                "value": "Слово1"
              },
              {
                "value": "слово2"
              }
            ]
          }
        ],
        "nomenclatures": [
          {
            "id": "b06b93a5-083a-4d74-80f9-83e140be2f",
            "nmId": 1889397,
            "photos": [],
            "vendorCode": "синий",
            "variations": [
              {
                "id": "f572767f-1fd3-4409-99df-a314fda22b",
                "chrtId": 5082952,
                "barcode": "2001114123800",
                "addin": [
                  {
                    "type": "Розничная цена",
                    "params": [
                      {
                        "count": 50000
                      }
                    ]
                  },
                  {
                    "type": "Размер",
                    "params": [
                      {
                        "value": "44"
                      }
                    ]
                  },
                  {
                    "type": "Рос. размер",
                    "params": [
                      {
                        "value": "32"
                      }
                    ]
                  }
                ],
                "errors": []
              }
            ],
            "photoStatus": "",
            "status": "",
            "addin": [
              {
                "type": "Фото",
                "params": [
                  {
                    "value": "https://img1.wildberries.ru/big/new/18890000/18890000-1.jpg"
                  }
                ]
              },
              {
                "type": "Фото360",
                "params": []
              },
              {
                "type": "Видео",
                "params": []
              }
            ]
          }
        ],
        "createdAt": "2021-01-27T11:44:11.322Z",
        "updatedAt": "2021-01-27T11:44:11.322Z"
      }
    ],
    "cursor": {
      "total": 1000,
      "limit": 1,
      "offset": 0
    }
  }
}

Генерация ШК для карточки.

Для того чтобы сгенерировать шк для размера требуется вызвать метод:

GetBarcodes. https://suppliers-api.wildberries.ru/card/getBarcodes

Описание: генерации ШК для размера Тело запроса выглядит следующим образом:

   {
        "id": "{{uuid}}", // uuid запроса
        "jsonrpc": "2.0", 
        "params": {
            // Количество ШК которые необходимо сгенерировать
            "quantity": 1
        }
    }

Пример ответа:

{
  "id": "deb3a313-c168-4e2a-bb9f-b126e185c3bb",
  "jsonrpc": "2.0",
  "result": {
    "barcodes": [
      "2000429418026"
    ]
  }
}

Описание процесса загрузки файлов

Для работы с запросами требуется пройти аутентификацию пользователя.

Files. https://suppliers-api.wildberries.ru/card/upload/file/multipart

Заголовок должен содержать следующее поля:

  • X-File-ID – сгенерированный идентификатор файла в формате uuid v4, его в дальнейшем и надо передавать в карточку товара. Идентификатор поставщик генерирует своими силами.
  • Authorization – токен полученный в личном кабинете (пример WBToken=AvvYxgfMn7P0C8zCuPQLQhkkkt-C…)

Время жизни файла во временном хранилище не более 2 суток, после этого он автоматически удалится

В тело запроса передаётся файл. Пример запроса:

POST https://suppliers-api.wildberries.ru/card/upload/file/multipart
Authorization: {{token}}
Content-Type: multipart/form-data; boundary=boundaryImage
X-File-Id: 00000000-0000-0000-0000-000000000001

--boundaryImage
Content-Disposition: form-data; name="uploadfile"; filename="photo.jpg"

bytes photo.jpg
--boundaryImage--

Пример CURL запроса который можно использовать для загрузки файла:

$ curl -X POST --location "https://suppliers-api.wildberries.ru/upload/file/multipart" \
    -H "Authorization: {{token}}" \
    -H "X-File-id: 00000000-0000-0000-0000-000000000001" \
    -H "Content-Type: multipart/form-data; boundary=img" \
    -F "uploadfile=@Downloads/photo.jpg;filename=photo.jpg;type=*/*"

Добавление файла в карточку товара

Для добавления файла надо создать или обновить карточку товара

Create. https://suppliers-api.wildberries.ru/card/create

{
  "id": "8a41f7a8-6ed1-4910-bbd3-ac83e214ec8e",
  "jsonrpc": "2.0",
  "params": {
    "card": {
      "object": "Мячики",
      "countryProduction": "Россия",
      "supplierVendorCode": "svc-100",
      "nomenclatures": [
        {
          "vendorCode": "test-with-photo",
          "variations": [
            {
              "barcode": "4603374564721",
              "addin": [
                {
                  "type": "Размер",
                  "params": [
                    {
                      "value": "4"
                    }
                  ]
                },
                {
                  "type": "Розничная цена",
                  "params": [
                    {
                      "count": 70000,
                      "units": "рублей"
                    }
                  ]
                }
              ]
            }
          ],
          "addin": [
           {
            "type": "Фото",
            "params": [
             {
              "value": "e3ee6410-a09b-4dfe-a84b-ce8946abc521",
              "units": "images/jpeg"
             }
            ]
           },
            {
              "type": "Основной цвет",
              "params": [
                {
                  "value": "Синий"
                }
              ]
            }
          ]
        }
      ],
      "addin": [
        {
          "type": "Бренд",
          "params": [
            {
              "value": "adidas"
            }
          ]
        },
        {
          "type": "Описание",
          "params": [
            {
              "value": "Описание"
            }
          ]
        },
        {
          "type": "Пол",
          "params": [
            {
              "value": "Мужской"
            }
          ]
        },
        {
          "type": "Ключевые слова",
          "params": [
            {
              "value": "Слово1"
            },
            {
              "value": "слово2"
            }
          ]
        },
        {
          "type": "Материал изделия",
          "params": [
            {
              "value": "Полиуретан"
            }
          ]
        }
      ]
    }
  }
}

После синхронизаций с системами фото удаляется из хранилища и перемещается на CDN в связи с этим меняется секция:

           {
            "type": "Фото",
            "params": [
             {
              "value": "e3ee6410-a09b-4dfe-a84b-ce8946abc521",
              "units": "images/jpeg"
             }
            ]
           },

На подобную:

{
              "type": "Фото",
              "params": [
                {
                  "value": "https://img1.wildberries.ru/big/new/17640000/17620024-1.jpg"
                }
              **]
}

Добавление файла со стороннего ресурса в карточку товара

Для добавления файла надо создать или обновить карточку товара

Create. https://suppliers-api.wildberries.ru/card/create

Для добавления медиафайла со стороннего ресурса необходимо добавить в номенклатуру

"addin": [
    {
        "type": "Фото",
        "params": [
         {
          "value": "http://images.wbstatic.net/c516x688/new/13190000/13194759-1.jpg",
         }
        ]
    },
    {
        "type": "Фото360",
        "params": [
         {
          "value": "http://images.wbstatic.net/c516x688/new/13190000/13194759-1.jpg",
         }
        ]
    },
    {
        "type": "Видео",
        "params": [
         {
          "value": "http://images.wbstatic.net/c516x688/new/13190000/13194759-1.mp4",
         }
        ]
    }
]

{
  "id": "8a41f7a8-6ed1-4910-bbd3-ac83e214ec8e",
  "jsonrpc": "2.0",
  "params": {
    "card": {
      "object": "Мячики",
      "countryProduction": "Россия",
      "supplierVendorCode": "svc-100",
      "nomenclatures": [
        {
          "vendorCode": "test-with-photo",
          "variations": [
            {
              "barcode": "4603374564721",
              "addin": [
                {
                  "type": "Размер",
                  "params": [
                    {
                      "value": "4"
                    }
                  ]
                },
                {
                  "type": "Розничная цена",
                  "params": [
                    {
                      "count": 70000,
                      "units": "рублей"
                    }
                  ]
                }
              ]
            }
          ],
          "addin": [
           {
            "type": "Фото",
            "params": [
             {
              "value": "http://images.wbstatic.net/c516x688/new/13190000/13194759-1.jpg",
             }
            ]
           },
            {
              "type": "Основной цвет",
              "params": [
                {
                  "value": "Синий"
                }
              ]
            }
          ]
        }
      ],
      "addin": [
        {
          "type": "Бренд",
          "params": [
            {
              "value": "adidas"
            }
          ]
        },
        {
          "type": "Описание",
          "params": [
            {
              "value": "Описание"
            }
          ]
        },
        {
          "type": "Пол",
          "params": [
            {
              "value": "Мужской"
            }
          ]
        },
        {
          "type": "Ключевые слова",
          "params": [
            {
              "value": "Слово1"
            },
            {
              "value": "слово2"
            }
          ]
        },
        {
          "type": "Материал изделия",
          "params": [
            {
              "value": "Полиуретан"
            }
          ]
        }
      ]
    }
  }
}

Сервис конфигурации предметов и характеристик объекта.

Требуется для того чтобы сконфигурировать карточку товара

Список всех методов доступен по адресу https://suppliers-api.wildberries.ru/swagger/index.html

Поиск ключа объекта

Для осуществления поиска ключа следует выполнить GET запрос например: https://suppliers-api.wildberries.ru/api/v1/config/get/object/list?pattern=игр В полученном ответе требуется обратить внимание на столбик с названиями на русском языке. Именно они являются названиями категорий товаров и должны использоваться при создании карточек в поле object.

{
  "additionalErrors": null,
  "data": {
    "Toy phones": "Игровые телефоны",
    "Pet toys": "Игрушки для животных",
    "Bathroom toys": "Игрушки для ванной",
    "Play mats": "Игровые коврики",
    "Toy food": "Игрушечные продукты",
    "Play sets": "Игровые наборы",
    "Toys for adults": "Игрушки для взрослых",
    "Toy kitchenware": "Игрушечная посуда",
    "Game tents": "Игровые палатки",
    "Baby crib mobiles": "Игрушки-подвески",
    "Toy parking": "Игрушечные парковки",
    "Toy garages": "Игрушечные гаражи",
    "Games (digital content)": "Игры (цифровой контент)",
    "Antistress toys": "Игрушки антистресс",
    "Toy arms": "Игрушечное оружие",
    "Toy musical instruments": "Игрушечные музыкальные инструменты",
    "Game consoles": "Игровые консоли",
    "Toy vehicles": "Игровая техника",
    "Toys": "Игрушки-дергунчики",
    "Toy instruments": "Игрушечные инструменты",
    "Cat game furniture": "Игровые комплексы для кошек",
    "Baby game centers": "Игровые центры для малышей"
  },
  "error": false,
  "errorText": ""
}

Получение списка доступных справочников

Метод GET https://suppliers-api.wildberries.ru/api/v1/directory/get/list

{
  "additionalErrors": null,
  "data": {
    "/options": 5599,
    "/wbsizes": 70758,
    "/si": 123,
    "/countries": 254,
    "/seasons": 33,
    "/consists": 11280,
    "/brands": 102895,
    "/factories": 142690,
    "/ext": 313208,
    "/colors": 372,
    "/kinds": 7,
    "/collections": 69,
    "/contents": 10009,
    "/tech-sizes": 124391
  },
  "error": false,
  "errorText": ""
}

Получение ТНВЭД

GET https://suppliers-api.wildberries.ru/api/v1/directory/tnved?subject=%D0%9C%D0%B0%D1%81%D0%BB%D0%B0
Authorization: {{token}}

Получение данных справочника

Пример получения значения из справочника "/options", для получения данных следует выполнить GET запрос: https://suppliers-api.wildberries.ru/api/v1/directory/options?pattern=Ширина&top=10 Как и в случае с категориями товаров, из ответа данного запроса требуется извлечь поля translate и использовать для создания карточки.

{
  "additionalErrors": null,
  "data": [
    {
      "key": "Processing width",
      "translate": "Ширина обработки"
    },
    {
      "key": "Strap width",
      "translate": "Ширина ремешка"
    },
    {
      "key": "Curtain width",
      "translate": "Ширина штор"
    },
    {
      "key": "Working area width",
      "translate": "Ширина рабочей площади"
    },
    {
      "key": "Finished model width",
      "translate": "Ширина готовой модели"
    },
    {
      "key": "Work surface width",
      "translate": "Ширина рабочей поверхности"
    },
    {
      "key": "Neck Width",
      "translate": "Ширина грифа"
    },
    {
      "key": "Installed Tent Width",
      "translate": "Ширина установленной палатки"
    },
    {
      "key": "Kerf width",
      "translate": "Ширина пропила"
    },
    {
      "key": "Frame width",
      "translate": "Ширина оправы"
    }
  ],
  "error": false,
  "errorText": ""
}

Получение всех данных справочника

Пример получения значения из справочника "/options", для получения данных следует выполнить GET запрос: https://suppliers-api.wildberries.ru/api/v1/directory/options?lang=ru&top=10

{
  "additionalErrors": null,
  "data": [
    {
      "key": "Picture painting",
      "translate": "Рисунок картины"
    },
    {
      "key": "Filter view",
      "translate": "Вид фильтра"
    },
    {
      "key": "Number of rolls",
      "translate": "Количество рулонов"
    },
    {
      "key": "Installation furnaces",
      "translate": "Печи по установке"
    },
    {
      "key": "Minimum staple size",
      "translate": "Минимальный размер скоб"
    },
    {
      "key": "Type of constructor",
      "translate": "Тип конструктора"
    },
    {
      "key": "MKL diameter",
      "translate": "Диаметр МКЛ"
    },
    {
      "key": "Number of stations",
      "translate": "Количество станций"
    },
    {
      "key": "Print Resolution (Color)",
      "translate": "Разрешение печати (цветная)"
    }
  ],
  "error": false,
  "errorText": ""
}

Полный пример создания карточки с учётом всех справочников

{
 "params": {
  "card": [
   {
    "countryProduction": "Россия",
    "supplierVendorCode": "qwe-112",
    "object": "Куртки",
    "addin": [
     {
      "type": "Состав",
      "params": [
       {
        "value": "Кожа и текстиль",
        "count": 100
       }
      ]
     },
     {
      "type": "Тнвэд",
      "params": [
       {
        "value": "6101209000"
       }
      ]
     },
     {
      "type": "Бренд",
      "params": [
       {
        "value": "SNOB ARMY"
       }
      ]
     },
     {
      "type": "Комплектация",
      "params": [
       {
        "value": "куртка"
       }
      ]
     },
     {
      "type": "Пол",
      "params": [
       {
        "value": "Мужской"
       }
      ]
     },
     {
      "type": "Описание",
      "params": [
       {
        "value": "Описание"
       }
      ]
     },
      {
        "type": "Ключевые слова",
        "params": [
          {
            "value": "Слово1"
          },
          {
            "value": "слово2"
          }
        ]
      }
    ],
    "nomenclatures": [
     {
      "vendorCode": "black-123",
      "variations": [
       {
        "barcode": "2001092382003",
        "addin": [
         {
          "type": "Розничная цена",
          "params": [
           {
            "count": 17000
           }
          ]
         },
         {
          "type": "Размер",
          "params": [
           {
            "value": "56"
           }
          ]
         },
         {
          "type": "Рос. размер",
          "params": [
           {
            "value": "56"
           }
          ]
         }
        ]
       }
      ],
      "addin": [
       {
        "type": "Основной цвет",
        "params": [
         {
          "value": "черный"
         }
        ]
       },
       {
        "type": "Коллекция",
        "params": [
         {
          "value": "Осень-Зима 2021-2022"
         }
        ]
       },
       {
        "type": "Фото",
        "params": []
       },
       {
        "type": "Фото360",
        "params": []
       },
       {
        "type": "Видео",
        "params": []
       }
      ]
     }
    ]
   }
  ]
 },
 "jsonrpc": "2.0",
 "id": "8a41f7a8-6ed1-4910-bbd3-ac83e214ec81"
}
Clone this wiki locally