Skip to Content

EDI envelopes in Jitterbit EDI

Introduction

This section depicts the structure of X12 EDI ISA, GS, and ST envelope segments as tables, with the header row showing elements and delimiter characters (), and the first row the element's character width, or blank if unspecified.

Interchange control header/trailer (ISA/IEA)

The ISA segment is a positional or fixed length record. The ISA/IEA envelope is called the ISA envelope or interchange envelope. One per transmission is required. The Interchange Control Number element in the ISA and IEA segments (highlighted below) must be the same.

ISA Qualifier Sender 00 Security Qualifier Sender ID Qualifier Receiver ID Date Time U Version Interchange Control Number Flag T/P
3 1 2 1 10 1 2 1 10 1 2 1 15 1 2 1 15 1 6 1 4 1 1 1 5 1 9 1 1 1 1 1 1
IEA Number of Groups Interchange Control Number
3 1 1 9

Functional group header/trailer (GS/GE)

The GS/GE envelope is the group level, and groups documents by type and version. One is required per document type. There can be different groups in a single transmission. The Group Control Number element in the GS and GE segments (highlighted below) must be the same.

GS Document Type Sender ID Receiver ID Date (YYMMDD) Time (HHMM) Group Control Number Standard Version
2 1 2 1 1 1 6 1 4 1 1 1
GE Number of STs (Documents) Group Control Number
2 1 1

Transaction set header/trailer (ST/SE)

The ST/SE envelope is at the transaction set level. One is required for each document. The Transaction Control Number element in the ST and SE segments (highlighted below) must be the same.

ST Document Number Transaction Control Number
2 1 3 1 Minimum 4
SE Number of Segments Including ST and SE Transaction Control Number
2 1 1 Minimum 4

EDIFACT

The following is an example EDIFACT message. Lines 1 to 3 are described in more detail below.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
UNB+UNOC:3+SenderID+ReceiverID+230930:1200+1'
UNH+EDIFACTOrderMessage+ORDERS:D:93A:UN:1.0'
BGM+220+OrderNumber12345+9'
DTM+137:20231001:102'
RFF+ON:ReferenceNumber'
NAD+BY+BuyerID::16+BuyerName+BuyerAddress'
NAD+SE+SellerID::16+SellerName+SellerAddress'
CUX+2:USD'
LIN+1++ProductID123:IN'
PIA+1+ProductName:Product Description'
QTY+12:10'
UNT+12+EDIFACTOrderMessage'
UNZ+1+InterchangeControlReference'

  • UNB (Interchange Header)

    • UNOC: Character set (e.g., UNOC for ASCII).

    • 3: Syntax version number.

    • SenderID: Unique identifier for the sender.

    • ReceiverID: Unique identifier for the receiver.

    • 230930:1200: Date and time of the interchange (YYMMDD).

    • 1: Interchange control reference.

  • UNH (Message Header)

    • EDIFACTOrderMessage: Identifier for this specific message.

    • ORDERS: Message type (Order).

    • D:93A: Version and release.

    • UN:1.0: Agency and version.

  • BGM (Beginning of Message)

    • 220: Document message name (Order).

    • OrderNumber12345: Unique order number.

    • 9: Indicates a standard order.

TRADACOMS

The following is an example TRADACOMS message. Line 1 is described in more detail below.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
STX=ANAA:1+5000167000003:ABCCORP UK LTD+02-9050999992211:SUPPLIER NAME+180101:160101+01+PASSWORD+ORDHDR'
MHD=1+ORDHDR:9'
TYP=0430+NEW-ORDERS'
SDT=SUPPLIER GLN:VENDOR ACCOUNT NUMBER+SUPPLIER PLC+THE FACTORY:ANYSTREET:ANYTOWN:ANYSHIRE:AN1 9ZZ' CDT=5000167000078+BOOTS UK LIMITED+1 THANE ROAD WEST::NOTTINGHAM:GB:NG2 3AA+:GB116300129'
FIL=01+1+180101'
MTR=6'
MHD=2+ORDERS:9'
CLO=5000167100112:8100+STORES SERVICE CENTRE+HARRIMANS LANE::NOTTINGHAM:GB:NG7 2SD'
ORD=9907234567::180101++N'
DIN=180305'
OLD=1+5012345000015+5012345100012+:1364537+12+100+54000+++TOOTHBRUSH FIRM'
OLD=2+5012345000022+5012345100029+:1364541+12+100+54000+++TOOTHBRUSH MED'
OTR=2’
MTR=8'
MHD=3+ORDTLR:9'
OFT=1'
MTR=3'
MHD=4+RSGRSG:2'
RSG=01+SUPPLIER GLN'
MTR=3'
END=4'

  • STX Header Structure:

    • ANAA: Message type. In this case, it typically refers to an "Acknowledgment" or similar transaction type.

    • 1: Message format version. It helps ensure that both sender and receiver are using compatible formats.

    • 5000167000003: Sender information. This is a unique identifier for the sender (usually a code assigned by the trading partner or a standard body).

    • ABCCORP UK LTD: Receiver identification. This represents the name of the organization receiving the message. It provides clarity on who the intended recipient is.

    • 02-9050999992211: Contact information. This could be a phone number or another form of contact information related to the supplier or sender.

    • SUPPLIER NAME: Supplier identification. This could indicate the role or category of the sender, reinforcing that this entity is a supplier.