To streamline EDI data processing, centralizing the trading partner configurations with the
EDI profiles component, avoiding scattered configurations across flows, file definition rules, and mappings. This centralized approach reduces configuration time, minimizes errors, and offers a global view of EDI-related validations and values at the header level, allowing easy updates for specific trading partner configurations.
Note
The EDI profiles component is available if you have subscribed to EDI as part of the integrator.io license subscription.
-
Sign in to your integrator.io account.
-
From the left navigation, go to Resources > EDI profiles.
-
Or, you can access EDI profiles at the flow level by navigating to Integration > Flow > Flow Builder page > Export or Import bubbles > How would you like to parse files section > EDI profile. From the flow level, you can create or edit an EDI profile.
On the EDI profiles page, on the top-right, click Create EDI profile.
On the Create EDI profile window, in the General section, enter the appropriate details in the respective fields:
-
Name: This is a mandatory field. Enter a name for the EDI profile.
-
Description: Enter the description for the EDI profile.
-
EDI file type: This is a mandatory field and is non-editable. The field shows the EDI file type, currently, X12 is the file type supported
Note
The EDIFACT file type will be supported in one of the upcoming releases.
In this section, you can find the information on the permitted value for a given trading partner in the EDI enveloping section of a file.
Interchange identification
-
ISA01 (Authorization information qualifier): A code to identify the information type in the Authorization Qualifier. You can choose one option from the drop-down menu.
-
ISA02 (Authorization information): This is used for identifying the authorization code information about the interchange sender or the data in the interchange. Enter an appropriate value.
-
ISA03 (Security information qualifier): A code to identify the information type in the Security Information. You can choose one option from the drop-down menu.
-
ISA04 (Security information): This is used for identifying the security information about the interchange sender or the data in the interchange. This is used for identifying the security information about the interchange sender or the data in the interchange; the type of information is set by the Security Information Qualifier ISA03.
-
Trading Partner ID qualifier: A code indicating the system of code structure used to designate the Trading Partner ID element being qualified. This field is to be used as ISA05 for Inbound documents from Trading Partners for EDI Parsing and ISA07 for Outbound documents to Trading Partners for EDI generation.
-
Trading Partner interchange ID: An identification code published by the Trading Partner for other parties to use as the ID to exchange data. This field is to be used as ISA06 for Inbound documents from Trading Partners for EDI Parsing and ISA08 for Outbound documents to Trading Partners for EDI generation.
-
My ID qualifier: A code indicating the system of code structure used to designate the Trading Partner ID element being qualified. This field is to be used as ISA07 for Inbound documents from Trading Partners for EDI Parsing and ISA05 for Outbound documents to Trading Partners for EDI generation. You can choose one option from the drop-down menu.
-
My interchange ID: A code published for you for the other parties to use as the ID to exchange data. This field is to be used as ISA08 for Inbound documents from Trading Partners for EDI Parsing and ISA06 for Outbound documents to Trading Partners for EDI generation.
Interchange control information
-
ISA11 (Interchange standards ID): This field provides the delimiter used to separate repeated occurrences of a simple data element; this value must be different than the data element separator, component element separator, and segment terminator.
-
ISA12 (Interchange version number): A code specifying the version number of the interchange control segments.
-
ISA14 (Acknowledgement requested): A code indicating the sender's request for an interchange acknowledgment.
-
ISA15 (Usage indicator): A code to indicate whether data enclosed by this interchange envelope is test data or production data.
-
ISA16 (Component Element Separator): This field provides the delimiter used to separate component data elements. This value must be different from the data element separator and the segment terminator.
Group identification
-
Trading Partner group ID: An identification code published by the Trading Partner for other parties to use as the ID to exchange data. This field is used as GS02 for Inbound documents from Trading Partners and GS03 for Outbound documents to trading partners.
-
My group ID: An identification code published by Celigo’s customer for other parties to use as the ID to exchange data. This field is used as GS03 for Inbound documents from Trading Partners and GS02 for Outbound documents to trading partners.
-
GS07 (Responsible agency code): A code identifying the issuer of the standard, this code is used in conjunction with Data Element GS08. You can choose one option from the drop-down menu.
-
GS08 (Version): A code indicating the version, release, sublease, and industry identifier of the EDI standard being used
Control numbers
Control number sequence - Value: The control number, sequentially used in EDI messages for Interchange and Group level segments in fields ISA13, GS06, GE02, and IEA02, starts with a default value of '1'. This initial value is applied to the first EDI file, with each subsequent file's control number incrementing by 1. When the control number hits 999,999,999 (nine nines), it resets to the initially configured value by the user.
After you enter the details and click Save on the Create EDI profile window, a new entry is created on the EDI profiles page.
Note
The control number sequence is not supported for each document type.
For any flow, in the export or import bubbles, after you select the EDI file type as X12, the EDI profile option is enabled.
-
From the EDI profile drop-down menu, you can select an existing profile
-
You can create a new profile
-
You can edit an existing profile
Audit logs maintain a record of specific activities in your flows, including the fields that were changed, the type of change, and who’s responsible for the change. You can view your audit logs at a flow or EDI profile level. For more information, see View or download audit logs.
In integrator.io, on the EDI profile page, next to the appropriate profile, from the Actions overflow (…) menu select View audit log.
In audit logs, pageProcessors and pageGenerators represent imports and exports, respectively. It’s just a system naming convention that doesn’t affect your integrations or flows.
You can edit an already-created user profile. While editing an EDI profile, the EDI file can’t be edited.
In integrator.io, on the EDI profile page, next to the appropriate profile, from the Actions overflow (…) menu select Edit EDI profile.
After you edit the profile, on the EDI profiles page, the Last updated field will be updated with the latest timestamp.
Before executing the EDI profile at the flow level, you can preview the profile for validations. In integrator.io, on the Flow Builder page, from the export or import bubbles, after you select the Parser/Generation definition, click Launch to view the ‘EDI parser helper/generator’ Advanced Field Editor (AFE).
For the EDI parser helper and EDI generator, the EDI profile execution at the flow level is similar to that of the preview. When you open AFE, by default, the Auto preview is enabled and the EDI profile is executed.
-
In the EDI parser helper, the AFE must validate the EDI data received from the Trading partner and convert the data to a JSON format. The preview and Auto preview options are applicable for the execution of the EDI profiles.
-
In the EDI generator helper, the AFE must recognize the EDI profile selection from import replace the EDI data received from the Trading Partner and convert the data to a target ERP format. The preview and Auto preview options are applicable for the execution of the EDI profiles.
Comments
Please sign in to leave a comment.