Home /  Guides / 

Create Stedi Mappings From a Guide

Stedi Mappings let you transform JSON data from one shape to another. They are useful when you need to transform JSON data between a custom shape for your internal systems and EDI-like JSON for EDI Translate.

Mappings require that you define a source JSON schema that represents incoming data and a target JSON schema that represents outgoing data. You can choose to base the source or target of a mapping on a guide. When you create a mapping from a guide, the mapping document is prepopulated with fields from the guide.

Create a mapping based on a Stedi guide

To create a new mapping based on a Stedi guide:

  1. Go to the guide builder for the guide you want to use.
  2. Click Actions and select Create mapping.
  3. Choose a use case: Reading EDI or Writing EDI.
  4. Enter a Name and choose the Sample file the mappings UI will use to generate the schema. If there is no sample available, the guide builder auto-generates a sample by default.
  5. Click Create new mapping.
The mappings UI opens with either the Source or Target schema pre-filled according to the use case and guide you chose. the

Connected guides

When you generate a mapping source or target schema from a Stedi guide, the guide is automatically connected to the mapping. You can pull published changes from the guide into the mapping to automatically update the schema. For more details, visit the Mappings documentation.
Create a mapping based on a Stedi guideConnected guides


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


Build EDI integrations fast, without being an EDI expert

Start building
  1. Twitter
  2. GitHub
Backed by
AdditionBloomberg BetaFirst RoundStripeUSV
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.