Starting from December 31, push API methods will be unavailable. From October 1, they may be unstable.
Order processing using the push component
The market can send you requests on its own when new orders arrive, their statuses change, or, for example, a customer cancels an order. For this to work, you need to configure the push component. Yandex Market API.
If the push component is enabled, you need to necessarily respond to requests. You can't turn on notifications and not respond to them. Use the push component only if you are confident in the stability of your server and the system on it.
Requests from Yandex.Market should be enabled in the dashboard.
In order for the Market to start sending you requests for changes related to orders, click on the icon of your account → in the seller's account on the Market. Settings and in the menu on the left, select APIs and modules. On the tab Push API activate the option Enable requests from Yandex.Market.
If there is no Push API tab, contact support and describe your tasks. — in the seller's account on the Market, select Communication → Support → Create an appeal → Working through the API.
⚠️ Do this after you have configured the integration and tested it on test orders. How to perform debugging on test orders
Confirmation of order receipt
After receiving the order placed by the customer, the Market will send you a request to confirm the order. POST order/accept.
In order The text that comes in the request body contains a lot of different information designed to solve different tasks and work according to different models. To process an order, only a part of them is needed:
- Order ID
id, which you will need in your subsequent requests to the Market. - List of products
items, which transmits a list of ordered items. In it, for each product, the following are important to you:id— the ID of the specific product in the cart. It will be necessary, for example, to transfer the codes of the "Honest Sign" for him.shopSKU— the product ID in your catalog that shows what you ordered.count— how much is ordered.
- Date of shipment
shipmentDate— On this date, yandex.Market will be waiting for your order.
If you are working with test orders, you will need another indication of such an order. — fake.
Review the descriptions of all the request fields
You may want to use some more of them immediately or in the future, developing integration.
Further steps
Next, you will only need the pull API component. Just follow the basic instructions for order processing, starting from The second step.