The EDI Song · 3:59
Learn the EDI documents in one song
We were onboarding a brand onto retail EDI and nobody could keep 850, 855, 856 and 810 straight, so we wrote a song. Four minutes of emo rock about purchase orders.
EDI cheat sheet
EDI document types: the 11 lines from the song
EDI documents go by three-digit X12 codes, and every retailer’s vendor guide uses the numbers, not the names. The chorus is the first four: the order, the okay, the ship notice and the invoice. The rest are the ones you meet once you’re live.
| Code | Document | Who sends it | In plain English |
|---|---|---|---|
| 850 | Purchase Order | Retailer → you | The order. Everything else answers it. |
| 855 | PO Acknowledgment | You → retailer | You confirm the order: what you will ship, and when. |
| 856 | Advance Ship Notice (ASN) | You → retailer | What is on the truck, sent before the truck arrives. |
| 810 | Invoice | You → retailer | The bill for what shipped. |
| 846 | Inventory Inquiry / Advice | You → retailer | What is on the shelf, so the retailer doesn’t sell what you can’t ship. |
| 860 | PO Change | Retailer → you | Buyer-initiated: the retailer changes an order it already sent. |
| 997 | Functional Acknowledgment | Both ways | "Got it", not "read it". The file arrived and parsed; nobody accepted anything. |
| 940 | Warehouse Shipping Order | You → your 3PL | Please ship this. |
| 945 | Warehouse Shipping Advice | 3PL → you | What actually shipped, shortages included. |
| 857 | Shipment and Billing Notice | You → retailer | The 856 and the 810 in one document. |
| ST / BY / BT | Ship To / Buying Party / Bill To | Inside the documents | The N1 party codes: where the truck unloads, who the order is for, who pays. |
Who sends what
Retailer → You
850 · 860
orders and changes
You → Retailer
855 · 856 · 810 · 846
okay, on the truck, the bill, the shelf
You → 3PL
940
please ship this
3PL → You
945
shipped (most of) it
Every file in either direction gets a 997 back. The 857 is the 856 and the 810 in one, for retailers that ask for it. ST, BY and BT are the N1 party codes inside the documents, and which one holds the ship-to address depends on each retailer’s map.
Lyrics The EDI Song, 3:59
Hi. I sell stuff to retailers. And I have no idea what an 856 is.
One, two, 850, GO!
Got an order from a retailer, no "hope you’re doing well"
Just asterisks and tildes, like a robot cast a spell
It’s an envelope inside an envelope inside an envelope
I opened all three layers and I’m running out of hope
Born in 1979, it’s older than my boss
And if I read it wrong, guess who eats the loss?
I nodded on the Zoom call like I knew what they meant
Now I’m singing it until it’s permanent!
850! Here’s the order!
855! We say "okay!"
856! It’s on the truck!
810! Now pay the way!
(In 90 days!)
846, tell ’em what’s on the shelf
Or they’ll sell a thousand mugs and you’ll be making them yourself
860 lands on Friday at 4:59
The buyer changed the quantity on every single line
Send the ship notice late? That’s a chargeback fee
The truck beat the paperwork, and now it’s on me
Every file gets a 997 back
It means "we got it," not "we read it." Fact.
I nodded on the Zoom call like I knew what they meant
Now I’m singing it until it’s permanent!
850! Here’s the order!
855! We say "okay!"
856! It’s on the truck!
810! Now pay the way!
(In 90 days!)
Okay. Deep cuts. Stay with me.
ST, Ship To, where the truck unloads
BY, Buying Party, who the order’s for
BT, Bill To, who pays for it all
The textbook says it’s simple, then the big-box stores say no
The address is in BY, and ST’s empty, so...
Why? Nobody knows.
940 to the 3PL: "please ship this"
945 says "shipped it!" (Well... most of this)
857, ship notice and invoice all in one
It’s the spork of EDI, and honestly, it’s fun!
850! Here’s the order!
855! We say "okay!"
856! It’s on the truck!
810! Now pay the way!
850! Here’s the order!
855! We say "okay!"
856! It’s on the truck!
810! Now pay the way!
(In 90 days!)
850! 55! 56! 810!
Wait. Did anyone send the 855?
...No.