The UN/EDIFACT Interchange Envelop Structure – For all Woolworths EDI Implementations

The UN/EDIFACT Interchange Envelop Structure

For all Woolworths EDI Implementations

Public Release: March 7, 2002

Document Version: 1.2
Updated: August 26, 2002
Status: DRAFT

Based on EANCOM 1997 (UN/EDIFACT D.96A) 1

 The UN/EDIFACT Interchange Envelop Structure – For all Woolworths EDI Implementations

CONTENT
ABOUT THIS IMPLEMENTATION GUIDELINE ................................................................................................... 3
EDI MESSAGE FLOW ................................................................................................................................. 4
WOOLWORTHS INTERCHANGE ADDRESSES ................................................................................................. 5
DATA SEGMENT CLARIFICATION ................................................................................................................. 6
THE UN/EDIFACT ENVELOP STRUCTURE .................................................................................................. 7
MESSAGE EXAMPLE ................................................................................................................................. 15

Based on EANCOM 1997 (UN/EDIFACT D.96A) 2

 The UN/EDIFACT Interchange Envelop Structure – For all Woolworths EDI Implementations

About this Implementation Guideline

The B2B electronic commerce team is responsible for the specification of electronic data
interchanges within Woolworths. Before your company commences implementing this
message, it is vital that contact is made with the team to confirm specific data requirements
Woolworths has with your company.

For all other queries relating to this implementation, contact can be made to Joe Attard via
email at jattard@woolworths.com.au or by telephone at (02) 8732 5492.

Based on EANCOM 1997 (UN/EDIFACT D.96A) 3

 The UN/EDIFACT Interchange Envelop Structure – For all Woolworths EDI Implementations

EDI Message Flow

The following diagrams illustrate the flow of this message relative to the overall electronic
trading potentially conducted between Woolworths and your company.

For Distribution Centre Delivery (DC)

ORDERS
CONTRL

ORDRSP
CONTRL

For Direct Store Delivery (DSD)

ORDERS
CONTRL

For Financial Transactions

EFT

REMADV
CONTRL

Based on EANCOM 1997 (UN/EDIFACT D.96A) 4

 The UN/EDIFACT Interchange Envelop Structure – For all Woolworths EDI Implementations

Woolworths Interchange Addresses

Woolworths uses various EDI trading addresses for different implementation initiatives and purposes
such as planned roll-out for DSD (Direct Store Delivery), Programmed buying or Financial
Transactions, etc. The table below shows a list of trading addresses Woolworths currently use for
these purposes, however, we recommend that contact is made with Woolworths’ representative prior
to commencing your implementation to ensure a successful roll-out.

EDI Addresses Function Purpose

9300633025571 Distribution Centre Delivery – EANCOM 1997 Production
9300633025540 Distribution Centre Delivery – EANCOM 1997 Testing
9300633025595 Direct Store Delivery – EANCOM 1997 Production
9300633025601 Direct Store Delivery – EANCOM 1997 Testing
9300633025557 Distribution Centre Delivery – Limited use for X12 Messages Production

Based on EANCOM 1997 (UN/EDIFACT D.96A) 5

 The UN/EDIFACT Interchange Envelop Structure – For all Woolworths EDI Implementations

Data Segment Clarification

This section should be read in conjunction with the Segment Layout, which indicates mandatory,
conditional and repeating requirements.
The following guidelines and principles apply to the whole message and are intended to facilitate the
understanding and implementation of the message:
All specified dates/times specified in the message envelops (UNB & UNG) should be in the format
'YYMMDD/HHMM'. Dates/times specified within contents of individual messages are specified
according to business requirements of Woolworths and its trading community and may vary unless all
parties involved in the transaction agree that there is a functional requirement for an alternative format.
Conditional data that is not required in the message should not be included.

Notes
The segments are presented in the sequence in which they appear in the message. The segment or
segment group tag is followed by the Mandatory, Conditional indicator, the maximum number of
occurrences and the segment description.
Additionally, there are four types of status for data elements with a Conditional UN/EDIFACT status,
whether for simple, component or composite data elements. These are listed below and can be identified
when relevant by the following abbreviations:

The following convention will be used for the entire document, applicable to the usage of segment
groups, segments, composite and data elements:

Abbreviation Usage, Attribute Description

O Segment / data element defined as optional by standard specification but may be used in
this implementation, ie. at the sender’s discretion.
D Dependent – Segment usage depend on other segment / data element
M Mandatory – Required as triggering segment / data element
M/U Must Use – Required as specified
C Conditional – Data element used based on the conditions specified
Rec Recommended – Optional data segment / element used at the discretion of the sender and
is recommended to provide additional information complimentary to other elements in the
same context.
NR or Not Rec Not recommended for use for compliance with international standard guidelines.
X or N/U Segment / data element defined as optional by standard specification and are not required
for this Implementation.

Based on EANCOM 1997 (UN/EDIFACT D.96A) 6

 The UN/EDIFACT Interchange Envelop Structure – For all Woolworths EDI Implementations

The UN/EDIFACT Envelop Structure

United Nations - Electronic Data Interchange For Administration, Commerce and Transportation
Message Structure (UN/EDIFACT)

UNA Service string advice (definition of delimiters)

UNB Interchange header (message envelop)
UNG Functional group header (application routing) – Mutually agreed between parties
UNH Message header - First message

Message content (I.e. ORDERS)

UNT Message trailer - First message

UNH Message header - Second message

Message content (I.e. REMADV)

UNT Message trailer - Second message

UNE Functional group trailer – Mutually agreed between parties
UNZ Interchange trailer

Based on EANCOM 1997 (UN/EDIFACT D.96A) 7

 The UN/EDIFACT Interchange Envelop Structure – For all Woolworths EDI Implementations

Segment: UNA Service String Advice

Position:
Group:
Level: 0
Usage: Conditional
Max Use: 1
Purpose: To define the characters selected for use as delimiter and indicator in the rest
of the interchange that follows. The specifications in the Service string advice
take precedence over the specifications for delimiter etc. in UNB segment.
When transmitted, the Service string advice must appear immediately before
the Interchange Header (UNB) segment and begin with the upper case
characters UNA immediately followed by the six characters selected by the
sender to indicate, in sequence, the following functions:
Notes: Example:

UNA:+.? '

Data Element Summary

Data Component
Element Element Name Attributes
M 0010 COMPONENT DATA ELEMENT SEPARATOR M an..1
Composite element delimiter
: Colon
M 0020 DATA ELEMENT SEPARATOR M an..1
Data element delimiter
+ Plus sign
M 0030 DECIMAL NOTATION M an..1
The character transferred in this position shall be ignored by the
recipient. Retained to maintain upward compatibility with earlier
versions of the syntax.
. Full stop / Period
M 0040 RELEASE INDICATOR M an..1
Release indicator is used to signify that the following texts contain one
of the characters used as composite, data or segment delimiter, hence
release its usage convention for that instance.
? Question mark
M 0050 RESERVED FOR FUTURE USE M an..1
Insert space character use All valid standard codes are used.
White space (blank)
M 0060 SEGMENT TERMINATOR M an..1
Used to delimit the end of the current segment and start a new segment
‘ Apostrophe

Based on EANCOM 1997 (UN/EDIFACT D.96A) 8

 The UN/EDIFACT Interchange Envelop Structure – For all Woolworths EDI Implementations

UNB Interchange Header

Position: 0010
Group:
Level: 0
Usage: Mandatory
Max Use: 1
Purpose: To start, identify and specify an interchange
Comments:
Notes: Example:

UNB+UNOA:3+9300633025540:ZZ+9311658000001:ZZ+020219:0705+98761'

Data Element Summary

Data Component
Element Element Name Attributes
M S001 SYNTAX IDENTIFIER M
Identification of the agency controlling the syntax and indication of
syntax level.
M 0001 Syntax identifier M a4
Coded identification of the agency controlling a syntax and syntax level
used in an interchange.
UNOA UN/ECE level A
M 0002 Syntax version number M n1
Version number of the syntax identified in the syntax identifier (0001).
3 Syntax Version Number
M S002 INTERCHANGE SENDER M
Identification of the sender of the interchange.
M 0004 Sender identification M an..35
Name or coded representation of the sender of a data interchange.
The following interchange addresses are used for all exchanges with
Woolworths:

For Distribution Centre Delivery:

9300633025540 - Messages exchanged in test mode
9300633025571 - Messages exchanged in production

For Ditect Store Delivery:

9300633025601 - Messages exchanged in test mode
9300633025595 - Messages exchanged in production

O 0007 Partner identification code qualifier C an..4

X 0008
M S003
M 0010
O 0007
Qualifier referring to the source of codes for the identifiers of
interchanging partners.
ZZ Mutually defined
Address for reverse routing C an..14
Address specified by the sender of an interchange to be included by the
recipient in the response interchanges to facilitate internal routing.
INTERCHANGE RECIPIENT M
Identification of the recipient of the interchange.
Recipient identification M an..35
Name or coded representation of the recipient of a data interchange.
Partner identification code qualifier C an..4
Qualifier referring to the source of codes for the identifiers of
interchanging partners.
ZZ Mutually defined

Based on EANCOM 1997 (UN/EDIFACT D.96A) 9

 The UN/EDIFACT Interchange Envelop Structure – For all Woolworths EDI Implementations
X 0014
M S004
M 0017
M 0019
M 0020
X S005
X 0022
X 0025
X 0026
X 0029
X 0031
X 0032
O 0035
Based on EANCOM 1997 (UN/EDIFACT D.96A)
Routing address C an..14
Address specified by the recipient of an interchange to be included by
the sender and used by the recipient for routing of received
interchanges inside his organization.
DATE AND TIME OF PREPARATION M
Date and time of preparation of the interchange.
Date of preparation M n6
Local date when an interchange or a functional group was prepared.
Date in YYMMDD format, Eg. March 7th, 2002 is presented as 020307
Time of preparation M n4
Local time of day when an interchange or a functional group was
prepared.
Time in 24 hour-clock format, Eg. 3:30 PM is presented as 1530
INTERCHANGE CONTROL REFERENCE M an..14
Unique reference assigned by the sender to an interchange.
Same as UNZ02 DE 0020
RECIPIENTS REFERENCE PASSWORD C
Reference or password as agreed between the communicating
partners.
Recipient reference/password M an..14
Unique reference assigned by the recipient to the data interchange or a
password to the recipient's system or to a third party network as
specified in the partners interchange agreement.
Recipient reference/password qualifier C an2
Qualifier for the recipient's reference or password.
APPLICATION REFERENCE C an..14
Identification of the application area assigned by the sender, to which
the messages in the interchange relate e.g. the message identifier if all
the messages in the interchange are of the same type.
PROCESSING PRIORITY CODE C a1
Code determined by the sender requesting processing priority for the
interchange.
ACKNOWLEDGEMENT REQUEST C n1
Code determined by the sender for acknowledgement of the
interchange.
COMMUNICATIONS AGREEMENT ID C an..35
Identification by name or code of the type of agreement under which the
interchange takes place.
TEST INDICATOR C n1
Indication that the interchange is a test.
As individual addresses are used for each exchange mode for test or
production, this element is not used for this implementation
10
 The UN/EDIFACT Interchange Envelop Structure – For all Woolworths EDI Implementations

Segment: UNG Functional Group Header

Position: 0020
Group:
Level: 0
Usage: Optional (Optional)
Max Use: 1
Purpose: To head, identify and specify a Functional Group
Comments:
Notes: For messages generated by Woolworths, the functional group UNG - UNE is
provided upon request from vendors.

For all messages generated from Woolworths system with UNG - UNE
segments, all messages returned to Woolworths from vendors are expected to
include the equivalent UNG - UNE segments. This does not apply to the Syntax
and Report (CONTRL) message.

Example:

UNG+ORDRSP+930063302554:ZZ+931165800000:ZZ+020219:0705+31715+U
N+D:96A:EAN005

Data Element Summary

Data Component
Element Element Name Attributes
M 0038 FUNCTIONAL GROUP IDENTIFICATION M an..6
Identification of the one type of messages in a functional group.
M S006 APPLICATION SENDER IDENTIFICATION M
Identification of the sender's division, department etc. from which a
group of messages is sent.
M 0040 Application sender identification M an..35
Name or code identifying the originating division, department etc. within
the sender's organization.
O 0007 Partner identification code qualifier C an..4
Qualifier referring to the source of codes for the identifiers of
interchanging partners.
ZZ Mutually defined
M S007 APPLICATION RECIPIENTS IDENTIFICATION M
Identification of the recipient's division, department etc. for which a
group of messages is intended.
M 0044 Application recipient's identification M an..35
Name or code identifying the division, department etc. within the
recipient's organization for which the group of messages is intended.
O 0007 Partner identification code qualifier C an..4
Qualifier referring to the source of codes for the identifiers of
interchanging partners.
ZZ Mutually defined
M S004 DATE AND TIME OF PREPARATION M
Date and time of preparation of the interchange.
M 0017 Date of preparation M n6
Local date when an interchange or a functional group was prepared.
M 0019 Time of preparation M n4
Local time of day when an interchange or a functional group was
prepared.
M 0048 FUNCTIONAL GROUP REFERENCE NUMBER M an..14
Reference number for the functional group assigned by and unique
within the sender's division, department etc.

Based on EANCOM 1997 (UN/EDIFACT D.96A) 11

 The UN/EDIFACT Interchange Envelop Structure – For all Woolworths EDI Implementations
M 0051
M S008
M 0052
M 0054
O 0057
X 0058
Based on EANCOM 1997 (UN/EDIFACT D.96A)
Same as UNE02 DE 0048
CONTROLLING AGENCY M an..2
Code identifying the agency controlling the specification, maintenance
and publication of the message type.
UN UN/ECE/TRADE/WP.4, United Nations Standard
Messages (UNSM)
MESSAGE VERSION M
Specification of the type of messages in the functional group.
Message type version number M an..3
Version number of a message type.
D Draft Directory
Message type release number M an..3
Release number within the current message type version number
(0052).
96A Directory Version
Association assigned code C an..6
Code, assigned by the association responsible for the design and
maintenance of the message type concerned, which further identifies
the message.
EAN002 Version Control Number for CONTRL
EAN003 Version Control Number for REMADV
EAN005 Version Control Number for ORDRSP
EAN008 Version Control Number for ORDERS
APPLICATION PASSWORD C an..14
Password to the recipient's division, department or sectional system.
12
 The UN/EDIFACT Interchange Envelop Structure – For all Woolworths EDI Implementations

Segment: UNE Functional Group Trailer

Position: 0030
Group:
Level: 0
Usage: Conditional (Optional)
Max Use: 1
Purpose: To end and check the completeness of a Functional Group
Comments:
Notes: For messages generated by Woolworths, the functional group UNG - UNE is
provided upon request from vendors.

For all messages generated from Woolworths system with UNG - UNE
segments, all messages returned to Woolworths from vendors are expected to
include the equivalent UNG - UNE segments. This does not apply to the Syntax
and Report (CONTRL) message.

Example:

UNE+1+31715'

Data Element Summary

Data Component
Element Element Name Attributes
M 0060 NUMBER OF MESSAGES M n..6
A count of the number of messages in a functional group.
M 0048 FUNCTIONAL GROUP REFERENCE NUMBER M an..14
Reference number for the functional group assigned by and unique
within the sender's division, department etc.
Same as UNG05 DE 0048

Based on EANCOM 1997 (UN/EDIFACT D.96A) 13

 The UN/EDIFACT Interchange Envelop Structure – For all Woolworths EDI Implementations

Segment: UNZ Interchange Trailer

Position: 0040
Group:
Level: 0
Usage: Mandatory
Max Use: 1
Purpose: To end and check the completeness of an interchange.
Comments:
Notes: Example:

UNZ+1+98761'

Data Element Summary

Data Component
Element Element Name Attributes
M 0036 INTERCHANGE CONTROL COUNT M n..6
Count either of the number of messages or, if used, of the number of
functional groups in an interchange.
M 0020 INTERCHANGE CONTROL REFERENCE M an..14
Unique reference assigned by the sender to an interchange.
Same as UNB05 DE 0020

Based on EANCOM 1997 (UN/EDIFACT D.96A) 14

 The UN/EDIFACT Interchange Envelop Structure – For all Woolworths EDI Implementations

Message Example
The following example contains sample data to illustrate the document structure and syntax to be
used for the implementation of this message only.

UNA:+.? '
UNB+UNOA:3+WOOLWORTHS_ID:ZZ+VENDOR_ID:ZZ+020218:0901+40358'
UNG+ORDERS+WOOLWORTHS_APP:ZZ+VENDOR_APP:ZZ+020218:0901+0001+UN+D:96A:
EAN008'
UNH+1+ORDERS:D:96A:UN:EAN008' Optional UNG – UNE functional
BGM+231+92395353+29' group only required if presented in
: Woolworths ORDERS message
:
:
CNT+1:162'
CNT+2:5'
UNT+12+1'

UNH+2+ORDERS:D:96A:UN:EAN008'
BGM+231+92395366+29'
:
:
:
CNT+1:96’
CNT+2:4’
UNT+12+2'

UNH+3+ORDERS:D:96A:UN:EAN008'
Optional UNG – UNE functional
BGM+231+92395498+29' group only required if presented in
: Woolworths ORDERS message. The
: UNE segment indicates that this
: group (0001) contains 3 messages.
CNT+1:1040'
CNT+2:12'
UNT+12+3'
UNE+3+0001'
UNZ+1+40358'

Based on EANCOM 1997 (UN/EDIFACT D.96A) 15