EDI 889 Promotion Announcement: Trade Deal Guide

The EDI 889 is the trade deal in structured form. When a grocery manufacturer funds a holiday feature, a temporary price reduction or a display, the retailer needs to know which items, how much per case, which dates count, and what it has to do to earn the money. The 889 carries all of that, so the deal reaches the retailer's buying and deal systems as data instead of a PDF deal sheet someone keys in.

This guide covers what the 889 carries, how grocery promotion dates and allowance types work, two live examples (a new promotion and a date change), every segment you will map, and the errors that turn into disputed deductions months later.

What Is an EDI 889?

An EDI 889 is the Promotion Announcement transaction set defined by the ASC X12 standards body. It lets a broker, distributor or manufacturer announce promotion allowance amounts, dates and performance conditions, and also replace, cancel or change the dates of a promotion, or accept one that was offered. It belongs to the grocery UCS family, uses grocery "G" segments, and travels in functional group QG (Product Information) with the 888 Item Maintenance.

Authoritative references for 889 work:

• The X12 transaction set catalog defines the 889 structure, its segment order and the code lists for promotion status, date qualifiers, allowance codes and promotion conditions
• GS1 US governs the UPC case codes and consumer UPCs that identify each promoted item
• Each retailer's promotion or deal implementation guide sets which allowance codes, handling methods and performance conditions it accepts

Who sends it? Usually the manufacturer or its broker. X12 defines the 889 as multidirectional, so a retailer or wholesaler can send one back to accept a promotion and state which options it chose.

Who receives it? A grocery retailer or wholesaler, into the system its buyers use to plan promotions and that its accounts payable team later uses to settle them.

When is it sent? Ahead of the promotion's order window, and again whenever the deal changes: new dates, a replacement, a cancellation.

Why does it matter? Trade promotion money moves through deductions and bill-backs long after the event. If the retailer's deal record does not match yours (different dates, a different per-case rate, an item you did not fund), the difference comes back as a deduction you have to research and dispute. An 889 that both sides load from the same data is the simplest way to avoid that.

How Grocery Trade Promotions Are Structured

Three ideas cover most of what an 889 expresses.

Allowance types. The money is described by an allowance code (what it is for) and a method of handling (how it is paid). The common pairings in grocery:

Date windows. A promotion has more than one date range, and each has its own G62 qualifier. The retailer orders during the order window, receives during the ship window, and runs the event in the store during the promotion or performance window. Off-invoice deals are usually tied to the ship or order dates. Performance and scan deals are tied to the in-store dates.

Performance options. A deal can offer more than one way to earn it. Option 1 might be a plain off-invoice allowance with a minimum order. Option 2 might add a bill-back for running an ad and an end-aisle display. The 889 numbers each option, ties each allowance to an option, and lists the conditions with AND or OR logic.

Interactive Example: New Promotion (G42 Status 01)

A granola manufacturer announces a December holiday baking event to a grocery chain. The header sets status 01 (new) and the promotion number, then four dates: the promotion runs December 1 to 31 and the ship window is November 15 to December 15. The detail has two allowances. Option 1 is a $1.50 per case off-invoice allowance with a 10-case minimum. Option 2 is a $0.75 per case bill-back for running an ad and an end-aisle display. Both apply to the two items listed in G45.

Use the Plain English tab for a readable summary, or click any segment to break it down element by element.

Interactive Example: Promotion Date Change (G42 Status 06)

Two weeks later the retailer asks to move the event back a week. The supplier sends a short 889 with status 06 (replace all dates) and the same promotion number. It restates the four dates and the parties, and leaves the allowances and items as announced.

889 Structure at a Glance

GS01 is QG. Retailer guides commonly name the version 004010UCS in GS08.

Key Segments Explained

G42: Promotion Announcement Identification

G42*01*PRM-26-0417~

Keep the promotion number stable across every status. A changed number turns a date change into a second promotion in the retailer's deal system.

G62: Promotion Dates

G62*15*20261201~
G62*16*20261231~
G62*25*20261115~
G62*26*20261215~

G6201 is the date qualifier and G6202 the date. The promotion qualifiers in the X12 code list come in start and end pairs:

The header requires at least one G62. Which pairs a retailer requires, and which window it applies each allowance to, is defined in its guide. Get this wrong and an off-invoice allowance is missing from invoices for cases shipped in the right window.

N1: Parties

N1*BY*HARBOR GROCERY*1*069854900~
N1*SU*PINE HOLLOW FOODS*1*081234567~

The N1 loop is mandatory and names the buyer and supplier (and a broker, where one is involved), here by DUNS number. Each N1 loop can carry its own G62 dates.

LX and G46: Promotion Allowance/Charge

Each detail group starts with LX and lists its allowances in G46.

G46*101*02*1.50*CA*****1*OFF INVOICE CASE ALLOWANCE~
G46*90*01*0.75*CA*****2*AD AND DISPLAY PERFORMANCE~

A G46 carries a rate, an amount or a percent, never more than one. Some allowance codes that grocery deals use: 43 Display Allowance, 47 Price and Marketing Allowance, 65 New Item Allowance, 66 Slotting Allowance, 68 Scanner Allowance, 90 Performance Allowance, 97 Cents Off, 100 Advertising Allowance and 101 Voluntary Price Reduction. The sample uses 101 for the off-invoice case allowance and 90 for the performance bill-back. Retailers map these codes to their own deal types differently, so the code list in the retailer's guide decides which to send.

G94 and G95: Options and Performance Requirements

G94**1~
G95**06**10*CA~
G94**2~
G95**10~
G95*01*41~

G94 opens an option: G9402 is the option number that G4609 points to. G95 lists what the retailer must do for that option.

Read the sample as: option 1 requires a minimum order of 10 cases (06). Option 2 requires an advertisement (10) AND an end-aisle display (41). Common condition codes include 06 minimum order quantity, 10 advertisement (size not specified), 17 full-page advertisement, 33 circular advertisement, 40 display, 41 end-aisle display, 60 reduced price, 84 product scanning report required and 99 free-form text.

G45: Line Item Detail, Promotion

G45*008451200116*084512001168*PRM-26-0417**VN*PH-GRN-HNY16*12*16*OZ~

The case code and UPC must match what the retailer set up from your 888 or 832. An item the retailer cannot match is dropped from the deal, and the allowance you meant to fund on it never reaches the invoice.

Other 889 Segments

• G43 names the promotion or price list areas the deal covers. How those areas are coded is set by the retailer's guide.
• G51 describes free goods deals (buy a quantity, get product free) at the promotion or item level, but not both.
• G22 gives the suggested promoted retail price and multiple.
• NTE carries free-text deal notes. Put anything a system must act on in a coded segment, not in a note.

Where 889 Money Shows Up Later

An 889 is a promise. It turns into money on other documents, and each one has to agree with it:

1. Order. The retailer orders in the window on an 875 or 850, often expecting the deal cost.
2. Invoice. Off-invoice allowances appear as allowance lines on the 880 grocery invoice or 810, against the promotion number.
3. DSD deliveries. For direct store delivery, deals are applied at the back door through G72 allowances on the 894 Delivery/Return Base Record. An allowance the store has no record of is removed at check-in.
4. Bill-backs and scans. After the event, the retailer bills or deducts for performance and scan allowances, sometimes on an 812 credit/debit adjustment.
5. Payment. The 820 remittance shows what was deducted against which promotion. Scan allowances are often reconciled against 852 product activity data.

If the dates, rates or items differ anywhere in that chain, the deduction lands on whichever side has the weaker record.

EDI 889 vs 888, 832 and 879

Common 889 Errors and How to Prevent Them

These problems usually surface as retail chargebacks and deductions after the event. The EDI inspector shows every G46, G94, G95 and G45 element by name, so you can check that options, rates and items tie out before the 889 goes out.

889 Implementation Checklist

• Confirm the retailer takes deals on the 889, and not through a portal or a deal sheet
• Get its guide: the date qualifiers it requires, allowance codes, handling methods and condition codes
• Confirm whether it sends 889s back with status 07 to accept, and how you should process them
• Use one promotion number per deal from your trade promotion system, and keep it for every change
• Check each promoted item is set up at the retailer
• Test a new promotion, a date change, a replacement and a cancellation
• Reconcile invoices, deductions and remittances against the promotion number after each event

For the wider picture, see our grocery EDI requirements guide and the EDI document types reference.

Getting Promotional Orders Right With OrderSync

Promotions bring order spikes, and many of those orders do not arrive as clean EDI. Wholesalers email spreadsheets, independents send PDFs, and DSD accounts phone in extra cases for the display.

OrderSync reads orders in any format, including EDI 875s and 850s, emails, PDFs and spreadsheets, matches each line to your items and units, and outputs valid X12 or clean data to your ERP, so the promotional volume is entered once and correctly. Paste any 889 into the free EDI inspector to see it parsed with a plain-English summary, read about EDI for food distributors, or book a 15-minute walkthrough to see your own orders processed.

Frequently Asked Questions