Multiple Orders for a Cart

[Matt75]

Order splitting

Sometime PrestaShop will split a Cart in multiple Order with same Reference after a Payment.

Because this splitting is made by PrestaShop after the Payment, Customer has only paid Shipping Costs for one Order.

So PrestaShop will display a warning on Order view page to notify merchant the total order amount is not equal to total cart amount.

Possible cases

1. A product of Cart exceeds the price/weight range of carriers
2. A product of Cart is restricted to one Carrier (case described bellow)
3. Warehouse management in 1.6, removed in 1.7
4. Multi-shipping functionnality in 1.5 removed in 1.6
5. Others cases I don't know

➡️ Find every possible cases will cause Order splitting

How to handle that for PaymentModule

• Every PaymentModule will only update OrderState of the main Order, on module validation trigger by API (like bank validation return).
• Every child Order should be manually update by merchant because he needs to choose if additional shipping cost should be paid by Customer or if he take it in charge.

⚠️ This should be confirmed and documented

Related to https://github.com/PrestaShop/docs/issues/508