Ace Hardware
/
Credit/Debit Adjustment
  • Specification
  • EDI Inspector
Import
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 EDI Guide Catalog
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
    View the latest version of this implementation guide as an interactive webpage
    Powered by
    Build free 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

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

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

    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
    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
    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
    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
    YYMMDD format

    Date of the interchange

    ISA-10
    I09
    Interchange Time
    Required
    HHMM format

    Time of the interchange

    ISA-11
    I10
    Interchange Control Standards Identifier
    Required

    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

    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
    Min 9Max 9

    A control number assigned by the interchange sender

    ISA-14
    I13
    Acknowledgment Requested
    Required
    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
    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
    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

    Code identifying a group of application related transaction sets

    CD
    Credit/Debit Adjustment (812)
    GS-02
    142
    Application Sender's Code
    Required
    Min 2Max 15

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

    GS-03
    124
    Application Receiver's Code
    Required
    Min 2Max 15

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

    GS-04
    373
    Date
    Required
    CCYYMMDD format

    Date expressed as CCYYMMDD

    GS-05
    337
    Time
    Required
    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
    Min 1Max 9

    Assigned number originated and maintained by the sender

    GS-07
    455
    Responsible Agency Code
    Required
    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

    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

    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

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

    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
    CCYYMMDD format

    Date expressed as CCYYMMDD

    • BCD01 is the credit/debit adjustment date.
    BCD-02
    475
    Credit/Debit Adjustment Number
    Required
    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

    Code designating the action to be taken by all parties

    T
    Adjustment Requested
    BCD-04
    610
    Amount
    Required
    Min 1Max 15

    Monetary amount

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

    Code indicating whether amount is a credit or debit

    C
    Credit
    BCD-07
    76
    Invoice Number
    Optional
    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
    Min 1Max 22

    Identifying number for Purchase Order assigned by the orderer/purchaser

    Usage notes

    Ace Hardware Original PO Number

    CUR
    030

    Currency

    RequiredMax use 1

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

    Example
    CUR-01
    98
    Entity Identifier Code
    Required

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

    ZZ
    Mutually Defined
    CUR-02
    100
    Currency Code
    Required

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

    USD
    US Dollar
    SAC
    097

    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

    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

    Code identifying the service, promotion, allowance, or charge

    C310
    Discount
    SAC-03
    559
    Agency Qualifier Code
    Optional
    Min 2Max 2

    Code identifying the agency assigning the code values

    Usage notes

    Total Discount Amount

    SAC-05
    610
    Amount
    Optional
    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 N1 Loop Vendor
    RequiredMax >1
    N1
    100

    Name

    RequiredMax use 1

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

    Example
    N1-01
    98
    Entity Identifier Code
    Required

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

    VN
    Vendor
    N1-02
    93
    Name
    Optional
    Min 1Max 60

    Free-form name

    N2
    110

    Additional Name Information

    OptionalMax use 2

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

    Example
    N2-01
    93
    Name
    Required
    Min 1Max 60

    Free-form name

    N3
    120

    Address Information

    RequiredMax use 2

    To specify the location of the named party

    Example
    N3-01
    166
    Address Information
    Required
    Min 1Max 55

    Address information

    N4
    130

    Geographic Location

    RequiredMax use 1

    To specify the geographic place of the named party

    Example
    N4-01
    19
    City Name
    Optional
    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
    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
    Min 3Max 15

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

    N4-04
    26
    Country Code
    Optional
    Min 2Max 3

    Code identifying the country

    Detail

    CDD Loop
    RequiredMax >1
    CDD
    160

    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

    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

    Code indicating whether amount is a credit or debit

    C
    Credit
    CDD-07
    477
    Credit/Debit Quantity
    Optional
    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

    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
    Min 3Max 3

    Code identifying pricing specification

    Usage notes

    "UCP" UNIT PRICE CODE

    CDD-11
    212
    Unit Price
    Optional
    Min 1Max 15

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

    Usage notes

    UNIT PRICE

    LIN
    170

    Item Identification

    RequiredMax use 1

    To specify basic item identification data

    Example
    LIN-01
    350
    Assigned Identification
    Optional
    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

    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
    Min 1Max 48

    Identifying number for a product or service

    N9
    200

    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

    Code qualifying the Reference Identification

    ZZ
    Mutually Defined
    N9-02
    127
    Reference Identification
    Optional
    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
    Min 1Max 45

    Free-form descriptive text

    SE
    270

    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
    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
    Min 4Max 9

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

    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
    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
    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
    Min 1Max 5

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

    IEA-02
    I12
    Interchange Control Number
    Required
    Min 9Max 9

    A control number assigned by the interchange sender

    EDI Samples

    Sample 812

    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¬12148~
    IEA¬1¬000012148~

    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.