Deduction Knowledge Hub

Everything we know about retailer deductions, in one place.

Retailer deductions, also called chargebacks, are amounts a retailer subtracts from a supplier's invoice payment, each tied to a reason code alleging a compliance failure: a shortage, a late or incomplete shipment, a packing or labeling error, or a pricing discrepancy. Many are valid. Many are not, and the difference is decided by documentation, not argument. This hub collects what we have published on how deductions arise, what each code means, how individual retailers handle disputes, and when a deduction is worth challenging.

Deductions and chargebacks: the basics

Most of what confuses people about deductions is vocabulary. The same event travels under two names, arrives in a form that does not look like a bill, and lands in an inbox that was never designed to adjudicate it. Start here, then follow the thread that matches your situation.

What is a retailer deduction?

A retailer deduction is money a retailer withholds from a supplier's invoice payment, tied to a reason code that alleges a compliance failure on a specific shipment or order. It does not arrive as a separate bill. It arrives as a short-pay line on a remittance advice, netted against invoices you already expected to be paid in full. That form is the reason deductions are easy to miss and easy to accept by default: nobody sends you an invitation to contest them, and the accounting entry closes itself if you do nothing. The origin is almost always a vendor compliance manual or routing guide that defines what correct looks like, and a deduction desk applying it. Read: the disputable shortage claims most teams let slide

What is the difference between a deduction and a chargeback?

In practice, none. In retail supply chain the two words describe the same event: the retailer reduces what it pays and cites a reason code. The split is departmental, not substantive. Chargeback is the term used in vendor compliance manuals and by the retailer's compliance group; deduction is the term used in accounts receivable, where the short-pay actually shows up. Suppliers who treat them as separate things often end up with two partial views of one problem: compliance tracking violations it cannot see the cash impact of, and accounts receivable watching cash disappear without the underlying reason. Read: the three types of retailer chargebacks

What types of retailer chargebacks are there?

Retailer chargebacks cluster into a small number of recurring families. Shortage and receiving discrepancies allege the retailer got less than the invoice claims. Shipping and on-time-in-full (OTIF) charges allege the order arrived late, incomplete, or outside the routing guide, and they usually turn on advance ship notice (ASN) accuracy and routing confirmation. Packing and labeling non-compliance covers carton marking, ticketing, and pack configuration. Pricing discrepancies allege the invoiced price does not match the agreed price. Freight, relay, and third-party charges push liability toward a 3PL or carrier rather than the supplier itself, and unauthorized return charges sit in their own category. Each family has its own evidence set: a proof of delivery (POD) or bill of lading (BOL) for a shortage, an ASN and EDI 856 for OTIF, carton photographs and the routing guide for packing. Read the deep dives on each family

Look up a code

Every deduction carries a reason code, and the code is the fastest route to knowing what the retailer is actually alleging. The Deduction Code Library maps codes to the underlying claim and to the evidence that typically speaks to it.

Dispute guides by retailer

Each retailer runs its own dispute process, its own channel, its own evidence expectations, and its own deadline. These guides cover the mechanics retailer by retailer, so you are working from that retailer's rules rather than a generic template.

Playbooks and guides

Start here if you are still working out what a deduction is, which of them are worth challenging, and what the words mean. These guides cover the ground before the retailer-specific mechanics.

What is retailer deduction recovery?

The definition, and the four things it gets confused with: card chargebacks, tax recovery, data recovery, and a similarly named product in another industry.

Read

Deduction Dispute Letter Template

A fill-in template for disputing a retailer deduction: identifiers, evidence by deduction type, and what to ask for.

Read

Deduction KPIs: Definitions and Formulas

Clear definitions and formulas for the deduction KPIs finance teams track: DDO, dispute rate, recovery rate, aging buckets, and more, with common pitfalls.

Read

Allowance and Markdown Deductions

Tell a valid trade promotion, co-op, or markdown allowance deduction from a disputable one, and know what to attach.

Read

How to Dispute a Retailer Deduction

The cross-retailer process to identify, classify, and file a deduction dispute before your retailer's window closes.

Read

OTIF Fines: How They Work by Retailer

How CVS and Kroger define on-time and in-full, and how to check an OTIF fine against your own ship and delivery records.

Read

Freight and Routing Deductions Explained

What a routing guide violation is, how detention and demurrage charges work, and how to check each against your own records.

Read

Returns and RTV Deductions Explained

What a return-to-vendor deduction is, how defective merchandise charges and unauthorized returns differ, and how to check each against your records.

Read

EDI Compliance Chargebacks Explained

Which EDI document failures (850, 856, 810, 997) become a chargeback, and how to check each against your own EDI log.

Read

Proof and Documentation Checklist by Deduction Type

Which documents answer a shortage, OTIF, freight, returns, EDI compliance, allowance, or pricing deduction, and which guide covers each.

Read

Filing a Freight Claim Against the Carrier

Who files a freight claim, what it must contain, the filing and response deadlines, and how shipper load and count affects a shortage claim.

Read

Pricing and Cost-Difference Deductions

What a pricing or cost-difference deduction is, how to verify it against your PO and invoice, and when it holds up to dispute.

Read

Deep dives

Longer pieces on the chargeback families that cost suppliers the most attention: shortages, OTIF and shipping compliance, packing and labeling, and freight and relay liability. Read these when you want the reasoning behind a dispute, not just the process.

How other teams handle it

Deduction management gets handled in very different ways, from spreadsheets and a deduction analyst to dedicated software to an AI agent that assembles the evidence. These comparisons and case studies lay out how each approach behaves in practice, including where each one runs out of room.

Frequently asked

What is a retailer deduction?

Money a retailer withholds from a supplier's invoice payment, tied to a reason code alleging a compliance failure on that shipment or order. It arrives as a short-pay on a remittance rather than as a separate bill, which is why deductions are easy to miss and easy to accept by default.

Is a deduction the same thing as a chargeback?

In retail supply chain the two terms are used interchangeably for the same event: the retailer reduces what it pays against a stated reason code. Chargeback is more common in vendor compliance manuals, deduction more common in accounts receivable.

Are retailer chargebacks disputable?

Many are, but not all, and each retailer sets its own dispute window and evidence requirements. Whether a specific deduction is worth challenging depends on whether you can produce the documents that contradict the retailer's claim, a proof of delivery against a shortage, an advance ship notice and routing confirmation against an OTIF charge, before the window closes.

How do I find out what a specific deduction code means?

Our Deduction Code Library maps chargeback reason codes to what the retailer is actually alleging and what evidence typically speaks to it. Start there, then check the retailer-specific dispute guide for that retailer's process and deadlines.

Does ROIAI One dispute deductions automatically?

Roy gathers the underlying documents, matches them against the retailer's claim, and assembles a dispute packet with the reasoning laid out, including a recommendation not to dispute, which is sometimes the right call. Review is selective and exception-based. ROIAI One's own analysts review the exceptions that need judgment, not the customer's team. Auto-submission is off by default for every reason code, and enabling it for a given reason code is a deliberate change the customer makes and can reverse.

Working out what your deductions actually cost you?

Start with a recovery assessment, or run the numbers yourself in the calculator. Either way, every dispute packet Roy assembles is reviewed by a person before it goes to the retailer.