WB API Digest — December 2025

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

Publication date: 06.01.2026

WB API Digest — December 2025

In December 2025, Wildberries released 18 API updates — the busiest month of the year. Key highlights: CPC campaign support (cost per click), transition from barcodes to chrtId in inventory methods, new Seller User Management service, and numerous improvements to financial reports.

Disclaimer: Practical recommendations in this digest are based on integration experience and may vary depending on your specific implementation.

Ready-to-use Postman Collection: For convenient API testing and development, we've prepared a collection of methods from this digest. Import it into your Postman, set your API key in the api_key variable, and start working with the methods right away.

Critical Changes with Deadlines

Deadline	What's Changing	Required Actions
January 15	Disabling fixed phrases and keyword statistics methods	Migrate to Search Clusters methods
January 20	Disabling "Substitutions" and "Characteristics Change" methods	Migrate to new "Substitution and Incorrect Attachments" method
January 27	Disabling legacy warehouse measurements method	Migrate to new dimension reports methods
February 2	Disabling standard bid campaign methods (type 8)	Switch to type 9 campaigns
February 9	Discontinuing barcode usage in inventory methods	Switch to `chrtId`
March 11	Disabling "Supplies" report method	Use "Supplies Information" section methods

Marketing and Promotion

CPC Campaign Support (Cost Per Click)

The major update of the month in the advertising API — you can now create and manage campaigns with cpc payment type — cost per click.

New and Updated Methods

Campaign Information — new version
Minimum Bids for Product Cards — new version
Changing Campaigns Bids — new version
Create Campaign — added payment_type parameter

Benefits

For Business:

Alternative advertising payment model — pay only for actual clicks
More predictable advertising budget with fixed cost per click
Ability to test different payment strategies for different products

For Developers:

Unified API for working with both payment types (CPM and CPC)
The payment_type parameter allows explicit payment type specification when creating campaigns

Disabling Type 8 Campaign Methods

Wildberries continues campaign unification. On February 2, methods for standard bid campaigns (type 8) will be disabled:

List of Product Cards for Campaign with Standard Bid
Changing the List of Product Cards in a Campaign with Standard Bid
Statistics of a Campaign with Standard Bid by Phrase Clusters
Setting/Removing Minus-phrases for Campaigns with Standard Bid — date changed from January 15 to February 2

Use type 9 campaigns with the bid_type parameter to specify bid type.

Disabling Legacy Phrase and Statistics Methods

On January 15, the following will be disabled:

Up-to-date methods for working with search clusters and negative phrases are available in the Search Clusters subsection.

The search cluster statistics method has been moved to the Statistics subsection.

Working with Products

Transition from Barcodes to chrtId in Inventory Methods

Important change for everyone working with seller warehouse inventory. Added chrtId — product size ID — to the methods:

Get Inventory — in request and response
Update Inventory — in request
Delete Inventory — in request

Migration Deadline: Starting February 9, barcodes (SKU) will no longer be used for inventory management.

How to Get chrtId

A product can only have one chrtId. You can get it using the Product Cards List method.

Migration Recommendations

Export all product cards and save the barcode → chrtId mapping
Update inventory management logic to use chrtId
Test on a small sample of products
Complete the transition to chrtId before February 9

New Method for Getting Brands

Added method for getting product brands by subject ID.

Use it when creating product cards — you can specify any brand that is available for the subject you need.

FBS Orders and Cross-Border

New Statuses for DPX Shipments

Added status values for cross-border DPX shipments in the wbStatus field of the Get Assembly Orders Statuses method response:

accepted_by_carrier — accepted by carrier (the order is handed over to delivery service in the seller country)
sent_to_carrier — dispatched to carrier (the order is on the way to delivery service's warehouse in the seller country)

Similar statuses added to the Status History for Cross-Border Orders method:

dispatched_to_delivery_service — the order is handed over to delivery service in the seller country
on_way_to_delivery_service — the order is on the way to delivery service's warehouse in the seller country

Stickers for Orders in Delivery

Expanded sticker retrieval capabilities — now the Get Stickers method works not only for orders in confirm status (in assembly), but also in complete status (in delivery).

This is useful when you need to reprint a lost or damaged sticker for an order that has already been handed over for delivery.

General

New Seller User Management Service

Added a new API section — Seller User Management. Now via API you can:

Create an invitation for a user with access to the seller account
Get a list of the seller active or invited users
Update user's access permissions
Revoke a user's access

Important: You can manage user access only with a token from the active owner of the seller account.

Practical Applications

For Business:

Automated onboarding of new employees
Centralized access management from corporate systems
Audit and control of seller account access

For Developers:

Integration with corporate Identity and Access Management (IAM) systems
Automatic access creation/revocation when HR system changes occur

Documents and Reports

December brought numerous updates to financial reports.

New Fields in Realization Report Details

delivery_method Field (from December 23)

Added the delivery_method field with information about the sales method and cargo type to the details for the realization reports.

Now you can match report items with rates based on the delivery method. The field is only displayed for FBS, FBW, and DBW models.

In daily reports — starting with the report for December 22
In weekly reports — starting with the report for December 22–28

seller_promo_* Fields (from December 30)

Added fields with information about seller own promos with additional discounts:

seller_promo_id — seller own promo ID with additional discount
seller_promo_discount — additional discount from seller promo, %
In daily reports — starting with the report for December 29
In weekly reports — starting with the report for December 29–31

Response Change When No Data Available

The Realization Sales Report method now returns 204 No Data when there is no data, instead of an empty array [] in the 200 Success response.

Action Required: Update response handling — add status 204 check as a valid response with no data.

New Retention Reports

Substitution and Incorrect Attachments Report

Added the new method for getting the Substitution and Incorrect Attachments report.

On January 20, legacy methods will be disabled:

Package Dimension Reports

Added new methods:

The deprecated method will be disabled on January 27.

text — message text
addTimestamp — message time

This allows displaying chat previews without additional requests to fetch message history.

File Moderation Statuses

Added responses with moderation statuses for the Get File from the Message method:

202 — the file is under moderation
451 — moderation failed

Now you can properly handle situations when a file is still being reviewed or was rejected.

Migrate from fixed phrases methods to Search Clusters methods
Update keyword statistics retrieval

By January 20

Migrate to the new "Substitution and Incorrect Attachments" method

By January 27

Switch to new package dimension reports methods

By February 2

Complete transition from type 8 to type 9 campaigns
Update minus-phrases handling for standard bid campaigns

By February 9

Replace barcodes with chrtId in all inventory methods
Create barcode → chrtId mapping for all products

By March 11

Migrate from "Supplies" method to "Supplies Information" section methods

Optional Improvements

Implement CPC campaign support (payment_type)
Add handling for new DPX statuses in cross-border
Update 204 response handling in realization sales report
Add delivery_method and seller_promo_* fields to financial reporting
Integrate Seller User Management service with corporate systems
Use lastMessage for chat previews

Useful Links

Official Documentation and Resources