@spree/docs 0.1.267 → 0.1.268
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -41,7 +41,8 @@ On top of that, meaningful business moments get their own events:
|
|
|
41
41
|
|
|
42
42
|
| Event | Meaning |
|
|
43
43
|
|---|---|
|
|
44
|
-
| `order.placed` |
|
|
44
|
+
| `order.placed` | An order was placed — one per order, so a checkout that split across several sellers publishes one per seller |
|
|
45
|
+
| `order_group.completed` | A checkout that split finished — one event for the whole purchase |
|
|
45
46
|
| `order.paid` | Payment is settled in full |
|
|
46
47
|
| `order.canceled` | The order was cancelled |
|
|
47
48
|
| `order.fulfilled` / `order.delivered` | Everything has shipped / arrived |
|
|
@@ -271,6 +271,14 @@ curl -X PATCH https://your-store.com/api/v3/admin/orders/or_UkLWZg9DAJ/complete
|
|
|
271
271
|
```
|
|
272
272
|
|
|
273
273
|
|
|
274
|
+
### One confirmation, and it describes the purchase
|
|
275
|
+
|
|
276
|
+
The customer made one purchase, so they get one confirmation email — sent from the group, not from any of its orders. Each child order is placed silently.
|
|
277
|
+
|
|
278
|
+
If you replace the confirmation email, replace it at the group level too: the email a customer receives for a split checkout is `Spree::OrderGroupMailer`, reacting to the `order_group.completed` event, and a re-send from any child order in the admin sends the purchase's email rather than that child's. A checkout that doesn't split is unaffected and still sends the ordinary order confirmation.
|
|
279
|
+
|
|
280
|
+
> **NOTE:** **Orders and deliveries are different counts.** Three seller orders do not mean three parcels. When several sellers' goods ship from one warehouse, the checkout quotes one delivery charge, and the split divides that charge between the orders rather than charging for it again — so one box arrives. Ask the group for `fulfillment_groups` to get the parcels that really ship; each one knows its delivery method, its cost, the goods it carries and who is sending it. Counting child orders instead promises the customer deliveries that will never arrive.
|
|
281
|
+
|
|
274
282
|
## Commission
|
|
275
283
|
|
|
276
284
|
Commission is what the marketplace charges for the sale — configured as **rates**, and recorded per sale as immutable **commission lines**.
|