UNFI deduction codes, decoded — a broker’s cheat sheet.

Every food broker agency working with UNFI has felt this pain. A remittance PDF lands in the inbox. Line after line of alphanumeric codes — MCB, CBPB, OIA, PP, PB — each shaving dollars off what your principal was supposed to get paid. And you, the broker, are the one who has to explain the math to a manufacturer who just wants to know why their check is short.

Most existing content on UNFI deductions treats brands as the audience. That’s a gap. Brokers sit between the brand and the distributor, and the reconciliation problem hits differently when your commission is calculated off net sales that just got rewritten by codes nobody explained to you.

This guide is written for broker agencies. It covers the codes that actually matter, how to categorize them, when they’re disputable, and how to build a reconciliation workflow that scales past spreadsheets.

Why UNFI deductions are different for broker agencies

A CPG brand sees a deduction as revenue leakage. A broker agency sees it as three separate problems stacked on top of each other.

• The deduction changes your commission base. If your principal contract says commission is paid on net sales after trade allowances, then every valid MCB reduces your commission. If it says gross, then invalid deductions being paid create a reconciliation dispute with your principal — not with UNFI.
• You do the dispute work even though the money isn’t yours. The broker usually has the UNFI relationship depth, so when a deduction lands, the brand calls you first, not UNFI.
• The math compounds across principals. A brand might see 40 UNFI deductions a month. A ten-person broker agency might see 800 across the roster. That volume overwhelms Excel fast.

Everything downstream in this article assumes those three realities.

How UNFI categorizes deductions: Natural vs Conventional

UNFI operates two distinct supplier divisions, and the deduction handling is different for each. This matters because your workflow, your dispute portal, and your codes all change depending on which division your principal is registered under.

• Natural suppliers work with UNFI’s core natural and organic customer base — Whole Foods, Sprouts, independent health food stores. Disputes go through an Excel form (UNFI Natural Supplier Dispute Form 01012024.xlsb) submitted to deductions@unfi.com.
• Conventional suppliers work with mainstream grocery — Cub Foods, Shoppers, regional chains. Disputes go through the ePASS portal.

A supplier can technically operate in both divisions, but the codes, submission workflows, and even response times are separated. A broker agency handling both divisions for the same principal needs to track them as separate accounts in their reconciliation system.

Practical implication: if you’re building or evaluating any tool for UNFI reconciliation, ask whether it treats Natural and Conventional as separate entities or lumps them together. Lumping is the default mistake.

The anatomy of a remittance: PP, PB, and the suffixes

Before decoding individual codes, you need to read the invoice numbers themselves. UNFI appends single-letter and two-letter suffixes to invoice numbers to signal transaction type.

• PP (Prepayment). UNFI occasionally prepays invoices — you’ll see the invoice number with PP appended. On a subsequent check, or often the same check, UNFI reverses the prepayment. The reversal shows as a negative amount with the same PP suffix. These almost always net to zero.
• PB (Payback). When you win a dispute, UNFI pays back the disputed amount. You identify these by finding the original disputed invoice number with PB appended. This is your reconciliation win column.
• No suffix. Standard invoice payment or deduction.

Most reconciliation errors trace back to a broker or accountant missing that PP transactions net to zero. They see the negative and log it as a deduction. Then the offsetting positive shows up on the next remittance and gets logged as unexplained income. The books look messy for weeks until someone tracks it down.

Cash discounts (2/10 Net 30): the one you can’t dispute

Almost every UNFI remittance shows a cash discount deduction of roughly 2%. This is because UNFI’s standard terms are 2% 10, Net 30 — if UNFI pays within 10 days, they take a 2% discount.

Here’s the reality: UNFI almost always takes the discount, whether they paid in 10 days or 30. The discount is baked into their AP process. It’s part of doing business with them.

For broker commission purposes, the treatment depends on your principal agreement. Some agreements pay commission on gross sales before the cash discount. Others pay on net after. If your contract doesn’t specify, you have a problem — because the 2% cash discount alone can shift commission calculations by hundreds of dollars per remittance cycle across a busy principal.

Not disputable. Ever. Bake it into your pricing model and move on.

MCB — Manufacturer Charge Back: the most common deduction

MCBs are the single most frequent deduction code you’ll see, and the most misunderstood. An MCB is a chargeback where UNFI is passing through a cost or allowance that was pre-agreed with the supplier — typically a promotional allowance, a scan program, a temporary price reduction (TPR), or an off-invoice discount.

Accounting treatment: MCBs are almost always contra revenue. They reduce net sales and directly affect the base for broker commission calculation.

Disputable? Sometimes. An MCB is valid if:

• The promotion was in the approved promotional calendar
• The units sold match the promotional period
• The rate matches the pre-agreed allowance
• Documentation exists in the myUNFI portal

An MCB is disputable if:

• The promotion wasn’t in your principal’s approved calendar
• The units were sold outside the promo window
• The rate applied is higher than what was agreed
• No documentation backs the deduction

To dispute MCBs, brokers need access to backup documentation. UNFI sends MCB backup docs on a weekly cadence — but only to a single designated email address per supplier account. This is an operational constraint worth naming: if the brand designated their AP clerk as the recipient, the broker never sees the MCB backup, and the dispute cycle stalls.

CBPB: when UNFI pays back a won dispute

CBPB is a chargeback payback code — essentially a partial reversal of a previous deduction after a dispute is resolved in the supplier’s favor.

If you filed a dispute 30–45 days ago and don’t remember the outcome, look for a CBPB code with a partial credit. That’s UNFI telling you the dispute won.

For reconciliation, CBPBs need to be linked back to the original disputed invoice. Otherwise, they show up as unexplained credits, which is almost as messy as unexplained debits.

Shortage & damage deductions: documentation is everything

If UNFI’s receiving DC counts 95 cases on a 100-case invoice, they deduct the cost of the missing 5 cases. This shows up as a shortage code with a per-unit deduction tied to the original invoice.

Shortages are highly disputable but only with documentation. You need:

• Proof of delivery (POD) from the freight carrier
• Bill of lading (BOL) signed at pickup
• Any receiving photos or dock notes

The broker agency’s role here is often to intermediate between the principal’s warehouse/3PL and UNFI’s receiving team. If your principal ships blind and hopes for the best, you’ll lose most shortage disputes. If your principal has clean POD and BOL for every shipment, most shortages recover.

Practical rule: shortage deductions over $500 almost always deserve a dispute attempt. Below that threshold, the labor cost of documentation retrieval often exceeds the recovery.

Compliance & fill rate: the 95% threshold

UNFI expects a 95% fill rate on all purchase orders across a rolling window. Fall below that, and compliance fees start hitting. Persistent fill rate issues (typically more than two weeks) trigger a corrective action plan request, and continued failure can lead to product delisting.

Compliance-related deduction codes cover:

• Missed appointments (freight arrival outside the scheduled window)
• Late shipments
• Incorrect product ships (wrong SKU, wrong pack)
• Overages (shipping more than ordered)
• Documentation errors (missing or incorrect ASN, invoice format errors)

These deductions are operating expenses, not contra revenue. They don’t reduce net sales — they’re penalty fees for operational failure. This distinction matters for GL treatment: contra revenue reduces the top line, compliance fees hit an expense account below the line.

For broker commission, compliance fees usually don’t change the commission base — unless the principal contract specifies otherwise. But they do affect the principal’s net take-home, which affects the broker-principal relationship. Brokers who help principals reduce compliance fees create demonstrable value.

OIA & promotional allowance codes

OIA (Off-Invoice Allowance) and related promotional codes cover trade spend that UNFI passes through as a deduction rather than requiring separate invoicing.

Typical use cases:

• New item introductory allowances
• Slotting fees for new distribution
• Category program participation fees
• Ad program allowances
• Annual Advertising Agreement (AAA) charges — which range from $1,920 to $42,000 annually depending on program level

These are agreed upon in advance through UNFI’s promotional planning tools in the myUNFI portal. Disputes are rare but do happen when:

• The wrong allowance rate is applied
• An allowance is charged for a program the principal didn’t opt into
• Charges continue after a program was cancelled

For brokers, OIAs are typically visible in principal contracts and promotional calendars. If they aren’t documented in your principal’s records, that’s a red flag for the reconciliation workflow — someone said yes to something and forgot to write it down.

How to read the Supplier Deduction Key

UNFI maintains an official Supplier Deduction Key inside the myUNFI supplier portal. It contains hundreds of codes with definitions. Most brokers never see it because their principals don’t share portal access.

If you’re representing a principal and don’t have myUNFI access, request read-only access as part of your broker onboarding. Without it, you’re doing reconciliation with one hand tied behind your back. Every deduction code you don’t recognize costs time, and time compounds across a busy roster.

The Deduction Key is not exhaustive documentation — it’s a reference sheet. Real understanding comes from seeing the same codes appear across multiple principals, developing pattern recognition for what’s normal and what’s anomalous.

The reconciliation workflow: a 4-outcome framework

Reconciling UNFI deductions against principal contracts is fundamentally a matching problem, but a simple match/no-match binary loses too much information. Every deduction line has a state that determines what happens next. At Linecard, the reconciliation engine categorizes every deduction into one of four outcomes:

• Enforce. The deduction matches a valid contract term (approved MCB against the correct promo, valid cash discount, agreed OIA). The system posts it, adjusts the commission base, and moves on.
• Check. The deduction is plausible but requires verification. Rate is close but not exact. Units match but the promo period is a day off. Flagged for human review.
• Flag. The deduction has clear anomalies. Rate is higher than the contract allows. Units are outside the promo window. No documentation exists. This is a dispute candidate.
• Gap. The deduction can’t be matched to any contract term the system knows about. Either the contract is incomplete in our system, or UNFI applied something that shouldn’t exist. Requires principal follow-up.

Filing disputes: ePASS vs the Excel form

Once you’ve identified Flag-category deductions, disputes go through two different channels depending on division.

Conventional (ePASS)

1. Log into ePASS with your supplier credentials
2. Use Document Search to locate the specific deduction by document number
3. If it doesn’t appear, use Create PASS# manually
4. Include the deduction code and a clear explanation
5. Upload backup documentation (5MB limit per attachment)
6. Submit — you’ll get a PASS number to track

Natural (Excel form)

1. Fill out the UNFI Natural Supplier Dispute Form 01012024.xlsb
2. Email to deductions@unfi.com — must be Excel format, not PDF
3. Receive a tracking number within two business days
4. Follow up if no response in 30–45 days

UNFI suggests submitting disputes within 60 days of the original deduction, though sooner responses often get quicker resolutions. Most reviews take 30–45 days.

For broker agencies handling multiple principals, the operational challenge isn’t the submission itself — it’s tracking dispute status across the roster. If every principal has 5–10 open disputes at any time and your agency handles 20 principals, that’s 100–200 open disputes to track. Spreadsheets fail at this scale. Dedicated dispute tracking with automated status pulls becomes necessary somewhere between 3 and 5 principals.

Common mistakes broker agencies make

Patterns that appear across broker agencies moving from Excel to a real system:

• Commission calculated on the wrong base. If your principal contract pays commission on net sales after trade allowances, but your Excel model calculates on gross invoiced amount, you’re overpaying yourself by 5–15% and creating an eventual clawback. Reconcile the base before you reconcile the deductions.
• PP prepayments logged as deductions. They net to zero on the next cycle. If your model doesn’t handle this, your monthly reports look wrong for two weeks and then mysteriously correct themselves.
• MCB backup emails going to the wrong person. UNFI only sends MCB backup docs to one designated address per account. If that address isn’t checked, disputes stall for lack of documentation.
• Treating Natural and Conventional as one account. Different portals, different codes, different response times. Merge them at your reporting level, not your operational level.
• Filing every dispute. Compliance fees under $200 usually aren’t worth the documentation retrieval cost. Focus dispute effort on MCBs, shortages, and OIA anomalies over $500.
• Not linking CBPB paybacks to the original dispute. If a payback arrives 60 days after a dispute was filed and nobody connects them, the payback shows up as unexplained income. Reconciliation systems should chain related invoice numbers automatically.

The modern approach: automating UNFI reconciliation

Manual UNFI reconciliation works for a broker agency with 2–3 principals. It stops working around principal #4 or #5, and it actively costs money by principal #7. The failure modes aren’t dramatic — they’re quiet. A missed CBPB here. A miscategorized MCB there. A shortage dispute never filed because nobody had bandwidth. Each individual miss is small. Across a year, they add up to five figures.

Linecard was built for the shape of this problem. The reconciliation engine ingests UNFI remittance data (whether from PDF, EDI 820, or portal export), matches every line against principal contracts stored in the platform, and produces the four-outcome categorization automatically. Broker AEs and ops staff review the exceptions instead of every line.

The Principal Portal gives your brand principals visibility into what you’re recovering on their behalf — which turns reconciliation from an invisible cost center into demonstrated broker value.

If your agency is spending 4–10 hours per remittance cycle on UNFI, or if you suspect deductions are slipping through unreviewed, that’s the operational signal it’s time to move off spreadsheets.

Quick reference: top UNFI deduction codes

Linecard is a modern commission reconciliation and deduction recovery platform built specifically for food broker agencies. If this was useful, the field-notes newsletter sends one operator guide like it per week.