Core
Stedi Core is the starting point to build an end-to-end EDI integration on Stedi.
Core is bi-directional, translating inbound EDI to JSON and generating outbound EDI from JSON—for any of the 300+ transaction sets across every X12 version release. Core allows you to configure any EDI relationship with your trading partners and provides complete visibility into your transactions.
During operations, Core emits rich events that you can consume to build your business integrations. Core accepts data in other formats, including CSV, JSON, and XML, so you can drive integrations from a central hub.
Use cases
Core addresses the following EDI use cases:
- Monitor and analyze EDI transactions: View transaction activity across all your partnerships. Inspect raw EDI files to troubleshoot issues. Use a business identifier, like a PO number, to locate specific transactions and find related transactions.
- Build an end-to-end EDI system: Configure Core to send and receive EDI data with any trading partner. Then, integrate Stedi with your systems and applications to create an end-to-end EDI flow.
Enable Core
Core has a monthly fee plus usage-based pricing for processed data.
To enable Core:
- Go to your Stedi account and select Core in the Products menu.
- Click Enable Core.
How Core Works
Core allows you to configure every aspect of your EDI integrations, including trading partner identity details, what transaction sets you want to exchange, and how you want to send and receive business data. Once configured, Core automatically detects new EDI files and converts them into validated JSON payloads.
Core emits a rich set of events that you can use to route data and events to your business systems. You can use Core’s Generate API to build and deliver complex EDI documents to your trading partners.
Configuration
You can configure the following settings within Core:
- Profiles: Represents trading entities, each with a unique ISA identity (ISA qualifier + ISA identifier) for you or your trading partner. Core uses profile information to identify the sender and receiver for each EDI document.
- Partnerships: A unique pair of profiles that establishes a relationship between you (local profile) and a trading partner (remote profile). Partnerships describe aspects of the EDI relationship between the two participating profiles, including:
- Transaction Settings: The EDI transaction sets you intend to exchange within a partnership and how you want Stedi to process them. Using a Stedi guide, you can customize translation for each transaction. Core automatically uses its baseline X12 specification to ingest EDI documents if you don't specify a guide.
- Connections: Define how you want to send and receive EDI documents, with native support for SFTP.
- Control Numbers: Control numbers uniquely identify the Interchanges and Functional Groups included in an EDI document sent from the local profile within the partnership.
Inbound processing flow
When Core detects a new EDI file in a configured connection, it automatically performs the following actions:
- Confirms that the information in the transaction set ISA headers matches the connection's partnership definition. If not, Stedi displays an error, and you can retry after creating the required configuration.
- Identifies all available transaction sets in the file and retrieves the associated guides, if specified in the partnership definition.
- Validates the incoming files either against the specified guide or the generic X12 base specification for the transaction set.
- Translates the EDI into EDI-like JSON that follows the schema of the transaction set.
- Persists a copy of the original EDI and the EDI-like JSON within its archive.
- Displays the transaction set data in the UI for inspection.
- Emits several events: one file.processed for the file, one functional_group.processed for each functional group, and one transaction.processed for each transaction set found within the file. Visit Events for details.
Outbound processing flow
When you use Core's Generate API or SDK to write EDI files, Core performs the following actions:
- Determines whether the information in the JSON payload matches existing profiles and whether those profiles have a partnership defined. If not, Stedi displays an error, and you can retry after creating the required configuration.
- Translates the JSON into an EDI document, according to the transaction settings defined in the associated partnership.
- Persists a copy of the JSON payload and resulting EDI file in its archive.
- Loads the associated connection configuration.
- Delivers the EDI file to the destination specified in the connection configuration.
- Displays the transaction set data in the UI for inspection after successful delivery.
- Emits multiple events: one
file.processed
for the file, onefunctional_group.processed
for each functional group, and onetransaction.processed
for each transaction set found within the file. Visit Events for details.
How Core handles invalid data
For example, if a file contained 100 transactions and 1 was invalid, Stedi would not process the 99 valid transaction sets until the single validation issue was addressed.
Integrating with external systems
Ingesting data from existing EDI systems
To get started, replicate your EDI data flow from the existing system to the Core ingest bucket. You can do this with the Stedi Buckets SDK or a single SFTP user configuration. Once configured, Core begins detecting and processing all incoming documents in real time.
As data arrives, you can build up profiles and partnerships to facilitate processing, allowing you to quickly build the required configuration for your production data flow and start to leverage other Stedi features.
Feedback
Have an idea for something we could improve? Page not clear? We love feedback - send us a message.