How to Dispute Walmart Shortage Deductions (Codes 21, 22, 24, 25)


Shortage deductions are among the most common and recoverable issues Walmart suppliers face. Codes 21, 22, 24, and 25 account for a large share of volume for many CPG companies. With solid documentation, these claims are often winnable. When it is missing or mismatched, the dollars are usually lost.
This guide breaks down the differences between the main shortage types. It covers what documentation actually works, how to file effectively in APDP, and when mass dispute tools make sense versus individual disputes. The typical dispute process involves identifying the shortage claim, gathering and attaching relevant documentation, submitting the dispute through APDP, and following up until resolution. This overview will help you quickly understand the flow before diving into the step-by-step guidance.
Understanding the Four Main Shortage Codes
Walmart uses specific codes to describe different shortage scenarios. Treating them all the same is one of the fastest ways to lose recoverable dollars.
Code 21 – Concealed Shortage: The outer carton count matched expectations, but product was missing inside the carton or inner pack. These cases are usually found later, during unpacking or at the store, not at the distribution center receiving scan.
Code 22 – Merchandise Billed Not Shipped (Goods Billed Not Shipped): Walmart's records show the full quantity was invoiced, but not all of it was shipped or received. This often reflects packing errors, split shipments, or invoice mismatches with what left the warehouse.
Code 24 – Carton Shortage / Freight Bill Signed Short: The freight bill or proof of delivery was signed short at pickup or delivery. The carrier or receiving location documented fewer cartons than the ASN or invoice showed. This is common on mixed pallets and floor-loaded trailers.
Code 25 – No Merchandise Received for Invoice: Walmart has no record of receiving the goods for a particular invoice. This can result from routing issues, lost shipments, or documents that never matched the receiving record.
Each code points to a different root cause and requires different proof. A clean proof of delivery may win a Code 24 but do little for a Code 21 if you can't support the inner-pack count.
Documentation That Wins Shortage Disputes
Walmart's dispute process is largely rules-based. Strong documentation that matches the claim details is far more effective than a general explanation.
The most useful documents include:
Bill of Lading (BOL) and Proof of Delivery (POD): These should show the purchase order number, carton or case count, and signatures or stamps confirming what was shipped and received. For Code 24, an unsigned POD is often decisive.
Advance Ship Notice (ASN): Confirms what was electronically declared as shipped.
Invoice and Purchase Order: Used to match quantities, item numbers, and case packs.
Packing lists or case-level records: Especially valuable for Code 21 (concealed) and Code 22 situations where the outer count matched but contents did not.
Carrier records or tracking: Helpful when the discrepancy occurred in transit or at the dock.
The strongest disputes show that the full quantity left the supplier's facility (or arrived at the distribution center) and that any shortage occurred on the retailer's or carrier's side. Mismatched PO numbers, missing signatures, or documents that do not reference the specific claim are common reasons disputes are denied.
Step-by-Step: Filing a Shortage Dispute in APDP
Most shortage claims are handled through Walmart's Accounts Payable Dispute Portal (APDP) inside Retail Link.
Log in to Retail Link and open APDP.
Search for the claim or invoice by claim number or invoice number.
Review the details (code, amount, date) and confirm it is eligible. A claim is typically eligible if it falls within the dispute window, uses a valid shortage code, and has not already been resolved or disputed. Confirm that you can provide all required supporting documentation before proceeding.
Create the dispute and provide a clear, factual description of why the claim is invalid.
Attach the supporting documents (BOL, POD, ASN, invoice, etc.). Make sure file names and content clearly reference the claim.
Submit and monitor the status. Respond promptly if Walmart requests additional information (typically within a short window).
Common pitfalls:
Attaching generic documents that do not match the specific claim or PO.
Waiting too long—dispute windows for many APDP claims are limited.
Submitting incomplete evidence on the first attempt and then missing the follow-up deadline.
Using the wrong portal (some compliance items go through EIPP rather than APDP). As a rule of thumb, APDP handles shortage and payment claims, while EIPP handles deduction types linked to compliance fines or operational chargebacks. Double-check the specific code and deduction type to make sure you are using the correct portal, since misfiling can lead to processing delays or rejected disputes.
Mass Dispute Tools vs. Individual Disputes
Walmart offers Mass Dispute Creation (MDC) for certain lower-value codes.
Eligible shortage-related codes can include 21, 22, and 24 in some cases. In general, the main MDC eligibility criteria are: the claim must use an eligible code, the claim amount must be below Walmart's maximum threshold, the claim must be within the open dispute window, and the dispute must not have been submitted individually before. For these claims, MDC works best when volume is high, dollar amounts are low, and the effort to gather full support for each claim would outweigh the recovery opportunity. Use MDC to move faster on smaller claims, but review eligibility carefully before submitting.
MDC can be efficient for high volumes of small claims where gathering full documentation for each one isn't practical. However, win rates on mass disputes are typically much lower than on well-documented individual disputes.
Use individual disputes when:
The claim value is meaningful.
You have a clean POD, BOL, or other strong evidence.
The code is high-frequency, and you want to establish a pattern of successful recovery.
Consider MDC when:
Claims are low-dollar and high-volume.
The amount at stake does not justify full documentation for each claim.
You want to clear backlog quickly while focusing individual effort on higher-value opportunities.
Full documentation is incomplete or expensive to gather relative to the amount.
You want to clear backlog quickly while focusing individual effort on higher-value opportunities.
Many suppliers use a hybrid approach: individual disputes for the strongest cases and MDC for the rest.
Prevention and Next Steps
Winning individual disputes is valuable, but the bigger opportunity is reducing shortage volume over time. Recurring Codes 22 or 24 on the same items, distribution centers, or carriers often point to packing, labeling, ASN accuracy, or carrier process issues that can be fixed upstream.
To help prevent shortages, consider implementing regular internal audits of shipment accuracy and documentation before orders leave your facility. Also, confirm that your Advance Ship Notices (ASNs) are completed accurately and match the physical shipment. These steps can catch common issues early and reduce shortage deductions.
If shortage deductions represent a meaningful portion of your Walmart volume, a structured review of recent claims—paired with the right documentation and dispute strategy—can surface both recoverable dollars and the root causes driving them.
HRG helps suppliers investigate shortage claims, assemble the supporting evidence, manage disputes through APDP, and identify the patterns that reduce future leakage. To understand what may be recoverable and where your current shortage activity stands, request a free opportunity analysis.


