Walmart Deduction Code 22: What It Means and How to Dispute It

Home › Walmart › Walmart Deduction Code 22

Last updated: October 26, 2026.

Walmart deduction code 22 means Merchandise Billed Not Shipped. Walmart counted fewer units of an item than you invoiced, so it deducted the difference from that invoice line. You dispute it in APDP inside Retail Link with a signed proof of delivery or bill of lading that lists the PO.

Key takeaways

  • Code 22 is a line-level quantity deduction: invoiced units for one item are higher than the units Walmart counted in.
  • Common causes include DC receiving and scan errors, pack-size mismatches, invoice timing and substitutions.
  • Disputes go through APDP in Retail Link, with documents attached before you submit.
  • Industry sources cite a two-year lookback, but older deductions are much harder to document.
  • Historically about 65% of code 22 disputes were won, across vendor-filed Walmart disputes we have reviewed.

What does Walmart deduction code 22 mean?

When Walmart pays an invoice, it compares the quantity you billed for each item with the quantity its distribution center counted. If you invoiced 45 cases of an item and Walmart’s count shows 40, the cost of the 5 missing cases comes off the payment as code 22, Merchandise Billed Not Shipped. Some vendors call it “billed not shipped” or “goods billed not shipped.” It is the same deduction.

Code 22 works at the line level. It names a specific item on a specific invoice, which separates it from code 25, where Walmart found no receipt for the whole invoice, and from code 24, a carton shortage recorded on the freight bill. In APIS paid history the deduction type appears as 0022, and in the Supplier One payments export the reason code appears as 022.

You can see and export code 22 lines in Supplier One under Payments, filtered by reason code. That export is the fastest way to size the problem across your account before deciding which lines to dispute.

What triggers a code 22 deduction?

Most code 22 lines trace back to one of a handful of causes. Some of them mean the goods arrived and the deduction is wrong. Others mean the shortage was real.

  1. Receiving and scan errors at the DC. Cases get scanned under the wrong item or PO, or a mixed pallet is miscounted at the dock.
  2. Pack-size or unit-of-measure mismatch. The item file, the PO (EDI 850) and your invoice (EDI 810) disagree on pack size, so cases and eaches never reconcile.
  3. Invoice timing and split shipments. You invoiced before receiving finished, split a PO across loads, or billed one PO for goods that arrived on another.
  4. ASN and label problems. A late, missing or inaccurate ASN (EDI 856) or unreadable case labels make it harder for the DC to match cartons to your PO.
  5. Substitutions. If you shipped a substitute item, Walmart deducts the invoiced item as a negative code 22 and credits the substitute as a positive code 13. The two lines offset each other, so the net is what matters.
  6. Genuine short-ships or transit loss. The goods really did not ship or did not arrive.
From remittance line to recovered cash
From remittance line to recovered cash

Valid vs invalid code 22 deductions

Before filing anything, sort each code 22 line into one of two groups. Disputing a valid deduction uses up one of your limited attempts on that line and ties up your team.

Likely invalid (worth disputing)Likely valid (fix upstream instead)
Full quantity delivered, with a signed POD or carrier-signed BOL that lists the POYour own pick or ship records show the line went out short
Cases scanned under the wrong item or PO at the DCFreight was tendered shipper load and count and you cannot show the carrier verified the count
Pack-size or unit-of-measure mismatch where the units were deliveredGoods lost or damaged in transit (recover from the carrier)
Substitution where the code 13 credit does not fully offset the code 22Substitution pair that nets to zero

For lines in the right-hand column, the better use of time is fixing the cause: correcting item file pack sizes, tightening ASN timing, or filing a carrier claim for transit loss.

What documents support a code 22 dispute?

Walmart publishes basic evidence guidance by freight type, and it applies to code 22 like any other shortage code. For prepaid freight, Walmart looks for the facility’s signed receiving stamp on the POD. For a prepaid drop trailer, it expects the drop stamp plus a BOL listing the POs and case counts. For collect freight, it expects a carrier-signed BOL listing the POs, and for small parcel, delivery confirmation for each PO.

Your invoice and ASN support the file by showing what you billed and what you said you shipped. Our team knows which evidence each code needs and builds every dispute with the documentation Walmart requires.

What is the deadline to dispute code 22?

Walmart does not publish a per-code dispute window. Industry sources consistently cite a two-year lookback for APDP disputes. In practice, the older a deduction gets, the harder it is to win, because carriers purge POD images and the people who handled the shipment move on.

Several shorter clocks also apply once you file:

  • An APDP draft you never submit expires after 14 days.
  • If Walmart moves your dispute to Supplier Action, you have 7 days to respond or it auto-closes.
  • You typically get up to three attempts per deduction line. First attempts win far more often, so re-dispute only with new evidence.

How do you dispute code 22 in APDP?

Walmart AP deductions are disputed in the Accounts Payable Disputes Portal (APDP) inside Retail Link. Supplier One’s “create dispute” link sends you to the same place. The public process looks like this:

  1. In Retail Link, open Apps, then APDP, then Create.
  2. Search by claim number, invoice number, PO or deduction code to find the code 22 line.
  3. Add the line to your dispute. This creates a draft, which can be cancelled but not deleted.
  4. Choose a proof type: POD, BOL, SPL (shipping label) or OTH (other).
  5. Attach your documents as PDF, JPEG or PNG before you submit. Files cannot be added afterward.
  6. Submit, then watch the status: Submitted, Walmart Research, Supplier Action, Approved or Denied, Sent for Payment, Paid.

Approved amounts come back as positive coded lines on a later remittance. For more detail, see our guide on how to dispute Walmart deductions in APDP.

How does code 22 compare with other shortage codes?

Code 22 sits in a family of shortage deductions. Code 24 covers cartons the DC signed short on the freight bill, code 25 covers invoices with no receipt at all, and code 21 covers concealed shortages. Historical win rates across vendor-filed Walmart disputes we have reviewed are about 65% for code 22, 78% for code 24 and 80% for code 25.

Our overview of Walmart shortage deductions explains how the codes relate, and the full list of Walmart deduction codes covers every code you may see on a remittance.

Why do vendors hand code 22 recovery to a specialist?

Code 22 lines are small and numerous. A single PO can produce several, each with its own invoice, item and document trail, and each needs to be filed separately in APDP before its evidence goes stale. For most AR teams, that volume competes with collections and close.

Refunds Manager recovers Walmart shortage deductions, including codes 22, 24 and 25, for 1P Retail Link vendors who ship prepaid to Walmart DCs. We work on contingency: no recovery, no fee, with a monthly recovery report showing what was filed and what came back. Across 13+ years we have recovered more than $1B+ for 15,000+ clients, with a 90% success rate and a 4.9/5 rating on Trustpilot.

One national safety and workwear supplier recovered over $120,000 within the first month after sign-up, with a further $75,000 pending Walmart review. Learn more about our Walmart deduction recovery service.

Dispute it yourself, or we recover it for you on contingency.

Refunds Manager recovers Walmart shortage deductions (codes 22, 24 and 25) for 1P Retail Link vendors who ship prepaid to Walmart DCs. We build each dispute with the documentation Walmart requires, track it to payment and send a monthly recovery report. No recovery, no fee.

Request your free Walmart deduction audit:



    Estimated Annual Walmart Sales



    Frequently asked questions

    What is Walmart deduction code 22?

    Code 22 is Merchandise Billed Not Shipped. Walmart counted fewer units of an item than you invoiced and deducted the difference from that invoice line.

    Is code 22 the same as merchandise billed not shipped?

    Yes. Merchandise Billed Not Shipped is the name of code 22. It shows as 0022 in APIS paid history and as reason code 022 in the Supplier One payments export.

    How long do I have to dispute a code 22 deduction?

    Walmart does not publish a per-code window, but industry sources cite a two-year lookback for APDP disputes. File as early as you can, because carriers purge POD images over time.

    Why does a code 13 credit appear next to a code 22?

    When you ship a substitute item, Walmart deducts the invoiced item as a negative code 22 and credits the substitute as a positive code 13. Review the two lines together, since only the net difference is at stake.

    What documents support a code 22 dispute?

    Public Walmart guidance asks for a POD with the facility's signed receiving stamp on prepaid freight, a carrier-signed BOL listing the POs on collect freight, and delivery confirmation per PO for small parcel. Your invoice and ASN support the file.

    Can Refunds Manager dispute code 22 deductions for us?

    Yes. We recover Walmart shortage deductions, including codes 22, 24 and 25, for 1P Retail Link vendors who ship prepaid to Walmart DCs, on contingency: no recovery, no fee.

    Grow Your Profit With Us




      Contact background
      Skip to content