WB API Digest — June 2025

WB API Updates Digest for June 2025

In June, we introduced a number of important updates to the API. In this edition of our monthly digest, we’ve compiled the key innovations of the month and explained the practical benefits you’ll gain from using them.

---

FBS & Click & Collect Orders

New Guides and Test Environments

In June, the WB API team released a detailed FBS & Click & Collect guide.

The new guide includes:

• Step-by-step instructions for using FBS and Click & Collect, plus recommendations on method call order.
• List of available methods with detailed descriptions and real-world usage examples.
• Visual flowcharts illustrating core order-processing workflows, making complex scenarios easier to understand.

This new guide makes integration and understanding of FBS simpler, even for those without deep API experience.

---

Launch of New Sandbox for FBS Orders

Another major addition was the launch of the sandbox for FBS order testing. Developers can now test all methods in a safe environment before integrating them into production workflows.

What you can test in the new sandbox:

• Assembly tasks: from creation to completion, including status changes.
• Order metadata: working with extra data needed for internal processes.
• Supplies and passes: full testing of supply workflows to warehouses.
• Warehouse management: creation/editing of warehouses and stock updates.

Access is provided via a special «Test Environment» token, so you can safely experiment without affecting live data.

Click & Collect Sandbox

Similar to FBS, Wildberries launched a separate sandbox for Click & Collect orders. Before integration, all methods can be verified in a secure environment, reducing risks of errors.

Available for testing:

• Assembly task management: create/cancel orders, handle status changes.
• Metadata: retrieve additional details about orders.
• Status models: test various status transition scenarios, including cancellations.

Dedicated test methods were also added:

• Create test assembly tasks
• Cancel test assembly tasks

These guides and sandboxes enable faster, safer integration of FBS and Click & Collect models into your business workflows.

---

DBS Orders

New Data for Better Customer Communication

In June, WB API added an important improvement for DBS orders. A new field — replacementPhone — is now available in the customer info method. It contains the buyer’s primary contact number, removing the need for extension numbers that often caused confusion.

The old method remains available as a backup, in case the main number is unreachable.

Learn more in the customer info method documentation.

---

Extra Price Data in DBS & Click & Collect Assembly Tasks

DBS and Click & Collect APIs now include new fields that give sellers better financial insights:

• finalPrice — final product price in sale currency with all discounts × 100
• convertedFinalPrice — final product price in seller’s country currency with all discounts × 100

Additional for Click & Collect:

• convertedPrice — product price in seller’s currency with all discounts except WB Wallet discount × 100
• convertedCurrencyCode — seller’s country currency code

These fields improve financial tracking, especially for sellers working across countries and currencies.

Updated methods:

• New DBS assembly tasks
• Completed DBS assembly tasks
• New Click & Collect assembly tasks
• Completed Click & Collect assembly tasks

---

Accounting & Reporting

New Seller Balance API

A new API method now allows you to retrieve your seller balance — the same figure shown on the main dashboard in Seller Portal. Access is via a dedicated balance method with a «Finance» token.

More details: Release notes and documentation.

Weekly Sales Report Updates

Since mid-July, some weekly sales report fields now return percentages instead of fractions, simplifying interpretation:

• sale_percent
• product_discount_for_report
• supplier_promo
• ppvz_spp_prc
• ppvz_kvw_prc_base
• ppvz_kvw_prc
• sup_rating_prc_up

Also, the outdated field rid has been removed.

These changes improve clarity and simplify accounting. Full details are in the financial reports documentation.

---

Analytics

Advanced Search by Substituted SKUs

API search analytics gained new filters for substituted SKUs, providing more accurate insights:

• Filter queries by substituted SKUs
• includeSubstitutedSKUs — include data for direct substituted SKU queries
• includeSearchTexts — include data for standard search queries

Both cannot be false simultaneously.

New response field:

• isSubstitutedSKU — indicates whether the item was found via substituted SKU.

Supported in:

• Main search report
• Paginated group data
• Paginated product data
• Top search queries by product

Higher Limits & New Access Rules

For sellers with the «Advanced» plan, analytics limits were raised:

• 100 queries — max per product
• 100 items — max in searchTexts array

Access to search query methods now requires the «Jam» subscription.

Details: official docs.

---

Deprecated /storage-coefficient Method

The old /storage-coefficient method (logistics/storage deductions report) was fully disabled on June 23, 2025.

It will be replaced by two new methods covering deductions for underestimated packaging dimensions and warehouse measurements, giving sellers more accurate logistics cost control.

---

Customer Interaction

Simplified Chats: Removal of refund Object

We updated the chat events method. Previously, the API returned a refund object for return requests via chat. This has now been removed, and all chat events are unified under message.

For handling returns, sellers should now use the dedicated Returns API methods. This clear separation avoids confusion and improves customer support transparency.

Learn more in: Customer chats docs and Customer returns docs.

---

Stay tuned for new releases, read case studies, use the guides, and subscribe to the WB API Telegram channel to never miss important updates.