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 838 — Trading Partner Profile

The 838 transmits the complete profile of a trading partner: identifiers, EDI capabilities, certifications (8(a), SDB, woman-owned), contact points, banking info.

Purpose

The 838 documents the formal registration of a trading partner in a system — SAM.gov (System for Award Management) for federal, supplier master for private. It carries DUNS / UEI, NAICS codes, small business certifications, EDI capabilities, banking for ACH.

It is the reference registration required before a contract can be awarded. Acknowledged by 997. Updates are frequent (banking change, new certification, contact).

Envelope structure

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

x12 example-838.x12 
ISA*00*          *00*          *ZZ*CONTRACTOR    *ZZ*SAMREGISTRY   *260515*1100*U*00401*000000838*0*P*>~
GS*TP*CONTRACTOR*SAMREGISTRY*20260515*1100*1*X*004010~
ST*838*0001~
BGN*00*TPP-2026-ACME*20260515~
N1*SE*ACME CONSTRUCTION*24*EIN-ACME*1*UEI-ACME12345678~
N3*123 BUSINESS WAY~
N4*HOUSTON*TX*77001~
REF*ZZ*NAICS-237310~
REF*ZZ*CERT-SDB-VERIFIED~
PER*IC*MARK ROBERTS*EM*mroberts@acme.com~
REF*ZZ*EDI-AS2-ENABLED~
SE*10*0001~
GE*1*1~
IEA*1*000000838~

Common segments

  • Header — ST, BGN.
  • Partner — N1*SE (with UEI / DUNS), N3/N4.
  • Classification — REF*ZZ (NAICS), REF*ZZ (certifications — SDB, WOSB, HUBZone).
  • Contact — PER (Contact Information).
  • EDI capabilities — REF*ZZ (AS2, OFTP, web portal).
  • Summary — SE.

Common pitfalls

  • DUNS retirement: DUNS was replaced by UEI (Unique Entity Identifier) in April 2022; a current 838 must carry UEI, DUNS alone is obsolete.
  • Certification expiry: 8(a), WOSB, HUBZone are time-limited; an 838 with an expired certification disqualifies the partner from the corresponding set-asides.
  • Banking change: a banking change must trigger an 838 update and Treasury OFAC re-validation — not a silent update.

Documentation

The code 838 and the name Trading Partner Profile 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.