EDI Structure Descriptor File Guide
Last updated
Was this helpful?
Last updated
Was this helpful?
The Structure Descriptor File defines how repeating EDI segments (e.g., N1–N4) are grouped into structured JSON. It ensures:
Accurate parsing of related elements as single units.
Consistent output for downstream systems.
For a full example with segment details, see .
Settings → Document Type → [Your Document (e.g., Purchase Order)] → E-Doc.
Under E-Doc, select your format (e.g., EDI ).
Click Structure Descriptor.
Create a Draft: Click the ✏️ pencil icon to begin editing.
Delete Drafts: Use the 🗑️ trashcan icon to remove unused drafts.
Activate Changes: Click the ✅ checkmark icon to approve and publish your changes.
Note: Activating a new version will automatically deactivate the previous one.
The Preview Function allows you to test and preview how an uploaded EDI file is parsed using the current Structure Descriptor File.
Upload an EDI file via the standard upload flow.
Copy the Document ID of the uploaded file.
Navigate to the Structure Descriptor File interface.
Open the Preview Function.
Enter the Document ID into the field and press Test.
The resulting structured XML output will be displayed.
This is especially useful for debugging mappings and validating structural groupings in real time.
A video guide for this file type is available on the Use it to follow along with setup, editing, and previewing.
