Naar hoofdinhoud

EDI 832: de X12-prijscatalogus uitgelegd, segment voor segment

Wat een EDI 832-prijscatalogus bevat, een uitgewerkt voorbeeld per segment, de mappingfouten die tot afwijzing leiden en de vergelijking met BMEcat en GDSN.

Diego Nijboer

EDI 832: de X12-prijscatalogus uitgelegd, segment voor segment

De EDI 832 is de X12-transactieset voor een Price/Sales Catalog, een prijs- en verkoopcatalogus. Een leverancier stuurt daarmee artikelcodes, korte omschrijvingen, prijzen, verpakkingsgegevens en levertijden naar een afnemer, in vaste segmenten die het ERP van de afnemer zonder overtypen inleest. X12 omschrijft de set als een manier om prijzen van goederen of diensten te leveren of op te vragen in de vorm van een catalogus.

De meeste 832's gaan tussen Noord-Amerikaanse fabrikanten, distributeurs, resellers en retailers. In Europa loopt hetzelfde werk meestal via BMEcat-bestanden, GS1-datapools of EDIFACT, waar het PRICAT-bericht het dichtst in de buurt komt. Werk je als Nederlandse leverancier met een Amerikaanse distributeur, dan krijg je met de 832 te maken. Dit artikel loopt de segmenten door, geeft een uitgewerkt voorbeeld en de mappingfouten waardoor catalogi worden afgewezen, en vergelijkt de 832 met BMEcat en GDSN.

Wat een EDI 832-prijscatalogus meestuurt en wat niet

De 832 draait om artikelen en prijzen. In versie 004010 is elk artikel één LIN-lus met datums, omschrijvingen, maten, verpakking, fysieke gegevens, levertijden, belastingen, gegevens over gevaarlijke stoffen en een geneste CTP-lus voor prijzen, die per artikel tot 100 keer mag voorkomen (X12-referentie van Stedi). Een kopgedeelte voor de artikelen bevat het catalogusnummer, de valuta, de partijen en de voorwaarden voor de hele set.

Rijke content is niet zijn sterkste kant. Het element voor vrije omschrijving in een PID-segment bevat maximaal 80 tekens, dus een langere tekst verdeel je over meerdere PID-segmenten; de leveranciersgids van CDW zegt precies dat (CDW 832-gids). Gidsen zoals die van CDW vragen om codes, omschrijvingen, verpakkingsgegevens, prijzen en levertijden, en niet om afbeeldingen of technische kenmerken. Die komen meestal op een andere manier bij de afnemer, bijvoorbeeld via een upload op de leverancierssite van de afnemer of een apart contentbestand.

X12 kent ook verwante sets die je naast de 832 tegenkomt: de 846 Inventory Inquiry/Advice voor voorraad, de 850 Purchase Order, de 856 Ship Notice/Manifest, de 879 Price Information en de 888 Item Maintenance. Sommige handelspartners gebruiken de 888 of 879 voor het aanmaken van artikelen en prijswijzigingen in plaats van een 832. Lees dus eerst de gids van je partner voordat je iets bouwt.

De 832-segmenten die in de gids van je handelspartner staan

Elke handelspartner publiceert een implementatiegids die segmenten en codes uit de standaard kiest. De tabel toont de segmenten die je in gidsen voor 004010 het vaakst ziet, met een fragment zoals het in een bestand staat.

Veelgebruikte EDI 832-segmenten in versie 004010

STTransaction Set HeaderKopSet-ID 832 en een controlenummerST*832*0001
BCTBeginning Segment for Price/Sales CatalogKopDoel van de catalogus (PC prijscatalogus, SC verkoopcatalogus), catalogusnummer en versie, en het doel van de set (00 origineel, 04 wijziging)BCT*PC*FAST2026*4
CURCurrencyKopValuta van de prijzen, voor de verkopende partijCUR*SE*USD
N1NameKopPartijen, zoals de leverancier (VN)N1*VN*Example Fixings Inc
LINItem IdentificationDetailTot 15 paren van kwalificatie en code per artikel: VP leveranciersartikelnummer, MG fabrikantartikelnummer, UP UPC, EN EAN, UK GTIN-14LIN*1*VP*CT-4830-BK
G53Maintenance TypeDetailWat er met het artikel gebeurt: 001 wijziging, 002 verwijderen, 003 volledig artikel toevoegenG53*003
DTMDate/Time ReferenceDetailDatums zoals 007 ingangsdatumDTM*007*20261201
PIDProduct/Item DescriptionDetailF voor vrije tekst, maximaal 80 tekens per segment, herhaalbaarPID*F****Cable tie...
MEAMeasurementsDetailLosse maten zoals lengte (LN), breedte (WD), hoogte (HT), gewicht (WT)MEA*PD*LN*300*MM
PO4Item Physical DetailsDetailVerpakking en inhoud, brutogewicht per verpakking, afmetingen met eenhedenPO4*20*100*EA
LDTLead TimeDetailCode voor levertijd, aantal en tijdseenheidLDT*AE*10*DA
CTPPricing InformationDetail (CTP-lus)Prijssoort (WHL groothandel, MSR adviesprijs, CON contract), stukprijs, aantal en eenheidCTP**WHL*12.40*1*BG
CTTTransaction TotalsAfsluitingAantal artikelregels (LIN-segmenten)CTT*1
SETransaction Set TrailerAfsluitingAantal segmenten inclusief ST en SE, en hetzelfde controlenummer als STSE*14*0001
14 van 14 rijen
Filter op de kolom Deel: kopsegmenten gelden voor de hele catalogus, detailsegmenten herhalen per artikel.

Codes tellen net zo zwaar als segmenten. Dezelfde EAN van 13 cijfers onder de kwalificatie UP, die een U.P.C. van 12 cijfers verwacht, faalt bij de afnemer. En een prijs onder CTP02 RES (wederverkoop) in plaats van WHL (groothandel) kan in de verkeerde prijslijst belanden. De gids van je partner noemt de kwalificaties die hij accepteert.

Eén kabelbinder in een 832, regel voor regel uitgelegd

Het voorbeeld hieronder is fictief: een verzonnen leverancier stuurt één artikel in een 832 versie 004010, met "*" als scheidingsteken tussen elementen en "~" als segmentafsluiter. De EAN is het demonstratienummer van GS1. De ISA- en GS-envelop rond de set laten we weg; de functionele groepscode voor een 832 is SC.

Een 832 voor één kabelbinder, regel voor regel

ST*832*0001~Begin van een 832 met controlenummer 0001.
BCT*PC*FAST2026*4~Een prijscatalogus (PC), catalogusnummer FAST2026, versie 4.
CUR*SE*USD~Prijzen in Amerikaanse dollars, de valuta van de verkoper.
N1*VN*Example Fixings Inc~De leverancier die de catalogus stuurt.
LIN*1*VP*CT-4830-BK*MG*CT4830B*EN*9506000134352~Regel 1: leveranciersartikelnummer, fabrikantartikelnummer en de EAN van het zakje van 100.
DTM*007*20261201~De prijzen gaan in op 1 december 2026 (CCYYMMDD).
PID*F****Cable tie 4.8 x 300 mm black UV-resistant~Vrije omschrijving in element PID05, maximaal 80 tekens.
PID*F****Polyamide 6.6, bag of 100~Een tweede PID zet de omschrijving voort.
PO4*20*100*EA**G*11.5*LB~20 binnenverpakkingen (zakjes) van 100 stuks per doos; brutogewicht 11,5 lb per doos.
LDT*AE*10*DA~Verzending 10 kalenderdagen na ontvangst van de inkooporder.
CTP**WHL*12.40*1*BG~Groothandelsprijs USD 12,40 per zakje.
CTP**MSR*19.95*1*BG~Adviesverkoopprijs USD 19,95 per zakje.
CTT*1~Eén artikelregel (één LIN) in deze set.
SE*14*0001~14 segmenten van ST tot en met SE, afgesloten met controlenummer 0001.
14 van 14 rijen
Fictieve volledige catalogus: de prijs geldt per zakje (BG), de verpakkingsgegevens beschrijven de doos en het SE-aantal telt ST en SE zelf mee.

Drie details dragen de betekenis. De LIN-regel identificeert het artikel op drie manieren, en de afnemer matcht op de kwalificatie die hij zelf opslaat. De CTP-regels noemen hun eigen eenheid (BG, zakje), zodat een prijs per zakje nooit met een doosprijs wordt verward. En het SE-aantal van 14 telt elk segment van ST tot en met SE; Flxpoint, een platform dat 832's ontvangt, controleert ook of CTT01 gelijk is aan het aantal LIN-segmenten (Flxpoint 832-notities).

Volledige catalogus of wijzigingsbestand: zo lopen 832-updates

Partners verwerken wijzigingen op twee manieren, en de implementatiegids zegt welke. BCT10 markeert de set als 00 origineel of 04 wijziging. De gids van CDW vraagt om DTM-kwalificatie 007 (ingangsdatum) bij een volledige catalogus en 128 (vervangende ingangsdatum) bij een delta (CDW 832-gids).

Per artikel geeft het G53-segment het soort onderhoud aan. De codelijst van 004010 bevat onder meer 001 wijziging, 002 verwijderen, 003 volledig artikel toevoegen, 004 artikel tijdelijk terugtrekken en 005 artikel herstellen. Spreek met je partner af wat een ontbrekend artikel in een volledige catalogus betekent: sommige afnemers lezen het als uit assortiment, andere negeren het tot er een verwijdering binnenkomt.

Gebruikt een set beide, dan gaat de G53-code van een artikel voor BCT10 (X12-referentie van Stedi). Zo kan één wijzigingsset sommige artikelen toevoegen, andere wijzigen en een paar verwijderen.

Prijswijzigingen met ingangs- en einddatum

Het DTM-segment kan op artikelniveau staan, zoals in het voorbeeld hierboven, of binnen de CTP-lus, waar elke prijs zijn eigen datums krijgt: kwalificatie 007 voor de datum waarop de prijs ingaat en 036 voor de datum waarop hij vervalt. Bij een prijsverhoging stuur je de nieuwe prijs met een 007-datum in de toekomst, terwijl de huidige prijs tot dan geldig blijft. De afnemer leest hem vooraf in en schakelt op de datum om, in plaats van een prijs te krijgen die al geldt.

Hoeveel tijd de partner vooraf nodig heeft, en of hij een ingangsdatum in het verleden accepteert, staat in zijn gids of in je leveranciersovereenkomst, niet in de standaard. Vraag het voor de eerste verhoging, niet tijdens.

Staffelprijzen in de CTP-lus

CTP04 en CTP05 bevatten een aantal en de eenheid daarvan, en het voorbeeld van X12 zelf gebruikt ze als begin van een prijsstaffel. Een staffelprijs bestaat dan uit meerdere CTP-segmenten met dezelfde prijssoort en oplopende aantallen, bijvoorbeeld 1, 10 en 50 zakjes. Sommige partners lezen CTP04 juist als het aantal waarvoor de prijs geldt. Check dus in de gids welke lezing geldt voordat je een tweede prijsregel stuurt.

Verwijderen, tijdelijk terugtrekken en herstellen

G53-code 002 haalt een artikel uit de catalogus van de afnemer. Bij een tijdelijk leveringsprobleem trek je het artikel met 004 terug en herstel je het later met 005; zo blijven de historie en contractprijzen van dat artikel bij de afnemer bewaard. Gebruik een verwijderd leveranciersartikelnummer nooit opnieuw: een nummer dat verdwijnt en later op een ander artikel terugkomt, is een van de lastigste fouten om terug te vinden in het ERP van een afnemer.

EDI 832 naast BMEcat en GDSN

Alle drie brengen product- en prijsdata van leverancier naar afnemer, maar ze dienen een ander doel. BMEcat is een XML-catalogusformaat dat BME beheert; de huidige versie is 2005.2, en BMEcat 2005 kan meerdere talen in één bestand en logistieke gegevens per product meesturen (BME). GDSN is het netwerk van gecertificeerde datapools van GS1: data wordt geladen, geregistreerd, geabonneerd, gepubliceerd en bevestigd (GS1).

EDI 832, BMEcat 2005 en GDSN naast elkaar

Beheerd doorX12BME, de Duitse vereniging voor inkoop en logistiekGS1
FormaatSegmenten met scheidingstekens, van ST tot SEEén XML-catalogusbestandXML-berichten tussen gecertificeerde datapools
Waar je het tegenkomtNoord-Amerikaanse distributeurs, resellers en retailersDuitstalige en Nederlandse B2B-handel, technische groothandel, inkoopcatalogiRetail in consumentengoederen, food en zorg
Hoe het reistRechtstreeks tussen twee handelspartnersBestand naar een klant, datapool of inkoopsysteemDe datapool van de leverancier registreert artikelen in de GS1 Global Registry; de datapool van de afnemer abonneert zich
ProductcontentCodes, korte tekst, verpakking, prijzen, levertijdenMeertalige teksten in één bestand, ETIM- of ECLASS-kenmerken, afbeeldingen en documenten, prijzen, logistieke dataAttributen uit het GS1 Global Data Model, gekoppeld aan de GTIN
WijzigingenOrigineel of wijziging (BCT10), onderhoudscodes per artikel (G53)Transacties T_NEW_CATALOG (volledige catalogus), T_UPDATE_PRODUCTS (elk product gemarkeerd als new, update of delete) en T_UPDATE_PRICESPubliceren, abonneren en bevestigen
6 van 6 rijen
De 832 is een prijs- en codebericht tussen twee partners; BMEcat bevat volledige cataloguscontent; GDSN synchroniseert stamgegevens op basis van de GTIN via datapools.

Een fabrikant die in Noord-Amerika en Europa verkoopt, bedient vaak alle drie vanuit één productrecord: een 832 naar een Amerikaanse distributeur, een BMEcat-bestand naar een Duitse of Nederlandse groothandel en GDSN voor retail. Onze artikelen over BMEcat-bestanden en GDSN en GS1 Data Source behandelen die twee routes in detail, en het artikel over de punchout-catalogus behandelt de route via inkoopsystemen, waarbij afnemers in je webshop bestellen in plaats van een bestand in te lezen.

Zeven mappingfouten waardoor een 832 wordt afgewezen

Syntaxfouten zijn zeldzaam zodra een EDI-vertaler is ingericht. Afwijzingen komen meestal uit de mapping, waar productdata de regels van de partner raakt:

  1. EAN onder de UPC-kwalificatie. UP verwacht een U.P.C. van 12 cijfers; een EAN van 13 cijfers hoort onder EN, een doos-GTIN-14 onder UK. De gids over GTIN, UPC en EAN legt de verschillen uit.
  2. Prijseenheid en verpakkingseenheid lopen niet gelijk. Een doosprijs met eenheid EA wordt gelezen als prijs per stuk. Houd elke CTP-eenheid in lijn met je omrekeningen van meeteenheden.
  3. Opgemaakte prijzen. Flxpoint eist dat CTP03 een positief decimaal getal is, zonder valutateken en zonder komma's (Flxpoint 832-notities).
  4. Omschrijvingen langer dan 80 tekens. Tekst boven de limiet van PID05 wordt afgekapt of afgewezen; verdeel hem over meerdere PID-segmenten voor zover de gids van je partner dat toestaat.
  5. Verplichte prijssoorten ontbreken. CDW maakt zowel de eigen prijs (C01) als de adviesverkoopprijs van de fabrikant (MSR) verplicht; een bestand met maar één van de twee faalt.
  6. Codes die per document verschillen. Het leveranciersartikelnummer in de 832 moet gelijk zijn aan dat in je 846- en 856-berichten met die partner, anders vinden orders en voorraadupdates het artikel niet.
  7. Verkeerde controletotalen. SE01 telt elk segment inclusief ST en SE, en CTT01 telt de LIN-segmenten. Een met de hand aangepast bestand met een extra PID zonder bijgewerkte SE faalt.

Een nieuwe 832-handelspartner aansluiten, stap voor stap

Een 832 inrichten met een nieuwe klant is een klein project, en de meeste tijd gaat naar data, niet naar EDI-software. Een gebruikelijke volgorde:

  1. Vraag de implementatiegids op. Die noemt de X12-versie, de segmenten en kwalificaties die de partner leest, de verplichte prijssoorten en of hij volledige catalogi of wijzigingen wil.
  2. Spreek de codes af. Bepaal welk nummer onder VP komt, of de partner ook MG en een UPC of EAN nodig heeft, en houd die nummers gelijk in elk ander document dat je met die partner uitwisselt.
  3. Map je productdata. Zet elk segment en element naast een veld in je ERP- of PIM-export: eenheden, verpakkingsaantallen, gewichten, prijssoorten, levertijden. Noteer elk veld dat je nog niet hebt.
  4. Vul de gaten. Ontbrekende UPC's, gewichten of korte omschrijvingen zijn productdatawerk, en dat duurt langer dan de mapping zelf.
  5. Stuur testbestanden. De vertaler van de partner beantwoordt elke set met een 997 Functional Acknowledgment, die meldt of het bestand syntactisch is geaccepteerd. Inhoudelijke fouten, zoals een onbekende prijssoort, komen meestal per e-mail of via het portaal van de partner terug.
  6. Ga live met een volledige catalogus. Begin met het complete assortiment en stap over op wijzigingsbestanden als de partner die accepteert.

Bewaar de testbestanden. Past de partner later zijn gids aan, of voeg je een productlijn met een nieuw soort verpakking toe, dan vergelijk je de nieuwe output met een bestand dat ooit is geaccepteerd.

Waar een afwijzing zichtbaar wordt, is net zo belangrijk als de oorzaak. De 997 meldt alleen of de set syntactisch is geaccepteerd. Sommige partners sturen ook een 824 Application Advice, die meldt of de inhoud door de controles van hun systeem kwam: geaccepteerd, afgewezen of met wijzigingen geaccepteerd. Vraag welke van de twee je partner stuurt en wie ze bij jullie leest. Een 824 waar niemand naar kijkt, betekent een prijswijziging die nooit live ging.

Productdata klaarmaken voor een 832 als je PIM geen EDI doet

WISEPIM verstuurt en ontvangt geen EDI: het maakt geen 832, geen PRICAT en geen ander EDI-bericht. Wat een PIM wel kan, is de data achter het bericht op orde houden voordat een EDI-vertaler of dienstverlener die in de layout van de partner zet. WISEPIM controleert GTIN-controlecijfers bij het opslaan, bewaart fabrikantartikelnummers, gewichten en afmetingen met expliciete eenheden, en exporteert naar CSV of Excel of via Feed Hub als eigen XML of als BMEcat 2005 (ETIM)-bestand.

Quality Guard-regels blokkeren of markeren producten voor de export, bijvoorbeeld een product zonder geldige EAN of GTIN.

Met Quality Guard-regels houd je de fouten uit de lijst hierboven tegen voordat ze bij de vertaler komen: een product zonder geldige GTIN, een omschrijving die te lang is voor de limiet van je partner, een ontbrekend gewicht. Welke data de artikelstam in je ERP schrijft en wat de PIM toevoegt, lees je in ons artikel over artikelstamgegevens.

Diego Nijboer

CTO and Co-Founder at WISEPIM, building AI-powered solutions that transform product data management for e-commerce businesses. Over 10 years of experience solving complex technical challenges in e-commerce and PIM systems.

Veelgestelde vragen

Nog vragen?

Kan je het antwoord niet vinden? Neem contact op met ons team.

Contact opnemen

Meestal de leverancier. Een fabrikant of distributeur stuurt zijn catalogus en prijzen naar een klant, die ze in zijn ERP of inkoopsysteem inleest. De X12-definitie omvat ook het opvragen van prijzen in catalogusvorm, dus soms stuurt een afnemer een 832 als verzoek. Catalogi van leverancier naar afnemer zijn verreweg het gewoonst.

De 832 Price/Sales Catalog bevat artikelcodes, omschrijvingen, verpakkingsgegevens en prijzen, en verandert als je assortiment of prijzen veranderen. De 846 Inventory Inquiry/Advice meldt voorraadniveaus en verandert dagelijks of vaker. Beide verwijzen naar dezelfde artikelen, dus de codes erin moeten gelijk zijn.

Het UN/EDIFACT-bericht PRICAT, een price/sales catalogue-bericht voor prijs- en catalogusgegevens van verkoper naar koper. Europese retailers en groothandels die met EDIFACT werken, vragen om PRICAT waar een Noord-Amerikaanse partner om een 832 vraagt. Opbouw en codelijsten verschillen, dus elk heeft een eigen mapping nodig.

De versie die in de implementatiegids van je handelspartner staat. Veel gidsen noemen nog 004010, waaronder die van CDW, terwijl X12 nieuwere releases blijft uitbrengen. Je EDI-vertaler kan meerdere versies uit dezelfde data maken, maar segmenten, kwalificaties en verplichte prijssoorten komen altijd uit de gids van je partner.

Partnergidsen vragen er zelden om. De 832 is gemaakt voor codes, korte omschrijvingen, verpakkingsgegevens, prijzen en levertijden, en omschrijvingen zijn beperkt tot 80 tekens per PID-segment. Afnemers verzamelen afbeeldingen, documenten en technische kenmerken meestal anders, bijvoorbeeld via een portaalupload, een contentbestand of een BMEcat-catalogus.

Verder ontdekken

Zorgvuldig gekozen vervolgstappen om dieper te gaan.

Betere productdata, betere resultaten.Verkoop meer producten.

4,7