This article is a bit technical and particularly useful for Merchants choosing a Technical connection (such as API or FTP). You can also find more information here: https://doc.backmarket.fr/#taxonomy
From its creation to the moment it's totally processed, an order passes by several states.
When an order is created, it's in state 0. The payment validation is pending. Back Market is doing verifications to check the customer identity. Orders in this state must not be shipped.
If the payment process fails, the order passes in state 8. You must ignore this order. Actually, it should never arrive in your system as we filter them out when sending you the order list.
If the payment is checked and validated, the order passes in state 1. You must process the orderlines.
When all the orderlines are managed (accepted or canceled), the order passes in state 3. You must ship the accepted orderlines and refund the canceled ones.
When all the orderlines are shipped or refunded, the order passes in state 9: the order is processed.
When an order is created, all its orderlines are in state 0. You have to wait for payment confirmation.
If the payment process fails, all the orderlines pass in state 7.
When the order passes in state 1, all its orderlines pass in state 1. You have received the payment and you must now validate or cancel each orderline.
If you cancel an orderline, it passes in state 4. The customer will be refunded for this orderline.
If you accept an orderline, it passes in state 2. You must now prepare the corresponding product for shipment.
When all the orderlines are in state 2 or 4, the order passes in state 3.
Even if you accepted an orderline, you can cancel it afterward. If you or the customer cancel it after it has been validated, the orderline passes from state 2 to state 5. The customer will be refunded for this orderline.
Once you have shipped the orderline, you need to update the orderline from the state 2 to the state 3.
Note that, since all orderlines are gathered in the same package, you don’t need to update every orderlines to the state 3 but just once for the whole order. Indeed, every orderline of this order will be set to this state automatically.
Finally, if the customer makes a refund request after shipping, the orderline passes from state 3 to state 6. The customer will be refunded for this orderline.