GSA (General Services Administration)
/
Invoice (GSA OMS)
  • 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 810 Invoice (GSA OMS)

X12 Release 4010
Delimiters
  • ~ Segment
  • * Element
  • > Component
EDI sample
  • EDI_810.txt
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/gsa/invoice-gsa-oms/01HH12F28952YM7ZNHJWQXBPHB
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
BIG
020
Beginning Segment for Invoice
Max use 1
Required
N1 Loop
ITD
130
Terms of Sale/Deferred Terms of Sale
Max use 1
Optional
DTM
140
Date/Time Reference
Max use 1
Optional
detail
IT1 Loop
GE
-
Functional Group Trailer
Max use 1
Required
IEA
-
Interchange Control Trailer
Max use 1
Required
ISA

Interchange Control Header

RequiredMax use 1
Example
ISA-01
I01
Authorization Information Qualifier
Required
Identifier (ID)
00
No Authorization Information Present (No Meaningful Information in I02)
ISA-02
I02
Authorization Information
Required
String (AN)
Min 10Max 10
ISA-03
I03
Security Information Qualifier
Required
Identifier (ID)
00
No Security Information Present (No Meaningful Information in I04)
ISA-04
I04
Security Information
Required
String (AN)
Min 10Max 10
ISA-05
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2
Codes
ISA-06
I06
Interchange Sender ID
Required
String (AN)
Min 15Max 15
ISA-07
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2
Codes
ISA-08
I07
Interchange Receiver ID
Required
String (AN)
Min 15Max 15
ISA-09
I08
Interchange Date
Required
Date (DT)
YYMMDD format
ISA-10
I09
Interchange Time
Required
Time (TM)
HHMM format
ISA-11
I10
Interchange Control Standards Identifier
Required
Identifier (ID)
U
U.S. EDI Community of ASC X12, TDCC, and UCS
ISA-12
I11
Interchange Control Version Number
Required
Identifier (ID)
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
ISA-14
I13
Acknowledgment Requested
Required
Identifier (ID)
Min 1Max 1
0
No Acknowledgment Requested
1
Interchange Acknowledgment Requested
ISA-15
I14
Usage Indicator
Required
Identifier (ID)
Min 1Max 1
I
Information
P
Production Data
T
Test Data
ISA-16
I15
Component Element Separator
Required
String (AN)
Min 1Max 1
>
Component Element Separator

Functional Group Header

RequiredMax use 1
Example
GS-01
479
Functional Identifier Code
Required
Identifier (ID)
IN
Invoice Information (810,819)
GS-02
142
Application Sender's Code
Required
String (AN)
Min 2Max 15
GS-03
124
Application Receiver's Code
Required
String (AN)
Min 2Max 15
Required
Date (DT)
CCYYMMDD format
Required
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format
GS-06
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9
GS-07
455
Responsible Agency Code
Required
Identifier (ID)
Min 1Max 2
T
Transportation Data Coordinating Committee (TDCC)
X
Accredited Standards Committee X12
GS-08
480
Version / Release / Industry Identifier Code
Required
String (AN)
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
Example
ST-01
143
Transaction Set Identifier Code
Required
Identifier (ID)
810
Invoice
ST-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9
BIG
020
Heading > BIG

Beginning Segment for Invoice

RequiredMax use 1
Example
Required
Date (DT)
CCYYMMDD format
Usage notes
BIG-02
76
Invoice Number
Required
String (AN)
Min 1Max 22
Usage notes
Optional
Date (DT)
CCYYMMDD format
Usage notes
BIG-04
324
Purchase Order Number
Required
String (AN)
Min 1Max 22
Usage notes
BIG-05
328
Release Number
Required
String (AN)
Min 1Max 30
Usage notes
BIG-07
640
Transaction Type Code
Optional
Identifier (ID)
DI
Debit Invoice
BIG-08
353
Transaction Set Purpose Code
Optional
Identifier (ID)
Min 2Max 2
N1 Loop
RequiredMax >1
N1
070
Heading > N1 Loop > N1

Name

RequiredMax use 1
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)
PE
Payee
VN
Vendor
Optional
String (AN)
Min 1Max 60
N1-03
66
Identification Code Qualifier
Optional
Identifier (ID)
1
D-U-N-S Number, Dun & Bradstreet
9
D-U-N-S+4, D-U-N-S Number with Four Character Suffix
12
Telephone Number (Phone)
94
Code assigned by the organization that is the ultimate destination of the transaction set
N1-04
67
Identification Code
Optional
String (AN)
Min 2Max 80
N2
080
Heading > N1 Loop > N2

Additional Name Information

OptionalMax use 2
Example
Optional
String (AN)
Min 1Max 60
Optional
String (AN)
Min 1Max 60
N3
090
Heading > N1 Loop > N3

Address Information

OptionalMax use 2
Example
N3-01
166
Address Information
Required
String (AN)
Min 1Max 55
N3-02
166
Address Information
Optional
String (AN)
Min 1Max 55
N4
100
Heading > N1 Loop > N4

Geographic Location

OptionalMax use 1
Example
N4-01
19
City Name
Optional
String (AN)
Min 2Max 30
N4-02
156
State or Province Code
Optional
Identifier (ID)
Min 2Max 2
N4-03
116
Postal Code
Optional
Identifier (ID)
Min 3Max 15
N4-04
26
Country Code
Optional
Identifier (ID)
Min 2Max 3
N1 Loop end
ITD
130
Heading > ITD

Terms of Sale/Deferred Terms of Sale

OptionalMax use >1
Example
If Terms Discount Percent (ITD-03) is present, then at least one of Terms Discount Due Date (ITD-04), Terms Discount Days Due (ITD-05) or Day of Month (ITD-13) is required
ITD-01
336
Terms Type Code
Optional
Identifier (ID)
Min 2Max 2
ITD-02
333
Terms Basis Date Code
Optional
Identifier (ID)
Min 1Max 2
ITD-03
338
Terms Discount Percent
Optional
Decimal number (R)
Min 1Max 6
ITD-04
370
Terms Discount Due Date
Optional
Date (DT)
CCYYMMDD format
ITD-05
351
Terms Discount Days Due
Optional
Numeric (N0)
Min 1Max 3
ITD-06
446
Terms Net Due Date
Optional
Date (DT)
CCYYMMDD format
ITD-07
386
Terms Net Days
Optional
Numeric (N0)
Min 1Max 3
ITD-13
765
Day of Month
Optional
Numeric (N0)
Min 1Max 2
DTM
140
Heading > DTM

Date/Time Reference

OptionalMax use 1
Example
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)
011
Shipped
Optional
Date (DT)
CCYYMMDD format
Optional
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format
DTM-05
1250
Date Time Period Format Qualifier
Optional
Identifier (ID)
Min 2Max 3
DTM-06
1251
Date Time Period
Optional
String (AN)
Min 1Max 35
Heading end

Detail

IT1 Loop
OptionalMax 200000
IT1
010
Detail > IT1 Loop > IT1

Baseline Item Data (Invoice)

RequiredMax use 1
Example
If either Product/Service ID Qualifier (IT1-10) or Product/Service ID (IT1-11) is present, then the other is required
If either Product/Service ID Qualifier (IT1-12) or Product/Service ID (IT1-13) is present, then the other is required
If either Product/Service ID Qualifier (IT1-14) or Product/Service ID (IT1-15) is present, then the other is required
If either Product/Service ID Qualifier (IT1-16) or Product/Service ID (IT1-17) is present, then the other is required
If either Product/Service ID Qualifier (IT1-18) or Product/Service ID (IT1-19) is present, then the other is required
If either Product/Service ID Qualifier (IT1-20) or Product/Service ID (IT1-21) is present, then the other is required
If either Product/Service ID Qualifier (IT1-22) or Product/Service ID (IT1-23) is present, then the other is required
If either Product/Service ID Qualifier (IT1-24) or Product/Service ID (IT1-25) is present, then the other is required
If either Quantity Invoiced (IT1-02), Unit or Basis for Measurement Code (IT1-03) or Unit Price (IT1-04) are present, then the others are required
IT1-01
350
Assigned Identification
Required
String (AN)
Min 1Max 20
Usage notes
IT1-02
358
Quantity Invoiced
Required
Decimal number (R)
Min 1Max 10
Usage notes
IT1-03
355
Unit or Basis for Measurement Code
Required
Identifier (ID)
Min 2Max 2
Usage notes
IT1-04
212
Unit Price
Optional
Decimal number (R)
Min 1Max 15
Usage notes
IT1-05
639
Basis of Unit Price Code
Optional
Identifier (ID)
Min 2Max 2
IT1-06
235
Product/Service ID Qualifier
Required
Identifier (ID)
FS
National Stock Number
MG
Manufacturer's Part Number
PD
Part Number Description
VP
Vendor's (Seller's) Part Number
IT1-07
234
Product/Service ID
Required
String (AN)
Min 1Max 48
IT1-08
235
Product/Service ID Qualifier
Required
Identifier (ID)
PL
Purchaser's Order Line Number
IT1-09
234
Product/Service ID
Required
String (AN)
Min 1Max 48
IT1-10
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2
IT1-11
234
Product/Service ID
Optional
String (AN)
Min 1Max 48
IT1-12
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2
IT1-13
234
Product/Service ID
Optional
String (AN)
Min 1Max 48
IT1-14
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2
IT1-15
234
Product/Service ID
Optional
String (AN)
Min 1Max 48
IT1-16
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2
IT1-17
234
Product/Service ID
Optional
String (AN)
Min 1Max 48
IT1-18
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2
IT1-19
234
Product/Service ID
Optional
String (AN)
Min 1Max 48
IT1-20
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2
IT1-21
234
Product/Service ID
Optional
String (AN)
Min 1Max 48
IT1-22
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2
IT1-23
234
Product/Service ID
Optional
String (AN)
Min 1Max 48
IT1-24
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2
IT1-25
234
Product/Service ID
Optional
String (AN)
Min 1Max 48
IT1 Loop end
Detail end

Summary

TDS
010
Summary > TDS

Total Monetary Value Summary

RequiredMax use 1
Usage notes
Example
TDS-01
610
Amount
Required
Numeric (N2)
Min 1Max 15
SAC Loop
OptionalMax >1
SAC
040
Summary > SAC Loop > SAC

Service, Promotion, Allowance, or Charge Information

RequiredMax use 1
Example
If either Agency Qualifier Code (SAC-03) or Agency Service, Promotion, Allowance, or Charge Code (SAC-04) is present, then the other is required
At least one of Service, Promotion, Allowance, or Charge Code (SAC-02) or Agency Qualifier Code (SAC-03) is required
SAC-01
248
Allowance or Charge Indicator
Required
Identifier (ID)
A
Allowance
C
Charge
SAC-02
1300
Service, Promotion, Allowance, or Charge Code
Optional
Identifier (ID)
B680
Contract Service Charge
D240
Freight
SAC-03
559
Agency Qualifier Code
Optional
Identifier (ID)
Min 2Max 2
SAC-04
1301
Agency Service, Promotion, Allowance, or Charge Code
Optional
String (AN)
Min 1Max 10
SAC-05
610
Amount
Optional
Numeric (N2)
Min 1Max 15
SAC Loop end
CTT
070
Summary > CTT

Transaction Totals

OptionalMax use 1
Example
CTT-01
354
Number of Line Items
Required
Numeric (N0)
Min 1Max 6
CTT-02
347
Hash Total
Optional
Decimal number (R)
Min 1Max 10
SE
080
Summary > SE

Transaction Set Trailer

RequiredMax use 1
Example
SE-01
96
Number of Included Segments
Required
Numeric (N0)
Min 1Max 10
SE-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9
Summary end

Functional Group Trailer

RequiredMax use 1
Example
GE-01
97
Number of Transaction Sets Included
Required
Numeric (N0)
Min 1Max 6
GE-02
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Interchange Control Trailer

RequiredMax use 1
Example
IEA-01
I16
Number of Included Functional Groups
Required
Numeric (N0)
Min 1Max 5
IEA-02
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9
EDI Samples

EDI_810.txt

ISA*00* *00* *12*5168121123 *ZZ*GSAOMS *151110*1027*U*00401*447169220*0*T*>~
GS*IN*5168121123*GSAOMS*20151110*1027*447169249*X*004010~
ST*810*447169275~
BIG*20151110*INVNUM01*20151110*BPA NUMBER*PO NUMBER**DI*00~
N1*VN*TEST VENDOR*12*5168121123~
IT1*1*100*PK*7.43**FS*3230015749123*PL*FB203753142ZYZ~
TDS*74300~
CTT*1~
SE*7*447169275~
GE*1*447169249~
IEA*1*447169220~

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.