Kvitteringsprincipper og -regler



Relaterede dokumenter
Bilagsrapport 2: Kvitteringsprincipper og -regler Forskrift F1: EDI-kommunikation med DataHub'en i elmarkedet. Træder i kraft den 1.3.

Oversættelse til dansk af APERAK. Application Error and Acknowledgement Message. Dank EDI Message Implementation Guide

14. KONTROLMEDDELELSE

EdiDKgas Implementeringsguide

EDI-guide for Regres Bilag 2 Ajourføringshistorik

Syntaks og struktur i EDI-meddelelser

Metodeanmeldelse af markedsforskrift F1 - EDIkommunikation

Internt notat

Meddelelses Implementerings Guide (MIG) for CONTRL meddelelsen

Bilagsrapport 4: DataHub - Webservice interface Forskrift F1: EDI-kommunikation med DataHub'en i elmarkedet. Træder i kraft den 1.3.

Indledning... 2 Opbygning... 2 Servicesegmenternes sammenhæng... 3 UNA... 4 UNB... 6 UNH UNT UNZ... 14

Forretningsprocesser for EDIkommunikation

Indholdsfortegnelse. 1. Formål Referencer... 4

Oversættelse til dansk af UTILMD. Utility Master Data Message. Dansk EDI Message Implementation Guide

Forskrift F: EDI-kommunikation

Den Gode VANSEnvelope. MedCom

EDI-kommunikation med DataHub i elmarkedet

EDI-guide for CONTRL. Version 1.0 Final

Vejledning og feltværdier

Forskrift F: EDI-kommunikation

Teknisk Implementerings Guide UN/EDIFACT & UNA/UNB-UNZ

Udgivelsen er beskyttet af Creative Commons license, Navngivning 2.5

Oversættelse til dansk af MSCONS Metered Services Consumption rapport. Dansk "EDI Message Implementation Guide

MT 940 Customer Statement Message ( i FINSTA format)

EDI-guide for Regres. Version 3.3 draft F

15. FINANSIEL AFLYSNINGSMEDDELELSE (FINCAN)

Metodeanmeldelse af markedsforskrift F1 EDIkommunikation

Digital post Snitflader Bilag B - Afsendelse og modtagelse af meddelelser via S/MIME Version 6.3

Den Gode VANSEnvelope, Scenariebeskrivelser. MedCom

FESD-standardiseringsgruppen Att: Palle Aagaard IT- og Telestyrelsen IT-strategisk kontor Holsteinsgade København Ø

Kvitteringspolitik. Syntaks- og kommunikations-regler. Aaaaaa Aaaaaaa. Regler for beskedforsendelse og eventuel kvittering

Bilag A til Aftale om modtagelse af elektroniske fakturaer og samtalespecifikationer

13. BANK-STATUSMEDDELELSE (BANSTA)

DKAL Snitflader Afsendelse og modtagelse af meddelelser via S/MIME

OIOUBL Guideline. OIOUBL Profiler. UBL 2.0 Profiles (UTS) Appendiks til G26. Version 1.3

Planhåndtering i det danske elmarked

NemKonto. XML skemaer for. ukomplette og komplette betalinger. til NKS

ITD ecmr WEB Services. Af Allan Wisborg, IT Udvikler

Driftsudfordringer. DataHub den 21. april Markedsdrift El

Udgivelsen er beskyttet af Creative Commons license, Navngivning 2.5

Dansk Ediel implementeringsguide til skift af leverandør

Vejledning VEDRØRENDE GENERELLE BETINGELSER FOR ANVENDELSE AF NEMHANDEL. Februar 2015 (VERSION 1.4 AF FEBRUAR 2015)

2. BRUGEN AF EDIFACT. Indholdsfortegnelse

DAVAR Omdøbt til SagDokumentFormat. Attention er skilt ud i et selvstændigt format, AttentionFormat.

Forretningsprocesser for EDIkommunikation

Beskrivelse af fejlkoder. Version 1.0,

Beskrivelse af fejlkoder. Version 7.0, KMD Indkomst WEBService IndkomstEnkeltForespoergsel og MQService IndkomstMasseForespoergsel

Udgivelsen er beskyttet af Creative Commons license, Navngivning 2.5

Forretningsprocesser for det danske elmarked. (EDI guide - BRS'ere)

OIOUBL Guideline. Profiler i OIOUBL bekendtgørelsen Version 1.0. Udgivelsen er beskyttet af Creative Commons license, Navngivning 2.

DataHub Dialogmøde. 6. august 2012

Digital post Snitflader Bilag A5 - REST HTTP returkoder Version 6.3

Fordeling af journalnotater og dokumenter Udkast til løsningsmodel. Marts 2014

Introduktion til MeMo

EDI-kommunikation med DataHub i elmarkedet

Dansk Ediel implementeringsguide til skift af leverandør

AFGØRELSE VEDRØRENDE SKIFT AF BA- LANCEANSVARLIG AKTØR

Fælles Fallback-procedure for EDI-meddelelser

SEPA Direct Debit. Vejledning for tilbageførsel. privatbetalinger (CORE) Nets Denmark A/S Lautrupbjerg 10 P.O. 500 DK-2750 Ballerup

DKAL Snitflader REST Register

1. FORORD TIL BRUGERVEJLEDNING FOR FLYTNING AF LD-KONTI... 3

Regler for CTF. (Energinet.dk Gastransmissions regler for Capacity Transfer Facility)

Tilslutningsprøvedrejebog til NemKonto for Private Udbetalere. Version 1. december 2007

Udgivelsen er beskyttet af Creative Commons license, Navngivning 2.5

BILAG 9. DataHub- og markedsrapportering. 1. Markedsoverblik. 1.1 Leverandørskift. 1.2 Fejlagtige leverandørskift. Direktørgruppen. 14.

Tilslutning til ecomone Basis (OIO Faktura)

EPJ-Syd SPØRGSMÅL OG SVAR I PRÆKVALIFIKATIONSFASEN FOR UDBUD VEDR. EPJ/PAS

Underbilag 2O Beskedkuvert Version 2.0

Elektronisk signering manual 1.3

AO FORRETNINGSREGLER EDI fakturaer fra vareleverandører. (offentliggøres på Suppliers Portal)

OIOUBL Guideline. OIOUBL Guideline

Udkast til dataudveksling med elleverandører og andre tredjeparter via kundestyret dataadgang

FORSLAG TIL MASSEAFSENDELSE

Fællesoffentlig beskedmodel version 1.0

EPJ-Syd SPØRGSMÅL OG SVAR I PRÆKVALIFIKATIONSFASEN FOR UDBUD VEDR. EPJ/PAS

EDI kvalitetssikring af den elektroniske kommunikation

Ændring i vilkår for skift af elleverandør for elproduktionsanlæg

Vejledning til anvendelse af MeMo og SMTP. Næste generation Digital Post Maj 2018, version 0.9

XML webservice for pensionsordninger. Version 1.0 Draft A

DKAL Snitflader REST HTTP returkoder

EDI-guide for Regres. Version 3.2

Forretningsprocesser for EDIkommunikation

Teknisk Dokumentation

EDI-guide for Panthaverdeklarationer. Version 5.2 final

Afsnittet er temmelig teoretisk. Er du mere til det praktiske, går du blot til det næste afsnit.

Introduktion til eblisten Opret brugerkonto Abonnementtyper Kom godt i gang med eblisten Start eblisten...

1 Brug af snitfladebeskrivelsen Formål og beskrivelse Hvad er formålet med snitfladen? Beskrivelse af snitfladen...

Implementeringsvejledning NemKonto-betalinger via Danske Bank Version 1.2

SEPA DIRECT DEBIT. Vejledning til forespørgselsprocedure ved fejlagtig erhvervsbetaling

Reducér risikoen for falske mails

Digital post Snitflader Bilag A2 - REST Register Version 6.3

Fejlbehæftede betalinger

Drejebog for tilslutningsprøve OIO sag

Den Gode LÆ-blanket Webservice (DGLÆ:WS)

Indholdsfortegnelse. Systembeskrivelse kapitel 8 Administrationsdatabase

MØDE OM INTEGRATION GENNEM ØKONOMI I RAMMEARKITEKTUREN 27/8-2015

EDIFACT Kursus. Mandag den 16. juni 2014 hos MedCom

EDI-guide for Opsigelser. Version 5.7 draft G

KRAVSPECIFIKATION for underretningsstatistik

Transkript:

Forskrift F: EDI-kommunikation Bilagsrapport 2: Kvitteringsprincipper og -regler April 2007 Rev. 1 Dok.løbenr. 80089-07 1/15

Indholdsfortegnelse 1. Kvitteringsprincipper og -regler... 3 1.1 Begreber... 3 1.2 af kvitterings- og fejlmeddelelsesniveauer... 4 1.3 Generiske kvitteringsprincipper... 6 1.3.1 Punkt 1 - Generelt... 6 1.3.2 Punkt 2 - Er afsender kendt?... 6 1.3.3 Punkt 3 Syntaks og struktur OK?... 7 1.3.4 Punkt 4 - Positiv kvittering? (gælder kun EDIFACT)... 7 1.3.5 Punkt 5 - Behandling af meddelelsen... 8 1.3.6 Punkt 6 - Fejl?... 9 1.3.7 Punkt 7 - Overholdes tidsfristen?... 9 1.3.8 Punkt 8 Fejlbehandling... 9 1.4 EDIFACT-kvittering... 9 1.4.1 CONTRL... 10 1.4.2 APERAK... 11 1.4.3 Negativ APERAK... 11 1.4.4 Positiv APERAK... 13 1.5 XML-kvitteringer... 13 Dok.løbenr. 80089-07 2/15

1. Kvitteringsprincipper og -regler Det overordnede princip i forbindelse med EDI-udvekslinger i Danmark er, at der skal foreligge et svar fra modtageren af data enten i form af en accept eller en fejlmeddelelse. For at sikre at de elektroniske meddelelser sendes og modtages korrekt, og at eventuelle fejl bliver fundet og behandlet, skal aktører efterleve reglerne for brug af kvitteringer og fejlmeddelelser, som de er beskrevet i dette dokument. UN/CEFACT angiver tre overordnede niveauer af accept. Accept af modtagelse (sendt fra kommunikationssoftware/edi-konverter) Accept af EDI-meddelelse (sendt fra EDI- og/eller forretningsapplikationen) Meddelelsessvar (sendt fra forretningsapplikationen) Sidstnævnte anvendes kun, når det sker i overensstemmelse med en forretningsproces og dermed ikke for simple meddelelser. Meddelelsessvar behandles ikke nærmere i dette dokument, men er beskrevet i de enkelte forretningsprocesser. Ud over disse niveauer af accept findes der flere niveauer af fejlmeddelelser, der afsendes, når der opstår fejl hos modparten. Overordnet har kvitteringer og fejlmeddelelser til formål at informere meddelelsesafsender om modtagers reaktion. 1.1 Begreber 1 Nedenstående figur beskriver sammenhængen mellem de anvendte begreber i kvitteringsprincipperne. Begreber og niveauer for kvitteringer UN/CEFACT-niveauer Modtagelseskvittering Syntakskvittering Meddelelse (header-niveau) Strukturkvittering Indholdskvittering 0..* Modtagelsesaccept Dokument Forretningsdokument Meddelelse: Beskriver overordnet information (header-information), der er gældende for alle de underliggende dokumenter, f.eks. afsender og modtager. Dokument: Repeterede oplysninger under meddelelsen, eksempelvis én tidsserie ud af alle meddelelsens tidsserier. 1 Se bilag 1 Syntaks og struktur i EDI-meddelelser for en mere specifik beskrivelse af de enkelte begreber. Dok.løbenr. 80089-07 3/15

1.2 af kvitterings- og fejlmeddelelsesniveauer Herunder specificeres principperne og reglerne for anvendelse af kvitteringer. Principperne er identiske, uanset hvilket dataformat, der er tale om. Derimod er der forskel på detailreglerne inden for XML og EDIFACT. De følgende afsnit er derfor inddelt i de specifikke regler for EDIFACT og XML. Meddelelsestype EDIFACT: Positiv CONTRL XML: Anvendes ikke Modtagelseskvittering Modtagelseskvittering anvendes kun, hvis det er krævet i forretningsprocessen, eller ved kritiske processer. Kvitteringen, som sendes fra EDI-konverteren, benyttes til at bekræfte, at syntaksen er korrekt. Modtagelseskvitteringen kan desuden anvendes i testsituationer. Syntakskvittering Syntakskvittering sendes fra EDI-konverteren og benyttes i de tilfælde, hvor en meddelelse er modtaget, og der er fejl i syntaksen. Meddelelsestype EDIFACT: Negativ CONTRL XML: Acknowledgement document på baggrund af en XMLskema validering. Strukturkvittering (Model Error Report) Strukturkvitteringen er syntaks-neutral og anvendes til validering mod Business Information Model (klassediagram m.m. beskrevet i forretningstransaktionerne). Omhandler f.eks. verificering af korrekt brug af attributter. Strukturkvitteringen skal være på dokumentniveau og refererer til et Business Document (f.eks. aktørplan, regulerkraftbud eller regulerkraftbestilling), hvis det er muligt. Hvor det ikke er muligt at referere til det underliggende dokumentniveau, skal hele meddelelsen afvises. Meddelelsestype EDIFACT: Negativ APERAK XML: Acknowledgement document på baggrund af XMLskema validering. Dok.løbenr. 80089-07 4/15

Indholdskvittering (Processability Error Report) Indholdskvitteringen er syntaks-neutral og anvendes til at kvittere for indholdet på dokumentniveauet, f.eks. validering af målepunkt-id. Indholdet af kvitteringen afhænger af indholdet i den meddelelse, der kvitteres for. Reglerne for hvornår og hvordan indholdskvitteringen skal anvendes er beskrevet i de forretningstransaktioner, hvori den indgår. Meddelelsestype EDIFACT: Negativ APERAK XML: Acknowledgement document Modtagelsesaccept (Acknowledgement of Acceptance) Meddelelsestype Modtagelsesaccepten skal altid gives på dokumentniveau. En modtagelsesaccept betyder, at modtageren har modtaget, valideret (syntaks) og behandlet indholdet positivt. Accepten gælder hele den modtagne meddelelse. EDIFACT: Positiv APERAK XML: Positivt acknowledgement document Forretningsdokument (Business Document) Forretningsdokumentet er et svar på en forespørgende meddelelse og er udformet som et Business Document. Kvitteringen afslutter hele forretningstransaktionen. Meddelelsestype Det er angivet i den aktuelle forretningstransaktion, hvilke Business Documents der anvendes. Dok.løbenr. 80089-07 5/15

1.3 Generiske kvitteringsprincipper Nedenstående figur beskriver de generiske principper for udvekslingen af meddelelser og kvitteringer. Krav og anbefalinger vedrørende de enkelte punkter i figuren fremgår af skemaer i de efterfølgende afsnit. Afsender - Aktør A Modtager - Aktør B Afslut Send meddelelse Pkt. 1. Initierende meddelelse Modtag meddelelse [Ja] Pkt. 7. Overholdes tidsfristen? Kontakt modtager [Nej] Gensend berørte meddelelser Pkt. 8. Undersøg fejl Ignorer meddelse Afslut [Nej] [Ja] Er afsender kendt? Pkt. 2. [Nej] [Ja] Modtag meddelelse Send negativ kvittering [Nej] Syntaks og struktur OK? Pkt. 3. Afslut [Ja] Fejl? Pkt. 6. Modtag meddelelse Send positiv kvittering Gælder kun EDIFACT Positiv kvittering? Pkt. 4. Behandling af meddelelserne Modtag meddelelse Send negativ indholdskvittering [Nej] Er meddelelsesindholdet OK? Afslut [Ja] Pkt. 5. Modtag meddelelse Afsluttende meddelelse Send modtagelsesaccept Afslut 1.3.1 Punkt 1 - Generelt Alle kvitteringsforløb indledes med en initierende meddelelse. En meddelelse kan også være en kvittering. 1.3.2 Punkt 2 - Er afsender kendt? Modtager (Aktør B) skal være i stand til at identificere afsender (Aktør A) og validere vedkommende mod de valide afsendere, der er indgået aftale med. Der kan være to udfald af valideringen: Dok.løbenr. 80089-07 6/15

Afsender (Aktør A) er ikke valid eller ukendt. I disse tilfælde afsluttes processen. Afsender (Aktør A) er valid. I dette tilfælde fortsætter processen. Krav 2.1 Krav 2.2 Modtager skal validere afsender. Afsender og modtager skal føre et opdateret kartotek over valide aktører. 1.3.3 Punkt 3 Syntaks og struktur OK? Modtager (Aktør B) struktur- og syntaksvaliderer den modtagne meddelelse og dens indhold. Der kan være to udfald af valideringen: Syntaksen og strukturen er ikke korrekt. Modtager (Aktør B) sender en negativ kvittering (syntaks-/strukturkvittering). Denne skal referere til afsenderens (Aktør A) initierende meddelelse, således at vedkommende ikke har problemer med at identificere den fejlagtige meddelelse. Syntaksen og strukturen er korrekt og processen fortsætter. Krav 3.1 Krav 3.2 Krav 3.3 Anbefaling 3.4 Krav 3.5 Modtagers (Aktør B) EDI-system skal være i stand til automatisk at validere en meddelelse ud fra følgende kriterier: 1. Grundlæggende struktur (UN/CEFACTmeddelelsen ved EDIFACT, skema ved XML) 2. Syntaks Ved fejl skal modtager (Aktør B) kunne afsende en negativ kvittering, der refererer til den initierende meddelelse. Afsender af den initierende meddelelse skal løbende undersøge de indkomne negative kvitteringer. Hvis der opstår fejl i syntaks- og strukturvalideringen, skal modtager (Aktør B) svare inden for 5 minutter efter modtagelse. Det er kun tilladt at sende én kvittering pr. meddelelse (positiv eller negativ). 1.3.4 Punkt 4 - Positiv kvittering? (gælder kun EDIFACT) Den positive kvittering (modtagelseskvittering) kan anvendes under to omstændigheder: Det kan være under et testforløb, eller hvis det er praksis, at modtagelsesaccepten afsendes meget senere end modtagelseskvitteringen. Der kan være tale om to situationer: Afsender ønsker ikke en modtagelseskvittering. I disse tilfælde må den ikke sendes. Afsender ønsker en modtagelseskvittering. I disse tilfælde skal det fremgå af den initierende meddelelse. Modtagelseskvitteringen skal referere til den initierende meddelelse. Dok.løbenr. 80089-07 7/15

Anbefaling 4.1 Krav 4.2 Krav 4.4 Krav 4.5 Anbefaling 4.2 Modtagelseskvitteringen bør ikke anvendes, med mindre mindst et af følgende forhold gør sig gældende: 1. Afsender og modtager er i et testforløb. 2. Der er stor tidsforskel mellem afsendelse af modtagelseskvitteringen og modtagelsesaccepten. Modtager (Aktør B) skal kunne sende en modtagelseskvittering med reference til den initierende meddelelse. Modtager skal svare med en kvittering inden for 5 minutter. Der skal sendes en kvittering for hver meddelelse. Forespørger Aktør A på en kvittering, bør vedkommende løbende undersøge, om kvitteringen er modtaget. 1.3.5 Punkt 5 - Behandling af meddelelsen Når meddelelsen er syntaksvalideret, kan EDI-systemet videresende de indeholdte dokumenter til de aktuelle applikationer, hvor meddelelsen og dokumenterne valideres. Afhængigt af EDI-system kan dele af indholdsvalideringen foregå i EDI-konverteren. Der kan være følgende udfald af valideringen: Der er indholdsmæssige fejl. I disse tilfælde skal modtager (Aktør B) fremsende en indholdskvittering, indeholdende en reference til den initierende meddelelse og det specifikke dokument. Det skal fremgå af indholdskvitteringen, hvad fejlen er og hvor i meddelelsen/dokumenterne, fejlen er identificeret. Kvitteringen skal være på et niveau, der gør afsenderen af den initierende meddelelse (Aktør A) i stand til at identificere og udbedre fejlen uden at skulle tage kontakt til afsender af fejlmeddelelsen (Aktør B). Meddelelsen/dokumenterne er blevet valideret positivt (der er ingen indholdsmæssige fejl). Modtager (Aktør B) skal i disse tilfælde sende en positiv indholdskvittering. Applikationen behandler meddelelsen, og kvitteringsudvekslingen afsluttes. Krav 5.1 Modtagers (Aktør B) applikation (eller EDI-system) skal være i stand til automatisk at validere en meddelelse med tilhørende dokumenter ud fra følgende: Krav 5.2 Anbefaling 5.3 1. Klassediagrammer og kodelister jf. den gældende forretningstransaktion. 2. Fælles dataformat-regelsæt, der er gældende for hele markedet. Det skal sikre, at afsender altid kan forvente den samme validering. Modtager (Aktør B) skal kunne sende en indholdskvittering på et informationsniveau, der muliggør, at afsender (Aktør A) kan identificere den initierende meddelelse/dokument samt finde årsagen til en eventuel negativ indholdskvittering. Hvis ikke andet fremgår af forretningstransaktionerne for den pågældende meddelelse/dokument, skal modta- Dok.løbenr. 80089-07 8/15

Krav 5.4 ger (Aktør B) svare med en indholdskvittering inden for to timer efter modtagelse. Det er kun tilladt at sende én indholdskvittering pr. dokument. 1.3.6 Punkt 6 - Fejl? I punkt 6 gennemføres samme procedure som i punkterne 2 til 4. Det vil sige, at den modtagne kvittering (modtagelses-/syntaks-/struktur- /indholdskvittering) eller modtagelsesaccept valideres i forhold til syntaks og struktur. Forskellen i forhold til punkterne 2 til 4 er, at der ikke må sendes en kvittering på en kvittering. Der er følgende muligheder for svar på den initierende meddelelse: Svaret er negativt. Årsagen skal i dette tilfælde undersøges. Den initierende meddelelse er godkendt, og processen fortsætter. Krav 6.1 Der må ikke sendes en kvittering på en kvittering. 1.3.7 Punkt 7 - Overholdes tidsfristen? Alle meddelelser skal besvares i overensstemmelse med den foreskrevne forretningstransaktion. Det påhviler modtager (Aktør A) at sikre, at alle afsendte meddelelser bliver rettidigt besvaret 2. Der er følgende muligheder: Svar udebliver. Sker dette, skal afsender (Aktør A) kontrollere egne systemer, før der tages kontakt til modtager (Aktør B). Svar kommer rettidigt. Er svaret afgivet inden for tidsfristen, afsluttes forløbet. Anbefaling 7.1 Anbefaling 7.2 Alle afsendte meddelelser bør overvåges. Såfremt et rettidigt svar udebliver, skal den berørte aktør reagere jf. forskrift F, afsnit 8.1. Såfremt tidsfristen ikke overholdes, bør afsender (Aktør A) undersøge egne systemer for fejl, før Aktør B kontaktes. 1.3.8 Punkt 8 Fejlbehandling Aktør A skal undersøge og udbedre fejlen. Krav 8.1 Fejl skal undersøges og udbedres inden for en tidshorisont, der muliggør rettidig fremsendelse af ændringer. 1.4 EDIFACT-kvittering Overordnet er der to typer af svar på en EDIFACT-meddelelse: 2 Dette kan f.eks. ske i forbindelse med en "timer" i applikationen, som kan trigge tiden fra afsendelse. Dok.løbenr. 80089-07 9/15

1. CONTRL godkender eller afviser hele meddelelsen. Her valideres meddelelsens struktur og syntaks efter gældende regler. 2. APERAK godkender eller afviser på meddelelses- og/eller dokumentniveau. Her valideres meddelelsens forretningsmæssige indhold og underliggende dokumenter ud fra reglerne, der er specificeret i den aktuelle forretningstransaktion. o Såfremt der er fejl i headeren, afvises hele meddelelsen inkl. underliggende dokumenter. o Er der ingen fejl i headeren, skal hvert enkelt dokument besvares. Hvis den modtagne EDIFACT-meddelelse indeholder flere dokumenter (f.eks. tidsserier) er det legalt at sende én APERAK pr. dokument eller at sende én samlet APERAK for alle dokumenter. Dataformatet EDIFACT benytter følgende kvitteringer: Niveau Kvitteringer Dækker følgende punkter fra afsnit 1.3 Meddelelsesniveau CONTRL 1-4 (Modtagelses-/syntaks- /strukturkvittering) Meddelelsesniveau (Indholdskvittering) Dokumentniveau (Indholdskvittering) APERAK 5 1.4.1 CONTRL CONTRL-kvitteringen oplyser, om en given meddelelse er godkendt eller afvist i forhold til den angivne syntaks og struktur. En CONTRL-meddelelse er en standard EDIFACT-meddelelse, der kan kvittere for alle EDIFACT-meddelelser. CONTRL-meddelelsen dannes i konverteren efter modtagelse af en EDIFACTmeddelelse, og CONTRL s er altid ens er opbygget. Kvitteringen kan være positiv eller negativ. De almindelige EDIFACT syntaks-regler er gældende for CONTRL en. Disse er beskrevet i: CONTRL Syntax og Service Report Message Danish Ediel Message Implementation Guide 3. Eksempel på CONTRL: UNA:+.? ' UNB+UNOC:3+5790000432752:14+5790001062231:14+070124:0725+6649' UNH+1+CONTRL:2:2:UN:EDIEL2' UCI+M2865462+5790001062231:14+5790000432752:14+1' UNT+3+147' UNZ+1+6649' 3 http://www.ediel.dk/ny/elmarked/dok/levskift_dok_146.pdf Dok.løbenr. 80089-07 10/15

1.4.2 APERAK APERAK-kvitteringen tjener overordnet to formål: 1. At informere afsender om, at bestemmelsesapplikationen har modtaget meddelelsen eller dele heraf og afvist indholdet på grund af fejl. 2. At informere afsender om succesfuld modtagelse og behandling af meddelelsen eller dele heraf. APERAK en fremsendes kun, hvis EDIFACT-syntaksen er valid. APERAK en sendes altid som kvittering på en meddelelse, hvis det fremgår af forretningstransaktionen. Dette gælder, uanset om afsender beder om en APERAK i BGM-segmentets element 4343 i original-meddelelsen. APERAK en dannes delvist i applikationslaget og kan derfor kvittere for selve indholdet i meddelelsen. APERAK en godkender indirekte EDIFACT-syntaksen, idet den kun sendes, såfremt meddelelsen er blevet behandlet i applikationen og derfor er blevet syntaks-valideret positivt. Positive CONTRL s bør derfor ikke anvendes. Som beskrevet i afsnit 1.4 er det valgfrit, om APERAK en svarer på hele meddelelsen med underliggende dokumenter eller hver enkelt dokument i en særskilt APERAK. Der skal kvitteres for ethvert dokument med en APERAK, der, uanset niveau, skal referere til den oprindelse meddelelse. Teksterne, der angiver fejlårsagen i den negative APERAK, skal være klart formulerede og medvirke til en hurtig afklaring af fejlen. De almindelige EDIFACT syntaks-regler er gældende for APERAK en. Disse er beskrevet i: APERAK Application Error and Acknowledgement Message Danish Ediel Message Implementation Guide 4. 1.4.3 Negativ APERAK En negativ APERAK afsendes, hvis der er fejl i den modtagne EDIFACTmeddelelse. Der er forskellige måder at kvittere på, afhængigt af om der er fejl i header-sektionen eller på dokumentniveau. Fejl på header-niveau Følgende forhold valideres på header-niveau: At meddelelses-id har ikke været modtaget før. At påkrævede attributter jf. forretningstransaktionen er til stede inkl. UNBattributter. At forretningstransaktionen og versionen er understøttet (UNH/0068). Skal også benyttes, hvis modtager ikke har implementeret forretningsscenariet, der initierer meddelelsen. At implementeringsguidens version (UNH/S009) stemmer overens med forretningstransaktionen. At meddelelsesfunktionen er i overensstemmelse med forretningstransaktionen. 4 http://www.ediel.dk/ny/elmarked/dok/levskift_dok_150.pdf Dok.løbenr. 80089-07 11/15

At modtager er i stand til at behandle dokumenter for "Interchange Recipient". At tidszonen er UTC, medmindre andet er blevet bilateralt aftalt. At kodede værdier er indeholdt i liste over accepterede værdier. Ved fejl på header-niveau stopper behandlingen, og den negative APERAK dannes og sendes efter følgende regler: Segmentgruppe. Værdi segment.element BGM.4343 27 Afvist SG3.ERC.C901.9321 Fejlkoden jf. ovenstående skema Fejlkode skal fremgå af elementet i ERC-segmentet. SG3.FTX.C108.4440 Tekstbeskrivelse Fejlbeskrivelsen på dansk og engelsk adskilt af tegnet /. Navnet på fejl behæftet element (fx Startdato) SG1.RFF.C506.1154 Meddelelses-ID Indeholder en reference til meddelelses-id fra den validerede meddelelse. Eksempel på APERAK der oplyser om header-fejl: UNA:+.? ' UNB+UNOC:3+5790000701278:14+5790000432752:14+070118:1447+4471++DK- TIS-MET++1+DK' UNH+1+APERAK:D:96A:UN:E2DK02+DK-BT-008-002' BGM+++27' DTM+137:200701181445:203' RFF+ACW:7179' NAD+FR+5790000701278::9' NAD+DO+5790000432752::9' ERC+42::ZZZ' FTX+AAO+++Forkert meddelelsesnavn / Wrong Message Name' UNT+9+1' UNZ+1+4471' Fejl på dokumentniveau Meddelelser, der indeholder en række repeterede dokumenter, som f.eks. tidsserier i MSCONS og UTILTS, skal der kvitteres for individuelt i form af en samlet APERAK eller en APERAK pr. dokument. Før dokumenterne kan valideres kræves et validt header-niveau. Følgende forhold bliver valideret: At påkrævede attributter jf. forretningstransaktionen er til stede. At kodede værdier er indeholdt i liste over accepterede værdier. At værdier er korrekt formateret jf. implementeringsguiden. At attributter overholder antallet af repetitioner. Uanset antallet af fejl valideres alle dokumenter, og der sendes efterfølgende en APERAK med oplysninger om fejlene efter følgende regler: Dok.løbenr. 80089-07 12/15

Segmentgruppe. segment.element Værdi BGM.4343 34 Godkendt med kommentarer SG1.RFF.C506.1154 Meddelelses-ID Indeholder en reference til meddelelses-id fra den validerede meddelelse. eller målepunkts- ID SG3.ERC.C901.9321 Fejlkoden jf. ovenstående skema Fejlkode skal fremgå af elementet i ERC-segmentet. SG3.FTX.C108.4440 Tekstbeskrivelse Fejlbeskrivelsen på dansk og engelsk adskilt af tegnet /. Navnet på fejlbehæftet element (fx startdato). SG4.RFF.C506.1154 Transaktions-ID, serie-id Det er angivet i forretningstransaktion, hvad der skal bruges i forhold til den meddelelse, APERAK en vedrører. Modtageren af en negativ APERAK er forpligtet til at reagere på denne. 1.4.4 Positiv APERAK Accept sendes altid på dokumentniveau og skal overholde følgende regler: Segmentgruppe. Værdi segment.element BGM.4343 34 Godkendt med kommentarer SG1.RFF.C506.1154 Meddelelses-ID 100 Objektet er godkendt SG3.ERC.C901.9321 SG3.FTX.C108.4440 SG4.RFF.C506.1154 Tekstbeskrivelse Transaktions- ID eller Serie-ID eller Målepunkts-ID n skal kun anvendes, hvis det fremgår af forretningstransaktionen (BT). Såfremt det er tilfældet, skal beskrivelsen være dansk og engelsk adskilt af tegnet /. Det er angivet i forretningstransaktion, hvad der skal bruges i forhold til den meddelelse, APERAK en vedrører. En APERAK kan indeholde både positive og negative svar på dokumenter fra samme meddelelse. 1.5 XML-kvitteringer Dette afsnit indeholder en specifik beskrivelse af reglerne for XML-kvitteringer anvendt i forbindelse med XML-meddelelser. Følgende to kvitteringstyper anvendes til XML-meddelelser: Dok.løbenr. 80089-07 13/15

Niveau Kvitteringer Dækker følgende Meddelelsesniveau (Syntaks-/struktur- /indholdskvittering) Dokumentniveau (Syntaks-/struktur- /indholdskvittering) Acknowledgement Document punkter fra afsnit 1.3 1-5 I XML-konteksten anvendes kun én type kvittering, hvilket afspejler anvendelsen af ETSO s Acknowledgement Document 5. Ved modtagelse valideres meddelelsen i forhold til et XML-skema og videre med indholdsvalidering. Herefter sendes et Acknowledgement Document retur. Dokumentet er positivt eller negativt alt efter udfaldet af valideringen. Alle meddelelser/dokumenter skal således kvitteres af et og kun et Acknowledgement Document, der refererer til den oprindelige meddelelse. Når en aktør kalder en webservice hos Energinet.dk, sker der en validering af den modtagende XML-meddelelse i forhold til det XML-skema, der er relateret til den aktuelle webservice. Valideringen kontrollerer både, at XML-meddelelsen er well-formed, det vil sige, at indholdet overholder W3C s standard for opbygning af XML-meddelelser. Derudover kontrolleres, om de elementer, der indgår i XML-meddelelsen, er tilladte i forhold til XML-skemaet. Desuden kan skemaet definere regler for indholdet af de enkelte elementer. Stemmer XML-indholdet ikke overens med det relaterede XML-skema, returneres en negativ kvittering, og kvitteringsprocessen afsluttes. Hvis skemavalideringen gennemføres uden problemer, fortsættes med en semantikvalidering, som er et resultat af applikationsvalidering. Resultatet af kontrollen kan være en negativ kvittering, hvis applikationskontrollen eller indholdet på anden vis ikke stemmer overens med de opsatte regler for semantikken (jf. valideringstabellen for den aktuelle forretningsproces). Kvitteringen vil på meddelelsesniveauet indeholde overordnet information om meddelelsen (meddelelses-id, afsender og modtager), samt en årsag bestående af en kode samt tilhørende beskrivelse. Ved brug af Acknowledgement Document som positiv kvittering påhæftes årsagen med årsagskode A01 (Message fully accepted). Kvitteringen tjener således tre formål: At informere afsender om, at meddelelsens indhold er afvist på grund af fejl i syntaksen (meddelelsesniveau). At informere afsender om succesfuld modtagelse og om, at behandling af hele meddelelsen fortsætter (meddelelses- og dokumentniveau). 5 http://www.edi.etso-net.org/acknowledgement-v4r0/acknowledgement-documentv4r0.zip Dok.løbenr. 80089-07 14/15

At informere afsender om, at bestemmelsesapplikation har modtaget meddelelsen, eller dele heraf, og at oplyse om mulige fejl i indholdet. Dok.løbenr. 80089-07 15/15