ediverse

Type to search across standards, messages, tools and glossary.

ediverse Explore the platform

Spotlight PEPPOL BIS Billing 3.0 The EU e-invoicing mandate is here — France Sept 2026, Belgium Jan 2026, Germany 2025.

— 01

Foundations

— 02

Standards

— 03

Flagship messages

— 04

Tools

X12 887 — Coupon Notification

The 887 notifies the issuance or circulation of a coupon — distribution channel, vehicle, audience — from a manufacturer or clearinghouse to downstream actors.

Purpose

The 887 documents the operational issuance of a coupon: channel (FSI free standing insert, in-store, digital, direct mail), vehicle (Sunday newspaper, supermarket flyer, retailer app), audience size, distribution date. It follows a 877 (promotion announcement) with distribution details.

It feeds redemption rate forecasting and coupon budget forecasting. Acknowledged by 997.

Envelope structure

The 887 travels within the three X12 envelope levels (ISA/IEA, GS/GE with functional group CO, and ST/SE). Didactic example in release 004010:

x12 example-887.x12 
ISA*00*          *00*          *ZZ*MFR           *ZZ*CLEARINGHOUSE *260515*1200*U*00401*000000887*0*P*>~
GS*CO*MFR*CLEARINGHOUSE*20260515*1200*1*X*004010~
ST*887*0001~
BNR*00*CO*CN-2026-4400*20260515~
N1*MF*ACME FOODS INC*92*MFR-001~
REF*ZZ*CPN-2026-4400~
REF*ZZ*CHANNEL-FSI~
REF*ZZ*VEHICLE-SUNDAY-INSERT~
DTM*090*20260601~
QTY*36*7500000~
SE*9*0001~
GE*1*1~
IEA*1*000000887~

Common segments

  • Header — ST, BNR (Beginning Segment for Notification).
  • Manufacturer — N1*MF.
  • Coupon reference — REF*ZZ (CPN number).
  • Channel / vehicle — repeated REF*ZZ.
  • Date / distribution — DTM*090 (drop date), QTY*36 (Audience size).
  • Summary — SE.

Common pitfalls

  • Channel cannibalization: a coupon distributed simultaneously FSI + digital on the same audience doubles redemptions without incremental gain — a 887 must split audiences.
  • Digital fingerprinting: a digital coupon has a unique fingerprint per redemption; a digital 887 must carry it in REF, otherwise fraud multiplies.
  • Drop date vs effective: the drop date (distribution) is not the effective date (validity start); a 887 must clarify both.

Documentation

The code 887 and the name Coupon Notification are public and listed on x12.org/products/transaction-sets. The complete structure of loops, qualifiers and code lists is distributed by DISA via the proprietary Implementation Guides (TR3). ediverse.io covers only public concepts, the envelope and didactic examples.