Ace Hardware
/
Credit/Debit Adjustment
  • Specification
  • EDI Inspector
Import guide into your account
Stedi maintains this guide based on public documentation from Ace Hardware. Contact Ace Hardware for official EDI specifications. To report any errors in this guide, please contact us.
Go to Stedi Network
Ace Hardware logo

X12 812 Credit/Debit Adjustment

X12 Release 4010

This Draft Standard for Trial Use contains the format and establishes the data contents of the Credit/Debit Adjustment Transaction Set (812) for use within the context of an Electronic Data Interchange (EDI) environment. The transaction set can be used to notify a trading partner of an adjustment or billback and may be used to request an adjustment or billback. It identifies and contains the details and amounts covering exceptions, adjustments, credits, or debits for goods or services. This transaction set is multi-directional between trading partners.

Delimiters
  • ~ Segment
  • * Element
  • > Component
EDI sample
  • Sample 812
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/ace-hardware/creditdebit-adjustment/01GTHEZQE5JDP003YTSH6WFFWP
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
BCD
020
Beginning Credit/Debit Adjustment
Max use 1
Required
CUR
030
Currency
Max use 1
Required
SAC
097
Service, Promotion, Allowance, or Charge Information
Max use 25
Required
N1 Loop Vendor
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)

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

01
Duns (Dun & Bradstreet)
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

CD
Credit/Debit Adjustment (812)
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).
812
Credit/Debit Adjustment
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

BCD
020
Heading > BCD

Beginning Credit/Debit Adjustment

RequiredMax use 1

To transmit identifying dates and numbers for the transaction set and indicate the monetary value to the receiver of the transaction

  • BCD05 indicates whether the net of the detail is a credit or a debit.
Example
BCD-01
373
Date
Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • BCD01 is the credit/debit adjustment date.
BCD-02
475
Credit/Debit Adjustment Number
Required
String (AN)
Min 1Max 22

Number assigned by issuer of a credit or debit memo

Usage notes

Credit memo number

BCD-03
305
Transaction Handling Code
Required
Identifier (ID)

Code designating the action to be taken by all parties

T
Adjustment Requested
BCD-04
610
Amount
Required
Numeric (N2)
Min 1Max 15

Monetary amount

  • BCD04 is the net amount of this complete transaction.
BCD-05
478
Credit/Debit Flag Code
Required
Identifier (ID)

Code indicating whether amount is a credit or debit

C
Credit
BCD-07
76
Invoice Number
Optional
String (AN)
Min 1Max 22

Identifying number assigned by issuer

  • If using BCD07 or BCD10, do not use BCD14 to identify invoice number or purchase order number.
Usage notes

Original Invoice Number

BCD-10
324
Purchase Order Number
Optional
String (AN)
Min 1Max 22

Identifying number for Purchase Order assigned by the orderer/purchaser

Usage notes

Ace Hardware Original PO Number

CUR
030
Heading > CUR

Currency

RequiredMax use 1

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

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

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

ZZ
Mutually Defined
CUR-02
100
Currency Code
Required
Identifier (ID)

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

USD
US Dollar
SAC
097
Heading > SAC

Service, Promotion, Allowance, or Charge Information

RequiredMax 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
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
SAC-02
1300
Service, Promotion, Allowance, or Charge Code
Optional
Identifier (ID)

Code identifying the service, promotion, allowance, or charge

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

Code identifying the agency assigning the code values

Usage notes

Total Discount Amount

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.
N1 Loop Vendor
RequiredMax >1
N1
100
Heading > N1 Loop Vendor > 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

VN
Vendor
N1-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

N2
110
Heading > N1 Loop Vendor > N2

Additional Name Information

OptionalMax use 2

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

Example
N2-01
93
Name
Required
String (AN)
Min 1Max 60

Free-form name

N3
120
Heading > N1 Loop Vendor > N3

Address Information

RequiredMax use 2

To specify the location of the named party

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

Address information

N4
130
Heading > N1 Loop Vendor > N4

Geographic Location

RequiredMax 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 Vendor end
Heading end

Detail

CDD Loop
RequiredMax >1
CDD
160
Detail > CDD Loop > CDD

Credit/Debit Adjustment Detail

RequiredMax use 1

To provide information relative to a line item adjustment

Example
If either Credit/Debit Quantity (CDD-07) or Unit or Basis for Measurement Code (CDD-08) is present, then the other is required
If Credit/Debit Quantity (CDD-07) is present, then Unit Price (CDD-11) is required
If either Price Identifier Code (CDD-10) or Unit Price (CDD-11) is present, then the other is required
CDD-01
426
Adjustment Reason Code
Required
Identifier (ID)

Code indicating reason for debit or credit memo or adjustment to invoice, debit or credit memo, or payment

CS
Adjustment
CDD-02
478
Credit/Debit Flag Code
Required
Identifier (ID)

Code indicating whether amount is a credit or debit

C
Credit
CDD-07
477
Credit/Debit Quantity
Optional
Decimal number (R)
Min 1Max 10

Number of supplier units credited or debited

Usage notes

Number of Units

CDD-08
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

AS
Assortment
BA
Bale
BC
Bucket
BD
Bundle
BG
Bag
BX
Box
CA
Case
CG
Card
CN
Can
CS
Cassette
CT
Carton
CX
Coil
DR
Drum
DS
Display
EA
Each
HA
Hank
KT
Kit
LN
Length
PA
Pail
PK
Package
PL
Pallet/Unit Load
PR
Pair
RE
Reel
RL
Roll
RM
Ream
SL
Sleeve
SO
Spool
ST
Set
TB
Tube
CDD-10
236
Price Identifier Code
Optional
Identifier (ID)
Min 3Max 3

Code identifying pricing specification

Usage notes

"UCP" UNIT PRICE CODE

CDD-11
212
Unit Price
Optional
Decimal number (R)
Min 1Max 15

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

Usage notes

UNIT PRICE

LIN
170
Detail > CDD Loop > LIN

Item Identification

RequiredMax use 1

To specify basic item identification data

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

Alphanumeric characters assigned for differentiation within a transaction set

  • LIN01 is the line item identification
LIN-02
235
Product/Service ID Qualifier
Required
Identifier (ID)

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

  • LIN02 through LIN31 provide for fifteen different product/service IDs for each item. For example: Case, Color, Drawing No., U.P.C. No., ISBN No., Model No., or SKU.
IN
Buyer's Item Number

ACE SKU NUMBER

LIN-03
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

N9
200
Detail > CDD Loop > N9

Reference Identification

RequiredMax use >1

To transmit identifying information as specified by the Reference Identification Qualifier

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

Code qualifying the Reference Identification

ZZ
Mutually Defined
N9-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

N9-03
369
Free-form Description
Optional
String (AN)
Min 1Max 45

Free-form descriptive text

CDD Loop end
SE
270
Detail > 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

Detail 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 812

ISA*00* *00* *ZZ*SENDER *ZZ*RECEIVER *231101*0059*U*00401*000000001*0*T*>~
GS*CD*SENDERGS*RECEIVERGS*20231101*005900*000000001*X*004010~
ST*812*30389~
BCD*20190122*1234567891*T*11361*C**4545454545***AZ123~
CUR*ZZ*USD~
SAC*C*C310***227~
N1*VN*WARE CORPORATION~
N3*2200 KENSINGTON COURT~
N4*OAK BROOK*IL*60521*US~
CDD*CS*C*****1*EA**UCP*113.61~
LIN*001*IN*2222222~
N9*ZZ**WARE TABLE LAMP~
SE*11*30389~
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.