Home /  API Reference /  Legacy products / 
This is a legacy product

EDI Translate

The EDI Translate product is responsible for translating data between JSON and EDI formats. It uses a Stedi guide, which validates the data being translated, and is the resource which enables the API to determine how the EDI output is structured and formatted.

Download OpenAPI

TranslateX12ToJson

POST/x12/to-json
Converts an X12 EDI string into a JSON document, using the provided guideId.
Request body

application/json

guideIdOptionalstring

The ID to the guide that describes the relationship between the fields found in the input X12 EDI document and the output JSON.

The guide ID may be omitted to translate without a guide. The translation will use a default structure definition for the JSON document. The input X12 EDI will also be validated using the generic X12 release specification. Translating without a guide is in public preview.

inputRequiredstring

The incoming X12 EDI string to be converted into a JSON object. Must be a UTF-8 encoded string.

outputOptionsOptionalobject
TranslateX12ToJsonOutputOptions object.

inputOptionsOptionalobject
Input options for translation
TranslateX12ToJsonInputOptions object.

Example

POST
https://edi-translate.us.stedi.com/2022-01-01/x12/to-json

TranslateJsonToX12

POST/x12/from-json
Converts a JSON document into X12 EDI, using the provided guideId.
Request body

application/json

guideIdRequiredstring

The ID to the guide that describes the relationship between the fields found in the input JSON document and the output X12 EDI.

inputRequiredAny

The JSON document to be converted into X12 EDI. This document must conform to the specified guide.

envelopeOptionalpassword
Envelope object.

outputOptionsOptionalobject
Options that tell EDI Translate how to format the output.
TranslateJsonToX12OutputOptions object.

Example

POST
https://edi-translate.us.stedi.com/2022-01-01/x12/from-json

Feedback

Have an idea for something we could improve? Page not clear? We love feedback - send us a message.

Stedi

Build EDI integrations fast, without being an EDI expert

Start building
About
ProductPricingCareersContactBlog
Documentation
CoreGuidesFunctionsAll DocsChangelog
Resources
EDI ReferenceEDI InspectorEDI Guide CatalogEDI Forum
Follow
  1. Twitter
  2. GitHub
Backed by
AdditionBloomberg BetaFirst RoundStripeUSV
Loading status...
Customer AgreementService TermsPrivacy Notice

Stedi is a registered trademark of Stedi, Inc. All names, logos, and brands of third parties listed on our site are trademarks of their respective owners (including “X12”, which is a trademark of X12 Incorporated). Stedi, Inc. and its products and services are not endorsed by, sponsored by, or affiliated with these third parties. Our use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.