top of page

Complete Guide to Walmart Deduction Codes (With Dispute Tips)

Writer: Jon Allen
Jon Allen
24 minutes ago
9 min read
Unlock Walmart deduction codes. Open padlock piercing a stack of hundred-dollar bills on a white background.

What Walmart's deduction codes mean, which claims you can challenge, and how to recover revenue you've earned.

You shipped the products. Walmart received the order. You submitted the invoice.

Then the payment arrived, and it was less than expected.

The explanation? A deduction code.

Maybe it's Code 22 for merchandise billed but not shipped. Code 11 for a pricing discrepancy—or Code 51 for a promotional allowance.

These codes may look like simple accounting references, but they represent real money leaving your business.

For Walmart suppliers managing thousands of transactions, even relatively small deductions can add up quickly.

The challenge isn't just understanding what a code means. It's determining whether the deduction is legitimate, whether you can dispute it, and what documentation you'll need to support recovery.

This guide breaks down common Walmart deduction codes and offers practical tips to help you evaluate claims, prioritize recovery opportunities, and reduce future deductions.

What are Walmart deduction codes?

Walmart uses deduction codes to identify why it withheld money from a supplier's payment.

Each code represents a particular type of claim, such as a shortage, pricing discrepancy, promotional allowance, merchandise return, or other adjustment.

For example:

  • Code 11 generally indicates a difference between the purchase order price and the invoiced price.

  • Code 22 indicates merchandise Walmart says was billed but not shipped.

  • Code 25 indicates Walmart has no merchandise receipt associated with the invoice.

  • Code 51 relates to promotional, display, or fixture allowances.

The code helps explain why Walmart reduced the payment. It doesn't, by itself, establish that the deduction is valid.

That's an important distinction.

Some deductions are legitimate and reflect agreed terms or actual operational errors. Others may result from incorrect receiving information, inaccurate pricing records, duplicate transactions, or mismatched documentation.

Understanding the code is the first step toward determining what happened.

Common Walmart deduction codes: A supplier reference guide

The following table summarizes frequently encountered deduction codes, their typical causes, the evidence worth reviewing, and the appropriate dispute route.

To check if a deduction code is eligible for APDP, suppliers should review the APDP portal for current eligibility lists or consult Walmart's supplier documentation, as some codes and claim types may have dedicated workflows or require action through a merchant or Returns Center. Confirming the right channel before starting a dispute helps avoid delays and increases the chance of a successful claim.

Pricing, shortage, and invoice deductions

Code

Meaning and common trigger

Evidence to review

Dispute route and recovery considerations

10

Price difference or allowance discrepancy; agreed terms differ from the deduction

Supplier agreement, invoice, allowance terms

APDP in eligible cases; merchant involvement may be needed

11

Pricing overcharge; PO price differs from invoice

PO, invoice, approved price changes, effective dates

APDP for eligible claims; buyer payback may be necessary

13

Substitution overcharge; Walmart records a substitute product at a different cost

PO, invoice, BOL, POD, item records

APDP; investigate related shortage codes

21

Concealed shortage; merchandise reported missing inside a shipment

BOL, POD, packing records, receiving data

APDP; recovery depends on proof of actual quantities

22

Goods billed but not shipped; invoiced quantity exceeds recorded shipment or receipt

Invoice, BOL, POD, ASN, receiving records

APDP; strong candidate for investigation when shipment and receipt evidence conflict

24

Carton shortage; freight bill signed short

BOL, signed POD, carton counts, carrier records

APDP; investigate whether the signed shortage was accurate

25

No merchandise received for invoice; no matching receipt identified

PO, invoice, BOL, POD, ASN, receiving records

APDP; receipt matching and delivery evidence are critical

30

Duplicate billing; Walmart identifies a potentially repeated invoice

Both invoices, POs, payment history, BOL/POD

APDP mass-dispute functionality where available; verify current eligibility and whether invoicing was actually duplicated

BOL = Bill of Lading; POD = Proof of Delivery; ASN = Advance Shipment Notice; APDP = Accounts Payable Dispute Portal.

Allowances, returns, and compliance deductions

Code

Meaning and common trigger

Evidence to review

Dispute route and recovery considerations

50

Advertising allowance; retailer charges for agreed advertising support

Advertising agreement, approved terms, charge details

Generally merchant/buyer payback; APDP approval is limited

51

Promotional, display, or fixture allowance; deduction differs from expected promotional terms

Promotional agreement, dates, item details, calculations

Typically merchant/buyer payback rather than routine APDP

52

Volume allowance; rebate or allowance based on purchases or volume

Supplier agreement, purchase totals, calculation

Merchant/buyer review; verify thresholds and rates

54

Warehouse allowance; contracted distribution allowance

Supplier agreement, invoice, allowance calculations

Usually merchant/buyer review

59

Defective merchandise allowance; charge associated with agreed defective-merchandise terms

Supplier agreement, allowance rates, supporting claim details

Merchant/buyer review; confirm contractual basis

66

Markdown monies or price protection

Approved markdown agreement, price dates, inventory and sales data

Verify agreement and route through the appropriate merchant process

87

Other adjustment; broad category requiring investigation

Claim details, invoices, relevant agreements

APDP where eligible; evidence depends on the underlying issue

92

Returned merchandise: overstock or recall

Return authorization, credit records, claim backup

APDP only for eligible non-Returns-Center claims; otherwise Partner Support

94

Returned or defective merchandise

Return documentation, agreement, claim details

Depends on return channel; Returns Center claims use a separate process

99 / OTIF

On-Time In-Full compliance charge

Delivery appointments, carrier timestamps, PO and shipment records

Compliance dispute process, generally HighRadius; not the standard APDP route

SQEP

Supplier Quality Excellence Program charge, such as labeling or ASN defects

ASN acknowledgments, label images, inspection records

Compliance dispute process, generally HighRadius

Important: Codes identify the reported reason for a deduction, not whether the claim is valid. APDP availability can vary by claim type and process. Codes such as 30 have specialized dispute workflows, while allowances and Returns Center charges may require different channels.

Which Walmart deductions are worth disputing?

No single deduction code guarantees recovery.

The strongest opportunities arise when the available evidence demonstrates a clear discrepancy between Walmart's claim and what actually occurred.

Consider three common examples.

Example 1: Code 22 — Merchandise billed but not shipped

Your invoice shows 1,000 units shipped, but Walmart's deduction indicates that only 900 were accounted for.

Your warehouse confirms the full quantity was loaded.

Does that mean the deduction is invalid?

Not necessarily.

The next step is to compare the shipping records with Walmart's receiving data.

If Walmart received a complete, properly documented shipment but recorded it incorrectly, there may be a legitimate recovery opportunity.

If the missing units were never shipped or were lost in transit, the responsibility may be different.

Dispute tip: Match the purchase order, invoice, ASN, BOL, and POD. Investigate differences in quantities, units of measure, and receiving information before submitting the claim.

Example 2: Code 11 — Pricing overcharge

Walmart approves a new cost effective October 1.

Your team updates the invoice price, but the purchase order still reflects the previous amount.

Walmart deducts the difference.

Your first instinct may be to dispute the deduction because the increase was approved.

But approval alone may not be sufficient.

You'll need documentation establishing the approved cost, effective date, applicable items, and whether the purchase order qualifies for the new price.

Dispute tip: Include written approval and a clear explanation connecting the agreed terms to the specific transaction. Also check whether the dispute requires merchant involvement.

Example 3: Code 51 — Promotional allowance

Your business agrees to a promotional allowance for a specified period and product assortment.

Later, Walmart takes an allowance that appears to exceed the agreed amount.

This could be a valid recovery opportunity, but it may not follow the same dispute process as a shortage.

Codes associated with promotional and contractual allowances often require merchant review or buyer-approved payback.

Dispute tip: Compare the original agreement, promotional dates, eligible products, quantities, and actual deduction calculations. Present the discrepancy clearly, with the relevant supporting records.

Where do Walmart suppliers dispute deductions?

One of the most common mistakes suppliers make is assuming every deduction belongs in the same dispute system.

Walmart uses different processes depending on the claim type.

1. Accounts Payable Dispute Portal (APDP)

APDP is the primary dispute channel for eligible Accounts Payable deductions.

Suppliers commonly use it for claims involving shortages, pricing discrepancies, damaged merchandise, and certain returns.

Examples include Codes 11, 21, 22, 24, and 25.

Suppliers should verify eligibility within the portal because not every code or transaction can be disputed through APDP. To check eligibility, log in to the APDP portal and use the search or filter functions to look up the deduction code in question. Many codes display eligibility details directly, including available dispute actions and guidelines for supporting documentation. If you need help finding this information, consult the portal's help resources or contact your Walmart support contact for guidance on specific codes. This step ensures you initiate your dispute using the correct workflow and avoid unnecessary delays.

2. Merchant or buyer-approved paybacks

Some deductions require action through Walmart's merchant team.

Promotional allowances, volume allowances, and other contractual charges may need buyer involvement.

In these situations, having clear documentation and a specific explanation of the error is especially important.

A buyer is not obligated to approve repayment simply because a supplier disagrees with a deduction.

3. Returns Center claims

Returns processed through Walmart's Returns Centers generally follow a separate claim procedure.

Suppliers may need to obtain claim backup, complete the appropriate chargeback form, and submit a case through Walmart Partner Support.

4. Compliance disputes: OTIF and SQEP

OTIF and SQEP charges are different from traditional Accounts Payable shortages.

They address delivery performance and supplier compliance requirements.

Walmart generally handles these disputes through its compliance billing process, including HighRadius, rather than standard APDP submissions.

The evidence required depends on the charge.

For OTIF, it may include carrier delivery records and appointment information.

For SQEP, it may include ASN acknowledgments, labeling evidence, inspection details, or other records associated with the reported defect.

The right dispute process is just as important as having the right documentation.

How long do suppliers have to dispute Walmart deductions?

Time matters.

Walmart's standard APDP process generally has a two-year limitation measured from the original claim date.

That doesn't mean every deduction has two years, or that every Walmart claim follows the APDP process.

Compliance charges, returns, and other categories can have different procedures and deadlines. For example, compliance charges such as OTIF or SQEP may have dispute windows of as little as 90 days, while some return-related deductions or certain promotional allowances may be limited to 12 months or less. Always check the claim type in Walmart's supplier documentation or within the relevant portal to confirm the current deadline, as some dispute windows are significantly shorter than the standard two-year APDP period. Staying aware of these differences helps avoid missing critical recovery opportunities.

Suppliers should confirm the applicable rules for each claim before assuming recovery remains available.

What about 2024 deductions?

As 2026 comes to a close, older 2024 Walmart deductions deserve immediate attention.

Claims originating in 2024 have been reaching their two-year anniversaries throughout 2026. The remaining eligible claims will continue aging out based on their individual dates.

January 31, 2027, is an important milestone for Walmart's fiscal calendar, but it isn't a universal expiration date for every 2024 claim.

If you still have unresolved 2024 Walmart deductions, now is the time to review them.

Don't wait until a deadline passes to determine whether the claim was recoverable.

Five tips for stronger Walmart deduction disputes

1. Investigate before you dispute

Start by determining whether the claim is valid.

If a shipment was actually short or an allowance was correctly calculated, pursuing recovery may not be appropriate.

A good recovery process focuses on evidence, not assumptions.

2. Match documents to the deduction code

A pricing dispute requires different proof than a shortage.

For shortages, focus on shipment and receiving evidence.

For pricing, focus on approved costs, purchase orders, and invoices.

For allowances, focus on agreements, effective dates, and calculations.

3. Make the explanation easy to understand

A large collection of attachments doesn't automatically create a strong dispute.

Explain exactly why the deduction is incorrect, identify the relevant transaction, and connect the evidence to the disputed amount.

4. Monitor the dispute after submission

Submitting a dispute isn't the same as resolving it.

Retailers may request additional documentation or clarification.

Track claim statuses, respond to requests, and maintain a record of the outcome.

5. Look beyond the individual claim

If the same deduction keeps appearing, investigate the pattern.

Repeated pricing discrepancies may indicate item-file or agreement-management issues.

Recurring shortages may point to problems with shipping, carrier performance, or receiving reconciliation.

Understanding these patterns can help suppliers prevent future revenue loss.

What Walmart deduction codes can tell you about your business

A deduction report is more than a list of charges.

It's a source of information about how your business interacts with Walmart.

An increase in pricing deductions may indicate problems with cost updates.


Repeated shortages at a particular distribution center may warrant additional investigation.


A concentration of promotional allowance disputes may reveal differences between Sales, Finance, and the retailer's understanding of an agreement.


This is where effective deduction management becomes more valuable than processing claims one at a time.


By examining patterns across deduction categories, suppliers can identify opportunities to improve operations and reduce avoidable revenue loss.


How HRG helps Walmart suppliers recover revenue

At Harvest Revenue Group, we've helped suppliers recover revenue from complex retailer deductions since 2010.


Our team has contributed to more than $1 billion in recoveries across our retail recovery work.


We understand that suppliers need more than someone to submit disputes.


They need a business partner who can investigate claims, identify recoverable revenue, understand the underlying causes, and help reduce recurring deductions.


HRG combines experienced retail auditors with analytical capabilities that help clients gain greater visibility into their deductions.


Through services such as Retail Deduction Recovery and Audit 360, we help suppliers move from reacting to individual charges toward a more consistent approach to recovery and prevention.


Because the goal isn't simply to challenge Walmart's deductions.


It's to make sure your business understands where its revenue is going — and why.


Know the code. Understand the claim. Protect your revenue.

Every Walmart deduction has a story behind it.


Sometimes it's a valid charge. Sometimes it's an operational problem that needs attention. And sometimes it represents revenue your business may be entitled to recover.


The code tells you where to begin.


The evidence tells you what to do next.


Have unresolved Walmart deductions? Let's take a closer look.

Contact HRG to discuss your recovery opportunities and learn how we help suppliers recover revenue, reduce risk, and perform better. Our support covers every stage of the deduction dispute process, including detailed documentation review, claim preparation, negotiation with Walmart teams, and root cause analysis to help resolve underlying issues. By combining our dispute-resolution expertise with actionable insights, we help suppliers recover more revenue and strengthen their processes to prevent future deductions.

bottom of page