EDI

API DocsTerminal
NEW!
Programmatically translate EDI to JSON with the EDI Core REST API
Get started in minutes →
Transaction Set
in
X12 Release 004010

889 Promotion Announcement

Functional Group QG

This Draft Standard for Trial Use contains the format and establishes the data contents of the Promotion Announcement Transaction Set (889) for use within the context of an Electronic Data Interchange (EDI) environment. This transaction set can be used by a broker, distributor or manufacturer and provides for customary and established business and industry practice relative to the announcement of promotion allowance amounts, dates and performance conditions that may apply; the replacement of a previously transmitted promotion in its entirety; the cancellation of a previously transmitted promotion; changes to promotion dates; or acceptance of a promotion offered by a broker or supplier. This transaction set is multidirectional between trading partners.

Heading

Sequence
Segment
Name
Max use
010
Transaction Set HeaderMandatory
Max 1
To indicate the start of a transaction set and to assign a control number
020
Promotion Announcement IdentificationMandatory
Max 1
To identify promotion activities between trading partners
090
Reference Identification
Max 10
To transmit identifying information as specified by the Reference Identification Qualifier
100
Contact
Max 3
To identify a person or office to whom communications should be directed
110
Date/TimeMandatory
Max 50
To specify pertinent dates and times
120
Note/Special Instruction
Max 300
To transmit information in a free-form format, if necessary, for comment or special instruction
130
Promotion/Price List Area
Max 1000
To specify the geographic area in which a promotion or price is in effect
145
Terms of Sale
Max 1
To specify the terms of sale
0100 Loop
Repeat >1
150
NameMandatory
Max 1
To identify a party by type of organization, name, and code
160
Additional Name Information
Max 1
To specify additional names or those longer than 35 characters in length
170
Address Information
Max 2
To specify the location of the named party
180
Geographic Location
Max 1
To specify the geographic place of the named party
185
Date/Time
Max >1
To specify pertinent dates and times
0200 Loop
Repeat 20
190
Promotion Conditions
Max 1
To indicate the option number associated with a promotion and to specify the "AND" or "OR" condition for the option
200
Performance Requirements
Max 99
To specify the "AND" or "OR" condition for the option, or provide information related to the promotion performance conditions and allocations required, or both

Detail

Sequence
Segment
Name
Max use
0300 Loop
Repeat 9999
015
Assigned Number
Max 1
To reference a line number in a transaction set
020
Promotion Allowance/Charge
Max 20
To specify unit amount and method of payment for a charge/allowance for a line item
025
Free Goods/Product Condition
Max 1
To indicate quantity of free goods and under what conditions free goods are earned
The G51 segment can be used in the 0300 loop or the 0320 loop, but not both.
0310 Loop
Repeat 20
032
Promotion Conditions
Max 1
To indicate the option number associated with a promotion and to specify the "AND" or "OR" condition for the option
0311 Loop
Repeat 99
035
Performance Requirements
Max 1
To specify the "AND" or "OR" condition for the option, or provide information related to the promotion performance conditions and allocations required, or both
036
Date/Time
Max 2
To specify pertinent dates and times
0320 Loop
Repeat 9999
040
Line Item Detail - Promotion
Max 1
To provide information for a line item
050
Line Item Detail - Description
Max 5
To describe an item in free-form format
055
Promotion/Price List Area
Max 9999
To specify the geographic area in which a promotion or price is in effect
060
Free Goods/Product Condition
Max 10
To indicate quantity of free goods and under what conditions free goods are earned
The G51 segment can be used in the 0300 loop or the 0320 loop, but not both.
075
Terms of Sale
Max 1
To specify the terms of sale
080
Date/Time
Max 10
To specify pertinent dates and times
085
Pricing Information
Max 1
To specify prepricing information
087
Quantity
Max 10
To specify quantity information
100
Transaction Set TrailerMandatory
Max 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)
Stedi is a registered trademark of Stedi, Inc. Stedi's EDI Reference and Mapping Guides are provided for marketing purposes and are free of charge. All names, logos, and brands of third parties listed on our site 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. Our use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.
Stedi is a registered trademark of Stedi, Inc. Stedi's EDI Reference and Mapping Guides are provided for marketing purposes and are free of charge. All names, logos, and brands of third parties listed on our site 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. Our use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.