--- title: "Создание карточек товаров с присоединением" description: "Метод создаёт карточки товаров, присоединяя их к существующим отдельным карточкам и группам объединённых карточек. В одной группе объединённых карточек товаров…" lang: ru-RU source: https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/items/post-content-v2-cards-upload-add --- # Создание карточек товаров с присоединением ```http POST /content/v2/cards/upload/add ``` **База:** `https://content-api.wildberries.ru` · **Модуль:** [`items`](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/items/) · **Раздел:** Создание карточек товаров · [Документация спецификации ↗](https://dev.wildberries.ru/en/docs/openapi/item-management#tag/listingItems/operation/postV2CardsUploadAdd) Метод создаёт карточки товаров, присоединяя их к существующим отдельным карточкам и группам [объединённых](https://dev.wildberries.ru/knowledge-base/articles/019d49a4-1320-71bb-9dac-8ba07e7177ce/rabota-s-tovarami#obuedinenie-i-razuedinenie-kartochek-tovarov) карточек. В одной группе объединённых карточек товаров может быть не более 30 карточек, соответственно, создать с присоединением можно не более 29 карточек товаров за один запрос. Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Если ответ `Успешно` (`200`), но какие-то карточки не создались, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Создание карточки товара происходит асинхронно. Синхронизация новой карточки с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. В песочнице карточка товара создаётся сразу, без ожидания. Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса `documents`. Чтобы подтвердить, что для товара не требуются документы, передайте `true` в параметре `excludeDocuments`. Проверка документов выполняется асинхронно и может занимать до 3 дней. При изменении карточки или документа проверка запускается повторно. Результаты проверки отображаются в [списке карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsList), объект `documents`: - результат по каждому документу в полях `verdict` объекта `items`. Если `verdict` не возвращается в ответе — проверка документа ещё не завершена - итоговый общий результат по карточке в поле `overallVerdict`. При общей проверке карточки учитываются не только результаты проверки документов, но и другие данные. Например, наличие обязательной маркировки и сведения из внешних реестров. Если `overallVerdict` не возвращается в ответе — проверка карточки ещё не завершена Типы документов, которые вы можете добавить для товара, указаны в [характеристиках предмета](https://dev.wildberries.ru/openapi/item-management#tag/categoriesSubcategoriesAndCharacteristics/operation/getV2ObjectCharcsSubjectId). При этом не все документы, которые вы можете добавить, обязательны и проходят проверку — вы самостоятельно определяете, какие разрешительные документы требуются для товара в соответствии с законодательством. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один профиль продавца: | Тип | Период | Лимит | Интервал | Всплеск | | ------------------ | ------ | ----------- | -------- | ---------- | | Персональный | 1 мин | 10 запросов | 6 сек | 5 запросов | | Сервисный | 1 мин | 10 запросов | 6 сек | 5 запросов | | Базовый с секретом | 1 мин | 10 запросов | 6 сек | 5 запросов | | Базовый | 2 ч | 1 запрос | 2 ч | 1 запрос | ## Тело запроса `application/json` — схема `object`, необязательно - `imtID` `integer` — `imtID` отдельной карточки товара или группы [объединённых](https://dev.wildberries.ru/knowledge-base/articles/019d49a4-1320-71bb-9dac-8ba07e7177ce/rabota-s-tovarami#obuedinenie-i-razuedinenie-kartochek-tovarov) карточек товаров, к которой присоединяются создаваемые карточки - `cardsToAdd` `object[]` — Добавляемые карточки товаров - `brand` `string` — Бренд - `vendorCode` `string` (обязательно) — Артикул продавца - `kizMarked` `boolean` — Подтверждение, что на товар нанесён обязательный код маркировки [Честного знака](https://честныйзнак.рф/): - `true` — продавец подтверждает, что на товар нанесён обязательный код маркировки - `false` — продавец не подтверждает, что на товар нанесён обязательный код маркировки. Передайте в запросе `true`, чтобы подтвердить наличие на товаре обязательного кода маркировки. Карточка товара не пройдёт проверку, если нет подтверждения продавца о том, что обязательный код маркировки нанесён на товар Чтобы проверить, является ли код маркировки [Честного знака](https://честныйзнак.рф/) обязательным, используйте метод [Список карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsList), поле ответа `needKiz` - `wholesale` `object` — B2B-продажа - `enabled` `boolean` — Предназначен ли товар для продажи только B2B-покупателям: - `true` — товар предназначен для продажи только B2B-покупателям - `false` — товар предназначен для продажи B2B и B2C-покупателям - `quantum` `number` — Минимальное количество единиц товара в одной корзине B2B-покупателя. Только при `"enable":true` - `title` `string` — Наименование товара - `gtin` `string` — Дополнительный GTIN. Укажите этот параметр, если тот же GTIN вы ранее указывали в одной из карточек товара в параметре `skus`. Нельзя указывать один и тот же GTIN в `skus` для разных карточек или размеров товаров. Только для продавцов из РФ - `description` `string` — Описание товара. Максимальное количество символов зависит от категории товара Стандарт — 2000, минимум — 1000, максимум — 5000 Подробно о \*\*правилах заполнения карточки товара\*\* в [Справочном центре](https://seller.wildberries.ru/instructions/ru/ru/material/how-to-create-card) на портале продавцов - `dimensions` `object` — Габариты и вес товара \*\*c упаковкой\*\*. Укажите в `сантиметрах` и `килограммах` для любого товара. Если данные не указаны, автоматически сгенерируются нулевые значения длины, ширины, высоты и веса. Синхронизация данных с сервисом может занимать до 30 минут - `length` `integer` — Длина, см - `width` `integer` — Ширина, см - `height` `integer` — Высота, см - `weightBrutto` `number` — Вес, кг Количество знаков после запятой <=3 - `sizes` `object[]` — Массив размеров. Если не указать для размерного товара (обувь, одежда и др.), сгенерируется автоматически с `techSize` = "A", `wbSize` = "1" и баркодом - `techSize` `string` — Размер товара (например, XL, 45) - `wbSize` `string` — Российский размер товара - `price` `integer` — Цена товара - `skus` `string[]` — Баркод. Если не указать, сгенерируется автоматически - `characteristics` `object[]` — Характеристики товара. Можно получить методом [Характеристики предмета](https://dev.wildberries.ru/openapi/item-management#tag/categoriesSubcategoriesAndCharacteristics/operation/getV2ObjectCharcsSubjectId) - `id` `integer` (обязательно) — ID характеристики - `value` `object` (обязательно) — Значения характеристики. Тип данных — массив строк или число — зависит от типа характеристики, см. описание поля `charcType` в методе [Характеристики предмета](https://dev.wildberries.ru/openapi/item-management#tag/categoriesSubcategoriesAndCharacteristics/operation/getV2ObjectCharcsSubjectId). Допустимое количество значений отображено в поле `maxCount` того же метода - `documents` `object` — Документы - `items` `documentsRequest[]` — Список разрешительных документов и их данные. Тип документа `type` обязателен для каждого документа - `type` `integer` — Тип документа. Типы документов, которые вы можете добавить для товара, указаны в [характеристиках предмета](https://dev.wildberries.ru/openapi/item-management#tag/categoriesSubcategoriesAndCharacteristics/operation/getV2ObjectCharcsSubjectId) — поле `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` — Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) **Структура `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** ```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** ```ts 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** ```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** ```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** ```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** ```bsl #Использовать "wb-api-client" Настройки = Новый Конфигурация(); Настройки.УстановитьТокен("<ваш JWT WB>"); Клиент = Новый ItemsApi(Настройки); Сообщить(Клиент.PostV2CardsUploadAdd(Тело).Тело); ``` **C#** ```csharp 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** ```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); } ```