972-836-7750 Request a demo Talk to an expert
Talk to an expert Request a demo Call sales 972-836-7750

X12 transaction guide · Catalogs and pricing

EDI 889 Promotion Announcement

The X12 document a broker, distributor or manufacturer uses to announce promotion allowances, dates and conditions, or to replace or cancel a promotion.

Sent by
Manufacturer, broker or distributor
Received by
Retailer or wholesaler
Standard
ANSI ASC X12

What is an EDI 889?

The EDI 889 Promotion Announcement is the ANSI X12 transaction set used to announce promotion allowance amounts, the dates they apply and any performance conditions attached to them. It can also replace a promotion sent earlier in its entirety or cancel it.

Promotions drive a large share of consumer goods volume, and the allowances they carry reduce what the buyer pays. Announcing them electronically lets the buyer plan orders around the promotion and apply the right allowances when invoices arrive, which reduces deductions and disputes.

How the EDI 889 worksDiagram of the EDI 889 Promotion Announcement. Manufacturer, broker or distributor sends it to retailer or wholesaler. It usually starts the exchange. It is usually followed by 997, 875 and 850. Inside the ISA, GS and ST envelopes, X12 release 008010 requires, in the heading: G42 (Promotion Announcement Identification), G62 (Date/Time) and the required 0100 loop with N1 (Party Identification). 2 optional loops are listed by their first segment.How the EDI 889 worksPromotion Announcement: who sends it, where it fits and what the standard marks required1 WHERE IT FITSUSUALLY FOLLOWSStarts the exchangeEDI 889SENDERManufacturer, brokeror distributorRECEIVERRetailer or wholesaler997 or 999 acknowledgment back, if the partners agreeUSUALLY FOLLOWED BY997FunctionalAcknowledgment875Grocery ProductsPurchase Order850Purchase Order2 WHAT X12 RELEASE 008010 REQUIRESInterchange: sender and receiver IDsISA … IEAFunctional group, ID code QGGS … GETransaction set 889ST … SEHEADINGG42Promotion Announcement IdentificationG62Date/TimeRequired loop 0100 · repeats many timesN1Party Identification+ 1 optional loop, starting with:G94DETAIL+ 1 optional loop, starting with:LXBlue box: required loop. Optional loops are listed by the segment that starts them; when a loop is used, that first segment is required. Optional segmentsoutside loops are not drawn.Structure: required segments and loops in the X12 008010 listing for the 889. Your trading partner's implementation guide adds its own requirements.
How the EDI 889 worksDiagram of the EDI 889 Promotion Announcement. Manufacturer, broker or distributor sends it to retailer or wholesaler. It usually starts the exchange. It is usually followed by 997, 875 and 850. Inside the ISA, GS and ST envelopes, X12 release 008010 requires, in the heading: G42 (Promotion Announcement Identification), G62 (Date/Time) and the required 0100 loop with N1 (Party Identification). 2 optional loops are listed by their first segment.How the EDI 889 worksPromotion Announcement: who sends it, whereit fits and what the standard marks required1 WHERE IT FITSUSUALLY FOLLOWSStarts the exchangeEDI 889SENDERManufacturer,broker ordistributorRECEIVERRetailer orwholesaler997 or 999 acknowledgment back, if the partnersagreeUSUALLY FOLLOWED BY997Functional Acknowledgment875Grocery Products Purchase Order850Purchase Order2 WHAT X12 RELEASE 008010 REQUIRESInterchange: sender and receiver IDs (ISA… IEA)Functional group, ID code QG (GS … GE)Transaction set 889 (ST … SE)HEADINGG42Promotion AnnouncementIdentificationG62Date/TimeRequired loop 0100 · repeatsmany timesN1Party Identification+ 1 optional loop, starting with:G94DETAIL+ 1 optional loop, starting with:LXBlue box: required loop. Optional loops are listedby the segment that starts them; when a loop isused, that first segment is required. Optionalsegments outside loops are not drawn.Structure: required segments and loops in the X12008010 listing for the 889. Your trading partner'simplementation guide adds its own requirements.

How to read this diagram: the top row shows who sends the 889, to whom, and which documents usually come before and after it. The lower part shows what X12 release 008010 itself requires: the envelopes around the 889 and the segments and loops the standard marks as required, area by area. Optional loops are listed by the segment that starts them rather than drawn in full. This is the standard's minimum, not a trading partner's requirement: each partner's implementation guide usually makes some optional loops mandatory, restricts the codes and may use a different release.

Expand diagram Download SVG

When it is used

  • Announcing a new trade promotion and its allowances
  • Replacing a promotion with revised terms
  • Cancelling a promotion before it starts

Where it fits in the document flow

This document 889 Promotion Announcement
Usually followed by 997 Functional Acknowledgment875 Grocery Products Purchase Order850 Purchase Order

Structure

Mandatory segments in the 889 (X12 release 008010)

The segments X12 release 008010 marks as mandatory at their level, in order. Segments inside optional loops are needed only when the loop is used. This is the standard's requirement, not your trading partner's: each partner's implementation guide names the release it uses, adds the optional segments it requires and restricts the values. The requirement status comes from one published X12 reference listing and has not been checked against a second source.

  • ST
  • G42
  • G62
  • N1
  • G94
  • LX
  • G95
  • G45
  • SE

Practical example

The 889 in practice

A coffee brand offers wholesalers an off-invoice allowance on selected items for a four-week period, provided they feature the items in their weekly ads. It sends an 889 with the items, the allowance per case, the dates and the performance condition. The wholesaler plans larger orders for the period and applies the allowance when invoices arrive.

Implementation

Implementation considerations for the 889

  • Make the promotion identifiers on later orders and invoices match the 889.
  • Treat replacements and cancellations as updates to the original promotion, not new ones.
  • Record performance conditions so proof of performance can be matched before payment.

How ECOM helps

Automate the 889 with ECOM

Industry

Food and Beverage

Grocery and foodservice EDI for food and beverage manufacturers, with lot, date and inventory data.

Industry

Consumer Goods

Retail, distributor, marketplace and direct-channel integration for consumer brands.

Solution

Order-to-Cash Automation

Automate the flow from purchase order to payment across every customer channel.

More general questions about EDI are answered in the EDI FAQ.

Related transactions

Related catalogs and pricing documents

All 21 catalogs and pricing documents

Need help with the EDI 889?

ECOM maps, tests and monitors X12 documents for your trading partners and integrates them with your ERP.

Request a Demo Contact us