Редактирование карточек товаров¶

POST /content/v2/cards/update

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

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

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

С помощью этого метода нельзя обновлять или удалять: - баркоды размеров товара. Можно только добавить дополнительные баркоды - параметры photos, video и tags - цены товаров. Цену можно задать, только если вы добавляете новые размеры

При добавлении нового размера укажите его цену через параметр price. Если в запросе не указан price, цена размера будет 0 — в этом случае изменить её можно будет с помощью методов: - Установить цены и скидки, если у товара "editablePriceSize":false - Установить цены для размеров, если у товара "editablePriceSize":true

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

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

Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса documents.
Чтобы внести изменения в прикрепленный к карточке документ, передайте id документа и его данные в объекте запроса documents. Получить id документа вы можете в списке карточек товара. После изменения документа или добавления нового документа карточка повторно отправляется на проверку.

Проверка документов выполняется асинхронно и может занимать до 3 дней.
Вы можете изменить карточку снова до завершения текущей проверки. При этом проверка запустится повторно, а карточка сохранит текущий статус до завершения новой проверки.
Если карточка была доступна для продажи до обновления документа, она будет доступна и до получения нового результата проверки. Если карточка уже была заблокирована, то после обновления данных она останется заблокированной до получения положительного результата повторной проверки.

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

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

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

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

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

Ответ: responseItemList

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

PythonNode.jsGoPHPRust

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_update(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.postV2CardsUpdate({ ... });
console.log(result);

cfg := items.NewConfiguration()
cfg.AddDefaultHeader("Authorization", os.Getenv("WB_API_TOKEN"))
client := items.NewAPIClient(cfg)
result, _, err := client.DefaultApi.PostV2CardsUpdate(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->postV2CardsUpdate(...);

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_update(&config, ...).await?;