В этом руководстве рассматривается метод API Wildberries, который позволяет продавцам эффективно добавлять новую номенклатуру (НМ) к существующей карточке товара (КТ). Этот метод, доступный по адресу https://suppliers-api.wildberries.ru/content/v2/cards/upload/add, является ключевым инструментом для управления ассортиментом на платформе Wildberries и представляет собой асинхронный процесс, гарантирующий гибкость и удобство для продавцов.
Основные особенности метода
Асинхронное добавление: Отправка запроса на добавление новой номенклатуры к карточке товара инициирует асинхронную обработку, благодаря чему запросы обрабатываются поочерёдно, минимизируя задержки и ускоряя процесс интеграции.
Обработка ошибок: В случае, если после отправки запроса новая номенклатура не была успешно создана, важно проверить раздел "Список несозданных НМ с ошибками" в панели управления. Это позволяет быстро идентифицировать и устранить возникшие проблемы, повторно отправив запрос с исправлениями.
Требования к авторизации
Для использования метода необходимо обеспечить соответствующие авторизационные данные. В частности, требуется использование HeaderApiKey для подтверждения прав на выполнение операций добавления номенклатуры.
Формат запроса
Запрос должен быть сформирован в формате JSON и содержать следующие ключевые элементы:
imtID: Идентификатор карточки товара (КТ), к которой будет добавлена новая номенклатура. Это поле представляет собой целое число и является обязательным для указания в запросе.
cardsToAdd: Массив объектов, каждый из которых описывает структуру добавляемой новой номенклатуры. Это позволяет детализировать информацию о каждом добавляемом элементе, обеспечивая точность и эффективность процесса.
Давайте разберём пример использования API-метода для добавления новой номенклатуры к карточке товара на Wildberries. Этот пример показывает, как формируется запрос для добавления одной или нескольких новых номенклатур к уже существующей карточке товара.
Пример запроса на добавление новой номенклатуры
Предположим, у вас есть карточка товара с идентификатором (imtID) 123456, к которой вы хотите добавить две новые номенклатуры. Ваш запрос к API может выглядеть следующим образом:
POST /content/v2/cards/upload/add
Host: suppliers-api.wildberries.ru
Authorization: HeaderApiKey <Ваш API-ключ>
Content-Type: application/json
{
"imtID": 123456,
"cardsToAdd": [
{
"productName": "Толстовка мужская синяя",
"brand": "BestBrand",
"country": "Россия",
"composition": "Хлопок 100%",
"size": "M",
"color": "Синий",
"barcode": "1234567890123"
},
{
"productName": "Джинсы женские классические",
"brand": "FashionLine",
"country": "Турция",
"composition": "Деним",
"size": "S",
"color": "Черный",
"barcode": "1234567890456"
}
]
}
Объяснение компонентов запроса
imtID: Указывает на идентификатор карточки товара, к которой вы хотите добавить новые номенклатуры.
cardsToAdd: Массив, содержащий один или несколько объектов, каждый из которых описывает добавляемую номенклатуру. Для каждой номенклатуры вы должны указать:
productName: Название товара.
brand: Бренд товара.
country: Страна производства.
composition: Состав товара.
size: Размер товара.
color: Цвет товара.
barcode: Штрихкод товара.
Примечание
Важно помнить, что добавление номенклатуры к карточке товара происходит асинхронно. Это означает, что после отправки запроса он поступит в очередь на обработку, и может потребоваться некоторое время для отображения новых номенклатур в каталоге на платформе Wildberries.
Также, если после отправки запроса вы обнаружите, что номенклатура не была добавлена, рекомендуется проверить раздел "Список несозданных НМ с ошибками" в вашем аккаунте на Wildberries для выявления и устранения возможных ошибок.
Этот пример показывает, как продавцы могут использовать API Wildberries для эффективного расширения и обновления своего ассортимента, улучшая тем самым управление товарами и предлагая покупателям широкий выбор качественных товаров.
Преимущества для продавцов на Wildberries
Использование данного API-метода предоставляет продавцам на платформе Wildberries ряд важных преимуществ, включая упрощение процесса расширения ассортимента, повышение оперативности обновления информации о товарах и минимизацию времени на обработку запросов. Эти аспекты способствуют более эффективному управлению каталогом товаров и укреплению позиций продавца на рынке.
Оптимизируя свои операции с помощью API Wildberries, продавцы могут достичь более высокой производительности и конкурентоспособности, обеспечивая при этом лучший опыт для своих клиентов.