X12 889 — Promotion Announcement
Le 889 annonce une promotion retailer — TPR, BOGO, off-invoice allowance, display program — d'un manufacturer vers ses retailers, pour planification trade.
Objet
Le 889 documente une promotion trade : type (TPR temporary price reduction, BOGO buy-one-get-one, off-invoice allowance, display incentive), montant, période de performance, items concernés, conditions (display compliance, minimum order). Il sert au trade promotion management (TPM).
Il est le déclencheur d'un cycle de planning, exécution et settlement trade. Acquitté par 997. Suivi typiquement par 855 / 810 sur les commandes promo.
Structure d'enveloppe
Le 889 voyage à l'intérieur des trois niveaux d'enveloppe X12 (ISA/IEA,
GS/GE avec functional group PA, et ST/SE).
Exemple didactique en 004010 :
ISA*00* *00* *ZZ*MFR *ZZ*RETAILER *260515*1300*U*00401*000000889*0*P*>~
GS*PA*MFR*RETAILER*20260515*1300*1*X*004010~
ST*889*0001~
BAU*00*PA*PROMO-2026-5500*20260515~
N1*MF*ACME FOODS INC*92*MFR-001~
N1*BY*ACME RETAIL CO*92*0001~
REF*ZZ*PROMO-TYPE-TPR~
DTM*090*20260601~
DTM*036*20260628~
LX*1~
LIN*1*UP*012345678905~
AMT*PI*0.50~
SE*11*0001~
GE*1*1~
IEA*1*000000889~ Segments courants
- Header —
ST,BAU. - Mfr / Retailer —
N1*MF,N1*BY. - Type promo —
REF*ZZ. - Période —
DTM*090/DTM*036. - Items / off-invoice — boucle
LX:LIN*UP,AMT*PI(Promotion incentive value). - Summary —
SE.
Pièges courants
- Trade compliance proofs : un off-invoice allowance demande des display compliance proofs (photos) ; le 889 doit conditionner explicit.
- Lift forecasting : un 889 sans expected lift / volume ne permet pas au manufacturer de provisionner les stocks promo — l'inclure en
QTY. - Stack avec coupons : un 889 TPR + un 877 coupon sur le même item dans la même fenêtre n'est pas combinable par défaut ; le 889 doit déclarer la stacking policy.
Transactions liées
Documentation
Le code 889 et le nom Promotion Announcement sont publics et listés sur x12.org/products/transaction-sets. La structure complète des loops, qualifiers et code-lists est distribuée par DISA via les Implementation Guides (TR3) propriétaires. ediverse.io ne couvre que les concepts publics, l'enveloppe et des exemples didactiques.