Processing of FBS orders
- Step 1. Regular checking of new orders
- Step 2. Generating an assembly sheet
- Step 3. Transfer of labeling codes and distribution of goods by boxes
- Step 4. Label printing and "Ready for shipment" status transmission
- Step 5. Handling the shipment
- If the product is not enough: postponement, cancellation and reduction of the order
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 processing.
Step 1. Regular checking of new orders
Use API notifications instead of this step.
Yandex.Market will send you a request. POST notification when a new order appears.
-
Check regularly to see if there are any new orders. — request GET campaigns/{campaignId}/orders. Do this at least once an hour.
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. Postponement, cancellation and reduction of the order.
Step 2. Generating an assembly sheet
Generation takes time, so first you need to make a request for the generation itself, and then to get the finished assembly sheet.
- Make a request POST reports/documents/shipment-list/generate.
- To find out if the build sheet is ready, make a request GET reports/info/{reportId}. You will receive the generation status and the estimated time remaining until it is completed.
- After the generation time is over, repeat the request. GET reports/info/{reportId}. If the build sheet has been generated, you will receive a link to download it.
Step 3. Transfer of labeling codes and distribution of goods by boxes
This information is transmitted simultaneously in a single request.: PUT campaigns/{campaignId}/orders/{orderId}/boxes.
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.
For example, if a person ordered three pairs of identical slippers, three codes must be provided for this item in the order.
For orders that contain jewelry
After you transfer the bitcoins, the Market will start checking them. How to get LOGin verification statuses
Distribution by boxes
Before shipping the order, you need to provide the Market with information about how the goods are distributed in boxes. This information is sometimes needed if something goes wrong.
What should I do if I need to change the order information?
By request PUT campaigns/{campaignId}/orders/{orderId}/boxes you can use it as many times as you want until the order status changes Ready for shipment. Each new request replaces the data transmitted with the previous request.
Step 4. Label printing and "Ready for shipment" status transmission
The collected order must be packed. This is done according to the rules described in detail. in the Help of the Market for sellers.
A special standard label with a number, barcodes and other information is affixed to the packaged order. Delivery services use it to determine where to take the parcel. You can get a shortcut via the API using a request:
- GET campaigns/{campaignId}/orders/{orderId}/delivery/labels — for one order.
- POST reports/documents/labels/generate — for multiple orders.
After you have prepared the order, set it to the status Ready for shipment ("status": "PROCESSING" "substatus": "READY_TO_SHIP"
). This is done using queries. PUT campaigns/{campaignId}/orders/{orderId}/status (if you want to transfer one order at a time) or POST campaigns/{campaignId}/orders/status-update (if you want to transmit it en masse).
By converting the order to the status Ready for shipment, you confirm to Yandex. Market that the product is there and will be shipped. Products in the status Ready for shipment they are included in the acceptance and transfer certificate.
Step 5. Handling the shipment
To ship orders, the driver will need an acceptance certificate. Using a request GET campaigns/{campaignId}/shipments/reception-transfer-act You can:
-
Receive and sign the acceptance certificate via the API. For information on how to enable work with electronic acceptance certificates, see Yandex.Market Help for sellers.
-
Confirm the shipment. There is no such step when working in the office, but when working through the API— there is.
When can I receive the report and confirm the shipment?
Only after all orders have been converted to the status Ready for shipment. If there are unconfirmed orders in the shipment, an error message with a list of orders will be sent in response to the request.
Planned confidential acceptance
Send the number of boxes or pallets using a request PUT campaigns/{campaignId}/first-mile/shipments/{shipmentId}/pallets.
To get shortcuts for them, use a request GET campaigns/{campaignId}/first-mile/shipments/{shipmentId}/pallet/labels.
If the product is not enough: postponement, cancellation and reduction of the order
During the preparation of an order, your warehouse may discover that one or more items are missing. If this happens, you will have to postpone the delivery of the order or cancel it in whole or in part.
The postponement of the delivery date and the complete cancellation of the order are made by separate requests.
To change the order composition, use PUT campaigns/{campaignId}/orders/{orderId}/boxes — the same request that transmits the labeling codes and the distribution of goods in boxes.
Order action | Request |
---|---|
Transfer to the next shipment | POST campaigns/{campaignId}/first-mile/shipments/{shipmentId}/orders/transfer |
Complete cancellation of the order | Request PUT campaigns/{campaignId}/orders/{orderId}/status. (Transfer the order to "status":"CANCELLED" "substatus": "SHOP_FAILED" .) |
Exclusion of the product from the order | PUT campaigns/{campaignId}/orders/{orderId}/boxes |
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.
Trust acceptance is the transfer of orders to the Market without recalculation in a common container. To learn more
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