Создание карточек товаров с присоединением

POST /content/v2/cards/upload/add

База: https://content-api.wildberries.ru · Модуль: items · Раздел: Создание карточек товаров · Документация спецификации ↗

Метод создаёт карточки товаров, присоединяя их к существующим отдельным карточкам и группам объединённых карточек. В одной группе объединённых карточек товаров может быть не более 30 карточек, соответственно, создать с присоединением можно не более 29 карточек товаров за один запрос. Габариты товаров можно указать только в сантиметрах, вес товара с упаковкой — в килограммах.

Если ответ Успешно (200), но какие-то карточки не создались, проверьте список несозданных карточек товаров. Создание карточки товара происходит асинхронно. Синхронизация новой карточки с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. В песочнице карточка товара создаётся сразу, без ожидания.

Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса documents. Чтобы подтвердить, что для товара не требуются документы, передайте true в параметре excludeDocuments. Проверка документов выполняется асинхронно и может занимать до 3 дней. При изменении карточки или документа проверка запускается повторно. Результаты проверки отображаются в списке карточек товаров, объект documents:

• результат по каждому документу в полях verdict объекта items. Если verdict не возвращается в ответе — проверка документа ещё не завершена
• итоговый общий результат по карточке в поле overallVerdict. При общей проверке карточки учитываются не только результаты проверки документов, но и другие данные. Например, наличие обязательной маркировки и сведения из внешних реестров. Если overallVerdict не возвращается в ответе — проверка карточки ещё не завершена

Типы документов, которые вы можете добавить для товара, указаны в характеристиках предмета.

При этом не все документы, которые вы можете добавить, обязательны и проходят проверку — вы самостоятельно определяете, какие разрешительные документы требуются для товара в соответствии с законодательством.

Лимит запросов на один профиль продавца:

Тип	Период	Лимит	Интервал	Всплеск
Персональный	1 мин	10 запросов	6 сек	5 запросов
Сервисный	1 мин	10 запросов	6 сек	5 запросов
Базовый с секретом	1 мин	10 запросов	6 сек	5 запросов
Базовый	2 ч	1 запрос	2 ч	1 запрос

Тело запроса

application/json — схема object, необязательно

• imtID integer<int64> — imtID отдельной карточки товара или группы объединённых карточек товаров, к которой присоединяются создаваемые карточки
• cardsToAdd object[] — Добавляемые карточки товаров
  • brand string — Бренд
  • vendorCode string (обязательно) — Артикул продавца
  • kizMarked boolean — Подтверждение, что на товар нанесён обязательный код маркировки Честного знака: - true — продавец подтверждает, что на товар нанесён обязательный код маркировки - false — продавец не подтверждает, что на товар нанесён обязательный код маркировки. Передайте в запросе true, чтобы подтвердить наличие на товаре обязательного кода маркировки. Карточка товара не пройдёт проверку, если нет подтверждения продавца о том, что обязательный код маркировки нанесён на товар Чтобы проверить, является ли код маркировки Честного знака обязательным, используйте метод Список карточек товаров, поле ответа needKiz
  • wholesale object — B2B-продажа
    • enabled boolean — Предназначен ли товар для продажи только B2B-покупателям: - true — товар предназначен для продажи только B2B-покупателям - false — товар предназначен для продажи B2B и B2C-покупателям
    • quantum number<uint64> — Минимальное количество единиц товара в одной корзине B2B-покупателя. Только при "enable":true
  • title string — Наименование товара
  • gtin string — Дополнительный GTIN. Укажите этот параметр, если тот же GTIN вы ранее указывали в одной из карточек товара в параметре skus. Нельзя указывать один и тот же GTIN в skus для разных карточек или размеров товаров. Только для продавцов из РФ
  • description string — Описание товара. Максимальное количество символов зависит от категории товара Стандарт — 2000, минимум — 1000, максимум — 5000 Подробно о **правилах заполнения карточки товара** в Справочном центре на портале продавцов
  • dimensions object — Габариты и вес товара **c упаковкой**. Укажите в сантиметрах и килограммах для любого товара. Если данные не указаны, автоматически сгенерируются нулевые значения длины, ширины, высоты и веса. Синхронизация данных с сервисом может занимать до 30 минут
    • length integer<int64> — Длина, см
    • width integer<int64> — Ширина, см
    • height integer<int64> — Высота, см
    • weightBrutto number — Вес, кг Количество знаков после запятой <=3
  • sizes object[] — Массив размеров. Если не указать для размерного товара (обувь, одежда и др.), сгенерируется автоматически с techSize = "A", wbSize = "1" и баркодом
    • techSize string — Размер товара (например, XL, 45)
    • wbSize string — Российский размер товара
    • price integer<int64> — Цена товара
    • skus string[] — Баркод. Если не указать, сгенерируется автоматически
  • characteristics object[] — Характеристики товара. Можно получить методом Характеристики предмета
    • id integer<int64> (обязательно) — ID характеристики
    • value object (обязательно) — Значения характеристики. Тип данных — массив строк или число — зависит от типа характеристики, см. описание поля charcType в методе Характеристики предмета. Допустимое количество значений отображено в поле maxCount того же метода
  • documents object — Документы
    • items documentsRequest[] — Список разрешительных документов и их данные. Тип документа type обязателен для каждого документа
      • type integer<int64> — Тип документа. Типы документов, которые вы можете добавить для товара, указаны в характеристиках предмета — поле charcID. Возможные типы документов: - 1 — Сертификат соответствия. Можно указать для charcID: 15001136, 15001137, 15001138 - 2 — Декларация о соответствии. Можно указать для charcID: 15001135, 15001137, 15001138 - 3 — Свидетельство о государственной регистрации (СГР). Можно указать для charcID: 62945173, 15000785, 15004302 - 4 — Регистрационное удостоверение (РУ) на медицинские изделия. Можно указать для charcID: 15001574, 15002355, 15002356, 15002357 - 5 — Регистрационное удостоверение Республики Беларусь. Можно указать для charcID: 15003071, 15003939 - 7 — Данные о регистрации пестицида. Можно указать для charcID: 15003924, 15003925 - 8 — Данные о регистрации агрохимиката. Можно указать для charcID: 15003920, 15003921 - 9 — Регистрационное удостоверение (РУ) на лекарственные препараты. Можно указать для charcID: 1897013, 15004284
      • number string — Номер документа
      • productNumber string — Дополнительный номер документа
      • tradeName string — Торговое наименование
      • applicant string — Представитель изготовителя медицинского изделия
      • startDate string — Дата и время начала срока действия документа
      • endDate string — Дата и время окончания срока действия документа
      • isEndless boolean — Бессрочный ли документ: - true — да, документ бессрочный - false — нет, у документа есть срок действия
    • excludeDocuments boolean — Подтверждение продавца, что для товара не требуются разрешительные документы: - true — продавец подтверждает, что документы не требуются. Все значения, переданные в documents, будут заменены на пустые значения - false — продавец не подтверждает, что документы не требуются Обязательность документов проверяется при создании и изменении карточки товара. Если для товара требуются документы и указано значение true, карточка не пройдёт проверку

Ответы

Код	Описание	Схема
200	Успешно	responseItemList
400	Неправильный запрос	responseBodyContentError400
401	Не авторизован	object
402	Требуется платёж	object
403	Доступ запрещён	object
413	Превышен лимит объёма данных в запросе	PostV2CardsUploadAddResponse413
429	Слишком много запросов	object

Структура 200:

• data object — Данные ответа
• error boolean — Флаг ошибки
• errorText string — Описание ошибки
• additionalErrors object — Дополнительные ошибки
  • один из вариантов: object, string, object

Структура 400:

• data object — Данные ошибки
• error boolean — Флаг ошибки
• errorText string — Описание ошибки
• additionalErrors object — Дополнительные ошибки

Структура 401:

• title string — Заголовок ошибки
• detail string — Детали ошибки
• code string — Внутренний код ошибки
• requestId string — Уникальный ID запроса
• origin string — ID внутреннего сервиса WB
• status number — HTTP статус-код
• statusText string — Расшифровка HTTP статус-кода
• timestamp string — Дата и время запроса

Структура 402:

• title string — Заголовок ошибки
• detail string — Детали ошибки. Ошибка возвращается только сервисам из Каталога решений для бизнеса

Структура 403:

• title string — Заголовок ошибки
• detail string — Детали ошибки
• code string — Внутренний код ошибки
• requestId string — ID запроса
• origin string — ID внутреннего сервиса WB
• status number — HTTP статус-код
• statusText string — Расшифровка HTTP статус-кода
• timestamp string — Дата и время запроса

Структура 413:

• title string — Заголовок ошибки
• detail string — Детали ошибки
• code string — Внутренний код ошибки
• requestId string — Уникальный ID запроса
• origin string — ID внутреннего сервиса WB
• status number — HTTP статус-код
• statusText string — Расшифровка HTTP статус-кода

Структура 429:

• title string — Заголовок ошибки
• detail string — Детали ошибки
• code string — Внутренний код ошибки
• requestId string — Уникальный ID запроса
• origin string — ID внутреннего сервиса WB
• status number — HTTP статус-код
• statusText string — Расшифровка HTTP статус-кода
• timestamp string — Дата и время запроса

Примеры вызова

Аргументы показаны именами параметров — подставьте свои значения. Языки, в клиенте которых этой операции нет, не показаны.

Python

from wb_api_client.items import Configuration, ApiClient
from wb_api_client.items.api import ItemsApi

cfg = Configuration(access_token="<ваш JWT WB>")
api = ItemsApi(ApiClient(cfg))

result = api.post_v2_cards_upload_add(post_v2_cards_upload_add_request=...)
print(result)

TypeScript

import {
  Configuration,
  ItemsApi,
} from "@valeryverkhoturov/wb-api-client/items";

const cfg = new Configuration({});
cfg.setAccessToken("<ваш JWT WB>");
const api = new ItemsApi(cfg);

const { data } = await api.postV2CardsUploadAdd(postV2CardsUploadAddRequest);
console.log(data);

Go

import (
	"context"
	"fmt"

	wbitems "github.com/ValeryVerkhoturov/wb-api-client-go/items"
)

cfg := wbitems.NewConfiguration()
cfg.SetAccessToken("<ваш JWT WB>")
client := wbitems.NewAPIClient(cfg)

result, _, err := client.ItemsAPI.PostV2CardsUploadAdd(context.Background()).Execute()
if err != nil {
    panic(err)
}
fmt.Printf("%+v\n", result)

Java

import io.github.valeryverkhoturov.wbapi.items.ApiClient;
import io.github.valeryverkhoturov.wbapi.items.SecretString;
import io.github.valeryverkhoturov.wbapi.items.api.ItemsApi;

ApiClient client = new ApiClient();
client.setAccessToken(new SecretString("<ваш JWT WB>"));
ItemsApi api = new ItemsApi(client);

System.out.println(api.postV2CardsUploadAdd(postV2CardsUploadAddRequest));

PHP

use ValeryVerkhoturov\WbApiClient\Items\Configuration;
use ValeryVerkhoturov\WbApiClient\Items\SecretString;
use ValeryVerkhoturov\WbApiClient\Items\Api\ItemsApi;
use GuzzleHttp\Client;

$config = (new Configuration())
    ->setAccessTokenSecret(new SecretString('<ваш JWT WB>'));
$api = new ItemsApi(new Client(), $config);

print_r($api->postV2CardsUploadAdd());

OneScript

#Использовать "wb-api-client"

Настройки = Новый Конфигурация();
Настройки.УстановитьТокен("<ваш JWT WB>");
Клиент = Новый ItemsApi(Настройки);

Сообщить(Клиент.PostV2CardsUploadAdd(Тело).Тело);

C#

using ValeryVerkhoturov.WbApiClient.Items.Api;
using ValeryVerkhoturov.WbApiClient.Items.Client;

var config = new Configuration();
config.AccessTokenSecret = new SecretString("<ваш JWT WB>");
var api = new ItemsApi(config);

Console.WriteLine(api.PostV2CardsUploadAdd());

Rust

use wb_api_client::items::apis::{configuration::Configuration, items_api};

#[tokio::main]
async fn main() {
    let mut cfg = Configuration::new();
    cfg.set_access_token("<ваш JWT WB>");

    let result = items_api::post_v2_cards_upload_add(&cfg, post_v2_cards_upload_add_request).await;
    println!("{:#?}", result);
}