Transaksjonsstandard for virkesomsetningen i Norge Versjon 2.0 Desember 2007 SKOG-DATA AS
Innhold 1 Innledning 3 2 Dokumentasjon av 3 2.1 Oversikt 3 2.1.1 Meldingstyper/funksjoner 3 2.1.2 BusinessAcknowledge forretningsregler 3 2.1.3 Samhandling 3 2.1.3.1 Kvittere for mottatt melding 4 2.1.4 Behandle meldingen BusinessAcknowledge 5 2.1.4.1 Statusverdier som benyttes 5 2.2 Hvordan lese diagrammene 5 3 BusinessAcknowledge 7 3.1 BusinessAcknowledge meldingen 8 3.1.1 Dokument 8 Side 2
1 Innledning Transaksjonsstandard for virkesomsetningen i Norge er utviklet for å sikre en effektiv og sikker utveksling av elektroniske meldinger mellom forretningspartnere innen virkesomsetningen i Norge. Standarden inneholder beskrivelse av dokumenter som ikke er dekket i andre standarder. 2 Dokumentasjon av Beskrivelsen i dette dokumentet er ikke komplett med tanke på tekniske spesifikasjoner. Det henvises til dokumentet BusinessAcknowledge XML Schema for detaljert teknisk dokumentasjon. Ferdig schema kan lastes ned (BusinessAcknowledge.xsd). Beskrivelse av alle elementer finnes i dokumentet Data Dictionary. 2.1 Oversikt En mottaker av en melding bruker meldingen for å informere avsender om at meldingen er mottatt og godtatt for prosessering i det mottaende datasystemet. Bruken av meldingen som kvittering på mottatt melding, er frivillig og bruken avtales mellom partene. Kvittering for mottatt melding ligger ofte som standard i meldingsformidlingen (SAP XI, MS BizTalk osv). Meldingen brukes som tilbakemelding dersom originalmeldingen ikke følger standarden (validering mot schema). I slike situasjoner benyttes statuskode Avvist. Meldingen brukes som tilbakemelding dersom mottager ikke kan prosessere meldingen pga feil som for eksempel feil i innholdet, feilsendt (mottaker kan ikke gjenkjenne opplysninger) osv. I slike situasjoner benyttes statuskode Feil. 2.1.1 Meldingstyper/funksjoner Det er ingen varianter av. 2.1.2 BusinessAcknowledge forretningsregler Den etterfølgende tabellen lister hvilke forretningsregler som gjelder for meldingen. Referanse 2.1.3 Samhandling Regel Når meldingen brukes i en feilsituasjon, skal beskrivelse av feilen inkluderes i meldingen. Det skal alltid være en unik referanse til originaldokumentet Forklaring på aktivitetsdiagrammene: Kolonne: Et aktivitetsdiagram består av flere kolonner (Swimlanes). En kolonne beskriver aktiviteter og prosesser hos en aktør. Aktivitet: Et sett operasjoner som utføres hos en aktør. Angis i bokser med avrundede hjørner. Valg: Et punkt i prosessen der evalueringen av en betingelse medfører valg av ett eller flere mulige videre prosessløp. Angis som en rombe. Overgang (Forgrening og Sammenføyning): Start og avslutning av to eller flere parallelle prosesser. Angis med en tykk heltrukken linje. Start/stopp: Start og avslutning av selve samhandlingsprosessen. Det kan kun være ett startpunkt, men det kan være flere avslutninger. Angis som sirkler der startpunktet er helt svart mens sluttpunktet inneholder en hvit ring. Side 3
Aktivitet med gul farge: Dette er en aktivitet som er direkte relatert til sending eller mottak av en elektronisk melding beskrevet i dette dokumentet til/fra en annen aktør. Selve meldingen identifiseres med et understreket navn. Aktivitet med grønn farge: Dette er en aktivitet som er direkte relatert til sending eller mottak av en elektronisk melding relatert til denne standarden, til/fra en annen aktør. Selve meldingen identifiseres ved et understreket navn. Beskrivelse av meldingen finnes i et annet dokument. Aktivitet med blå farge: Dette er en aktivitet som er direkte relatert til sending eller mottak av en elektronisk melding som ikke er en del av denne standarden, til/fra en annen aktør. Selve meldingen identifiseres ved et understreket navn. 2.1.3.1 Kvittere for mottatt melding Side 4
2.1.4 Behandle meldingen BusinessAcknowledge Alle som benytter meldinger ihht til standarden, må ha på plass en rutine for behandling av feil. En slik rutine må monitorere mottatte BusinessAcknowledge meldinger og rute dem videre for behandling. Behandling kan gjerne være manuelle rutiner. 2.1.4.1 Statusverdier som benyttes Nivå Attributt Verdi Melding BusinessAckStatus Avvist Den mottatte meldingen følger ikke standarden (feil ved validering mot schema) og kan ikke prosesseres av det mottagende systemet. Feil Den mottatte meldingen inneholder feil som gjør at prosessering i det mottagende datasystemet ikke kunne gjennomføres. Mottatt Meldingen er mottatt og vil bli prosessert. 2.2 Hvordan lese diagrammene Forklaring på symboler i diagrammene: Sekvensen av enheter til høyre for symbolet, er påkrevd. Et valg mellom enheter til høyre for symbolet, er påkrevd Det er valgfritt å benytte en enkel forekomst av dette elementet. Prikket linje rundt. Det er valgfritt å benytte flere forekomster av dette elementet. Prikket linje rundt. Antall mulige forekomster er angitt under. En enkel forekomst av dette elementet er påkrevd. Heltrukken linje rundt. En enkel forekomst av dette elementet er påkrevd. Flere instanser kan forekomme. Heltrukken linje rundt. Antall mulige forekomster er angitt under. Antallet forekomster må ligge innenfor nedre og øvre grense som er angitt under (i dette tilfellet minimum 2 og maksimum 10 forekomster). Når en datatype er angitt for et element (både simple og komplekse datatyper), er navnet og eventuell lengde på datatypen angitt under. Det samme gjelder minimums og maksimumsverdier samt standardverdi (default-verdi). En farget boks med stiplet linje vil omgi komplekse datatyper. Strukturen på den komplekse datatypen vises inne i boksen. Stiplet linje betyr ikke at elementet er valgfritt. I dette eksemplet er strukturen undertrykket (+ til høyre angir at strukturen kan åpnes). Elementer kan forekomme utenfor den komplekse gruppeboksen hvis de er utvidelser av den definerte datatypen. Side 5
Attributter knyttet til et element kan bli vist over og under elementet. Hvis attributtet er en utvidelse av en definert datatype, vil det bli vist under gruppeboksen for den komplekse datatypen. I øvrige tilfeller vil den bli vist over elementinnholdet. Dette eksemplet viser en valgfri attributt. Påkrevde attributter vil ha heltrukken linje. Side 6
3 BusinessAcknowledge Side 7
3.1 BusinessAcknowledge meldingen BusinessAcknowledge består av følgende attributter: MeldingVersjon Gjeldene versjon er 2.0 MeldingOmsending Indikerer at dokumentet er sendt på nytt uten at det er foretatt endringer i opplysningene. Benyttes derom en mottager ber om å få sendt dokumentet på nytt. Ja eller Nei. Standardverdi er Nei. Dersom opplysningen mangler i dokumentet, skal standardverdi benyttes. BusinessAcknowledge består av følgende elementer: DokumentId Unikt nummer/identifikasjon av denne meldingen Avsender Hvilken organisasjon som er avsender av denne meldingen Mottaker - Hvilken organisasjon som er mottaker av denne meldingen Dokument Opplysninger om originaldokumentet Feil Eventuelle feilopplysninger Melding Fri kommentar til mottaker av meldingen 3.1.1 Dokument Elementgruppe med opplysninger om originalmeldingen. Gruppen består av følgende attributter: BusinessAckStatus Se 2.1.4.1 og Data Dictionary for gyldige verdier Dokument består av følgende elementer: DokumentReferanse Referanse til det originale dokumentet. DokumentMottatt Hele den originale meldingen kan legges inn i dette feltet. Side 8