Transfer of balances via API
In order for the Market to receive up-to-date information about balances, use the method PUT v2/campaigns/{campaignId}/offers/stocks.
What needs to be ready before you get started
Before setting up order processing via the API, you need to add products to the Market and set up assortment updates. You don't have to do this via the API. Choose any method that is convenient for you. All the necessary instructions are available in Yandex.Market Help.
How does the transfer of leftovers work?
It is important for Yandex.Market to know how many items are left in the store's warehouse. Otherwise, it may turn out that the customer places an order and the product does not turn out to be there. The only exception is the FBY model, because the goods are stored in the Market's warehouse and he can count them himself.
To transfer the leftovers correctly, be sure to read an article in the Help of the Market for sellers. All the general rules for transferring balances apply to the API too.
Is it possible to use the API and other balance transfer methods at the same time?
Yes, you can transfer leftovers according to this instruction using the method PUT v2/campaigns/{campaignId}/offers/stocks and in the office via YML or through Excel files.
Integration development
Using a request PUT v2/campaigns/{campaignId}/offers/stocks You can transfer leftovers at any time.
Each entry includes:
- Your SKU of the product for which you need to update the balances.
- Date and time — the moment at which the new value is relevant.
- The value of the leftovers itself.
How to check the functionality of the integration
- Hide the goods using POST v2/campaigns/{campaignId}/hidden-offers.
- Make a request PUT v2/campaigns/{campaignId}/offers/stocks to transfer the leftovers.
- Resume showing hidden goods — POST v2/campaigns/{campaignId}/hidden-offers/delete.
What number should I send
The remaining product is the number of units, available for ordering on the Market.
When a customer places an order, the number of available items decreases, so the leftovers do too. For example, if there were 20 and someone ordered 2 units, the remainder would be 18.
Both on-Market and off-market sales are taken into account
It doesn't matter where the product was purchased: on the Market or, for example, directly in an offline store. In any case, immediately reduce the remaining product.
For example:
Event |
Changing balances |
10 units of new goods were brought to the warehouse |
0 → 10 |
The buyer ordered 2 units on the Market |
10 → 8 |
The supplier brought 10 more pieces. |
8 → 18 |
Visitor offline stores I bought 3 pieces |
18 → 15 |
How to transfer leftovers for a group of warehouses
Transfer leftovers only for one of any warehouse. The information for the other warehouses in this group will be updated automatically.
It is assumed that the offline store sells with The same warehouse, the same as the store on the Market.