ediverse Explorer la plateforme

À la une PEPPOL BIS Billing 3.0 L’obligation européenne d’e-invoicing arrive : France sept 2026, Belgique janv 2026, Allemagne 2025.

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 :

x12 example-889.x12
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

  • HeaderST, BAU.
  • Mfr / RetailerN1*MF, N1*BY.
  • Type promoREF*ZZ.
  • PériodeDTM*090 / DTM*036.
  • Items / off-invoice — boucle LX : LIN*UP, AMT*PI (Promotion incentive value).
  • SummarySE.

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.