Changelog

June 2, 2023

Functions UI now includes step-by-step instructions for local development

You can create and manage Stedi Functions, such as those using external libraries, locally with the Stedi CLI and Functions SDK. The Functions UI now contains a Local Setup page with step-by-step instructions to help you get started.

Functions is a compute service that lets you run code without managing servers. You can use functions to respond to Stedi Core events, integrate Stedi with external systems, and define functionality to fulfill any EDI integration requirement.

May 19, 2023

EDI Guide Catalog expanded to include nine more brands

We are excited to announce the addition of guides for the following brands to our public catalog:

The EDI Guide Catalog is an open directory of our most-requested public Stedi guides, interactive EDI specifications that let you instantly validate X12 EDI documents.

Stedi guides contain validated sample files to help trading partners learn usage patterns faster. You can also use Stedi guides to automatically validate, parse, and generate EDI documents according to partner-specific requirements.

Import any guide from the catalog into your Stedi account for free and use it for your integration.
Submit a request for new guides from any trading partner, and we'll add them to the catalog for free. Building new guides typically only takes a few business days.
Contact us to add your guides to the catalog, so you can simplify onboarding for your partners.

May 12, 2023

Stedi Core increases size limits for EDI transactions

Stedi Core now supports translating EDI transaction sets up to 130mb in size, both using a custom guide and using the default X12 spec.

Previously, the limit was 90mb with a guide and 50mb with the default X12 spec.

Dimension	Previous limit	New limit
File size	500 mb [^1]	500 mb (unchanged)
Largest transaction set within a file
without a guide	50 mb	130 mb
with a guide	90 mb	130 mb

For more details, visit Limits in the Core documentation.

[^1] An EDI file can contain multiple interchanges, and each interchange can contain multiple transaction sets. The limit of what Core can process is generally dictated by the size of the largest EDI transaction set within the file, not by the file size itself.

May 3, 2023

Stedi Core now supports translating large EDI files

Stedi Core now supports translating EDI files up to 500mb and individual transaction sets up to 90mb. This is more than 80x larger than the EDI Translate API's current limit.

For more details, visit Limits in the Core documentation.

May 2, 2023

Introducing Function templates for common integration tasks

You can now deploy Stedi Functions from templates as a starting point for common integration tasks, such as routing errors to an internal alerting system. Templates contain all the event bindings and environment variables required to accomplish each task.

After you create a function from a template, you can customize it to add error handling and other behavior for your use case.

April 25, 2023

EDI Guide Catalog adds guides for ten new brands

We are excited to announce the addition of guides for the following brands to our public catalog:

The EDI Guide Catalog is an open directory of our most-requested public Stedi guides, interactive EDI specifications that let you instantly validate X12 EDI documents.

Stedi guides contain validated sample files to help trading partners learn valid usage patterns faster. You can also use Stedi guides to automatically validate, parse, and generate EDI documents according to partner-specific requirements.

Submit a request if you want us to add guides for any new trading partner, and we'll add them to the catalog for free. Building new guides typically only takes a few business days.

Contact us to add your guides to the catalog, so you can simplify onboarding for your partners.

April 21, 2023

New HIPAA guides available in the EDI Guide Catalog

We added new HIPAA guides to our public catalog:

Stedi’s X12 HIPAA guides are a free catalog of X12 HIPAA specifications that make it easier to understand, test, and translate healthcare EDI.

Browse interactive specifications for each transaction set, view sample transactions, and even validate EDI files in real time in your browser. Import any X12 HIPAA guide into your Stedi account and customize it to fit your integration use case. You can also use guides to programmatically validate and generate X12 EDI that conforms to the specifications.

April 14, 2023

EDI Guide Catalog expanded to include guides for Ace Hardware, Adobe, Boeing, Buckle, Estes Forwarding Worldwide, Ford, and General Mills

We are excited to announce the addition of guides for the following brands to our public catalog:

The EDI Guide Catalog is an open directory of our most-requested public Stedi guides, interactive EDI specifications that let you instantly validate X12 EDI documents.

Stedi guides contain validated sample files to help trading partners learn valid usage patterns faster. You can also use Stedi guides to automatically validate, parse, and generate EDI documents according to partner-specific requirements.

Submit a request if you want us to add guides for any new trading partner, and we'll add them to the catalog for free. Building new guides typically only takes a few business days.

Contact us to add your guides to the catalog, so you can simplify onboarding for your partners.

April 7, 2023

EDI Guide Catalog expanded to include guides for 3M, CN Rail, Costco, Coupa, Kroger, and TForce Freight

We are excited to announce the addition of guides for the following brands to our public catalog:

The EDI Guide Catalog is an open directory of our most-requested public Stedi guides, interactive EDI specifications that let you instantly validate X12 EDI documents.

Stedi guides contain validated sample files to help trading partners learn valid usage patterns faster. You can also use Stedi guides to automatically validate, parse, and generate EDI documents according to partner-specific requirements.

Submit a request if you want us to add guides for any new trading partner, and we'll add them to the catalog for free. Building new guides typically only takes a few business days.

You can also contact us to add your guides to the catalog, so you can simplify onboarding for your partners.

March 31, 2023

Improvements to Guides and Mappings

Stedi guides are machine-readable EDI specifications that you can share as interactive web pages with built-in X12 EDI validation. Stedi mappings let you transform JSON from one shape to another. You can base the source or target schema of a mapping on a guide, which lets you automatically pull changes from the connected guide into the mapping.

We recently released the following Guides and Mappings improvements and fixes:

Improvements

You now receive a warning when you try to delete a guide that is connected to one or more mappings. The warning lists all of the connected mappings.
The guide builder now includes tooltips when you hover over the colored icons next to each node in the sidebar. The tooltips tell you the segment or element type and whether or not it’s required.
The mappings UI now pre-selects all target keys when you create a mapping externally from the API or guide builder. Previously, Mappings only pre-selected target keys when you created a mapping from within the Mappings UI.

Fixes

When you enter Allowed Values for elements, the guide builder displays a shortened versioned of long JSON keys so they don't overlap with the description.
The guide builder now allows spaces in values. This update is important for values like organization names, which require spaces for readability.

March 29, 2023

EDI Guide Catalog expanded to include guides for Albertsons, Amazon, Best Buy, CVS, JCPenney, Lowe's, and Nordstrom

The EDI Guide Catalog is an open directory of our most-requested public Stedi guides, interactive EDI specifications that let you instantly validate X12 EDI documents.

We are excited to announce the addition of guides for the following brands to our public catalog:

Stedi guides contain validated sample files to help trading partners learn valid usage patterns faster. You can also use Stedi guides to automatically validate, parse, and generate EDI documents according to partner-specific requirements.

Submit a request for new guides for any trading partner, and we'll add them to the catalog for free. Building new guides typically only takes a few business days.

You can also contact us to add your existing guides to the catalog.

March 27, 2023

Omit any field in Mappings based on a condition

While building a Stedi mapping, you often need to omit a specific field based on the data in the incoming source document. For example, you may need to omit a delivery address object completely if the purchase order has not been confirmed yet. Now, you can use the $omitField constant to omit both primitive fields and entire objects.

Previously, Mappings UI only allowed using the $omitField for primitive fields (fields that map to strings, numbers, and booleans).

You can now use $omitField to exclude an entire object or an array based on a condition. Mappings now recognizes $omitField within list context expressions. In addition, every object field has a new optional object context input with built-in support for $omitField.

March 23, 2023

Auto-generate EDI Translate API calls from any Stedi guide

EDI Translate uses Stedi guides to read, validate, and generate EDI according to partner-specific requirements. When you call EDI Translate APIs, you must provide your Stedi API key for authorization and either the EDI document (reading) or JSON document (writing EDI).

The guide builder now auto-generates sample EDI Translate API calls for reading and writing EDI. Click Actions > Get Translate API snippet to copy sample calls for several languages, including cURL, HTTP, and Python.

The sample API calls include valid test EDI or JSON data based on the guide's specifications. The guide builder auto-generates generic test data, but you can also get test data from an attached sample EDI file.

March 21, 2023

Bootstrap module now supports polling FTP/SFTP servers

The Stedi bootstrap repository lets you quickly deploy a reference implementation that sends and receives EDI documents, connecting Stedi products in an end-to-end flow.

The bootstrap implementation now supports polling remote FTP / SFTP servers for new files. When the poller finds files, it copies them to a Stedi bucket and optionally deletes those files from the remote server. You can configure the bootstrap module to process these files automatically. Visit the bootstrap external poller README for more details.

Book time with our technical team for help deploying the bootstrap repository to your Stedi account and customizing it for your use case.

March 16, 2023

View connected Stedi guide for any mapping on the list view

Building a Stedi mapping requires defining a source and target JSON schema. You can generate these schemas automatically by connecting the mapping to an existing Stedi guide.

Now, the Mappings UI shows you which mapping source or target schemas are connected to Stedi guides and links directly to the connected guide. This new view helps you understand how many mappings are linked to Stedi guides and which mappings are affected by specific guide changes.

March 15, 2023

Enable payload validation for transformed JSON documents in Mappings API

Stedi Mappings let you transform JSON documents from one structure to another. By default, the Mappings API does not apply any payload validation on the /map endpoint.

Now, you can enable Strict validation mode to validate the input and the output payload of the mapping operation. Validation helps you ensure that the mapping results are accurate and catch deviations from expected results early.

To apply strict validation, set the validation_mode query parameter to strict. Mappings uses the source schema to validate the input document and the target schema to validate the outgoing document.

If validation of the input or output payload fails, the response is a 400 error with the validation_failed code and validation_errors object.

HTTP/1.1 400
Content-Type: application/json

{
  "code": "validation_failed",
  "message": "The input of the mapping does not conform to the specified source JSON Schema, and the output of the mapping does not conform to the specified target JSON Schema.",
  "validation_errors": {
    "source": {
      "mapping_input": {
        "quantity": 15,
        "unit_price": 2.50
      },
      "errors": [
        {
          "code": "required",
          "message": "must have required property 'unit_description'",
          "json_pointer": "/",
          "json_schema_pointer": "#/required"
        }
      ]
    },
    "target": {
      "mapping_output": {
        "total": 37.50
      },
      "errors": [
        {
          "code": "type",
          "message": "must be integer",
          "json_pointer": "/total",
          "json_schema_pointer": "#/properties/total/type"
        }
      ]
    }
  }
}

March 9, 2023

Add a description to validated samples in Stedi guides

You can include multiple EDI sample files in Stedi guides to help new trading partners understand valid usage patterns faster and reduce onboarding time.

Now, you can add a description to each sample that gives trading partners even more context about the intended use cases. The description appears at the top of the guide’s EDI Inspector.

This feature is available both for Public Guides and for Stedi guides published privately. View descriptions for samples in the YRC Freight X12 Motor Carrier Bill of Lading.

March 6, 2023

Mappings UI Improvements

Stedi mappings let you transform JSON data from one shape to another, most importantly between your internal schema and EDI-like JSON required for EDI Translate.

We launched the following improvements to the Mapping builder UI:

When you connect a Stedi guide to the mapping’s source or target schema, the Guide tab links directly to the connected guide.
The Schema and Example tabs are now read-only when a guide is connected. This prevents you and collaborators from manually editing the schema out of sync with the connected guide.
You can use the View menu to show and hide the source and output columns as needed.

March 3, 2023

Change the industry identifier for X12 HIPAA guides

The industry identifier for an EDI transaction set is specified in characters 7-12 of the GS-08 element of the functional group header.

You can now change the industry identifier when building a custom Stedi guide for an X12 HIPAA transaction set. You can build a custom guide by importing an [X12 HIPAA public guide] (https://www.stedi.com/edi/catalog/hipaa) into your account. EDI Translate uses the industry identifier you choose when generating EDI documents according to your guide's specifications.

March 1, 2023

Use underscore as a delimiter in Stedi guides

Delimiters separate the segments and elements in an EDI file. When you create a Stedi guide, you can choose the delimiters that the EDI Translate API should use when writing EDI.

Now, you can choose underscore as the delimiter option in Stedi guides.

Visit our product documentation for more information about delimiters in Stedi guides.

February 27, 2023

EDI samples are now included in Stedi guide PDFs

Stedi guides let you view and share EDI specifications as interactive web pages with built-in X12 EDI validation. You can also download Stedi guides as high-quality PDFs.

EDI samples attached to the guide are now included in the downloaded PDF. The guide builder automatically validates new sample files against the guide specifications, so you can be sure that the sample matches the specification before sharing the PDF with your trading partners.

February 22, 2023

Announcing X12 HIPAA guides

We are excited to announce the availability of Stedi’s X12 HIPAA guides, a free catalog of X12 HIPAA specifications that make it easier to understand, test, and translate healthcare EDI.

Browse interactive specifications for each transaction set, view sample transactions, and even validate EDI files in real time in your browser. Import any X12 HIPAA guide directly into your Stedi account and customize it to fit your integration use case. You can use Stedi's EDI Translate APIs to programmatically validate against any X12 HIPAA guides as well as parse and generate X12 EDI that conforms to the specifications.

February 16, 2023

Quickly update mapping source and target schemas from connected Stedi guides

Stedi guides and EDI Translate convert data between EDI and EDI-like JSON. Stedi mappings transform data between EDI-like JSON and a custom JSON shape that reflects your internal data model.

Each mapping has a source schema and a target schema, which you can define based on a Stedi guide or a sample JSON file.

Now, the mappings UI automatically detects changes in connected Stedi guides and lets you pull those changes into the schema. When you change the schema, the mappings UI alerts you when the updates affect existing expressions in the mapping.

February 14, 2023

Download validated EDI files from EDI Inspector

Stedi EDI Inspector instantly recognizes data from any X12 EDI file and validates it against the standard to catch errors such as incorrect codes and formats, missing or misplaced segments, and more. Each Stedi Guide has a built-in EDI Inspector that validates files against partner-specific EDI specifications. Now, you can download validated EDI files.

Try the EDI Inspector on Walmart's 204 Motor Carrier Load Tender. Visit the EDI Guide Catalog for public guides from many trading partners, including Amazon, FedEx, Walmart, Trader Joe's, and more.

February 6, 2023

Integrate faster: Import Stedi guides from the EDI Guide Catalog to your account

The first step toward building an EDI integration with Stedi is to create a Stedi guide from your partner's PDF implementation guide. Now, you can skip this step and directly import any guide from our EDI Guide Catalog into your Stedi account to integrate faster.

The EDI Guide Catalog is an open directory of our most-requested guides, and we continue adding more. You can view these guides as interactive EDI specifications and validate test files right in your browser. You can also request new guides, and we'll add them to the catalog.

February 2, 2023

Build a new mapping directly from a Stedi guide

A Stedi mapping lets you transform data into any JSON shape you want. Now, you can create a mapping directly from a Stedi guide for EDI reading or writing use cases.

Mappings are useful when you want to transform data to or from EDI-like JSON. For example, you may need to transform data from the guide JSON format that EDI Translate understands into a custom shape for internal systems. EDI Translate uses guides to quickly and accurately convert data between EDI and JSON. The JSON shape for both input and output closely matches the shape of the incoming or outgoing EDI.

January 30, 2023

Guide builder: Add multiple codes and built-in support for standard ISO currency codes

We're constantly simplifying the guide builder experience. Instead of adding allowed values one-by-one for code (Identifier) elements, you can now provide a comma separated list of all the values you want to allow.

For the Currency Code, you can now select from a dropdown of standard ISO codes. This minimizes the chances of errors in the specification from entering an invalid code.

January 27, 2023

Guide builder: More easily specify when to use segment and loop variants

You may want to allow multiple variants of a segment or loop in your EDI specifications. For example, you could specify that partners include two N1 Name loops in each 850 purchase order: one for the ship to contact and another for the bill to party.

The guide builder UI now lets you select a discriminant element that has unique values for each variant. The discriminant tells the guide’s EDI Inspector and the EDI Translate API when one variant should be used over the other for validating, generating, or parsing EDI documents.

In the 850 purchase order example, you’d add the Entity Identifier Code as the discriminant for N1 Name loops. For the bill to variant, you’d use the BT qualifier, and for the ship to variant, you’d use the ST qualifier.

January 26, 2023

EDI Inspector 'Format' option now prompts auto-adjustments for malformed ISA header

Formatting a malformed EDI file can be painful, especially if you are new to EDI or when you are troubleshooting a problem. This is why we originally introduced the 'Format' option on the EDI Inspector to make EDI content easier to navigate.

We noticed that EDI samples enclosed in PDF implementation guides almost always have incorrect whitespace padding within the ISA header. A customer needs to manually correct these to get to a valid EDI even if the rest of the EDI document is valid. Starting today, the format action detects the whitespace issues within the ISA header, and recommends one-click fixes to quickly get to a valid EDI. Try it out on a sample guide today.

Invalid Date

Stedi completes external audit for HIPAA eligibility: Ensuring the protection and confidentiality of patient data

We are excited to announce that Stedi has successfully passed an external audit and our products have been certified as HIPAA eligible. This certification means that our products have undergone rigorous testing and have been deemed compliant with HIPAA regulations.

We understand that HIPAA eligibility is important for our customers in the healthcare industry as it ensures their sensitive patient data and protected health information (PHI) will be safe and kept confidential when using Stedi products. This is critical when you are exchanging health information such as claims, eligibility, and enrollment information with your partners.

This certification is just one of the many ways in which Stedi is fortifying its platform to handle customer data safely and securely. Visit our trust page for more information on our security and compliance policies and documents, or contact us with any compliance questions related to your business case.

Feedback