@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.
- package/dist/items/api.d.ts +60 -41
- package/dist/items/api.d.ts.map +1 -1
- package/dist/items/api.js +16 -16
- package/dist/items/api.js.map +1 -1
- package/dist/orders-fbs/api.d.ts +13 -157
- package/dist/orders-fbs/api.d.ts.map +1 -1
- package/dist/orders-fbs/api.js +8 -87
- package/dist/orders-fbs/api.js.map +1 -1
- package/dist/orders-fbs/base.d.ts.map +1 -1
- package/dist/orders-fbs/base.js +0 -6
- package/dist/orders-fbs/base.js.map +1 -1
- package/package.json +1 -1
package/dist/items/api.d.ts
CHANGED
|
@@ -164,7 +164,7 @@ export interface DeleteV3StocksWarehouseIdRequest {
|
|
|
164
164
|
*/
|
|
165
165
|
export interface DocumentsRequest {
|
|
166
166
|
/**
|
|
167
|
-
* Тип
|
|
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`, чтобы подтвердить наличие на товаре обязательного кода маркировки. Карточка товара не пройдёт
|
|
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
|
-
*
|
|
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
|
-
* Тип
|
|
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` — продавец подтверждает, что на товар нанесён обязательный код
|
|
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 {
|
|
2614
|
+
* @type {PostV2CardsUploadAddRequestCardsToAddInnerDocuments}
|
|
2615
2615
|
* @memberof PostV2CardsUploadAddRequestCardsToAddInner
|
|
2616
2616
|
*/
|
|
2617
|
-
documents?:
|
|
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` — продавец подтверждает, что на товар нанесён обязательный код
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
* Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые
|
|
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).
|
|
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 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены.
|
|
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] Язык полей ответа `name`, `value` и `object`: - `ru` — русский - `en` — английский - `zh` — китайский Не используется в песочнице. Данные песочницы возвращаются только на русском языке
|
|
@@ -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
|
-
* Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые
|
|
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).
|
|
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 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены.
|
|
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] Язык полей ответа `name`, `value` и `object`: - `ru` — русский - `en` — английский - `zh` — китайский Не используется в песочнице. Данные песочницы возвращаются только на русском языке
|
|
@@ -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
|
-
* Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые
|
|
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).
|
|
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 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены.
|
|
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] Язык полей ответа `name`, `value` и `object`: - `ru` — русский - `en` — английский - `zh` — китайский Не используется в песочнице. Данные песочницы возвращаются только на русском языке
|
|
@@ -7132,7 +7151,7 @@ export interface DefaultApiInterface {
|
|
|
7132
7151
|
*/
|
|
7133
7152
|
postV2CardsRecover(postV2CardsDeleteTrashRequest: PostV2CardsDeleteTrashRequest, options?: RawAxiosRequestConfig): AxiosPromise<PostV2CardsRecoverResponse200>;
|
|
7134
7153
|
/**
|
|
7135
|
-
* Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые
|
|
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).
|
|
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 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены.
|
|
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] Язык полей ответа `name`, `value` и `object`: - `ru` — русский - `en` — английский - `zh` — китайский Не используется в песочнице. Данные песочницы возвращаются только на русском языке
|
|
@@ -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
|
-
* Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые
|
|
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).
|
|
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 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены.
|
|
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] Язык полей ответа `name`, `value` и `object`: - `ru` — русский - `en` — английский - `zh` — китайский Не используется в песочнице. Данные песочницы возвращаются только на русском языке
|