Sometimes a customer orders several products in one delivery and an item is damaged in transit. You still delivered the rest (and paid the courier), so the customer should pay for the good items plus the delivery charge, while the broken item becomes your loss — not something the customer pays for.
How to handle it
- Open the order (it must already be confirmed/fulfilled, so a sale exists).
- Choose Report breakage and tick the item(s) that broke, with the broken quantity (or send them to
POST /store/orders/{id}/breakage).
- Confirm. The system does everything in one step.
What the system does automatically
- Removes the broken item from the customer's bill. Its value is reversed off the sale, so the customer owes only the delivered items.
- Records the broken item as your loss. Its cost is posted to Inventory Damage / Write-off (5600-DMG) and the unit leaves your stock — it does not go back on the shelf.
- Keeps the delivery charge on the customer's bill (the delivery was done).
- Collects the right amount on delivery. When you then mark the order delivered, cash-on-delivery collects only the delivered items + delivery — never the broken item.
Example: a customer orders a $100 lamp and a $50 vase with $20 delivery. The vase breaks. You report the vase as broken, the courier collects $120 (lamp + delivery), and the $50 vase becomes your loss under Inventory Damage. Your profit report shows the loss; the customer was never charged for the vase.
