UNFI EDI Requirements: The Complete 2026 Guide for Food & Beverage Brands

Introduction: The UNFI Opportunity

UNFI (United Natural Foods, Inc.) is the largest distributor of natural, organic, and specialty foods in North America. With distribution to over 30,000 retail locations—including Whole Foods, Sprouts, Natural Grocers, and thousands of independent natural food stores—UNFI is the gateway to the natural products industry.

For emerging food and beverage brands, a UNFI partnership means immediate access to the retail channel that matters most: health-conscious consumers willing to pay premium prices for quality products.

But here’s what many brands discover too late: UNFI’s operational requirements are as demanding as any major retailer.

Unlike selling direct-to-consumer where you control the entire experience, UNFI relationships require precise coordination across ordering, shipping, invoicing, and compliance tracking. The brands that scale successfully with UNFI are those that treat EDI compliance as a core operational capability from day one.

This guide covers everything you need to achieve and maintain UNFI EDI compliance in 2026:

• The complete list of required EDI documents
• Step-by-step setup process from vendor agreement to go-live
• UNFI Supplier Portal navigation and best practices
• GS1 and barcode requirements
• ASN specifications and timing requirements
• Fill rate standards and how to maintain them
• Common errors and how to prevent chargebacks
• Differences between UNFI distributor EDI and retail EDI

UNFI EDI Requirements Overview

What EDI Documents Does UNFI Require?

UNFI uses the ANSI X12 standard for all EDI communication. Here are the primary transaction sets you’ll need to support:

• EDI 850 – Purchase Order: UNFI sends this to order products from you. Contains item details, quantities, requested delivery dates, and ship-to locations (UNFI distribution centers).
• EDI 855 – Purchase Order Acknowledgment: You send this to confirm receipt of the PO and indicate whether you can fulfill it as ordered. Include acceptance status, ship date confirmation, and any quantity adjustments.
• EDI 856 – Advance Ship Notice (ASN): You send this when goods ship. The ASN must include detailed case/pallet information, SSCC-18 codes, carrier details, and expected delivery date. This is UNFI’s most compliance-sensitive document.
• EDI 810 – Invoice: You send this to bill UNFI. Must match the PO and ASN exactly — any discrepancies trigger payment delays or deductions.
• EDI 820 – Payment Order/Remittance Advice: UNFI sends this to communicate payment details, deductions, and remittance information.
• EDI 997 – Functional Acknowledgment: Automated receipt confirmation sent in both directions to verify that EDI documents were received and are syntactically valid.

UNFI EDI Communication Protocols

UNFI supports multiple communication methods for EDI document exchange:

• AS2 (Applicability Statement 2): The preferred method for high-volume suppliers. AS2 provides encrypted, real-time document exchange over the internet.
• VAN (Value Added Network): Traditional EDI routing through a third-party network. If you use a VAN provider, they’ll route documents to UNFI’s VAN mailbox.
• SFTP (Secure File Transfer Protocol): Available for suppliers who need batch file transfer capabilities.

Most modern EDI platforms, including Crstl, support all three methods and can configure the appropriate connection type based on UNFI’s requirements for your specific account.

UNFI EDI Identifier Information

To set up EDI with UNFI, you’ll need the following identifiers:

• UNFI’s ISA Qualifier/ID: Provided during vendor onboarding (typically ZZ qualifier)
• Your ISA Qualifier/ID: Your company’s EDI identifier (your EDI provider will help configure this)
• GS Sender/Receiver IDs: Application-level identifiers for document routing
• DUNS Number: UNFI may require your D-U-N-S number for vendor identification

Your EDI provider should handle the technical configuration of these identifiers as part of the onboarding process.

UNFI EDI Setup Process: Step-by-Step

Phase 1: Vendor Agreement and Account Setup

Before any EDI configuration begins, you need an active vendor relationship with UNFI:

1. Complete the UNFI Vendor Application

Submit your application through the UNFI Supplier Portal or through your UNFI category manager. The application covers company information, product details, insurance requirements, and food safety certifications.

2. Execute the Vendor Agreement

UNFI’s vendor agreement covers pricing, payment terms, promotional programs, and compliance requirements. Pay close attention to the compliance sections — they define the chargeback and deduction structures you’ll be held to.

3. Register on the UNFI Supplier Portal

The Supplier Portal (suppliers.unfi.com) is your central hub for managing your UNFI relationship. You’ll use it for item setup, promotional planning, invoice tracking, and deduction management.

Phase 2: EDI Configuration

4. Select Your EDI Provider

Choose an EDI platform that supports UNFI’s requirements. Key criteria: UNFI-specific document mapping, AS2/VAN/SFTP connectivity, ASN automation with SSCC-18 support, and experience with food & beverage distributor EDI.

5. Establish EDI Connection

Your EDI provider will coordinate with UNFI’s EDI team to establish the technical connection. This includes exchanging ISA/GS identifiers, configuring communication protocols, and setting up document routing.

6. Map EDI Documents

Configure your EDI system to map UNFI’s specific document requirements. Each UNFI distribution center may have slightly different requirements for ship-to addresses, routing guides, and ASN specifications.

Phase 3: Testing and Go-Live

7. Complete EDI Testing

UNFI requires testing of all EDI document types before going live. The testing process typically includes sending test 855s in response to test 850s, generating test ASNs with proper SSCC-18 codes, submitting test invoices for validation, and verifying 997 acknowledgments in both directions.

8. UNFI EDI Certification

Once testing is complete, UNFI’s EDI team certifies your connection. Certification confirms that your documents meet UNFI’s format and content requirements.

9. Go-Live and Monitoring

After certification, you begin processing live orders. Monitor closely during the first 2–4 weeks to catch any issues before they become systemic.

Timeline Expectations

The total UNFI EDI setup process typically takes 2–6 weeks depending on your EDI provider, your internal readiness, and UNFI’s testing queue. With a modern, AI-powered platform like Crstl, the technical setup can be completed in as little as 1–2 weeks because UNFI’s document maps are pre-built and the connection configuration is automated.

Legacy EDI providers often require 6–12 weeks due to manual mapping, manual testing, and sequential (rather than parallel) onboarding workflows.

UNFI Supplier Portal and Systems

Navigating the UNFI Supplier Portal

The UNFI Supplier Portal (suppliers.unfi.com) is your primary interface for managing your UNFI business outside of EDI transactions. Key functions include:

Item Management: Set up new items, manage UPCs, update product information, and maintain item status across UNFI’s distribution network.

Promotional Planning: Submit and manage promotional programs, TPRs (Temporary Price Reductions), MCBs (Manufacturer Charge Backs), and other trade spend activities.

Invoice and Payment Tracking: View invoice status, payment history, and upcoming payment schedules. Cross-reference with your EDI 820 remittance data for reconciliation.

Deduction Management: Review and dispute deductions. The portal shows deduction reason codes, supporting documentation, and the dispute submission process.

Reporting: Access sales reports, fill rate scorecards, and distribution analytics to track your UNFI business performance.

UNFI Systems Integration

Beyond EDI, UNFI uses several systems that touch your operations:

UNFI Connect: UNFI’s newer platform for supplier collaboration, designed to streamline item setup and promotional workflows.

UNFI Insights: Analytics platform providing sell-through data, market trends, and category performance. Available to qualifying suppliers.

Your EDI integration should complement these portal-based workflows. For example, while EDI handles the transactional flow (POs, ASNs, invoices), the Supplier Portal handles the strategic activities (promotions, item setup, deduction disputes).

GS1 and Barcode Requirements for UNFI

Required Barcode Standards

UNFI requires GS1-standard barcodes on all products and shipping containers:

Product Level (Each/Inner Pack):

• UPC-A (12-digit) for retail-scannable products
• Must be registered with GS1 US
• Each unique product/size/flavor needs its own UPC

Case Level:

• ITF-14 (14-digit) barcode on each shipping case
• Must be different from the individual product UPC
• Used for warehouse scanning at UNFI DCs

Pallet/Container Level:

• GS1-128 labels with SSCC-18 (Serial Shipping Container Code)
• Required on all pallets and shipping containers
• Must match the ASN (EDI 856) data exactly
• Includes: SSCC-18, ship-to location, PO number, item details

GS1-128 Label Requirements for UNFI

The GS1-128 shipping label is critical for UNFI receiving. Each label must include:

• SSCC-18: Unique 18-digit serial shipping container code
• Ship To: UNFI DC name and address
• Ship From: Your company name and address
• PO Number: The UNFI purchase order number
• Item Details: UPC, description, quantity per case
• Carrier Information: Carrier name, PRO number, BOL number

Modern EDI platforms like Crstl generate GS1-128 labels automatically from your ASN data, ensuring that labels always match the electronic ASN sent to UNFI. This eliminates the most common source of receiving discrepancies.

GS1 Registration

If you don’t already have a GS1 Company Prefix, you’ll need to register with GS1 US (gs1us.org). Pricing is based on annual revenue. The registration process takes 1–3 business days. You need the prefix before you can create UPCs, ITF-14s, or SSCC-18s.

UNFI ASN Requirements (EDI 856)

The Advance Ship Notice is UNFI’s most compliance-sensitive EDI document. Getting ASNs right is critical to avoiding receiving delays and deductions.

ASN Timing

UNFI requires ASNs to be transmitted before the shipment arrives at the distribution center. Best practice is to send the ASN within 30 minutes of carrier pickup. Late ASNs — those received after the shipment arrives — can result in receiving delays, manual processing charges, and deductions.

ASN Content Requirements

Every UNFI ASN must include:

• Shipment Level: Carrier name, carrier SCAC code, PRO number, bill of lading number, ship date, expected delivery date, ship-from address, ship-to UNFI DC address
• Order Level: UNFI PO number, PO date
• Pack Level: SSCC-18 for each pallet/container, pack configuration (cases per pallet)
• Item Level: UPC, vendor item number, UNFI item number, quantity shipped (cases), weight

Common ASN Errors with UNFI

• SSCC-18 Mismatch: The SSCC-18 on the physical GS1-128 label doesn’t match the SSCC-18 in the electronic ASN. This is the #1 ASN error.
• Missing or Incorrect PO Reference: The ASN references a PO number that UNFI doesn’t recognize or that has already been closed.
• Quantity Discrepancies: Cases shipped don’t match cases listed in the ASN.
• Late Transmission: ASN arrives after the physical shipment, defeating the purpose of advance notification.
• Incorrect Ship-To: ASN lists a different UNFI DC than where the shipment is actually going.

AI-powered EDI platforms catch most of these errors before transmission. Crstl’s Edison AI agent, for example, validates every ASN against the original PO data and flags discrepancies before the document is sent to UNFI.

UNFI Fill Rate and Compliance Standards

Understanding UNFI Fill Rates

Fill rate is the single most important operational metric in your UNFI relationship. It measures the percentage of ordered cases that you actually ship.

Fill Rate = Cases Shipped ÷ Cases Ordered × 100

UNFI expects suppliers to maintain fill rates of 95% or higher. Some categories and high-priority items may have even stricter targets.

Fill Rate Thresholds and Consequences

• 95%+ Fill Rate: Good standing. Eligible for promotional opportunities and preferred placement.
• 90–95% Fill Rate: Warning zone. May receive supplier scorecard flags and category manager attention.
• Below 90% Fill Rate: Risk zone. May result in reduced order volume, loss of promotional opportunities, potential item deauthorization for chronic underperformance.

How UNFI Calculates Fill Rate

UNFI calculates fill rate based on cases shipped vs. cases ordered at the item level, aggregated across a measurement period (typically monthly or quarterly). Key nuances include: partial shipments count proportionally (ship 80 of 100 cases = 80% for that line), out-of-stock items that you report via EDI 855 still count against fill rate, and fill rate is tracked by UNFI DC so your performance may vary by region.

Improving Your UNFI Fill Rate

• Demand Planning: Use UNFI sales data (available through the Supplier Portal) to forecast demand by DC.
• Safety Stock: Maintain buffer inventory specifically allocated for UNFI orders.
• EDI 855 Communication: If you know you can’t fill an order completely, send the 855 PO Acknowledgment with adjusted quantities immediately. Proactive communication matters.
• Production Scheduling: Align production runs with UNFI order patterns (typically weekly replenishment cycles).

Common UNFI EDI Errors and Chargebacks

UNFI Deduction Categories

UNFI uses a deduction system (rather than the chargeback terminology used by retailers like Walmart or Target). Common deduction categories include:

Shipping and Receiving Deductions:

• Short shipments (cases ordered vs. cases received)
• Overage shipments (sent more than ordered)
• Damaged goods
• Incorrect items shipped
• Missing or incorrect GS1-128 labels
• ASN discrepancies

Pricing Deductions:

• Invoice price doesn’t match agreed vendor cost
• Promotional pricing not applied correctly
• Bracket pricing errors

Compliance Deductions:

• Late shipments
• Early shipments (outside delivery window)
• EDI document errors (rejected 856s, incorrect 810s)
• Missing required documentation

How to Prevent UNFI Deductions

• Validate Before Sending: Use an EDI platform with pre-transmission validation that checks every document against UNFI’s requirements before sending.
• Match Everything: Ensure PO → 855 → 856 → 810 data consistency. The PO number, quantities, items, and prices must match across all documents.
• Ship On Time: Respect UNFI’s delivery windows. Not early, not late.
• Label Accurately: GS1-128 labels must match ASN data exactly.
• Monitor Your Scorecard: Check the UNFI Supplier Portal regularly for deduction notices and scorecard updates. Address issues immediately.

Disputing UNFI Deductions

If you believe a deduction is incorrect, file a dispute through the UNFI Supplier Portal. Include: the deduction reference number, proof of delivery (BOL, carrier confirmation), ASN data showing correct shipment, photos of labels and product condition (if relevant). UNFI has specific time windows for disputes — typically 30–60 days from the deduction date. Don’t miss the deadline. For more on preventing EDI chargebacks and deductions across retailers, see our dedicated guide.

UNFI vs Retail EDI: Key Differences

Understanding the differences between distributor EDI (like UNFI) and retailer EDI (like Walmart or Target) helps you manage both relationships effectively.

UNFI (Distributor) Model: UNFI is your customer — they buy from you and sell to thousands of retailers. Your products go to UNFI DCs, then to stores. You deal with one set of EDI requirements (UNFI’s), fill rate expectations are typically 95%+, and order patterns tend to be regular replenishment cycles.

Retail (Direct) Model: The retailer is your customer. Products ship to individual stores or retailer DCs. Each retailer has unique EDI requirements and compliance programs. ASN timing windows vary by retailer (Walmart requires ASN within 30 minutes of shipment), and chargeback structures differ significantly.

Key operational difference: UNFI requires item-level UPC validation on every EDI document. Most retailers validate at the PO level. UNFI’s fill rate standards are also typically stricter than individual retailers, and deduction resolution follows a different process than retail chargebacks.

UNFI EDI Compliance Checklist

Use this checklist to ensure your UNFI EDI setup is complete and compliant:

Pre-Setup:

• ☐ UNFI vendor agreement executed
• ☐ Supplier Portal account created and active
• ☐ GS1 Company Prefix registered with GS1 US
• ☐ UPCs assigned to all products
• ☐ ITF-14 case codes created
• ☐ EDI provider selected and onboarded

EDI Configuration:

• ☐ ISA/GS identifiers exchanged with UNFI
• ☐ Communication protocol established (AS2/VAN/SFTP)
• ☐ EDI 850 inbound mapping configured
• ☐ EDI 855 outbound mapping configured
• ☐ EDI 856 outbound mapping configured with SSCC-18 support
• ☐ EDI 810 outbound mapping configured
• ☐ EDI 820 inbound mapping configured
• ☐ EDI 997 bidirectional acknowledgments enabled

Testing:

• ☐ Test 855 sent and validated by UNFI
• ☐ Test 856 sent with proper SSCC-18 codes and validated
• ☐ Test 810 sent and validated
• ☐ 997 acknowledgments flowing in both directions
• ☐ GS1-128 label format approved by UNFI
• ☐ EDI certification received from UNFI

Go-Live:

• ☐ First live PO received and processed
• ☐ First live ASN sent and confirmed received
• ☐ First live invoice sent and accepted
• ☐ Payment received via EDI 820
• ☐ Supplier Portal scorecard reviewed
• ☐ Monitoring process established for ongoing compliance

Frequently Asked Questions

How much does UNFI EDI setup cost?

Costs vary significantly by provider. Legacy EDI providers may charge $1,500–$5,000+ for initial UNFI setup plus ongoing monthly fees of $200–$500 and per-document fees ($0.30–$3.00 per transaction). Modern AI-powered EDI platforms often offer flat monthly pricing ($500–1,500/month) without per-document fees. Additional costs include GS1 membership ($250–10,500/year depending on product count) and any ERP/WMS integration work.

What fill rate does UNFI expect from suppliers?

UNFI expects suppliers to maintain a fill rate of 95% or higher—meaning you ship at least 95% of the cases ordered. The minimum acceptable fill rate is typically 90%. Fill rates below 90% may result in reduced order volume, loss of promotional opportunities, or potential deauthorization.

How does UNFI EDI differ from Walmart or Target EDI?

While the same ANSI X12 standards apply, key differences include: order frequency (UNFI has regular replenishment cycles vs. variable retail orders), ASN complexity (UNFI often accepts case-level vs. pallet/SSCC-18 required by retailers), chargeback severity (UNFI deductions are typically less punitive than Walmart/Target chargebacks), and primary metrics (UNFI focuses on fill rate vs. OTIF for retailers). Managing both requires separate EDI configurations.

Do I need EDI to sell to UNFI?

For small suppliers with limited order volume, UNFI may accept manual order processing. However, EDI capability is strongly preferred and becomes effectively mandatory as your volume grows. EDI improves order accuracy, reduces processing time, enables faster receiving at UNFI DCs, and positions you for growth. Most suppliers find that EDI investment pays off quickly through operational efficiency and improved supplier scorecard metrics.

How do I dispute UNFI deductions?

When you receive a deduction, first review the detail in the UNFI Supplier Portal to understand the reason code and evidence. Gather supporting documentation (BOL, carrier confirmation, ASN data, photos if relevant). Submit a dispute through the Supplier Portal within UNFI’s dispute window (typically 30–60 days from deduction date). Include all evidence and a clear explanation of why the deduction is incorrect. Track dispute status in the portal and follow up if resolution is delayed.

Conclusion

UNFI EDI compliance is essential for food and beverage brands serious about scaling in the natural products channel. The brands that thrive with UNFI treat EDI not as administrative overhead but as a strategic capability that enables growth.

The key to success: understand UNFI's distribution model (they're your customer, not the end retailer), implement all required EDI documents correctly from day one, maintain fill rates above 95%, and monitor ASN timing closely to avoid chargebacks. Modern AI-powered EDI platforms can automate most of this compliance work, letting your team focus on growing your UNFI business rather than managing EDI errors.

Crstl provides AI-powered EDI automation for food and beverage brands selling through distributors and retailers including UNFI, KeHE, Walmart, Target, and Whole Foods.