The deduction management process: how to code, match and dispute retailer deductions

In this Mirage Metrics guide, deduction management is the accounts receivable work of turning each short payment into a decision. Every deduction a retailer or distributor takes is read from the remittance advice, coded to its family (shortage, pricing, trade promotion, compliance fine, returns and spoils, post-audit claim), matched to the invoice it reduces, and checked against the backup that family calls for: the proof of delivery signed at receipt for a shortage, the PO and your price file for a pricing deduction, the promotion agreement and its dates for trade spend, your ASN and shipping timestamps for a fine. Valid deductions are posted. Invalid ones are disputed with that backup before the customer's window closes, and the windows are contractual and short: 180 days from the deduction at KeHE, 30 days for disputes at Sprouts. Software can capture, code, match and assemble the packet. A person decides validity, write-offs and what to say to the customer.

Published
Reading time
17 min
Written by
Jules Toussaint

Scope: US manufacturers and CPG or food suppliers selling to retailers and distributors. Supplier agreements are quoted from the versions their publishers post openly, read on October 30, 2026; the agreement you signed governs yours. Not legal advice.

Where Mirage stands

Mirage has published no deductions deployment. The nearest published work sits upstream of a deduction. At Biodéal, an organic dairy distributor supplying retail chains, Mirage reads customers' email orders and creates them in SAP Business One: 2,943 orders and 12,993 lines for 113 customers since July 22, 2025, about 7% flagged for a person. That is the order record a deduction is checked against. At Transwin, a Moroccan logistics operator, reading transport documents into the TMS brought 70% less manual data entry on freight documents: the delivery paperwork a shortage dispute rests on. Neither figure is a deduction result.

What a deduction is, and the six families

A deduction is an amount a customer subtracts from a payment instead of paying the invoice in full, with a reason given in the remittance advice, a debit memo or a supplier portal. A chargeback is usually an amount the customer bills you, a fine or a promotion claim, often collected by deduction too: KeHE's policies say "charged back" for promotions and spoils, Shopbop calls its fines chargebacks (KeHE, 7.4, 9.2; Shopbop, 2.2). The family, not the word, decides which document settles the question.

The six families of deductions and the backup that settles each (recommended practice; rules from the supplier agreements cited below). Compiled by Mirage Metrics, November 2026.
FamilyWhat the customer is sayingBackup that settles itValid whenDisputable when
Shortage"We received fewer cases than you invoiced"Proof of delivery signed at the receiving dock, with any exception; the customer's receiving count or discrepancy report; your BOL, ASN and pick recordThe receiving count shows the shortage and the agreement makes that count governSigned for in full with no exception and no discrepancy report, or the cases billed on another invoice
Pricing"Your invoice price is above our PO price"Invoice, PO, your price file with effective dates, the price change notice and its acceptanceThe PO price was the price in force: a change invoiced before it took effectThe PO carried an old price after an accepted change, or the deduction is larger than the difference
Trade promotion"Funding you agreed to: off-invoice, billback, scans, slotting, ads"The deal sheet (event, items, rate, dates, quantity basis, payment method) and the customer's proof of performanceAgreed event; items, dates, rate and quantity match; not paid another wayNo agreement, outside the dates, wrong items or rate, or paid twice
Compliance fine"You broke a rule of our routing guide or vendor manual"The rule and fee schedule in force on the ship date; your timestamps: ASN sent and acknowledged, appointment, arrivalYour own records show the rule was broken and the fee is the scheduled oneYour records show the requirement met, or the fee is above the schedule
Returns and spoils"Product we could not sell, under our program"The spoils or returns terms (an allowance or a per-unit charge) and the reclaim reportIt follows the agreed program and the units are yoursCharged both ways, not your units, or outside the program
Post-audit claim"Our auditor found an overpayment"The claim detail, your invoices, credits and promotion payments, and the agreed audit periodInside the agreed audit period and supported line by lineOutside the period, already credited, or sent without detail
The six families of deductions and the backup that settles each (recommended practice; rules from the supplier agreements cited below). Compiled by Mirage Metrics, November 2026.

The code gives the family, the family gives the document, the document gives the answer. Trade promotion deductions are often money you agreed to pay: check them against the deal, do not dispute them by default.

When a distributor passes a retailer's deduction through

KeHE passes through to the supplier every expense it incurs from retailers for the supplier's products, "regardless of the timing", acting as a "bank" because the retailer deducts from KeHE first (KeHE, 8). When the error came from the retailer's deduction, KeHE repays the supplier only when the retailer has repaid KeHE (4.4). A pass-through deduction therefore has two counterparties, and the backup you send has to work for the retailer's dispute too.

Reading the remittance: codes, references and the code map

Deductions arrive as lines on a remittance advice: an EDI 820, which X12 defines as the set used to "make a payment, send a remittance advice, or make a payment and send a remittance advice", or a portal export, a PDF, a paper stub. Debit memos can arrive as an EDI 812, used to "notify a trading partner of an adjustment or billback" (X12 transaction sets). Each line carries a deduction number and an amount, and often the invoice, the PO, a code and a short text.

Codes belong to the customer and mean nothing outside its list. The working tool is a code map per customer: the code, its family, the backup it needs, and who owns it inside the company (logistics for shortages, sales for promotions, the EDI team for ASN fines). A code not on the map stops the line until someone adds it. Deductions with no code or a generic one ("MISC", "other") go to research first: ask for the claim detail at once, because nothing in the agreements read here pauses the window while you wait.

The same map belongs in the ERP. In Dynamics 365 Supply Chain Management every deduction needs a reason with a claim basis, price based (a credit on approval) or quantity based (a return order) (Microsoft Learn, deduction workbench): the split between pricing or promotion and shortage. In SAP S/4HANA, the accounts receivable reason code on a residual item can be linked to a dispute case reason, and SAP suggests "Unknown" as the default where the person posting the payment does not know it (SAP Dispute Management configuration guide, 1.5).

The dispute window decides the order of work

Every customer sets its own clock, starting from its own event. The two published grocery documents read for this guide differ by a factor of six.

Dispute windows and related clocks in two published supplier agreements, read October 30, 2026. Compiled by Mirage Metrics, November 2026.
ClauseWhat the clock coversLengthCounts from
KeHE, 4.4Disputing a payment deduction ("Request for Repayment" in KSolve)180 daysKeHE's deduction from your invoice; after that the objection is waived
KeHE, 6.6Answering an Unloading Discrepancy Report (overage, date code, damage and the like)48 hoursThe notification
KeHE, 4.9Audit of your transactions; notice before a third-party auditor's claim is deducted2 years (longer if a retailer requires it); 30 days' noticeNot named for the audit; the notice comes before the deduction
Sprouts, 6.1Disputes or corrections, after which the invoice is "fully paid and closed"30 daysNot named in the clause: confirm it with your buyer
Sprouts, 6.1Issuing the invoice; an invoice received late may be discounted or not paid10 days; 90 daysDelivery; not named for the 90 days
Dispute windows and related clocks in two published supplier agreements, read October 30, 2026. Compiled by Mirage Metrics, November 2026.

Three consequences. First, compute a deadline for each deduction, not for each remittance: one check can carry deductions taken on different dates. Second, work the queue by days left, then by amount. Third, find the clock that comes before the window. Under KeHE's policies the supplier agrees to rely on the case count at KeHE's distribution center and that the Unloading Discrepancy Report "shall govern", with 48 hours to answer it; KeHE does not repay a shortage deduction that such a report supports (KeHE, 6.6 and 6.7). For a shortage, the 48 hours after the report are worth more than the 180 days after the deduction.

From the remittance to a closed deduction

Deduction lifecycle: a remittance line is captured and coded, matched to the invoice, its backup pulled, then a person decides: valid deductions are posted, invalid ones disputed, unclear ones sent back for detail; a dispute ends repaid or denied, all inside the dispute window that starts at the deductionRemittance adviceEDI 820, portal export, PDF or emailCapture and code every lineamount, invoice, code to familyMatch it to the invoiceorder, shipment, promotionPull the backup its family needsPOD, receiving count, PO, deal, ASN logDecidea person: valid, invalid or unclearValid: post itaccrual or expenseInvalid: dispute itwith the backup, in timeUnclear: askfor the claim detaildetail receivedRepaidcredit clearedDeniedwrite off or escalatedeductionthe dispute window runsdeadline
Every line reaches a status, so the remittance balances. The window runs from the deduction (or the date the agreement names) whatever step the line is at; a request for detail does not stop it.

The backup, family by family

Shortages: whose count governs

The bill of lading is signed at origin. The GS1 US standard form records which party loaded the trailer and which party counted the freight, and whether the driver counted pieces or pallets; the carrier's signature says it received the product as listed (GS1 US Bill of Lading Guideline, 9.17 and 9.18). A bill marked shipper load and count, or counted by the pallet, shows what you say you loaded. It does not show what the dock counted.

Customers say which count they pay on. KeHE relies on its distribution center's case count, not on documents its drivers signed at origin, and deducts any shortage at the PO price (KeHE, 6.6 and 6.7). To dispute a deduction, it asks for the KeHE PO number and "the bill of lading or other proof of delivery signed by a KeHE employee" (4.4): the receiver's signature, not yours. Shopbop pays only for units received and accepted, and charges $25 a carton plus a $100 fee when receipt quantities do not match the bill of lading or packing slip (Shopbop, 2.3 and 10).

A shortage is disputable when the receiver signed for the full quantity with no exception and no discrepancy report covers that PO. File the signed delivery copy, the ASN and the pick record together for every shipment, before any deduction; see proof of delivery processing.

Pricing: the PO price, the invoice price, the date

A pricing deduction is usually a difference between the PO and the invoice. KeHE pays the lower of its PO net price and the supplier's invoice amount (KeHE, 5.3), wants cost changes 90 days before its published effective date (4.7), asks for a PO Opportunity Form to correct a PO's price before it is filled (5.2) and charges back price protection on its inventory when your price goes down (4.8). Sprouts pays at the received quantities and the purchase order costs and rejects an invoice whose quantities or costs vary from them (Sprouts, 6.1). Check the price in force on the PO date: if the PO was right, the deduction is valid; if it carried an old price after an accepted change, the dispute needs the notice and its acceptance.

Trade promotions: check against the deal

The deduction has to match the funding method agreed. In KeHE's policies: off-invoice allowances on every PO written during the buy dates, plus a deduction of the extra discount when KeHE sells more during the promotion than it bought (KeHE, 7.3); manufacturer charge backs computed on KeHE's outbound case shipments during the funding period, charged every two weeks, with the backup in the supplier portal (7.4); scans, ads, demos and slotting processed for the retailer and passed through with an administrative fee (7.5); and turnover orders charged back at KeHE's wholesale price unless the supplier provides backup of a different arrangement (7.6). Microsoft's trade allowance management names the same three event types, bill back, lump sum and off-invoice, and settles the customer's short-pay against the approved claim (Microsoft Learn, trade allowance management).

Four checks, in order: an agreement exists for the event; items, dates and rate match; the quantity basis matches (purchases, shipments or scans); and it was not paid another way: taken off-invoice and billed back, deducted on two remittances, or paid by check too.

Compliance fines: the rule, the schedule, your timestamps

Fines come from a routing guide or vendor manual with a fee schedule. Shopbop's published schedule of minimum chargebacks is a clear example: $300 a shipment for a late shipment, $250 a shipment for an ASN not delivered before the shipment reaches the fulfillment center, $2.60 a unit for carton contents that do not match the ASN, and $20 a unit plus a $100 fee for a mis-ship, shortage or overage against the PO (Shopbop, 10). KeHE charges fill rate and on-time fees set in its terms and routing guide (KeHE, 6.5), and leaves lumping and non-compliance fees at its docks to the carrier on supplier-delivered freight, with the supplier responsible for any disputed fee (6.3).

A fine for a rule you broke is valid. Dispute the ones your own timestamps contradict: an 856 sent before arrival, with the 997 functional acknowledgment the customer's system returned for it; an appointment kept; a fee above the schedule. The ASN rules themselves are in the guide to EDI 850, 855, 856 and 810.

Returns, spoils and post-audit claims

Spoils are charged in one of two ways at KeHE: the amount credited to the retailer plus a fee per unit, or a fixed spoils allowance built into the price to the retailer in place of individual charges (KeHE, 9.2). Check that nothing is charged both ways. Post-audit claims can reach back further than the dispute window: KeHE may audit two years of transactions, longer if a retailer requires it, gives 30 days' notice before deducting a claim found by a third-party auditor, and asks suppliers to keep full accounts for at least two years (KeHE, 4.9). Ask for the claim detail, check the period and look for the credit already given.

What software can match, and what a person decides

Before the decision, the work is reading and finding; the decision itself is judgement about the deal and the customer.

What software can do and what a person decides, step by step (recommended practice). Compiled by Mirage Metrics, November 2026.
StepSoftware canA person decides
CaptureRead every line of the 820, portal export, PDF or email, and total it to the paymentNothing, unless the remittance cannot be tied to a payment
CodeApply the code map and flag every code that is not on itWhich family a new code belongs to, and who owns it inside the company
MatchFind the invoice, PO, shipment, ASN and promotion from the references and amountsWhich invoice, when references are missing and several amounts fit
BackupFetch the proof of delivery, receiving report, price file, deal sheet and EDI log, and list what is missingWhat to ask the carrier, the customer or your sales team for
ProposeValid or invalid, with the document that says so; duplicates; fees above the schedule or the agreementValid or invalid on promotions, on terms agreed outside the systems, and on goodwill
PrioritizeDays left on every line, then amountWhether a small invalid amount is disputed or written off
DisputePrepare the packet in the customer's format; file it where the portal accepts itThe wording, and whether to escalate to the buyer
PostMatch the repayment or the denial to the deduction and propose the entryThe write-off, and the fix upstream
What software can do and what a person decides, step by step (recommended practice). Compiled by Mirage Metrics, November 2026.

Your ERP is where the decision is recorded. Dynamics 365's deduction workbench matches a deduction to an open credit, splits it, denies it or writes it off, and a periodic task settles approved deductions whose Deduction ID and amount match a credit (Microsoft Learn). SAP creates a dispute case for the residual item of an underpayment when the incoming payment is posted, and can write off small or uncollectible disputed amounts automatically (SAP Dispute Management configuration guide, 1.1 and 1.5.2.2). A reading and matching layer feeds those records; the write-off threshold stays a decision someone signs.

One worked queue: seven deductions, two remittances

Illustrative example, invented figures: a supplier's open deductions from one distributor

Assumptions, all invented. Distributor A's agreement gives 90 days from the deduction to dispute it. The count is taken on October 30, 2026, and the team flags anything with fewer than 14 days left. Two remittances, dated August 10 and September 14, 2026, carry seven deductions.

Seven invented deductions, coded, matched and decided
DeductionTakenFamilyAmount, $Your recordsDecisionDays left
D-4471Aug 10Trade promotion1,800.00Deal sheet: $1.50 a case, buy dates August 1 to 31; 1,200 cases shipped in the windowValidclosed
D-4472Aug 10Compliance fine250.00"ASN not received": the 856 left on August 20 at 09:12, its 997 came back at 09:14, the truck arrived August 21Dispute9
D-4473Aug 10Shortage257.60Discrepancy report: 14 cases short at $18.40; the BOL says shipper load and countValidclosed
D-5108Sep 14Trade promotion1,800.00Same event and invoice period as D-4471, already deductedDuplicate44
D-5109Sep 14Shortage132.006 cases at $22.00; the dock signed for the full load with no exception; no discrepancy report; signed copy requested from the carrierDispute, backup missing44
D-5110Sep 14Pricing84.00240 cases at $0.35: invoiced at $22.35, PO at $22.00, the increase took effect after the PO dateValidclosed
D-5111Sep 14Unknown ("MISC")46.80No reason textResearching44
Seven invented deductions, coded, matched and decided

The seven come to $4,370.40: $2,141.60 valid, $2,182.00 to dispute, $46.80 unexplained. The August deductions expire on November 8, the September ones on December 13. D-4472 goes first, the smallest dispute but 9 days left. D-5109 is next: the carrier's signed copy decides it and is not in hand. D-5108 is the largest and the easiest, the earlier deduction of the same event is on file. D-5111 gets its detail requested today. Open: $250.00 at 61 to 90 days, $1,978.80 at 31 to 60.

Next for this team: D-4473 points at picking, D-5110 at a price change invoiced too early. Those fixes remove next month's deductions.

One row per deduction, a window per customer, a code map: the log computes family, deadline, age, days left, age bucket, open amount and a flag (past window, backup missing, due soon), and a summary by family, age and flag. Every amount is empty.

How to measure deduction management

Measure the queue, not only the money back.

Deduction measures and their traps (recommended practice). Compiled by Mirage Metrics, November 2026.
MeasureDefinitionTrap
Open amount by ageOpen deductions summed by days since the deduction: 0 to 30, 31 to 60, 61 to 90, over 90Ageing by remittance or invoice date when the window counts from the deduction
Days leftThe deadline of each open line minus todayOne window for every customer, or one date per remittance
Disputed inside the windowDisputes filed before their deadline, divided by all disputes filedLeaving out the ones that expired before anyone filed
Repaid shareAmount repaid divided by amount disputed, once customers have had time to answerDividing by all deductions, or reading it in the first month
Write-offsAmount written off, by family and reasonOne "other" line that hides the reason
Valid deductions by causeAccepted amount by root cause: picking, price file, ASN timing, promotion setupTreating a valid deduction as finished work
Deduction measures and their traps (recommended practice). Compiled by Mirage Metrics, November 2026.

The cheapest deduction is the one that never happens, and the agreements say where to act: answer every discrepancy report inside its 48 hours, correct a PO before it ships, send cost changes 90 days ahead, submit promotions through the customer's own channel before its deadlines (KeHE, 5.2, 4.7, 6.6 and 7.2), and send invoices within the days the customer allows (Sprouts, 6.1).

When not to automate deduction management

  • A handful of deductions a month. If they are read and settled the week they arrive, there is little to remove.
  • The backup does not exist. No signed delivery copies, no ASN logs, deals agreed by phone. Capture first.
  • Nearly all of them are valid promotions your ERP already settles. If claims and short-pays already meet on the deduction workbench, the remaining work is small.
  • The cause is upstream. Picking errors, a late price file: fix those first.
  • The portal is the only record and its terms rule out automated access. Then a person works the portal, and software can only prepare the packet.

The opposite case is many customers, many codes, backup spread across the ERP, the carrier and the sales team, and windows that expire before anyone gets to them. That is what Mirage's deduction and chargeback management is built for.

Questions readers ask

  • Resolving the amounts customers subtract from their payments: reading each deduction from the remittance advice, coding it to its family, matching it to the invoice, checking the backup its family needs, posting the valid ones and disputing the invalid ones before the customer's window closes.

  • As long as your agreement with that customer says, and windows differ. KeHE's published policies give 180 days from the deduction, after which the objection is waived; Sprouts' vendor agreement gives 30 days for disputes or corrections. Compute a deadline for each deduction, and remember the clock keeps running while you wait for backup.

  • The proof of delivery signed by the receiver at destination, with no exception noted, and proof that no discrepancy report covers that PO; your ASN and pick record support it. A bill of lading signed at origin shows what was loaded, and some agreements say outright that the receiving count governs: KeHE relies on its distribution center count and its Unloading Discrepancy Report.

  • The words overlap. A deduction is an amount withheld from a payment; a chargeback is usually an amount the customer bills you, such as a fine or a promotion claim, often collected by deduction anyway. The family decides how you handle it, not the word.

  • It can propose a decision when a document settles it: a signed proof of delivery, a PO price, an ASN timestamp, a promotion already deducted once. A person decides on promotions agreed outside the systems, on write-offs and on anything that touches the customer relationship. Microsoft's and SAP's deduction tools record those decisions; they do not make them.

Sources and scope

Checked on . Supplier agreement clauses are quoted from the versions their publishers post openly; most large retailers keep their deduction codes and windows inside their supplier portals, and the agreement you signed governs. Standards and ERP features are cited from their own documentation. The six families, the code map, the decision split and the measures are recommended practice, presented as such. The worked queue is invented. Biodéal and Transwin facts are quoted from their case studies and describe those deployments only.

Dispute windows, audit periods and repayment rules are contractual. Read them in your own agreement with each customer before relying on any date on this page.

Related on this site

See which of your deductions your own records contradict

Send us a few remittance advices with deductions you have not had time to check. Mirage returns each one coded, matched to its invoice and to the backup its family needs, with the ones your records contradict marked for dispute, so you can set it against your own review.

We use your email to reply to you and, now and then, to tell you about Mirage. You can opt out at any time. Privacy policy