AT&T
/
Purchase Order
  • Specification
  • EDI Inspector
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 850 Purchase Order

X12 Release 4010

This Draft Standard for Trial Use contains the format and establishes the data contents of the Purchase Order Transaction Set (850) for use within the context of an Electronic Data Interchange (EDI) environment. The transaction set can be used to provide for customary and established business and industry practice relative to the placement of purchase orders for goods and services. This transaction set should not be used to convey purchase order changes or purchase order acknowledgment information.

Delimiters
  • ~ Segment
  • * Element
  • > Component
EDI sample
  • Sample
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/at-t/purchase-order/01H2WZTCZCKRFZJBSVN6WCX3BF
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
ST
010
Transaction Set Header
Max use 1
Required
BEG
020
Beginning Segment for Purchase Order
Max use 1
Required
CUR
040
Currency
Max use 1
Optional
REF
050
PO Type
Max use 1
Required
REF
050
Quote Number
Max use 1
Optional
REF
050
Supplier Number
Max use 1
Required
PER
060
Administrative Communications Contact
Max use 3
Required
FOB
080
F.O.B. Related Instructions
Max use 1
Optional
ITD
130
Terms of Sale/Deferred Terms of Sale
Max use 1
Optional
AMT Loop
Bill To
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

PO
Purchase Order (850)
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

Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

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).
850
Purchase Order
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

BEG
020
Heading > BEG

Beginning Segment for Purchase Order

RequiredMax use 1

To indicate the beginning of the Purchase Order Transaction Set and transmit identifying numbers and dates

Usage notes

Sample EDI:
BEG00SA99999990*20070606~

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

Code identifying purpose of transaction set

00
Original
BEG-02
92
Purchase Order Type Code
Required
Identifier (ID)

Code specifying the type of Purchase Order

BK
Blanket Order (Quantity Firm)
RL
Release or Delivery Order

An order for goods and services placed against a pre-existing contract or blanket order

SA
Stand-alone Order
BEG-03
324
Purchase Order Number
Required
String (AN)
Min 1Max 22

Identifying number for Purchase Order assigned by the orderer/purchaser

BEG-04
328
Release Number
Optional
String (AN)
Min 1Max 30

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

Usage notes

For Release Orders, the presence of the Release Number > 0 indicates a Release Purchase Order for a previously sent Blanket Purchase Order. The Release Number is required on all EDI transactions sent to AT&T Mobility. Default is '0'.

Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • BEG05 is the date assigned by the purchaser to purchase order.
CUR
040
Heading > CUR

Currency

OptionalMax use 1

To specify the currency (dollars, pounds, francs, etc.) used in a transaction

Usage notes

Sample EDI:
CURBYUSD~

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

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

BY
Buying Party (Purchaser)
CUR-02
100
Currency Code
Required
Identifier (ID)
Min 3Max 3

Code (Standard ISO) for country in whose currency the charges are specified

REF
050
Heading > REF

PO Type

RequiredMax use 1

To specify identifying information

Usage notes

The REF*ZZ will always be sent to the Vendor in the Purchase Order.

Sample EDI:
REFZZHandset Device Accessory~

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

Code qualifying the Reference Identification

ZZ
PO Type
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

REF
050
Heading > REF

Quote Number

OptionalMax use 1

To specify identifying information

Usage notes

The Quote Reference Segment is not used for Handset Device Accessory Vendors.

Sample EDI:
REFQ1999999999~

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

Code qualifying the Reference Identification

Q1
Quote 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

REF
050
Heading > REF

Supplier Number

RequiredMax use 1

To specify identifying information

Usage notes

Sample EDI:
REFZA99999999~

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

Code qualifying the Reference Identification

ZA
Supplier
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

Usage notes

AT&T Mobility assigned Vendor Number.

PER
060
Heading > PER

Administrative Communications Contact

RequiredMax use 3

To identify a person or office to whom administrative communications should be directed

Usage notes

Sample EDI:
PERBDFirstName LastNameTE123-456-7890**EMemail.address@company.com~

Example
If either Communication Number Qualifier (PER-05) or Communication Number (PER-06) is present, then the other is required
If either Communication Number Qualifier (PER-07) or Communication Number (PER-08) is present, then the other is required
PER-01
366
Contact Function Code
Required
Identifier (ID)

Code identifying the major duty or responsibility of the person or group named

BD
Buyer Name or Department
Required
String (AN)
Min 1Max 60

Free-form name

PER-03
365
Communication Number Qualifier
Required
Identifier (ID)

Code identifying the type of communication number

TE
Telephone
PER-04
364
Communication Number
Required
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

PER-05
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

FX
Facsimile
PER-06
364
Communication Number
Optional
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

PER-07
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

EM
Electronic Mail
PER-08
364
Communication Number
Optional
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

FOB
080
Heading > FOB

F.O.B. Related Instructions

OptionalMax use >1

To specify transportation instructions relating to shipment

Usage notes

Sample EDI:
FOB*PC~

Example
FOB-01
146
Shipment Method of Payment
Required
Identifier (ID)

Code identifying payment terms for transportation charges

  • FOB01 indicates which party will pay the carrier.
PC
Prepaid but Charged to Customer
ITD
130
Heading > ITD

Terms of Sale/Deferred Terms of Sale

OptionalMax use >1

To specify terms of sale

Usage notes

Sample EDI:
ITD013**********IMMEDIATE~

Example
ITD-01
336
Terms Type Code
Required
Identifier (ID)

Code identifying type of payment terms

  • If the code in ITD01 is "04", then ITD07 or ITD09 is required and either ITD10 or ITD11 is required; if the code in ITD01 is "05", then ITD06 or ITD07 is required.
01
Basic
ITD-02
333
Terms Basis Date Code
Required
Identifier (ID)

Code identifying the beginning of the terms period

3
Invoice Date
ITD-12
352
Description
Required
String (AN)
Min 1Max 80

A free-form description to clarify the related data elements and their content

AMT Loop
OptionalMax >1
Usage notes

This loop only used for Blanket POs.

AMT
287
Heading > AMT Loop > AMT

Monetary Amount

RequiredMax use 1

To indicate the total monetary amount

Usage notes

This segment only used for Blanket POs.

Sample EDI:
AMTACR12200*D~

Example
AMT-01
522
Amount Qualifier Code
Required
Identifier (ID)

Code to qualify amount

ACR
Amount Involved
AMT-02
782
Monetary Amount
Required
Decimal number (R)
Min 1Max 15

Monetary amount

Usage notes

If a Blanket Purchase Order, the AMT02 will contain the Amount Agreed.

AMT-03
478
Credit/Debit Flag Code
Required
Identifier (ID)
Min 1Max 1

Code indicating whether amount is a credit or debit

DTM
290
Heading > AMT Loop > DTM

Date/Time Reference

OptionalMax use 1

To specify pertinent dates and times

Usage notes

This segment only used for Blanket POs.

Sample EDI:
DTM00720070630~

Example
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)

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

007
Effective
Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

AMT Loop end
N9 Loop
OptionalMax >1
N9
295
Heading > N9 Loop > N9

Reference Identification

RequiredMax use 1

To transmit identifying information as specified by the Reference Identification Qualifier

Usage notes

With N9*ZZ, AT&T Mobility will always send the value "AT&T MOBILITY MESSAGES" if the header level MSG segments exist.

Sample EDI:
N9ZZAT&T MOBILITY MESSAGES~

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

Code qualifying the Reference Identification

ZZ
Message Type
N9-02
127
Reference Identification
Required
String (AN)

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

AT&T MOBILITY MESSAGES
AT&T MOBILITY MESSAGES
MSG
300
Heading > N9 Loop > MSG

Message Text

OptionalMax use 1000

To provide a free-form format that allows the transmission of text information

Usage notes

Sample EDI:
MSGFREE-FORM MESSAGE TEXTSS~

Example
MSG-01
933
Free-Form Message Text
Required
String (AN)
Min 1Max 264

Free-form message text

MSG-02
934
Printer Carriage Control Code
Required
Identifier (ID)

A field to be used for the control of the line feed of the receiving printer

  • MSG02 is not related to the specific characteristics of a printer, but identifies top of page, advance a line, etc.
SS
Advance to new line before print
N9 Loop end
N1 Bill To
RequiredMax 1
Variants (all may be used)
Ship ToVendor
N1
310
Heading > Bill To > N1

Name

RequiredMax use 1

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

Usage notes

Sample EDI:
N1BTBILL TO PARTY~

Example
If either Identification Code Qualifier (N1-03) or Identification Code (N1-04) is present, then the other is required
N1-01
98
Entity Identifier Code
Required
Identifier (ID)

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

BT
Bill-to-Party
Required
String (AN)
Min 1Max 60

Free-form name

N1-03
66
Identification Code Qualifier
Optional
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
Optional
String (AN)
Min 2Max 80

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.
N3
330
Heading > Bill To > N3

Address Information

OptionalMax use 2

To specify the location of the named party

Usage notes

Sample EDI:
N3*STREET ADDRESS~

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
340
Heading > Bill To > N4

Geographic Location

OptionalMax use >1

To specify the geographic place of the named party

Usage notes

Sample EDI:
N4CITYSTZIPCOUS~

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

PER
360
Heading > Bill To > PER

Administrative Communications Contact

RequiredMax use >1

To identify a person or office to whom administrative communications should be directed

Usage notes

Sample EDI:
PERBIFirstName LastNameTE123-456-7890**EMemail.address@company.com~

Example
If either Communication Number Qualifier (PER-05) or Communication Number (PER-06) is present, then the other is required
If either Communication Number Qualifier (PER-07) or Communication Number (PER-08) is present, then the other is required
PER-01
366
Contact Function Code
Required
Identifier (ID)

Code identifying the major duty or responsibility of the person or group named

BI
Bill Inquiry Contact
Required
String (AN)
Min 1Max 60

Free-form name

PER-03
365
Communication Number Qualifier
Required
Identifier (ID)

Code identifying the type of communication number

TE
Telephone
PER-04
364
Communication Number
Required
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

PER-05
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

FX
Facsimile
PER-06
364
Communication Number
Optional
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

PER-07
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

EM
Electronic Mail
PER-08
364
Communication Number
Optional
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

N1 Bill To end
N1 Ship To
RequiredMax 1
Variants (all may be used)
Bill ToVendor
N1
310
Heading > Ship To > N1

Name

RequiredMax use 1

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

Usage notes

Sample EDI:
N1STSHIP TO~

Example
If either Identification Code Qualifier (N1-03) or Identification Code (N1-04) is present, then the other is required
N1-01
98
Entity Identifier Code
Required
Identifier (ID)

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

ST
Ship To
Required
String (AN)
Min 1Max 60

Free-form name

N1-03
66
Identification Code Qualifier
Optional
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
Optional
String (AN)
Min 2Max 80

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.
N3
330
Heading > Ship To > N3

Address Information

OptionalMax use 2

To specify the location of the named party

Usage notes

Sample EDI:
N3*STREET ADDRESS~

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
340
Heading > Ship To > N4

Geographic Location

OptionalMax use >1

To specify the geographic place of the named party

Usage notes

Sample EDI:
N4CITYSTZIPCOUS~

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

PER
360
Heading > Ship To > PER

Administrative Communications Contact

RequiredMax use >1

To identify a person or office to whom administrative communications should be directed

Usage notes

Sample EDI:
PERSTFirstName LastNameTE123-456-7890**EMemail.address@company.com~

Example
If either Communication Number Qualifier (PER-05) or Communication Number (PER-06) is present, then the other is required
If either Communication Number Qualifier (PER-07) or Communication Number (PER-08) is present, then the other is required
PER-01
366
Contact Function Code
Required
Identifier (ID)

Code identifying the major duty or responsibility of the person or group named

ST
Ship To Contact
Required
String (AN)
Min 1Max 60

Free-form name

PER-03
365
Communication Number Qualifier
Required
Identifier (ID)

Code identifying the type of communication number

TE
Telephone
PER-04
364
Communication Number
Required
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

PER-05
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

FX
Facsimile
PER-06
364
Communication Number
Optional
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

PER-07
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

EM
Electronic Mail
PER-08
364
Communication Number
Optional
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

N1 Ship To end
N1 Vendor
RequiredMax 1
Variants (all may be used)
Bill ToShip To
N1
310
Heading > Vendor > N1

Name

RequiredMax use 1

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

Usage notes

Sample EDI:
N1VNVENDOR NAME92VENDOR ID~

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

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

VN
Vendor
Required
String (AN)
Min 1Max 60

Free-form name

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)
Min 2Max 80

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.
N3
330
Heading > Vendor > N3

Address Information

OptionalMax use 2

To specify the location of the named party

Usage notes

Sample EDI:
N3*STREET ADDRESS~

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
340
Heading > Vendor > N4

Geographic Location

OptionalMax use >1

To specify the geographic place of the named party

Usage notes

Sample EDI:
N4CITYSTZIPCOUS~

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

PER
360
Heading > Vendor > PER

Administrative Communications Contact

RequiredMax use >1

To identify a person or office to whom administrative communications should be directed

Usage notes

Sample EDI:
PERSUFirstName LastNameTE123-456-7890**EMemail.address@company.com~

Example
If either Communication Number Qualifier (PER-05) or Communication Number (PER-06) is present, then the other is required
If either Communication Number Qualifier (PER-07) or Communication Number (PER-08) is present, then the other is required
PER-01
366
Contact Function Code
Required
Identifier (ID)

Code identifying the major duty or responsibility of the person or group named

SU
Supplier Contact
Required
String (AN)
Min 1Max 60

Free-form name

PER-03
365
Communication Number Qualifier
Required
Identifier (ID)

Code identifying the type of communication number

TE
Telephone
PER-04
364
Communication Number
Required
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

PER-05
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

FX
Facsimile
PER-06
364
Communication Number
Optional
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

PER-07
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

EM
Electronic Mail
PER-08
364
Communication Number
Optional
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

N1 Vendor end
Heading end

Detail

PO1 Loop
RequiredMax >1
PO1
010
Detail > PO1 Loop > PO1

Baseline Item Data

RequiredMax use 1

To specify basic and most frequently used line item data

  • PO102 is required.
Usage notes

Sample EDI:
PO11100EA424*SKRTL.12345VNITEM DESCRIPTION~

Example
PO1-01
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • PO101 is the line item identification.
PO1-02
330
Quantity Ordered
Required
Decimal number (R)
Min 1Max 15

Quantity ordered

PO1-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

BG
Bag
BX
Box
CA
Case
CT
Carton
DA
Days
DZ
Dozen
EA
Each
FT
Foot
HR
Hours
HU
Hundred
LB
Pound
LO
Lot
MO
Months
PD
Pad
PF
Pallet (Lift)
PK
Package
Q1
Quarter (Time)
RL
Roll
RM
Ream
ST
Set
SY
Square Yard
TH
Thousand
YR
Years
PO1-04
212
Unit Price
Required
Decimal number (R)
Min 1Max 15

Price per unit of product, service, commodity, etc.

PO1-06
235
Product/Service ID Qualifier
Required
Identifier (ID)

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

  • PO106 through PO125 provide for ten different product/service IDs per each item. For example: Case, Color, Drawing No., U.P.C. No., ISBN No., Model No., or SKU.
SK
Stock Keeping Unit (SKU)
PO1-07
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

This is the AT&T Mobility SKU

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

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

VN
Vendor's (Seller's) Item Number
PO1-09
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

This is the Vendor SKU

PO3
030
Detail > PO1 Loop > PO3

Additional Item Detail

OptionalMax use 25

To specify additional item-related data involving variations in normal price/quantity structure

Usage notes

The PO3 segment is only used to pass the Extended Price to the partner.

The PO301 is not used as a Change to the Purchase Order but is used as per the X12 Standard requirements dictate.

Sample EDI:
PO3UP20070606EST42400*100EA~

Example
PO3-01
371
Change Reason Code
Required
Identifier (ID)

Code specifying the reason for price or quantity change

UP
Unit Price
Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

PO3-03
236
Price Identifier Code
Required
Identifier (ID)

Code identifying pricing specification

EST
Estimated Price
PO3-04
212
Unit Price
Optional
Decimal number (R)
Min 1Max 15

Price per unit of product, service, commodity, etc.

Usage notes

Extended Unit Price - This is the total price for the line item.

Calculated as Line Item Quantity x Item Unit Price = Extended Unit Price

PO3-06
380
Quantity
Required
Decimal number (R)
Min 1Max 15

Numeric value of quantity

Usage notes

This should match the Item Quantity for the item in the matching PO1 segment.

PO3-07
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

  • PO307 defines the unit of measure for PO306.
BG
Bag
BX
Box
CA
Case
CT
Carton
DA
Days
DZ
Dozen
EA
Each
FT
Foot
HR
Hours
HU
Hundred
LB
Pound
LO
Lot
MO
Months
PD
Pad
PF
Pallet (Lift)
PK
Package
Q1
Quarter (Time)
RL
Roll
RM
Ream
ST
Set
SY
Square Yard
TH
Thousand
YR
Years
PO3-08
352
Description
Optional
String (AN)
Min 1Max 80

A free-form description to clarify the related data elements and their content

Usage notes

This contains the per item Unit Price from the PO1 segment.

The PO308 is used for informational purposes only to support the calculation.

PID Loop
RequiredMax >1
PID
050
Detail > PO1 Loop > PID Loop > PID

Product/Item Description

RequiredMax use 1

To describe a product or process in coded or free-form format

Usage notes

Sample EDI:
PIDF***ITEM DESCRIPTION~

Example
PID-01
349
Item Description Type
Required
Identifier (ID)

Code indicating the format of a description

  • If PID01 equals "F", then PID05 is used. If PID01 equals "S", then PID04 is used. If PID01 equals "X", then both PID04 and PID05 are used.
F
Free-form
PID-05
352
Description
Required
String (AN)
Min 1Max 80

A free-form description to clarify the related data elements and their content

PID Loop end
REF
100
Detail > PO1 Loop > REF

Reference Identification

RequiredMax use >1

To specify identifying information

Usage notes

Used to notify the trading partner that the line item is Taxable or Non-Taxable.

Sample EDI:
REFZZTAXABLE - YES~
REFZZTAXABLE - NO~

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

Code qualifying the Reference Identification

ZZ
Taxable Flag
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

Usage notes

Taxable Flag

TAXABLE - NO
TAXABLE - YES
MSG
289
Detail > PO1 Loop > MSG

Message Text

OptionalMax use >1

To provide a free-form format that allows the transmission of text information

Usage notes

Item Level messages/attachments

NOTE: AT&T Mobility can send Item Level messages/attachments as well as Shipment Level messages/attachments in the N9 loop which may follow this MSG segment.

Sample EDI:
MSGFREE-FORM MESSAGE TEXTSS~

Example
MSG-01
933
Free-Form Message Text
Required
String (AN)
Min 1Max 264

Free-form message text

MSG-02
934
Printer Carriage Control Code
Required
Identifier (ID)

A field to be used for the control of the line feed of the receiving printer

  • MSG02 is not related to the specific characteristics of a printer, but identifies top of page, advance a line, etc.
SS
Advance to new line before print
N9 Loop
OptionalMax >1
N9
330
Detail > PO1 Loop > N9 Loop > N9

Reference Identification

RequiredMax use 1

To transmit identifying information as specified by the Reference Identification Qualifier

Usage notes

With N9*ZZ, AT&T Mobility will always send the value "AT&T MOBILITY MESSAGES" if the header level MSG segments exist.

Sample EDI:
N9ZZAT&T MOBILITY MESSAGES~

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

Code qualifying the Reference Identification

ZZ
Message Type
N9-02
127
Reference Identification
Required
String (AN)

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

AT&T MOBILITY MESSAGES
AT&T MOBILITY MESSAGES
MSG
340
Detail > PO1 Loop > N9 Loop > MSG

Message Text

OptionalMax use 1000

To provide a free-form format that allows the transmission of text information

Usage notes

Shipment Level messages/attachments

NOTE: AT&T Mobility can send Item Level messages/attachments as well as Shipment Level messages/attachments in the MSG segment which may precede this N9 Loop.

Sample EDI:
MSGFREE-FORM MESSAGE TEXTSS~

Example
MSG-01
933
Free-Form Message Text
Required
String (AN)
Min 1Max 264

Free-form message text

MSG-02
934
Printer Carriage Control Code
Required
Identifier (ID)

A field to be used for the control of the line feed of the receiving printer

  • MSG02 is not related to the specific characteristics of a printer, but identifies top of page, advance a line, etc.
SS
Advance to new line before print
N9 Loop end
N1 Loop
RequiredMax >1
N1
350
Detail > PO1 Loop > N1 Loop > N1

Name

RequiredMax use 1

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

Usage notes

Sample EDI:
N1STMEMPHIS DISTRIBUTION CENTER9210107048~

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
Required
String (AN)

Free-form name

FORT WORTH DISTRIBUTION CENTER
MEMPHIS DISTRIBUTION CENTER
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
10110146
Ft. Worth Distribution Center
N3
370
Detail > PO1 Loop > N1 Loop > N3

Address Information

OptionalMax use 2

To specify the location of the named party

Usage notes

Sample EDI:
N3*STREET ADDRESS~

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
380
Detail > PO1 Loop > N1 Loop > N4

Geographic Location

OptionalMax use 1

To specify the geographic place of the named party

Usage notes

Sample EDI:
N4CITYSTZIPCOUS~

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

QTY
383
Detail > PO1 Loop > N1 Loop > QTY

Quantity

OptionalMax use >1

To specify quantity information

Usage notes

Sample EDI:
QTYB3100*EA~

Example
Only one of Quantity (QTY-02) or Free-Form Message (QTY-04) may be present
QTY-01
673
Quantity Qualifier
Required
Identifier (ID)

Code specifying the type of quantity

B3
Requested Amount
QTY-02
380
Quantity
Required
Decimal number (R)
Min 1Max 15

Numeric value of quantity

QTY-03
C001
Composite Unit of Measure
RequiredMax use 1
To identify a composite unit of measure (See Figures Appendix for examples of use)
Usage notes

QTY03 should match PO103

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

BG
Bag
BX
Box
CA
Case
CT
Carton
DA
Days
DZ
Dozen
EA
Each
FT
Foot
HR
Hours
HU
Hundred
LB
Pound
LO
Lot
MO
Months
PD
Pad
PF
Pallet (Lift)
PK
Package
Q1
Quarter (Time)
RL
Roll
RM
Ream
ST
Set
SY
Square Yard
TH
Thousand
YR
Years
QTY-04
61
Free-Form Message
Optional
String (AN)
Min 1Max 30

Free-form information

  • QTY04 is used when the quantity is non-numeric.
REF
390
Detail > PO1 Loop > N1 Loop > REF

Distribution Number

RequiredMax use 1

To specify identifying information

Usage notes

Distribution Number is being sent with the Line Item and is required for return on the EDI 855 PO Acknowledgement, the EDI 856 Shipment Notice and the EDI 810 Invoice. Default Distribution Number cannot be null.

Sample EDI:
REFKA1~

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

Code qualifying the Reference Identification

KA
Distribution List

Qualifies a list of addresses to which the distribution of something should be made

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

REF
390
Detail > PO1 Loop > N1 Loop > REF

Shipment Number

RequiredMax use 1

To specify identifying information

Usage notes

Shipment Number is being sent with the Line Item and is required for return on the EDI 855 PO Acknowledgement, the EDI 856 Shipment Notice and the EDI 810 Invoice. Default Shipment Number cannot be null.

Sample EDI:
REFSI1~

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

Code qualifying the Reference Identification

SI
Shipper's Identifying Number for Shipment (SID)

A unique number (to the shipper) assigned by the shipper to identify the shipment

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

PER
400
Detail > PO1 Loop > N1 Loop > PER

Delivery Contact

OptionalMax use 1

To identify a person or office to whom administrative communications should be directed

Usage notes

Sample EDI:
PERRQDELIVERY CONTACTTE123-456-7890~

Example
Variants (all may be used)
PERShip To Contact
If either Communication Number Qualifier (PER-03) or Communication Number (PER-04) is present, then the other is required
PER-01
366
Contact Function Code
Required
Identifier (ID)

Code identifying the major duty or responsibility of the person or group named

RQ
Delivery Contact
Required
String (AN)
Min 1Max 60

Free-form name

PER-03
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

TE
Telephone
PER-04
364
Communication Number
Optional
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

PER
400
Detail > PO1 Loop > N1 Loop > PER

Ship To Contact

OptionalMax use 1

To identify a person or office to whom administrative communications should be directed

Usage notes

Sample EDI:
PERDCSHIP TO CONTACTTE123-456-7890~

Example
Variants (all may be used)
PERDelivery Contact
If either Communication Number Qualifier (PER-03) or Communication Number (PER-04) is present, then the other is required
PER-01
366
Contact Function Code
Required
Identifier (ID)

Code identifying the major duty or responsibility of the person or group named

DC
Ship To Contact
Required
String (AN)
Min 1Max 60

Free-form name

PER-03
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

TE
Telephone
PER-04
364
Communication Number
Optional
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

DTM
406
Detail > PO1 Loop > N1 Loop > DTM

Date/Time Reference

RequiredMax use 1

To specify pertinent dates and times

Usage notes

Sample EDI:
DTM01720070630~

Example
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)

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

017
Estimated Delivery
Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

N1 Loop end
PO1 Loop end
Detail end

Summary

CTT Loop
RequiredMax >1
CTT
010
Summary > CTT Loop > CTT

Transaction Totals

RequiredMax use 1

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

  • The number of line items (CTT01) is the accumulation of the number of PO1 segments. If used, hash total (CTT02) is the sum of the value of quantities ordered (PO102) for each PO1 segment.
Usage notes

Sample EDI:
CTT*1~

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

Total number of line items in the transaction set

AMT
020
Summary > CTT Loop > AMT

Monetary Amount

RequiredMax use 1

To indicate the total monetary amount

  • If AMT is used in the summary area, then AMT01 will = TT and AMT02 will indicate total transaction amount as calculated by the sender.
Usage notes

Sample EDI:
AMTBAP42400*D~

Example
AMT-01
522
Amount Qualifier Code
Required
Identifier (ID)

Code to qualify amount

BAP
Total Amount Due
AMT-02
782
Monetary Amount
Required
Decimal number (R)
Min 1Max 15

Monetary amount

AMT-03
478
Credit/Debit Flag Code
Required
Identifier (ID)

Code indicating whether amount is a credit or debit

D
Debit
CTT Loop end
SE
030
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

EDI Samples

Sample

ST*850*0001~
BEG*00*SA*9999999*0*20070606~
CUR*BY*USD~
REF*Q1*999999999~
REF*ZZ*Handset Device Accessory~
REF*ZA*99999999~
PER*BD*FirstName LastName*TE*123-456-7890***EM*email.address@company.com~
FOB*PC~
ITD*01*3**********IMMEDIATE~
AMT*ACR*12200*D~
DTM*007*20070630~
N9*ZZ*AT&T MOBILITY MESSAGES~
MSG*FREE-FORM MESSAGE TEXT*SS~
N1*BT*BILL TO PARTY~
N3*STREET ADDRESS~
N4*CITY*ST*ZIPCO*US~
PER*BI*FirstName LastName*TE*123-456-7890***EM*email.address@company.com~
N1*ST*SHIP TO~
N3*STREET ADDRESS~
N4*CITY*ST*ZIPCO*US~
PER*ST*FirstName LastName*TE*123-456-7890***EM*email.address@company.com~
N1*VN*VENDOR NAME*92*VENDOR ID~
N3*STREET ADDRESS~
N4*CITY*ST*ZIPCO*US~
PER*SU*FirstName LastName*TE*123-456-7890***EM*email.address@company.com~
PO1*1*100*EA*424**SK*RTL.12345*VN*ITEM DESCRIPTION~
PO3*UP*20070606*EST*42400**100*EA~
PID*F****ITEM DESCRIPTION~
REF*ZZ*TAXABLE - YES~
MSG*FREE-FORM MESSAGE TEXT*SS~
N9*ZZ*AT&T MOBILITY MESSAGES~
MSG*FREE-FORM MESSAGE TEXT*SS~
N1*ST*MEMPHIS DISTRIBUTION CENTER*92*10107048~
N3*STREET ADDRESS~
N4*CITY*ST*ZIPCO*US~
QTY*B3*100*EA~
REF*KA*1~
REF*SI*1~
PER*DC*SHIP TO CONTACT*TE*123-456-7890~
PER*RQ*DELIVERY CONTACT*TE*123-456-7890~
DTM*017*20070630~
CTT*1~
AMT*BAP*42400*D~
SE*44*0001~

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.