Express order processing
The Yandex.Market API allows you to perform all the same actions that are performed in the cabinet: view new orders, get labels for them, change something in them if necessary, and so on.
To understand how everything happens
Read it an article about order fulfillment.
Step 1. Getting information about orders
Set up notifications, as you need to know about new orders instantly. Instruction manual
About notifications in the app Yandex Market for sellers, by mail or Telegram , read in Yandex.Market Help for sellers.
Notifications are enabled
-
Get detailed information about the order by making a request GET v2/campaigns/{campaignId}/orders/{orderId}.
-
Make sure that all the items are in stock. If everything is in order, proceed to step 2. If something is missing, read the instructions first. Cancellation and reduction of the order.
Notifications are not enabled
-
Check regularly to see if there are any new orders. — request GET v2/campaigns/{campaignId}/orders. Do this at least once every 5-10 minutes.
Use a range of delivery dates — parameters
fromDate
andtoDate
. If you don't pass ittoDate
, the current date will be indicated.To get information about orders that have been modified
Use filters
updatedAtFrom
andupdatedAtTo
. If you don't pass itupdatedAtTo
, the current date will be indicated. -
Make sure that all the items are in stock. If everything is in order, proceed to step 2. If something is missing, read the instructions first. Cancellation and reduction of the order.
Step 2. Transmission of marking codes
Labeling of goods in the system "An honest SIGN" optional for orders from individuals
If the product is marked in "An honest sign" or other labeling systems, give the Market the code of each sold copy.
This information is transmitted by request PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes.
For orders that contain jewelry
After you transfer the bitcoins, the Market will start checking them. How to get LOGin verification statuses
Step 3. Label printing and "Ready for shipment" status transmission
-
Pack the assembled order according to the rules described in detail in Yandex.Market Help for sellers.
-
Get shortcuts using a request GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/labels and stick them on the packaged order.
-
Set the order to the status Ready for shipment (
"status": "PROCESSING" "substatus": "READY_TO_SHIP"
) — request PUT v2/campaigns/{campaignId}/orders/{orderId}/status.
Step 4. Sending the confirmation code and the order to the courier
-
Send the confirmation code that the courier gave you in the request. PUT v2/campaigns/{campaignId}/orders/{orderId}/verifyEac.
-
If the code verification is successful, send the order to the courier.
If the product is not enough: cancel and shorten the order
If, during the preparation of an order, you find that one or more items are missing, cancel it in whole or in part. This is done by separate requests.
Order action |
Request |
Complete cancellation of the order |
PUT v2/campaigns/{campaignId}/orders/{orderId}/status. Transfer the order to |
Exclusion of the product from the order |
You can't do that often.
Any of these actions will lower the quality index the store. When the quality index decreases, the store faces limitations.
The quality index is a number from 0 to 100. If the store operates according to the FBY model, the quality index shows how well the seller makes deliveries to the Market's warehouses, and in the FBS, DBS, and Express models, the index evaluates the work with orders. To learn more
Honest Sign is a state system for labeling and tracking goods. To learn more