Damaged Stock Reason Codes: WMS Rules for Ecommerce Sellers
Amazon's Inventory Ledger separates damaged inventory by reason: customer-damaged, carrier-damaged, fulfillment-center-damaged, defective, distributor-damaged and merchant-damaged. That level of detail is a useful benchmark for online sellers running their own warehouse, because a single “damaged” stock adjustment hides the operational cause, the margin impact and the next action.
Damaged stock reason codes are standardized labels used in a WMS to explain why inventory left sellable stock, moved into quarantine, became write-off stock or returned to availability. For ecommerce teams selling through Shopify, bol.com, Amazon, Zalando, OTTO or Kaufland, the code is not an admin label. It decides whether stock can still be promised, whether finance can book a loss, whether a supplier claim has evidence and whether the same damage keeps repeating next month.
Why “damaged” is too blunt for ecommerce WMS control
Most small warehouses start with one manual correction: someone sees a torn box, adjusts inventory down and leaves a note. That works until order volume grows. A webshop can absorb one blind adjustment; a multichannel seller cannot, because every correction must travel through marketplace availability, pick lists, returns, accounting and sometimes supplier or carrier claims.
The real risk is not the damaged unit itself. It is the stock status leak that follows. If a damaged item is still counted as available, Amazon, bol.com or the webshop can sell a unit the warehouse should not pick. If the damaged unit is removed without a reason code, finance sees shrinkage but operations cannot tell whether the root cause was inbound handling, pick-face crushing, return fraud, carrier damage or bad packaging.
The counter-intuitive rule: do not start with more codes. Start with fewer codes that force a decision. A reason-code tree with 40 options becomes free text in disguise. A compact tree with source, condition and disposition creates repeatable data.
A practical damaged-stock code tree
A good ecommerce WMS reason-code model separates three questions. First, where did the damage originate? Second, what is the commercial condition of the item? Third, what disposition did the warehouse choose? This keeps warehouse staff fast while still giving managers useful data.
One generic damage code
- Every correction says DMG or damaged
- No difference between inbound damage and picker damage
- Marketplace availability may be fixed, but root cause stays hidden
- Finance sees losses after the fact
Source + condition + dispositionRecommended
- Source: supplier, carrier, warehouse, customer or marketplace
- Condition: cosmetic, packaging, functional, missing parts or unsafe
- Disposition: quarantine, rework, open-box, write-off, supplier claim or carrier claim
- Trend reports show where damage actually starts
For most online sellers, the first usable list is short: SUPPLIER_DAMAGED, CARRIER_DAMAGED, WAREHOUSE_DAMAGED, CUSTOMER_DAMAGED, DEFECTIVE, MISSING_PARTS, PACKAGING_DAMAGED and UNKNOWN_PENDING_REVIEW. Each code should have an allowed disposition. For example, packaging damage can often move to repack and sell, while unsafe electrical damage should route to write-off or supplier claim.
How the WMS workflow should handle damaged stock
The code only works if the workflow prevents stock from leaking back into the pickable pool. Connect damaged-stock codes to fulfillment workflows, barcode scans and stock status rules, not just to a back-office adjustment screen.
- 1Scan the SKU and current locationThe associate scans the item or bin before choosing a code, so the record includes SKU, lot or serial number when applicable, current location and user.
- 2Move the unit out of sellable availabilityThe WMS changes the unit to quarantine, blocked or damaged status before any marketplace stock sync runs. This prevents the unit from being promised while it waits for inspection.
- 3Capture reason code and photo evidenceA short code plus one or two photos is enough for most supplier, carrier and internal warehouse reviews. Free-text notes should be optional, not the main data field.
- 4Choose disposition after inspectionDo not write off everything immediately. Route to repack, open-box sale, supplier claim, carrier claim, repair, recycle or final write-off based on condition and value.
- 5Sync only the final stock outcomeAfter disposition, update available inventory, quarantine inventory, write-off quantity or claim quantity. The final stock event should then flow into marketplace, ERP and carrier integrations.
Where competitors and generic WMS guides fall short
Most ranking WMS guides talk about barcode scanning, pick lists, stock locations and real-time inventory. Those features matter, but they often stop at “track damaged goods” without explaining the control model. Even more technical ERP articles describe reason-code setup screens but do not connect them to ecommerce risks like overselling, FBA reimbursement evidence, returns disposition, marketplace SLA misses and margin leakage.
That gap matters for online sellers. A damaged unit in an ecommerce warehouse is not just a warehouse event. It can affect a paid ad campaign, a marketplace promise date, a customer service ticket, a supplier negotiation and an accounting close. The WMS should make that chain visible.
The minimum data fields to capture
Do not ask warehouse staff to become accountants at the shelf. Keep the scan fast and add approval only where value or risk justifies it. A damaged-stock event should capture SKU, quantity, location, employee, timestamp, source code, condition code, photo evidence and proposed disposition. For higher-value SKUs, add manager approval before write-off.
Serial-numbered products need tighter control. If an item has a serial number, the damage event should attach to that exact serial. Lot-controlled products need lot and expiry data as well, especially for food, cosmetics, supplements and electronics accessories where safety or expiry affects resale decisions.
If a code changes sellable stock, it should be visible in the same audit trail as cycle counts, returns, transfers and receiving discrepancies. That is how teams separate real damage from training issues, supplier packaging failures and integration drift.
How damaged-stock codes protect marketplace availability
Multichannel sellers share a limited stock pool across channels. A single damaged unit can create an oversell if the WMS adjusts local stock but the sync layer still exports the old available quantity. The safer pattern is to move damaged units into a non-sellable status first, then let the available-to-sell calculation subtract that quantity before the next channel sync.
For sellers using shared stock, buffers and reservations, damaged-stock codes should sit upstream of availability. The availability formula should treat damaged, quarantine, pending-inspection and claim stock as unavailable until a final disposition returns it to sellable inventory. ChannelDock's inventory workflows can connect that logic with stock control, order handling and warehouse execution from one operational view.
- A damaged-stock code is only useful when it changes stock status, not just when it explains a past adjustment.
- Separate source, condition and disposition so operations can prevent repeat damage instead of only booking write-offs.
- Require photo evidence for supplier, carrier and high-value warehouse damage, but keep the scan flow fast for low-value cases.
- Keep damaged and quarantine stock out of marketplace availability until inspection is complete.
- Review the top damaged-stock codes weekly by SKU, location and source to find training, packaging and supplier issues.
FAQ
What are damaged stock reason codes?
How many damage reason codes should an ecommerce warehouse use?
Should damaged stock be removed from marketplace availability immediately?
Do reason codes replace cycle counts?
When should a manager approve damaged-stock write-offs?
Conclusion
Damaged stock reason codes turn a warehouse correction into a control system. The goal is not to create administration. The goal is to keep unsellable units out of active inventory, prove what happened, recover value where possible and prevent the same damage pattern from repeating. For online sellers scaling beyond spreadsheets, this is one of the simplest WMS disciplines that protects margin and customer promises at the same time.