AT&T
/
Ship Notice/Manifest
  • Specification
  • EDI Inspector
Import guide into your account
Stedi maintains this guide based on public documentation from AT&T. Contact AT&T for official EDI specifications. To report any errors in this guide, please contact us.
Go to Stedi Network
AT&T logo

X12 856 Ship Notice/Manifest

X12 Release 4010

This Draft Standard for Trial Use contains the format and establishes the data contents of the Ship Notice/Manifest Transaction Set (856) for use within the context of an Electronic Data Interchange (EDI) environment. The transaction set can be used to list the contents of a shipment of goods as well as additional information relating to the shipment, such as order information, product description, physical characteristics, type of packaging, marking, carrier information, and configuration of goods within the transportation equipment. The transaction set enables the sender to describe the contents and configuration of a shipment in various levels of detail and provides an ordered flexibility to convey information.

The sender of this transaction is the organization responsible for detailing and communicating the contents of a shipment, or shipments, to one or more receivers of the transaction set. The receiver of this transaction set can be any organization having an interest in the contents of a shipment or information about the contents of a shipment.

Delimiters
  • ~ Segment
  • * Element
  • > Component
EDI samples
  • None included
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/at-t/ship-noticemanifest/01H2WZVE0N52VW5B68P4CSZBVC
Powered by
Build EDI implementation guides at stedi.com
Overview
ISA
-
Interchange Control Header
Max use 1
Required
GS
-
Functional Group Header
Max use 1
Required
heading
detail
HL Loop
HL
010
Hierarchical Level
Max use 1
Required
TD1
110
Carrier Details (Quantity and Weight)
Max use 20
Optional
TD5
120
Carrier Details (Routing Sequence/Transit Time)
Max use 12
Optional
TD3
130
Carrier Details (Equipment)
Max use 12
Optional
REF
150
Buyer Identification
Max use 1
Required
REF
150
References
Max use 1
Optional
HL Loop
HL
010
Hierarchical Level
Max use 1
Required
PRF
050
Purchase Order Reference
Max use 1
Optional
REF
150
Reference Identification
Max use 1
Optional
HL Loop Item
GE
-
Functional Group Trailer
Max use 1
Required
IEA
-
Interchange Control Trailer
Max use 1
Required
ISA

Interchange Control Header

RequiredMax use 1

To start and identify an interchange of zero or more functional groups and interchange-related control segments

Example
ISA-01
I01
Authorization Information Qualifier
Required
Identifier (ID)

Code to identify the type of information in the Authorization Information

00
No Authorization Information Present (No Meaningful Information in I02)
ISA-02
I02
Authorization Information
Required
String (AN)
Min 10Max 10

Information used for additional identification or authorization of the interchange sender or the data in the interchange; the type of information is set by the Authorization Information Qualifier (I01)

ISA-03
I03
Security Information Qualifier
Required
Identifier (ID)

Code to identify the type of information in the Security Information

00
No Security Information Present (No Meaningful Information in I04)
ISA-04
I04
Security Information
Required
String (AN)
Min 10Max 10

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 (I03)

ISA-05
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2

Qualifier to designate the system/method of code structure used to designate the sender or receiver ID element being qualified

Codes
ISA-06
I06
Interchange Sender ID
Required
String (AN)
Min 15Max 15

Identification code published by the sender for other parties to use as the receiver ID to route data to them; the sender always codes this value in the sender ID element

ISA-07
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2

Qualifier to designate the system/method of code structure used to designate the sender or receiver ID element being qualified

Codes
ISA-08
I07
Interchange Receiver ID
Required
String (AN)
Min 15Max 15

Identification code published by the receiver of the data; When sending, it is used by the sender as their sending ID, thus other parties sending to them will use this as a receiving ID to route data to them

ISA-09
I08
Interchange Date
Required
Date (DT)
YYMMDD format

Date of the interchange

ISA-10
I09
Interchange Time
Required
Time (TM)
HHMM format

Time of the interchange

ISA-11
I10
Interchange Control Standards Identifier
Required
Identifier (ID)

Code to identify the agency responsible for the control standard used by the message that is enclosed by the interchange header and trailer

U
U.S. EDI Community of ASC X12, TDCC, and UCS
ISA-12
I11
Interchange Control Version Number
Required
Identifier (ID)

This version number covers the interchange control segments

00401
Draft Standards for Trial Use Approved for Publication by ASC X12 Procedures Review Board through October 1997
ISA-13
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9

A control number assigned by the interchange sender

ISA-14
I13
Acknowledgment Requested
Required
Identifier (ID)
Min 1Max 1

Code sent by the sender to request an interchange acknowledgment (TA1)

0
No Acknowledgment Requested
1
Interchange Acknowledgment Requested
ISA-15
I14
Usage Indicator
Required
Identifier (ID)
Min 1Max 1

Code to indicate whether data enclosed by this interchange envelope is test, production or information

I
Information
P
Production Data
T
Test Data
ISA-16
I15
Component Element Separator
Required
String (AN)
Min 1Max 1

Type is not applicable; the component element separator is a delimiter and not a data element; this field provides the delimiter used to separate component data elements within a composite data structure; this value must be different than the data element separator and the segment terminator

>
Component Element Separator

Functional Group Header

RequiredMax use 1

To indicate the beginning of a functional group and to provide control information

Example
GS-01
479
Functional Identifier Code
Required
Identifier (ID)

Code identifying a group of application related transaction sets

SH
Ship Notice/Manifest (856)
GS-02
142
Application Sender's Code
Required
String (AN)
Min 2Max 15

Code identifying party sending transmission; codes agreed to by trading partners

GS-03
124
Application Receiver's Code
Required
String (AN)
Min 2Max 15

Code identifying party receiving transmission. Codes agreed to by trading partners

GS-04
373
Date
Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

GS-05
337
Time
Required
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format

Time expressed in 24-hour clock time as follows: HHMM, or HHMMSS, or HHMMSSD, or HHMMSSDD, where H = hours (00-23), M = minutes (00-59), S = integer seconds (00-59) and DD = decimal seconds; decimal seconds are expressed as follows: D = tenths (0-9) and DD = hundredths (00-99)

GS-06
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Assigned number originated and maintained by the sender

GS-07
455
Responsible Agency Code
Required
Identifier (ID)
Min 1Max 2

Code used in conjunction with Data Element 480 to identify the issuer of the standard

T
Transportation Data Coordinating Committee (TDCC)
X
Accredited Standards Committee X12
GS-08
480
Version / Release / Industry Identifier Code
Required
String (AN)

Code indicating the version, release, subrelease, and industry identifier of the EDI standard being used, including the GS and GE segments; if code in DE455 in GS segment is X, then in DE 480 positions 1-3 are the version number; positions 4-6 are the release and subrelease, level of the version; and positions 7-12 are the industry or trade association identifiers (optionally assigned by user); if code in DE455 in GS segment is T, then other formats are allowed

004010
Draft Standards Approved for Publication by ASC X12 Procedures Review Board through October 1997

Heading

ST
010
Heading > ST

Transaction Set Header

RequiredMax use 1

To indicate the start of a transaction set and to assign a control number

Example
ST-01
143
Transaction Set Identifier Code
Required
Identifier (ID)

Code uniquely identifying a Transaction Set

  • The transaction set identifier (ST01) used by the translation routines of the interchange partners to select the appropriate transaction set definition (e.g., 810 selects the Invoice Transaction Set).
856
Ship Notice/Manifest
ST-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9

Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set

BSN
020
Heading > BSN

Beginning Segment for Ship Notice

RequiredMax use 1

To transmit identifying numbers, dates, and other basic data relating to the transaction set

Usage notes

Sample EDI:
BSN0099999999200701011022*0002~

Example
BSN-01
353
Transaction Set Purpose Code
Required
Identifier (ID)

Code identifying purpose of transaction set

00
Original
BSN-02
396
Shipment Identification
Required
String (AN)
Min 2Max 30

A unique control number assigned by the original shipper to identify a specific shipment

BSN-03
373
Date
Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • BSN03 is the date the shipment transaction set is created.
Usage notes

Creation/Transaction Date

BSN-04
337
Time
Required
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format

Time expressed in 24-hour clock time as follows: HHMM, or HHMMSS, or HHMMSSD, or HHMMSSDD, where H = hours (00-23), M = minutes (00-59), S = integer seconds (00-59) and DD = decimal seconds; decimal seconds are expressed as follows: D = tenths (0-9) and DD = hundredths (00-99)

  • BSN04 is the time the shipment transaction set is created.
BSN-05
1005
Hierarchical Structure Code
Optional
Identifier (ID)

Code indicating the hierarchical application structure of a transaction set that utilizes the HL segment to define the structure of the transaction set

0001
Shipment, Order, Packaging, Item
0002
Shipment, Order, Item, Packaging
DTM
040
Heading > DTM

Estimated Delivery

OptionalMax use 1

To specify pertinent dates and times

Usage notes

Mandatory for For Warehouse Shipments

Sample EDI:
DTM01720051105~

Example
Variants (all may be used)
DTMShipped
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)

Code specifying type of date or time, or both date and time

017
Estimated Delivery
DTM-02
373
Date
Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

DTM
040
Heading > DTM

Shipped

RequiredMax use 1

To specify pertinent dates and times

Usage notes

Sample EDI:
DTM01120051101~

Example
Variants (all may be used)
DTMEstimated Delivery
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)

Code specifying type of date or time, or both date and time

011
Shipped
DTM-02
373
Date
Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

Heading end

Detail

HL Loop
RequiredMax >1
HL
010
Detail > HL Loop > HL

Hierarchical Level

RequiredMax use 1

To identify dependencies among and the content of hierarchically related groups of data segments

  • The HL segment is the only mandatory segment within the HL loop, and by itself, the HL segment has no meaning.
Example
HL-01
628
Hierarchical ID Number
Required
String (AN)
Min 1Max 12

A unique number assigned by the sender to identify a particular data segment in a hierarchical structure

  • HL01 shall contain a unique alphanumeric number for each occurrence of the HL segment in the transaction set. For example, HL01 could be used to indicate the number of occurrences of the HL segment, in which case the value of HL01 would be "1" for the initial HL segment and would be incremented by one in each subsequent HL segment within the transaction.
HL-03
735
Hierarchical Level Code
Required
Identifier (ID)

Code defining the characteristic of a level in a hierarchical structure

  • HL03 indicates the context of the series of segments following the current HL segment up to the next occurrence of an HL segment in the transaction. For example, HL03 is used to indicate that subsequent segments in the HL loop form a logical grouping of data referring to shipment, order, or item-level information.
S
Shipment
HL-04
736
Hierarchical Child Code
Optional
Identifier (ID)

Code indicating if there are hierarchical child data segments subordinate to the level being described

  • HL04 indicates whether or not there are subordinate (or child) HL segments related to the current HL segment.
1
Additional Subordinate HL Data Segment in This Hierarchical Structure.
TD1
110
Detail > HL Loop > TD1

Carrier Details (Quantity and Weight)

OptionalMax use 20

To specify the transportation details relative to commodity, weight, and quantity

Usage notes

The TD1 segment is Mandatory for all direct to warehouse shipments.

Scenario #1: Product is shipped to warehouse on Pallets.
*****One TD101 with PLTxx qualifier and TD102 with total number of pallets in the shipment.
*****One TD101 with CTNxx qualifier and TD102 with total number of cartons/cases in the shipment.
Scenario #2: Product is shipped to warehouse in cartons only (No Pallets but in a Master Carton).
*****One TD101 with PLTxx qualifier and TD102 with total number of Master Cartons in the shipment.
*****One TD101 with CTNxx qualifier and TD102 with total number of cartons/cases in the shipment.
**If the shipment is a Return that is shipped directly to the consumer/End-User, the TD1 segment is not required.

========================
Non-Warehouse Shipments:
This segment is not Mandatory for Non-Warehouse Shipments.

Sample EDI:
For TL, LTL, Small Parcel shipments (i.e. FedEx, DHL, UPS, etc.):
TD1PLT9410*G8000*LB~
TD1
CTN25
250***G7750*LB~

Example
TD1-01
103
Packaging Code
Optional
String (AN)

Code identifying the type of packaging; Part 1: Packaging Form, Part 2: Packaging Material; if the Data Element is used, then Part 1 is always required

Usage notes

Warehouse Shipments:
The TD101 is a composite element so the "PLT" and "94" will be sent as “PLT94”.
The TD101 is a composite element so the "CTN" and "25" will be sent as “CTN25”.

Part 1/2
CTN
Carton
PLT
Pallet
Part 2/2
25
Corrugated or Solid
76
Paper
79
Plastic
91
Stainless Steel
94
Wood
TD1-02
80
Lading Quantity
Required
Numeric (N0)
Min 1Max 7

Number of units (pieces) of the lading commodity

TD1-06
187
Weight Qualifier
Required
Identifier (ID)

Code defining the type of weight

G
Gross Weight
TD1-07
81
Weight
Required
Decimal number (R)
Min 1Max 10

Numeric value of weight

Usage notes

You will send the total gross weight for the appropriate TD1 segment. There are two TD1 segments required if you are shipping on a pallet or in a Master Carton. The PLT will be all cartons on the pallets + the pallet/Master Carton weight.

The CTN iteration of the TD1 will contain the total gross weight for all cartons in the shipment (does not include the pallets).

TD1-08
355
Unit or Basis for Measurement Code
Required
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

LB
Pound
TD5
120
Detail > HL Loop > TD5

Carrier Details (Routing Sequence/Transit Time)

OptionalMax use 12

To specify the carrier and sequence of routing and provide transit time information

Usage notes

This segment is not Mandatory for Non-Warehouse Shipments.

Sample EDI:
TD5B2XXXXM*Shipper Name~

Example
TD5-01
133
Routing Sequence Code
Required
Identifier (ID)

Code describing the relationship of a carrier to a specific shipment movement

B
Origin/Delivery Carrier (Any Mode)
TD5-02
66
Identification Code Qualifier
Required
Identifier (ID)

Code designating the system/method of code structure used for Identification Code (67)

  • When specifying a routing sequence to be used for the shipment movement in lieu of specifying each carrier within the movement, use TD502 to identify the party responsible for defining the routing sequence, and use TD503 to identify the actual routing sequence, specified by the party identified in TD502.
2
Standard Carrier Alpha Code (SCAC)
TD5-03
67
Identification Code
Required
String (AN)
Min 2Max 80

Code identifying a party or other code

Usage notes

The SCAC must be a valid SCAC code for the Transportation industry.

TD5-04
91
Transportation Method/Type Code
Optional
Identifier (ID)

Code specifying the method or type of transportation for the shipment

M
Motor (Common Carrier)
TD5-05
387
Routing
Optional
String (AN)
Min 1Max 35

Free-form description of the routing or requested routing for shipment, or the originating carrier's identity

TD3
130
Detail > HL Loop > TD3

Carrier Details (Equipment)

OptionalMax use 12

To specify transportation details relating to the equipment used by the carrier

Usage notes
# Warehouse Shipments:
Only one TD3 per EDI 856 transaction. Each TL (Truckload) or LTL (Less than Truckload) trailer must have an individual
**** The TD3 segment is Required for TL and LTL shipments. The TD3 is Optional for Small Parcel shipments.

Non-Warehouse Shipments:
This segment is not Mandatory for Non-Warehouse Shipments.

Sample EDI:
For TL or LTL shipments:
TD3TLXXX*1234567890~

Example
TD3-01
40
Equipment Description Code
Required
Identifier (ID)

Code identifying type of equipment used for shipment

TL
Trailer (not otherwise specified)
TD3-02
206
Equipment Initial
Required
String (AN)
Min 1Max 4

Prefix or alphabetic part of an equipment unit's identifying number

Usage notes

The AT&T Mobility 3 position Alpha Vendor Code will be provided to the Vendor by the Account Representative. The Vendor Code will be used to ensure a unique Truck Number is used in the Warehouse Management System.

TD3-03
207
Equipment Number
Required
String (AN)
Min 1Max 10

Sequencing or serial part of an equipment unit's identifying number (pure numeric form for equipment number is preferred)

Usage notes

This is the Truck Number that is used to uniquely identify the truck.

REF
150
Detail > HL Loop > REF

Buyer Identification

RequiredMax use 1

To specify identifying information

Usage notes

The REF*YD segment is Mandatory.
The YD qualifier is a reference field used for Wireless and Wireline Shipments.

# Wireless Shipment:

Valid examples for the REFYD:
REF
YDSERIALIZED~
REF
YDNON-SERIALIZED~
REF
YD*MIXED~
MIXED shipment should contain SERIALIZED and NON-SERIALIZED items at the Item level.

SERIALIZED items are items that require the HL*K loop, which communicates all serialized infromation, such as IMEI, Unlock Code, etc.

# Wireline Shipment:
# Valid examples for the REFYD:
REF
YDWIRELINE~
WIRELINE items require the HL
K loop, which communicates all serialized infromation, such as Serial Number, MAC Address, etc.
Only one REF*YD segment is expected at the Shipment level.

Non-Warehouse Orders:
REFYDNON-WAREHOUSE~

Example
Variants (all may be used)
REFReferences
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

YD
Buyer Identification
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 30

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

Usage notes

Supplier Number - Identifier for the supplier. Assigned by AT&T Mobility. Contact the AT&T Mobility Buyer or Account Representative to obtain the correct Supplier Number.

REF
150
Detail > HL Loop > REF

References

OptionalMax use >1

To specify identifying information

Usage notes
# Warehouse Shipments:
REFBM segment is Mandatory.
REF
CN segment is Optional.
REF*ZA segment is Mandatory.

Non-Warehouse Shipments:
REFBM segment is Optional.
REF
CN segment is Optional.
REF*ZA segment is Optional.

Sample EDI:
Warehouse Orders:
REFBM123456789~
REFCN1234567890~
REFZASUPPLIER NUMBER~

Example
Variants (all may be used)
REFBuyer Identification
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

BM
Bill of Lading Number
CN
Carrier's Reference Number (PRO/Invoice)
ZA
Supplier

Supplier Number - Identifier for the supplier. Assigned by AT&T Mobility. Contact the AT&T Mobility Buyer or Account Representative to obtain the correct Supplier Number.

REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 30

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

N1 Loop
RequiredMax >1
N1
220
Detail > HL Loop > N1 Loop > N1

Name

RequiredMax use 1

To identify a party by type of organization, name, and code

Usage notes
# Sample EDI:
Warehouse Shipments:
N1STMEMPHIS DISTRIBUTION CENTER9210107048~

Non-Warehouse Shipments:
N1STNON-WAREHOUSE SHIPMENT9299999999~

Example
N1-01
98
Entity Identifier Code
Required
Identifier (ID)

Code identifying an organizational entity, a physical location, property or an individual

ST
Ship To
N1-02
93
Name
Required
String (AN)

Free-form name

FORT WORTH DISTRIBUTION CENTER

for Warehouse Shipments

MEMPHIS DISTRIBUTION CENTER

for Warehouse Shipments

NON-WAREHOUSE SHIPMENT

for Non-Warehouse Shipments

N1-03
66
Identification Code Qualifier
Required
Identifier (ID)

Code designating the system/method of code structure used for Identification Code (67)

92
Assigned by Buyer or Buyer's Agent
N1-04
67
Identification Code
Required
String (AN)

Code identifying a party or other code

  • This segment, used alone, provides the most efficient method of providing organizational identification. To obtain this efficiency the "ID Code" (N104) must provide a key to the table maintained by the transaction processing party.
10107048
Memphis Distribution Center

for Warehouse Shipments

10110146
Ft. Worth Distribution Center

for Warehouse Shipments

99999999
Non-Warehouse Shipments
N3
240
Detail > HL Loop > N1 Loop > N3

Address Information

OptionalMax use 2

To specify the location of the named party

Usage notes
# Sample EDI:
Warehouse Shipments:
N3Address Line 1Address Line 2~
N3Address Line 3Address Line 4~

Non-Warehouse Shipments:
This segment is not Mandatory for Non-Warehouse Shipments.

Example
N3-01
166
Address Information
Required
String (AN)
Min 1Max 55

Address information

N3-02
166
Address Information
Optional
String (AN)
Min 1Max 55

Address information

N4
250
Detail > HL Loop > N1 Loop > N4

Geographic Location

OptionalMax use 1

To specify the geographic place of the named party

Usage notes
# Sample EDI:
Warehouse Shipments:
N4ANY CITYGA00000US~

Non-Warehouse Shipments:
This segment is not Mandatory for Non-Warehouse Shipments.

Example
N4-01
19
City Name
Optional
String (AN)
Min 2Max 30

Free-form text for city name

  • A combination of either N401 through N404, or N405 and N406 may be adequate to specify a location.
N4-02
156
State or Province Code
Optional
Identifier (ID)
Min 2Max 2

Code (Standard State/Province) as defined by appropriate government agency

  • N402 is required only if city name (N401) is in the U.S. or Canada.
N4-03
116
Postal Code
Optional
Identifier (ID)
Min 3Max 15

Code defining international postal zone code excluding punctuation and blanks (zip code for United States)

N4-04
26
Country Code
Optional
Identifier (ID)
Min 2Max 3

Code identifying the country

N1 Loop end
HL Loop
RequiredMax >1
HL
010
Detail > HL Loop > HL Loop > HL

Hierarchical Level

RequiredMax use 1

To identify dependencies among and the content of hierarchically related groups of data segments

  • The HL segment is the only mandatory segment within the HL loop, and by itself, the HL segment has no meaning.
Example
HL-01
628
Hierarchical ID Number
Required
String (AN)
Min 1Max 12

A unique number assigned by the sender to identify a particular data segment in a hierarchical structure

  • HL01 shall contain a unique alphanumeric number for each occurrence of the HL segment in the transaction set. For example, HL01 could be used to indicate the number of occurrences of the HL segment, in which case the value of HL01 would be "1" for the initial HL segment and would be incremented by one in each subsequent HL segment within the transaction.
HL-02
734
Hierarchical Parent ID Number
Required
String (AN)
Min 1Max 12

Identification number of the next higher hierarchical data segment that the data segment being described is subordinate to

  • HL02 identifies the hierarchical ID number of the HL segment to which the current HL segment is subordinate.
HL-03
735
Hierarchical Level Code
Required
Identifier (ID)

Code defining the characteristic of a level in a hierarchical structure

  • HL03 indicates the context of the series of segments following the current HL segment up to the next occurrence of an HL segment in the transaction. For example, HL03 is used to indicate that subsequent segments in the HL loop form a logical grouping of data referring to shipment, order, or item-level information.
O
Order
HL-04
736
Hierarchical Child Code
Optional
Identifier (ID)

Code indicating if there are hierarchical child data segments subordinate to the level being described

  • HL04 indicates whether or not there are subordinate (or child) HL segments related to the current HL segment.
0
No Subordinate HL Segment in This Hierarchical Structure.
1
Additional Subordinate HL Data Segment in This Hierarchical Structure.
PRF
050
Detail > HL Loop > HL Loop > PRF

Purchase Order Reference

OptionalMax use 1

To provide reference to a specific purchase order

Usage notes
# Warehouse Shipments:
**** The data values for the PRF segment are available on the printed Purchase Order.

Non-Warehouse Shipments:
This segment is not Mandatory for Non-Warehouse Shipments. However, if you have this information, please include it in this segment.
Sample EDI:
Warehouse Shipments:
Stand-Alone Purchase Order
PRF7035632020051017~
Release Purchase Order (as part of a Blanket Purchase Order)
PRF70356321
20051017~
Purchase Order Change applied to Stand-Alone
PRF70356320120051017~
Purchase Order Change applied to a Release Purchase Order
PRF70356321120051017~
**** The PRF02 and PRF03 are derived from the printed Purchase Order from AT&T Mobility. The values in the above examples may not be typical of your particular scenario.

Example
PRF-01
324
Purchase Order Number
Required
String (AN)
Min 1Max 22

Identifying number for Purchase Order assigned by the orderer/purchaser

Usage notes

This is the AT&T Mobility PO Number.

PRF-02
328
Release Number
Required
String (AN)
Min 1Max 30

Number identifying a release against a Purchase Order previously placed by the parties involved in the transaction

Usage notes

If the Purchase Order was a Release Purchase Order for a Blanket PO from AT&T Mobility, include the Release Number; otherwise, please default this value to '0'.

PRF-03
327
Change Order Sequence Number
Optional
String (AN)
Min 1Max 8

Number assigned by the orderer identifying a specific change or revision to a previously transmitted transaction set

Usage notes

If the Purchase Order was changed by the AT&T Mobility Buyer prior to shipment, the Purchase Order Change Order Sequence Number is Required.

PRF-04
373
Date
Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • PRF04 is the date assigned by the purchaser to purchase order.
REF
150
Detail > HL Loop > HL Loop > REF

Reference Identification

OptionalMax use >1

To specify identifying information

Usage notes

Mandatory for Warehouse Shipments

# Sample EDI:
Warehouse Shipments:
REFVN987654321~

Non-Warehouse Shipments:
This segment is not Mandatory for Non-Warehouse Shipments. However, if you have this information, please include it in this segment.

Example
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

VN
Vendor Order Number
REF-02
127
Reference Identification
Required
String (AN)
Min 1Max 30

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

HL Loop Item
OptionalMax >1
Usage notes

Sample EDI:
Warehouse and Non-Warehouse Orders:
For Serialized Items
HL54I1~
For Non-Serialized Items
HL54I0~

Variants (all may be used)
HL Loop PackHL Loop Shipping Tare
HL
010
Detail > HL Loop > HL Loop > HL Loop Item > HL

Hierarchical Level

RequiredMax use 1

To identify dependencies among and the content of hierarchically related groups of data segments

  • The HL segment is the only mandatory segment within the HL loop, and by itself, the HL segment has no meaning.
Example
HL-01
628
Hierarchical ID Number
Required
String (AN)
Min 1Max 12

A unique number assigned by the sender to identify a particular data segment in a hierarchical structure

  • HL01 shall contain a unique alphanumeric number for each occurrence of the HL segment in the transaction set. For example, HL01 could be used to indicate the number of occurrences of the HL segment, in which case the value of HL01 would be "1" for the initial HL segment and would be incremented by one in each subsequent HL segment within the transaction.
HL-02
734
Hierarchical Parent ID Number
Required
String (AN)
Min 1Max 12

Identification number of the next higher hierarchical data segment that the data segment being described is subordinate to

  • HL02 identifies the hierarchical ID number of the HL segment to which the current HL segment is subordinate.
HL-03
735
Hierarchical Level Code
Required
Identifier (ID)

Code defining the characteristic of a level in a hierarchical structure

  • HL03 indicates the context of the series of segments following the current HL segment up to the next occurrence of an HL segment in the transaction. For example, HL03 is used to indicate that subsequent segments in the HL loop form a logical grouping of data referring to shipment, order, or item-level information.
I
Item
HL-04
736
Hierarchical Child Code
Optional
Identifier (ID)

Code indicating if there are hierarchical child data segments subordinate to the level being described

  • HL04 indicates whether or not there are subordinate (or child) HL segments related to the current HL segment.
0
No Subordinate HL Segment in This Hierarchical Structure.
1
Additional Subordinate HL Data Segment in This Hierarchical Structure.
LIN
020
Detail > HL Loop > HL Loop > HL Loop Item > LIN

Item Identification

RequiredMax use 1

To specify basic item identification data

Usage notes
# Sample EDI:
Warehouse Orders:
LIN0001CBXXX.12345MNMODEL NUMBERUIUPC CODESK*12345~

Non-Warehouse Orders:
LIN0001CBXXX.12345MN*MODEL NUMBER~

Example
If either Product/Service ID Qualifier (LIN-06) or Product/Service ID (LIN-07) is present, then the other is required
LIN-01
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • LIN01 is the line item identification
Usage notes

The LIN01 must be the Line Number from the Original Purchase Order created by AT&T Mobility. The LIN01 must be expressed in 4 numeric characters, with leading zeros.
examples:
Line Item 01 will be 0001.
Line Item 10 will be 0010.

LIN-02
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

  • LIN02 through LIN31 provide for fifteen different product/service IDs for each item. For example: Case, Color, Drawing No., U.P.C. No., ISBN No., Model No., or SKU.
CB
Buyer's Catalog Number
LIN-03
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The format of the SKU must match the value sent in the original Purchase Order. Typically, the Buyer's Catalog Number is formatted as XXX.12345 where 'XXX.' is the prefix to the numeric AT&T Mobility SKU.

LIN-04
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

MN
Model Number
LIN-05
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

Model: This is the model of the device (e.g. 'V70G', '5190', 'Treo 650')

LIN-06
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

UI
U.P.C. Consumer Package Code (1-5-5)
LIN-07
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

UPC Code is not Mandatory. However, if you have this information, please include it in this element.

LIN-08
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

SK
Stock Keeping Unit (SKU)
LIN-09
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The AT&T Mobility SKU is required on ALL Warehouse Orders, but not on Non-Warehouse Orders.

The AT&T Mobility SKU is sent in the Purchase Order. The value in the LIN09 element should be the numeric portion of the LIN03 Buyers Catalog Number; do not send the 'XXX.' prefix in the LIN09.

SN1
030
Detail > HL Loop > HL Loop > HL Loop Item > SN1

Item Detail (Shipment)

RequiredMax use 1

To specify line-item detail relative to shipment

Usage notes

Sample EDI:
Warehouse Orders:
SN100012000*EA~

Example
SN1-01
350
Assigned Identification
Required
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • SN101 is the ship notice line-item identification.
Usage notes

Must match the Line Number from the LIN segment (LIN01) exactly

SN1-02
382
Number of Units Shipped
Required
Decimal number (R)
Min 1Max 10

Numeric value of units shipped in manufacturer's shipping units for a line item or transaction set

Usage notes

Serialized: Total number of eaches in the carton/container. This quantity will be the number of Serialized eaches in the carton/container. The SN102 must match the number of HL Kit level SLN segment iterations.

Non-Serialized: Total number of eaches in the carton/container. This quantity will be the number of Non-Serialized eaches in the carton/container.

SN1-03
355
Unit or Basis for Measurement Code
Required
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

  • SN103 defines the unit of measurement for both SN102 and SN104.
EA
Each
PO4
060
Detail > HL Loop > HL Loop > HL Loop Item > PO4

Item Physical Details

RequiredMax use 1

To specify the physical qualities, packaging, weights, and dimensions relating to the item

Usage notes

For SIM cards, the box inside the outer carton contains 4 packs of 250 each. The PO401 would be 1000 and the PO414 should be 1.

# Sim Card Example:
PO41000***********1~
For handsets, no Inner Pack is used. You should send just the PO401.
Handset Example:
PO4
10~

Non-Warehouse Orders:
This segment is not Mandatory for Non-Warehouse Orders.
Sample EDI:
PO41000***********1~ (SIM cards)
or
PO4
1~ (handsets)

Example
PO4-01
356
Pack
Required
Numeric (N0)
Min 1Max 6

The number of inner containers, or number of eaches if there are no inner containers, per outer container

PO4-14
810
Inner Pack
Optional
Numeric (N0)
Min 1Max 6

The number of eaches per inner container

REF
150
Detail > HL Loop > HL Loop > HL Loop Item > REF

Buyer Identification

RequiredMax use 1

To specify identifying information

Usage notes

The REF*YD segment is Mandatory. The YD qualifier references whether the line item is SERIALIZED or NON-SERIALIZED.

SERIALIZED items are items that require the HL*K loop, which communicates all serialized infromation, such as IMEI, Unlock Code, Serial Number, MAC Address, etc.

Only one REF*YD segment is expected at the Item level per Item.

Valid examples for the REFYD:
REF
YDSERIALIZED~
REF
YD*NON-SERIALIZED~

Example
Variants (all may be used)
REFShipment Number
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

YD
Buyer Identification
REF-02
127
Reference Identification
Required
String (AN)

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

NON-SERIALIZED
SERIALIZED
REF
150
Detail > HL Loop > HL Loop > HL Loop Item > REF

Shipment Number

OptionalMax use 1

To specify identifying information

Usage notes
# Warehouse Orders:
The Trading Partner must send the ShipNum (Shipment Number) value from the original Purchase Order created by AT&T Mobility.
** Contact your AT&T Mobility Buyer if you do not receive the ShipNum on the paper/PDF Purchase Order.

Non-Warehouse Orders:
This segment is not Mandatory for Non-Warehouse Orders.

The REF02 (ZZ qualifier) must be expressed in 4 numeric characters, with leading zeros.

examples:
ShipNum 01 will be 0001.
ShipNum 10 will be 0010.

Sample EDI:
Warehouse Orders:
REFZZSHIPNUM~

Example
Variants (all may be used)
REFBuyer Identification
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

ZZ
Mutually Defined
REF-02
127
Reference Identification
Required
String (AN)
Min 1Max 30

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

HL Loop
OptionalMax >1
Usage notes

The HL Kit loop is Required if the product is Serialized.
The HL Kit loop is NOT Required if the product is Non-Serialized product (i.e. Accessories)

HL
010
Detail > HL Loop > HL Loop > HL Loop Item > HL Loop > HL

Hierarchical Level

RequiredMax use 1

To identify dependencies among and the content of hierarchically related groups of data segments

  • The HL segment is the only mandatory segment within the HL loop, and by itself, the HL segment has no meaning.
Example
HL-01
628
Hierarchical ID Number
Required
String (AN)
Min 1Max 12

A unique number assigned by the sender to identify a particular data segment in a hierarchical structure

  • HL01 shall contain a unique alphanumeric number for each occurrence of the HL segment in the transaction set. For example, HL01 could be used to indicate the number of occurrences of the HL segment, in which case the value of HL01 would be "1" for the initial HL segment and would be incremented by one in each subsequent HL segment within the transaction.
HL-02
734
Hierarchical Parent ID Number
Required
String (AN)
Min 1Max 12

Identification number of the next higher hierarchical data segment that the data segment being described is subordinate to

  • HL02 identifies the hierarchical ID number of the HL segment to which the current HL segment is subordinate.
HL-03
735
Hierarchical Level Code
Required
Identifier (ID)

Code defining the characteristic of a level in a hierarchical structure

  • HL03 indicates the context of the series of segments following the current HL segment up to the next occurrence of an HL segment in the transaction. For example, HL03 is used to indicate that subsequent segments in the HL loop form a logical grouping of data referring to shipment, order, or item-level information.
K
Kit
HL-04
736
Hierarchical Child Code
Optional
Identifier (ID)

Code indicating if there are hierarchical child data segments subordinate to the level being described

  • HL04 indicates whether or not there are subordinate (or child) HL segments related to the current HL segment.
0
No Subordinate HL Segment in This Hierarchical Structure.
SLN
040
Detail > HL Loop > HL Loop > HL Loop Item > HL Loop > SLN

Subline Item Detail

RequiredMax use 1000

To specify product subline detail item data

Usage notes

Sample EDI:
For WIRELESS Equipment:
with ICC-ID:
SLN00011I1EA********IC12345678901234567890IS356862003671263TW65225359*PJ20051101*ZZR47R~
without ICC-ID:
SLN00011I1EA***IS356862003671263*TW65225359*PJ20051101*ZZR47R~
without Unlock Code:
SLN00011I1EA***IS356862003671263*TWUNLOCK_NOT_SENT*PJ20051101*ZZR472R~
For WIRELINE Equipment:
with Serial Number & MAC Address:
SLN00011I1EASN123456789012*MA210987654321*PJ20051101ZZR472_G_08.18.40R~
without Serial Number:
SLN
00011I1EA*****
SNSERIAL_NOT_SENT**MA210987654321*PJ20051101ZZ*R472_G_08.18.40R~
without MAC Address:
SLN
00011I1EA*SN123456789012**MAMAC_NOT_SENTPJ20051101ZZR472_G_08.18.40R~

Example
If either Product/Service ID Qualifier (SLN-11) or Product/Service ID (SLN-12) is present, then the other is required
If either Product/Service ID Qualifier (SLN-13) or Product/Service ID (SLN-14) is present, then the other is required
If either Product/Service ID Qualifier (SLN-15) or Product/Service ID (SLN-16) is present, then the other is required
If either Product/Service ID Qualifier (SLN-17) or Product/Service ID (SLN-18) is present, then the other is required
If either Product/Service ID Qualifier (SLN-19) or Product/Service ID (SLN-20) is present, then the other is required
If either Product/Service ID Qualifier (SLN-25) or Product/Service ID (SLN-26) is present, then the other is required
SLN-01
350
Assigned Identification
Required
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • SLN01 is the identifying number for the subline item.
  • SLN01 is related to (but not necessarily equivalent to) the baseline item number. Example: 1.1 or 1A might be used as a subline number to relate to baseline number 1.
Usage notes

Must match the Line Number from the LIN segment (LIN01) exactly.

SLN-02
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • SLN02 is the identifying number for the subline level. The subline level is analogous to the level code used in a bill of materials.
Usage notes

Unique Counter for each SLN iteration.

SLN-03
662
Relationship Code
Required
Identifier (ID)

Code indicating the relationship between entities

  • SLN03 is the configuration code indicating the relationship of the subline item to the baseline item.
I
Included
SLN-04
380
Quantity
Required
Decimal number (R)
Min 1Max 15

Numeric value of quantity

Usage notes

Usually a quantity of 1.

SLN-05
C001
Composite Unit of Measure
OptionalMax use 1
To identify a composite unit of measure (See Figures Appendix for examples of use)
C001-01
355
Unit or Basis for Measurement Code
Required
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

EA
Each
SLN-11
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

SN
Serial Number
SLN-12
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN11 and SLN12 are mandatory for all WIRELINE equipment.
** Serial Number is mandatory for all wireline equipment. There will only be one Serial Number per piece of wireline equipment. If Serial Number is not being sent in the SLN segment of the EDI 856 based on a prior legal agreement with AT&T, please include the following hardcoded text within the SLN12 element: SERIAL_NOT_SENT.

SLN-13
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

IC
ICC-ID (SIM Serial Number)
SLN-14
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN14 contains the ICC-ID (SIM Serial Number).
** ICC-ID (SIM Cards Serial Number) is mandatory for all WIRELESS equipment that is pre-packaged with SIM Cards. There will only be one ICC-ID per handset/data device.

SLN-15
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

IS
International Standard Serial Number (ISSN)

IMEI Code

SLN-16
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN16 contains the IMEI number. The SLN15 and SLN16 are mandatory for all WIRELESS equipment.

SLN-17
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

TW
Program Code

Subsidy Unlock Code

SLN-18
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN17 and SLN18 are mandatory for all WIRELESS equipment.
** Subsidy Unlock Codes (SIMLOCK3 or SIMLOCK4) are mandatory for all wireless equipment. There will only be one Subsidy Unlock Code per handset/data device. If Subsidy Unlock Code is not being sent in the SLN segment of the EDI 856 based on a prior legal agreement with AT&T, please include the following hardcoded text within the SLN18 element: UNLOCK_NOT_SENT.

SLN-19
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

MA
Media Access Control (MAC) Address
OI
OEM Identification Code
SLN-20
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN19 and SLN20 are mandatory for all WIRELINE equipment.
** Media Access Control (MAC) Address is mandatory for all wireline equipment. There will only be one Media Access Control (MAC) Address per piece of wireline equipment. If Media Access Control (MAC) Address is not being sent in the SLN segment of the EDI 856 based on a prior legal agreement with AT&T, please include the following hardcoded text within the SLN20 element: MAC_NOT_SENT.

The SLN19 and SLN20 are mandatory for all FEMTOCELL equipment.
** OEM Identification Code is mandatory for all FemtoCell equipment. There will only be one OEM Identification Code per piece of FemtoCell equipment.

SLN-21
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

PJ
Product Date Code (A code indicating the period during which a product was manufactured.)

Manufacture Date

SLN-22
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN21 and SLN22 are mandatory for all WIRELESS equipment.

Format Date as CCYYMMDD. If the Manufacture Date is not formatted correctly, the EDI856 transaction will be rejected.

Manufacture Date - This is the date which the device was manufactured.

SLN-23
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

ZZ
Software/Firmware Version
SLN-24
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN23 and SLN24 are mandatory for all WIRELESS equipment.
Firmware Version - Build or version of firmware on the phone.
Vendor Firmware Version Number must be sent for all handset/data card devices.
AT&T Mobility is expecting the Operating System (OS) Software/Firmware version in SLN24.

For handsets/data devices that also utilize a Flex Version, please use the SLN25 and SLN26.

SLN-25
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

RN
Flex Version
SLN-26
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

Flex Version - Depending on the device, a Flex Version will identify the build of the software. This field will contain the appropriate information of this build. This should be blank if it is not applicable to a device.

For handsets/data devices that also utilize a Flex Version, please use the SLN25 and SLN26.

HL Loop end
HL Loop Item end
HL Loop Pack
OptionalMax >1
Usage notes
# Warehouse Shipments:
The HL Pack iteration is Mandatory for all Warehouse shipments

Non-Warehouse Shipments:
This segment is not Mandatory for Non-Warehouse Shipments.

Sample EDI:
Warehouse Orders:
For LTL, TL, or Small Parcel Shipments where product is in a Carton
HL43P1~

Variants (all may be used)
HL Loop ItemHL Loop Shipping Tare
HL
010
Detail > HL Loop > HL Loop > HL Loop Pack > HL

Hierarchical Level

RequiredMax use 1

To identify dependencies among and the content of hierarchically related groups of data segments

  • The HL segment is the only mandatory segment within the HL loop, and by itself, the HL segment has no meaning.
Example
HL-01
628
Hierarchical ID Number
Required
String (AN)
Min 1Max 12

A unique number assigned by the sender to identify a particular data segment in a hierarchical structure

  • HL01 shall contain a unique alphanumeric number for each occurrence of the HL segment in the transaction set. For example, HL01 could be used to indicate the number of occurrences of the HL segment, in which case the value of HL01 would be "1" for the initial HL segment and would be incremented by one in each subsequent HL segment within the transaction.
HL-02
734
Hierarchical Parent ID Number
Required
String (AN)
Min 1Max 12

Identification number of the next higher hierarchical data segment that the data segment being described is subordinate to

  • HL02 identifies the hierarchical ID number of the HL segment to which the current HL segment is subordinate.
HL-03
735
Hierarchical Level Code
Required
Identifier (ID)

Code defining the characteristic of a level in a hierarchical structure

  • HL03 indicates the context of the series of segments following the current HL segment up to the next occurrence of an HL segment in the transaction. For example, HL03 is used to indicate that subsequent segments in the HL loop form a logical grouping of data referring to shipment, order, or item-level information.
P
Pack
HL-04
736
Hierarchical Child Code
Optional
Identifier (ID)

Code indicating if there are hierarchical child data segments subordinate to the level being described

  • HL04 indicates whether or not there are subordinate (or child) HL segments related to the current HL segment.
1
Additional Subordinate HL Data Segment in This Hierarchical Structure.
MAN
190
Detail > HL Loop > HL Loop > HL Loop Pack > MAN

Marks and Numbers

RequiredMax use >1

To indicate identifying marks and numbers for shipping containers

Usage notes

If the product has a UCC-128 barcode label applied, the MAN segment could contain the following:
MANGM00123456789123456789~
**** Only 1 MAN segment is required at the Pack level.
**** The Carton ID number is required in the MAN segment.

Sample EDI:
MANAny Qualifier123456789123456~

Example
MAN-01
88
Marks and Numbers Qualifier
Required
Identifier (ID)
Min 1Max 2

Code specifying the application or source of Marks and Numbers (87)

  • MAN01/MAN02 and MAN04/MAN05 may be used to identify two different marks and numbers assigned to the same physical container.
  • When MAN01 contains code "UC" (U.P.C. Shipping Container Code) and MAN05/MAN06 contain a range of ID numbers, MAN03 is not used. The reason for this is that the U.P.C. Shipping Container code is the same on every carton that is represented in the range in MAN05/MAN06.
MAN-02
87
Marks and Numbers
Required
String (AN)
Min 1Max 48

Marks and numbers used to identify a shipment or parts of a shipment

  • When both MAN02 and MAN03 are used, MAN02 is the starting number of a sequential range and MAN03 is the ending number of that range.
Usage notes

The MAN02 should contain a valid identification number for the Carton. The AT&T Mobility Routing Guide should be referenced.

HL Loop
RequiredMax >1
Usage notes

Sample EDI:
Warehouse and Non-Warehouse Orders:
For Serialized Items
HL54I1~
For Non-Serialized Items
HL54I0~

HL
010
Detail > HL Loop > HL Loop > HL Loop Pack > HL Loop > HL

Hierarchical Level

RequiredMax use 1

To identify dependencies among and the content of hierarchically related groups of data segments

  • The HL segment is the only mandatory segment within the HL loop, and by itself, the HL segment has no meaning.
Example
HL-01
628
Hierarchical ID Number
Required
String (AN)
Min 1Max 12

A unique number assigned by the sender to identify a particular data segment in a hierarchical structure

  • HL01 shall contain a unique alphanumeric number for each occurrence of the HL segment in the transaction set. For example, HL01 could be used to indicate the number of occurrences of the HL segment, in which case the value of HL01 would be "1" for the initial HL segment and would be incremented by one in each subsequent HL segment within the transaction.
HL-02
734
Hierarchical Parent ID Number
Required
String (AN)
Min 1Max 12

Identification number of the next higher hierarchical data segment that the data segment being described is subordinate to

  • HL02 identifies the hierarchical ID number of the HL segment to which the current HL segment is subordinate.
HL-03
735
Hierarchical Level Code
Required
Identifier (ID)

Code defining the characteristic of a level in a hierarchical structure

  • HL03 indicates the context of the series of segments following the current HL segment up to the next occurrence of an HL segment in the transaction. For example, HL03 is used to indicate that subsequent segments in the HL loop form a logical grouping of data referring to shipment, order, or item-level information.
I
Item
HL-04
736
Hierarchical Child Code
Optional
Identifier (ID)

Code indicating if there are hierarchical child data segments subordinate to the level being described

  • HL04 indicates whether or not there are subordinate (or child) HL segments related to the current HL segment.
0
No Subordinate HL Segment in This Hierarchical Structure.
1
Additional Subordinate HL Data Segment in This Hierarchical Structure.
LIN
020
Detail > HL Loop > HL Loop > HL Loop Pack > HL Loop > LIN

Item Identification

RequiredMax use 1

To specify basic item identification data

Usage notes
# Sample EDI:
Warehouse Orders:
LIN0001CBXXX.12345MNMODEL NUMBERUIUPC CODESK*12345~

Non-Warehouse Orders:
LIN0001CBXXX.12345MN*MODEL NUMBER~

Example
If either Product/Service ID Qualifier (LIN-06) or Product/Service ID (LIN-07) is present, then the other is required
LIN-01
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • LIN01 is the line item identification
Usage notes

The LIN01 must be the Line Number from the Original Purchase Order created by AT&T Mobility. The LIN01 must be expressed in 4 numeric characters, with leading zeros.
examples:
Line Item 01 will be 0001.
Line Item 10 will be 0010.

LIN-02
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

  • LIN02 through LIN31 provide for fifteen different product/service IDs for each item. For example: Case, Color, Drawing No., U.P.C. No., ISBN No., Model No., or SKU.
CB
Buyer's Catalog Number
LIN-03
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The format of the SKU must match the value sent in the original Purchase Order. Typically, the Buyer's Catalog Number is formatted as XXX.12345 where 'XXX.' is the prefix to the numeric AT&T Mobility SKU.

LIN-04
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

MN
Model Number
LIN-05
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

Model: This is the model of the device (e.g. 'V70G', '5190', 'Treo 650')

LIN-06
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

UI
U.P.C. Consumer Package Code (1-5-5)
LIN-07
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

UPC Code is not Mandatory. However, if you have this information, please include it in this element.

LIN-08
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

SK
Stock Keeping Unit (SKU)
LIN-09
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The AT&T Mobility SKU is required on ALL Warehouse Orders, but not on Non-Warehouse Orders.

The AT&T Mobility SKU is sent in the Purchase Order. The value in the LIN09 element should be the numeric portion of the LIN03 Buyers Catalog Number; do not send the 'XXX.' prefix in the LIN09.

SN1
030
Detail > HL Loop > HL Loop > HL Loop Pack > HL Loop > SN1

Item Detail (Shipment)

RequiredMax use 1

To specify line-item detail relative to shipment

Usage notes

Sample EDI:
Warehouse Orders:
SN100012000*EA~

Example
SN1-01
350
Assigned Identification
Required
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • SN101 is the ship notice line-item identification.
Usage notes

Must match the Line Number from the LIN segment (LIN01) exactly

SN1-02
382
Number of Units Shipped
Required
Decimal number (R)
Min 1Max 10

Numeric value of units shipped in manufacturer's shipping units for a line item or transaction set

Usage notes

Serialized: Total number of eaches in the carton/container. This quantity will be the number of Serialized eaches in the carton/container. The SN102 must match the number of HL Kit level SLN segment iterations.

Non-Serialized: Total number of eaches in the carton/container. This quantity will be the number of Non-Serialized eaches in the carton/container.

SN1-03
355
Unit or Basis for Measurement Code
Required
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

  • SN103 defines the unit of measurement for both SN102 and SN104.
EA
Each
PO4
060
Detail > HL Loop > HL Loop > HL Loop Pack > HL Loop > PO4

Item Physical Details

RequiredMax use 1

To specify the physical qualities, packaging, weights, and dimensions relating to the item

Usage notes

For SIM cards, the box inside the outer carton contains 4 packs of 250 each. The PO401 would be 1000 and the PO414 should be 1.

# Sim Card Example:
PO41000***********1~
For handsets, no Inner Pack is used. You should send just the PO401.
Handset Example:
PO4
10~

Non-Warehouse Orders:
This segment is not Mandatory for Non-Warehouse Orders.
Sample EDI:
PO41000***********1~ (SIM cards)
or
PO4
1~ (handsets)

Example
PO4-01
356
Pack
Required
Numeric (N0)
Min 1Max 6

The number of inner containers, or number of eaches if there are no inner containers, per outer container

PO4-14
810
Inner Pack
Optional
Numeric (N0)
Min 1Max 6

The number of eaches per inner container

REF
150
Detail > HL Loop > HL Loop > HL Loop Pack > HL Loop > REF

Buyer Identification

RequiredMax use 1

To specify identifying information

Usage notes

The REF*YD segment is Mandatory. The YD qualifier references whether the line item is SERIALIZED or NON-SERIALIZED.

SERIALIZED items are items that require the HL*K loop, which communicates all serialized infromation, such as IMEI, Unlock Code, Serial Number, MAC Address, etc.

Only one REF*YD segment is expected at the Item level per Item.

Valid examples for the REFYD:
REF
YDSERIALIZED~
REF
YD*NON-SERIALIZED~

Example
Variants (all may be used)
REFShipment Number
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

YD
Buyer Identification
REF-02
127
Reference Identification
Required
String (AN)

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

NON-SERIALIZED
SERIALIZED
REF
150
Detail > HL Loop > HL Loop > HL Loop Pack > HL Loop > REF

Shipment Number

OptionalMax use 1

To specify identifying information

Usage notes
# Warehouse Orders:
The Trading Partner must send the ShipNum (Shipment Number) value from the original Purchase Order created by AT&T Mobility.
** Contact your AT&T Mobility Buyer if you do not receive the ShipNum on the paper/PDF Purchase Order.

Non-Warehouse Orders:
This segment is not Mandatory for Non-Warehouse Orders.

The REF02 (ZZ qualifier) must be expressed in 4 numeric characters, with leading zeros.

examples:
ShipNum 01 will be 0001.
ShipNum 10 will be 0010.

Sample EDI:
Warehouse Orders:
REFZZSHIPNUM~

Example
Variants (all may be used)
REFBuyer Identification
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

ZZ
Mutually Defined
REF-02
127
Reference Identification
Required
String (AN)
Min 1Max 30

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

HL Loop
OptionalMax >1
Usage notes

The HL Kit loop is Required if the product is Serialized.
The HL Kit loop is NOT Required if the product is Non-Serialized product (i.e. Accessories)

HL
010
Detail > HL Loop > HL Loop > HL Loop Pack > HL Loop > HL Loop > HL

Hierarchical Level

RequiredMax use 1

To identify dependencies among and the content of hierarchically related groups of data segments

  • The HL segment is the only mandatory segment within the HL loop, and by itself, the HL segment has no meaning.
Example
HL-01
628
Hierarchical ID Number
Required
String (AN)
Min 1Max 12

A unique number assigned by the sender to identify a particular data segment in a hierarchical structure

  • HL01 shall contain a unique alphanumeric number for each occurrence of the HL segment in the transaction set. For example, HL01 could be used to indicate the number of occurrences of the HL segment, in which case the value of HL01 would be "1" for the initial HL segment and would be incremented by one in each subsequent HL segment within the transaction.
HL-02
734
Hierarchical Parent ID Number
Required
String (AN)
Min 1Max 12

Identification number of the next higher hierarchical data segment that the data segment being described is subordinate to

  • HL02 identifies the hierarchical ID number of the HL segment to which the current HL segment is subordinate.
HL-03
735
Hierarchical Level Code
Required
Identifier (ID)

Code defining the characteristic of a level in a hierarchical structure

  • HL03 indicates the context of the series of segments following the current HL segment up to the next occurrence of an HL segment in the transaction. For example, HL03 is used to indicate that subsequent segments in the HL loop form a logical grouping of data referring to shipment, order, or item-level information.
K
Kit
HL-04
736
Hierarchical Child Code
Optional
Identifier (ID)

Code indicating if there are hierarchical child data segments subordinate to the level being described

  • HL04 indicates whether or not there are subordinate (or child) HL segments related to the current HL segment.
0
No Subordinate HL Segment in This Hierarchical Structure.
SLN
040
Detail > HL Loop > HL Loop > HL Loop Pack > HL Loop > HL Loop > SLN

Subline Item Detail

RequiredMax use 1000

To specify product subline detail item data

Usage notes

Sample EDI:
For WIRELESS Equipment:
with ICC-ID:
SLN00011I1EA********IC12345678901234567890IS356862003671263TW65225359*PJ20051101*ZZR47R~
without ICC-ID:
SLN00011I1EA***IS356862003671263*TW65225359*PJ20051101*ZZR47R~
without Unlock Code:
SLN00011I1EA***IS356862003671263*TWUNLOCK_NOT_SENT*PJ20051101*ZZR472R~
For WIRELINE Equipment:
with Serial Number & MAC Address:
SLN00011I1EASN123456789012*MA210987654321*PJ20051101ZZR472_G_08.18.40R~
without Serial Number:
SLN
00011I1EA*****
SNSERIAL_NOT_SENT**MA210987654321*PJ20051101ZZ*R472_G_08.18.40R~
without MAC Address:
SLN
00011I1EA*SN123456789012**MAMAC_NOT_SENTPJ20051101ZZR472_G_08.18.40R~

Example
If either Product/Service ID Qualifier (SLN-11) or Product/Service ID (SLN-12) is present, then the other is required
If either Product/Service ID Qualifier (SLN-13) or Product/Service ID (SLN-14) is present, then the other is required
If either Product/Service ID Qualifier (SLN-15) or Product/Service ID (SLN-16) is present, then the other is required
If either Product/Service ID Qualifier (SLN-17) or Product/Service ID (SLN-18) is present, then the other is required
If either Product/Service ID Qualifier (SLN-19) or Product/Service ID (SLN-20) is present, then the other is required
If either Product/Service ID Qualifier (SLN-25) or Product/Service ID (SLN-26) is present, then the other is required
SLN-01
350
Assigned Identification
Required
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • SLN01 is the identifying number for the subline item.
  • SLN01 is related to (but not necessarily equivalent to) the baseline item number. Example: 1.1 or 1A might be used as a subline number to relate to baseline number 1.
Usage notes

Must match the Line Number from the LIN segment (LIN01) exactly.

SLN-02
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • SLN02 is the identifying number for the subline level. The subline level is analogous to the level code used in a bill of materials.
Usage notes

Unique Counter for each SLN iteration.

SLN-03
662
Relationship Code
Required
Identifier (ID)

Code indicating the relationship between entities

  • SLN03 is the configuration code indicating the relationship of the subline item to the baseline item.
I
Included
SLN-04
380
Quantity
Required
Decimal number (R)
Min 1Max 15

Numeric value of quantity

Usage notes

Usually a quantity of 1.

SLN-05
C001
Composite Unit of Measure
OptionalMax use 1
To identify a composite unit of measure (See Figures Appendix for examples of use)
C001-01
355
Unit or Basis for Measurement Code
Required
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

EA
Each
SLN-11
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

SN
Serial Number
SLN-12
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN11 and SLN12 are mandatory for all WIRELINE equipment.
** Serial Number is mandatory for all wireline equipment. There will only be one Serial Number per piece of wireline equipment. If Serial Number is not being sent in the SLN segment of the EDI 856 based on a prior legal agreement with AT&T, please include the following hardcoded text within the SLN12 element: SERIAL_NOT_SENT.

SLN-13
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

IC
ICC-ID (SIM Serial Number)
SLN-14
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN14 contains the ICC-ID (SIM Serial Number).
** ICC-ID (SIM Cards Serial Number) is mandatory for all WIRELESS equipment that is pre-packaged with SIM Cards. There will only be one ICC-ID per handset/data device.

SLN-15
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

IS
International Standard Serial Number (ISSN)

IMEI Code

SLN-16
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN16 contains the IMEI number. The SLN15 and SLN16 are mandatory for all WIRELESS equipment.

SLN-17
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

TW
Program Code

Subsidy Unlock Code

SLN-18
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN17 and SLN18 are mandatory for all WIRELESS equipment.
** Subsidy Unlock Codes (SIMLOCK3 or SIMLOCK4) are mandatory for all wireless equipment. There will only be one Subsidy Unlock Code per handset/data device. If Subsidy Unlock Code is not being sent in the SLN segment of the EDI 856 based on a prior legal agreement with AT&T, please include the following hardcoded text within the SLN18 element: UNLOCK_NOT_SENT.

SLN-19
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

MA
Media Access Control (MAC) Address
OI
OEM Identification Code
SLN-20
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN19 and SLN20 are mandatory for all WIRELINE equipment.
** Media Access Control (MAC) Address is mandatory for all wireline equipment. There will only be one Media Access Control (MAC) Address per piece of wireline equipment. If Media Access Control (MAC) Address is not being sent in the SLN segment of the EDI 856 based on a prior legal agreement with AT&T, please include the following hardcoded text within the SLN20 element: MAC_NOT_SENT.

The SLN19 and SLN20 are mandatory for all FEMTOCELL equipment.
** OEM Identification Code is mandatory for all FemtoCell equipment. There will only be one OEM Identification Code per piece of FemtoCell equipment.

SLN-21
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

PJ
Product Date Code (A code indicating the period during which a product was manufactured.)

Manufacture Date

SLN-22
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN21 and SLN22 are mandatory for all WIRELESS equipment.

Format Date as CCYYMMDD. If the Manufacture Date is not formatted correctly, the EDI856 transaction will be rejected.

Manufacture Date - This is the date which the device was manufactured.

SLN-23
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

ZZ
Software/Firmware Version
SLN-24
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN23 and SLN24 are mandatory for all WIRELESS equipment.
Firmware Version - Build or version of firmware on the phone.
Vendor Firmware Version Number must be sent for all handset/data card devices.
AT&T Mobility is expecting the Operating System (OS) Software/Firmware version in SLN24.

For handsets/data devices that also utilize a Flex Version, please use the SLN25 and SLN26.

SLN-25
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

RN
Flex Version
SLN-26
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

Flex Version - Depending on the device, a Flex Version will identify the build of the software. This field will contain the appropriate information of this build. This should be blank if it is not applicable to a device.

For handsets/data devices that also utilize a Flex Version, please use the SLN25 and SLN26.

HL Loop end
HL Loop end
HL Loop Pack end
HL Loop Shipping Tare
OptionalMax >1
Usage notes
# Warehouse Shipments:
The HL Tare iteration is Mandatory for all Warehouse shipments

Non-Warehouse Shipments:
This segment is not Mandatory for Non-Warehouse Shipments.

Variants (all may be used)
HL Loop ItemHL Loop Pack
HL
010
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL

Hierarchical Level

RequiredMax use 1

To identify dependencies among and the content of hierarchically related groups of data segments

  • The HL segment is the only mandatory segment within the HL loop, and by itself, the HL segment has no meaning.
Example
HL-01
628
Hierarchical ID Number
Required
String (AN)
Min 1Max 12

A unique number assigned by the sender to identify a particular data segment in a hierarchical structure

  • HL01 shall contain a unique alphanumeric number for each occurrence of the HL segment in the transaction set. For example, HL01 could be used to indicate the number of occurrences of the HL segment, in which case the value of HL01 would be "1" for the initial HL segment and would be incremented by one in each subsequent HL segment within the transaction.
HL-02
734
Hierarchical Parent ID Number
Required
String (AN)
Min 1Max 12

Identification number of the next higher hierarchical data segment that the data segment being described is subordinate to

  • HL02 identifies the hierarchical ID number of the HL segment to which the current HL segment is subordinate.
HL-03
735
Hierarchical Level Code
Required
Identifier (ID)

Code defining the characteristic of a level in a hierarchical structure

  • HL03 indicates the context of the series of segments following the current HL segment up to the next occurrence of an HL segment in the transaction. For example, HL03 is used to indicate that subsequent segments in the HL loop form a logical grouping of data referring to shipment, order, or item-level information.
T
Shipping Tare
HL-04
736
Hierarchical Child Code
Optional
Identifier (ID)

Code indicating if there are hierarchical child data segments subordinate to the level being described

  • HL04 indicates whether or not there are subordinate (or child) HL segments related to the current HL segment.
0
No Subordinate HL Segment in This Hierarchical Structure.
1
Additional Subordinate HL Data Segment in This Hierarchical Structure.
MAN
190
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > MAN

Marks and Numbers

RequiredMax use >1

To indicate identifying marks and numbers for shipping containers

Usage notes

If the product has a UCC-128 barcode label applied, the MAN segment could contain the following:
MANGM00123456789123456789~
**** Only 1 MAN segment is required at the Tare level.

Sample EDI:
MANAny Qualifier123456789123456~

Example
MAN-01
88
Marks and Numbers Qualifier
Required
Identifier (ID)
Min 1Max 2

Code specifying the application or source of Marks and Numbers (87)

  • MAN01/MAN02 and MAN04/MAN05 may be used to identify two different marks and numbers assigned to the same physical container.
  • When MAN01 contains code "UC" (U.P.C. Shipping Container Code) and MAN05/MAN06 contain a range of ID numbers, MAN03 is not used. The reason for this is that the U.P.C. Shipping Container code is the same on every carton that is represented in the range in MAN05/MAN06.
MAN-02
87
Marks and Numbers
Required
String (AN)
Min 1Max 48

Marks and numbers used to identify a shipment or parts of a shipment

  • When both MAN02 and MAN03 are used, MAN02 is the starting number of a sequential range and MAN03 is the ending number of that range.
Usage notes

The MAN02 should contain a valid identification number for the Pallet. The AT&T Mobility Routing Guide should be referenced.

HL Loop Item
OptionalMax >1
Usage notes

Sample EDI:
Warehouse and Non-Warehouse Orders:
For Serialized Items
HL54I1~
For Non-Serialized Items
HL54I0~

Variants (all may be used)
HL Loop Pack
HL
010
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Item > HL

Hierarchical Level

RequiredMax use 1

To identify dependencies among and the content of hierarchically related groups of data segments

  • The HL segment is the only mandatory segment within the HL loop, and by itself, the HL segment has no meaning.
Example
HL-01
628
Hierarchical ID Number
Required
String (AN)
Min 1Max 12

A unique number assigned by the sender to identify a particular data segment in a hierarchical structure

  • HL01 shall contain a unique alphanumeric number for each occurrence of the HL segment in the transaction set. For example, HL01 could be used to indicate the number of occurrences of the HL segment, in which case the value of HL01 would be "1" for the initial HL segment and would be incremented by one in each subsequent HL segment within the transaction.
HL-02
734
Hierarchical Parent ID Number
Required
String (AN)
Min 1Max 12

Identification number of the next higher hierarchical data segment that the data segment being described is subordinate to

  • HL02 identifies the hierarchical ID number of the HL segment to which the current HL segment is subordinate.
HL-03
735
Hierarchical Level Code
Required
Identifier (ID)

Code defining the characteristic of a level in a hierarchical structure

  • HL03 indicates the context of the series of segments following the current HL segment up to the next occurrence of an HL segment in the transaction. For example, HL03 is used to indicate that subsequent segments in the HL loop form a logical grouping of data referring to shipment, order, or item-level information.
I
Item
HL-04
736
Hierarchical Child Code
Optional
Identifier (ID)

Code indicating if there are hierarchical child data segments subordinate to the level being described

  • HL04 indicates whether or not there are subordinate (or child) HL segments related to the current HL segment.
0
No Subordinate HL Segment in This Hierarchical Structure.
1
Additional Subordinate HL Data Segment in This Hierarchical Structure.
LIN
020
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Item > LIN

Item Identification

RequiredMax use 1

To specify basic item identification data

Usage notes
# Sample EDI:
Warehouse Orders:
LIN0001CBXXX.12345MNMODEL NUMBERUIUPC CODESK*12345~

Non-Warehouse Orders:
LIN0001CBXXX.12345MN*MODEL NUMBER~

Example
If either Product/Service ID Qualifier (LIN-06) or Product/Service ID (LIN-07) is present, then the other is required
LIN-01
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • LIN01 is the line item identification
Usage notes

The LIN01 must be the Line Number from the Original Purchase Order created by AT&T Mobility. The LIN01 must be expressed in 4 numeric characters, with leading zeros.
examples:
Line Item 01 will be 0001.
Line Item 10 will be 0010.

LIN-02
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

  • LIN02 through LIN31 provide for fifteen different product/service IDs for each item. For example: Case, Color, Drawing No., U.P.C. No., ISBN No., Model No., or SKU.
CB
Buyer's Catalog Number
LIN-03
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The format of the SKU must match the value sent in the original Purchase Order. Typically, the Buyer's Catalog Number is formatted as XXX.12345 where 'XXX.' is the prefix to the numeric AT&T Mobility SKU.

LIN-04
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

MN
Model Number
LIN-05
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

Model: This is the model of the device (e.g. 'V70G', '5190', 'Treo 650')

LIN-06
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

UI
U.P.C. Consumer Package Code (1-5-5)
LIN-07
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

UPC Code is not Mandatory. However, if you have this information, please include it in this element.

LIN-08
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

SK
Stock Keeping Unit (SKU)
LIN-09
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The AT&T Mobility SKU is required on ALL Warehouse Orders, but not on Non-Warehouse Orders.

The AT&T Mobility SKU is sent in the Purchase Order. The value in the LIN09 element should be the numeric portion of the LIN03 Buyers Catalog Number; do not send the 'XXX.' prefix in the LIN09.

SN1
030
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Item > SN1

Item Detail (Shipment)

RequiredMax use 1

To specify line-item detail relative to shipment

Usage notes

Sample EDI:
Warehouse Orders:
SN100012000*EA~

Example
SN1-01
350
Assigned Identification
Required
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • SN101 is the ship notice line-item identification.
Usage notes

Must match the Line Number from the LIN segment (LIN01) exactly

SN1-02
382
Number of Units Shipped
Required
Decimal number (R)
Min 1Max 10

Numeric value of units shipped in manufacturer's shipping units for a line item or transaction set

Usage notes

Serialized: Total number of eaches in the carton/container. This quantity will be the number of Serialized eaches in the carton/container. The SN102 must match the number of HL Kit level SLN segment iterations.

Non-Serialized: Total number of eaches in the carton/container. This quantity will be the number of Non-Serialized eaches in the carton/container.

SN1-03
355
Unit or Basis for Measurement Code
Required
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

  • SN103 defines the unit of measurement for both SN102 and SN104.
EA
Each
PO4
060
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Item > PO4

Item Physical Details

RequiredMax use 1

To specify the physical qualities, packaging, weights, and dimensions relating to the item

Usage notes

For SIM cards, the box inside the outer carton contains 4 packs of 250 each. The PO401 would be 1000 and the PO414 should be 1.

# Sim Card Example:
PO41000***********1~
For handsets, no Inner Pack is used. You should send just the PO401.
Handset Example:
PO4
10~

Non-Warehouse Orders:
This segment is not Mandatory for Non-Warehouse Orders.
Sample EDI:
PO41000***********1~ (SIM cards)
or
PO4
1~ (handsets)

Example
PO4-01
356
Pack
Required
Numeric (N0)
Min 1Max 6

The number of inner containers, or number of eaches if there are no inner containers, per outer container

PO4-14
810
Inner Pack
Optional
Numeric (N0)
Min 1Max 6

The number of eaches per inner container

REF
150
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Item > REF

Buyer Identification

RequiredMax use 1

To specify identifying information

Usage notes

The REF*YD segment is Mandatory. The YD qualifier references whether the line item is SERIALIZED or NON-SERIALIZED.

SERIALIZED items are items that require the HL*K loop, which communicates all serialized infromation, such as IMEI, Unlock Code, Serial Number, MAC Address, etc.

Only one REF*YD segment is expected at the Item level per Item.

Valid examples for the REFYD:
REF
YDSERIALIZED~
REF
YD*NON-SERIALIZED~

Example
Variants (all may be used)
REFShipment Number
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

YD
Buyer Identification
REF-02
127
Reference Identification
Required
String (AN)

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

NON-SERIALIZED
SERIALIZED
REF
150
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Item > REF

Shipment Number

OptionalMax use 1

To specify identifying information

Usage notes
# Warehouse Orders:
The Trading Partner must send the ShipNum (Shipment Number) value from the original Purchase Order created by AT&T Mobility.
** Contact your AT&T Mobility Buyer if you do not receive the ShipNum on the paper/PDF Purchase Order.

Non-Warehouse Orders:
This segment is not Mandatory for Non-Warehouse Orders.

The REF02 (ZZ qualifier) must be expressed in 4 numeric characters, with leading zeros.

examples:
ShipNum 01 will be 0001.
ShipNum 10 will be 0010.

Sample EDI:
Warehouse Orders:
REFZZSHIPNUM~

Example
Variants (all may be used)
REFBuyer Identification
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

ZZ
Mutually Defined
REF-02
127
Reference Identification
Required
String (AN)
Min 1Max 30

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

HL Loop
OptionalMax >1
Usage notes

The HL Kit loop is Required if the product is Serialized.
The HL Kit loop is NOT Required if the product is Non-Serialized product (i.e. Accessories)

HL
010
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Item > HL Loop > HL

Hierarchical Level

RequiredMax use 1

To identify dependencies among and the content of hierarchically related groups of data segments

  • The HL segment is the only mandatory segment within the HL loop, and by itself, the HL segment has no meaning.
Example
HL-01
628
Hierarchical ID Number
Required
String (AN)
Min 1Max 12

A unique number assigned by the sender to identify a particular data segment in a hierarchical structure

  • HL01 shall contain a unique alphanumeric number for each occurrence of the HL segment in the transaction set. For example, HL01 could be used to indicate the number of occurrences of the HL segment, in which case the value of HL01 would be "1" for the initial HL segment and would be incremented by one in each subsequent HL segment within the transaction.
HL-02
734
Hierarchical Parent ID Number
Required
String (AN)
Min 1Max 12

Identification number of the next higher hierarchical data segment that the data segment being described is subordinate to

  • HL02 identifies the hierarchical ID number of the HL segment to which the current HL segment is subordinate.
HL-03
735
Hierarchical Level Code
Required
Identifier (ID)

Code defining the characteristic of a level in a hierarchical structure

  • HL03 indicates the context of the series of segments following the current HL segment up to the next occurrence of an HL segment in the transaction. For example, HL03 is used to indicate that subsequent segments in the HL loop form a logical grouping of data referring to shipment, order, or item-level information.
K
Kit
HL-04
736
Hierarchical Child Code
Optional
Identifier (ID)

Code indicating if there are hierarchical child data segments subordinate to the level being described

  • HL04 indicates whether or not there are subordinate (or child) HL segments related to the current HL segment.
0
No Subordinate HL Segment in This Hierarchical Structure.
SLN
040
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Item > HL Loop > SLN

Subline Item Detail

RequiredMax use 1000

To specify product subline detail item data

Usage notes

Sample EDI:
For WIRELESS Equipment:
with ICC-ID:
SLN00011I1EA********IC12345678901234567890IS356862003671263TW65225359*PJ20051101*ZZR47R~
without ICC-ID:
SLN00011I1EA***IS356862003671263*TW65225359*PJ20051101*ZZR47R~
without Unlock Code:
SLN00011I1EA***IS356862003671263*TWUNLOCK_NOT_SENT*PJ20051101*ZZR472R~
For WIRELINE Equipment:
with Serial Number & MAC Address:
SLN00011I1EASN123456789012*MA210987654321*PJ20051101ZZR472_G_08.18.40R~
without Serial Number:
SLN
00011I1EA*****
SNSERIAL_NOT_SENT**MA210987654321*PJ20051101ZZ*R472_G_08.18.40R~
without MAC Address:
SLN
00011I1EA*SN123456789012**MAMAC_NOT_SENTPJ20051101ZZR472_G_08.18.40R~

Example
If either Product/Service ID Qualifier (SLN-11) or Product/Service ID (SLN-12) is present, then the other is required
If either Product/Service ID Qualifier (SLN-13) or Product/Service ID (SLN-14) is present, then the other is required
If either Product/Service ID Qualifier (SLN-15) or Product/Service ID (SLN-16) is present, then the other is required
If either Product/Service ID Qualifier (SLN-17) or Product/Service ID (SLN-18) is present, then the other is required
If either Product/Service ID Qualifier (SLN-19) or Product/Service ID (SLN-20) is present, then the other is required
If either Product/Service ID Qualifier (SLN-25) or Product/Service ID (SLN-26) is present, then the other is required
SLN-01
350
Assigned Identification
Required
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • SLN01 is the identifying number for the subline item.
  • SLN01 is related to (but not necessarily equivalent to) the baseline item number. Example: 1.1 or 1A might be used as a subline number to relate to baseline number 1.
Usage notes

Must match the Line Number from the LIN segment (LIN01) exactly.

SLN-02
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • SLN02 is the identifying number for the subline level. The subline level is analogous to the level code used in a bill of materials.
Usage notes

Unique Counter for each SLN iteration.

SLN-03
662
Relationship Code
Required
Identifier (ID)

Code indicating the relationship between entities

  • SLN03 is the configuration code indicating the relationship of the subline item to the baseline item.
I
Included
SLN-04
380
Quantity
Required
Decimal number (R)
Min 1Max 15

Numeric value of quantity

Usage notes

Usually a quantity of 1.

SLN-05
C001
Composite Unit of Measure
OptionalMax use 1
To identify a composite unit of measure (See Figures Appendix for examples of use)
C001-01
355
Unit or Basis for Measurement Code
Required
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

EA
Each
SLN-11
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

SN
Serial Number
SLN-12
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN11 and SLN12 are mandatory for all WIRELINE equipment.
** Serial Number is mandatory for all wireline equipment. There will only be one Serial Number per piece of wireline equipment. If Serial Number is not being sent in the SLN segment of the EDI 856 based on a prior legal agreement with AT&T, please include the following hardcoded text within the SLN12 element: SERIAL_NOT_SENT.

SLN-13
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

IC
ICC-ID (SIM Serial Number)
SLN-14
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN14 contains the ICC-ID (SIM Serial Number).
** ICC-ID (SIM Cards Serial Number) is mandatory for all WIRELESS equipment that is pre-packaged with SIM Cards. There will only be one ICC-ID per handset/data device.

SLN-15
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

IS
International Standard Serial Number (ISSN)

IMEI Code

SLN-16
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN16 contains the IMEI number. The SLN15 and SLN16 are mandatory for all WIRELESS equipment.

SLN-17
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

TW
Program Code

Subsidy Unlock Code

SLN-18
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN17 and SLN18 are mandatory for all WIRELESS equipment.
** Subsidy Unlock Codes (SIMLOCK3 or SIMLOCK4) are mandatory for all wireless equipment. There will only be one Subsidy Unlock Code per handset/data device. If Subsidy Unlock Code is not being sent in the SLN segment of the EDI 856 based on a prior legal agreement with AT&T, please include the following hardcoded text within the SLN18 element: UNLOCK_NOT_SENT.

SLN-19
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

MA
Media Access Control (MAC) Address
OI
OEM Identification Code
SLN-20
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN19 and SLN20 are mandatory for all WIRELINE equipment.
** Media Access Control (MAC) Address is mandatory for all wireline equipment. There will only be one Media Access Control (MAC) Address per piece of wireline equipment. If Media Access Control (MAC) Address is not being sent in the SLN segment of the EDI 856 based on a prior legal agreement with AT&T, please include the following hardcoded text within the SLN20 element: MAC_NOT_SENT.

The SLN19 and SLN20 are mandatory for all FEMTOCELL equipment.
** OEM Identification Code is mandatory for all FemtoCell equipment. There will only be one OEM Identification Code per piece of FemtoCell equipment.

SLN-21
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

PJ
Product Date Code (A code indicating the period during which a product was manufactured.)

Manufacture Date

SLN-22
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN21 and SLN22 are mandatory for all WIRELESS equipment.

Format Date as CCYYMMDD. If the Manufacture Date is not formatted correctly, the EDI856 transaction will be rejected.

Manufacture Date - This is the date which the device was manufactured.

SLN-23
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

ZZ
Software/Firmware Version
SLN-24
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN23 and SLN24 are mandatory for all WIRELESS equipment.
Firmware Version - Build or version of firmware on the phone.
Vendor Firmware Version Number must be sent for all handset/data card devices.
AT&T Mobility is expecting the Operating System (OS) Software/Firmware version in SLN24.

For handsets/data devices that also utilize a Flex Version, please use the SLN25 and SLN26.

SLN-25
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

RN
Flex Version
SLN-26
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

Flex Version - Depending on the device, a Flex Version will identify the build of the software. This field will contain the appropriate information of this build. This should be blank if it is not applicable to a device.

For handsets/data devices that also utilize a Flex Version, please use the SLN25 and SLN26.

HL Loop end
HL Loop Item end
HL Loop Pack
OptionalMax >1
Usage notes
# Warehouse Shipments:
The HL Pack iteration is Mandatory for all Warehouse shipments

Non-Warehouse Shipments:
This segment is not Mandatory for Non-Warehouse Shipments.

Sample EDI:
Warehouse Orders:
For LTL, TL, or Small Parcel Shipments where product is in a Carton
HL43P1~

Variants (all may be used)
HL Loop Item
HL
010
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Pack > HL

Hierarchical Level

RequiredMax use 1

To identify dependencies among and the content of hierarchically related groups of data segments

  • The HL segment is the only mandatory segment within the HL loop, and by itself, the HL segment has no meaning.
Example
HL-01
628
Hierarchical ID Number
Required
String (AN)
Min 1Max 12

A unique number assigned by the sender to identify a particular data segment in a hierarchical structure

  • HL01 shall contain a unique alphanumeric number for each occurrence of the HL segment in the transaction set. For example, HL01 could be used to indicate the number of occurrences of the HL segment, in which case the value of HL01 would be "1" for the initial HL segment and would be incremented by one in each subsequent HL segment within the transaction.
HL-02
734
Hierarchical Parent ID Number
Required
String (AN)
Min 1Max 12

Identification number of the next higher hierarchical data segment that the data segment being described is subordinate to

  • HL02 identifies the hierarchical ID number of the HL segment to which the current HL segment is subordinate.
HL-03
735
Hierarchical Level Code
Required
Identifier (ID)

Code defining the characteristic of a level in a hierarchical structure

  • HL03 indicates the context of the series of segments following the current HL segment up to the next occurrence of an HL segment in the transaction. For example, HL03 is used to indicate that subsequent segments in the HL loop form a logical grouping of data referring to shipment, order, or item-level information.
P
Pack
HL-04
736
Hierarchical Child Code
Optional
Identifier (ID)

Code indicating if there are hierarchical child data segments subordinate to the level being described

  • HL04 indicates whether or not there are subordinate (or child) HL segments related to the current HL segment.
1
Additional Subordinate HL Data Segment in This Hierarchical Structure.
MAN
190
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Pack > MAN

Marks and Numbers

RequiredMax use >1

To indicate identifying marks and numbers for shipping containers

Usage notes

If the product has a UCC-128 barcode label applied, the MAN segment could contain the following:
MANGM00123456789123456789~
**** Only 1 MAN segment is required at the Pack level.
**** The Carton ID number is required in the MAN segment.

Sample EDI:
MANAny Qualifier123456789123456~

Example
MAN-01
88
Marks and Numbers Qualifier
Required
Identifier (ID)
Min 1Max 2

Code specifying the application or source of Marks and Numbers (87)

  • MAN01/MAN02 and MAN04/MAN05 may be used to identify two different marks and numbers assigned to the same physical container.
  • When MAN01 contains code "UC" (U.P.C. Shipping Container Code) and MAN05/MAN06 contain a range of ID numbers, MAN03 is not used. The reason for this is that the U.P.C. Shipping Container code is the same on every carton that is represented in the range in MAN05/MAN06.
MAN-02
87
Marks and Numbers
Required
String (AN)
Min 1Max 48

Marks and numbers used to identify a shipment or parts of a shipment

  • When both MAN02 and MAN03 are used, MAN02 is the starting number of a sequential range and MAN03 is the ending number of that range.
Usage notes

The MAN02 should contain a valid identification number for the Carton. The AT&T Mobility Routing Guide should be referenced.

HL Loop
RequiredMax >1
Usage notes

Sample EDI:
Warehouse and Non-Warehouse Orders:
For Serialized Items
HL54I1~
For Non-Serialized Items
HL54I0~

HL
010
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Pack > HL Loop > HL

Hierarchical Level

RequiredMax use 1

To identify dependencies among and the content of hierarchically related groups of data segments

  • The HL segment is the only mandatory segment within the HL loop, and by itself, the HL segment has no meaning.
Example
HL-01
628
Hierarchical ID Number
Required
String (AN)
Min 1Max 12

A unique number assigned by the sender to identify a particular data segment in a hierarchical structure

  • HL01 shall contain a unique alphanumeric number for each occurrence of the HL segment in the transaction set. For example, HL01 could be used to indicate the number of occurrences of the HL segment, in which case the value of HL01 would be "1" for the initial HL segment and would be incremented by one in each subsequent HL segment within the transaction.
HL-02
734
Hierarchical Parent ID Number
Required
String (AN)
Min 1Max 12

Identification number of the next higher hierarchical data segment that the data segment being described is subordinate to

  • HL02 identifies the hierarchical ID number of the HL segment to which the current HL segment is subordinate.
HL-03
735
Hierarchical Level Code
Required
Identifier (ID)

Code defining the characteristic of a level in a hierarchical structure

  • HL03 indicates the context of the series of segments following the current HL segment up to the next occurrence of an HL segment in the transaction. For example, HL03 is used to indicate that subsequent segments in the HL loop form a logical grouping of data referring to shipment, order, or item-level information.
I
Item
HL-04
736
Hierarchical Child Code
Optional
Identifier (ID)

Code indicating if there are hierarchical child data segments subordinate to the level being described

  • HL04 indicates whether or not there are subordinate (or child) HL segments related to the current HL segment.
0
No Subordinate HL Segment in This Hierarchical Structure.
1
Additional Subordinate HL Data Segment in This Hierarchical Structure.
LIN
020
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Pack > HL Loop > LIN

Item Identification

RequiredMax use 1

To specify basic item identification data

Usage notes
# Sample EDI:
Warehouse Orders:
LIN0001CBXXX.12345MNMODEL NUMBERUIUPC CODESK*12345~

Non-Warehouse Orders:
LIN0001CBXXX.12345MN*MODEL NUMBER~

Example
If either Product/Service ID Qualifier (LIN-06) or Product/Service ID (LIN-07) is present, then the other is required
LIN-01
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • LIN01 is the line item identification
Usage notes

The LIN01 must be the Line Number from the Original Purchase Order created by AT&T Mobility. The LIN01 must be expressed in 4 numeric characters, with leading zeros.
examples:
Line Item 01 will be 0001.
Line Item 10 will be 0010.

LIN-02
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

  • LIN02 through LIN31 provide for fifteen different product/service IDs for each item. For example: Case, Color, Drawing No., U.P.C. No., ISBN No., Model No., or SKU.
CB
Buyer's Catalog Number
LIN-03
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The format of the SKU must match the value sent in the original Purchase Order. Typically, the Buyer's Catalog Number is formatted as XXX.12345 where 'XXX.' is the prefix to the numeric AT&T Mobility SKU.

LIN-04
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

MN
Model Number
LIN-05
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

Model: This is the model of the device (e.g. 'V70G', '5190', 'Treo 650')

LIN-06
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

UI
U.P.C. Consumer Package Code (1-5-5)
LIN-07
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

UPC Code is not Mandatory. However, if you have this information, please include it in this element.

LIN-08
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

SK
Stock Keeping Unit (SKU)
LIN-09
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The AT&T Mobility SKU is required on ALL Warehouse Orders, but not on Non-Warehouse Orders.

The AT&T Mobility SKU is sent in the Purchase Order. The value in the LIN09 element should be the numeric portion of the LIN03 Buyers Catalog Number; do not send the 'XXX.' prefix in the LIN09.

SN1
030
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Pack > HL Loop > SN1

Item Detail (Shipment)

RequiredMax use 1

To specify line-item detail relative to shipment

Usage notes

Sample EDI:
Warehouse Orders:
SN100012000*EA~

Example
SN1-01
350
Assigned Identification
Required
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • SN101 is the ship notice line-item identification.
Usage notes

Must match the Line Number from the LIN segment (LIN01) exactly

SN1-02
382
Number of Units Shipped
Required
Decimal number (R)
Min 1Max 10

Numeric value of units shipped in manufacturer's shipping units for a line item or transaction set

Usage notes

Serialized: Total number of eaches in the carton/container. This quantity will be the number of Serialized eaches in the carton/container. The SN102 must match the number of HL Kit level SLN segment iterations.

Non-Serialized: Total number of eaches in the carton/container. This quantity will be the number of Non-Serialized eaches in the carton/container.

SN1-03
355
Unit or Basis for Measurement Code
Required
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

  • SN103 defines the unit of measurement for both SN102 and SN104.
EA
Each
PO4
060
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Pack > HL Loop > PO4

Item Physical Details

RequiredMax use 1

To specify the physical qualities, packaging, weights, and dimensions relating to the item

Usage notes

For SIM cards, the box inside the outer carton contains 4 packs of 250 each. The PO401 would be 1000 and the PO414 should be 1.

# Sim Card Example:
PO41000***********1~
For handsets, no Inner Pack is used. You should send just the PO401.
Handset Example:
PO4
10~

Non-Warehouse Orders:
This segment is not Mandatory for Non-Warehouse Orders.
Sample EDI:
PO41000***********1~ (SIM cards)
or
PO4
1~ (handsets)

Example
PO4-01
356
Pack
Required
Numeric (N0)
Min 1Max 6

The number of inner containers, or number of eaches if there are no inner containers, per outer container

PO4-14
810
Inner Pack
Optional
Numeric (N0)
Min 1Max 6

The number of eaches per inner container

REF
150
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Pack > HL Loop > REF

Buyer Identification

RequiredMax use 1

To specify identifying information

Usage notes

The REF*YD segment is Mandatory. The YD qualifier references whether the line item is SERIALIZED or NON-SERIALIZED.

SERIALIZED items are items that require the HL*K loop, which communicates all serialized infromation, such as IMEI, Unlock Code, Serial Number, MAC Address, etc.

Only one REF*YD segment is expected at the Item level per Item.

Valid examples for the REFYD:
REF
YDSERIALIZED~
REF
YD*NON-SERIALIZED~

Example
Variants (all may be used)
REFShipment Number
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

YD
Buyer Identification
REF-02
127
Reference Identification
Required
String (AN)

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

NON-SERIALIZED
SERIALIZED
REF
150
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Pack > HL Loop > REF

Shipment Number

OptionalMax use 1

To specify identifying information

Usage notes
# Warehouse Orders:
The Trading Partner must send the ShipNum (Shipment Number) value from the original Purchase Order created by AT&T Mobility.
** Contact your AT&T Mobility Buyer if you do not receive the ShipNum on the paper/PDF Purchase Order.

Non-Warehouse Orders:
This segment is not Mandatory for Non-Warehouse Orders.

The REF02 (ZZ qualifier) must be expressed in 4 numeric characters, with leading zeros.

examples:
ShipNum 01 will be 0001.
ShipNum 10 will be 0010.

Sample EDI:
Warehouse Orders:
REFZZSHIPNUM~

Example
Variants (all may be used)
REFBuyer Identification
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

ZZ
Mutually Defined
REF-02
127
Reference Identification
Required
String (AN)
Min 1Max 30

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

HL Loop
OptionalMax >1
Usage notes

The HL Kit loop is Required if the product is Serialized.
The HL Kit loop is NOT Required if the product is Non-Serialized product (i.e. Accessories)

HL
010
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Pack > HL Loop > HL Loop > HL

Hierarchical Level

RequiredMax use 1

To identify dependencies among and the content of hierarchically related groups of data segments

  • The HL segment is the only mandatory segment within the HL loop, and by itself, the HL segment has no meaning.
Example
HL-01
628
Hierarchical ID Number
Required
String (AN)
Min 1Max 12

A unique number assigned by the sender to identify a particular data segment in a hierarchical structure

  • HL01 shall contain a unique alphanumeric number for each occurrence of the HL segment in the transaction set. For example, HL01 could be used to indicate the number of occurrences of the HL segment, in which case the value of HL01 would be "1" for the initial HL segment and would be incremented by one in each subsequent HL segment within the transaction.
HL-02
734
Hierarchical Parent ID Number
Required
String (AN)
Min 1Max 12

Identification number of the next higher hierarchical data segment that the data segment being described is subordinate to

  • HL02 identifies the hierarchical ID number of the HL segment to which the current HL segment is subordinate.
HL-03
735
Hierarchical Level Code
Required
Identifier (ID)

Code defining the characteristic of a level in a hierarchical structure

  • HL03 indicates the context of the series of segments following the current HL segment up to the next occurrence of an HL segment in the transaction. For example, HL03 is used to indicate that subsequent segments in the HL loop form a logical grouping of data referring to shipment, order, or item-level information.
K
Kit
HL-04
736
Hierarchical Child Code
Optional
Identifier (ID)

Code indicating if there are hierarchical child data segments subordinate to the level being described

  • HL04 indicates whether or not there are subordinate (or child) HL segments related to the current HL segment.
0
No Subordinate HL Segment in This Hierarchical Structure.
SLN
040
Detail > HL Loop > HL Loop > HL Loop Shipping Tare > HL Loop Pack > HL Loop > HL Loop > SLN

Subline Item Detail

RequiredMax use 1000

To specify product subline detail item data

Usage notes

Sample EDI:
For WIRELESS Equipment:
with ICC-ID:
SLN00011I1EA********IC12345678901234567890IS356862003671263TW65225359*PJ20051101*ZZR47R~
without ICC-ID:
SLN00011I1EA***IS356862003671263*TW65225359*PJ20051101*ZZR47R~
without Unlock Code:
SLN00011I1EA***IS356862003671263*TWUNLOCK_NOT_SENT*PJ20051101*ZZR472R~
For WIRELINE Equipment:
with Serial Number & MAC Address:
SLN00011I1EASN123456789012*MA210987654321*PJ20051101ZZR472_G_08.18.40R~
without Serial Number:
SLN
00011I1EA*****
SNSERIAL_NOT_SENT**MA210987654321*PJ20051101ZZ*R472_G_08.18.40R~
without MAC Address:
SLN
00011I1EA*SN123456789012**MAMAC_NOT_SENTPJ20051101ZZR472_G_08.18.40R~

Example
If either Product/Service ID Qualifier (SLN-11) or Product/Service ID (SLN-12) is present, then the other is required
If either Product/Service ID Qualifier (SLN-13) or Product/Service ID (SLN-14) is present, then the other is required
If either Product/Service ID Qualifier (SLN-15) or Product/Service ID (SLN-16) is present, then the other is required
If either Product/Service ID Qualifier (SLN-17) or Product/Service ID (SLN-18) is present, then the other is required
If either Product/Service ID Qualifier (SLN-19) or Product/Service ID (SLN-20) is present, then the other is required
If either Product/Service ID Qualifier (SLN-25) or Product/Service ID (SLN-26) is present, then the other is required
SLN-01
350
Assigned Identification
Required
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • SLN01 is the identifying number for the subline item.
  • SLN01 is related to (but not necessarily equivalent to) the baseline item number. Example: 1.1 or 1A might be used as a subline number to relate to baseline number 1.
Usage notes

Must match the Line Number from the LIN segment (LIN01) exactly.

SLN-02
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • SLN02 is the identifying number for the subline level. The subline level is analogous to the level code used in a bill of materials.
Usage notes

Unique Counter for each SLN iteration.

SLN-03
662
Relationship Code
Required
Identifier (ID)

Code indicating the relationship between entities

  • SLN03 is the configuration code indicating the relationship of the subline item to the baseline item.
I
Included
SLN-04
380
Quantity
Required
Decimal number (R)
Min 1Max 15

Numeric value of quantity

Usage notes

Usually a quantity of 1.

SLN-05
C001
Composite Unit of Measure
OptionalMax use 1
To identify a composite unit of measure (See Figures Appendix for examples of use)
C001-01
355
Unit or Basis for Measurement Code
Required
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

EA
Each
SLN-11
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

SN
Serial Number
SLN-12
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN11 and SLN12 are mandatory for all WIRELINE equipment.
** Serial Number is mandatory for all wireline equipment. There will only be one Serial Number per piece of wireline equipment. If Serial Number is not being sent in the SLN segment of the EDI 856 based on a prior legal agreement with AT&T, please include the following hardcoded text within the SLN12 element: SERIAL_NOT_SENT.

SLN-13
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

IC
ICC-ID (SIM Serial Number)
SLN-14
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN14 contains the ICC-ID (SIM Serial Number).
** ICC-ID (SIM Cards Serial Number) is mandatory for all WIRELESS equipment that is pre-packaged with SIM Cards. There will only be one ICC-ID per handset/data device.

SLN-15
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

IS
International Standard Serial Number (ISSN)

IMEI Code

SLN-16
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN16 contains the IMEI number. The SLN15 and SLN16 are mandatory for all WIRELESS equipment.

SLN-17
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

TW
Program Code

Subsidy Unlock Code

SLN-18
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN17 and SLN18 are mandatory for all WIRELESS equipment.
** Subsidy Unlock Codes (SIMLOCK3 or SIMLOCK4) are mandatory for all wireless equipment. There will only be one Subsidy Unlock Code per handset/data device. If Subsidy Unlock Code is not being sent in the SLN segment of the EDI 856 based on a prior legal agreement with AT&T, please include the following hardcoded text within the SLN18 element: UNLOCK_NOT_SENT.

SLN-19
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

MA
Media Access Control (MAC) Address
OI
OEM Identification Code
SLN-20
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN19 and SLN20 are mandatory for all WIRELINE equipment.
** Media Access Control (MAC) Address is mandatory for all wireline equipment. There will only be one Media Access Control (MAC) Address per piece of wireline equipment. If Media Access Control (MAC) Address is not being sent in the SLN segment of the EDI 856 based on a prior legal agreement with AT&T, please include the following hardcoded text within the SLN20 element: MAC_NOT_SENT.

The SLN19 and SLN20 are mandatory for all FEMTOCELL equipment.
** OEM Identification Code is mandatory for all FemtoCell equipment. There will only be one OEM Identification Code per piece of FemtoCell equipment.

SLN-21
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

PJ
Product Date Code (A code indicating the period during which a product was manufactured.)

Manufacture Date

SLN-22
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN21 and SLN22 are mandatory for all WIRELESS equipment.

Format Date as CCYYMMDD. If the Manufacture Date is not formatted correctly, the EDI856 transaction will be rejected.

Manufacture Date - This is the date which the device was manufactured.

SLN-23
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

ZZ
Software/Firmware Version
SLN-24
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The SLN23 and SLN24 are mandatory for all WIRELESS equipment.
Firmware Version - Build or version of firmware on the phone.
Vendor Firmware Version Number must be sent for all handset/data card devices.
AT&T Mobility is expecting the Operating System (OS) Software/Firmware version in SLN24.

For handsets/data devices that also utilize a Flex Version, please use the SLN25 and SLN26.

SLN-25
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

RN
Flex Version
SLN-26
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

Flex Version - Depending on the device, a Flex Version will identify the build of the software. This field will contain the appropriate information of this build. This should be blank if it is not applicable to a device.

For handsets/data devices that also utilize a Flex Version, please use the SLN25 and SLN26.

HL Loop end
HL Loop end
HL Loop Pack end
HL Loop Shipping Tare end
HL Loop end
HL Loop end
Detail end

Summary

CTT
010
Summary > CTT

Transaction Totals

RequiredMax use 1

To transmit a hash total for a specific element in the transaction set

  • Number of line items (CTT01) is the accumulation of the number of HL segments.
    If used, hash total (CTT02) is the sum of the value of units shipped (SN102) for each SN1 segment.
Usage notes

Sample EDI:
CTT0120002005~

Example
CTT-01
354
Number of Line Items
Required
Numeric (N0)
Min 1Max 6

Total number of line items in the transaction set

Usage notes

The CTT01 contains the total number of Eaches in the shipment. If the product is serialized (such as handsets), the CTT01 should contain the total number of SLN segments in the HL Kit level loop. If the product is not serialized (such as accessories), the CTT01 should contain the total number of eaches in the shipment (sum of the SN102 from the item level).

Example:
If there are two HL Item level loops in the 856, the sum of the SN102 elements must be provided in the CTT01.

HL Item Loop # 1
LIN Item 2
SN10001500EA~
...
HL Item Loop # 2
LIN Item 2
SN1
00021000EA~
...
CTT0115001503~

CTT-02
347
Hash Total
Required
Decimal number (R)
Min 1Max 10

Sum of values of the specified data element. All values in the data element will be summed without regard to decimal points (explicit or implicit) or signs. Truncation will occur on the left most digits if the sum is greater than the maximum size of the hash total of the data element.

## Example:
-.0018 First occurrence of value being hashed.
.18 Second occurrence of value being hashed.
1.8 Third occurrence of value being hashed.
18.01 Fourth occurrence of value being hashed.

1855 Hash total prior to truncation.
855 Hash total after truncation to three-digit field.

Usage notes

The CTT02 must contain the Total Count of all HL segments

SE
020
Summary > SE

Transaction Set Trailer

RequiredMax use 1

To indicate the end of the transaction set and provide the count of the transmitted segments (including the beginning (ST) and ending (SE) segments)

Example
SE-01
96
Number of Included Segments
Required
Numeric (N0)
Min 1Max 10

Total number of segments included in a transaction set including ST and SE segments

SE-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9

Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set

Summary end

Functional Group Trailer

RequiredMax use 1

To indicate the end of a functional group and to provide control information

Example
GE-01
97
Number of Transaction Sets Included
Required
Numeric (N0)
Min 1Max 6

Total number of transaction sets included in the functional group or interchange (transmission) group terminated by the trailer containing this data element

GE-02
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Assigned number originated and maintained by the sender

Interchange Control Trailer

RequiredMax use 1

To define the end of an interchange of zero or more functional groups and interchange-related control segments

Example
IEA-01
I16
Number of Included Functional Groups
Required
Numeric (N0)
Min 1Max 5

A count of the number of functional groups included in an interchange

IEA-02
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9

A control number assigned by the interchange sender

Stedi is a registered trademark of Stedi, Inc. All names, logos, and brands of third parties listed on this page are trademarks of their respective owners (including “X12”, which is a trademark of X12 Incorporated). Stedi, Inc. and its products and services are not endorsed by, sponsored by, or affiliated with these third parties. Use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.