Hva er Vinmonopolet EDI-validering?

Vinmonopolet EDI-validering er den automatiserte kontrollen som avgjør om en melding aksepteres i Vinmonopolets systemer. Meldingen prøves mot XML-schemaet, mot Vinmonopolets kodelister, mot referansene til tidligere meldinger, og mot forretningsreglene i grossistavtalen. Kun meldinger som består alle kontrollene behandles videre. Feiler én, stoppes transaksjonen til feilen er rettet.

Kilde og forbehold: Konkrete valideringsregler, schemaversjoner og kodelister følger av Vinmonopolets gjeldende implementeringsguide, som er den eneste autoritative kilden. Kravene endres over tid. Kontroller alltid mot gjeldende versjon før oppsett eller produksjonssetting.

Nøkkelpunkter:

• Vinmonopolet bruker EDI XML, så syntakskontrollen skjer mot et XML-schema (XSD), ikke mot EDIFACT-syntaks.
• Valideringen dekker fem lag: schema, obligatoriske felt, kodelister, referanser og forretningslogikk.
• Kodelistene er Vinmonopolets egne, og oppdateres uavhengig av GS1-standardene.
• Samme valideringslogikk brukes i test og produksjon, men ikke nødvendigvis samme masterdata.
• Avviste meldinger stopper hele kjeden: ordre, leveranse, faktura og betaling.
• Endres schemaversjonen, må oppsettet oppdateres og som regel testes på nytt.

Hva betyr Vinmonopolet EDI-validering?

Hvilke meldinger valideres?

Alle operative og rapporteringsrelaterte meldinger:

Melding	Rolle	Retning
ORDERS	Innkjøpsordre fra Vinmonopolet	Inn til leverandør
ORDRSP	Bekreftelse på hel eller delvis leveranse	Ut fra leverandør
DESADV	Pakkseddel med forsendelsesdetaljer	Ut fra leverandør
INVOIC	Faktura for leverte varer	Ut fra leverandør
Betalings- og remitteringsmeldinger	Informerer om gjennomført betaling og hvilke fakturaer den dekker	Inn til leverandør

I tillegg kan rapporterings- og etterlevelsesmeldinger være underlagt validering. Hver meldingstype kontrolleres mot sine egne regler i implementeringsguiden. Se Vinmonopolet EDI-krav for hva fakturameldingen konkret må inneholde.

Hvordan foregår EDI-valideringen?

Fem lag, i stigende rekkefølge fra det tekniske til det forretningsmessige:

Lag	Hva som kontrolleres	Typisk feil
1. Schema (XSD)	XML-struktur, elementrekkefølge, datatyper, feltformat	Element utenfor definert rekkefølge, feil datatype
2. Obligatoriske felt	Leverandøridentifikator, produktidentifikasjon, ordre- eller fakturanummer, datoer, mengde og enhet	Manglende referansenummer
3. Kodelister	GTIN eller varenummer, lokasjonskoder, enhetskoder, valuta, avgifts- og priskvalifikatorer	Kode som ikke finnes i gjeldende liste
4. Referanser	At ORDRSP viser til en eksisterende ORDERS, at DESADV viser til gyldig ordre, at INVOIC samsvarer med bekreftet leveranse	Faktura mot en leveranse som ikke er registrert
5. Logikk og tall	Bestilt mot bekreftet mengde, fakturert mot levert mengde, priser mot avtale, totalsummer mot linjebeløp, avgiftsberegning	Avrundingsavvik i totalen

Schemakontrollen er det som skiller Vinmonopolet fra EDIFACT-baserte kjeder. Fordi formatet er XML, valideres syntaksen mot et XSD-schema med definert elementrekkefølge og datatyper. Et felt som ligger på feil plass i strukturen avvises, selv om innholdet er riktig. Det gjør schemaversjonen til et kritisk punkt: bruker leverandøren en eldre versjon enn den Vinmonopolet kjører, feiler meldingene på lag 1, og feilmeldingen sier ingenting om innholdet.

Kodelistene er Vinmonopolets egne og oppdateres uavhengig av GS1-standardene. En GTIN kan være formelt gyldig og likevel ukjent i Vinmonopolets katalog.

Testmiljø og produksjonsmiljø

Integrasjonen må testes i Vinmonopolets testmiljø før produksjonssetting. Testfasen kontrollerer meldingsstruktur, implementering av valideringsreglene, referanseflyt mellom meldingene, og samspillet mellom ERP-systemet og EDI-integrasjonen.

Samme valideringslogikk kjøres normalt i begge miljøer, men ikke nødvendigvis samme masterdata. Et varenummer som finnes i test kan mangle i produksjon, og motsatt. Det er en vanlig årsak til avvisninger rett etter at leverandøren er aktivert for produksjonstrafikk, selv når testløpet gikk feilfritt.

Se EDI-testing for hvordan testløpet gjennomføres.

Hva skjer ved valideringsfeil?

Meldingen avvises eller flagges, en feilmelding genereres med feilkode som peker på elementet, og hendelsen loggføres for sporbarhet. Meldingen må rettes i kilden og sendes på nytt.

Så lenge en kritisk feil stopper prosessen:

• ordren behandles ikke videre
• forsendelsen kan ikke registreres
• fakturaen aksepteres ikke
• betalingen forsinkes

Det er den siste konsekvensen leverandøren merker først, og som regel flere uker etter at feilen faktisk oppsto.

Vanlige årsaker til valideringsfeil

• Manglende obligatoriske XML-elementer
• Ugyldige eller ukjente GTIN-koder
• Feil referanser mellom meldinger
• Avvik mellom ordre og faktura
• Feil datoformat
• Feil valutaformat
• Utdatert schemaversjon etter oppdatering hos Vinmonopolet

De fleste av disse stammer fra mappingen mellom ERP-systemet og EDI-formatet, ikke fra den enkelte transaksjonen. Skillet er verdt å kjenne: kommer samme feilkode på alle meldinger av en type, ligger årsaken i mappingen eller i masterdata. Sporadiske avvisninger peker på datakvaliteten i den enkelte ordren eller fakturaen.

Hvordan påvirker validering ordre- og fakturaflyten?

Valideringen er en integrert del av ordre-til-betaling-prosessen. Den sikrer korrekt behandling av ordrebekreftelser, riktig registrering av forsendelser, gyldig bokføring av faktura, korrekt betalingsavstemming og etterlevelse av regulatoriske krav.

Uten godkjent validering stopper flyten. Ordre kan ikke behandles, leveranser kan ikke matches mot ordre, fakturaer kan ikke godkjennes, og betalinger forsinkes. Valideringen beskytter dermed både systemintegriteten og den finansielle kontrollen på begge sider.

Hvordan bistår Kundan med Vinmonopolet EDI-validering?

Vi kan bistå med kartlegging, mapping, testing og drift av EDI-integrasjoner mot Vinmonopolet, basert på gjeldende krav og kundens systemoppsett:

• Mapping til Vinmonopolets EDI XML-format
• Oppsett av valideringsregler
• Oppdatering av kodelister
• Feilsøking ved avviste meldinger
• Overvåking av valideringsrapporter
• Tilpasning ved endringer i spesifikasjonene

Mest tid går normalt med til å tolke feilkoder og finne ut hvor i kjeden avviket faktisk oppsto. Det er sjelden der feilmeldingen peker.

Oppsummering

• Valideringen kontrollerer struktur, innhold, koder, referanser og forretningslogikk før behandling.
• Syntakskontrollen skjer mot XML-schema, ikke EDIFACT-syntaks, fordi Vinmonopolet bruker EDI XML.
• Schemaversjon og kodelister er de to punktene som oftest utløser feil etter en oppdatering.
• Test- og produksjonsmiljø deler valideringslogikk, men ikke nødvendigvis masterdata.
• Avviste meldinger stopper hele kjeden fram til betaling.
• Systematiske feil peker på mappingen, sporadiske på datakvaliteten.

Spørsmål og svar

Ofte stilte spørsmål

Her svarer vi på de vanligste spørsmålene vi får fra nye og eksisterende kunder.

Hva er Vinmonopolet EDI-validering?

Vinmonopolet EDI-validering er kontrollen som avgjør om en elektronisk melding aksepteres i Vinmonopolets systemer. Valideringen sikrer at meldingen følger XML-strukturen i gjeldende implementeringsguide, inneholder alle obligatoriske dataelementer, bruker gyldige koder, har konsistente referanser og oppfyller forretningsreglene. Feiler meldingen, avvises den og må korrigeres før den kan behandles videre.

Hvorfor blir EDI-meldinger avvist hos Vinmonopolet?

De vanligste årsakene er manglende obligatoriske XML-elementer, ugyldige eller ukjente GTIN-koder, feil referanser mellom meldinger, avvik mellom ordre og faktura, feil dato- eller valutaformat, og utdatert schemaversjon. De fleste av disse stammer fra mappingen mellom ERP-systemet og EDI-formatet framfor fra den enkelte transaksjonen, og gjentar seg derfor på hver melding til mappingen er rettet.

Hva er forskjellen på validering hos Vinmonopolet og hos dagligvarekjedene?

Formatet. Vinmonopolet bruker EDI XML, så syntakskontrollen skjer mot et XML-schema (XSD) med definert elementrekkefølge og datatyper. Dagligvarekjedene bruker i hovedsak EDIFACT, hvor syntakskontrollen gjelder segmentstruktur og skilletegn, og hvor kvitteringene kommer som CONTRL og APERAK. De øvrige valideringslagene ligner, men feilmeldingene ser helt ulike ut.

Hvilke EDI-meldinger valideres?

Alle operative meldinger i leverandørkommunikasjonen: ORDERS for innkjøpsordre, ORDRSP for ordrebekreftelse, DESADV for pakkseddel og INVOIC for faktura, samt eventuelle betalings- og remitteringsmeldinger. Hver meldingstype kontrolleres mot sine egne krav til struktur, obligatoriske dataelementer og referanser mellom transaksjoner. Rapporterings- og etterlevelsesmeldinger kan også være underlagt validering.

Hvordan kan vi unngå avviste meldinger?

Sikre korrekt mapping mellom ERP-systemet og Vinmonopolets format, hold kodelistene oppdatert, kontroller at referansene mellom meldingene henger sammen, og test grundig i testmiljøet før produksjonsstart. Verifiser i tillegg hvilken schemaversjon som gjelder, siden en oppdatering hos Vinmonopolet kan gjøre et fungerende oppsett ugyldig uten at noe er endret på leverandørsiden.

Vi bestod testingen, men meldingene avvises i produksjon. Hvorfor?

Fordi test- og produksjonsmiljøet deler valideringslogikk, men ikke nødvendigvis masterdata. Et varenummer, en lokasjonskode eller en avtalepris som finnes i test kan mangle i produksjon. Feilen ligger da ikke i meldingsoppsettet, men i at referansedataene ikke er på plass på produksjonssiden. Dette er en vanlig årsak til avvisninger de første dagene etter aktivering.