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 877 — Manufacturer Coupon Promotion Announcement

The 877 announces the parameters of a manufacturer coupon promotion — UPC, value, validity window, restrictions — from a manufacturer to retailers and coupon clearinghouses.

Purpose

The 877 documents an upcoming coupon promotion: coupon number, face value, eligible product UPCs, validity period (offer expire date), geographic restrictions, household limits, doubling rules. It is the upstream announcement before physical or digital coupon issuance.

It feeds retailer pricing systems and coupon clearinghouses (Inmar, NCH). Acknowledged by 997. Followed by the 881 (Manufacturer Coupon Redemption Detail) after redemption.

Envelope structure

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

x12 example-877.x12 
ISA*00*          *00*          *ZZ*MFR           *ZZ*RETAILER      *260515*0900*U*00401*000000877*0*P*>~
GS*CN*MFR*RETAILER*20260515*0900*1*X*004010~
ST*877*0001~
BCP*00*CPN-2026-4400*20260515~
N1*MF*ACME FOODS INC*92*MFR-001~
DTM*090*20260601~
DTM*036*20260930~
LX*1~
LIN*1*UP*012345678905~
AMT*FV*1.50~
PCT*MX*1~
SE*10*0001~
GE*1*1~
IEA*1*000000877~

Common segments

  • Header — ST, BCP (Beginning Segment for Coupon Promotion).
  • Manufacturer — N1*MF.
  • Dates — DTM*090 (effective), DTM*036 (expire).
  • Eligible product — LX loop: LIN*UP (UPC), AMT*FV (face value), PCT*MX (household limit).
  • Summary — SE.

Common pitfalls

  • Family code vs UPC: a coupon may be product-specific (UPC) or family-wide (manufacturer family code) — confusing both leads to wrong retailer scope.
  • Doubling rules: some retailers double coupons; an 877 must explicitly declare "no doubling" if the manufacturer wants it, otherwise the retailer applies its policy.
  • Stacking vs digital: a paper coupon cannot be stacked with a digital one on the same UPC in most chains — an 877 must specify the stacking policy.

Documentation

The code 877 and the name Manufacturer Coupon Promotion Announcement 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.