EDI translator and X12 viewer

Paste or open an X12 file to read it as a document, with every segment and element named. Nothing is uploaded.

The viewer reads the delimiters from the ISA segment. The text is read in this browser and never uploaded.

SAMPLE

What is EDI?

EDI, electronic data interchange, is the exchange of business documents between companies' computers in a fixed format. The receiving system reads them without anyone retyping. A former US federal standard, FIPS 161-2, defined it as the computer-to-computer exchange of strictly formatted messages. A purchase order, its acknowledgment, the ship notice, and the invoice each have their own document type.

In North America the format is ANSI X12, which GS1 Canada calls the most used EDI standard in Canada and the United States. X12 is developed by ASC X12, an ANSI-accredited standards body that holds the copyright in the standards and was chartered in 1979. The international standard is UN/EDIFACT, published by the United Nations body UN/CEFACT, and GS1's EANCOM is a subset of it.

What an EDI translator does

An X12 file is plain text written for machines. Segments end with a terminator such as a tilde, elements are split by a separator such as an asterisk, and short codes stand for meanings. A translator turns that text into something a person or an ERP can use. The viewer above reads any X12 file and shows:

Other transaction sets show their envelope, parties, dates, and every segment. EDI software also writes documents and maps them into the ERP. This page reads a file so that a person can understand it.

How to read an X12 file

Every interchange starts with an ISA segment of fixed length, and it sets the delimiters for the rest of the file. Microsoft's EDI documentation spells out where each one sits:

The sender picks these characters, and X12 says they cannot appear inside the data of that interchange. Three envelopes then nest inside one another. Each trailer repeats a count and a control number from its header, as the 3M 850 specification lists them:

HeaderTrailerWhat the trailer repeats
ISAIEAIEA01 counts the functional groups, and IEA02 repeats the interchange control number in ISA13.
GSGEGE01 counts the transaction sets, and GE02 repeats the group control number in GS06.
STSESE01 counts the segments from ST to SE, both included, and SE02 repeats ST02.

The viewer checks each pair and says which one is off.

Read the purchase orders that do not come as EDI

ThriveAI's order desk reads the purchase orders customers email and matches each line to your items and prices. It drafts the ERP order for a person to approve. Derik will tell you what a four-week build would cover.

See order desk automation

X12 versions 4010 and 5010

X12 published version 004010 on January 1, 1998, and 005010 on January 1, 2004. GS08 carries the version each functional group uses. One envelope change matters to a reader of the file. Before version 4020, ISA11 holds the letter U, and from 4020 on it holds the repetition separator, as Boomi's X12 settings describe. The viewer reads ISA12 to tell which.

Guides published as recently as 2024 still specify 4010, such as 3M's 850 specification.

The documents of one order

X12's supply chain flow runs from the purchase order to the payment, with a 997 sent back after each document received:

SetDocumentSent byWhat it carries
850Purchase orderBuyerThe order: items, quantities, prices, ship-to, and dates
997Functional acknowledgmentWhoever received a documentWhether the document passed the syntax checks
855Purchase order acknowledgmentSupplierEach line accepted, changed, backordered, or rejected
856Ship notice (ASN)SupplierWhat shipped, packed how, for which orders
810InvoiceSupplierThe bill for what shipped
820Payment order and remittance adviceBuyerThe payment and what it covers

A 997 reports whether a document arrived and passed the syntax checks. X12 says it reports syntax only, not meaning, so a 997 does not tell you the buyer agrees with your prices.

EDI vs ERP

An ERP is the system where a company keeps its orders, inventory, and invoices. EDI is a format for moving documents between two companies' systems. An 850 that arrives by EDI becomes a sales order in the supplier's ERP only after a translator maps its segments to the ERP's fields. Someone then checks what does not match, such as an unknown item or a price that differs from the contract. The guide to the sales order covers that step, and the order to cash process places it in the whole cycle.

How to convert an EDI file to Excel

Open the file in the viewer, choose the transaction set if the file holds more than one, and select Download CSV. The CSV holds one row per line item with its quantity, unit, price, part numbers, and description, and it opens in Excel. For an 856, each row also carries its purchase order number and the label of the pallet or carton it shipped in.

Customers who send PDFs instead of EDI

EDI covers the customers who are set up to send it. The rest send purchase orders by email, as a PDF, a spreadsheet, a scan, or lines typed into the message. Someone then keys each line into the ERP. ThriveAI's order desk reads those orders and matches each line to your items and to that customer's prices. It drafts the ERP order beside the original for a person to approve. Nothing enters the ERP before that approval.

What stays in your browser

The file is read in this browser and never uploaded. The viewer is plain JavaScript with no library to download, so it keeps working offline once the page has loaded. The page counts how often the viewer is used, with the transaction set number and the number of segments and lines. It never records the file or anything in it.

Questions

What is EDI?
EDI, electronic data interchange, is the exchange of business documents such as purchase orders, ship notices, and invoices between companies' systems in a fixed format. In North America the format is ANSI X12, developed by ASC X12. The receiving system reads each document without anyone retyping it.
How do I view an EDI file?
Paste the text into the viewer on this page, or open the file. An X12 file is plain text, so any text editor opens it, but the segments run together and the codes carry no labels. The viewer splits the segments, names each element, and shows the document as an order, a ship notice, or an invoice.
How does EDI work?
The sender's system writes a business document in the agreed format and sends it to the trading partner. The receiver's translator checks the envelopes and returns a 997 functional acknowledgment. It then maps the document into its own system, where it becomes a sales order, a receipt, or an invoice to pay.
What is EDI vs ERP?
An ERP is the system that holds a company's orders, inventory, and invoices. EDI is the format two companies use to send documents between their systems. A translator sits between them: it maps each EDI document into the ERP's fields, and maps the ERP's documents back out as EDI.
How can I convert an EDI file to Excel?
Open the file in the viewer on this page and select Download CSV. You get one row per line item, with quantities, units, prices, part numbers, and descriptions, in a file Excel opens. For an 856, each row also carries its purchase order number and its pallet or carton label.
Which EDI files does the viewer read?
Any ANSI X12 file. It reads the delimiters from the ISA segment, splits the envelopes, and names every segment it knows. It reads the 850, 855, 856, and 810 as documents. It does not read EDIFACT, which starts with UNA or UNB.
Is my EDI file uploaded anywhere?
No. The viewer runs in your browser and the file never leaves it. The page counts how often the viewer is used, with the transaction set number and the number of segments and lines. It never records the file or what is in it.

Contact

Read the orders that do not come as EDI

Tell Derik how your customers send purchase orders today. He will tell you what a four-week order desk build would cover.

Prefer to talk? Book a meeting.

Your message goes to Derik Lawlis, the founder.