daytona-wildberries-typescript-sdk 3.10.2 → 3.12.0

package/README.md

@@ -41,6 +41,31 @@ Transform 11 OpenAPI specifications into a production-ready SDK with 14 modules,
 - **💰 Finance v1 Reports** - Sales Reports and Acquiring Reports with `parseMoneyAmount()` helper and field union types for autocomplete
 - **🔔 Deprecation Utilities** - `warnOnce()` and `resetDeprecationWarnings()` for clean migration workflows
 
+## What's New (v3.12.0) — May 2026
+
+⚠️ **Critical migration deadline: 2026-05-20 13:00 MSK** — Wildberries begins disabling the legacy `sku` parameter on seller-warehouse stock endpoints. Migrate now.
+
+🆕 **3 stock methods on `sdk.products`** now accept `chrtId` / `chrtIds` (size IDs from `POST /content/v2/get/cards/list`):
+- `sdk.products.getStocks(warehouseId, { chrtIds })` — preferred path
+- `sdk.products.updateStock(warehouseId, { stocks: [{ chrtId, amount }] })` — per-item migration
+- `sdk.products.deleteStock(warehouseId, { chrtIds })` — preferred path
+
+🔧 **Deprecation handling**: legacy `sku`/`skus` parameters work until 2026-05-20 but emit a one-time `console.warn`. After the deadline: WB returns HTTP 400.
+
+🆕 **4 new types exported**: `StockItem`, `StocksRequest`, `UpdateStockRequest`, `GetStocksResponse`.
+
+See [CHANGELOG v3.12.0](#3120---2026-05-14) and the [migration guide](https://salacoste.github.io/daytona-wildberries-typescript-sdk/guides/stocks-sku-to-chrtid-migration) for full details.
+
+## What's New (v3.11.0) — May 2026
+
+🆕 **4 new DBW methods on `sdk.ordersFBW`** — WB disables legacy single-order DBW endpoints on **2026-06-05**; migrate now:
+- `sdk.ordersFBW.deleteMetaBulk({ orders, key })` — bulk metadata deletion
+- `sdk.ordersFBW.setSgtinBulk({ orders })` — bulk SGTIN assignment
+- `sdk.ordersFBW.deliverBulk(orderIds)` — bulk status → delivered (1–1000 orders, with 409 MetaValidationFail support)
+- `sdk.ordersFBW.checkMetaValidation({ orders })` — pre-flight metadata validator: find invalid SGTIN/IMEI/UIN before calling `deliverBulk()`, avoiding the 409 guess-and-retry loop
+
+See [CHANGELOG v3.11.0](#3110---unreleased) for full details and migration notes.
+
 ## What's New (v3.10.2 hotfix)
 
 🔧 **Bug fix**: `validateRequiredCharacteristics` and `validateMergedCardVariants` now correctly handle `existNamedField:true` characteristics (brand, height, length, etc.). See CHANGELOG v3.10.2 for migration details.
@@ -283,6 +308,31 @@ This is an unofficial SDK. It is not affiliated with, officially maintained by,
 - **💰 Финансовые Отчеты v1** - Отчеты о продажах и эквайринге с хелпером `parseMoneyAmount()` и union-типами полей для автодополнения
 - **🔔 Утилиты Для Устаревших Методов** - `warnOnce()` и `resetDeprecationWarnings()` для удобной миграции
 
+## Что нового (v3.12.0) — Май 2026
+
+⚠️ **Критический дедлайн миграции: 2026-05-20 13:00 MSK** — Wildberries начинает отключение legacy-параметра `sku` на эндпоинтах остатков склада продавца. Мигрируйте сейчас.
+
+🆕 **3 метода остатков в `sdk.products`** теперь принимают `chrtId` / `chrtIds` (ID размеров из `POST /content/v2/get/cards/list`):
+- `sdk.products.getStocks(warehouseId, { chrtIds })` — рекомендуемый путь
+- `sdk.products.updateStock(warehouseId, { stocks: [{ chrtId, amount }] })` — миграция per-item
+- `sdk.products.deleteStock(warehouseId, { chrtIds })` — рекомендуемый путь
+
+🔧 **Обработка устаревания**: legacy `sku`/`skus` работают до 2026-05-20, но эмитят одноразовый `console.warn`. После дедлайна: WB возвращает HTTP 400.
+
+🆕 **4 новых экспортируемых типа**: `StockItem`, `StocksRequest`, `UpdateStockRequest`, `GetStocksResponse`.
+
+Подробности — в [CHANGELOG v3.12.0](#3120---2026-05-14) и в [руководстве по миграции](https://salacoste.github.io/daytona-wildberries-typescript-sdk/guides/stocks-sku-to-chrtid-migration).
+
+## Что нового (v3.11.0) — Май 2026
+
+🆕 **4 новых DBW-метода в `sdk.ordersFBW`** — WB отключает legacy single-order DBW эндпоинты **2026-06-05**; мигрируйте заранее:
+- `sdk.ordersFBW.deleteMetaBulk({ orders, key })` — массовое удаление маркировочных метаданных
+- `sdk.ordersFBW.setSgtinBulk({ orders })` — массовая установка SGTIN-кодов
+- `sdk.ordersFBW.deliverBulk(orderIds)` — массовая передача в доставку (1–1000 заказов, поддержка 409 MetaValidationFail)
+- `sdk.ordersFBW.checkMetaValidation({ orders })` — проверка метаданных маркировки перед передачей в доставку (предварительная валидация): находит невалидные SGTIN/IMEI/UIN до вызова `deliverBulk()`, исключая петлю guess-and-retry при 409
+
+Подробности и инструкции по миграции — в [CHANGELOG v3.11.0](#3110---unreleased).
+
 ## Что нового (v3.10.2 hotfix)
 
 🔧 **Исправление**: `validateRequiredCharacteristics` и `validateMergedCardVariants` теперь корректно обрабатывают характеристики с `existNamedField:true` (бренд, высота, длина и т.д.). Подробности миграции — в CHANGELOG v3.10.2.