// edi to json
EDI Translator
Turn an X12 EDI document into JSON.
Paste a document to translate it into JSON. Unlike most online EDI to JSON conversion tools, the output is properly structured and readable. For more on the output, see The Tediware JSON Format farther down the page. No account is needed to use this tool.
Translate EDI to JSON
Paste raw X12 EDI here to see it translated to JSON. Requires JavaScript.
Source
ISA*00* *00* *ZZ*TEDIBUYER *01*WIDGETWORKS *260101*0000*U*00401*000000001*0*T*}
GS*PO*TEDIBUYER*WIDGETWORKS*20260101*0000*1001*X*004010
ST*850*1001
BEG*00*SA*TEDIPO0001**20260101
CUR*BY*CAD
REF*IA*10000
REF*19*Ship to head office
REF*YD*1
REF*ZZ*No QC Hold, OK to Ship
PER*BD*Adrian
FOB*PP
ITD************26
DTM*106*20260201
N9*ZZ*GEN
MSG*THIS PURCHASE ORDER MUST BE FULFILLED ACCORDING TO THE VENDOR GUIDE AT https://tediware.com
MSG*QUESTIONS ABOUT THIS ORDER? CONTACT INFO@TEDIWARE.COM. NO SUBSTITUTIONS OR BACKORDERS.
N1*VN*WIDGETWORKS LLC
N3*1 INDUSTRIAL WAY
N4*PORTLAND*OR*97201*US
N1*ST*TEDIWARE HEAD OFFICE*92*400**WH
N3*18 KING STREET EAST*SUITE 1400
N4*TORONTO*ON*M5C1C4*CA
PO1*1*36.0*EA*10.000**SK*0000001*VN*SKUTEDI1*UP*000000000001
PID*F*08***WIDGET ASSEMBLY KIT
PO4*36*****27*LB***10*15*12*IN
CTT*1
SE*25*1001
GE*1*1001
IEA*1*000000001JSON
{
"interchanges": [
{
"interchange_control_header_ISA": {
"authorization_information_qualifier_01": "no_authorization_information_present_no_meaningful_information_in_i02_00",
"security_information_qualifier_03": "no_security_information_present_no_meaningful_information_in_i04_00",
"interchange_id_qualifier_05": "mutually_defined_ZZ",
"interchange_sender_id_06": "TEDIBUYER",
"interchange_id_qualifier_07": "duns_dun_bradstreet_01",
"interchange_receiver_id_08": "WIDGETWORKS",
"interchange_date_09": "260101",
"interchange_time_10": "0000",
"interchange_control_standards_identifier_11": "u_s_edi_community_of_asc_x12_tdcc_and_ucs_U",
"interchange_control_version_number_12": "00401",
"interchange_control_number_13": 1,
"acknowledgment_requested_14": "no_acknowledgment_requested_0",
"usage_indicator_15": "test_data_T",
"component_element_separator_16": "}"
},
"interchange_control_trailer_IEA": {
"number_of_included_functional_groups_01": 1,
"interchange_control_number_02": 1
},
"groups": [
{
"functional_group_header_GS": {
"functional_identifier_code_01": "purchase_order_850_PO",
"application_senders_code_02": "TEDIBUYER",
"application_receivers_code_03": "WIDGETWORKS",
"date_04": "20260101",
"time_05": "0000",
"group_control_number_06": 1001,
"responsible_agency_code_07": "accredited_standards_committee_x12_X",
"version_release_industry_identifier_code_08": "004010"
},
"functional_group_trailer_GE": {
"number_of_transaction_sets_included_01": 1,
"group_control_number_02": 1001
},
"transaction_sets": [
{
"heading": {
"transaction_set_header_ST": {
"transaction_set_identifier_code_01": "purchase_order_850",
"transaction_set_control_number_02": "1001"
},
"beginning_segment_for_purchase_order_BEG": {
"transaction_set_purpose_code_01": "original_00",
"purchase_order_type_code_02": "stand_alone_order_SA",
"purchase_order_number_03": "TEDIPO0001",
"date_05": "20260101"
},
"currency_CUR": {
"entity_identifier_code_01": "buying_party_purchaser_BY",
"currency_code_02": "CAD"
},
"reference_identification_REF": [
{
"reference_identification_qualifier_01": "internal_vendor_number_IA",
"reference_identification_02": "10000"
},
{
"reference_identification_qualifier_01": "division_identifier_19",
"reference_identification_02": "Ship to head office"
},
{
"reference_identification_qualifier_01": "buyer_identification_YD",
"reference_identification_02": "1"
},
{
"reference_identification_qualifier_01": "mutually_defined_ZZ",
"reference_identification_02": "No QC Hold, OK to Ship"
}
],
"administrative_communications_contact_PER": [
{
"contact_function_code_01": "buyer_name_or_department_BD",
"name_02": "Adrian"
}
],
"f_o_b_related_instructions_FOB": [
{
"shipment_method_of_payment_01": "prepaid_by_seller_PP"
}
],
"terms_of_sale_deferred_terms_of_sale_ITD": [
{
"description_12": "26"
}
],
"date_time_reference_DTM": [
{
"date_time_qualifier_01": "required_by_106",
"date_02": "20260201"
}
],
"reference_identification_N9_loop": [
{
"reference_identification_N9": {
"reference_identification_qualifier_01": "mutually_defined_ZZ",
"reference_identification_02": "GEN"
},
"message_text_MSG": [
{
"free_form_message_text_01": "THIS PURCHASE ORDER MUST BE FULFILLED ACCORDING TO THE VENDOR GUIDE AT https://tediware.com"
},
{
"free_form_message_text_01": "QUESTIONS ABOUT THIS ORDER? CONTACT INFO@TEDIWARE.COM. NO SUBSTITUTIONS OR BACKORDERS."
}
]
}
],
"name_N1_loop": [
{
"name_N1": {
"entity_identifier_code_01": "vendor_VN",
"name_02": "WIDGETWORKS LLC"
},
"address_information_N3": [
{
"address_information_01": "1 INDUSTRIAL WAY"
}
],
"geographic_location_N4": [
{
"city_name_01": "PORTLAND",
"state_or_province_code_02": "OR",
"postal_code_03": "97201",
"country_code_04": "US"
}
]
},
{
"name_N1": {
"entity_identifier_code_01": "ship_to_ST",
"name_02": "TEDIWARE HEAD OFFICE",
"identification_code_qualifier_03": "assigned_by_buyer_or_buyers_agent_92",
"identification_code_04": "400",
"entity_identifier_code_06": "warehouse_WH"
},
"address_information_N3": [
{
"address_information_01": "18 KING STREET EAST",
"address_information_02": "SUITE 1400"
}
],
"geographic_location_N4": [
{
"city_name_01": "TORONTO",
"state_or_province_code_02": "ON",
"postal_code_03": "M5C1C4",
"country_code_04": "CA"
}
]
}
]
},
"detail": {
"baseline_item_data_PO1_loop": [
{
"baseline_item_data_PO1": {
"assigned_identification_01": "1",
"quantity_ordered_02": 36.0,
"unit_or_basis_for_measurement_code_03": "each_EA",
"unit_price_04": 10.0,
"product_service_id_qualifier_06": "stock_keeping_unit_sku_SK",
"product_service_id_07": "0000001",
"product_service_id_qualifier_08": "vendors_sellers_item_number_VN",
"product_service_id_09": "SKUTEDI1",
"product_service_id_qualifier_10": "u_p_c_consumer_package_code_1_5_5_1_UP",
"product_service_id_11": "000000000001"
},
"product_item_description_PID_loop": [
{
"product_item_description_PID": {
"item_description_type_01": "free_form_F",
"product_process_characteristic_code_02": "product_08",
"description_05": "WIDGET ASSEMBLY KIT"
}
}
],
"item_physical_details_PO4": [
{
"pack_01": 36,
"gross_weight_per_pack_06": 27.0,
"unit_or_basis_for_measurement_code_07": "pound_LB",
"length_10": 10.0,
"width_11": 15.0,
"height_12": 12.0,
"unit_or_basis_for_measurement_code_13": "inch_IN"
}
]
}
]
},
"summary": {
"transaction_set_trailer_SE": {
"number_of_included_segments_01": 25,
"transaction_set_control_number_02": "1001"
},
"transaction_totals_CTT_loop": [
{
"transaction_totals_CTT": {
"number_of_line_items_01": 1
}
}
]
}
}
]
}
]
}
]
}The Tediware JSON Format
One of the reasons X12 EDI is challenging is because so much of the information communicated by an EDI document is not contained within the document itself.
Structure (such as loops and hierarchical levels) and meaning are denoted by dense clusters of codes whose positions are of critical importance. (This is explained in detail in the EDI Guide For Developers, especially the Anatomy Of A Segment section).
The JSON puts that information back into the document. Structure becomes structure:
an interchange holds its groups, a group holds its transaction sets, and each
transaction set is split into the heading, detail and summary areas it uses. Every
loop and hierarchical level is a JSON array, so the line items of an 850 arrive as
baseline_item_data_PO1_loop, ready to
iterate. Nothing has to be reassembled by counting segments.
Names and meanings travel with the data. A key carries the X12 name of the element
along with its position, so an FOB segment's first element reads as
shipment_method_of_payment_01. A coded
value carries what the code means along with the code itself, so a bare
PP arrives as
prepaid_by_seller_PP. You can read a
document without the standard open beside it, and the raw codes are still there when
your system needs them.
Numbers arrive as numbers, with implied decimals already applied, and the delimiters each sender chooses in the ISA are resolved before the data reaches you. What is left is ordinary JSON that your language and tools already know how to traverse.
For more information about Tediware's JSON format, read JSON Format in the documentation.
Limits
| Signed out | Signed in | |
|---|---|---|
| Per minute | 10 | 30 |
| Sustained | 30 an hour | 1,000 a day |
| Document size | 50KB | 100KB |
| Verification | Per request | None |
Signed-out limits are counted per IP address, so an office behind one address shares them. Your document is sent to our server to be translated, and it is not stored.
Sign in for higher limits
An account raises the limit to 30 documents a minute and 1,000 a day, takes documents up to 100KB, and drops the verification step before each one is translated.
Related
To read a document segment by segment and see where it breaks the standard, use the EDI Inspector. The developer guide covers X12 structure and how inbound and outbound processing work.