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 891 — Deduction Research Report

The 891 documents the research and resolution of a deduction taken by a buyer on a supplier invoice: reason, amount, resolution status.

Purpose

The 891 is used in consumer packaged goods (CPG) and grocery retail where retailers (Walmart, Kroger, Target) frequently take deductions on supplier payments for various reasons: promotional allowance, shortage, damage, slotting fee, scan back, MCB (Manufacturer Chargeback).

It carries the original deduction, the supplier research (validated, disputed, partial), supporting documentation, and final status. Acknowledged by 997; valid disputed deductions return as credit memo or adjustment on the next 820 (Payment).

Envelope structure

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

x12 example-891.x12 
ISA*00*          *00*          *ZZ*SUPPLIER      *ZZ*WALMART        *260514*0900*U*00401*000000891*0*P*>~
GS*DR*SUPPLIER*WALMART*20260514*0900*1*X*004010~
ST*891*0001~
BGN*00*DR-2026-0042*20260514~
N1*SU*ACME FOODS*24*EIN-SUPPLIER~
N1*BY*WALMART INC*24*EIN-WALMART~
REF*ZZ*DEDUCTION-NUMBER-2026-DED-0099~
AMT*ZZ*15250.00~
LX*1~
REF*ZZ*REASON-CODE-91-SHORTAGE~
AMT*ZZ*5250.00~
MSG*DISPUTED - PROOF OF DELIVERY ATTACHED~
SE*10*0001~
GE*1*1~
IEA*1*000000891~

Common segments

  • Header — ST, BGN.
  • Parties — N1*SU (Supplier), N1*BY (Buyer retailer).
  • Deduction — REF*ZZ (deduction number), AMT*ZZ (total amount).
  • Research — LX loop: REF*ZZ (reason code, e.g., RA Reason Code 91 = Shortage), AMT*ZZ (per-line amount), MSG (status — VALIDATED, DISPUTED, PARTIAL).
  • Summary — SE.

Common pitfalls

  • Retailer-specific reason code: each retailer has its own code list (Walmart RA Codes, Kroger D-Codes, Target Vendor Codes); an 891 with a home-grown code cannot be auto-processed.
  • Dispute window: the dispute window is typically 12 to 18 months per contract — past that the deduction is forfeited and the supplier loses recovery rights.
  • Required documentation: a DISPUTED 891 without documentation (POD, BOL, photos) is typically rejected on second pass; always reference attachments via REF*ZZ.

Documentation

The code 891 and the name Deduction Research Report 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.