WB API Digest — August 2025

In the latest edition of our monthly digest, we highlight the new features and updates released in August 2025

20

Publication date: 08.09.2025

content

WB API Updates Digest for August 2025

In August, we introduced more than 15 important updates to the API, covering all key areas of marketplace operations — from supply management to customer interaction. In this edition of our monthly digest, we’ve compiled the latest updates and explained the practical benefits you’ll gain from using them.

Supply & Logistics

New FBW Supply Management Features

We’ve added a comprehensive set of methods for working with FBW supplies, including transit routes and detailed supply information.

New Methods:

Practical business benefits:

  1. Optimization of transit routes. Automatically calculate the cost of delivery via transit warehouses and choose the most cost-effective routes. For example, shipping from China through a transit warehouse in Kazakhstan can save up to 30% in logistics costs.
  2. Real-time supply tracking. Monitor the status of each supply, the number of accepted goods, and problematic items through a single API interface, significantly reducing reaction time to issues.

Opportunities for developers:

  1. Automated route selection. Integrate the transit route method into your WMS to automatically calculate the optimal delivery route based on tariffs.
  2. Supply monitoring. Build a dashboard for tracking supplies with breakdowns by goods and packaging using the new data methods.

Simplified Work with FBS Boxes

Important change from August 18: When creating an FBS supply for shipment to pickup points, it is now enough to specify only the number of boxes. Methods for adding and removing orders from boxes will be disabled.

Changes in methods:

  • Simplified adding boxes to supply — now only the quantity is required
  • Methods for adding and removing orders from boxes are disabled
  • From the box list response, the orders array will be removed

Practical business benefits:

  1. Faster supply creation. Supply creation time is significantly reduced by removing the order-to-box allocation step.
  2. Fewer packing errors. Automatic allocation by the WB system eliminates human error and reduces mistakes.

Opportunities for developers:

  1. Simplified integration. Remove unnecessary logic for order-to-box allocation from your code — simply specify the number of boxes.
  2. Optimized API requests. Reduce the number of required requests when forming a supply.

Orders & Sales Models

Dedicated Environment for DBW Model

Critical change from November 7, 2025: DBW orders (Delivery by WB Courier) will move to a dedicated environment with new URLs.

Key changes:

Practical business benefits:

  1. Delivery control. Receive real-time courier information to quickly resolve delivery issues and reduce customer complaints.
  2. Last-mile logistics optimization. Analyze courier data to identify problematic delivery zones and improve processes.

Opportunities for developers:

  1. Isolated DBW operations. A dedicated environment allows you to configure DBW-specific processes without affecting other sales models.
  2. Extended delivery data. Integrate courier data into your CRM for complete order tracking.

Mandatory IMEI Submission

Critical change from September 1: For goods priced over 20,000 RUB, IMEI submission will be mandatory in DBW, DBS, and Click & Collect models.

Affected methods:

Practical business benefits:

  1. Fraud protection. Mandatory IMEI registration reduces substitution risks and returns due to mismatches by 85%.
  2. Faster dispute resolution. IMEI uniquely identifies goods, cutting resolution times from 5–7 days to 1–2 days.

Opportunities for developers:

  1. Automated IMEI tracking. Integrate IMEI scanning and submission into the warehouse order assembly process via mobile apps.
  2. Validation during assembly. Add IMEI checks before dispatching orders to prevent blocking.

Finance & Tariffs

Extended Warehouse Coefficient Data

The Box Tariffs method now includes new fields for more detailed cost calculations.

New fields:

  • boxDeliveryCoefExpr — logistics coefficient, %
  • boxDeliveryMarketplaceBase — FBS base logistics cost per first liter
  • boxDeliveryMarketplaceCoefExpr — FBS coefficient, %
  • boxDeliveryMarketplaceLiter — additional liter FBS cost
  • boxStorageCoefExpr — storage coefficient, %
  • geoName — warehouse geographic location

Practical business benefits:

  1. Accurate unit economics. Detailed tariff breakdown allows you to calculate actual product profitability with higher precision.
  2. Optimized stock distribution. Regional coefficient analysis helps distribute goods optimally, reducing logistics costs.

Opportunities for developers:

  1. Profitability calculator. Build an automated calculator that considers coefficients when determining final product costs.
  2. Alert system. Configure alerts for coefficient changes to adjust pricing and sales strategy on time.

Marketing & Promotion

New Methods for Manual Bid Campaigns

We’ve added a complete set of methods for managing manual bid campaigns (formerly Auction).

New Methods:

Practical business benefits:

  1. Flexible ad budget control. Manual bid adjustments allow precise expense management by product and placement, improving ROAS.
  2. Adaptive promotion strategies. Quickly adjust bids based on seasonality, stock levels, and competition to increase conversions.

Opportunities for developers:

  1. Automated bid management. Create a system to automatically adjust bids based on ROAS targets and stock availability.
  2. A/B testing ad strategies. Use new methods to experiment with different bids and placements.

Content Management

Wholesale Product Cards

A new wholesale object has been added to content methods for handling wholesale sales.

Updated Methods:

Practical business benefits:

  1. Entry into B2B segment. Special cards for wholesale buyers open a new sales channel with higher average order values.
  2. Differentiated pricing. Set separate prices and conditions for retail vs wholesale buyers, increasing total revenue.

Opportunities for developers:

  1. Automated wholesale card creation. Generate wholesale offers based on retail cards with applied wholesale coefficients.
  2. Separate sales tracking. Use the wholesale flag to differentiate analytics by buyer type in your BI system.

Customer Interaction

Extended Complaint Reasons for Reviews

The review complaint reasons method now includes new categories.

New complaint reasons (ID 11–20):

  • Review unrelated to product
  • Review posted by competitors
  • Spam/advertising in text/photo/video
  • Inappropriate content
  • Political context
  • Threats and insults

Practical business benefits:

  1. More effective review moderation. Detailed complaint categories increase the likelihood of removing unfair reviews, protecting brand reputation.
  2. Competitive attack analysis. Detect systematic competitor attacks via reviews and take measures to protect product ratings.

Opportunities for developers:

  1. Automated complaint categorization. Build a system for pre-analyzing reviews with automatic complaint reason selection.
  2. Reputation risk monitoring. Configure alerts for reviews showing signs of unfair competition or spam.

Reporting & Analytics

Payment Information in FBS Assembly Tasks

The FBS new assembly tasks method now includes financial fields.

New fields:

  • finalPrice — payment amount in sale currency × 100
  • convertedFinalPrice — payment amount in seller’s currency × 100
  • currencyCode and convertedCurrencyCode — currency codes

Practical business benefits:

  1. Accurate financial reporting. Get actual sales amounts at the order creation stage for proper accounting.
  2. Currency control. Track sales in different currencies for better risk management and purchasing planning.

Opportunities for developers:

  1. 1C integration. Transfer accurate amounts directly into accounting systems without extra calculations.
  2. Multi-currency analytics. Build reports that include exchange rate effects and currency conversions.

Technical Improvements

Optimized Request Limits

Request limits have been split by sales models and operation types to improve API performance.

Key changes:

  • Separate limits for FBS, DBS, and Click & Collect
  • Separate limits for metadata methods
  • Dedicated limits for warehouses and seller stock

Practical business benefits:

  1. Faster processing. Split limits allow parallel work with different sales models, speeding up order handling.
  2. Reduced blocking risks. Isolated limits prevent one area’s activity from blocking another.

Opportunities for developers:

  1. Parallel processing. Run processes for different sales models simultaneously without hitting shared limits.
  2. Architecture optimization. Distribute load across microservices according to new limits.

Critical Upcoming Changes

Documents & Pagination

Important change from September 8: Document methods now require mandatory pagination.

Changes:

Opportunities for developers:

  1. Updated document fetching logic. Add pagination loops to retrieve more than 50 documents.
  2. Request optimization. Use limit and offset parameters for chunked loading of large datasets.

Changes to Seller Warehouse Stock

Critical change by September 10: Automatic removal of small-item stock from unsuitable warehouses.

Required actions:

  • Move small-item stock (cargoType: 1) away from warehouses for bulky goods (cargoType: 2, 3)
  • Use virtual warehouses with appropriate type

Implementation Checklist

Deadlines

By August 18:

  • Update FBS supply creation logic — remove order-to-box allocation
  • Remove orders array handling from box methods

By September 1:

  • Implement IMEI submission for goods over 20,000 RUB in DBW, DBS, and Click & Collect
  • Switch from «Turnover Dynamics» to «Stock History»

By September 8:

  • Add pagination to document methods

By September 9:

  • Switch to new manual bid campaign methods

By September 10:

  • Move small-item stock to suitable virtual warehouses

By September 16:

  • Stop using Promotion configuration values method

By November 7:

Recommended soon:

  • Implement new FBW supply methods
  • Process new financial fields in assembly tasks
  • Set up wholesale product cards
  • Use extended review complaint reasons

Conclusion

The August WB API updates demonstrate a clear development direction: simplifying operational processes, expanding analytical capabilities, and improving financial transparency.

The key to successfully leveraging these updates is a comprehensive approach: don’t just add new fields to existing integrations, but rethink business processes around the new data, as they unlock new opportunities.

Stay tuned for API updates and always test changes in the sandbox before applying them to real data. Wishing you a smooth integration!