H-E-B
/
Utility Utility Invoice
  • Specification
  • EDI Inspector
Import guide into your account
Stedi maintains this guide based on public documentation from H-E-B. Contact H-E-B for official EDI specifications. To report any errors in this guide, please contact us.
Go to Stedi Network
H-E-B logo

X12 810 Utility Utility Invoice

X12 Release 4010

This Draft Standard for Trial Use contains the format and establishes the data contents of the Invoice Transaction Set (810) 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 billing for goods and services provided.

Delimiters
  • ~ Segment
  • * Element
  • > Component
EDI sample
  • Sample
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/h-e-b/utility-utility-invoice/01H914EG19BDW304E3R9DMFRK5
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
REF
050
Reference Identification
Max use 12
Required
N1 Loop
ITD
130
Terms of Sale/Deferred Terms of Sale
Max use 1
Required
DTM
140
Invoice Period End
Max use 10
Required
DTM
140
Invoice Period Start
Max use 10
Required
BAL
212
Balance Detail
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

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

IN
Invoice Information (810,819)
GS-02
142
Application Sender's Code
Required
String (AN)
Min 2Max 15

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

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

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

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

Date expressed as CCYYMMDD

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

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

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

Assigned number originated and maintained by the sender

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

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

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

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

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

Heading

ST
010
Heading > ST

Transaction Set Header

RequiredMax use 1

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

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

Code uniquely identifying a Transaction Set

  • The transaction set identifier (ST01) used by the translation routines of the interchange partners to select the appropriate transaction set definition (e.g., 810 selects the Invoice Transaction Set).
810
Invoice
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

BIG
020
Heading > BIG

Beginning Segment for Invoice

RequiredMax use 1

To indicate the beginning of an invoice transaction set and transmit identifying numbers and dates

Example
BIG-01
373
Date
Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • BIG01 is the invoice issue date.
BIG-02
76
Invoice Number
Required
String (AN)
Min 1Max 22

Identifying number assigned by issuer

BIG-03
373
Date
Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • BIG03 is the date assigned by the purchaser to purchase order.
BIG-04
324
Purchase Order Number
Optional
String (AN)
Min 1Max 22

Identifying number for Purchase Order assigned by the orderer/purchaser

BIG-05
328
Release Number
Optional
String (AN)
Min 1Max 30

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

BIG-06
327
Change Order Sequence Number
Optional
String (AN)
Min 1Max 8

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

BIG-07
640
Transaction Type Code
Optional
Identifier (ID)
Min 2Max 2

Code specifying the type of transaction

  • BIG07 is used only to further define the type of invoice when needed.
BIG-08
353
Transaction Set Purpose Code
Optional
Identifier (ID)
Min 2Max 2

Code identifying purpose of transaction set

BIG-09
306
Action Code
Optional
Identifier (ID)
Min 1Max 2

Code indicating type of action

BIG-10
76
Invoice Number
Optional
String (AN)
Min 1Max 22

Identifying number assigned by issuer

  • BIG10 indicates the consolidated invoice number. When BIG07 contains code CI, BIG10 is not used.
REF
050
Heading > REF

Reference Identification

RequiredMax use 12

To specify identifying information

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

11
Account Number
12
Billing Account
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

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

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

REF-04
C040
Reference Identifier
OptionalMax use 1
To identify one or more reference numbers or identification numbers as specified by the Reference Qualifier
If either Reference Identification Qualifier (C040-03) or Reference Identification (C040-04) is present, then the other is required
If either Reference Identification Qualifier (C040-05) or Reference Identification (C040-06) is present, then the other is required
C040-01
128
Reference Identification Qualifier
Required
Identifier (ID)
Min 2Max 3

Code qualifying the Reference Identification

C040-02
127
Reference Identification
Required
String (AN)
Min 1Max 30

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

C040-03
128
Reference Identification Qualifier
Optional
Identifier (ID)
Min 2Max 3

Code qualifying the Reference Identification

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

C040-05
128
Reference Identification Qualifier
Optional
Identifier (ID)
Min 2Max 3

Code qualifying the Reference Identification

C040-06
127
Reference Identification
Optional
String (AN)
Min 1Max 30

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

N1 Loop
RequiredMax >1
N1
070
Heading > N1 Loop > N1

Name

RequiredMax use 1

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

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

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

Usage notes

H-E-B requires vendor to use "SJ" code. In addition to "SJ" code you can list any other codes if needed.

8S
Consumer Service Provider (CSP)
BT
Bill-to-Party
RE
Party to receive commercial invoice remittance
SJ
Service Provider
N1-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

If N1_01 is "SJ", then the Vendor Name must be provided in the N1_02.

N1-03
66
Identification Code Qualifier
Optional
Identifier (ID)
Min 1Max 2

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

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.
N1-05
706
Entity Relationship Code
Optional
Identifier (ID)
Min 2Max 2

Code describing entity relationship

  • N105 and N106 further define the type of entity in N101.
N1-06
98
Entity Identifier Code
Optional
Identifier (ID)
Min 2Max 3

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

N3
090
Heading > N1 Loop > N3

Address Information

OptionalMax use 2

To specify the location of the named party

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

Geographic Location

OptionalMax use 1

To specify the geographic place of the named party

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)

PER
120
Heading > 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)
Min 2Max 2

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

PER-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

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

Code identifying the type of communication number

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

Code identifying the type of communication number

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

Complete communications number including country or area code when applicable

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

Code identifying the type of communication number

N1 Loop end
ITD
130
Heading > ITD

Terms of Sale/Deferred Terms of Sale

RequiredMax use >1

To specify terms of sale

Example
If Terms Deferred Due Date (ITD-09) is present, then at least one of Deferred Amount Due (ITD-10) or Percent of Invoice Payable (ITD-11) is required
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
If Terms Discount Amount (ITD-08) 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

Code identifying type of payment terms

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

Code identifying the beginning of the terms period

ITD-03
338
Terms Discount Percent
Optional
Decimal number (R)
Min 1Max 6

Terms discount percentage, expressed as a percent, available to the purchaser if an invoice is paid on or before the Terms Discount Due Date

ITD-04
370
Terms Discount Due Date
Optional
Date (DT)
CCYYMMDD format

Date payment is due if discount is to be earned expressed in format CCYYMMDD

ITD-05
351
Terms Discount Days Due
Optional
Numeric (N0)
Min 1Max 3

Number of days in the terms discount period by which payment is due if terms discount is earned

ITD-06
446
Terms Net Due Date
Required
Date (DT)
CCYYMMDD format

Date when total invoice amount becomes due expressed in format CCYYMMDD

ITD-07
386
Terms Net Days
Optional
Numeric (N0)
Min 1Max 3

Number of days until total invoice amount is due (discount not applicable)

ITD-08
362
Terms Discount Amount
Optional
Numeric (N2)
Min 1Max 10

Total amount of terms discount

ITD-09
388
Terms Deferred Due Date
Optional
Date (DT)
CCYYMMDD format

Date deferred payment or percent of invoice payable is due expressed in format CCYYMMDD

ITD-10
389
Deferred Amount Due
Optional
Numeric (N2)
Min 1Max 10

Deferred amount due for payment

ITD-11
342
Percent of Invoice Payable
Optional
Decimal number (R)
Min 1Max 5

Amount of invoice payable expressed in percent

ITD-12
352
Description
Optional
String (AN)
Min 1Max 80

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

ITD-13
765
Day of Month
Optional
Numeric (N0)
Min 1Max 2

The numeric value of the day of the month between 1 and the maximum day of the month being referenced

ITD-14
107
Payment Method Code
Optional
Identifier (ID)
Min 1Max 2

Code identifying type of payment procedures

ITD-15
954
Percent
Optional
Decimal number (R)
Min 1Max 10

Percentage expressed as a decimal

  • ITD15 is the percentage applied to a base amount used to determine a late payment charge.
DTM
140
Heading > DTM

Invoice Period End

RequiredMax use 10

To specify pertinent dates and times

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

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

187
Invoice Period End
DTM-02
373
Date
Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

DTM-03
337
Time
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

DTM
140
Heading > DTM

Invoice Period Start

RequiredMax use 10

To specify pertinent dates and times

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

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

186
Invoice Period Start
DTM-02
373
Date
Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

DTM-03
337
Time
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

BAL
212
Heading > BAL

Balance Detail

OptionalMax use >1

To identify the specific monetary balances associated with a particular account

Example
BAL-01
951
Balance Type Code
Required
Identifier (ID)
Min 1Max 2

Code indicating the type of balance

BAL-02
522
Amount Qualifier Code
Required
Identifier (ID)
Min 1Max 3

Code to qualify amount

BAL-03
782
Monetary Amount
Required
Decimal number (R)
Min 1Max 15

Monetary amount

Heading end

Detail

IT1 Loop
OptionalMax >1
IT1
010
Detail > IT1 Loop > IT1

Baseline Item Data (Invoice)

RequiredMax use 1

To specify the basic and most frequently used line item data for the invoice and related transactions

Example
If either Unit or Basis for Measurement Code (IT1-03) or Unit Price (IT1-04) is present, then the other is required
If either Product/Service ID Qualifier (IT1-06) or Product/Service ID (IT1-07) is present, then the other is required
If either Product/Service ID Qualifier (IT1-08) or Product/Service ID (IT1-09) is present, then the other is required
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-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
IT1-01
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • IT101 is the purchase order line item identification.
IT1-02
358
Quantity Invoiced
Optional
Decimal number (R)
Min 1Max 10

Number of units invoiced (supplier units)

IT1-03
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

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

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

IT1-05
639
Basis of Unit Price Code
Optional
Identifier (ID)
Min 2Max 2

Code identifying the type of unit price for an item

IT1-06
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)

  • IT106 through IT125 provide for ten different product/service IDs for each item. For example: Case, Color, Drawing No., U.P.C. No., ISBN No., Model No., or SKU.
IT1-07
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

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

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

Identifying number for a product or service

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

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

Identifying number for a product or service

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

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

Identifying number for a product or service

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

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

Identifying number for a product or service

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

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

Identifying number for a product or service

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

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

Identifying number for a product or service

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

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

Identifying number for a product or service

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

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

Identifying number for a product or service

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

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

Identifying number for a product or service

TXI
040
Detail > IT1 Loop > TXI

Tax Information

OptionalMax use 10

To specify tax information

Example
If either Tax Jurisdiction Code Qualifier (TXI-04) or Tax Jurisdiction Code (TXI-05) is present, then the other is required
At least one of Monetary Amount (TXI-02), Percent (TXI-03) or Tax Exempt Code (TXI-06) is required
If Dollar Basis For Percent (TXI-08) is present, then Percent (TXI-03) is required
TXI-01
963
Tax Type Code
Required
Identifier (ID)

Code specifying the type of tax

CS
City Sales Tax
CT
County Tax
ET
Energy Tax

Emergency Services Tax

FF
Fuel Super Fund Tax

Franchise Fee Tax

FR
Franchise Tax
GR
Gross Receipts Tax

Gross Receipts Reimbursement

LT
Local Sales Tax (All Applicable Sales Taxes by Taxing Authority Below the State Level)

Library Tax

SE
State Excise Tax

TX Puc Assessment

SP
State/Provincial Tax

State Sales Tax

TXI-02
782
Monetary Amount
Optional
Decimal number (R)
Min 1Max 15

Monetary amount

  • TXI02 is the monetary amount of the tax.
Usage notes

If TXI01 has a code, then TXI02 must have a value listed.

TXI-03
954
Percent
Optional
Decimal number (R)
Min 1Max 10

Percentage expressed as a decimal

  • TXI03 is the tax percent expressed as a decimal.
TXI-04
955
Tax Jurisdiction Code Qualifier
Optional
Identifier (ID)
Min 2Max 2

Code identifying the source of the data used in tax jurisdiction code

TXI-05
956
Tax Jurisdiction Code
Optional
String (AN)
Min 1Max 10

Code identifying the taxing jurisdiction

TXI-06
441
Tax Exempt Code
Optional
Identifier (ID)
Min 1Max 1

Code identifying exemption status from sales and use tax

TXI-07
662
Relationship Code
Optional
Identifier (ID)
Min 1Max 1

Code indicating the relationship between entities

  • TXI07 is a code indicating the relationship of the price or amount to the associated segment.
TXI-08
828
Dollar Basis For Percent
Optional
Decimal number (R)
Min 1Max 9

Dollar basis to be used in the percent calculation of the allowance, charge or tax

TXI-09
325
Tax Identification Number
Optional
String (AN)
Min 1Max 20

Number assigned to a purchaser (buyer, orderer) by a taxing jurisdiction (state, county, etc.); often called a tax exemption number or certificate number

TXI-10
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

MEA
059
Detail > IT1 Loop > MEA

Measurements

OptionalMax use 40

To specify physical measurements or counts, including dimensions, tolerances, variances, and weights

(See Figures Appendix for example of use of C001)

Example
If Range Minimum (MEA-05) is present, then Composite Unit of Measure (MEA-04) is required
If Range Maximum (MEA-06) is present, then Composite Unit of Measure (MEA-04) is required
If Measurement Significance Code (MEA-07) is present, then at least one of Measurement Value (MEA-03), Range Minimum (MEA-05) or Range Maximum (MEA-06) is required
MEA-01
737
Measurement Reference ID Code
Optional
Identifier (ID)
Min 2Max 2

Code identifying the broad category to which a measurement applies

MEA-02
738
Measurement Qualifier
Optional
Identifier (ID)
Min 1Max 3

Code identifying a specific product or process characteristic to which a measurement applies

MEA-03
739
Measurement Value
Optional
Decimal number (R)
Min 1Max 15

The value of the measurement

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

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

C001-02
1018
Exponent
Optional
Decimal number (R)
Min 1Max 15

Power to which a unit is raised

C001-03
649
Multiplier
Optional
Decimal number (R)
Min 1Max 10

Value to be used as a multiplier to obtain a new value

Usage notes

If MEA_04 has a K1 or KH code, then MEA_03 must have a value listed. If no usage recorded, please put a zero as a listed value.

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

C001-05
1018
Exponent
Optional
Decimal number (R)
Min 1Max 15

Power to which a unit is raised

C001-06
649
Multiplier
Optional
Decimal number (R)
Min 1Max 10

Value to be used as a multiplier to obtain a new value

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

C001-08
1018
Exponent
Optional
Decimal number (R)
Min 1Max 15

Power to which a unit is raised

C001-09
649
Multiplier
Optional
Decimal number (R)
Min 1Max 10

Value to be used as a multiplier to obtain a new value

C001-10
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

C001-11
1018
Exponent
Optional
Decimal number (R)
Min 1Max 15

Power to which a unit is raised

C001-12
649
Multiplier
Optional
Decimal number (R)
Min 1Max 10

Value to be used as a multiplier to obtain a new value

C001-13
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

C001-14
1018
Exponent
Optional
Decimal number (R)
Min 1Max 15

Power to which a unit is raised

C001-15
649
Multiplier
Optional
Decimal number (R)
Min 1Max 10

Value to be used as a multiplier to obtain a new value

MEA-05
740
Range Minimum
Optional
Decimal number (R)
Min 1Max 15

The value specifying the minimum of the measurement range

  • When citing dimensional tolerances, any measurement requiring a sign (+ or -), or any measurement where a positive (+) value cannot be assumed, use MEA05 as the negative (-) value and MEA06 as the positive (+) value.
MEA-06
741
Range Maximum
Optional
Decimal number (R)
Min 1Max 15

The value specifying the maximum of the measurement range

MEA-07
935
Measurement Significance Code
Optional
Identifier (ID)
Min 2Max 2

Code used to benchmark, qualify or further define a measurement value

REF
120
Detail > IT1 Loop > REF

Meter Number

OptionalMax use >1

To specify identifying information

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

Code qualifying the Reference Identification

MG
Meter 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

REF
120
Detail > IT1 Loop > REF

Rate code number

OptionalMax use >1

To specify identifying information

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

Code qualifying the Reference Identification

RB
Rate code 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

DTM
150
Detail > IT1 Loop > DTM

Service Period End

OptionalMax use 10

To specify pertinent dates and times

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

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

151
Service Period End
DTM-02
373
Date
Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

DTM
150
Detail > IT1 Loop > DTM

Date/Time Reference

OptionalMax use 10

To specify pertinent dates and times

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

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

150
Service Period Start
DTM-02
373
Date
Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

SLN Loop
OptionalMax >1
SLN
200
Detail > IT1 Loop > SLN Loop > SLN

Subline Item Detail

RequiredMax use 1

To specify product subline detail item data

Example
If Basis of Unit Price Code (SLN-07) is present, then Unit Price (SLN-06) is required
If Relationship Code (SLN-08) is present, then Unit Price (SLN-06) is required
If either Product/Service ID Qualifier (SLN-09) or Product/Service ID (SLN-10) is present, then the other is required
If either Product/Service ID Qualifier (SLN-11) or Product/Service ID (SLN-12) is present, then the other is required
If either Product/Service ID Qualifier (SLN-13) or Product/Service ID (SLN-14) is present, then the other is required
If either Product/Service ID Qualifier (SLN-15) or Product/Service ID (SLN-16) is present, then the other is required
If either Product/Service ID Qualifier (SLN-17) or Product/Service ID (SLN-18) is present, then the other is required
If either Product/Service ID Qualifier (SLN-19) or Product/Service ID (SLN-20) is present, then the other is required
If either Product/Service ID Qualifier (SLN-21) or Product/Service ID (SLN-22) is present, then the other is required
If either Product/Service ID Qualifier (SLN-23) or Product/Service ID (SLN-24) is present, then the other is required
If either Product/Service ID Qualifier (SLN-25) or Product/Service ID (SLN-26) is present, then the other is required
If either Product/Service ID Qualifier (SLN-27) or Product/Service ID (SLN-28) is present, then the other is required
SLN-01
350
Assigned Identification
Required
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • SLN01 is the identifying number for the subline item.
  • SLN01 is related to (but not necessarily equivalent to) the baseline item number. Example: 1.1 or 1A might be used as a subline number to relate to baseline number 1.
SLN-02
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • SLN02 is the identifying number for the subline level. The subline level is analogous to the level code used in a bill of materials.
SLN-03
662
Relationship Code
Required
Identifier (ID)
Min 1Max 1

Code indicating the relationship between entities

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

Numeric value of quantity

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

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

C001-02
1018
Exponent
Optional
Decimal number (R)
Min 1Max 15

Power to which a unit is raised

C001-03
649
Multiplier
Optional
Decimal number (R)
Min 1Max 10

Value to be used as a multiplier to obtain a new value

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

C001-05
1018
Exponent
Optional
Decimal number (R)
Min 1Max 15

Power to which a unit is raised

C001-06
649
Multiplier
Optional
Decimal number (R)
Min 1Max 10

Value to be used as a multiplier to obtain a new value

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

C001-08
1018
Exponent
Optional
Decimal number (R)
Min 1Max 15

Power to which a unit is raised

C001-09
649
Multiplier
Optional
Decimal number (R)
Min 1Max 10

Value to be used as a multiplier to obtain a new value

C001-10
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

C001-11
1018
Exponent
Optional
Decimal number (R)
Min 1Max 15

Power to which a unit is raised

C001-12
649
Multiplier
Optional
Decimal number (R)
Min 1Max 10

Value to be used as a multiplier to obtain a new value

C001-13
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

C001-14
1018
Exponent
Optional
Decimal number (R)
Min 1Max 15

Power to which a unit is raised

C001-15
649
Multiplier
Optional
Decimal number (R)
Min 1Max 10

Value to be used as a multiplier to obtain a new value

SLN-06
212
Unit Price
Optional
Decimal number (R)
Min 1Max 15

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

SLN-07
639
Basis of Unit Price Code
Optional
Identifier (ID)
Min 2Max 2

Code identifying the type of unit price for an item

SLN-08
662
Relationship Code
Optional
Identifier (ID)
Min 1Max 1

Code indicating the relationship between entities

  • SLN08 is a code indicating the relationship of the price or amount to the associated segment.
SLN-09
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)

  • SLN09 through SLN28 provide for ten different product/service IDs for each item. For example: Case, Color, Drawing No., U.P.C. No., ISBN No., Model No., or SKU.
SLN-10
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

SLN-11
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)

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

Identifying number for a product or service

SLN-13
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)

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

Identifying number for a product or service

SLN-15
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)

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

Identifying number for a product or service

SLN-17
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)

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

Identifying number for a product or service

SLN-19
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)

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

Identifying number for a product or service

SLN-21
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)

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

Identifying number for a product or service

SLN-23
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)

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

Identifying number for a product or service

SLN-25
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)

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

Identifying number for a product or service

SLN-27
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)

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

Identifying number for a product or service

SAC
230
Detail > IT1 Loop > SLN Loop > SAC

Service, Promotion, Allowance, or Charge Information

OptionalMax use 25

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

Example
At least one of Service, Promotion, Allowance, or Charge Code (SAC-02) or Agency Qualifier Code (SAC-03) is required
If either Agency Qualifier Code (SAC-03) or Agency Service, Promotion, Allowance, or Charge Code (SAC-04) is present, then the other is required
If either Allowance/Charge Percent Qualifier (SAC-06) or Percent (SAC-07) is present, then the other is required
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
If Reference Identification (SAC-13) is present, then at least one of Service, Promotion, Allowance, or Charge Code (SAC-02) or Agency Service, Promotion, Allowance, or Charge Code (SAC-04) is required
If Option Number (SAC-14) is present, then Reference Identification (SAC-13) is required
If Language Code (SAC-16) is present, then Description (SAC-15) 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.
C
Charge
N
No Allowance or Charge
SAC-02
1300
Service, Promotion, Allowance, or Charge Code
Optional
Identifier (ID)
Min 4Max 4

Code identifying the service, promotion, allowance, or charge

SAC-03
559
Agency Qualifier Code
Optional
Identifier (ID)
Min 2Max 2

Code identifying the agency assigning the code values

SAC-04
1301
Agency Service, Promotion, Allowance, or Charge Code
Optional
String (AN)
Min 1Max 10

Agency maintained code identifying the service, promotion, allowance, or charge

  • SAC04 may be used to uniquely identify the service, promotion, allowance, or charge. In addition, it may be used in conjunction to further the code in SAC02.
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-06
378
Allowance/Charge Percent Qualifier
Optional
Identifier (ID)
Min 1Max 1

Code indicating on what basis allowance or charge percent is calculated

SAC-07
332
Percent
Optional
Decimal number (R)
Min 1Max 6

Percent expressed as a percent

SAC-08
118
Rate
Optional
Decimal number (R)
Min 1Max 9

Rate expressed in the standard monetary denomination for the currency specified

  • SAC08 is the allowance or charge rate per unit.
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

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.
SAC-11
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

SAC-12
331
Allowance or Charge Method of Handling Code
Optional
Identifier (ID)
Min 2Max 2

Code indicating method of handling for an allowance or charge

SAC-13
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

  • SAC13 is used in conjunction with SAC02 or SAC04 to provide a specific reference number as identified by the code used.
SAC-14
770
Option Number
Optional
String (AN)
Min 1Max 20

A unique number identifying available promotion or allowance options when more than one is offered

  • SAC14 is used in conjunction with SAC13 to identify an option when there is more than one option of the promotion.
SAC-15
352
Description
Optional
String (AN)
Min 1Max 80

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

SAC-16
819
Language Code
Optional
Identifier (ID)
Min 2Max 3

Code designating the language used in text, from a standard code list maintained by the International Standards Organization (ISO 639)

  • SAC16 is used to identify the language being used in SAC15.
SLN Loop end
N1 Loop
OptionalMax >1
N1
240
Detail > IT1 Loop > N1 Loop > N1

Name

RequiredMax use 1

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

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

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

MQ
Metering Location
N1-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

N3
260
Detail > IT1 Loop > N1 Loop > N3

Address Information

OptionalMax use 2

To specify the location of the named party

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
270
Detail > IT1 Loop > N1 Loop > N4

Geographic Location

OptionalMax use 1

To specify the geographic place of the named party

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

Free-form text for city name

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

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

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

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

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

Code identifying the country

N1 Loop end
IT1 Loop end
Detail end

Summary

TDS
010
Summary > TDS

Total Monetary Value Summary

RequiredMax use 1

To specify the total invoice discounts and amounts

Example
TDS-01
610
Amount
Required
Numeric (N2)
Min 1Max 15

Monetary amount

  • TDS01 is the total amount of invoice (including charges, less allowances) before terms discount (if discount is applicable).
TDS-02
610
Amount
Optional
Numeric (N2)
Min 1Max 15

Monetary amount

  • TDS02 indicates the amount upon which the terms discount amount is calculated.
  • TDS02 is required if the dollar value subject to discount is not equal to the dollar value of TDS01.
TDS-03
610
Amount
Optional
Numeric (N2)
Min 1Max 15

Monetary amount

  • TDS03 is the amount of invoice due if paid by terms discount due date (total invoice or installment amount less cash discount).
TDS-04
610
Amount
Optional
Numeric (N2)
Min 1Max 15

Monetary amount

  • TDS04 indicates the total amount of terms discount.
TXI
020
Summary > TXI

Tax Information

OptionalMax use 10

To specify tax information

Example
If either Tax Jurisdiction Code Qualifier (TXI-04) or Tax Jurisdiction Code (TXI-05) is present, then the other is required
At least one of Monetary Amount (TXI-02), Percent (TXI-03) or Tax Exempt Code (TXI-06) is required
If Dollar Basis For Percent (TXI-08) is present, then Percent (TXI-03) is required
TXI-01
963
Tax Type Code
Required
Identifier (ID)

Code specifying the type of tax

Usage notes

CS - City Sales Tax
CT - County Tax
ET - Emergency Services Tax
FF - Franchise Fee Tax
GR - Gross Receipts Reimbursement
LT - Library Tax
SE - TX Puc Assessment
SP - State Sales Tax

CS
City Sales Tax
CT
County Tax
ET
Energy Tax

Emergency Services Tax

FF
Fuel Super Fund Tax

Franchise Fee Tax

GR
Gross Receipts Tax

Gross Receipts Reimbursement

LT
Local Sales Tax (All Applicable Sales Taxes by Taxing Authority Below the State Level)

Library Tax

SE
State Excise Tax

TX Puc Assessment

SP
State/Provincial Tax

State Sales Tax

TXI-02
782
Monetary Amount
Optional
Decimal number (R)
Min 1Max 15

Monetary amount

  • TXI02 is the monetary amount of the tax.
Usage notes

If TXI01 has a code, then TXI02 must have a value listed.

TXI-03
954
Percent
Optional
Decimal number (R)
Min 1Max 10

Percentage expressed as a decimal

  • TXI03 is the tax percent expressed as a decimal.
TXI-04
955
Tax Jurisdiction Code Qualifier
Optional
Identifier (ID)
Min 2Max 2

Code identifying the source of the data used in tax jurisdiction code

TXI-05
956
Tax Jurisdiction Code
Optional
String (AN)
Min 1Max 10

Code identifying the taxing jurisdiction

TXI-06
441
Tax Exempt Code
Optional
Identifier (ID)
Min 1Max 1

Code identifying exemption status from sales and use tax

TXI-07
662
Relationship Code
Optional
Identifier (ID)
Min 1Max 1

Code indicating the relationship between entities

  • TXI07 is a code indicating the relationship of the price or amount to the associated segment.
TXI-08
828
Dollar Basis For Percent
Optional
Decimal number (R)
Min 1Max 9

Dollar basis to be used in the percent calculation of the allowance, charge or tax

TXI-09
325
Tax Identification Number
Optional
String (AN)
Min 1Max 20

Number assigned to a purchaser (buyer, orderer) by a taxing jurisdiction (state, county, etc.); often called a tax exemption number or certificate number

TXI-10
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

CTT
070
Summary > CTT

Transaction Totals

OptionalMax use 1

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

  • Number of line items (CTT01) is the accumulation of the number of IT1 segments.
    If used, hash total (CTT02) is the sum of the value of quantities invoiced (IT102) for each IT1 segment.
Example
CTT-01
354
Number of Line Items
Required
Numeric (N0)
Min 1Max 6

Total number of line items in the transaction set

SE
080
Summary > SE

Transaction Set Trailer

RequiredMax use 1

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

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

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

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

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

Summary end

Functional Group Trailer

RequiredMax use 1

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

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

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

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

Assigned number originated and maintained by the sender

Interchange Control Trailer

RequiredMax use 1

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

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

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

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

A control number assigned by the interchange sender

EDI Samples

Sample

ISA*00* *00* *ZZ*SENDER *ZZ*RECEIVER *231106*1439*U*00401*000000001*0*T*>
GS*IN*SENDERGS*RECEIVERGS*20231106*143919*000000001*X*004010
ST*810*020859176
BIG*20160422*D161130026643015**UTILITY***PR*00
REF*11*825377
REF*12*10204049731033110
N1*8S*NAME OF COMPANY*1*007923311
N3*700 ADDRESS
N4*GAHANNA*OH*42320
PER*IC**TE*(877)-373-4858
N1*SJ*ENERGY*1*800770810
N3*1001 ADDRESS
N4*PITTSBURGH*PA*15222
PER*IC**TE*1-888-925-9115
N1*RE*ENERGY COMPANY*1*800770810
N3*P.O. BOX 642665
N4*PITTSBURGH*PA*15264-2665
N1*BT*H-E-B GROCERY COMPANY, STORE #070, ABILENE*92*61526
N3*ACCOUNTS PAYABLE, ATTN: UTILITIES*PO BOX 839944
N4*SAN ANTONIO*TX*78283
ITD*05*4****20160512
DTM*186*20151202
DTM*187*20160104
BAL*P*BD*-1618.3
BAL*M*J9*-1618.3
BAL*P*TP*0
BAL*M*PB*23992.29
BAL*P*YB*-1618.3
BAL*A*BM*0
BAL*M*YB*22373.99
IT1*1*****SV*ELECTRIC-SUP*C3*ACCOUNT
TXI*CS*443.26
TXI*GR*433.22
TXI*SE*36.17
TXI*SP*1385.21
TXI*FR*0
DTM*150*20151202
DTM*151*20160104
SLN*1**A
SAC*N**EU*MSC000*1424054**********Direct Energy Current Charges
SLN*2**A
SAC*C**EU*ENC001*671278***.016166*KH*415229.4*****Wholesale Energy 1 - 415,229.4 kWh Total @ $0.016166/kWh
SLN*3**A
SAC*C**EU*TRN000*63416***.001527*KH*415229.4*****Loss Charges - 415,229.4 kWh Actual @ $0.001527/kWh
SLN*4**A
SAC*C**EU*TRN000*2995***.000793*KH*37748.127273*****Ancillary Services - 37,748.127273 kWh Total @ $0.000793 /kW
SLN*5**A
SAC*C**EU*TRN000*30366***.000804*KH*377481.272727*****Ancillary Services - 377,481.272727 kWh Total @ $0.000804 /k
SLN*6**A
SAC*C**EU*ENC000*125***.000033*KH*37748.127273*****Renewable Energy - 37,748.127273 kWh Total @ $0.000033 /kWh
SLN*7**A
SAC*C**EU*ENC000*1019***.000027*KH*377481.272727*****Renewable Energy - 377,481.272727 kWh Total @ $0.000027 /kW
SLN*8**A
SAC*C**EU*ENC000*2095***.000555*KH*37748.127273*****ERCOT Administrative Fees - 37,748.127273 kWh Total @ $0.000
SLN*9**A
SAC*C**EU*ENC000*17553***.000465*KH*377481.272727*****ERCOT Administrative Fees - 377,481.272727 kWh Total @ $0.00
SLN*10**A
SAC*C**EU*ENC000*93427***.00225*KH*415229.4*****Direct Energy Fees - 415,229.4 kWh Total @ $0.00225/kWh
SLN*11**A
SAC*C**EU*MSC000*0***0*KH*0*****Day Ahead Make Whole
SLN*12**A
SAC*C**EU*MSC000*10180***0*KH*0*****Wholesale Energy 3
SLN*13**A
SAC*C**EU*ADJ000*531600***0*KH*0*****Wholesale Energy 2
IT1*2*****SV*ELECTRIC-DEL*C3*ACCOUNT
DTM*150*20151202
DTM*151*20160104
SLN*1**A
SAC*N**EU*MSC000*745389**********LDC Current Charges
SLN*2**A
SAC*C**EU*BAS001*2600***26*EA*1*****BASIC CUSTOMER ADMINISTRATIVE CHARGES
SLN*3**A
SAC*C**EU*BAS003*3500***35*EA*1*****DELIVERY POINT CHARGE
SLN*4**A
SAC*C**EU*DIS001*287456***3.21*RC*895.5*****DISTRIBUTION CHARGE
SLN*5**A
SAC*C**EU*MSC000*27465***.000661*KH*415500*****ENERGY EFFICIENCY COST RECOVERY
SLN*6**A
SAC*C**EU*TRN001*197233***1.953*4C*1009.9*****TRANSMISSION CHARGE
SLN*7**A
SAC*C**EU*TRN002*227135***2.249087*4C*1009.9*****POINT TO POINT TRANSMISSION - FIRM SCHEDULE 7
IT1*3*****SV*ELECTRIC-SUP*C3*METER
MEA*AA**697.2*K1***51
MEA*AA**284073.6*K3*21539*22108*51
MEA*AA**415229.4*KH*30488*31319*51
MEA**MU*500
MEA**ZA*0
REF*MG*452758611
REF*RB*CLDCACCOUNT
DTM*150*20151202
DTM*151*20160104
N1*MQ*PREMISE
N3*1345 BARROW ST
N4*ABILENE*TX*79605-5171*USA
TDS*2399229
CTT*3
SE*95*020859176
GE*1*000000001
IEA*1*000000001

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.