Skip to content

Latest commit

Β 

History

375 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Wildberries API TypeScript SDK

CI Documentation Deploy npm version Coverage License: Personal Use

Full-featured TypeScript SDK providing type-safe access to all Wildberries marketplace API methods.

ΠŸΠΎΠ»Π½ΠΎΡ„ΡƒΠ½ΠΊΡ†ΠΈΠΎΠ½Π°Π»ΡŒΠ½Ρ‹ΠΉ TypeScript SDK с ΠΏΠΎΠ»Π½ΠΎΠΉ Ρ‚ΠΈΠΏΠΈΠ·Π°Ρ†ΠΈΠ΅ΠΉ для всСх ΠΌΠ΅Ρ‚ΠΎΠ΄ΠΎΠ² API маркСтплСйса Wildberries.


πŸ“š Complete Documentation | Languages: English | Русский (Russian)


🌍 Language / Π―Π·Ρ‹ΠΊ


English Version

Transform 11 OpenAPI specifications into a production-ready SDK with 14 modules, complete type safety, automatic rate limiting, retry mechanisms, and comprehensive error handling. Reduce integration time from weeks to hours.

✨ Features

  • πŸ” Complete Type Safety - Auto-generated TypeScript types from OpenAPI specifications for all 14 API modules
  • ⚑ Automatic Rate Limiting - Built-in enforcement of per-endpoint rate limits with intelligent queuing and Basic/Test token multipliers
  • πŸ”„ Smart Retry Logic - Exponential backoff retry mechanism for transient failures with per-request timeout support
  • πŸ›‘οΈ Rich Error Handling - Typed error hierarchy with detailed recovery guidance
  • πŸ“¦ Tree-Shakeable - Dual ESM/CommonJS builds, import only what you need (<100KB gzipped)
  • βœ… Battle-Tested - 2,376 tests passing across all modules
  • 🎯 100% API Coverage - All YAML endpoints implemented including v1 Finance Reports and Acquiring Reports
  • πŸ“š Comprehensive Documentation - Complete API reference, 44 guides, tutorials, and working examples in English and Russian
  • πŸ”§ Zero Configuration - Works out of the box with sensible defaults, configurable for advanced use
  • πŸ’° 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 (v4.1.0) β€” July 2026

πŸ†• Item Rating v2 β€” sdk.analytics.getItemRatingV2() implements POST /api/analytics/v2/item-rating, including onlyShadowedNms and items[].isShadowed for hidden-from-catalog reporting.

⚠️ Migration deadline: July 30, 2026 β€” Wildberries will disable Item Rating v1 and the dedicated hidden-products report. Replace sdk.analytics.getItemRating() and sdk.reports.getBannedProductsShadowed() with the v2 method.

πŸ“– Item Rating v1 β†’ v2 migration guide

What's New (v3.15.0) β€” May 2026

⚠️ FBS marking-code deadline: 2026-06-03 β€” WB starts validating ЧСстный Π—Π½Π°ΠΊ marking codes server-side for B2C FBS orders. Invalid codes β†’ HTTP 409 with new metaDetails[] diagnostic field on PATCH /api/v3/supplies/{supplyId}/deliver (method sdk.ordersFBS.updateSuppliesDeliver()). Codes must be passed in full with GS separators + crypto-tail.

πŸ†• New MetaValidationFailError class β€” import { MetaValidationFailError } from 'daytona-wildberries-typescript-sdk'. Extends WBAPIError; exposes typed metaDetails: MetaDetail[] and code: string. Backward-compatible β€” existing instanceof WBAPIError catches still work.

πŸ›  New parseMetaValidationFail() helper β€” narrows any caught error to { code, message, metaDetails } | null without importing the class. Convenient for shared error boundaries.

⚑ 10Γ— rate-limit penalty warning: every 409 response on updateSuppliesDeliver counts as 10 requests. The migration guide recommends pre-flight validation via sdk.ordersFBS.getOrdersMetaBulk() to avoid burning quota.

See CHANGELOG v3.15.0 and the migration guide for the full pattern catalog, decision matrix, and FAQ.

What's New (v3.14.0) β€” May 2026

🚨 Silent semantic break deadline: 2026-06-16 β€” WB changes the withPhoto filter: withPhoto: 0 (or missing) will mean "ALL cards" instead of "no-photo only". The new value withPhoto: 2 replaces the old 0 semantic. No HTTP error, no signal β€” wrong data. Migrate before the deadline.

πŸ†• New WITH_PHOTO_FILTER const β€” import { WITH_PHOTO_FILTER } from 'daytona-wildberries-typescript-sdk'. Use WITH_PHOTO_FILTER.NO_PHOTO (= 2), WITH_PHOTO_FILTER.WITH_PHOTO (= 1), or WITH_PHOTO_FILTER.ALL (= -1) instead of magic numbers.

πŸ”” Runtime warn-once: first call with withPhoto: 0 emits a console.warn pointing to the migration guide and deadline. Use resetDeprecationWarnings() in tests.

See CHANGELOG v3.14.0 and the migration guide for the full migration matrix and code examples.

What's New (v3.13.0) β€” May 2026

πŸ”§ Critical fix: sdk.communications.createSellerMessage() now works β€” the method previously sent an empty body on every call (broken since introduction). v3.13.0 requires a data: SellerMessageRequest parameter. Existing TypeScript call sites createSellerMessage() will fail to compile β€” this is intentional; the old signature never worked.

⚠️ replySign format deadline: 2026-06-04 β€” WB updated the replySign field format. Old-format values cached before this date will be rejected with HTTP 400 after the cutoff. Always refresh via getSellerChats() before calling createSellerMessage().

πŸ†• New type exported: SellerMessageRequest β€” import type { SellerMessageRequest } from 'daytona-wildberries-typescript-sdk'.

πŸ”” Heuristic warn-once: SDK emits a one-time console.warn when a probable old-format replySign is detected at runtime. Use resetDeprecationWarnings() in tests.

See CHANGELOG v3.13.0 and the migration guide for full details.

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 and the migration guide 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 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.

What's New (v3.10.0) β€” May 2026

πŸ†• sdk.returns aggregator module β€” single source of truth for return analytics. Combines FBO + FBS + Finance sources via Promise.allSettled with srid-based deduplication and per-source telemetry. Three methods:

  • sdk.returns.getReturns({ dateFrom, dateTo, ... }) β€” primary aggregator with partial-failure tolerance
  • sdk.returns.getReturnByOrderId(orderId, ...) β€” single-record lookup
  • sdk.returns.getReturnStats({ groupBy: 'nmId' | 'category' | 'orderType' }) β€” aggregation buckets

πŸ†• classifyFbsReturnCategory() β€” heuristic FBS status history β†’ return category enum

πŸ“š New EN+RU guide: Returns Module with Mermaid diagram, limitations table, and 4 copy-paste recipes

βœ… 2207 tests passing, 25 code review findings fixed (all severities)

  • v3.9.3 -- classifyReturnReason(), enrichReturnsWithType(), reconcileBuyoutsAndReturns() helpers + new guide
  • v3.9.2 -- isVariable field + validateMergedCardVariants() helper
  • v3.9.1 -- validateRequiredCharacteristics() helper for required-field pre-flight checks
  • v3.9.0 -- Mandatory product characteristics support (isRequiredForCreate), characteristic input/output types, DRY refactor

See CHANGELOG.md for the complete release history.


⚠️ Critical API Update

Wildberries API Deprecation Notice - The Promotion v0/v1 advert API was disabled by Wildberries on February 2, 2026 and the corresponding SDK methods were removed in v4.0.0:

  • getAuctionAdverts() / getPromotionAdverts() - advert listing (v0/v1)
  • createAutoUpdatenm() - Update Product Cards (type 8 campaigns)
  • createAutoSetExcluded() - Set/Remove Minus-Phrases (type 8 campaigns)
  • getStatsKeywords() / updateAuctionBid() - keyword stats & manual bidding (v0/v1)

Action Required: Migrate to the v2 advert methods (e.g. getAdvertsV2(), updateBids()).

πŸ“– v4.0.0 Migration Guide


πŸ“¦ Installation

npm install daytona-wildberries-typescript-sdk

Requirements

  • Node.js: β‰₯ 20.0.0
  • TypeScript: β‰₯ 5.0.0 (for TypeScript projects)
  • Wildberries API Key: Get one here

πŸš€ Quick Start

import { WildberriesSDK } from 'daytona-wildberries-typescript-sdk';

// Initialize SDK with your API key
const sdk = new WildberriesSDK({
  apiKey: process.env.WB_API_KEY! // Store securely in environment variables
});

// Test connectivity
const pingResponse = await sdk.general.ping();
console.log('Connected:', pingResponse.Status); // 'OK'

// Fetch product categories
const categories = await sdk.products.getParentAll();
console.log('Categories:', categories.data?.length);

// Get new orders
const orders = await sdk.ordersFBS.getOrdersNew();
console.log('New orders:', orders.orders?.length);

// Check account balance
const balance = await sdk.finances.getAccountBalance();
console.log('Balance:', balance.for_withdraw, balance.currency);

// Get advertising campaigns overview
const campaigns = await sdk.promotion.getCampaignCount();
console.log('Total campaigns:', campaigns.all);

// Get advertising balance
const advBalance = await sdk.promotion.getAdvBalance();
console.log('Ad cabinet balance:', advBalance.net);

// Get customer chat list with last messages
const chats = await sdk.communications.getSellerChats();
console.log('Active chats:', chats.result?.length);
chats.result?.forEach(chat => {
  if (chat.lastMessage) {
    console.log(`${chat.clientName}: "${chat.lastMessage.text}"`);
  }
});

Time to First API Call: <5 minutes πŸš€

πŸ‘‰ Complete Quickstart Guide

Advanced Configuration

The SDK accepts much more than just apiKey. Customize timeout, retry logic, rate limiting, and logging:

const sdk = new WildberriesSDK({
  apiKey: process.env.WB_API_KEY!,
  timeout: 60000,                    // Global timeout (default: 30000ms)
  logLevel: 'info',                  // 'debug' | 'info' | 'warn' | 'error'
  retryConfig: {
    maxRetries: 5,
    retryDelay: 2000,
    exponentialBackoff: true,
  },
});

// For slow operations, create an SDK instance with a longer timeout
const longTimeoutSdk = new WildberriesSDK({
  apiKey: process.env.WB_API_KEY!,
  timeout: 120000,                   // 2 min for report downloads
});
const reportFile = await longTimeoutSdk.analytics.getDownloadsFile(downloadId);

πŸ‘‰ Configuration Guide


πŸ“Š Project Status & Development

Current Status: 🟒 Production Ready | SDK Version: 4.1.0

πŸ“– Project Status Summary β€” Comprehensive overview of all epics, stories, and implementation status.

Quick Stats

Metric Value
API Modules 14 (100%)
API Endpoints 240+ implemented
Test Suite 2,376 tests passing
Documentation 44 guides, 22 examples
Bundle Size ~91KB gzipped (ESM)

⚠️ For Contributors: When creating or completing epics/stories, update PROJECT_STATUS_SUMMARY.md to keep the project status current. This file is automatically generated and should reflect the latest implementation state.


πŸ“š Documentation

Getting Started

Guides

🎯 Supported API Modules

All 14 Wildberries API modules are fully supported with 100% API coverage:

Module Description
General Ping, news, seller info, Jam subscription, seller rating
Products Categories, CRUD, media, pricing, warehouse, stock, kizMarked support
Orders FBS Seller fulfillment, order status, shipping, supplies, metadata validation
Orders FBW WB warehouse fulfillment, supply planning, buyer info
Orders DBS Delivery by Seller - bulk operations, B2B support, product marking (SGTIN, IMEI)
Finances Balance, transactions, v1 Sales Reports, Acquiring Reports, parseMoneyAmount(), field union types
Analytics Sales funnel, search queries, stock history, WB warehouse stock, CSV reports
Reports Income reports, sales reports, data exports
Communications Customer chat, product Q&A, reviews, pinned reviews for product cards
Promotion Campaigns, bids, minus phrases, advertising
Tariffs Commission rates, fee schedules
In-Store Pickup Pickup point orders and management
User Management Seller profile user management
Returns Unified return analytics aggregator (FBO + FBS + Finance), getReturns(), getReturnByOrderId(), getReturnStats()

πŸ“„ License

Personal Use License - Free for personal, educational, and non-commercial use.

βœ… Permitted:

  • Personal non-commercial use
  • Educational purposes
  • Open source projects (non-commercial)
  • Learning and skill development

❌ Not Permitted Without Commercial License:

  • Commercial use in business environments
  • Selling or monetizing the SDK
  • Providing paid services based on the SDK
  • Use in commercial products/services

For commercial use, please contact for licensing.

See LICENSE file for complete terms.

🀝 Contributing

We welcome contributions! Whether it's bug reports, feature requests, documentation improvements, or code contributions.

β†’ Contributing Guide

πŸ“ž Support

⚠️ Disclaimer

This is an unofficial SDK. It is not affiliated with, officially maintained by, or endorsed by Wildberries. Use at your own risk. Always refer to the official Wildberries API documentation for authoritative information.


Русская ВСрсия

ΠŸΡ€Π΅ΠΎΠ±Ρ€Π°Π·ΡƒΠΉΡ‚Π΅ 11 OpenAPI спСцификаций Π² production-Π³ΠΎΡ‚ΠΎΠ²Ρ‹ΠΉ SDK с 14 модулями, ΠΏΠΎΠ»Π½ΠΎΠΉ Ρ‚ΠΈΠΏΠΎΠ±Π΅Π·ΠΎΠΏΠ°ΡΠ½ΠΎΡΡ‚ΡŒΡŽ, автоматичСскими Π»ΠΈΠΌΠΈΡ‚Π°ΠΌΠΈ запросов, ΠΌΠ΅Ρ…Π°Π½ΠΈΠ·ΠΌΠ°ΠΌΠΈ ΠΏΠΎΠ²Ρ‚ΠΎΡ€Π½Ρ‹Ρ… ΠΏΠΎΠΏΡ‹Ρ‚ΠΎΠΊ ΠΈ комплСксной ΠΎΠ±Ρ€Π°Π±ΠΎΡ‚ΠΊΠΎΠΉ ошибок. Π‘ΠΎΠΊΡ€Π°Ρ‚ΠΈΡ‚Π΅ врСмя ΠΈΠ½Ρ‚Π΅Π³Ρ€Π°Ρ†ΠΈΠΈ с нСдСль Π΄ΠΎ часов.

✨ ВозмоТности

  • πŸ” Полная Π’ΠΈΠΏΠΎΠ±Π΅Π·ΠΎΠΏΠ°ΡΠ½ΠΎΡΡ‚ΡŒ - АвтоматичСски Π³Π΅Π½Π΅Ρ€ΠΈΡ€ΡƒΠ΅ΠΌΡ‹Π΅ TypeScript Ρ‚ΠΈΠΏΡ‹ ΠΈΠ· OpenAPI для всСх 14 ΠΌΠΎΠ΄ΡƒΠ»Π΅ΠΉ
  • ⚑ АвтоматичСскиС Π›ΠΈΠΌΠΈΡ‚Ρ‹ Запросов - ВстроСнноС соблюдСниС Π»ΠΈΠΌΠΈΡ‚ΠΎΠ² для ΠΊΠ°ΠΆΠ΄ΠΎΠΉ ΠΊΠΎΠ½Π΅Ρ‡Π½ΠΎΠΉ Ρ‚ΠΎΡ‡ΠΊΠΈ с ΡƒΠΌΠ½ΠΎΠΉ ΠΎΡ‡Π΅Ρ€Π΅Π΄ΡŒΡŽ ΠΈ мноТитСлями для Basic/Test Ρ‚ΠΎΠΊΠ΅Π½ΠΎΠ²
  • πŸ”„ Умная Π›ΠΎΠ³ΠΈΠΊΠ° ΠŸΠΎΠ²Ρ‚ΠΎΡ€ΠΎΠ² - Π­ΠΊΡΠΏΠΎΠ½Π΅Π½Ρ†ΠΈΠ°Π»ΡŒΠ½Π°Ρ Π·Π°Π΄Π΅Ρ€ΠΆΠΊΠ° для Π²Ρ€Π΅ΠΌΠ΅Π½Π½Ρ‹Ρ… сбоСв с ΠΏΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠΎΠΉ Ρ‚Π°ΠΉΠΌΠ°ΡƒΡ‚Π° для ΠΊΠ°ΠΆΠ΄ΠΎΠ³ΠΎ запроса
  • πŸ›‘οΈ Богатая ΠžΠ±Ρ€Π°Π±ΠΎΡ‚ΠΊΠ° Ошибок - Випизированная иСрархия ошибок с ΠΏΠΎΠ΄Ρ€ΠΎΠ±Π½Ρ‹ΠΌΠΈ рСкомСндациями
  • πŸ“¦ Tree-Shakeable - Двойная сборка ESM/CommonJS, ΠΈΠΌΠΏΠΎΡ€Ρ‚ΠΈΡ€ΡƒΠΉΡ‚Π΅ Ρ‚ΠΎΠ»ΡŒΠΊΠΎ Ρ‚ΠΎ, Ρ‡Ρ‚ΠΎ Π½ΡƒΠΆΠ½ΠΎ (<100KB gzip)
  • βœ… ΠŸΡ€ΠΎΠ²Π΅Ρ€Π΅Π½ΠΎ Π² Π‘ΠΎΡŽ - 2,376 тСстов для всСх ΠΌΠΎΠ΄ΡƒΠ»Π΅ΠΉ
  • 🎯 100% ΠŸΠΎΠΊΡ€Ρ‹Ρ‚ΠΈΠ΅ API - ВсС эндпоинты YAML Ρ€Π΅Π°Π»ΠΈΠ·ΠΎΠ²Π°Π½Ρ‹, Π²ΠΊΠ»ΡŽΡ‡Π°Ρ ЀинансовыС ΠžΡ‚Ρ‡Π΅Ρ‚Ρ‹ v1 ΠΈ Π­ΠΊΠ²Π°ΠΉΡ€ΠΈΠ½Π³
  • πŸ“š Полная ДокумСнтация - Π‘ΠΏΡ€Π°Π²ΠΎΡ‡Π½ΠΈΠΊ API, 44 руководства, ΠΏΡ€ΠΈΠΌΠ΅Ρ€Ρ‹ Π½Π° английском ΠΈ русском
  • πŸ”§ Π‘Π΅Π· Настройки - Π Π°Π±ΠΎΡ‚Π°Π΅Ρ‚ ΠΈΠ· ΠΊΠΎΡ€ΠΎΠ±ΠΊΠΈ с Ρ€Π°Π·ΡƒΠΌΠ½Ρ‹ΠΌΠΈ значСниями ΠΏΠΎ ΡƒΠΌΠΎΠ»Ρ‡Π°Π½ΠΈΡŽ
  • πŸ’° ЀинансовыС ΠžΡ‚Ρ‡Π΅Ρ‚Ρ‹ v1 - ΠžΡ‚Ρ‡Π΅Ρ‚Ρ‹ ΠΎ ΠΏΡ€ΠΎΠ΄Π°ΠΆΠ°Ρ… ΠΈ эквайрингС с Ρ…Π΅Π»ΠΏΠ΅Ρ€ΠΎΠΌ parseMoneyAmount() ΠΈ union-Ρ‚ΠΈΠΏΠ°ΠΌΠΈ ΠΏΠΎΠ»Π΅ΠΉ для автодополнСния
  • πŸ”” Π£Ρ‚ΠΈΠ»ΠΈΡ‚Ρ‹ Для Π£ΡΡ‚Π°Ρ€Π΅Π²ΡˆΠΈΡ… ΠœΠ΅Ρ‚ΠΎΠ΄ΠΎΠ² - warnOnce() ΠΈ resetDeprecationWarnings() для ΡƒΠ΄ΠΎΠ±Π½ΠΎΠΉ ΠΌΠΈΠ³Ρ€Π°Ρ†ΠΈΠΈ

Π§Ρ‚ΠΎ Π½ΠΎΠ²ΠΎΠ³ΠΎ (v4.1.0) β€” Июль 2026

πŸ†• ΠžΡ†Π΅Π½ΠΊΠ° Ρ‚ΠΎΠ²Π°Ρ€Π° v2 β€” sdk.analytics.getItemRatingV2() Ρ€Π΅Π°Π»ΠΈΠ·ΡƒΠ΅Ρ‚ POST /api/analytics/v2/item-rating, Π²ΠΊΠ»ΡŽΡ‡Π°Ρ onlyShadowedNms ΠΈ items[].isShadowed для ΠΎΡ‚Ρ‡Ρ‘Ρ‚Π° ΠΏΠΎ скрытым ΠΈΠ· ΠΊΠ°Ρ‚Π°Π»ΠΎΠ³Π° Ρ‚ΠΎΠ²Π°Ρ€Π°ΠΌ.

⚠️ Π”Π΅Π΄Π»Π°ΠΉΠ½ ΠΌΠΈΠ³Ρ€Π°Ρ†ΠΈΠΈ: 30 июля 2026 β€” Wildberries ΠΎΡ‚ΠΊΠ»ΡŽΡ‡ΠΈΡ‚ ΠžΡ†Π΅Π½ΠΊΡƒ Ρ‚ΠΎΠ²Π°Ρ€Π° v1 ΠΈ ΠΎΡ‚Π΄Π΅Π»ΡŒΠ½Ρ‹ΠΉ ΠΎΡ‚Ρ‡Ρ‘Ρ‚ ΠΏΠΎ скрытым Ρ‚ΠΎΠ²Π°Ρ€Π°ΠΌ. Π—Π°ΠΌΠ΅Π½ΠΈΡ‚Π΅ sdk.analytics.getItemRating() ΠΈ sdk.reports.getBannedProductsShadowed() Π½Π° ΠΌΠ΅Ρ‚ΠΎΠ΄ v2.

πŸ“– Руководство ΠΏΠΎ ΠΌΠΈΠ³Ρ€Π°Ρ†ΠΈΠΈ ΠžΡ†Π΅Π½ΠΊΠΈ Ρ‚ΠΎΠ²Π°Ρ€Π° v1 β†’ v2

Π§Ρ‚ΠΎ Π½ΠΎΠ²ΠΎΠ³ΠΎ (v3.15.0) β€” Май 2026

⚠️ Π”Π΅Π΄Π»Π°ΠΉΠ½ ΠΏΡ€ΠΎΠ²Π΅Ρ€ΠΊΠΈ ΠΌΠ°Ρ€ΠΊΠΈΡ€ΠΎΠ²ΠΊΠΈ FBS: 2026-06-03 β€” WB Π½Π°Ρ‡ΠΈΠ½Π°Π΅Ρ‚ ΡΠ΅Ρ€Π²Π΅Ρ€Π½ΡƒΡŽ ΠΏΡ€ΠΎΠ²Π΅Ρ€ΠΊΡƒ ΠΊΠΎΠ΄ΠΎΠ² ЧСстного Π·Π½Π°ΠΊΠ° для B2C-Π·Π°ΠΊΠ°Π·ΠΎΠ² FBS. НСкоррСктныС ΠΊΠΎΠ΄Ρ‹ β†’ HTTP 409 с Π½ΠΎΠ²Ρ‹ΠΌ диагностичСским ΠΏΠΎΠ»Π΅ΠΌ metaDetails[] Π½Π° PATCH /api/v3/supplies/{supplyId}/deliver (ΠΌΠ΅Ρ‚ΠΎΠ΄ sdk.ordersFBS.updateSuppliesDeliver()). ΠšΠΎΠ΄Ρ‹ ΠΏΠ΅Ρ€Π΅Π΄Π°ΡŽΡ‚ΡΡ ΠΏΠΎΠ»Π½ΠΎΡΡ‚ΡŒΡŽ β€” с GS-раздСлитСлями ΠΈ криптохвостом.

πŸ†• Новый класс MetaValidationFailError β€” import { MetaValidationFailError } from 'daytona-wildberries-typescript-sdk'. НаслСдуСтся ΠΎΡ‚ WBAPIError; Ρ‚ΠΈΠΏΠΈΠ·ΠΈΡ€ΠΎΠ²Π°Π½Π½ΠΎ ΠΎΡ‚ΠΊΡ€Ρ‹Π²Π°Π΅Ρ‚ metaDetails: MetaDetail[] ΠΈ code: string. ΠžΠ±Ρ€Π°Ρ‚Π½ΠΎΡΠΎΠ²ΠΌΠ΅ΡΡ‚ΠΈΠΌΠΎ β€” ΡΡƒΡ‰Π΅ΡΡ‚Π²ΡƒΡŽΡ‰ΠΈΠ΅ instanceof WBAPIError ΠΏΡ€ΠΎΠ΄ΠΎΠ»ΠΆΠ°ΡŽΡ‚ Ρ€Π°Π±ΠΎΡ‚Π°Ρ‚ΡŒ.

πŸ›  Новый Ρ…Π΅Π»ΠΏΠ΅Ρ€ parseMetaValidationFail() β€” ΠΏΡ€ΠΈΠ²ΠΎΠ΄ΠΈΡ‚ Π»ΡŽΠ±ΡƒΡŽ ΠΏΠΎΠΉΠΌΠ°Π½Π½ΡƒΡŽ ΠΎΡˆΠΈΠ±ΠΊΡƒ ΠΊ { code, message, metaDetails } | null Π±Π΅Π· ΠΈΠΌΠΏΠΎΡ€Ρ‚Π° класса. Π£Π΄ΠΎΠ±Π½ΠΎ для ΠΎΠ±Ρ‰ΠΈΡ… error boundary.

⚑ Π¨Ρ‚Ρ€Π°Ρ„ rate-limit Γ—10: ΠΊΠ°ΠΆΠ΄Ρ‹ΠΉ ΠΎΡ‚Π²Π΅Ρ‚ 409 Π½Π° updateSuppliesDeliver учитываСтся ΠΊΠ°ΠΊ 10 запросов. Π“Π°ΠΉΠ΄ ΠΌΠΈΠ³Ρ€Π°Ρ†ΠΈΠΈ Ρ€Π΅ΠΊΠΎΠΌΠ΅Π½Π΄ΡƒΠ΅Ρ‚ ΠΏΡ€Π΅Π΄Π²Π°Ρ€ΠΈΡ‚Π΅Π»ΡŒΠ½ΡƒΡŽ ΠΏΡ€ΠΎΠ²Π΅Ρ€ΠΊΡƒ Ρ‡Π΅Ρ€Π΅Π· sdk.ordersFBS.getOrdersMetaBulk(), Ρ‡Ρ‚ΠΎΠ±Ρ‹ Π½Π΅ Π²Ρ‹ΠΆΠΈΠ³Π°Ρ‚ΡŒ ΠΊΠ²ΠΎΡ‚Ρƒ.

ΠŸΠΎΠ΄Ρ€ΠΎΠ±Π½ΠΎΡΡ‚ΠΈ β€” Π² CHANGELOG v3.15.0 ΠΈ руководствС ΠΏΠΎ ΠΌΠΈΠ³Ρ€Π°Ρ†ΠΈΠΈ с ΠΏΠΎΠ»Π½Ρ‹ΠΌ ΠΊΠ°Ρ‚Π°Π»ΠΎΠ³ΠΎΠΌ ΠΏΠ°Ρ‚Ρ‚Π΅Ρ€Π½ΠΎΠ², ΠΌΠ°Ρ‚Ρ€ΠΈΡ†Π΅ΠΉ Ρ€Π΅ΡˆΠ΅Π½ΠΈΠΉ ΠΈ FAQ.

Π§Ρ‚ΠΎ Π½ΠΎΠ²ΠΎΠ³ΠΎ (v3.14.0) β€” Май 2026

🚨 Π‘ΠΊΡ€Ρ‹Ρ‚ΠΎΠ΅ ΠΈΠ·ΠΌΠ΅Π½Π΅Π½ΠΈΠ΅ сСмантики, Π΄Π΅Π΄Π»Π°ΠΉΠ½ 2026-06-16 β€” WB мСняСт Ρ„ΠΈΠ»ΡŒΡ‚Ρ€ withPhoto: Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅ 0 (ΠΈΠ»ΠΈ отсутствиС ΠΏΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Π°) Π±ΡƒΠ΄Π΅Ρ‚ ΠΎΠ·Π½Π°Ρ‡Π°Ρ‚ΡŒ Β«Π’Π‘Π• ΠΊΠ°Ρ€Ρ‚ΠΎΡ‡ΠΊΠΈΒ» вмСсто Β«Ρ‚ΠΎΠ»ΡŒΠΊΠΎ Π±Π΅Π· Ρ„ΠΎΡ‚ΠΎΒ». НовоС Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅ withPhoto: 2 замСняСт ΠΏΡ€Π΅ΠΆΠ½ΡŽΡŽ сСмантику 0. HTTP 200, Π½Π΅Ρ‚ ошибки, Π½Π΅Ρ‚ сигнала β€” Π½Π΅ΠΏΡ€Π°Π²ΠΈΠ»ΡŒΠ½Ρ‹Π΅ Π΄Π°Π½Π½Ρ‹Π΅. ΠœΠΈΠ³Ρ€ΠΈΡ€ΡƒΠΉΡ‚Π΅ Π΄ΠΎ Π΄Π΅Π΄Π»Π°ΠΉΠ½Π°.

πŸ†• Новая константа WITH_PHOTO_FILTER β€” import { WITH_PHOTO_FILTER } from 'daytona-wildberries-typescript-sdk'. Π˜ΡΠΏΠΎΠ»ΡŒΠ·ΡƒΠΉΡ‚Π΅ WITH_PHOTO_FILTER.NO_PHOTO (= 2), WITH_PHOTO_FILTER.WITH_PHOTO (= 1) ΠΈΠ»ΠΈ WITH_PHOTO_FILTER.ALL (= -1) вмСсто магичСских чисСл.

πŸ”” ΠŸΡ€Π΅Π΄ΡƒΠΏΡ€Π΅ΠΆΠ΄Π΅Π½ΠΈΠ΅ ΠΏΡ€ΠΈ ΠΏΠ΅Ρ€Π²ΠΎΠΌ Π²Ρ‹Π·ΠΎΠ²Π΅: ΠΏΠ΅Ρ€Π²Ρ‹ΠΉ Π²Ρ‹Π·ΠΎΠ² с withPhoto: 0 Π²Ρ‹Π²ΠΎΠ΄ΠΈΡ‚ console.warn со ссылкой Π½Π° руководство ΠΏΠΎ ΠΌΠΈΠ³Ρ€Π°Ρ†ΠΈΠΈ ΠΈ Π΄Π΅Π΄Π»Π°ΠΉΠ½ΠΎΠΌ. Π˜ΡΠΏΠΎΠ»ΡŒΠ·ΡƒΠΉΡ‚Π΅ resetDeprecationWarnings() Π² тСстах.

ΠŸΠΎΠ΄Ρ€ΠΎΠ±Π½ΠΎΡΡ‚ΠΈ β€” Π² CHANGELOG v3.14.0 ΠΈ руководствС ΠΏΠΎ ΠΌΠΈΠ³Ρ€Π°Ρ†ΠΈΠΈ с ΠΏΠΎΠ»Π½ΠΎΠΉ ΠΌΠ°Ρ‚Ρ€ΠΈΡ†Π΅ΠΉ ΠΌΠΈΠ³Ρ€Π°Ρ†ΠΈΠΈ ΠΈ ΠΏΡ€ΠΈΠΌΠ΅Ρ€Π°ΠΌΠΈ ΠΊΠΎΠ΄Π°.

Π§Ρ‚ΠΎ Π½ΠΎΠ²ΠΎΠ³ΠΎ (v3.13.0) β€” Май 2026

πŸ”§ ΠšΡ€ΠΈΡ‚ΠΈΡ‡Π΅ΡΠΊΠΎΠ΅ исправлСниС: sdk.communications.createSellerMessage() Ρ‚Π΅ΠΏΠ΅Ρ€ΡŒ Ρ€Π°Π±ΠΎΡ‚Π°Π΅Ρ‚ β€” ΠΌΠ΅Ρ‚ΠΎΠ΄ Ρ€Π°Π½Π΅Π΅ отправлял пустоС Ρ‚Π΅Π»ΠΎ ΠΏΡ€ΠΈ ΠΊΠ°ΠΆΠ΄ΠΎΠΌ Π²Ρ‹Π·ΠΎΠ²Π΅ (сломан с ΠΌΠΎΠΌΠ΅Π½Ρ‚Π° появлСния). v3.13.0 Ρ‚Ρ€Π΅Π±ΡƒΠ΅Ρ‚ ΠΏΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€ data: SellerMessageRequest. Π‘ΡƒΡ‰Π΅ΡΡ‚Π²ΡƒΡŽΡ‰ΠΈΠ΅ Π²Ρ‹Π·ΠΎΠ²Ρ‹ createSellerMessage() Π±Π΅Π· Π°Ρ€Π³ΡƒΠΌΠ΅Π½Ρ‚ΠΎΠ² пСрСстанут ΠΊΠΎΠΌΠΏΠΈΠ»ΠΈΡ€ΠΎΠ²Π°Ρ‚ΡŒΡΡ β€” это Π½Π°ΠΌΠ΅Ρ€Π΅Π½Π½ΠΎ; старая сигнатура Π½ΠΈΠΊΠΎΠ³Π΄Π° Π½Π΅ Ρ€Π°Π±ΠΎΡ‚Π°Π»Π°.

⚠️ Π”Π΅Π΄Π»Π°ΠΉΠ½ Ρ„ΠΎΡ€ΠΌΠ°Ρ‚Π° replySign: 2026-06-04 β€” WB ΠΎΠ±Π½ΠΎΠ²ΠΈΠ» Ρ„ΠΎΡ€ΠΌΠ°Ρ‚ поля replySign. Π‘Ρ‚Π°Ρ€Ρ‹Π΅ значСния, ΠΊΡΡˆΠΈΡ€ΠΎΠ²Π°Π½Π½Ρ‹Π΅ Π΄ΠΎ этой Π΄Π°Ρ‚Ρ‹, Π±ΡƒΠ΄ΡƒΡ‚ ΠΎΡ‚ΠΊΠ»ΠΎΠ½ΡΡ‚ΡŒΡΡ с HTTP 400 послС Π΄Π΅Π΄Π»Π°ΠΉΠ½Π°. ВсСгда обновляйтС Ρ‡Π΅Ρ€Π΅Π· getSellerChats() ΠΏΠ΅Ρ€Π΅Π΄ Π²Ρ‹Π·ΠΎΠ²ΠΎΠΌ createSellerMessage().

πŸ†• Новый экспортируСмый Ρ‚ΠΈΠΏ: SellerMessageRequest β€” import type { SellerMessageRequest } from 'daytona-wildberries-typescript-sdk'.

πŸ”” Эвристика warn-once: SDK Π²Ρ‹Π²ΠΎΠ΄ΠΈΡ‚ ΠΎΠ΄Π½ΠΎΡ€Π°Π·ΠΎΠ²ΠΎΠ΅ console.warn, Ссли ΠΎΠ±Π½Π°Ρ€ΡƒΠΆΠΈΠ²Π°Π΅Ρ‚ вСроятный replySign старого Ρ„ΠΎΡ€ΠΌΠ°Ρ‚Π°. Π’ тСстах ΠΈΡΠΏΠΎΠ»ΡŒΠ·ΡƒΠΉΡ‚Π΅ resetDeprecationWarnings().

ΠŸΠΎΠ΄Ρ€ΠΎΠ±Π½ΠΎΡΡ‚ΠΈ β€” Π² CHANGELOG v3.13.0 ΠΈ руководствС ΠΏΠΎ ΠΌΠΈΠ³Ρ€Π°Ρ†ΠΈΠΈ.

Π§Ρ‚ΠΎ Π½ΠΎΠ²ΠΎΠ³ΠΎ (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 ΠΈ Π² руководствС ΠΏΠΎ ΠΌΠΈΠ³Ρ€Π°Ρ†ΠΈΠΈ.

Π§Ρ‚ΠΎ Π½ΠΎΠ²ΠΎΠ³ΠΎ (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.

Π§Ρ‚ΠΎ Π½ΠΎΠ²ΠΎΠ³ΠΎ (v3.10.2 hotfix)

πŸ”§ Π˜ΡΠΏΡ€Π°Π²Π»Π΅Π½ΠΈΠ΅: validateRequiredCharacteristics ΠΈ validateMergedCardVariants Ρ‚Π΅ΠΏΠ΅Ρ€ΡŒ ΠΊΠΎΡ€Ρ€Π΅ΠΊΡ‚Π½ΠΎ ΠΎΠ±Ρ€Π°Π±Π°Ρ‚Ρ‹Π²Π°ΡŽΡ‚ характСристики с existNamedField:true (Π±Ρ€Π΅Π½Π΄, высота, Π΄Π»ΠΈΠ½Π° ΠΈ Ρ‚.Π΄.). ΠŸΠΎΠ΄Ρ€ΠΎΠ±Π½ΠΎΡΡ‚ΠΈ ΠΌΠΈΠ³Ρ€Π°Ρ†ΠΈΠΈ β€” Π² CHANGELOG v3.10.2.

Π§Ρ‚ΠΎ Нового (v3.10.0) β€” Май 2026

πŸ†• АгрСгаторный ΠΌΠΎΠ΄ΡƒΠ»ΡŒ sdk.returns β€” Π΅Π΄ΠΈΠ½Ρ‹ΠΉ источник истины для Π°Π½Π°Π»ΠΈΡ‚ΠΈΠΊΠΈ Π²ΠΎΠ·Π²Ρ€Π°Ρ‚ΠΎΠ². ΠžΠ±ΡŠΠ΅Π΄ΠΈΠ½ΡΠ΅Ρ‚ источники FBO + FBS + Finance Ρ‡Π΅Ρ€Π΅Π· Promise.allSettled с Π΄Π΅Π΄ΡƒΠΏΠ»ΠΈΠΊΠ°Ρ†ΠΈΠ΅ΠΉ ΠΏΠΎ srid ΠΈ Ρ‚Π΅Π»Π΅ΠΌΠ΅Ρ‚Ρ€ΠΈΠ΅ΠΉ ΠΏΠΎ ΠΊΠ°ΠΆΠ΄ΠΎΠΌΡƒ источнику. Π’Ρ€ΠΈ ΠΌΠ΅Ρ‚ΠΎΠ΄Π°:

  • sdk.returns.getReturns({ dateFrom, dateTo, ... }) β€” основной Π°Π³Ρ€Π΅Π³Π°Ρ‚ΠΎΡ€ с ΡƒΡΡ‚ΠΎΠΉΡ‡ΠΈΠ²ΠΎΡΡ‚ΡŒΡŽ ΠΊ частичным сбоям
  • sdk.returns.getReturnByOrderId(orderId, ...) β€” поиск ΠΎΠ΄Π½ΠΎΠΉ записи
  • sdk.returns.getReturnStats({ groupBy: 'nmId' | 'category' | 'orderType' }) β€” агрСгация ΠΏΠΎ Π³Ρ€ΡƒΠΏΠΏΠ°ΠΌ

πŸ†• classifyFbsReturnCategory() β€” эвристичСский Ρ…Π΅Π»ΠΏΠ΅Ρ€: история статусов FBS β†’ enum ΠΊΠ°Ρ‚Π΅Π³ΠΎΡ€ΠΈΠΈ Π²ΠΎΠ·Π²Ρ€Π°Ρ‚Π°

πŸ“š НовоС руководство EN+RU: ΠœΠΎΠ΄ΡƒΠ»ΡŒ Returns с Π΄ΠΈΠ°Π³Ρ€Π°ΠΌΠΌΠΎΠΉ Mermaid, Ρ‚Π°Π±Π»ΠΈΡ†Π΅ΠΉ ΠΎΠ³Ρ€Π°Π½ΠΈΡ‡Π΅Π½ΠΈΠΉ ΠΈ 4 Π³ΠΎΡ‚ΠΎΠ²Ρ‹ΠΌΠΈ Ρ€Π΅Ρ†Π΅ΠΏΡ‚Π°ΠΌΠΈ

βœ… 2207 тСстов проходят, исправлСно 25 Π·Π°ΠΌΠ΅Ρ‡Π°Π½ΠΈΠΉ ΠΏΠΎ code review (всС ΡƒΡ€ΠΎΠ²Π½ΠΈ ΡΠ΅Ρ€ΡŒΡ‘Π·Π½ΠΎΡΡ‚ΠΈ)

  • v3.9.3 -- Ρ…Π΅Π»ΠΏΠ΅Ρ€Ρ‹ classifyReturnReason(), enrichReturnsWithType(), reconcileBuyoutsAndReturns() + Π½ΠΎΠ²ΠΎΠ΅ руководство
  • v3.9.2 -- ΠΏΠΎΠ»Π΅ isVariable + Ρ…Π΅Π»ΠΏΠ΅Ρ€ validateMergedCardVariants()
  • v3.9.1 -- Ρ…Π΅Π»ΠΏΠ΅Ρ€ validateRequiredCharacteristics() для ΠΏΡ€Π΅Π΄Π²Π°Ρ€ΠΈΡ‚Π΅Π»ΡŒΠ½ΠΎΠΉ ΠΏΡ€ΠΎΠ²Π΅Ρ€ΠΊΠΈ ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½Ρ‹Ρ… ΠΏΠΎΠ»Π΅ΠΉ
  • v3.9.0 -- ΠΏΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ° ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½Ρ‹Ρ… характСристик Ρ‚ΠΎΠ²Π°Ρ€ΠΎΠ² (isRequiredForCreate), Ρ‚ΠΈΠΏΡ‹ Π²Π²ΠΎΠ΄Π°/Π²Ρ‹Π²ΠΎΠ΄Π° характСристик, DRY-Ρ€Π΅Ρ„Π°ΠΊΡ‚ΠΎΡ€ΠΈΠ½Π³

Полная история ΠΈΠ·ΠΌΠ΅Π½Π΅Π½ΠΈΠΉ: CHANGELOG.md


⚠️ ΠšΡ€ΠΈΡ‚ΠΈΡ‡Π΅ΡΠΊΠΎΠ΅ ОбновлСниС API

Π£Π²Π΅Π΄ΠΎΠΌΠ»Π΅Π½ΠΈΠ΅ ΠΎΠ± устарСвании API Wildberries - Π Π΅ΠΊΠ»Π°ΠΌΠ½Ρ‹ΠΉ API v0/v1 Π±Ρ‹Π» ΠΎΡ‚ΠΊΠ»ΡŽΡ‡Ρ‘Π½ Wildberries 2 фСвраля 2026, Π° ΡΠΎΠΎΡ‚Π²Π΅Ρ‚ΡΡ‚Π²ΡƒΡŽΡ‰ΠΈΠ΅ ΠΌΠ΅Ρ‚ΠΎΠ΄Ρ‹ SDK ΡƒΠ΄Π°Π»Π΅Π½Ρ‹ Π² v4.0.0:

  • getAuctionAdverts() / getPromotionAdverts() - списки Ρ€Π΅ΠΊΠ»Π°ΠΌΠ½Ρ‹Ρ… ΠΊΠ°ΠΌΠΏΠ°Π½ΠΈΠΉ (v0/v1)
  • createAutoUpdatenm() - ОбновлСниС ΠΊΠ°Ρ€Ρ‚ΠΎΡ‡Π΅ΠΊ Ρ‚ΠΎΠ²Π°Ρ€ΠΎΠ² (ΠΊΠ°ΠΌΠΏΠ°Π½ΠΈΠΈ type 8)
  • createAutoSetExcluded() - Установка/ΡƒΠ΄Π°Π»Π΅Π½ΠΈΠ΅ минус-Ρ„Ρ€Π°Π· (ΠΊΠ°ΠΌΠΏΠ°Π½ΠΈΠΈ type 8)
  • getStatsKeywords() / updateAuctionBid() - статистика ΠΏΠΎ ΠΊΠ»ΡŽΡ‡Π΅Π²Ρ‹ΠΌ словам ΠΈ Ρ€ΡƒΡ‡Π½Ρ‹Π΅ ставки (v0/v1)

ВрСбуСтся дСйствиС: ΠŸΠ΅Ρ€Π΅ΠΉΠ΄ΠΈΡ‚Π΅ Π½Π° ΠΌΠ΅Ρ‚ΠΎΠ΄Ρ‹ v2 (Π½Π°ΠΏΡ€ΠΈΠΌΠ΅Ρ€, getAdvertsV2(), updateBids()).

πŸ“– Руководство ΠΏΠΎ ΠΌΠΈΠ³Ρ€Π°Ρ†ΠΈΠΈ v4.0.0


πŸ“¦ Установка

npm install daytona-wildberries-typescript-sdk

ВрСбования

πŸš€ Быстрый Π‘Ρ‚Π°Ρ€Ρ‚

import { WildberriesSDK } from 'daytona-wildberries-typescript-sdk';

// Π˜Π½ΠΈΡ†ΠΈΠ°Π»ΠΈΠ·Π°Ρ†ΠΈΡ SDK с вашим API ΠΊΠ»ΡŽΡ‡ΠΎΠΌ
const sdk = new WildberriesSDK({
  apiKey: process.env.WB_API_KEY! // Π₯Ρ€Π°Π½ΠΈΡ‚Π΅ бСзопасно Π² ΠΏΠ΅Ρ€Π΅ΠΌΠ΅Π½Π½Ρ‹Ρ… окруТСния
});

// ΠŸΡ€ΠΎΠ²Π΅Ρ€ΠΊΠ° ΠΏΠΎΠ΄ΠΊΠ»ΡŽΡ‡Π΅Π½ΠΈΡ
const pingResponse = await sdk.general.ping();
console.log('ΠŸΠΎΠ΄ΠΊΠ»ΡŽΡ‡Π΅Π½ΠΎ:', pingResponse.Status); // 'OK'

// ΠŸΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ ΠΊΠ°Ρ‚Π΅Π³ΠΎΡ€ΠΈΠΉ Ρ‚ΠΎΠ²Π°Ρ€ΠΎΠ²
const categories = await sdk.products.getParentAll();
console.log('ΠšΠ°Ρ‚Π΅Π³ΠΎΡ€ΠΈΠΈ:', categories.data?.length);

// ΠŸΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ Π½ΠΎΠ²Ρ‹Ρ… Π·Π°ΠΊΠ°Π·ΠΎΠ²
const orders = await sdk.ordersFBS.getOrdersNew();
console.log('НовыС Π·Π°ΠΊΠ°Π·Ρ‹:', orders.orders?.length);

// ΠŸΡ€ΠΎΠ²Π΅Ρ€ΠΊΠ° баланса счСта
const balance = await sdk.finances.getAccountBalance();
console.log('Баланс:', balance.for_withdraw, balance.currency);

// ΠžΠ±Π·ΠΎΡ€ Ρ€Π΅ΠΊΠ»Π°ΠΌΠ½Ρ‹Ρ… ΠΊΠ°ΠΌΠΏΠ°Π½ΠΈΠΉ
const campaigns = await sdk.promotion.getCampaignCount();
console.log('ВсСго ΠΊΠ°ΠΌΠΏΠ°Π½ΠΈΠΉ:', campaigns.all);

// Баланс Ρ€Π΅ΠΊΠ»Π°ΠΌΠ½ΠΎΠ³ΠΎ ΠΊΠ°Π±ΠΈΠ½Π΅Ρ‚Π°
const advBalance = await sdk.promotion.getAdvBalance();
console.log('Баланс Ρ€Π΅ΠΊΠ». ΠΊΠ°Π±ΠΈΠ½Π΅Ρ‚Π°:', advBalance.net);

// Бписок Ρ‡Π°Ρ‚ΠΎΠ² с ΠΊΠ»ΠΈΠ΅Π½Ρ‚Π°ΠΌΠΈ ΠΈ послСдними сообщСниями
const chats = await sdk.communications.getSellerChats();
console.log('АктивныС Ρ‡Π°Ρ‚Ρ‹:', chats.result?.length);
chats.result?.forEach(chat => {
  if (chat.lastMessage) {
    console.log(`${chat.clientName}: "${chat.lastMessage.text}"`);
  }
});

ВрСмя Π΄ΠΎ ΠΏΠ΅Ρ€Π²ΠΎΠ³ΠΎ API Π²Ρ‹Π·ΠΎΠ²Π°: <5 ΠΌΠΈΠ½ΡƒΡ‚ πŸš€

πŸ‘‰ ПолноС Руководство ΠΏΠΎ Быстрому Π‘Ρ‚Π°Ρ€Ρ‚Ρƒ

Π Π°ΡΡˆΠΈΡ€Π΅Π½Π½Π°Ρ конфигурация

SDK ΠΏΡ€ΠΈΠ½ΠΈΠΌΠ°Π΅Ρ‚ Π½Π΅ Ρ‚ΠΎΠ»ΡŒΠΊΠΎ apiKey. НастройтС Ρ‚Π°ΠΉΠΌΠ°ΡƒΡ‚, Π»ΠΎΠ³ΠΈΠΊΡƒ ΠΏΠΎΠ²Ρ‚ΠΎΡ€ΠΎΠ², Π»ΠΈΠΌΠΈΡ‚Ρ‹ запросов ΠΈ Π»ΠΎΠ³ΠΈΡ€ΠΎΠ²Π°Π½ΠΈΠ΅:

const sdk = new WildberriesSDK({
  apiKey: process.env.WB_API_KEY!,
  timeout: 60000,                    // Π“Π»ΠΎΠ±Π°Π»ΡŒΠ½Ρ‹ΠΉ Ρ‚Π°ΠΉΠΌΠ°ΡƒΡ‚ (ΠΏΠΎ ΡƒΠΌΠΎΠ»Ρ‡Π°Π½ΠΈΡŽ: 30000мс)
  logLevel: 'info',                  // 'debug' | 'info' | 'warn' | 'error'
  retryConfig: {
    maxRetries: 5,
    retryDelay: 2000,
    exponentialBackoff: true,
  },
});

// Для ΠΌΠ΅Π΄Π»Π΅Π½Π½Ρ‹Ρ… ΠΎΠΏΠ΅Ρ€Π°Ρ†ΠΈΠΉ создайтС экзСмпляр SDK с ΡƒΠ²Π΅Π»ΠΈΡ‡Π΅Π½Π½Ρ‹ΠΌ Ρ‚Π°ΠΉΠΌΠ°ΡƒΡ‚ΠΎΠΌ
const longTimeoutSdk = new WildberriesSDK({
  apiKey: process.env.WB_API_KEY!,
  timeout: 120000,                   // 2 ΠΌΠΈΠ½ для скачивания ΠΎΡ‚Ρ‡Π΅Ρ‚ΠΎΠ²
});
const reportFile = await longTimeoutSdk.analytics.getDownloadsFile(downloadId);

πŸ‘‰ Руководство ΠΏΠΎ ΠΊΠΎΠ½Ρ„ΠΈΠ³ΡƒΡ€Π°Ρ†ΠΈΠΈ


πŸ“Š Бтатус ΠŸΡ€ΠΎΠ΅ΠΊΡ‚Π° ΠΈ Π Π°Π·Ρ€Π°Π±ΠΎΡ‚ΠΊΠ°

Π’Π΅ΠΊΡƒΡ‰ΠΈΠΉ Бтатус: 🟒 Production Ready | ВСрсия SDK: 4.1.0

πŸ“– Project Status Summary β€” ΠšΠΎΠΌΠΏΠ»Π΅ΠΊΡΠ½Ρ‹ΠΉ ΠΎΠ±Π·ΠΎΡ€ всСх эпиков, историй ΠΈ статуса Ρ€Π΅Π°Π»ΠΈΠ·Π°Ρ†ΠΈΠΈ.

ΠšΡ€Π°Ρ‚ΠΊΠ°Ρ Бтатистика

ΠœΠ΅Ρ‚Ρ€ΠΈΠΊΠ° Π—Π½Π°Ρ‡Π΅Π½ΠΈΠ΅
API ΠΌΠΎΠ΄ΡƒΠ»ΠΈ 14 (100%)
API эндпоинты 240+ Ρ€Π΅Π°Π»ΠΈΠ·ΠΎΠ²Π°Π½ΠΎ
ВСсты 2,376 тСстов проходят
ДокумСнтация 44 руководства, 22 ΠΏΡ€ΠΈΠΌΠ΅Ρ€Π°
Π Π°Π·ΠΌΠ΅Ρ€ Π±Π°Π½Π΄Π»Π° ~91KB gzipped (ESM)

⚠️ Для ΠΊΠΎΠ½Ρ‚Ρ€ΠΈΠ±ΡŒΡŽΡ‚ΠΎΡ€ΠΎΠ²: ΠŸΡ€ΠΈ создании ΠΈΠ»ΠΈ Π·Π°Π²Π΅Ρ€ΡˆΠ΅Π½ΠΈΠΈ эпиков/историй обновляйтС PROJECT_STATUS_SUMMARY.md, Ρ‡Ρ‚ΠΎΠ±Ρ‹ статус ΠΏΡ€ΠΎΠ΅ΠΊΡ‚Π° оставался Π°ΠΊΡ‚ΡƒΠ°Π»ΡŒΠ½Ρ‹ΠΌ. Π­Ρ‚ΠΎΡ‚ Ρ„Π°ΠΉΠ» автоматичСски гСнСрируСтся ΠΈ Π΄ΠΎΠ»ΠΆΠ΅Π½ ΠΎΡ‚Ρ€Π°ΠΆΠ°Ρ‚ΡŒ послСднСС состояниС Ρ€Π΅Π°Π»ΠΈΠ·Π°Ρ†ΠΈΠΈ.


πŸ“š ДокумСнтация

Начало Π Π°Π±ΠΎΡ‚Ρ‹

Руководства

🎯 ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΈΠ²Π°Π΅ΠΌΡ‹Π΅ ΠœΠΎΠ΄ΡƒΠ»ΠΈ API

ВсС 14 ΠΌΠΎΠ΄ΡƒΠ»Π΅ΠΉ Wildberries API ΠΏΠΎΠ»Π½ΠΎΡΡ‚ΡŒΡŽ ΠΏΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΈΠ²Π°ΡŽΡ‚ΡΡ со 100% ΠΏΠΎΠΊΡ€Ρ‹Ρ‚ΠΈΠ΅ΠΌ API:

ΠœΠΎΠ΄ΡƒΠ»ΡŒ ОписаниС
General Ping, новости, информация ΠΎ ΠΏΡ€ΠΎΠ΄Π°Π²Ρ†Π΅, Jam-подписка, Ρ€Π΅ΠΉΡ‚ΠΈΠ½Π³ ΠΏΡ€ΠΎΠ΄Π°Π²Ρ†Π°
Products ΠšΠ°Ρ‚Π΅Π³ΠΎΡ€ΠΈΠΈ, CRUD, ΠΌΠ΅Π΄ΠΈΠ°, Ρ†Π΅Π½ΠΎΠΎΠ±Ρ€Π°Π·ΠΎΠ²Π°Π½ΠΈΠ΅, склад, запасы, ΠΏΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ° kizMarked
Orders FBS Π’Ρ‹ΠΏΠΎΠ»Π½Π΅Π½ΠΈΠ΅ ΠΏΡ€ΠΎΠ΄Π°Π²Ρ†ΠΎΠΌ, статус Π·Π°ΠΊΠ°Π·Π°, доставка, поставки, валидация ΠΌΠ΅Ρ‚Π°Π΄Π°Π½Π½Ρ‹Ρ…
Orders FBW Π’Ρ‹ΠΏΠΎΠ»Π½Π΅Π½ΠΈΠ΅ складом WB, ΠΏΠ»Π°Π½ΠΈΡ€ΠΎΠ²Π°Π½ΠΈΠ΅ поставок, информация ΠΎ ΠΏΠΎΠΊΡƒΠΏΠ°Ρ‚Π΅Π»Π΅
Orders DBS Доставка ΠŸΡ€ΠΎΠ΄Π°Π²Ρ†ΠΎΠΌ - массовыС ΠΎΠΏΠ΅Ρ€Π°Ρ†ΠΈΠΈ, ΠΏΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ° B2B, ΠΌΠ°Ρ€ΠΊΠΈΡ€ΠΎΠ²ΠΊΠ° (SGTIN, IMEI)
Finances Баланс, Ρ‚Ρ€Π°Π½Π·Π°ΠΊΡ†ΠΈΠΈ, ΠžΡ‚Ρ‡Π΅Ρ‚Ρ‹ ΠΎ ΠŸΡ€ΠΎΠ΄Π°ΠΆΠ°Ρ… v1, Π­ΠΊΠ²Π°ΠΉΡ€ΠΈΠ½Π³, parseMoneyAmount(), union-Ρ‚ΠΈΠΏΡ‹ ΠΏΠΎΠ»Π΅ΠΉ
Analytics Π’ΠΎΡ€ΠΎΠ½ΠΊΠ° ΠΏΡ€ΠΎΠ΄Π°ΠΆ, поисковыС запросы, история запасов, запасы Π½Π° складах WB, CSV ΠΎΡ‚Ρ‡Π΅Ρ‚Ρ‹
Reports ΠžΡ‚Ρ‡Π΅Ρ‚Ρ‹ ΠΎ Π΄ΠΎΡ…ΠΎΠ΄Π°Ρ…, ΠΎΡ‚Ρ‡Π΅Ρ‚Ρ‹ ΠΎ ΠΏΡ€ΠΎΠ΄Π°ΠΆΠ°Ρ…, экспорт Π΄Π°Π½Π½Ρ‹Ρ…
Communications Π§Π°Ρ‚ с ΠΊΠ»ΠΈΠ΅Π½Ρ‚Π°ΠΌΠΈ, вопросы-ΠΎΡ‚Π²Π΅Ρ‚Ρ‹ ΠΏΠΎ Ρ‚ΠΎΠ²Π°Ρ€Π°ΠΌ, ΡƒΠΏΡ€Π°Π²Π»Π΅Π½ΠΈΠ΅ ΠΎΡ‚Π·Ρ‹Π²Π°ΠΌΠΈ, Π·Π°ΠΊΡ€Π΅ΠΏΠ»Ρ‘Π½Π½Ρ‹Π΅ ΠΎΡ‚Π·Ρ‹Π²Ρ‹
Promotion Кампании, ставки, минус-Ρ„Ρ€Π°Π·Ρ‹, Ρ€Π΅ΠΊΠ»Π°ΠΌΠ°
Tariffs Π‘Ρ‚Π°Π²ΠΊΠΈ комиссий, Ρ‚Π°Ρ€ΠΈΡ„Π½Ρ‹Π΅ ΠΏΠ»Π°Π½Ρ‹
In-Store Pickup Π—Π°ΠΊΠ°Π·Ρ‹ с самовывозом ΠΈ ΡƒΠΏΡ€Π°Π²Π»Π΅Π½ΠΈΠ΅
User Management Π£ΠΏΡ€Π°Π²Π»Π΅Π½ΠΈΠ΅ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»ΡΠΌΠΈ профиля ΠΏΡ€ΠΎΠ΄Π°Π²Ρ†Π°
Returns АгрСгатор Π²ΠΎΠ·Π²Ρ€Π°Ρ‚ΠΎΠ² (FBO + FBS + Finance), getReturns(), getReturnByOrderId(), getReturnStats()

πŸ“„ ЛицСнзия

ЛицСнзия для Π›ΠΈΡ‡Π½ΠΎΠ³ΠΎ Использования - БСсплатно для Π»ΠΈΡ‡Π½ΠΎΠ³ΠΎ, ΠΎΠ±Ρ€Π°Π·ΠΎΠ²Π°Ρ‚Π΅Π»ΡŒΠ½ΠΎΠ³ΠΎ ΠΈ нСкоммСрчСского использования.

βœ… Π Π°Π·Ρ€Π΅ΡˆΠ΅Π½ΠΎ:

  • Π›ΠΈΡ‡Π½ΠΎΠ΅ нСкоммСрчСскоС использованиС
  • ΠžΠ±Ρ€Π°Π·ΠΎΠ²Π°Ρ‚Π΅Π»ΡŒΠ½Ρ‹Π΅ Ρ†Π΅Π»ΠΈ
  • Open source ΠΏΡ€ΠΎΠ΅ΠΊΡ‚Ρ‹ (нСкоммСрчСскиС)
  • ΠžΠ±ΡƒΡ‡Π΅Π½ΠΈΠ΅ ΠΈ Ρ€Π°Π·Π²ΠΈΡ‚ΠΈΠ΅ Π½Π°Π²Ρ‹ΠΊΠΎΠ²

❌ Π—Π°ΠΏΡ€Π΅Ρ‰Π΅Π½ΠΎ Π‘Π΅Π· ΠšΠΎΠΌΠΌΠ΅Ρ€Ρ‡Π΅ΡΠΊΠΎΠΉ Π›ΠΈΡ†Π΅Π½Π·ΠΈΠΈ:

  • ΠšΠΎΠΌΠΌΠ΅Ρ€Ρ‡Π΅ΡΠΊΠΎΠ΅ использованиС Π² бизнСс-срСдС
  • ΠŸΡ€ΠΎΠ΄Π°ΠΆΠ° ΠΈΠ»ΠΈ монСтизация SDK
  • ΠŸΡ€Π΅Π΄ΠΎΡΡ‚Π°Π²Π»Π΅Π½ΠΈΠ΅ ΠΏΠ»Π°Ρ‚Π½Ρ‹Ρ… услуг Π½Π° основС SDK
  • ИспользованиС Π² коммСрчСских ΠΏΡ€ΠΎΠ΄ΡƒΠΊΡ‚Π°Ρ…/сСрвисах

Для коммСрчСского использования, поТалуйста, ΡΠ²ΡΠΆΠΈΡ‚Π΅ΡΡŒ для получСния Π»ΠΈΡ†Π΅Π½Π·ΠΈΠΈ.

Π‘ΠΌ. Ρ„Π°ΠΉΠ» LICENSE для ΠΏΠΎΠ»Π½Ρ‹Ρ… условий.

🀝 УчастиС Π² ΠŸΡ€ΠΎΠ΅ΠΊΡ‚Π΅

ΠœΡ‹ привСтствуСм Π²ΠΊΠ»Π°Π΄! Π‘ΡƒΠ΄ΡŒ Ρ‚ΠΎ сообщСния ΠΎΠ± ΠΎΡˆΠΈΠ±ΠΊΠ°Ρ…, запросы Ρ„ΡƒΠ½ΠΊΡ†ΠΈΠΉ, ΡƒΠ»ΡƒΡ‡ΡˆΠ΅Π½ΠΈΡ Π΄ΠΎΠΊΡƒΠΌΠ΅Π½Ρ‚Π°Ρ†ΠΈΠΈ ΠΈΠ»ΠΈ ΠΊΠΎΠ΄.

β†’ Руководство ΠΏΠΎ Π£Ρ‡Π°ΡΡ‚ΠΈΡŽ

πŸ“ž ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

⚠️ ΠžΡ‚ΠΊΠ°Π· ΠΎΡ‚ ΠžΡ‚Π²Π΅Ρ‚ΡΡ‚Π²Π΅Π½Π½ΠΎΡΡ‚ΠΈ

Π­Ρ‚ΠΎ Π½Π΅ΠΎΡ„ΠΈΡ†ΠΈΠ°Π»ΡŒΠ½Ρ‹ΠΉ SDK. НС Π°Ρ„Ρ„ΠΈΠ»ΠΈΡ€ΠΎΠ²Π°Π½, Π½Π΅ поддСрТиваСтся ΠΎΡ„ΠΈΡ†ΠΈΠ°Π»ΡŒΠ½ΠΎ ΠΈ Π½Π΅ ΠΎΠ΄ΠΎΠ±Ρ€Π΅Π½ Wildberries. Π˜ΡΠΏΠΎΠ»ΡŒΠ·ΡƒΠΉΡ‚Π΅ Π½Π° свой риск. ВсСгда ΠΎΠ±Ρ€Π°Ρ‰Π°ΠΉΡ‚Π΅ΡΡŒ ΠΊ ΠΎΡ„ΠΈΡ†ΠΈΠ°Π»ΡŒΠ½ΠΎΠΉ Π΄ΠΎΠΊΡƒΠΌΠ΅Π½Ρ‚Π°Ρ†ΠΈΠΈ Wildberries API Π·Π° Π°Π²Ρ‚ΠΎΡ€ΠΈΡ‚Π΅Ρ‚Π½ΠΎΠΉ ΠΈΠ½Ρ„ΠΎΡ€ΠΌΠ°Ρ†ΠΈΠ΅ΠΉ.


Made with ❀️ for the Wildberries developer community

Π‘Π΄Π΅Π»Π°Π½ΠΎ с ❀️ для сообщСства Ρ€Π°Π·Ρ€Π°Π±ΠΎΡ‚Ρ‡ΠΈΠΊΠΎΠ² Wildberries

⬆ Back to top / НавСрх

About

πŸ›οΈ Official TypeScript/JavaScript SDK for Wildberries Marketplace API. Full-featured, type-safe client with automatic rate limiting, retry logic, and comprehensive error handling. Supports all 11 API modules: Products, Orders (FBS/FBW), Finances, Analytics, Reports, Communications, Promotions, Tariffs, and more. Production-ready.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages