WB API Digest — May 2024

New APIs and Methods

We are excited to introduce three new APIs and several new methods.

---

Product Category Commissions

First on our list is a new API for retrieving commission rates by product categories:

• Endpoint: /api/v1/tariffs/commission
• Function: Returns WB commissions by parent product categories based on the sales model.
• Request Limit: Maximum of 1 request per minute.

Authorization and Parameters:

• HeaderApiKey: Required for authorization.
• Parameters:
• locale: Language for the parentName and subjectName fields in the response (options: ru, en, zh).

For more details, refer to the documentation.

Product Returns by Customers

Wildberries has also introduced an API for handling product returns by customers:

• Authorization requires generating and using a token with the «Returns» option.
• Documentation is available on our portal.

New methods:

• Customer Return Requests
• Customer Return Request Response

Report on Penalties for Characteristic Changes

Another new API for retrieving reports on penalties for product characteristic changes:

• Endpoint: /api/v1/analytics/characteristics-change
• Function: Returns a report on penalties for changing product characteristics. If products do not match the declared colors and sizes upon receipt and are re-labeled in the warehouse with correct characteristics, a penalty is imposed on such products.
• Request Limit: Maximum of 10 requests per 10 minutes.
• Data Period: Data can be obtained for a period of up to 31 days, available from December 28, 2021.

Authorization and Parameters:

• HeaderApiKey: Required for authorization.
• Parameters:
• dateFrom: Start of the reporting period (format: YYYY-MM-DD).
• dateTo: End of the reporting period (format: YYYY-MM-DD).

For more details, refer to the documentation.

New Methods: Information for Shipment Formation

New API methods are available to obtain information for shipment formation:

• Acceptance Coefficients
• Acceptance Options
• List of Warehouses

Authorization requires generating and using a token with the «Shipments» option.

OAuth2.0 and WB Authorized Services

We are pleased to announce support for the OAuth2.0 standard, which simplifies the connection of third-party services to your Wildberries account.

Benefits of OAuth2.0:

• Convenience: No need to manually create and enter tokens.
• Security: Access only to necessary data.
• Easy Management: Simple connection and disconnection of services.

How it works:

1. From the WB Personal Account:

• Select the service from the catalog and click «Connect.»
• Authorize and grant access to the data.
• The service automatically receives the necessary accesses.

2. From the Service:

• Click «Connect to Wildberries» in the service’s personal account.
• Confirm access on the WB Seller Portal.

For more details, refer to the OAuth2.0 documentation.

Changes

Please note the changes that took effect this month.

Changed Content Image Format: WEBP instead of JPG

On May 15, the image format for URLs transmitted in the photos array in the responses of the get/cards/list and get/cards/trash methods was changed from JPG to WEBP. You can still upload images in 5 formats, but you will receive the image in WEBP format via the link.

Replaced Fields in the Paid Storage Report

Following changes in the personal account, the fields giDate, giFixDateFrom, and giFixDateTill — supply and tariff fixation dates — have been replaced with tariffFixDate and tariffLowerDate — tariff fixation and reduction dates — in the paid storage report. For more details, refer to the documentation.

Added New Field in the Paid Acceptance Report

A new field total — the total cost of acceptance in kopecks — has been added to the paid acceptance report. total will replace the outdated sum field — the total cost of acceptance in rubles without kopecks. The sum field will be disabled on June 10. For more details, refer to the documentation.

Important Reminder: New API Token Validity Period — 180 Days

We remind you that since November 2023, the validity period of all authorization tokens is 180 days. After the expiration date, token records are deleted from the generation page. To ensure uninterrupted API operation, generate new tokens in advance and replace the old ones in your integration. The token validity period can be viewed on the generation page or obtained on the decoding page.

These were all the API updates for May. Stay tuned for news in our monthly column.