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 888 — Item Maintenance

The 888 transmits item master data changes — UPC, description, pack, weight, attributes — from a manufacturer to retailers.

Purpose

The 888 documents item master maintenance: new item add, attribute change (description, allergen flag, country of origin, ingredient list), pack change, retirement. It is the update channel for product fundamentals.

It feeds retailer item masters, GDSN (Global Data Synchronization Network) gateways, and e-commerce platforms. Acknowledged by 997.

Envelope structure

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

x12 example-888.x12 
ISA*00*          *00*          *ZZ*MFR           *ZZ*RETAILER      *260515*1230*U*00401*000000888*0*P*>~
GS*IM*MFR*RETAILER*20260515*1230*1*X*004010~
ST*888*0001~
BIN*00*IM*IM-2026-9900*20260515~
N1*MF*ACME FOODS INC*92*MFR-001~
LX*1~
LIN*1*UP*012345678905~
PID*F****ACME ORGANIC GRANOLA 12OZ~
G39*1*CASE*12~
MEA*PD*WT*12*OZ~
SE*10*0001~
GE*1*1~
IEA*1*000000888~

Common segments

  • Header — ST, BIN (Beginning Segment for Item Maintenance).
  • Manufacturer — N1*MF.
  • Item — LX loop: LIN*UP, PID*F (Description), G39 (Pack), MEA*PD*WT (Weight).
  • Summary — SE.

Common pitfalls

  • GTIN versioning: changing an attribute on a UPC without changing the UPC violates GS1 rules; some changes (size, formulation) mandate a new UPC.
  • Allergen flag: a 888 must always carry the 9 FDA major allergens (milk, eggs, fish, shellfish, tree nuts, peanuts, wheat, soybeans, sesame); an omission is a FALCPA violation.
  • Country of origin: a COO change can trigger tariff classification differences; omitting it causes customs compliance issues.

Documentation

The code 888 and the name Item Maintenance 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.