@valeryverkhoturov/wb-api-client 1.20260930.0 → 1.20261002.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -164,7 +164,7 @@ export interface DeleteV3StocksWarehouseIdRequest {
164
164
  */
165
165
  export interface DocumentsRequest {
166
166
  /**
167
- * Тип документа: - `1` — Сертификат соответствия - `2` — Декларация о соответствии - `3` — Свидетельство о государственной регистрации (СГР) - `4` — Регистрационное удостоверение (РУ) на медицинские изделия - `5` — Регистрационное удостоверение Республики Беларусь - `7` — Данные о регистрации пестицида - `8` — Данные о регистрации агрохимиката - `9` — Регистрационное удостоверение (РУ) на лекарственные препараты
167
+ * Тип документа. Типы документов, которые вы можете добавить для товара, указаны в [характеристиках предмета](./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
168
168
  * @type {number}
169
169
  * @memberof DocumentsRequest
170
170
  */
@@ -2266,7 +2266,7 @@ export interface PostV2CardsUpdateRequestInner {
2266
2266
  */
2267
2267
  vendorCode: string;
2268
2268
  /**
2269
- * Подтверждение, что на товар нанесён обязательный код маркировки [Честного знака](https://честныйзнак.рф/): - `true` — продавец подтверждает, что на товар нанесён обязательный код маркировки. - `false` — продавец подтверждает, что на товар нанесён обязательный код маркировки. Передайте в запросе `true`, чтобы подтвердить наличие на товаре обязательного кода маркировки. Карточка товара не пройдёт модерацию, если нет подтверждения продавца о том, что обязательный код маркировки нанесён на товар. Чтобы проверить, является ли код маркировки [Честного знака](https://честныйзнак.рф/) обязательным, используйте метод [Список карточек товаров](./item-management#tag/listings/operation/postV2GetCardsList), поле ответа `needKiz`
2269
+ * Подтверждение, что на товар нанесён обязательный код маркировки [Честного знака](https://честныйзнак.рф/): - `true` — продавец подтверждает, что на товар нанесён обязательный код маркировки. - `false` — продавец не подтверждает, что на товар нанесён обязательный код маркировки. Передайте в запросе `true`, чтобы подтвердить наличие на товаре обязательного кода маркировки. Карточка товара не пройдёт проверку, если нет подтверждения продавца о том, что обязательный код маркировки нанесён на товар. Чтобы проверить, является ли код маркировки [Честного знака](https://честныйзнак.рф/) обязательным, используйте метод [Список карточек товаров](./item-management#tag/listings/operation/postV2GetCardsList), поле ответа `needKiz`
2270
2270
  * @type {boolean}
2271
2271
  * @memberof PostV2CardsUpdateRequestInner
2272
2272
  */
@@ -2365,19 +2365,19 @@ export interface PostV2CardsUpdateRequestInnerDimensions {
2365
2365
  weightBrutto?: number;
2366
2366
  }
2367
2367
  /**
2368
- * Документы
2368
+ * Разрешительные документы карточки товара
2369
2369
  * @export
2370
2370
  * @interface PostV2CardsUpdateRequestInnerDocuments
2371
2371
  */
2372
2372
  export interface PostV2CardsUpdateRequestInnerDocuments {
2373
2373
  /**
2374
- * Список документов
2374
+ * Список разрешительных документов и их данные
2375
2375
  * @type {Array<PostV2CardsUpdateRequestInnerDocumentsItemsInner>}
2376
2376
  * @memberof PostV2CardsUpdateRequestInnerDocuments
2377
2377
  */
2378
2378
  items?: Array<PostV2CardsUpdateRequestInnerDocumentsItemsInner>;
2379
2379
  /**
2380
- * Исключить ли документы из проверки: - `true` — да, не проверять документы при проверке карточки товара. При `true` все значения, переданные в `documents`, будут заменены на пустые значения - `false` — нет, проверять документы при проверке карточки товара
2380
+ * Подтверждение продавца, что для товара не требуются разрешительные документы: - `true` — продавец подтверждает, что документы не требуются. Все значения, переданные в `documents`, будут заменены на пустые значения - `false` — продавец не подтверждает, что документы не требуются Обязательность документов проверяется при создании и изменении карточки товара. Если для товара требуются документы и указано значение `true`, карточка не пройдёт проверку
2381
2381
  * @type {boolean}
2382
2382
  * @memberof PostV2CardsUpdateRequestInnerDocuments
2383
2383
  */
@@ -2390,7 +2390,7 @@ export interface PostV2CardsUpdateRequestInnerDocuments {
2390
2390
  */
2391
2391
  export interface PostV2CardsUpdateRequestInnerDocumentsItemsInner {
2392
2392
  /**
2393
- * Тип документа: - `1` — Сертификат соответствия - `2` — Декларация о соответствии - `3` — Свидетельство о государственной регистрации (СГР) - `4` — Регистрационное удостоверение (РУ) на медицинские изделия - `5` — Регистрационное удостоверение Республики Беларусь - `7` — Данные о регистрации пестицида - `8` — Данные о регистрации агрохимиката - `9` — Регистрационное удостоверение (РУ) на лекарственные препараты
2393
+ * Тип документа. Типы документов, которые вы можете добавить для товара, указаны в [характеристиках предмета](./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
2394
2394
  * @type {number}
2395
2395
  * @memberof PostV2CardsUpdateRequestInnerDocumentsItemsInner
2396
2396
  */
@@ -2438,7 +2438,7 @@ export interface PostV2CardsUpdateRequestInnerDocumentsItemsInner {
2438
2438
  */
2439
2439
  isEndless?: boolean;
2440
2440
  /**
2441
- * ID документа
2441
+ * ID документа, прикреплённого к карточке. Укажите `id`, чтобы внести изменения в прикреплённый ранее документ. ID документа указан в [списке карточек товаров](https://dev.wildberries.ru/item-management#tag/listings/operation/postV2GetCardsList). Чтобы добавить новый документ, указывать `id` не нужно.
2442
2442
  * @type {string}
2443
2443
  * @memberof PostV2CardsUpdateRequestInnerDocumentsItemsInner
2444
2444
  */
@@ -2568,7 +2568,7 @@ export interface PostV2CardsUploadAddRequestCardsToAddInner {
2568
2568
  */
2569
2569
  vendorCode: string;
2570
2570
  /**
2571
- * Подтверждение, что на товар нанесён обязательный код маркировки [Честного знака](https://честныйзнак.рф/): - `true` — продавец подтверждает, что на товар нанесён обязательный код маркировки. - `false` — продавец не подтверждает, что на товар нанесён обязательный код маркировки. Передайте в запросе `true`, чтобы подтвердить наличие на товаре обязательного кода маркировки. Карточка товара не пройдёт модерацию, если нет подтверждения продавца о том, что обязательный код маркировки нанесён на товар. Чтобы проверить, является ли код маркировки [Честного знака](https://честныйзнак.рф/) обязательным, используйте метод [Список карточек товаров](./item-management#tag/listings/operation/postV2GetCardsList), поле ответа `needKiz`
2571
+ * Подтверждение, что на товар нанесён обязательный код маркировки [Честного знака](https://честныйзнак.рф/): - `true` — продавец подтверждает, что на товар нанесён обязательный код маркировки - `false` — продавец не подтверждает, что на товар нанесён обязательный код маркировки. Передайте в запросе `true`, чтобы подтвердить наличие на товаре обязательного кода маркировки. Карточка товара не пройдёт проверку, если нет подтверждения продавца о том, что обязательный код маркировки нанесён на товар Чтобы проверить, является ли код маркировки [Честного знака](https://честныйзнак.рф/) обязательным, используйте метод [Список карточек товаров](./item-management#tag/listings/operation/postV2GetCardsList), поле ответа `needKiz`
2572
2572
  * @type {boolean}
2573
2573
  * @memberof PostV2CardsUploadAddRequestCardsToAddInner
2574
2574
  */
@@ -2611,10 +2611,10 @@ export interface PostV2CardsUploadAddRequestCardsToAddInner {
2611
2611
  characteristics?: Array<PostV2CardsUpdateRequestInnerCharacteristicsInner>;
2612
2612
  /**
2613
2613
  *
2614
- * @type {PostV2CardsUploadRequestInnerVariantsInnerDocuments}
2614
+ * @type {PostV2CardsUploadAddRequestCardsToAddInnerDocuments}
2615
2615
  * @memberof PostV2CardsUploadAddRequestCardsToAddInner
2616
2616
  */
2617
- documents?: PostV2CardsUploadRequestInnerVariantsInnerDocuments;
2617
+ documents?: PostV2CardsUploadAddRequestCardsToAddInnerDocuments;
2618
2618
  }
2619
2619
  /**
2620
2620
  * Габариты и вес товара \\*\\*c упаковкой\\*\\*. Укажите в `сантиметрах` и `килограммах` для любого товара. Если данные не указаны, автоматически сгенерируются нулевые значения длины, ширины, высоты и веса. Синхронизация данных с сервисом может занимать до 30 минут
@@ -2647,6 +2647,25 @@ export interface PostV2CardsUploadAddRequestCardsToAddInnerDimensions {
2647
2647
  */
2648
2648
  weightBrutto?: number;
2649
2649
  }
2650
+ /**
2651
+ * Документы
2652
+ * @export
2653
+ * @interface PostV2CardsUploadAddRequestCardsToAddInnerDocuments
2654
+ */
2655
+ export interface PostV2CardsUploadAddRequestCardsToAddInnerDocuments {
2656
+ /**
2657
+ * Список разрешительных документов и их данные. Тип документа `type` обязателен для каждого документа
2658
+ * @type {Array<DocumentsRequest>}
2659
+ * @memberof PostV2CardsUploadAddRequestCardsToAddInnerDocuments
2660
+ */
2661
+ items?: Array<DocumentsRequest>;
2662
+ /**
2663
+ * Подтверждение продавца, что для товара не требуются разрешительные документы: - `true` — продавец подтверждает, что документы не требуются. Все значения, переданные в `documents`, будут заменены на пустые значения - `false` — продавец не подтверждает, что документы не требуются Обязательность документов проверяется при создании и изменении карточки товара. Если для товара требуются документы и указано значение `true`, карточка не пройдёт проверку
2664
+ * @type {boolean}
2665
+ * @memberof PostV2CardsUploadAddRequestCardsToAddInnerDocuments
2666
+ */
2667
+ excludeDocuments?: boolean;
2668
+ }
2650
2669
  /**
2651
2670
  *
2652
2671
  * @export
@@ -2777,7 +2796,7 @@ export interface PostV2CardsUploadRequestInnerVariantsInner {
2777
2796
  */
2778
2797
  vendorCode: string;
2779
2798
  /**
2780
- * Подтверждение, что на товар нанесён обязательный код маркировки [Честного знака](https://честныйзнак.рф/): - `true` — продавец подтверждает, что на товар нанесён обязательный код маркировки. - `false` — продавец не подтверждает, что на товар нанесён обязательный код маркировки. Передайте в запросе `true`, чтобы подтвердить наличие на товаре обязательного кода маркировки. Карточка товара не пройдёт модерацию, если нет подтверждения продавца о том, что обязательный код маркировки нанесён на товар. Чтобы проверить, является ли код маркировки [Честного знака](https://честныйзнак.рф/) обязательным, используйте метод [Список карточек товаров](./item-management#tag/listings/operation/postV2GetCardsList), поле ответа `needKiz`
2799
+ * Подтверждение, что на товар нанесён обязательный код маркировки [Честного знака](https://честныйзнак.рф/): - `true` — продавец подтверждает, что на товар нанесён обязательный код маркировки - `false` — продавец не подтверждает, что на товар нанесён обязательный код маркировки. Передайте в запросе `true`, чтобы подтвердить наличие на товаре обязательного кода маркировки. Карточка товара не пройдёт проверку, если нет подтверждения продавца о том, что обязательный код маркировки нанесён на товар Чтобы проверить, является ли код маркировки [Честного знака](https://честныйзнак.рф/) обязательным, используйте метод [Список карточек товаров](./item-management#tag/listings/operation/postV2GetCardsList), поле ответа `needKiz`
2781
2800
  * @type {boolean}
2782
2801
  * @memberof PostV2CardsUploadRequestInnerVariantsInner
2783
2802
  */
@@ -2845,19 +2864,19 @@ export interface PostV2CardsUploadRequestInnerVariantsInnerDimensions {
2845
2864
  weightBrutto?: number;
2846
2865
  }
2847
2866
  /**
2848
- * Документы
2867
+ * Разрешительные документы карточки товара
2849
2868
  * @export
2850
2869
  * @interface PostV2CardsUploadRequestInnerVariantsInnerDocuments
2851
2870
  */
2852
2871
  export interface PostV2CardsUploadRequestInnerVariantsInnerDocuments {
2853
2872
  /**
2854
- * Список документов
2873
+ * Список разрешительных документов и их данные. Тип документа `type` обязателен для каждого документа
2855
2874
  * @type {Array<DocumentsRequest>}
2856
2875
  * @memberof PostV2CardsUploadRequestInnerVariantsInnerDocuments
2857
2876
  */
2858
2877
  items?: Array<DocumentsRequest>;
2859
2878
  /**
2860
- * Исключить ли документы из проверки: - `true` — да, не проверять документы при проверке карточки товара. При `true` все значения, переданные в `documents`, будут заменены на пустые значения - `false` — нет, проверять документы при проверке карточки товара
2879
+ * Подтверждение продавца, что для товара не требуются разрешительные документы: - `true` — продавец подтверждает, что документы не требуются. Все значения, переданные в `documents`, будут заменены на пустые значения - `false` — продавец не подтверждает, что документы не требуются Обязательность документов проверяется при создании и изменении карточки товара. Если для товара требуются документы и указано значение `true`, карточка не пройдёт проверку
2861
2880
  * @type {boolean}
2862
2881
  * @memberof PostV2CardsUploadRequestInnerVariantsInnerDocuments
2863
2882
  */
@@ -3309,13 +3328,13 @@ export interface PostV2GetCardsListResponse200CardsInnerDimensions {
3309
3328
  isValid?: boolean;
3310
3329
  }
3311
3330
  /**
3312
- * Документы
3331
+ * Документы, прикреплённые к карточке товара. Результаты проверки каждого документа указаны в `items`. Результат проверки всей карточки товара указан в `overallVerdict`
3313
3332
  * @export
3314
3333
  * @interface PostV2GetCardsListResponse200CardsInnerDocuments
3315
3334
  */
3316
3335
  export interface PostV2GetCardsListResponse200CardsInnerDocuments {
3317
3336
  /**
3318
- * Список документов
3337
+ * Список документов и результаты проверки каждого документа
3319
3338
  * @type {Array<PostV2GetCardsListResponse200CardsInnerDocumentsItemsInner>}
3320
3339
  * @memberof PostV2GetCardsListResponse200CardsInnerDocuments
3321
3340
  */
@@ -3327,7 +3346,7 @@ export interface PostV2GetCardsListResponse200CardsInnerDocuments {
3327
3346
  */
3328
3347
  overallVerdict?: PostV2GetCardsListResponse200CardsInnerDocumentsOverallVerdict;
3329
3348
  /**
3330
- * Исключены ли документы из проверки карточки товара: - `true` — да, документы не проверяются при проверке карточки - `false` — нет, документы проверяются при проверке карточки
3349
+ * Подтверждение продавца, что для товара не требуются разрешительные документы: - `true` — продавец подтверждает, что документы не требуются. Все значения, переданные в `documents`, будут заменены на пустые значения - `false` — продавец не подтверждает, что документы не требуются Обязательность документов проверяется при создании и изменении карточки товара. Если для товара требуются документы и указано значение `true`, карточка не пройдёт проверку
3331
3350
  * @type {boolean}
3332
3351
  * @memberof PostV2GetCardsListResponse200CardsInnerDocuments
3333
3352
  */
@@ -3407,7 +3426,7 @@ export interface PostV2GetCardsListResponse200CardsInnerDocumentsItemsInner {
3407
3426
  createdAt?: string;
3408
3427
  }
3409
3428
  /**
3410
- * Результат проверки документа. Возвращается, когда проверка завершена
3429
+ * Результат проверки документа. Возвращается, когда проверка документа завершена
3411
3430
  * @export
3412
3431
  * @interface PostV2GetCardsListResponse200CardsInnerDocumentsItemsInnerVerdict
3413
3432
  */
@@ -3444,7 +3463,7 @@ export interface PostV2GetCardsListResponse200CardsInnerDocumentsItemsInnerVerdi
3444
3463
  createdAt?: string;
3445
3464
  }
3446
3465
  /**
3447
- * Результат проверки карточки товара. Возвращается, когда проверка завершена
3466
+ * Общий результат проверки всей карточки товара. Возвращается, когда проверка завершена. Результаты проверок отдельных документов и общий результат карточки могут различаться. Например, карточка может пройти проверку, если обязательный документ прошёл проверку, а дополнительный документ не прошёл
3448
3467
  * @export
3449
3468
  * @interface PostV2GetCardsListResponse200CardsInnerDocumentsOverallVerdict
3450
3469
  */
@@ -3462,7 +3481,7 @@ export interface PostV2GetCardsListResponse200CardsInnerDocumentsOverallVerdict
3462
3481
  */
3463
3482
  status?: number;
3464
3483
  /**
3465
- * Ошибка при проверке, возвращается для `status: 2`. Возможные значения: - `tnved\\_missing` — Не указан код ТН ВЭД - `supplier\\_inn\\_missing` — Не указан ИНН - `supplier\\_not\\_registered` — Поставщик не найден в реестре - `supplier\\_inactive` — Ошибка в статусе поставщика, проверьте его в реестре - `product\\_group\\_not\\_registered` — Добавлена неверная товарная группа в системе маркировки - `kiz\\_required` — Этот товар нельзя продавать в России без кода маркировки Честного Знака - `kiz\\_certificate\\_missing` — Нет подтверждения, что на товар нанесена необходимая маркировка
3484
+ * Ошибка при проверке, возвращается для `status: 2`. Указывается только 1 причина. Если карточка не прошла проверку по нескольким причинам, то после исправления первой причины, вернётся следующая. Возможные значения: - `tnved\\_missing` — Не указан код ТН ВЭД - `supplier\\_inn\\_missing` — Не указан ИНН - `supplier\\_not\\_registered` — Поставщик не найден в реестре - `supplier\\_inactive` — Ошибка в статусе поставщика, проверьте его в реестре - `product\\_group\\_not\\_registered` — Добавлена неверная товарная группа в системе маркировки - `kiz\\_required` — Этот товар нельзя продавать в России без кода маркировки Честного Знака - `kiz\\_certificate\\_missing` — Нет подтверждения, что на товар нанесена необходимая маркировка
3466
3485
  * @type {string}
3467
3486
  * @memberof PostV2GetCardsListResponse200CardsInnerDocumentsOverallVerdict
3468
3487
  */
@@ -3738,7 +3757,7 @@ export interface PostV2GetCardsTrashResponse200CardsInner {
3738
3757
  */
3739
3758
  vendorCode?: string;
3740
3759
  /**
3741
- * Есть ли подтверждение от продавца, что обязательный код маркировки [Честного знака](https://честныйзнак.рф/) нанесён на товар: - `true` — да - `false` — нет Чтобы проверить, является ли код маркировки [Честного знака](https://честныйзнак.рф/) обязательным, используйте метод [Список карточек товаров](./item-management#tag/listings/operation/postV2GetCardsList), поле ответа `needKiz`
3760
+ * Подтверждение, что на товар нанесён обязательный код маркировки [Честного знака](https://честныйзнак.рф/): - `true` — продавец подтверждает, что на товар нанесён обязательный код маркировки. - `false` — продавец не подтверждает, что на товар нанесён обязательный код маркировки. Передайте в запросе `true`, чтобы подтвердить наличие обязательного кода маркировки на товаре. Карточка товара не пройдёт проверку, если от продавца нет подтверждения о том, что на товар нанесён обязательный код маркировки. Чтобы проверить, является ли код маркировки [Честного знака](https://честныйзнак.рф/) обязательным, используйте метод [Список карточек товаров](./item-management#tag/listings/operation/postV2GetCardsList), поле ответа `needKiz`
3742
3761
  * @type {boolean}
3743
3762
  * @memberof PostV2GetCardsTrashResponse200CardsInner
3744
3763
  */
@@ -5672,7 +5691,7 @@ export declare const DefaultApiAxiosParamCreator: (configuration?: Configuration
5672
5691
  */
5673
5692
  postV2CardsRecover: (postV2CardsDeleteTrashRequest: PostV2CardsDeleteTrashRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
5674
5693
  /**
5675
- * Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые размеры. Карточка товара перезаписывается при обновлении. Поэтому в запросе нужно передать в том числе те параметры карточки, которые вы не собираетесь обновлять. Их значения можно получить в [списке карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsList) и [списке карточек товаров в корзине](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash). С помощью этого метода нельзя обновлять или удалять: - баркоды размеров товара. Можно только добавить дополнительные баркоды - параметры `photos`, `video` и `tags` - цены товаров. Цену можно задать, только если вы добавляете новые размеры При добавлении нового размера укажите его цену через параметр `price`. Если в запросе не указан `price`, цена размера будет `0` — в этом случае изменить её можно будет с помощью методов: - [Установить цены и скидки](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTask), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":false` - [Установить цены для размеров](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTaskSize), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":true` Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Одним запросом можно отредактировать максимум 3000 карточек товаров (`nmID`). Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не обновились, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Синхронизация данных с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 10 запросов | 6 сек | 5 запросов |
5694
+ * Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые размеры и документы. Карточка товара перезаписывается при обновлении. Поэтому в запросе нужно передать в том числе те параметры карточки, которые вы не собираетесь обновлять. Их значения можно получить в [списке карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsList) и [списке карточек товаров в корзине](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash). При обновлении карточки объект **documents** также полностью перезаписывается. Передавайте в запросе данные всех документов, которые должны остаться в карточке, включая документы без изменений. С помощью этого метода нельзя обновлять или удалять: - баркоды размеров товара. Можно только добавить дополнительные баркоды - параметры `photos`, `video` и `tags` - цены товаров. Цену можно задать, только если вы добавляете новые размеры При добавлении нового размера укажите его цену через параметр `price`. Если в запросе не указан `price`, цена размера будет `0` — в этом случае изменить её можно будет с помощью методов: - [Установить цены и скидки](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTask), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":false` - [Установить цены для размеров](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTaskSize), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":true` Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Одним запросом можно отредактировать максимум 3000 карточек товаров (`nmID`). Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не обновились, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Синхронизация данных с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса `documents`. Чтобы внести изменения в прикрепленный к карточке документ, передайте `id` документа и его данные в объекте запроса `documents`. Получить `id` документа вы можете в [списке карточек товара](https://dev.wildberries.ru/item-management#tag/listings/operation/postV2GetCardsList). После изменения документа или добавления нового документа карточка повторно отправляется на проверку. Проверка документов выполняется асинхронно и может занимать до 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 запросов |
5676
5695
  * @summary Редактирование карточек товаров
5677
5696
  * @param {Array<PostV2CardsUpdateRequestInner>} [postV2CardsUpdateRequestInner]
5678
5697
  * @param {*} [options] Override http request option.
@@ -5680,7 +5699,7 @@ export declare const DefaultApiAxiosParamCreator: (configuration?: Configuration
5680
5699
  */
5681
5700
  postV2CardsUpdate: (postV2CardsUpdateRequestInner?: Array<PostV2CardsUpdateRequestInner>, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
5682
5701
  /**
5683
- * Метод создаёт карточки товаров c указанием описаний и характеристик товаров. Есть две формы запроса: для создания отдельных и объединённых карточек товаров Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Создание карточки товара происходит асинхронно. Синхронизация новой карточки с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. Одним запросом можно создать максимум 100 отдельных карточек товаров или 100 групп [объединённых](https://dev.wildberries.ru/knowledge-base/articles/019d49a4-1320-71bb-9dac-8ba07e7177ce/rabota-s-tovarami#obuedinenie-i-razuedinenie-kartochek-tovarov) карточек товаров по 30 карточек в каждой. Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не создались, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). В песочнице карточка товара создаётся сразу, без ожидания. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 10 запросов | 6 сек | 5 запросов |
5702
+ * Метод создаёт карточки товаров c указанием описаний и характеристик товаров. Есть две формы запроса: для создания отдельных и объединённых карточек товаров Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Создание карточки товара происходит асинхронно. Синхронизация новой карточки с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. В песочнице карточка товара создаётся сразу, без ожидания. Одним запросом можно создать максимум 100 отдельных карточек товаров или 100 групп [объединённых](https://dev.wildberries.ru/knowledge-base/articles/019d49a4-1320-71bb-9dac-8ba07e7177ce/rabota-s-tovarami#obuedinenie-i-razuedinenie-kartochek-tovarov) карточек товаров по 30 карточек в каждой. Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не создались, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса `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 запросов |
5684
5703
  * @summary Создание карточек товаров
5685
5704
  * @param {Array<PostV2CardsUploadRequestInner>} [postV2CardsUploadRequestInner]
5686
5705
  * @param {*} [options] Override http request option.
@@ -5688,7 +5707,7 @@ export declare const DefaultApiAxiosParamCreator: (configuration?: Configuration
5688
5707
  */
5689
5708
  postV2CardsUpload: (postV2CardsUploadRequestInner?: Array<PostV2CardsUploadRequestInner>, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
5690
5709
  /**
5691
- * Метод создаёт карточки товаров, присоединяя их к существующим отдельным карточкам и группам [объединённых](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 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. В песочнице карточка товара создаётся сразу, без ожидания. [Лимит запросов](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 запрос |
5710
+ * Метод создаёт карточки товаров, присоединяя их к существующим отдельным карточкам и группам [объединённых](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 запрос |
5692
5711
  * @summary Создание карточек товаров с присоединением
5693
5712
  * @param {PostV2CardsUploadAddRequest} [postV2CardsUploadAddRequest]
5694
5713
  * @param {*} [options] Override http request option.
@@ -5696,7 +5715,7 @@ export declare const DefaultApiAxiosParamCreator: (configuration?: Configuration
5696
5715
  */
5697
5716
  postV2CardsUploadAdd: (postV2CardsUploadAddRequest?: PostV2CardsUploadAddRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
5698
5717
  /**
5699
- * Метод возвращает список созданных карточек товаров. В ответе метода не будет карточек, находящихся в корзине. Получить такие карточки можно через [отдельный метод](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash) Чтобы получить \\*\\*больше 100\\*\\* карточек товаров, используйте пагинацию: 1. Сделайте первый запрос: ``` { \"settings\": { \"sort\": { \"ascending\": true }, \"cursor\": { \"limit\": 100 }, \"filter\": { \"withPhoto\": -1 } } } ``` Чтобы после выгрузки получать только новые или обновлённые карточки товаров, используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Скопируйте `\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"` из `cursor` ответа и вставьте в `cursor` запроса. 3. Повторите запрос. 4. Повторяйте пункты 2 и 3, пока значение `total` в ответе не станет меньше, чем значение `limit` в запросе. Это будет означать, что вы получили все карточки. Чтобы получать только карточки товаров, которые были созданы или обновлены после предыдущей выгрузки данных: 1. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа предыдущей выгрузки. При выгрузке используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Укажите в первом запросе сохранённые поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}`. Продолжайте использовать сортировку по возрастанию. 3. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа текущей выгрузки. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 100 запросов | 600 мс | 5 запросов |
5718
+ * Метод возвращает список созданных карточек товаров. В ответе метода не будет карточек, находящихся в корзине. Получить такие карточки можно через [отдельный метод](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash) Чтобы получить \\*\\*больше 100\\*\\* карточек товаров, используйте пагинацию: 1. Сделайте первый запрос: ``` { \"settings\": { \"sort\": { \"ascending\": true }, \"cursor\": { \"limit\": 100 }, \"filter\": { \"withPhoto\": -1 } } } ``` Чтобы после выгрузки получать только новые или обновлённые карточки товаров, используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Скопируйте `\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"` из `cursor` ответа и вставьте в `cursor` запроса. 3. Повторите запрос. 4. Повторяйте пункты 2 и 3, пока значение `total` в ответе не станет меньше, чем значение `limit` в запросе. Это будет означать, что вы получили все карточки. Чтобы получать только карточки товаров, которые были созданы или обновлены после предыдущей выгрузки данных: 1. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа предыдущей выгрузки. При выгрузке используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Укажите в первом запросе сохранённые поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}`. Продолжайте использовать сортировку по возрастанию. 3. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа текущей выгрузки. В объекте `documents` метод возвращает: - информацию о переданных документах — массив `items` - результаты проверки по каждому документу — объект `verdict` в `items`. Если `verdict` не возвращается в ответе — проверка документа ещё не завершена - результат проверки всей карточки — объект `overallVerdict`. Проверка всей карточки включает проверку не только документов, но и других данных. Например, наличия обязательной маркировки и сведений из внешних реестров. Если `overallVerdict` не возвращается в ответе — проверка карточки ещё не завершена Проверки документов и карточки выполняются асинхронно и могут занимать до 3 дней. Каждое изменение результата проверки обновляет дату и время изменения карточки в поле ответа `updatedAt`. Чтобы получить новые результаты проверки, используйте выгрузку с пагинацией с сортировкой по возрастанию. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 100 запросов | 600 мс | 5 запросов |
5700
5719
  * @summary Список карточек товаров
5701
5720
  * @param {PostV2GetCardsListRequest} postV2GetCardsListRequest
5702
5721
  * @param {string} [locale] Язык полей ответа &#x60;name&#x60;, &#x60;value&#x60; и &#x60;object&#x60;: - &#x60;ru&#x60; — русский - &#x60;en&#x60; — английский - &#x60;zh&#x60; — китайский Не используется в песочнице. Данные песочницы возвращаются только на русском языке
@@ -6146,7 +6165,7 @@ export declare const DefaultApiFp: (configuration?: Configuration) => {
6146
6165
  */
6147
6166
  postV2CardsRecover(postV2CardsDeleteTrashRequest: PostV2CardsDeleteTrashRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PostV2CardsRecoverResponse200>>;
6148
6167
  /**
6149
- * Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые размеры. Карточка товара перезаписывается при обновлении. Поэтому в запросе нужно передать в том числе те параметры карточки, которые вы не собираетесь обновлять. Их значения можно получить в [списке карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsList) и [списке карточек товаров в корзине](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash). С помощью этого метода нельзя обновлять или удалять: - баркоды размеров товара. Можно только добавить дополнительные баркоды - параметры `photos`, `video` и `tags` - цены товаров. Цену можно задать, только если вы добавляете новые размеры При добавлении нового размера укажите его цену через параметр `price`. Если в запросе не указан `price`, цена размера будет `0` — в этом случае изменить её можно будет с помощью методов: - [Установить цены и скидки](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTask), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":false` - [Установить цены для размеров](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTaskSize), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":true` Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Одним запросом можно отредактировать максимум 3000 карточек товаров (`nmID`). Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не обновились, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Синхронизация данных с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 10 запросов | 6 сек | 5 запросов |
6168
+ * Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые размеры и документы. Карточка товара перезаписывается при обновлении. Поэтому в запросе нужно передать в том числе те параметры карточки, которые вы не собираетесь обновлять. Их значения можно получить в [списке карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsList) и [списке карточек товаров в корзине](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash). При обновлении карточки объект **documents** также полностью перезаписывается. Передавайте в запросе данные всех документов, которые должны остаться в карточке, включая документы без изменений. С помощью этого метода нельзя обновлять или удалять: - баркоды размеров товара. Можно только добавить дополнительные баркоды - параметры `photos`, `video` и `tags` - цены товаров. Цену можно задать, только если вы добавляете новые размеры При добавлении нового размера укажите его цену через параметр `price`. Если в запросе не указан `price`, цена размера будет `0` — в этом случае изменить её можно будет с помощью методов: - [Установить цены и скидки](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTask), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":false` - [Установить цены для размеров](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTaskSize), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":true` Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Одним запросом можно отредактировать максимум 3000 карточек товаров (`nmID`). Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не обновились, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Синхронизация данных с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса `documents`. Чтобы внести изменения в прикрепленный к карточке документ, передайте `id` документа и его данные в объекте запроса `documents`. Получить `id` документа вы можете в [списке карточек товара](https://dev.wildberries.ru/item-management#tag/listings/operation/postV2GetCardsList). После изменения документа или добавления нового документа карточка повторно отправляется на проверку. Проверка документов выполняется асинхронно и может занимать до 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 запросов |
6150
6169
  * @summary Редактирование карточек товаров
6151
6170
  * @param {Array<PostV2CardsUpdateRequestInner>} [postV2CardsUpdateRequestInner]
6152
6171
  * @param {*} [options] Override http request option.
@@ -6154,7 +6173,7 @@ export declare const DefaultApiFp: (configuration?: Configuration) => {
6154
6173
  */
6155
6174
  postV2CardsUpdate(postV2CardsUpdateRequestInner?: Array<PostV2CardsUpdateRequestInner>, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ResponseItemList>>;
6156
6175
  /**
6157
- * Метод создаёт карточки товаров c указанием описаний и характеристик товаров. Есть две формы запроса: для создания отдельных и объединённых карточек товаров Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Создание карточки товара происходит асинхронно. Синхронизация новой карточки с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. Одним запросом можно создать максимум 100 отдельных карточек товаров или 100 групп [объединённых](https://dev.wildberries.ru/knowledge-base/articles/019d49a4-1320-71bb-9dac-8ba07e7177ce/rabota-s-tovarami#obuedinenie-i-razuedinenie-kartochek-tovarov) карточек товаров по 30 карточек в каждой. Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не создались, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). В песочнице карточка товара создаётся сразу, без ожидания. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 10 запросов | 6 сек | 5 запросов |
6176
+ * Метод создаёт карточки товаров c указанием описаний и характеристик товаров. Есть две формы запроса: для создания отдельных и объединённых карточек товаров Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Создание карточки товара происходит асинхронно. Синхронизация новой карточки с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. В песочнице карточка товара создаётся сразу, без ожидания. Одним запросом можно создать максимум 100 отдельных карточек товаров или 100 групп [объединённых](https://dev.wildberries.ru/knowledge-base/articles/019d49a4-1320-71bb-9dac-8ba07e7177ce/rabota-s-tovarami#obuedinenie-i-razuedinenie-kartochek-tovarov) карточек товаров по 30 карточек в каждой. Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не создались, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса `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 запросов |
6158
6177
  * @summary Создание карточек товаров
6159
6178
  * @param {Array<PostV2CardsUploadRequestInner>} [postV2CardsUploadRequestInner]
6160
6179
  * @param {*} [options] Override http request option.
@@ -6162,7 +6181,7 @@ export declare const DefaultApiFp: (configuration?: Configuration) => {
6162
6181
  */
6163
6182
  postV2CardsUpload(postV2CardsUploadRequestInner?: Array<PostV2CardsUploadRequestInner>, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ResponseItemList>>;
6164
6183
  /**
6165
- * Метод создаёт карточки товаров, присоединяя их к существующим отдельным карточкам и группам [объединённых](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 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. В песочнице карточка товара создаётся сразу, без ожидания. [Лимит запросов](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 запрос |
6184
+ * Метод создаёт карточки товаров, присоединяя их к существующим отдельным карточкам и группам [объединённых](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 запрос |
6166
6185
  * @summary Создание карточек товаров с присоединением
6167
6186
  * @param {PostV2CardsUploadAddRequest} [postV2CardsUploadAddRequest]
6168
6187
  * @param {*} [options] Override http request option.
@@ -6170,7 +6189,7 @@ export declare const DefaultApiFp: (configuration?: Configuration) => {
6170
6189
  */
6171
6190
  postV2CardsUploadAdd(postV2CardsUploadAddRequest?: PostV2CardsUploadAddRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ResponseItemList>>;
6172
6191
  /**
6173
- * Метод возвращает список созданных карточек товаров. В ответе метода не будет карточек, находящихся в корзине. Получить такие карточки можно через [отдельный метод](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash) Чтобы получить \\*\\*больше 100\\*\\* карточек товаров, используйте пагинацию: 1. Сделайте первый запрос: ``` { \"settings\": { \"sort\": { \"ascending\": true }, \"cursor\": { \"limit\": 100 }, \"filter\": { \"withPhoto\": -1 } } } ``` Чтобы после выгрузки получать только новые или обновлённые карточки товаров, используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Скопируйте `\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"` из `cursor` ответа и вставьте в `cursor` запроса. 3. Повторите запрос. 4. Повторяйте пункты 2 и 3, пока значение `total` в ответе не станет меньше, чем значение `limit` в запросе. Это будет означать, что вы получили все карточки. Чтобы получать только карточки товаров, которые были созданы или обновлены после предыдущей выгрузки данных: 1. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа предыдущей выгрузки. При выгрузке используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Укажите в первом запросе сохранённые поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}`. Продолжайте использовать сортировку по возрастанию. 3. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа текущей выгрузки. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 100 запросов | 600 мс | 5 запросов |
6192
+ * Метод возвращает список созданных карточек товаров. В ответе метода не будет карточек, находящихся в корзине. Получить такие карточки можно через [отдельный метод](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash) Чтобы получить \\*\\*больше 100\\*\\* карточек товаров, используйте пагинацию: 1. Сделайте первый запрос: ``` { \"settings\": { \"sort\": { \"ascending\": true }, \"cursor\": { \"limit\": 100 }, \"filter\": { \"withPhoto\": -1 } } } ``` Чтобы после выгрузки получать только новые или обновлённые карточки товаров, используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Скопируйте `\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"` из `cursor` ответа и вставьте в `cursor` запроса. 3. Повторите запрос. 4. Повторяйте пункты 2 и 3, пока значение `total` в ответе не станет меньше, чем значение `limit` в запросе. Это будет означать, что вы получили все карточки. Чтобы получать только карточки товаров, которые были созданы или обновлены после предыдущей выгрузки данных: 1. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа предыдущей выгрузки. При выгрузке используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Укажите в первом запросе сохранённые поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}`. Продолжайте использовать сортировку по возрастанию. 3. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа текущей выгрузки. В объекте `documents` метод возвращает: - информацию о переданных документах — массив `items` - результаты проверки по каждому документу — объект `verdict` в `items`. Если `verdict` не возвращается в ответе — проверка документа ещё не завершена - результат проверки всей карточки — объект `overallVerdict`. Проверка всей карточки включает проверку не только документов, но и других данных. Например, наличия обязательной маркировки и сведений из внешних реестров. Если `overallVerdict` не возвращается в ответе — проверка карточки ещё не завершена Проверки документов и карточки выполняются асинхронно и могут занимать до 3 дней. Каждое изменение результата проверки обновляет дату и время изменения карточки в поле ответа `updatedAt`. Чтобы получить новые результаты проверки, используйте выгрузку с пагинацией с сортировкой по возрастанию. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 100 запросов | 600 мс | 5 запросов |
6174
6193
  * @summary Список карточек товаров
6175
6194
  * @param {PostV2GetCardsListRequest} postV2GetCardsListRequest
6176
6195
  * @param {string} [locale] Язык полей ответа &#x60;name&#x60;, &#x60;value&#x60; и &#x60;object&#x60;: - &#x60;ru&#x60; — русский - &#x60;en&#x60; — английский - &#x60;zh&#x60; — китайский Не используется в песочнице. Данные песочницы возвращаются только на русском языке
@@ -6620,7 +6639,7 @@ export declare const DefaultApiFactory: (configuration?: Configuration, basePath
6620
6639
  */
6621
6640
  postV2CardsRecover(postV2CardsDeleteTrashRequest: PostV2CardsDeleteTrashRequest, options?: RawAxiosRequestConfig): AxiosPromise<PostV2CardsRecoverResponse200>;
6622
6641
  /**
6623
- * Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые размеры. Карточка товара перезаписывается при обновлении. Поэтому в запросе нужно передать в том числе те параметры карточки, которые вы не собираетесь обновлять. Их значения можно получить в [списке карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsList) и [списке карточек товаров в корзине](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash). С помощью этого метода нельзя обновлять или удалять: - баркоды размеров товара. Можно только добавить дополнительные баркоды - параметры `photos`, `video` и `tags` - цены товаров. Цену можно задать, только если вы добавляете новые размеры При добавлении нового размера укажите его цену через параметр `price`. Если в запросе не указан `price`, цена размера будет `0` — в этом случае изменить её можно будет с помощью методов: - [Установить цены и скидки](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTask), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":false` - [Установить цены для размеров](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTaskSize), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":true` Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Одним запросом можно отредактировать максимум 3000 карточек товаров (`nmID`). Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не обновились, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Синхронизация данных с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 10 запросов | 6 сек | 5 запросов |
6642
+ * Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые размеры и документы. Карточка товара перезаписывается при обновлении. Поэтому в запросе нужно передать в том числе те параметры карточки, которые вы не собираетесь обновлять. Их значения можно получить в [списке карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsList) и [списке карточек товаров в корзине](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash). При обновлении карточки объект **documents** также полностью перезаписывается. Передавайте в запросе данные всех документов, которые должны остаться в карточке, включая документы без изменений. С помощью этого метода нельзя обновлять или удалять: - баркоды размеров товара. Можно только добавить дополнительные баркоды - параметры `photos`, `video` и `tags` - цены товаров. Цену можно задать, только если вы добавляете новые размеры При добавлении нового размера укажите его цену через параметр `price`. Если в запросе не указан `price`, цена размера будет `0` — в этом случае изменить её можно будет с помощью методов: - [Установить цены и скидки](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTask), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":false` - [Установить цены для размеров](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTaskSize), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":true` Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Одним запросом можно отредактировать максимум 3000 карточек товаров (`nmID`). Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не обновились, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Синхронизация данных с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса `documents`. Чтобы внести изменения в прикрепленный к карточке документ, передайте `id` документа и его данные в объекте запроса `documents`. Получить `id` документа вы можете в [списке карточек товара](https://dev.wildberries.ru/item-management#tag/listings/operation/postV2GetCardsList). После изменения документа или добавления нового документа карточка повторно отправляется на проверку. Проверка документов выполняется асинхронно и может занимать до 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 запросов |
6624
6643
  * @summary Редактирование карточек товаров
6625
6644
  * @param {Array<PostV2CardsUpdateRequestInner>} [postV2CardsUpdateRequestInner]
6626
6645
  * @param {*} [options] Override http request option.
@@ -6628,7 +6647,7 @@ export declare const DefaultApiFactory: (configuration?: Configuration, basePath
6628
6647
  */
6629
6648
  postV2CardsUpdate(postV2CardsUpdateRequestInner?: Array<PostV2CardsUpdateRequestInner>, options?: RawAxiosRequestConfig): AxiosPromise<ResponseItemList>;
6630
6649
  /**
6631
- * Метод создаёт карточки товаров c указанием описаний и характеристик товаров. Есть две формы запроса: для создания отдельных и объединённых карточек товаров Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Создание карточки товара происходит асинхронно. Синхронизация новой карточки с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. Одним запросом можно создать максимум 100 отдельных карточек товаров или 100 групп [объединённых](https://dev.wildberries.ru/knowledge-base/articles/019d49a4-1320-71bb-9dac-8ba07e7177ce/rabota-s-tovarami#obuedinenie-i-razuedinenie-kartochek-tovarov) карточек товаров по 30 карточек в каждой. Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не создались, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). В песочнице карточка товара создаётся сразу, без ожидания. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 10 запросов | 6 сек | 5 запросов |
6650
+ * Метод создаёт карточки товаров c указанием описаний и характеристик товаров. Есть две формы запроса: для создания отдельных и объединённых карточек товаров Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Создание карточки товара происходит асинхронно. Синхронизация новой карточки с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. В песочнице карточка товара создаётся сразу, без ожидания. Одним запросом можно создать максимум 100 отдельных карточек товаров или 100 групп [объединённых](https://dev.wildberries.ru/knowledge-base/articles/019d49a4-1320-71bb-9dac-8ba07e7177ce/rabota-s-tovarami#obuedinenie-i-razuedinenie-kartochek-tovarov) карточек товаров по 30 карточек в каждой. Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не создались, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса `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 запросов |
6632
6651
  * @summary Создание карточек товаров
6633
6652
  * @param {Array<PostV2CardsUploadRequestInner>} [postV2CardsUploadRequestInner]
6634
6653
  * @param {*} [options] Override http request option.
@@ -6636,7 +6655,7 @@ export declare const DefaultApiFactory: (configuration?: Configuration, basePath
6636
6655
  */
6637
6656
  postV2CardsUpload(postV2CardsUploadRequestInner?: Array<PostV2CardsUploadRequestInner>, options?: RawAxiosRequestConfig): AxiosPromise<ResponseItemList>;
6638
6657
  /**
6639
- * Метод создаёт карточки товаров, присоединяя их к существующим отдельным карточкам и группам [объединённых](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 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. В песочнице карточка товара создаётся сразу, без ожидания. [Лимит запросов](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 запрос |
6658
+ * Метод создаёт карточки товаров, присоединяя их к существующим отдельным карточкам и группам [объединённых](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 запрос |
6640
6659
  * @summary Создание карточек товаров с присоединением
6641
6660
  * @param {PostV2CardsUploadAddRequest} [postV2CardsUploadAddRequest]
6642
6661
  * @param {*} [options] Override http request option.
@@ -6644,7 +6663,7 @@ export declare const DefaultApiFactory: (configuration?: Configuration, basePath
6644
6663
  */
6645
6664
  postV2CardsUploadAdd(postV2CardsUploadAddRequest?: PostV2CardsUploadAddRequest, options?: RawAxiosRequestConfig): AxiosPromise<ResponseItemList>;
6646
6665
  /**
6647
- * Метод возвращает список созданных карточек товаров. В ответе метода не будет карточек, находящихся в корзине. Получить такие карточки можно через [отдельный метод](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash) Чтобы получить \\*\\*больше 100\\*\\* карточек товаров, используйте пагинацию: 1. Сделайте первый запрос: ``` { \"settings\": { \"sort\": { \"ascending\": true }, \"cursor\": { \"limit\": 100 }, \"filter\": { \"withPhoto\": -1 } } } ``` Чтобы после выгрузки получать только новые или обновлённые карточки товаров, используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Скопируйте `\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"` из `cursor` ответа и вставьте в `cursor` запроса. 3. Повторите запрос. 4. Повторяйте пункты 2 и 3, пока значение `total` в ответе не станет меньше, чем значение `limit` в запросе. Это будет означать, что вы получили все карточки. Чтобы получать только карточки товаров, которые были созданы или обновлены после предыдущей выгрузки данных: 1. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа предыдущей выгрузки. При выгрузке используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Укажите в первом запросе сохранённые поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}`. Продолжайте использовать сортировку по возрастанию. 3. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа текущей выгрузки. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 100 запросов | 600 мс | 5 запросов |
6666
+ * Метод возвращает список созданных карточек товаров. В ответе метода не будет карточек, находящихся в корзине. Получить такие карточки можно через [отдельный метод](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash) Чтобы получить \\*\\*больше 100\\*\\* карточек товаров, используйте пагинацию: 1. Сделайте первый запрос: ``` { \"settings\": { \"sort\": { \"ascending\": true }, \"cursor\": { \"limit\": 100 }, \"filter\": { \"withPhoto\": -1 } } } ``` Чтобы после выгрузки получать только новые или обновлённые карточки товаров, используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Скопируйте `\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"` из `cursor` ответа и вставьте в `cursor` запроса. 3. Повторите запрос. 4. Повторяйте пункты 2 и 3, пока значение `total` в ответе не станет меньше, чем значение `limit` в запросе. Это будет означать, что вы получили все карточки. Чтобы получать только карточки товаров, которые были созданы или обновлены после предыдущей выгрузки данных: 1. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа предыдущей выгрузки. При выгрузке используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Укажите в первом запросе сохранённые поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}`. Продолжайте использовать сортировку по возрастанию. 3. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа текущей выгрузки. В объекте `documents` метод возвращает: - информацию о переданных документах — массив `items` - результаты проверки по каждому документу — объект `verdict` в `items`. Если `verdict` не возвращается в ответе — проверка документа ещё не завершена - результат проверки всей карточки — объект `overallVerdict`. Проверка всей карточки включает проверку не только документов, но и других данных. Например, наличия обязательной маркировки и сведений из внешних реестров. Если `overallVerdict` не возвращается в ответе — проверка карточки ещё не завершена Проверки документов и карточки выполняются асинхронно и могут занимать до 3 дней. Каждое изменение результата проверки обновляет дату и время изменения карточки в поле ответа `updatedAt`. Чтобы получить новые результаты проверки, используйте выгрузку с пагинацией с сортировкой по возрастанию. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 100 запросов | 600 мс | 5 запросов |
6648
6667
  * @summary Список карточек товаров
6649
6668
  * @param {PostV2GetCardsListRequest} postV2GetCardsListRequest
6650
6669
  * @param {string} [locale] Язык полей ответа &#x60;name&#x60;, &#x60;value&#x60; и &#x60;object&#x60;: - &#x60;ru&#x60; — русский - &#x60;en&#x60; — английский - &#x60;zh&#x60; — китайский Не используется в песочнице. Данные песочницы возвращаются только на русском языке
@@ -7132,7 +7151,7 @@ export interface DefaultApiInterface {
7132
7151
  */
7133
7152
  postV2CardsRecover(postV2CardsDeleteTrashRequest: PostV2CardsDeleteTrashRequest, options?: RawAxiosRequestConfig): AxiosPromise<PostV2CardsRecoverResponse200>;
7134
7153
  /**
7135
- * Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые размеры. Карточка товара перезаписывается при обновлении. Поэтому в запросе нужно передать в том числе те параметры карточки, которые вы не собираетесь обновлять. Их значения можно получить в [списке карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsList) и [списке карточек товаров в корзине](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash). С помощью этого метода нельзя обновлять или удалять: - баркоды размеров товара. Можно только добавить дополнительные баркоды - параметры `photos`, `video` и `tags` - цены товаров. Цену можно задать, только если вы добавляете новые размеры При добавлении нового размера укажите его цену через параметр `price`. Если в запросе не указан `price`, цена размера будет `0` — в этом случае изменить её можно будет с помощью методов: - [Установить цены и скидки](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTask), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":false` - [Установить цены для размеров](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTaskSize), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":true` Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Одним запросом можно отредактировать максимум 3000 карточек товаров (`nmID`). Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не обновились, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Синхронизация данных с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 10 запросов | 6 сек | 5 запросов |
7154
+ * Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые размеры и документы. Карточка товара перезаписывается при обновлении. Поэтому в запросе нужно передать в том числе те параметры карточки, которые вы не собираетесь обновлять. Их значения можно получить в [списке карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsList) и [списке карточек товаров в корзине](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash). При обновлении карточки объект **documents** также полностью перезаписывается. Передавайте в запросе данные всех документов, которые должны остаться в карточке, включая документы без изменений. С помощью этого метода нельзя обновлять или удалять: - баркоды размеров товара. Можно только добавить дополнительные баркоды - параметры `photos`, `video` и `tags` - цены товаров. Цену можно задать, только если вы добавляете новые размеры При добавлении нового размера укажите его цену через параметр `price`. Если в запросе не указан `price`, цена размера будет `0` — в этом случае изменить её можно будет с помощью методов: - [Установить цены и скидки](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTask), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":false` - [Установить цены для размеров](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTaskSize), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":true` Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Одним запросом можно отредактировать максимум 3000 карточек товаров (`nmID`). Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не обновились, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Синхронизация данных с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса `documents`. Чтобы внести изменения в прикрепленный к карточке документ, передайте `id` документа и его данные в объекте запроса `documents`. Получить `id` документа вы можете в [списке карточек товара](https://dev.wildberries.ru/item-management#tag/listings/operation/postV2GetCardsList). После изменения документа или добавления нового документа карточка повторно отправляется на проверку. Проверка документов выполняется асинхронно и может занимать до 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 запросов |
7136
7155
  * @summary Редактирование карточек товаров
7137
7156
  * @param {Array<PostV2CardsUpdateRequestInner>} [postV2CardsUpdateRequestInner]
7138
7157
  * @param {*} [options] Override http request option.
@@ -7141,7 +7160,7 @@ export interface DefaultApiInterface {
7141
7160
  */
7142
7161
  postV2CardsUpdate(postV2CardsUpdateRequestInner?: Array<PostV2CardsUpdateRequestInner>, options?: RawAxiosRequestConfig): AxiosPromise<ResponseItemList>;
7143
7162
  /**
7144
- * Метод создаёт карточки товаров c указанием описаний и характеристик товаров. Есть две формы запроса: для создания отдельных и объединённых карточек товаров Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Создание карточки товара происходит асинхронно. Синхронизация новой карточки с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. Одним запросом можно создать максимум 100 отдельных карточек товаров или 100 групп [объединённых](https://dev.wildberries.ru/knowledge-base/articles/019d49a4-1320-71bb-9dac-8ba07e7177ce/rabota-s-tovarami#obuedinenie-i-razuedinenie-kartochek-tovarov) карточек товаров по 30 карточек в каждой. Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не создались, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). В песочнице карточка товара создаётся сразу, без ожидания. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 10 запросов | 6 сек | 5 запросов |
7163
+ * Метод создаёт карточки товаров c указанием описаний и характеристик товаров. Есть две формы запроса: для создания отдельных и объединённых карточек товаров Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Создание карточки товара происходит асинхронно. Синхронизация новой карточки с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. В песочнице карточка товара создаётся сразу, без ожидания. Одним запросом можно создать максимум 100 отдельных карточек товаров или 100 групп [объединённых](https://dev.wildberries.ru/knowledge-base/articles/019d49a4-1320-71bb-9dac-8ba07e7177ce/rabota-s-tovarami#obuedinenie-i-razuedinenie-kartochek-tovarov) карточек товаров по 30 карточек в каждой. Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не создались, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса `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 запросов |
7145
7164
  * @summary Создание карточек товаров
7146
7165
  * @param {Array<PostV2CardsUploadRequestInner>} [postV2CardsUploadRequestInner]
7147
7166
  * @param {*} [options] Override http request option.
@@ -7150,7 +7169,7 @@ export interface DefaultApiInterface {
7150
7169
  */
7151
7170
  postV2CardsUpload(postV2CardsUploadRequestInner?: Array<PostV2CardsUploadRequestInner>, options?: RawAxiosRequestConfig): AxiosPromise<ResponseItemList>;
7152
7171
  /**
7153
- * Метод создаёт карточки товаров, присоединяя их к существующим отдельным карточкам и группам [объединённых](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 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. В песочнице карточка товара создаётся сразу, без ожидания. [Лимит запросов](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 запрос |
7172
+ * Метод создаёт карточки товаров, присоединяя их к существующим отдельным карточкам и группам [объединённых](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 запрос |
7154
7173
  * @summary Создание карточек товаров с присоединением
7155
7174
  * @param {PostV2CardsUploadAddRequest} [postV2CardsUploadAddRequest]
7156
7175
  * @param {*} [options] Override http request option.
@@ -7159,7 +7178,7 @@ export interface DefaultApiInterface {
7159
7178
  */
7160
7179
  postV2CardsUploadAdd(postV2CardsUploadAddRequest?: PostV2CardsUploadAddRequest, options?: RawAxiosRequestConfig): AxiosPromise<ResponseItemList>;
7161
7180
  /**
7162
- * Метод возвращает список созданных карточек товаров. В ответе метода не будет карточек, находящихся в корзине. Получить такие карточки можно через [отдельный метод](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash) Чтобы получить \\*\\*больше 100\\*\\* карточек товаров, используйте пагинацию: 1. Сделайте первый запрос: ``` { \"settings\": { \"sort\": { \"ascending\": true }, \"cursor\": { \"limit\": 100 }, \"filter\": { \"withPhoto\": -1 } } } ``` Чтобы после выгрузки получать только новые или обновлённые карточки товаров, используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Скопируйте `\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"` из `cursor` ответа и вставьте в `cursor` запроса. 3. Повторите запрос. 4. Повторяйте пункты 2 и 3, пока значение `total` в ответе не станет меньше, чем значение `limit` в запросе. Это будет означать, что вы получили все карточки. Чтобы получать только карточки товаров, которые были созданы или обновлены после предыдущей выгрузки данных: 1. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа предыдущей выгрузки. При выгрузке используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Укажите в первом запросе сохранённые поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}`. Продолжайте использовать сортировку по возрастанию. 3. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа текущей выгрузки. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 100 запросов | 600 мс | 5 запросов |
7181
+ * Метод возвращает список созданных карточек товаров. В ответе метода не будет карточек, находящихся в корзине. Получить такие карточки можно через [отдельный метод](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash) Чтобы получить \\*\\*больше 100\\*\\* карточек товаров, используйте пагинацию: 1. Сделайте первый запрос: ``` { \"settings\": { \"sort\": { \"ascending\": true }, \"cursor\": { \"limit\": 100 }, \"filter\": { \"withPhoto\": -1 } } } ``` Чтобы после выгрузки получать только новые или обновлённые карточки товаров, используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Скопируйте `\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"` из `cursor` ответа и вставьте в `cursor` запроса. 3. Повторите запрос. 4. Повторяйте пункты 2 и 3, пока значение `total` в ответе не станет меньше, чем значение `limit` в запросе. Это будет означать, что вы получили все карточки. Чтобы получать только карточки товаров, которые были созданы или обновлены после предыдущей выгрузки данных: 1. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа предыдущей выгрузки. При выгрузке используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Укажите в первом запросе сохранённые поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}`. Продолжайте использовать сортировку по возрастанию. 3. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа текущей выгрузки. В объекте `documents` метод возвращает: - информацию о переданных документах — массив `items` - результаты проверки по каждому документу — объект `verdict` в `items`. Если `verdict` не возвращается в ответе — проверка документа ещё не завершена - результат проверки всей карточки — объект `overallVerdict`. Проверка всей карточки включает проверку не только документов, но и других данных. Например, наличия обязательной маркировки и сведений из внешних реестров. Если `overallVerdict` не возвращается в ответе — проверка карточки ещё не завершена Проверки документов и карточки выполняются асинхронно и могут занимать до 3 дней. Каждое изменение результата проверки обновляет дату и время изменения карточки в поле ответа `updatedAt`. Чтобы получить новые результаты проверки, используйте выгрузку с пагинацией с сортировкой по возрастанию. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 100 запросов | 600 мс | 5 запросов |
7163
7182
  * @summary Список карточек товаров
7164
7183
  * @param {PostV2GetCardsListRequest} postV2GetCardsListRequest
7165
7184
  * @param {string} [locale] Язык полей ответа &#x60;name&#x60;, &#x60;value&#x60; и &#x60;object&#x60;: - &#x60;ru&#x60; — русский - &#x60;en&#x60; — английский - &#x60;zh&#x60; — китайский Не используется в песочнице. Данные песочницы возвращаются только на русском языке
@@ -7663,7 +7682,7 @@ export declare class DefaultApi extends BaseAPI implements DefaultApiInterface {
7663
7682
  */
7664
7683
  postV2CardsRecover(postV2CardsDeleteTrashRequest: PostV2CardsDeleteTrashRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PostV2CardsRecoverResponse200, any, {}, any>>;
7665
7684
  /**
7666
- * Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые размеры. Карточка товара перезаписывается при обновлении. Поэтому в запросе нужно передать в том числе те параметры карточки, которые вы не собираетесь обновлять. Их значения можно получить в [списке карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsList) и [списке карточек товаров в корзине](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash). С помощью этого метода нельзя обновлять или удалять: - баркоды размеров товара. Можно только добавить дополнительные баркоды - параметры `photos`, `video` и `tags` - цены товаров. Цену можно задать, только если вы добавляете новые размеры При добавлении нового размера укажите его цену через параметр `price`. Если в запросе не указан `price`, цена размера будет `0` — в этом случае изменить её можно будет с помощью методов: - [Установить цены и скидки](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTask), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":false` - [Установить цены для размеров](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTaskSize), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":true` Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Одним запросом можно отредактировать максимум 3000 карточек товаров (`nmID`). Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не обновились, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Синхронизация данных с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 10 запросов | 6 сек | 5 запросов |
7685
+ * Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые размеры и документы. Карточка товара перезаписывается при обновлении. Поэтому в запросе нужно передать в том числе те параметры карточки, которые вы не собираетесь обновлять. Их значения можно получить в [списке карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsList) и [списке карточек товаров в корзине](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash). При обновлении карточки объект **documents** также полностью перезаписывается. Передавайте в запросе данные всех документов, которые должны остаться в карточке, включая документы без изменений. С помощью этого метода нельзя обновлять или удалять: - баркоды размеров товара. Можно только добавить дополнительные баркоды - параметры `photos`, `video` и `tags` - цены товаров. Цену можно задать, только если вы добавляете новые размеры При добавлении нового размера укажите его цену через параметр `price`. Если в запросе не указан `price`, цена размера будет `0` — в этом случае изменить её можно будет с помощью методов: - [Установить цены и скидки](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTask), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":false` - [Установить цены для размеров](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/postV2UploadTaskSize), если у [товара](https://dev.wildberries.ru/openapi/item-management#tag/pricesAndDiscounts/operation/getV2ListGoodsFilter) `\"editablePriceSize\":true` Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Одним запросом можно отредактировать максимум 3000 карточек товаров (`nmID`). Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не обновились, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Синхронизация данных с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса `documents`. Чтобы внести изменения в прикрепленный к карточке документ, передайте `id` документа и его данные в объекте запроса `documents`. Получить `id` документа вы можете в [списке карточек товара](https://dev.wildberries.ru/item-management#tag/listings/operation/postV2GetCardsList). После изменения документа или добавления нового документа карточка повторно отправляется на проверку. Проверка документов выполняется асинхронно и может занимать до 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 запросов |
7667
7686
  * @summary Редактирование карточек товаров
7668
7687
  * @param {Array<PostV2CardsUpdateRequestInner>} [postV2CardsUpdateRequestInner]
7669
7688
  * @param {*} [options] Override http request option.
@@ -7672,7 +7691,7 @@ export declare class DefaultApi extends BaseAPI implements DefaultApiInterface {
7672
7691
  */
7673
7692
  postV2CardsUpdate(postV2CardsUpdateRequestInner?: Array<PostV2CardsUpdateRequestInner>, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ResponseItemList, any, {}, any>>;
7674
7693
  /**
7675
- * Метод создаёт карточки товаров c указанием описаний и характеристик товаров. Есть две формы запроса: для создания отдельных и объединённых карточек товаров Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Создание карточки товара происходит асинхронно. Синхронизация новой карточки с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. Одним запросом можно создать максимум 100 отдельных карточек товаров или 100 групп [объединённых](https://dev.wildberries.ru/knowledge-base/articles/019d49a4-1320-71bb-9dac-8ba07e7177ce/rabota-s-tovarami#obuedinenie-i-razuedinenie-kartochek-tovarov) карточек товаров по 30 карточек в каждой. Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не создались, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). В песочнице карточка товара создаётся сразу, без ожидания. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 10 запросов | 6 сек | 5 запросов |
7694
+ * Метод создаёт карточки товаров c указанием описаний и характеристик товаров. Есть две формы запроса: для создания отдельных и объединённых карточек товаров Габариты товаров можно указать только в `сантиметрах`, вес товара с упаковкой — в `килограммах`. Создание карточки товара происходит асинхронно. Синхронизация новой карточки с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. В песочнице карточка товара создаётся сразу, без ожидания. Одним запросом можно создать максимум 100 отдельных карточек товаров или 100 групп [объединённых](https://dev.wildberries.ru/knowledge-base/articles/019d49a4-1320-71bb-9dac-8ba07e7177ce/rabota-s-tovarami#obuedinenie-i-razuedinenie-kartochek-tovarov) карточек товаров по 30 карточек в каждой. Максимальный размер запроса 10 Мб. Если ответ `Успешно` (`200`), но какие-то карточки не создались, проверьте [список несозданных карточек товаров](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2CardsErrorList). Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса `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 запросов |
7676
7695
  * @summary Создание карточек товаров
7677
7696
  * @param {Array<PostV2CardsUploadRequestInner>} [postV2CardsUploadRequestInner]
7678
7697
  * @param {*} [options] Override http request option.
@@ -7681,7 +7700,7 @@ export declare class DefaultApi extends BaseAPI implements DefaultApiInterface {
7681
7700
  */
7682
7701
  postV2CardsUpload(postV2CardsUploadRequestInner?: Array<PostV2CardsUploadRequestInner>, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ResponseItemList, any, {}, any>>;
7683
7702
  /**
7684
- * Метод создаёт карточки товаров, присоединяя их к существующим отдельным карточкам и группам [объединённых](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 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены. В песочнице карточка товара создаётся сразу, без ожидания. [Лимит запросов](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 запрос |
7703
+ * Метод создаёт карточки товаров, присоединяя их к существующим отдельным карточкам и группам [объединённых](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 запрос |
7685
7704
  * @summary Создание карточек товаров с присоединением
7686
7705
  * @param {PostV2CardsUploadAddRequest} [postV2CardsUploadAddRequest]
7687
7706
  * @param {*} [options] Override http request option.
@@ -7690,7 +7709,7 @@ export declare class DefaultApi extends BaseAPI implements DefaultApiInterface {
7690
7709
  */
7691
7710
  postV2CardsUploadAdd(postV2CardsUploadAddRequest?: PostV2CardsUploadAddRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ResponseItemList, any, {}, any>>;
7692
7711
  /**
7693
- * Метод возвращает список созданных карточек товаров. В ответе метода не будет карточек, находящихся в корзине. Получить такие карточки можно через [отдельный метод](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash) Чтобы получить \\*\\*больше 100\\*\\* карточек товаров, используйте пагинацию: 1. Сделайте первый запрос: ``` { \"settings\": { \"sort\": { \"ascending\": true }, \"cursor\": { \"limit\": 100 }, \"filter\": { \"withPhoto\": -1 } } } ``` Чтобы после выгрузки получать только новые или обновлённые карточки товаров, используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Скопируйте `\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"` из `cursor` ответа и вставьте в `cursor` запроса. 3. Повторите запрос. 4. Повторяйте пункты 2 и 3, пока значение `total` в ответе не станет меньше, чем значение `limit` в запросе. Это будет означать, что вы получили все карточки. Чтобы получать только карточки товаров, которые были созданы или обновлены после предыдущей выгрузки данных: 1. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа предыдущей выгрузки. При выгрузке используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Укажите в первом запросе сохранённые поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}`. Продолжайте использовать сортировку по возрастанию. 3. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа текущей выгрузки. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 100 запросов | 600 мс | 5 запросов |
7712
+ * Метод возвращает список созданных карточек товаров. В ответе метода не будет карточек, находящихся в корзине. Получить такие карточки можно через [отдельный метод](https://dev.wildberries.ru/openapi/item-management#tag/listings/operation/postV2GetCardsTrash) Чтобы получить \\*\\*больше 100\\*\\* карточек товаров, используйте пагинацию: 1. Сделайте первый запрос: ``` { \"settings\": { \"sort\": { \"ascending\": true }, \"cursor\": { \"limit\": 100 }, \"filter\": { \"withPhoto\": -1 } } } ``` Чтобы после выгрузки получать только новые или обновлённые карточки товаров, используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Скопируйте `\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"` из `cursor` ответа и вставьте в `cursor` запроса. 3. Повторите запрос. 4. Повторяйте пункты 2 и 3, пока значение `total` в ответе не станет меньше, чем значение `limit` в запросе. Это будет означать, что вы получили все карточки. Чтобы получать только карточки товаров, которые были созданы или обновлены после предыдущей выгрузки данных: 1. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа предыдущей выгрузки. При выгрузке используйте сортировку по возрастанию: `\"sort\":{\"ascending\":true}`. 2. Укажите в первом запросе сохранённые поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}`. Продолжайте использовать сортировку по возрастанию. 3. Сохраните поля `\"cursor\":{\"updatedAt\":\"\\*\\*\\*\",\"nmID\":\"\\*\\*\\*\"}` из последнего ответа текущей выгрузки. В объекте `documents` метод возвращает: - информацию о переданных документах — массив `items` - результаты проверки по каждому документу — объект `verdict` в `items`. Если `verdict` не возвращается в ответе — проверка документа ещё не завершена - результат проверки всей карточки — объект `overallVerdict`. Проверка всей карточки включает проверку не только документов, но и других данных. Например, наличия обязательной маркировки и сведений из внешних реестров. Если `overallVerdict` не возвращается в ответе — проверка карточки ещё не завершена Проверки документов и карточки выполняются асинхронно и могут занимать до 3 дней. Каждое изменение результата проверки обновляет дату и время изменения карточки в поле ответа `updatedAt`. Чтобы получить новые результаты проверки, используйте выгрузку с пагинацией с сортировкой по возрастанию. [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 100 запросов | 600 мс | 5 запросов |
7694
7713
  * @summary Список карточек товаров
7695
7714
  * @param {PostV2GetCardsListRequest} postV2GetCardsListRequest
7696
7715
  * @param {string} [locale] Язык полей ответа &#x60;name&#x60;, &#x60;value&#x60; и &#x60;object&#x60;: - &#x60;ru&#x60; — русский - &#x60;en&#x60; — английский - &#x60;zh&#x60; — китайский Не используется в песочнице. Данные песочницы возвращаются только на русском языке