In this article, learn about:
Why the weeks between a signed deal and a clean first shipment shape how profitable the account becomes
The order of operations for retailer onboarding, with realistic timelines for each stage
The specific mismatches that trigger chargebacks on a supplier’s first orders
How suppliers build the order and shipping data backbone a national retailer expects before launch day
A buyer says yes. That moment deserves the celebration it gets, but it's also the start of an operational project rather than the end of one.
The work between that “yes” and the first clean shipment usually runs several weeks. In that window a supplier connects to the retailer through electronic data interchange (EDI), registers item data, prints carton labels to an exact spec, passes a testing cycle, and learns how the retailer wants freight routed.
For a direct-to-consumer (DTC) brand moving into big-box retail, most of that work is new. Suppliers who treat those weeks as a readiness sprint tend to launch smoothly. Suppliers who treat them as paperwork often pay for it in deductions on their first orders.
Why Does Retailer Onboarding Begin After the Deal Closes?
Winning the account is a sales milestone. Shipping the first order clean is an operational one, and the two are weeks of work apart.
That gap is where the cost of being unready shows up. Protein bar brand Aloha launched into Target, could not absorb the slotting fees and marketing costs, and was dropped for underperforming. The brand spent years reformulating its products and rebuilding through its own website and Amazon before it re-entered Target with two products in about 600 stores, seven years later. CEO Brad Charron put the lesson plainly: “you can’t be poorly financed entering a big-box retailer,” and “once you’re out, be prepared to sit in purgatory for five to seven years.”
The brands that launch well start earlier than the deal. Jupiter turned down an early opportunity to sell at Target because its supply chain was not ready, invested in manufacturing stability first, and later expanded into more than 1,100 stores with a 3PL that already served Target suppliers. Razor brand Nimbi built capacity for 100 million units a year before its national rollout.
Preparation is also easier the second time. Men’s cosmetics brand Stryx rolled out to 2,000 CVS stores, then prepared for 950 Target doors with that experience behind it. “We have battle scars from the CVS rollout,” founder Jon Shanahan told Practical Ecommerce. “But that experience helped us prepare for Target.”
Related Reading: How the Best Breakout DTC Brands Prepared for the Jump to Walmart and Target
What Are the Steps in Retailer Onboarding?
Retailer onboarding follows a predictable order. Each stage depends on the one before it. A late start squeezes the stages that need the most care.
1. Vendor Agreement and Requirements Review
The supplier agreement and the vendor guide define what compliance means for this account. Between them they set order acknowledgment windows, delivery windows, label formats, packaging rules, and the penalty attached to each. Requirements differ by retailer. A retailer-by-retailer requirements reference helps with scoping, but the retailer’s own guide is the authority.
2. EDI Path and Provider Selection
Nearly every large retailer requires EDI for purchase orders, order acknowledgments, advance ship notices, and invoices. Suppliers generally pick one of three paths. A full-service provider handles the mapping and compliance. EDI software puts that work in-house. The retailer’s own web portal works at a few orders a week and hurts beyond that, because every document becomes manual entry.
3. Item Setup and GTIN Accuracy
Each sellable unit needs its own Global Trade Item Number, commonly encoded in a UPC barcode for retail products in North America. Inner packs and cases might need their own GTINs, as well. Item data has to agree across three places: the retailer’s item system, the supplier’s own system, and the physical product.
4. Mapping, Testing, and Certification
Testing is the stage suppliers underestimate most. The retailer sends test documents, checks the supplier’s responses against its spec, and returns errors to fix. Providers and retailers both refer to this stage as EDI testing and certification. eZCom, an EDI provider, notes that testing verifies orders are received correctly, advance ship notices carry the required detail, labels scan properly, and invoices meet formatting rules, and that the cycle commonly takes a few weeks.
5. GS1-128 Labels and Packaging
Distribution centers receive shipments by scanning cartons, so the physical label carries as much weight as the data. GS1-128 labels encode a unique serial shipping container code for every carton, and that code has to appear in the shipment data too.
Related Reading: Labeling for New Suppliers: GS1-128, SSCC, and Where Labels Have To Go
6. Routing Instructions and Carrier Setup
Many retailers control the freight. The supplier requests routing, the retailer assigns a carrier and a delivery window, and the shipment has to follow both.
7. First Order, Shipment, and Invoice Cycle
The first live orders are worth watching document by document. Teams that catch a timing or quantity problem on order three avoid repeating it on order 300.
Stage | What it involves | Typical timeline | Common chargeback risk |
1. Vendor agreement and requirements review | Signing the supplier agreement, getting a supplier number, reading the vendor and routing guides | 1 to 2 weeks | Requirements missed here surface later as repeat violations |
2. EDI path and provider selection | Choosing a full-service provider, in-house software, or the retailer’s web portal | 2 to 4 weeks | A portal that can’t scale forces manual entry and data errors |
3. Item setup and GTIN accuracy | Registering every sellable unit, inner pack, and case with its own barcode | 1 to 2 weeks, in parallel | Item data that disagrees with the purchase order or the label |
4. Mapping, testing, and certification | Translating the retailer’s formats to your systems, then passing test documents | 2 to 4 weeks | Untested edge cases such as partial shipments and cancellations |
5. Labeling and packaging | Building GS1-128 carton labels, case packs, and pallet configurations to spec | 1 to 2 weeks, in parallel | Labels that do not match the shipment data |
6. Routing setup | Requesting routing, receiving instructions, booking the carrier | Ongoing, per shipment | Missed routing windows and unapproved carriers |
7. First order, shipment, and invoice cycle | Running a live order end to end and watching every document | First 2 to 4 weeks live | Late or inaccurate advance ship notices |
How Long Does EDI Onboarding for Suppliers Take?
Long enough that a launch date set without it is usually optimistic. Crstl, an EDI provider, breaks a legacy Walmart setup into four phases that add up to 8 to 14 weeks from contract to go-live:
Provider setup, two to four weeks
Connection configuration, one to two weeks
Document mapping, two to four weeks
Certification testing, two to four weeks
eZCom puts general trading partner onboarding at two to six weeks. The spread is real. It depends on the retailer, the document set, and how clean the item data already is.
Commercial timelines run longer. Hydration brand Waterdrop went from eight doors to more than 3,000 in 2023, across Walmart, Target, and H-E-B at once. The placements behind that launch took over 12 months of negotiation, co-founder Henry Murray said. An outside consultant called the all-at-once approach “super high risk and high reward.” Most digitally native brands go local, then regional, then national instead.
The practical move is to plan backward. Start from the first delivery date. Count back through testing, mapping, and provider setup. The math either fits the calendar or it does not, and a supplier who learns that in week one can still reset the date with the buyer.
Which Retailer EDI Requirements Cause First-Shipment Chargebacks?
Many first-shipment deductions come from a mismatch between what the retailer was told and what arrived at the dock. The categories are narrow and repeat across retailers.
Data and labels that disagree. The carton label says one thing and the shipment data says another. eZCom names this as one of the most common onboarding problems, because the receiving team either delays the shipment or applies a chargeback.
Advance ship notice timing. The notice has to reach the retailer before the truck does. Crstl describes the advance ship notice as the document where most Walmart chargebacks originate.
Quantity and carton discrepancies. A carton counted at 23 units against data that promised 24 creates a receiving exception and an inventory problem.
Item data mismatches. A barcode that is not registered, or a case pack that differs from the retailer’s item record, stops the receipt.
Missed delivery windows. Walmart measures suppliers on on-time in-full (OTIF) performance, and Crstl reports that failures typically cost 3% of the affected order value.
None of these require unusual circumstances or especially bad luck. They happen when a process that worked for shipping 40 boxes a day has not been rebuilt for shipping to a distribution center that scans everything.
Can Your Operation Support a National Retailer’s Volume?
Capacity belongs in the onboarding plan alongside the data work. A national retailer needs output and consistency that most DTC operations have never had to produce.
Three questions tend to settle it:
Can production hold quality at the order volume, including replenishment after the first fill?
Does cash on hand cover a stock build that ships now and gets paid on the retailer’s terms?
Can the team hold a steady fill rate when a second retailer starts ordering too?
Stryx framed its Target rollout the same way. Shanahan said the core issue was inventory: could the brand put enough units in that many stores. He called cash flow management “the multi-million-dollar issue.” Target also told the brand how much stock to hold for replenishment. That is the kind of number worth asking about early, not in week two.
Capacity work also changes who a supplier needs. Jupiter hired a head of supply chain and production, then moved to a 3PL with big-box experience. Supplement brand Grüns grew past 100 employees and hired a VP of retail to support more than 5,000 stores.
Why Is the Retailer Routing Guide So Important?
The routing guide tells a supplier how freight moves, and retailers enforce it the way they enforce price.
On collect freight, the exchange runs through three connected EDI documents. The supplier sends an EDI 753 Request for Routing Instructions with the shipment details. The retailer returns an EDI 754 with the carrier and the pickup or delivery window. The supplier then sends the advance ship notice, and its details have to match both the 753 and the 754.
The window for this is short. SPS Commerce notes that the process often allows as little as 24 hours before shipment, and that missing it or ignoring partner requirements can mean significant chargebacks and a lower scorecard. Reading the routing guide closely before the first purchase order arrives is cheaper than learning it from a deduction.
Frequently Asked Questions
How long does retailer onboarding take?
Plan on six to 14 weeks for a first large retail account, depending on the retailer and the EDI path. Crstl puts a legacy Walmart EDI setup at 8 to 14 weeks from contract to go-live, while eZCom reports two to six weeks for general trading partner onboarding. Item data cleanup and capacity work can run in parallel.
Do small suppliers really need EDI?
Usually, yes. Most large retailers and distributors require electronic documents regardless of supplier size. Some offer a web portal for very low volume, which works for a handful of orders a week and stops working as volume grows.
What is the most common cause of a first-shipment chargeback?
A mismatch between the shipment data and the physical shipment. That includes late or inaccurate advance ship notices, carton labels that disagree with the data, quantity discrepancies, and unregistered barcodes.
Can a 3PL handle onboarding for us?
A 3PL can own labeling, packing, and shipping execution, and many are experienced with specific retailers. Responsibility still has to be assigned explicitly. Onboarding problems often trace back to an unclear handoff between the supplier’s system, the 3PL, and the EDI connection rather than to any one of them failing.
What should we do first if the first delivery date is already set?
Count backward from that date through testing, mapping, and provider setup, then compare the result to the calendar. If the date does not fit, that conversation with the buyer goes better in week one than in week six.
Want To Get Live With a New Retailer Faster?
Onboarding moves faster when someone already knows the retailer’s rules. SPS Fulfillment connects suppliers to those rules and handles the mapping, the testing, and the sign-off. It also builds the order, shipment, and invoice documents a first shipment needs.
Not ready to talk about EDI yet? The Supply Chain Source has guides on item setup, routing, and how to prevent deductions once you are live.