GSA (General Services Administration)
/
Purchase Order 4010 (GSA ADV)
  • Specification
  • EDI Inspector
Stedi maintains this guide based on public documentation from GSA (General Services Administration). Contact GSA (General Services Administration) for official EDI specifications. To report any errors in this guide, please contact us.
Go to Stedi Network
GSA (General Services Administration) logo

X12 850 Purchase Order 4010 (GSA ADV)

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 samples
  • None included
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/gsa/purchase-order-4010-gsa-adv/01HH10H3K4BE9NS24M9EFEWV6G
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
REF
050
Reference Identification
Max use 1
Optional
PER
060
Administrative Communications Contact
Max use 3
Optional
FOB
080
F.O.B. Related Instructions
Max use 1
Optional
SAC Loop
DTM
150
Date/Time Reference
Max use 10
Optional
PKG
220
Marking, Packaging, Loading
Max use 200
Optional
MAN
270
Marks and Numbers
Max use 10
Optional
detail
PO1 Loop
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

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

Code identifying purpose of transaction set

00
Original

Use to indicate an original procurement instrument.

22
Information Copy

Use to indicate that this is an information copy of an original procurement instrument. This information copy is sent to addresses other than the selling party, e.g., the Contract Administration Office. Used for designation of Emergency Orders. Do not Ship Indicator.

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

Code specifying the type of Purchase Order

Usage notes

Use to identify the type of procurement instrument represented by this transaction set.

CN
Consigned Order

Use to indicate a store order.

NE
New Order
RL
Release or Delivery Order

Use to indicate releases, calls, or delivery orders against existing indefinite procurement instruments. Used by GSA Advantage.

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

Identifying number for Purchase Order assigned by the orderer/purchaser

Usage notes

Use to identify the procurement instrument identification number (PIIN) not the order against a basic procurement instrument, e.g., delivery order, release, or call. For delivery orders, cite the basic procurement instrument identification number (e.g., the contract or schedule number) and cite the delivery order or call number in BEG04. This is the contract number.

BEG-04
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

Use to identify the delivery order, call or release number, (e.g., the Supplemental PIIN) against the basic procurement instrument cited in BEG03.This is the delivery/purchase order number.

Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • BEG05 is the date assigned by the purchaser to purchase order.
Usage notes

When BEG04 is used, cite the date of the delivery order, call or release. When BEG04 is not used, cite the date of the procurement instrument in BEG03.

BEG-07
587
Acknowledgment Type
Optional
Identifier (ID)
Min 2Max 2

Code specifying the type of acknowledgment

REF
050
Heading > REF

Reference Identification

OptionalMax use >1

To specify identifying information

Usage notes
  1. Use this 1/REF/050 segment to identify reference numbers that apply to all of the line items. When the reference numbers vary by line item, use the 2/REF/100 segment.
Example
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

Usage notes

A request has been submitted to ASC X12 for a code to specify Type of Science and for Catalog number (for Research and Development work). If approved, these codes will be available for use in ASC X12 Version/Release 3050.

2E
Foreign Military Sales Case Number

Use to indicate that the order involves a foreign military sale.

AT
Appropriation Number

Use to indicate accounting appropriation data. Cite the data as a literal string in REF03.

BB
Authorization Number

Use to indicate the statutory authorization under which this order is negotiated. BPA Number

BE
Business Activity

Use to indicate a web order.

BM
Bill of Lading Number

Use to indicate a government bill of lading (GBL).

CO
Customer Order Number

Customer Express Order Number – postal number

CR
Customer Reference Number

Customer Fedex Number

DO
Delivery Order Number
DS
Defense Priorities Allocation System (DPAS) Priority Rating
E4
Charge Card Number

Use to indicate the government credit card under which payment for this instrument will be accomplished. When used, provide the credit card expiration date in the 1/DTM/150 segment citing code 036 in DTM01.

FI
File Identifier

Use to indicate the unique ID number.

IL
Internal Order Number

Use to indicate the requisition number (e.g., the MILSTRIP/FEDSTRIP document number).

IT
Internal Customer Number

6 character agency internal code.

P4
Project Code

Use to indicate the project number applicable to this order.

PH
Priority Rating

Use to indicate the MILSTRIP/FEDSTRIP priority.

PR
Price Quote Number

Use to indicate the contractor's bid, quote or proposal number.

RQ
Purchase Requisition Number

Use, as appropriate, to indicate an internal number such as a purchase request or purchase request order number. When citing a purchase request number, concatenate its line number with the purchase request number if it is necessary to transmit both numbers. CSC order number or Global Supply Order number

TG
Transportation Control Number (TCN)
TH
Transportation Account Code (TAC)
TN
Transaction Reference Number

Use to indicate the unique reference number of a related transaction set (e.g., an 841 transaction set carrying a related technical specification or drawing). Each transaction set has a unique number. In the case of the 841 transaction set, that number is carried in SPI02.

W6
Federal Supply Schedule Number
ZZ
Mutually Defined

Use to indicate another type of reference number. When used, identify the nature of the number in REF03. Examples of the numbers that can be included here (for which data maintenance has been submitted to ASC X12) are: Military Standard Number, Technical Document Number, Technical Order Number, Related Contract Line Item Number, and Standard 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

Usage notes

If a reference number has an associated revision number, suffix or extension, concatenate the reference and revision/suffix/extension number and carry the resultant number in this data element.

REF-03
352
Description
Optional
String (AN)
Min 1Max 80

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

Usage notes
  1. Use to carry additional information related to the number cited in REF02.

  2. When REF01 is code AT, cite the accounting appropriation as a literal string in this data element.

  3. When REF01 is code E4, cite the type of credit card.

PER
060
Heading > PER

Administrative Communications Contact

OptionalMax use 3

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

Usage notes
  1. Use to identify a contract when that party is not to be associated with an address. When an address is also required, use the 1/PER/360 segment.

  2. A request has been submitted to ASC X12 to add data element 443, Contact Inquiry Reference, at PER07. This data element will permit citing the title of the party identified in PER02. If approved, this data element will be available for use in ASC X12 Version/Release 3050.

Example
If either Communication Number Qualifier (PER-03) or Communication Number (PER-04) is present, then the other is required
If either Communication Number Qualifier (PER-05) or Communication Number (PER-06) 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

CD
Contract Contact
HM
Hazardous Material Contact
NT
Notification Contact

Use to indicate the party to be contacted for shipping instructions. Use only when LDT01 in the 1/LDT/160 segment cites code AI.

RE
Receiving Contact

Use to indicate the party to be contacted to schedule a shipment. Use only when LDT01 in the 1/LDT/160 segment cites code AI.

ZZ
Mutually Defined
Optional
String (AN)
Min 1Max 35

Free-form name

Usage notes

Cite the last name first, followed by the first name. Do not truncate the last name if the whole name is longer than 35 characters. Instead, truncate or use the initial of the first name.

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

Code identifying the type of communication number

EM
Electronic Mail
FX
Facsimile
IT
International Telephone

Include the country code.

TE
Telephone

Use to indicate the commercial telephone number of the individual cited in PER02.

PER-04
364
Communication Number
Optional
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

Usage notes

Use to specify a second communication number for the party cited in PER02. For example, if PER03/04 cites the commercial telephone number, then PER05/06 can be used to cite an electronic mail number.

EM
Electronic Mail
EX
Telephone Extension

Use only if PER03 is used citing either code AU or TE.

FX
Facsimile
IT
International Telephone

Include the country code.

TE
Telephone

Use to indicate the commercial telephone number of the individual cited in PER02.

PER-06
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
  1. Use this 1/FOB/080 segment if the FOB point and the acceptance location apply to all of the line items. When the FOB point or acceptance location vary by line item, use the 2/FOB/180 segment.

  2. This segment is not necessary when the order is for a service.

Example
If Description (FOB-03) is present, then Location Qualifier (FOB-02) is required
If Description (FOB-07) is present, then Location Qualifier (FOB-06) is required
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.
BP
Paid by Buyer

Use to indicate that the FOB point is origin.

PE
Prepaid and Summary Bill

Use to indicate that transportation costs are authorized to be prepaid and added to the invoice.

PP
Prepaid (by Seller)

Use to indicate that the FOB point is destination.

FOB-02
309
Location Qualifier
Optional
Identifier (ID)

Code identifying type of location

  • FOB02 is the code specifying transportation responsibility location.
Usage notes
  1. Use to identify the FOB point.

  2. A request has been submitted to ASC X12 to add codes for Port of Embarkation, Port of Loading, and Government Furnished Property FOB Point. We expect these codes will be available for use in ASC X12 Version/Release 3050.

DE
Destination (Shipping)
FV
Free Alongside Vessel (Free On Board [F.O.B.] Point)
IT
Intermediate FOB Point

Use to indicate a Freight Forwarder.

OR
Origin (Shipping Point)
ZZ
Mutually Defined

Use to indicate that the FOB point is neither origin nor destination. When used, cite the actual FOB point in FOB03. If the actual FOB point is an address or geographical location, use in conjunction with one iteration of the appropriate N1 loop, using code KX in N101.

FOB-03
352
Description
Optional
String (AN)
Min 1Max 80

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

Usage notes

Use to identify the FOB point only when FOB02 is code ZZ. If necessary, use one iteration of the N1 loop, using code KX in N101, to specify the address of the FOB point. Use is discouraged.

FOB-06
309
Location Qualifier
Optional
Identifier (ID)

Code identifying type of location

  • FOB06 is the code specifying the title passage location.
Usage notes

Use to identify the acceptance point.

DE
Destination (Shipping)
OR
Origin (Shipping Point)
ZZ
Mutually Defined

Use to indicate that the acceptance point is neither origin nor destination. When used, cite the actual acceptance point in FOB07. If the actual acceptance point is an address or geographic location, use in conjunction with one iteration of the N1 loop, using code ZZ in N101.

FOB-07
352
Description
Optional
String (AN)
Min 1Max 80

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

Usage notes

Use to identify the acceptance point when FOB06 is code ZZ. If necessary, use one iteration of the N1 loop, using code ZZ in N101, to specify the address of the acceptance point. Use is discouraged.

SAC Loop
OptionalMax 25
SAC
120
Heading > SAC Loop > SAC

Service, Promotion, Allowance, or Charge Information

RequiredMax use 1

To request or identify a service, promotion, allowance, or charge; to specify the amount or percentage for the service, promotion, allowance, or charge

Usage notes

Use the 1/SAC/120 segment to identify charges that apply to all of the line items. If the charges vary by line item, use the 2/SAC/130 segment.

Example
If either Unit or Basis for Measurement Code (SAC-09) or Quantity (SAC-10) is present, then the other is required
If Quantity (SAC-11) is present, then Quantity (SAC-10) is required
SAC-01
248
Allowance or Charge Indicator
Required
Identifier (ID)

Code which indicates an allowance or charge for the service specified

  • If SAC01 is "A" or "C", then at least one of SAC05, SAC07, or SAC08 is required.
A
Allowance
C
Charge
N
No Allowance or Charge
SAC-02
1300
Service, Promotion, Allowance, or Charge Code
Required
Identifier (ID)
Min 4Max 4

Code identifying the service, promotion, allowance, or charge

Usage notes

Use any code.
D230 Freight Surcharge – additional charges for emergency orders

SAC-05
610
Amount
Optional
Numeric (N2)
Min 1Max 15

Monetary amount

  • SAC05 is the total amount for the service, promotion, allowance, or charge.
  • If SAC05 is present with SAC07 or SAC08, then SAC05 takes precedence.
SAC-09
355
Unit or Basis for Measurement Code
Optional
Identifier (ID)
Min 2Max 2

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

Usage notes

A conversion table may be required to convert agency codes to codes used by ASC X12.

SAC-10
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

  • SAC10 and SAC11 is the quantity basis when the allowance or charge quantity is different from the purchase order or invoice quantity.
  • SAC10 and SAC11 used together indicate a quantity range, which could be a dollar amount, that is applicable to service, promotion, allowance, or charge.
  • In some business applications, it is necessary to advise the trading partner of the actual dollar amount that a particular allowance, charge, or promotion was based on to reduce ambiguity. This amount is commonly referred to as "Dollar Basis Amount". It is represented in the SAC segment in SAC10 using the qualifier "DO" - Dollars in SAC09.
Usage notes

Use to indicate the quantity to which the amount in SAC05 applies. SAC10/11 can be used together to specify a quantity range to which the amount in SAC05 applies.

SAC-11
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

SAC Loop end
DTM
150
Heading > DTM

Date/Time Reference

OptionalMax use 10

To specify pertinent dates and times

Usage notes
  1. Use this 1/DTM/150 segment to specify a required delivery date when it is expressed as an actual date. If the delivery schedule is expressed as a set number time period after the occurrence of some event, use the 1/LDT/160 segment. If the 1/LDT/160 segment is used, do not use this segment.

  2. Use this 1/DTM/150 segment to specify dates (e.g., quote date, transaction set date) if they apply to all of the line items in the order. When the dates vary by line item, use the 2/DTM/210 segment.

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

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

036
Expiration

Use to indicate the expiration date of the government credit card identified in the 1/REF/050 segment.

996
Required Delivery

Use to indicate that delivery is required on or before the specified date.

Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

PKG
220
Heading > PKG

Marking, Packaging, Loading

OptionalMax use 200

To describe marking, packaging, loading, and unloading requirements

Usage notes
  1. Use this 1/PKG/220 segment to identify packaging requirements that apply to all of the line items. When the packaging requirements vary by line item, use the 2/PKG/300 segment.
  2. Do not use when standard commercial packaging is acceptable.
Example
If Description (PKG-05) is present, then Item Description Type (PKG-01) is required
PKG-01
349
Item Description Type
Optional
Identifier (ID)

Code indicating the format of a description

  • If PKG01 equals "F", then PKG05 is used. If PKG01 equals "S", then PKG04 is used. If PKG01 equals "X", then both PKG04 and PKG05 are used.
F
Free-form

Use when the packaging information is provided in free-form text.

PKG-02
753
Packaging Characteristic Code
Optional
Identifier (ID)
Min 1Max 5

Code specifying the marking, packaging, loading and related characteristics being described

PKG-03
559
Agency Qualifier Code
Optional
Identifier (ID)

Code identifying the agency assigning the code values

  • Use PKG03 to indicate the organization that publishes the code list being referred to.
DD
Department of Defense
GS
General Services Administration (GSA)
MS
Military Standard

Use to indicate Military Documentation needed.

ZZ
Mutually Defined

Use to indicate an activity other than DoD or GSA. Use to indicate Commercial Documentation needed.

PKG-05
352
Description
Required
String (AN)
Min 1Max 80

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

  • Special marking or tagging data can be given in PKG05 (description).
Usage notes

Use to identify a string of MIL-STD 2073-2C packaging codes or to provide packaging information in free-form text. The MIL-STD 2073-2C code string uses a positional and sequential system. Coded data must appear in the sequence and the number of positions specified in Appendix F of MIL-STD 2073-1. Zeros shall be inserted in the code string for data that is not being provided. A comma (,) will be used as a delimiter between the data in the code string. Use of this data element is discouraged. Place text either “MILITARY” or “COMMERCIAL”

MAN
270
Heading > MAN

Marks and Numbers

OptionalMax use 10

To indicate identifying marks and numbers for shipping containers

Usage notes
  1. Use this 1/MAN/270 segment when marks and numbers apply to all of the line items. Use the 2/MAN/280 segment when the marks and numbers vary by line item.

  2. Use to identify such data as MILSTRIP/FEDSTRIP number, Transportation Control number, Project Priority number, and consignee related codes.

Example
If either Marks and Numbers Qualifier (MAN-04) or Marks and Numbers (MAN-05) is present, then the other is required
If Marks and Numbers (MAN-06) is present, then Marks and Numbers (MAN-05) is required
MAN-01
88
Marks and Numbers Qualifier
Required
Identifier (ID)

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.
S
Entire Shipment

Use to indicate that the marks and numbers are applicable to all line items in the order.

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.
MAN-03
87
Marks and Numbers
Optional
String (AN)
Min 1Max 48

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

  • MAN03 and/or MAN06 are only used when sending a range(s) of ID numbers.
  • When both MAN02/MAN03 and MAN05/MAN06 are used to send ranges of ID numbers, the integrity of the two ID numbers must be maintained.
MAN-04
88
Marks and Numbers Qualifier
Optional
Identifier (ID)

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

S
Entire Shipment

Use to indicate that the marks and numbers are applicable to all line items in the order.

MAN-05
87
Marks and Numbers
Optional
String (AN)
Min 1Max 48

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

  • When both MAN05 and MAN06 are used, MAN05 is the starting number of a sequential range, and MAN06 is the ending number of that range.
MAN-06
87
Marks and Numbers
Optional
String (AN)
Min 1Max 48

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

N1 Loop
OptionalMax 200
N1
310
Heading > N1 Loop > N1

Name

RequiredMax use 1

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

Usage notes
  1. Whenever possible, address information should be transmitted using code values contained in a combination of the N101, N103/04 data elements. Use N102 and the N2-N4 segments only when it is necessary to transmit the full address. For example, if a vendor can be identified by a DUNS/UEI number, it is not necessary to transmit the vendor's full address since the relationship between the DUNS/UEI number and the vendor's address can be established by accessing a data base in which the information is stored, having been put there at the time the vendor electronically registered as a federal government trading partner.

  2. Use the 1/N1/310 loop to identify organizations or people that apply to all of the line items, or are not applicable at the line item level (e.g., ordering party, etc.). When the addresses vary by line item, use the 2/N1/350 loop.

  3. Multiple iterations of this segment may be used: codes BY, SE, IU, IC, Z7, ST.

Example
If either Identification Code Qualifier (N1-03) or Identification Code (N1-04) is present, then the other is required
At least one of Name (N1-02) or Identification Code Qualifier (N1-03) 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

Use to indicate the Credit Card Holder Name

BY
Buying Party (Purchaser)

Use to indicate the purchasing office or activity.

IC
Intermediate Consignee

Use to indicate a freight forwarder. CRP

IU
Issuer

GSA Advantage or GSA Ebuy distinction

OB
Ordered By

Use to identify the activity placing an order against a basic contract.

PO
Party to Receive Invoice for Goods or Services

Use to indicate where the invoice should be mailed.

RC
Receiving Location

Use to indicate the store ID code.

SE
Selling Party
ST
Ship To

Use to indicate the address to which an item must be shipped. If the ship-to address is an FPO or APO, identify the FPO or APO in the N4 segment using N401 and N403.

SV
Service Performance Site

Use to indicate a location where a service, e.g., grass cutting, will be performed

Z7
Mark-for Party

IN Country address for overseas orders.

ZZ
Mutually Defined

Use to identify the acceptance location when it cannot be described using a point such as origin or destination.

Optional
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)

Usage notes
  1. Use, when applicable, to identify the named party.

  2. A request has been submitted to ASC X12 to add a code for Contractor Establishment Code. We expect this code to be available for use in the ASC X12 Version/Release 3050.

  3. While Federal EDI will use the DUNS number, other numbers may be required for a period of transition in order to cross-reference existing data bases with new procurement actions.

1
D-U-N-S Number, Dun & Bradstreet

Use of the DUNS or DUNS+4 is preferred over any other coded number to identify a named party.

9
D-U-N-S+4, D-U-N-S Number with Four Character Suffix

Use of the DUNS or DUNS+4 is preferred over any other coded number to identify a named party.

10
Department of Defense Activity Address Code (DODAAC)

Use to indicate either a Department of Defense Activity Address Code or a Civilian Agency Activity Address Code.

16
ZIP Code

Billing Zip Code

33
Commercial and Government Entity (CAGE)
US
UEI designation
ZZ
Mutually Defined
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.
N2
320
Heading > N1 Loop > N2

Additional Name Information

OptionalMax use 2

To specify additional names or those longer than 35 characters in length

Usage notes

This segment is not necessary when the cited party can be identified by a code value in N101/03/04.

Example
Required
String (AN)
Min 1Max 60

Free-form name

Optional
String (AN)
Min 1Max 60

Free-form name

N3
330
Heading > N1 Loop > N3

Address Information

OptionalMax use 2

To specify the location of the named party

Usage notes

This segment is not necessary when the party can be identified by a code value in N101/03/04.

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 > N1 Loop > N4

Geographic Location

OptionalMax use >1

To specify the geographic place of the named party

Usage notes
  1. This segment is not necessary when the party can be identified by a code value in N101/03/04.

  2. When identifying an APO/FPO, N401 carries the APO/FPO city name and N403 carries the ZIP code of the city.

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

Usage notes

A conversion table may be required to convert agency codes to ASC X12 codes.

PER
360
Heading > N1 Loop > PER

Administrative Communications Contact

OptionalMax use >1

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

Usage notes
  1. Use this 1/PER/360 segment to identify contacts not associated with an address.

  2. A request has been submitted to ASC X12 to add data element 443, Contact Inquiry Reference, at PER07. This data element will permit citing the title of the party identified in PER02. If approved, this data element will be available for use in ASC X12 Version/Release 3050.

Example
If either Communication Number Qualifier (PER-03) or Communication Number (PER-04) is present, then the other is required
If either Communication Number Qualifier (PER-05) or Communication Number (PER-06) 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

Usage notes

Use to identify individuals who can be contacted regarding the order.

1A
Review/Repricing Contact
  1. When N101 is code SE, use to indicate an individual who authorized a one time special price for line items in this award instrument, e.g., a spot pricing reduction from an existing contract or catalog price. In this instance, PER02 MUST be used.

  2. When used, the 1/REF/350 segment may be used to provide a special price authorization number by citing code 9B in REF01 and the 2/CTP/040 segment in the PO1 loop of the line items authorized the special price should be used citing code SPC in CTP02.

BD
Buyer Name or Department
CN
General Contact

When N101 is code ST, use to indicate the accepting official at destination.

HM
Hazardous Material Contact
PC
Purchasing Contracting Officer (PCO)
PD
Project Director

Use to indicate the Investigator, i.e., the principal party working on a research effort. A request has been submitted to ASC X12 to add a code for Investigator (for research and development work). We expect this code will be available for use in ASC X12 Version/Release 3050. In the meantime, use this code.

RP
Responsible Person

When N101 is code C4, use to indicate the accepting official at origin.

SU
Supplier Contact

Use to indicate the selling party's point of contact.

Optional
String (AN)
Min 1Max 35

Free-form name

Usage notes

Cite the last name first, followed by the first name. Do not truncate the last name if whole name is longer than 35 characters. Instead, truncate the first name or use the initial of the first name.

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

Code identifying the type of communication number

EM
Electronic Mail
FX
Facsimile
IT
International Telephone
TE
Telephone

Use to indicate the commercial telephone number of the individual cited in PER02.

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

Complete communications number including country or area code when applicable

Usage notes

When PER03 is code TE, include the area code.

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

Code identifying the type of communication number

Usage notes

Use to identify a second communications number for the party cited in PER02. For example, if PER03/04 cites a commercial telephone number, PER05/06 can be used to cite an Electronic Mail address.

EM
Electronic Mail
EX
Telephone Extension

Use only if PER03 is used citing either code AU or TE.

FX
Facsimile
IT
International Telephone

Include the country code.

TE
Telephone

Use to indicate the commercial telephone number of the individual cited in PER02.

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

Complete communications number including country or area code when applicable

Usage notes

When PER05 is code TE, include the area code.

N1 Loop end
Heading end

Detail

PO1 Loop
RequiredMax 100000
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

Use the 2/PO1/010 loop to specify all information related to a CLIN, SUBCLIN or ELIN. Each iteration of the PO1 loop will carry all the information related to the CLIN, SUBCLIN or ELIN cited in PO101.

Example
If Unit or Basis for Measurement Code (PO1-03) is present, then Quantity Ordered (PO1-02) is required
If either Product/Service ID Qualifier (PO1-06) or Product/Service ID (PO1-07) is present, then the other is required
If either Product/Service ID Qualifier (PO1-08) or Product/Service ID (PO1-09) is present, then the other is required
If either Product/Service ID Qualifier (PO1-10) or Product/Service ID (PO1-11) is present, then the other is required
If either Product/Service ID Qualifier (PO1-12) or Product/Service ID (PO1-13) is present, then the other is required
If either Product/Service ID Qualifier (PO1-14) or Product/Service ID (PO1-15) is present, then the other is required
If either Product/Service ID Qualifier (PO1-16) or Product/Service ID (PO1-17) is present, then the other is required
If either Product/Service ID Qualifier (PO1-18) or Product/Service ID (PO1-19) is present, then the other is required
If either Product/Service ID Qualifier (PO1-20) or Product/Service ID (PO1-21) is present, then the other is required
If either Product/Service ID Qualifier (PO1-22) or Product/Service ID (PO1-23) is present, then the other is required
If either Product/Service ID Qualifier (PO1-24) or Product/Service ID (PO1-25) is present, then the other is required
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.
Usage notes

Use to identify the CLIN, SUBCLIN or ELIN or other number identifying the line item.

PO1-02
330
Quantity Ordered
Optional
Decimal number (R)
Min 1Max 15

Quantity ordered

Usage notes
  1. Use to specify the quantity of the item being ordered. Step ladder quantities and related prices will be cited in the 2/CTP/040 segment.

  2. Do not use this data element when quantities are specified at the SUBCLIN level.

PO1-03
355
Unit or Basis for Measurement Code
Optional
Identifier (ID)

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

Usage notes
  1. Use any code.

  2. A conversion table may be required to convert agency codes to codes used by ASC X12.

SX
Shipment

Use this code when PO101 is a line item for prepaid transportation charges. Use the 2/SAC/130 segment when no prepaid and add.

PO1-04
212
Unit Price
Optional
Decimal number (R)
Min 1Max 15

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

Usage notes

When PO105 is code TB, enter the number 0. Customer Price

PO1-06
235
Product/Service ID Qualifier
Optional
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.
Usage notes
  1. PO106 through PO125 are used in pairs. For example, PO106 will contain a qualifier code and PO107 will contain information related to the qualifying code. So, if PO106 is code FS then PO107 would carry the National Stock Number.

  2. Any code can be used but listed codes are preferred.

  3. Use as many codes as necessary to describe the ordered item. There is no need to use all the codes or even all of the applicable codes. Select from the code list the minimum set of codes and code values necessary to describe the item.

CH
Country of Origin Code
CL
Color
CN
Commodity Name
F7
End-Item Description

Use to identify the end item, if applicable, to which the ordered item applies.

FS
National Stock Number

The NSN shall be transmitted as a continuous set of numbers, and without the dashes.

FT
Federal Supply Classification

See Code Source 27 for the FSCs associated with this code.

MF
Manufacturer

Use to identify a manufacturer (by name) who does not have a CAGE code. Use code ZB for a CAGE code.

MG
Manufacturer's Part Number

Use to specify the manufacturer's part number assigned to the ordered item.

MN
Model Number
PD
Part Number Description

Use to provide a text description of an item.

PI
Purchaser's Item Code

Use to provide a text description of an item that has no other assigned identification number.

PQ
Product ID Attribute Code

Use to indicate the UII Unique Item Identifier.

SR
Substitute Product Number
SV
Service Rendered

Use to specify in text, the service being ordered.

VP
Vendor's (Seller's) Part Number

Use to identify a part number assigned by a selling party other than the manufacturer.

PO1-07
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

PO1-08
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2

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

PO1-09
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

PO1-10
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2

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

PO1-11
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

PO1-12
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2

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

PO1-13
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

PO1-14
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2

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

PO1-15
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

PO1-16
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2

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

PO1-17
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

PO1-18
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2

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

PO1-19
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

PO1-20
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2

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

PO1-21
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

PO1-22
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2

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

PO1-23
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

PO1-24
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2

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

PO1-25
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

CTP Loop
OptionalMax >1
CTP
040
Detail > PO1 Loop > CTP Loop > CTP

Pricing Information

RequiredMax use 1

To specify pricing information

Usage notes
  1. Use this 2/CTP/040 segment to specify prices for step-ladder quantities of the line item cited in PO101 for a basic procurement instrument, e.g., a requirements or indefinite quantity contract.

  2. Example of step-ladder pricing for ranges 1-10, 11-20, 21-30, 31-50:

CTPPBQ1EA n/l
CTP**ICL
25.0010EA n/l
CTPICL24.5020*EA n/l
CTP
ICL23.5030EA n/l
CTP**MAX
22.0050EA n/l

Example
If either Quantity (CTP-04) or Composite Unit of Measure (CTP-05) is present, then the other is required
CTP-02
236
Price Identifier Code
Optional
Identifier (ID)

Code identifying pricing specification

Usage notes
  1. Use to indicate the type of prices included in the order.

  2. Data maintenance has been submitted to ASC X12 asking for the addition of codes for: packaging protection levels and packing levels. If approved, these codes will be available for use in ASC X12 Version/Release 3050.

GOV
Government Price

Use to indicate the sale price to the government.

ICL
Unit Price Through Quantity

When specifying prices for different quantities, use to indicate the end of a quantity range.

MAX
Maximum Order Quantity Price

When specifying prices for different quantities, use to indicate the quantity above which the price will not change.

PBQ
Unit Price Beginning Quantity

When specifying prices for different quantities, use to indicate the beginning of a quantity range.

SPC
Special Price
  1. Use to indicate that the line item unit price cited in PO104, is a special price authorized by a representative of the selling party.

  2. When used, identify the authorizing party either in the 1/PER/360 or 2/PER/110 segment citing code 1A in PER01 and provide a special price authorization number either in the 1/REF/350 or 2/REF/100 segment citing code 9B in REF01.

  3. DO NOT use CTP03 when this code is used.

CTP-03
212
Unit Price
Optional
Decimal number (R)
Min 1Max 14

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

  • See Figures Appendix for an example detailing the use of CTP03 and CTP04.
  • See Figures Appendix for an example detailing the use of CTP03, CTP04 and CTP07.
Usage notes
  1. Government price.
CTP-04
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

CTP-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
Optional
Identifier (ID)
Min 2Max 2

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

Usage notes
  1. Use any code.

  2. A conversion table may be required to convert agency codes to codes used by ASC X12.

CTP Loop end
PID Loop
OptionalMax 1000
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

Use the 2/PID/050 segment when the information applies to a specific line item. Use the 1/PID/190 segment when the information applies to all the line items. Use is discouraged.

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

Usage notes

Use, if necessary, to provide a brief description of the line item being ordered.

PID Loop end
REF
100
Detail > PO1 Loop > REF

Reference Identification

OptionalMax use >1

To specify identifying information

Usage notes

Use this 2/REF/100 segment to identify reference numbers that vary by line item. When the reference numbers apply to all the line items in the order, use the 1/REF/050 segment.

Example
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

Usage notes

Use any code. Listed codes are preferred.

AT
Appropriation Number

Use to indicate accounting appropriation data. Cite the data as a literal string in REF03.

BB
Authorization Number
IL
Internal Order Number

Use to indicate the requisition number (e.g., the MILSTRIP/FEDSTRIP document number).

P4
Project Code

Use to indicate the project number applicable to this line item.

PH
Priority Rating

Use to indicate the MILSTRIP/FEDSTRIP priority rating.

PR
Price Quote Number
RQ
Purchase Requisition Number

Use, as appropriate, to indicate an internal number such as a purchase request or purchase request order number. When citing a purchase request number, concatenate its line item number with the purchase request number if it is necessary to transmit both numbers. Internal number- CSC Order Number or Global Supply Number.

TG
Transportation Control Number (TCN)
TH
Transportation Account Code (TAC)
TN
Transaction Reference Number

Use to indicate the unique reference number of a related transaction set (e.g., an 841 transaction set carrying a related technical specification or drawing). Each transaction set has a unique number. In the case of the 841 transaction set, that number is carried in SPI02.

ZZ
Mutually Defined

Use to indicate another type of reference number. When used, identify the nature of the number in REF03. Examples of the numbers that can be included here (for which data maintenance has been requested from ASC X12) is: DD Form 250 Requirement Code, Military Standard Number, Technical Document Number, Technical Order Number, Related Contract Line Item Number and Standard Number. If approved, these codes will be available in ASC X12 Version/Release 3050.

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

If a reference number has an associated revision number, suffix or extension, concatenate the reference and revision/suffix/extension number and carry the resultant number in this data element.

REF-03
352
Description
Optional
String (AN)
Min 1Max 80

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

PER
110
Detail > PO1 Loop > PER

Administrative Communications Contact

OptionalMax use 3

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

Usage notes
  1. Use this 1/PER/360 segment to identify contacts not associated with an address.
Example
If either Communication Number Qualifier (PER-03) or Communication Number (PER-04) is present, then the other is required
If either Communication Number Qualifier (PER-05) or Communication Number (PER-06) 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

1A
Review/Repricing Contact
  1. Use to indicate an individual who authorized a one time special price for the line item in this PO1 loop, e.g., a spot pricing reduction from an existing contract or catalog price. In this instance, PER02 MUST be used.

  2. When used, cite a special price authorization number in the 2/REF/100 segment citing code 9B in REF01 and use the 2/CTP/040 segment citing code SPC in CTP02.

AC
Administrative Contact
AU
Report Authorizer

Use to indicate the party approving the Contract Data Requirements List.

NT
Notification Contact

Use to indicate the party to be contacted for shipping instructions. Use only when LDT01 in the 220 segment cites code AI.

PI
Preparer

Use to indicate the preparer of the Contract Data Requirements List.

RE
Receiving Contact

Use to indicate the party to be contacted to schedule a shipment. Use only when LDT01 in the 2/LDT/220 segment cites code AI.

Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Cite the last name first, followed by the first name. Do not truncate the last name if the whole name is longer than 35 characters. Instead, truncate or use the initial of the first name.

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

Code identifying the type of communication number

EM
Electronic Mail
FX
Facsimile
IT
International Telephone

Include the country code.

TE
Telephone
PER-04
364
Communication Number
Optional
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

Usage notes

Use to identify a second communications number for the party cited in PER02. For example, if PER03/04 cites a commercial telephone number, PER05/06 can be used to cite an Electronic Mail address.

EM
Electronic Mail
EX
Telephone Extension

Use only if PER03 is used citing either code AU or TE.

FX
Facsimile
IT
International Telephone

Include the country code.

TE
Telephone

Use to indicate the commercial telephone number of the named party.

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

Complete communications number including country or area code when applicable

SAC Loop
OptionalMax 25
SAC
130
Detail > PO1 Loop > SAC Loop > SAC

Service, Promotion, Allowance, or Charge Information

RequiredMax use 1

To request or identify a service, promotion, allowance, or charge; to specify the amount or percentage for the service, promotion, allowance, or charge

Usage notes

Use the 2/SAC/130 segment to identify charges that apply to a line item. If the charges apply to all of the line items, use the 1/SAC/120 segment.

Example
If either Unit or Basis for Measurement Code (SAC-09) or Quantity (SAC-10) is present, then the other is required
If Quantity (SAC-11) is present, then Quantity (SAC-10) is required
SAC-01
248
Allowance or Charge Indicator
Required
Identifier (ID)

Code which indicates an allowance or charge for the service specified

  • If SAC01 is "A" or "C", then at least one of SAC05, SAC07, or SAC08 is required.
A
Allowance
C
Charge
N
No Allowance or Charge
SAC-02
1300
Service, Promotion, Allowance, or Charge Code
Required
Identifier (ID)
Min 4Max 4

Code identifying the service, promotion, allowance, or charge

Usage notes

Use any code.
D230 – Freight surcharges

SAC-05
610
Amount
Optional
Numeric (N2)
Min 1Max 15

Monetary amount

  • SAC05 is the total amount for the service, promotion, allowance, or charge.
  • If SAC05 is present with SAC07 or SAC08, then SAC05 takes precedence.
SAC-09
355
Unit or Basis for Measurement Code
Optional
Identifier (ID)
Min 2Max 2

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

Usage notes

A conversion table may be required to convert agency codes used by ASC X12.

SAC-10
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

  • SAC10 and SAC11 is the quantity basis when the allowance or charge quantity is different from the purchase order or invoice quantity.
  • SAC10 and SAC11 used together indicate a quantity range, which could be a dollar amount, that is applicable to service, promotion, allowance, or charge.
  • In some business applications, it is necessary to advise the trading partner of the actual dollar amount that a particular allowance, charge, or promotion was based on to reduce ambiguity. This amount is commonly referred to as "Dollar Basis Amount". It is represented in the SAC segment in SAC10 using the qualifier "DO" - Dollars in SAC09.
Usage notes

Use to indicate the quantity to which the amount in SAC05 applies. SAC10/11 can be used together to specify a quantity range to which the amount in SAC05 applies.

SAC-11
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

SAC Loop end
FOB
180
Detail > PO1 Loop > FOB

F.O.B. Related Instructions

OptionalMax use >1

To specify transportation instructions relating to shipment

Usage notes
  1. Use this 2/FOB/180 segment to identify the FOB point and acceptance location when they vary by line item. If the FOB point and acceptance location apply to all the line items, use the 1/FOB/080 segment.

  2. Do not use when the line item is for a service.

Example
If Description (FOB-03) is present, then Location Qualifier (FOB-02) is required
If Description (FOB-07) is present, then Location Qualifier (FOB-06) is required
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.
BP
Paid by Buyer

Use to indicate that the FOB point is origin.

PE
Prepaid and Summary Bill

Use to indicate that the shipping costs are authorized to be prepaid and added to an invoice

PP
Prepaid (by Seller)

Use to indicate that the FOB point is destination.

FOB-02
309
Location Qualifier
Optional
Identifier (ID)

Code identifying type of location

  • FOB02 is the code specifying transportation responsibility location.
Usage notes
  1. Use to identify the FOB point.

  2. A request has been submitted to ASC X12 to add codes for Port of Embarkation, Port of Loading, and Government Furnished Property FOB Point. We expect these codes will be available for use in ASC X12 Version/Release 3050.

DE
Destination (Shipping)
FV
Free Alongside Vessel (Free On Board [F.O.B.] Point)
IT
Intermediate FOB Point

Use to indicate a freight forwarder.

OR
Origin (Shipping Point)
ZZ
Mutually Defined

Use to indicate that the FOB point is neither origin nor destination. When used, cite the actual FOB point in FOB03. If the actual FOB point is an address or geographical location, use in conjunction with one iteration of the appropriate N1 loop, using code KX in N101.

FOB-03
352
Description
Optional
String (AN)
Min 1Max 80

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

Usage notes

Use to identify the FOB point only when FOB02 is code ZZ. If necessary, use one iteration of the N1 loop, using code KX in N101, to specify the address of the FOB point. Use is discouraged.

FOB-06
309
Location Qualifier
Optional
Identifier (ID)

Code identifying type of location

  • FOB06 is the code specifying the title passage location.
Usage notes

Use to identify the acceptance point.

DE
Destination (Shipping)
OR
Origin (Shipping Point)
ZZ
Mutually Defined

Use to identify the acceptance point when it is neither origin nor destination. When used, cite the actual acceptance point in FOB07. If the actual acceptance point is an address or geographic location, use in conjunction with the appropriate N1 loop, using code ZZ in N101.

FOB-07
352
Description
Optional
String (AN)
Min 1Max 80

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

Usage notes

Use to identify the acceptance point when FOB06 is code ZZ. If necessary, use one iteration of the N1 loop, using code ZZ in N101, to specify the address of the acceptance point. Use is discouraged.

DTM
210
Detail > PO1 Loop > DTM

Date/Time Reference

OptionalMax use 10

To specify pertinent dates and times

Usage notes
  1. Use this 2/DTM/210 segment to specify a required delivery date when it is expressed as an actual date. If the required delivery schedule is expressed as a set time period after the occurrence of some event, use the 2/LDT/220 segment.

2 Use this 2/DTM/210 segment to specify dates that apply to a line item. Use the 1/DTM/150 segment to specify date that apply to all of the line items.

Example
If Time Code (DTM-04) is present, then Time (DTM-03) is required
If either Date Time Period Format Qualifier (DTM-05) or Date Time Period (DTM-06) is present, then the other is required
At least one of Date (DTM-02), Time (DTM-03) or Date Time Period Format Qualifier (DTM-05) is required
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)

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

996
Required Delivery

Use to indicate that delivery is required on or before the specified date.

Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

Optional
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)

DTM-04
623
Time Code
Optional
Identifier (ID)
Min 2Max 2

Code identifying the time. In accordance with International Standards Organization standard 8601, time can be specified by a + or - and an indication in hours in relation to Universal Time Coordinate (UTC) time; since + is a restricted character, + and - are substituted by P and M in the codes that follow

DTM-05
1250
Date Time Period Format Qualifier
Optional
Identifier (ID)
Min 2Max 3

Code indicating the date format, time format, or date and time format

DTM-06
1251
Date Time Period
Optional
String (AN)
Min 1Max 35

Expression of a date, a time, or range of dates, times or dates and times

Usage notes

When delivery is specified as a range of time for a given date, e.g., use code RTM in DTM06 to qualify a range of times for a delivery on March 30, 1994 between 1:00 PM and 4:00 PM local time. Use DTM01/02 to convey the March 30, 1994 date.

MAN
280
Detail > PO1 Loop > MAN

Marks and Numbers

OptionalMax use 10

To indicate identifying marks and numbers for shipping containers

Usage notes
  1. Use this 2/MAN/280 segment to provide marks and numbers that vary by line item. If the marks and numbers apply to all of the line items, use the 1/MAN/270 segment.

  2. Use to identify such data as MILSTRIP/FEDSTRIP number, Transportation Control number, Project Priority number, and consignee related codes.

Example
If either Marks and Numbers Qualifier (MAN-04) or Marks and Numbers (MAN-05) is present, then the other is required
If Marks and Numbers (MAN-06) is present, then Marks and Numbers (MAN-05) is required
MAN-01
88
Marks and Numbers Qualifier
Required
Identifier (ID)

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.
L
Line Item Only
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.
MAN-03
87
Marks and Numbers
Optional
String (AN)
Min 1Max 48

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

  • MAN03 and/or MAN06 are only used when sending a range(s) of ID numbers.
  • When both MAN02/MAN03 and MAN05/MAN06 are used to send ranges of ID numbers, the integrity of the two ID numbers must be maintained.
MAN-04
88
Marks and Numbers Qualifier
Optional
Identifier (ID)

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

L
Line Item Only
MAN-05
87
Marks and Numbers
Optional
String (AN)
Min 1Max 48

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

  • When both MAN05 and MAN06 are used, MAN05 is the starting number of a sequential range, and MAN06 is the ending number of that range.
MAN-06
87
Marks and Numbers
Optional
String (AN)
Min 1Max 48

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

N1 Loop
OptionalMax 200
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
  1. Whenever possible, address information should be transmitted using code values contained in a combination of the N101, N103/04 data elements. Use N102 and the N2-N4 segments only when it is necessary to transmit the full address. For example, if a vendor can be identified by a DUNS number, it is not necessary to transmit the vendor's full address since the relationship between the DUNS number and the vendor's address can be established by accessing a data base in which the information is stored, having been put there at the time the vendor electronically registered as a federal government trading partner.

  2. Use the 2/N1/350 loop to identify organizations or people that vary by line item. If the organizations or people apply to all of the line items, use the 1/N1/310 loop.

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

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

Usage notes

A request has been submitted to ASC X12 to add additional codes for Contracting Officer Representative Party Authorized to Definitize Contract Action, Government Furnished Property FOB Point, Party to Receive Proposal, and Transportation Office. We expect these codes will be available for use in ASC X12 Version/Release 3050.

BY
Buying Party (Purchaser)

Use to indicate the purchasing office or activity.

IC
Intermediate Consignee

Use to indicate a freight forwarder.CRP

MF
Manufacturer of Goods
OB
Ordered By
ST
Ship To

Use to indicate the address to which an item must be shipped. If the ship-to address is an FPO or APO, identify the FPO or APO in the N4 segment using N401 and N403.

SV
Service Performance Site

Use to indicate the location where a service is to be performed.

Z7
Mark-for Party

In Country Address.

ZZ
Mutually Defined

Use to identify the acceptance location when it cannot be described using a point such as origin or destination. Data maintenance has been submitted to ASC X12 asking for a code for Acceptance Point. If approved, the code will be available in ASC X12 Version/Release 3050.

Optional
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)

Usage notes
  1. Use, when applicable, to identify the named party.

  2. A request has been submitted to ASC X12 to add a code for Contractor Establishment Code. We expect this code to be available for use in the ASC X12 Version/Release 3050.

  3. While Federal EDI will use the DUNS number, other numbers may be required for a period of transition in order to cross-reference existing data bases with new procurement actions.

1
D-U-N-S Number, Dun & Bradstreet

Use of the DUNS or DUNS+4 is preferred over any other coded number to identify a named party.

9
D-U-N-S+4, D-U-N-S Number with Four Character Suffix

Use of the DUNS or DUNS+4 is preferred over any other coded number to identify a named party.

10
Department of Defense Activity Address Code (DODAAC)

Use to indicate either a Department of Defense Activity Address Code or a Civilian Agency Activity Address Code.

33
Commercial and Government Entity (CAGE)

Use to indicate vendors with CAGE codes.

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.
N2
360
Detail > PO1 Loop > N1 Loop > N2

Additional Name Information

OptionalMax use 2

To specify additional names or those longer than 35 characters in length

Usage notes

This segment is not necessary when the cited party can be identified by a code value in N101/03/04.

Example
Required
String (AN)
Min 1Max 60

Free-form name

Optional
String (AN)
Min 1Max 60

Free-form name

N3
370
Detail > PO1 Loop > N1 Loop > N3

Address Information

OptionalMax use 2

To specify the location of the named party

Usage notes

This segment is not necessary when the cited party can be identified by a code value in N101/03/04.

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
  1. This segment is not necessary when the cited party can be identified by a code value in N101/03/04.

  2. When identifying an APO/FPO, N401 carries the APO/FPO city name and N403 carries the ZIP code of the city.

  3. A request has been submitted to ASC X12 to increase the maximum use of this segment to greater than 1 to accommodate specifying multiple states or countries in a delivery zone. We expect this maximum use to be available in ASC X12 Version/Release 3050.

Example
If Location Identifier (N4-06) is present, then Location Qualifier (N4-05) is required
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

Usage notes

A conversion table may be required to convert agency codes to codes used by ASC X12.

N4-05
309
Location Qualifier
Optional
Identifier (ID)

Code identifying type of location

CC
Country

When N101 is code DZ, if applicable, use to indicate a country in the delivery zone.

SP
State/Province

When N101 is code DZ, if applicable, use to indicate a state or province in the delivery zone.

N4-06
310
Location Identifier
Optional
String (AN)
Min 1Max 30

Code which identifies a specific location

PER
400
Detail > PO1 Loop > N1 Loop > PER

Administrative Communications Contact

OptionalMax use 3

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

Example
If either Communication Number Qualifier (PER-03) or Communication Number (PER-04) is present, then the other is required
If either Communication Number Qualifier (PER-05) or Communication Number (PER-06) 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

1A
Review/Repricing Contact
  1. Use to indicate an individual who authorized a one time special price for the line item in this PO1 loop, e.g., a spot pricing reduction from an existing contract or catalog price. In this instance, PER02 MUST be used.

  2. When used, cite a special price authorization number in the 2/REF/100 segment citing code 9B in REF01 and use the 2/CTP/040 segment citing code SPC in CTP02.

AC
Administrative Contact
AU
Report Authorizer

Use to indicate the party approving the Contract Data Requirements List.

NT
Notification Contact

Use to indicate the party to be contacted for shipping instructions. Use only when LDT01 in the 220 segment cites code AI.

PI
Preparer

Use to indicate the preparer of the Contract Data Requirements List.

RE
Receiving Contact

Use to indicate the party to be contacted to schedule a shipment. Use only when LDT01 in the 2/LDT/220 segment cites code AI.

Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Cite the last name first, followed by the first name. Do not truncate the last name if the whole name is longer than 35 characters. Instead, truncate or use the initial of the first name.

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

Code identifying the type of communication number

EM
Electronic Mail
FX
Facsimile
IT
International Telephone

Include the country code.

TE
Telephone
PER-04
364
Communication Number
Optional
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

Usage notes

Use to identify a second communications number for the party cited in PER02. For example, if PER03/04 cites a commercial telephone number, PER05/06 can be used to cite an Electronic Mail address.

EM
Electronic Mail
EX
Telephone Extension

Use only if PER03 is used citing either code AU or TE.

FX
Facsimile
IT
International Telephone

Include the country code.

TE
Telephone

Use to indicate the commercial telephone number of the named party.

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

Complete communications number including country or area code when applicable

N1 Loop end
AMT Loop
OptionalMax >1
AMT
600
Detail > PO1 Loop > AMT Loop > AMT

Monetary Amount

RequiredMax use 1

To indicate the total monetary amount

Usage notes

Use this segment to specify the total amount of the line item.

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

Code to qualify amount

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

Monetary amount

AMT 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.
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

Enter the total number of PO1 segments contained in this transaction set.

CTT-02
347
Hash Total
Optional
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

CTT02 is the sum of the value of quantities ordered (PO102) for each PO1 segment. Never use to carry an operational amount.

AMT
020
Summary > CTT Loop > AMT

Monetary Amount

OptionalMax 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

Use this segment to provide the total amount of the order.

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

Code to qualify amount

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

Monetary amount

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

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.