Skip to content
EDI X12 889

X12 transaction code

X12 889 Promotion Announcement

Stop Mapping. Start Trading.

Standard
X12
Code
889
Trading partners
1

Specification summary

X12 889 Promotion Announcement at the element level

The X12 889 specification defines 20 segments carrying 61 data elements, 37 of which are mandatory.

Segments
20
Data elements
61
Mandatory elements
37
Segments with mandatory elements
Segment Elements Mandatory
G42 2 2
G43 3 1
N1 4 1
G94 1 1
G95 5 1
LX 1 1
G46 3 2
G69 1 1
G22 2 1
Key identifiers in 889
  • Promotion Status Code
  • Allowance or Charge Number
  • Market Area Code Qualifier
  • Entity Identifier Code
  • Option Number
  • Promotion Condition Code
  • Assigned Number
  • Allowance or Charge Code

Trading partners that support X12 889

1 partner, 1 channel. Click a channel for the full segment guideline.

Usage breakdown

Who trades X12 889 Promotion Announcement

889 is used most heavily in grocery & food.

The 889 announces trade-promotion terms between consumer goods trading partners: allowance amounts, promotion start and end dates, performance conditions, and the items covered. It also carries lifecycle actions, including full replacement of a previously transmitted promotion, cancellation, date changes, and acceptance of a promotion offered by a broker or supplier. Partners require it so allowances claimed on later invoices reconcile against an agreed promotion record. The document is multidirectional: manufacturers, brokers, or distributors typically announce promotions to retail buying organizations, which can respond with acceptance using the same transaction. A manufacturer or broker finalizes a trade promotion, such as an off-invoice allowance for a defined date range, and must communicate the terms to buying organizations before orders ship under the deal.

By industry

  • grocery & food 1 channel
Largest 889 implementations

FAQ

X12 889 questions

What is X12 889 Promotion Announcement?

X12 889 (Promotion Announcement) is an EDI transaction set defined by ANSI ASC X12 for exchanging promotion announcement between trading partners. It is one of over 300 X12 transaction sets used across retail, healthcare, manufacturing, and logistics. 1 Stacksync trading partner supports this code across 1 channel.

Which trading partners use X12 889?

1 Stacksync partner accepts X12 889: Thrive Market. Each partner has its own implementation guideline that Stacksync pre-validates before sending. Browse the full directory above.

How do I integrate X12 889 with my ERP?

Stacksync handles the full X12 889 integration: partner channel certification (AS2, VAN, FTP), transaction-set mapping per the trading partner's implementation guide, translation to your ERP's native data model, and real-time delivery. Typical time from kickoff to production is 3 to 10 business days for a single partner connection.

Ready to automate your EDI?

Most teams go live in days, not months. Talk to our team and we'll walk you through your specific setup.