Перейти к содержанию

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

POST /content/v2/cards/upload

Метод создаёт карточки товаров c указанием описаний и характеристик товаров.

Есть две формы запроса: для создания отдельных и объединённых карточек товаров

Габариты товаров можно указать только в сантиметрах, вес товара с упаковкой — в килограммах.

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

Одним запросом можно создать максимум 100 отдельных карточек товаров или 100 групп объединённых карточек товаров по 30 карточек в каждой. Максимальный размер запроса 10 Мб.
Если ответ Успешно (200), но какие-то карточки не создались, проверьте список несозданных карточек товаров.

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

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

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

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

Период Лимит Интервал Всплеск
1 мин 10 запросов 6 сек 5 запросов

Тело запроса: object[]

Ответ: responseItemList

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

import os
from wildberries_sdk import items

token = os.getenv("WB_API_TOKEN")
api = items.DefaultApi(
    items.ApiClient(items.Configuration(api_key={"HeaderApiKey": token}))
)
result = api.post_v2_cards_upload(object[]=...)
print(result)

import { Configuration, DefaultApi } from 'wildberries-sdk';

const api = new DefaultApi(new Configuration({ apiKey: process.env.WB_API_TOKEN }));
const result = await api.postV2CardsUpload({ ... });
console.log(result);

cfg := items.NewConfiguration()
cfg.AddDefaultHeader("Authorization", os.Getenv("WB_API_TOKEN"))
client := items.NewAPIClient(cfg)
result, _, err := client.DefaultApi.PostV2CardsUpload(context.Background()).Execute()

<?php
$config = Wildberries\Sdk\Items\Configuration::getDefaultConfiguration()
    ->setApiKey('Authorization', getenv('WB_API_TOKEN'));
$api = new Wildberries\Sdk\Items\Api\DefaultApi(new GuzzleHttp\Client(), $config);
$result = $api->postV2CardsUpload(...);

use wildberries_sdk_items::apis::{configuration::Configuration, configuration::ApiKey, default_api};

let mut config = Configuration::new();
config.api_key = Some(ApiKey { prefix: None, key: std::env::var("WB_API_TOKEN").unwrap() });
let result = default_api::post_v2_cards_upload(&config, ...).await?;