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.
| Family | What the customer is saying | Backup that settles it | Valid when | Disputable 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 record | The receiving count shows the shortage and the agreement makes that count govern | Signed 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 acceptance | The PO price was the price in force: a change invoiced before it took effect | The 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 performance | Agreed event; items, dates, rate and quantity match; not paid another way | No 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, arrival | Your own records show the rule was broken and the fee is the scheduled one | Your 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 report | It follows the agreed program and the units are yours | Charged 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 period | Inside the agreed audit period and supported line by line | Outside the period, already credited, or sent without detail |
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.
| Clause | What the clock covers | Length | Counts from |
|---|---|---|---|
| KeHE, 4.4 | Disputing a payment deduction ("Request for Repayment" in KSolve) | 180 days | KeHE's deduction from your invoice; after that the objection is waived |
| KeHE, 6.6 | Answering an Unloading Discrepancy Report (overage, date code, damage and the like) | 48 hours | The notification |
| KeHE, 4.9 | Audit of your transactions; notice before a third-party auditor's claim is deducted | 2 years (longer if a retailer requires it); 30 days' notice | Not named for the audit; the notice comes before the deduction |
| Sprouts, 6.1 | Disputes or corrections, after which the invoice is "fully paid and closed" | 30 days | Not named in the clause: confirm it with your buyer |
| Sprouts, 6.1 | Issuing the invoice; an invoice received late may be discounted or not paid | 10 days; 90 days | Delivery; not named for the 90 days |
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
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.
| Step | Software can | A person decides |
|---|---|---|
| Capture | Read every line of the 820, portal export, PDF or email, and total it to the payment | Nothing, unless the remittance cannot be tied to a payment |
| Code | Apply the code map and flag every code that is not on it | Which family a new code belongs to, and who owns it inside the company |
| Match | Find the invoice, PO, shipment, ASN and promotion from the references and amounts | Which invoice, when references are missing and several amounts fit |
| Backup | Fetch the proof of delivery, receiving report, price file, deal sheet and EDI log, and list what is missing | What to ask the carrier, the customer or your sales team for |
| Propose | Valid or invalid, with the document that says so; duplicates; fees above the schedule or the agreement | Valid or invalid on promotions, on terms agreed outside the systems, and on goodwill |
| Prioritize | Days left on every line, then amount | Whether a small invalid amount is disputed or written off |
| Dispute | Prepare the packet in the customer's format; file it where the portal accepts it | The wording, and whether to escalate to the buyer |
| Post | Match the repayment or the denial to the deduction and propose the entry | The write-off, and the fix upstream |
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.
| Deduction | Taken | Family | Amount, $ | Your records | Decision | Days left |
|---|---|---|---|---|---|---|
| D-4471 | Aug 10 | Trade promotion | 1,800.00 | Deal sheet: $1.50 a case, buy dates August 1 to 31; 1,200 cases shipped in the window | Valid | closed |
| D-4472 | Aug 10 | Compliance fine | 250.00 | "ASN not received": the 856 left on August 20 at 09:12, its 997 came back at 09:14, the truck arrived August 21 | Dispute | 9 |
| D-4473 | Aug 10 | Shortage | 257.60 | Discrepancy report: 14 cases short at $18.40; the BOL says shipper load and count | Valid | closed |
| D-5108 | Sep 14 | Trade promotion | 1,800.00 | Same event and invoice period as D-4471, already deducted | Duplicate | 44 |
| D-5109 | Sep 14 | Shortage | 132.00 | 6 cases at $22.00; the dock signed for the full load with no exception; no discrepancy report; signed copy requested from the carrier | Dispute, backup missing | 44 |
| D-5110 | Sep 14 | Pricing | 84.00 | 240 cases at $0.35: invoiced at $22.35, PO at $22.00, the increase took effect after the PO date | Valid | closed |
| D-5111 | Sep 14 | Unknown ("MISC") | 46.80 | No reason text | Researching | 44 |
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.
| Measure | Definition | Trap |
|---|---|---|
| Open amount by age | Open deductions summed by days since the deduction: 0 to 30, 31 to 60, 61 to 90, over 90 | Ageing by remittance or invoice date when the window counts from the deduction |
| Days left | The deadline of each open line minus today | One window for every customer, or one date per remittance |
| Disputed inside the window | Disputes filed before their deadline, divided by all disputes filed | Leaving out the ones that expired before anyone filed |
| Repaid share | Amount repaid divided by amount disputed, once customers have had time to answer | Dividing by all deductions, or reading it in the first month |
| Write-offs | Amount written off, by family and reason | One "other" line that hides the reason |
| Valid deductions by cause | Accepted amount by root cause: picking, price file, ASN timing, promotion setup | Treating a valid deduction as finished work |
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.
- KeHE Distributors, Supplier Policies & Procedures, effective November 1, 2025 (PDF): 4.3 offset of amounts due; 4.4 disputes of payment deductions within 180 days of the deduction in KSolve, with the PO number and the bill of lading or other proof of delivery signed by a KeHE employee, repaid on a retailer's deduction only when the retailer repays; 4.7 price changes 90 days ahead; 4.8 price protection; 4.9 audits of two years and 30 days' notice for third-party auditor claims; 5.2 PO Opportunity Form; 5.3 payment at the lower of the PO net price or the invoice; 6.3 lumping and non-compliance fees; 6.5 fill rate fees; 6.6 and 6.7 the DC case count and the Unloading Discrepancy Report govern, 48 hours to respond, documents signed at origin not relied on; 7.2 to 7.6 promotional allowances, off-invoice, manufacturer charge backs, extra performance, turnover orders; 8 retailer expenses passed through; 9.2 spoils
- SFM, LLC (Sprouts Farmers Market), Product Vendors Indemnification Agreement, rev. September 1, 2023 (PDF): 6.1: invoices issued no later than ten days after delivery; invoices not received within 90 days may be discounted or not paid; payment at received quantities and purchase order costs; disputes or corrections within 30 days, otherwise the invoice is considered fully paid and closed
- Bop LLC (Shopbop), Vendor Operations Manual, July 2026 (PDF): 2.2 chargebacks for any deviation from the manual; 2.3 payment only for units received and accepted; 10 violation types and minimum chargeback amounts
- GS1 US, Apparel and General Merchandise Bill of Lading Guideline, Release 5.0, September 2025 (PDF): 8.1 mandatory information, including the trailer loaded and counted indicator; 9.17 which party loaded the trailer and counted the freight, and whether the driver counted pieces or pallets; 9.18 the carrier's signature
- X12, Transaction Sets: 820 Payment Order/Remittance Advice; 812 Credit/Debit Adjustment, to notify a trading partner of an adjustment or billback; 997 Functional Acknowledgment
- Microsoft Learn, Trade allowance management, Supply Chain Management (January 7, 2025): bill back, lump sum and off-invoice merchandising events; approved claims passed to accounts receivable as deductions; the customer's short-pay registered as a deduction and settled against the claim on the deduction workbench
- Microsoft Learn, Manage deductions using the deduction workbench, Supply Chain Management (July 21, 2025): match deductions to open credit transactions, split, deny, write off; a reason required for each deduction, with a price-based or quantity-based claim basis; the customer's external claim number; a periodic task that settles approved deductions with matching Deduction ID and amount
- SAP, Configuration Guide for SAP Dispute Management for FI-AR, SAP S/4HANA 2022 (version July 2024) (PDF): 1.1 a dispute case created for the residual item of an underpayment when the incoming payment is posted; 1.5 accounts receivable reason codes linked to dispute case reasons, Unknown as the default; 1.5.2.2 automatic write-off of uncollectible or small disputed amounts
- Mirage Metrics, Biodéal case study: an organic dairy distributor supplying retail chains; email orders read and created in SAP Business One since July 22, 2025: 2,943 orders, 12,993 lines, 113 customers, about 7% flagged for a human check
- Mirage Metrics, Transwin case study: a Moroccan logistics operator; transport documents read and keyed into its TMS, then invoicing and financial documents; 70% less manual data entry on freight documents
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
- Proof of delivery processing: reading the delivery documents a shortage dispute rests on
- EDI 850, 855, 856 and 810: the ASN rules behind most compliance fines
- How to automate order entry: the order record every deduction is checked against
- Sales order exception handling before ERP entry: pricing and unit errors caught before they become deductions
- Glossary: proof of delivery: and bill of lading, EDI, purchase order
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.