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

889 Promotion Announcement

Functional Group QG

X12M Supply Chain Subcommittee

This X12 Transaction Set 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
0100
Transaction Set HeaderMandatory
Max 1
To indicate the start of a transaction set and to assign a control number
0200
Promotion Announcement IdentificationMandatory
Max 1
To identify promotion activities between trading partners
0900
Extended Reference Information
Max 10
To transmit identifying information as specified by the Reference Identification Qualifier
1000
Contact
Max >1
To identify a person or office to whom communications should be directed
1100
Date/TimeMandatory
Max 50
To specify pertinent dates and times
1200
Note/Special Instruction
Max 300
To transmit information in a free-form format, if necessary, for comment or special instruction
1300
Promotion/Price List Area
Max 1000
To specify the geographic area in which a promotion or price is in effect
1450
Terms of Sale
Max 1
To specify the terms of sale
0100 Loop
Repeat >1
1500
Party IdentificationMandatory
Max 1
To identify a party by type of organization, name, and code
1600
Additional Name Information
Max 1
To specify additional names
1700
Party Location
Max 2
To specify the location of the named party
1800
Geographic Location
Max 1
To specify the geographic place of the named party
1850
Date/Time
Max >1
To specify pertinent dates and times
0200 Loop
Repeat 20
1900
Promotion Conditions
Max 1
To indicate the option number associated with a promotion and to specify the "AND" or "OR" condition for the option
2000
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
0150
Transaction Set Line Number
Max 1
To reference a line number in a transaction set
0200
Promotion Allowance/Charge
Max 20
To specify unit amount and method of payment for a charge/allowance for a line item
0250
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
0320
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
0350
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
0360
Date/Time
Max 2
To specify pertinent dates and times
0320 Loop
Repeat 9999
0400
Line Item Detail - Promotion
Max 1
To provide information for a line item
0500
Line Item Detail - Description
Max 5
To describe an item in free-form format
0550
Promotion/Price List Area
Max 9999
To specify the geographic area in which a promotion or price is in effect
0600
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.
0750
Terms of Sale
Max 1
To specify the terms of sale
0800
Date/Time
Max 10
To specify pertinent dates and times
0850
Pre-Pricing Information
Max 1
To specify pre-pricing information
0870
Quantity Information
Max 10
To specify quantity information
1000
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.