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 3 2.1.2 Transportoppdrag forretningsregler 3 2.1.3 Samhandling 4 2.1.3.1 Bekrefte transportoppdrag 6 2.1.3.2 Svare på forespørsel om transport 7 2.1.3.3 Registrere et transportoppdrag 8 2.1.4 Behandle meldingen Transportoppdrag 8 2.1.4.1 Statusverdier som benyttes 8 2.2 Hvordan lese diagrammene 9 3 11 3.1 Rot-element 12 3.2 TroppdrbekrHode 12 3.3 TroppdrbekrSpesifikasjoner 12 4 Eksempler på forretningsmessig bruk av meldingen 14 4.1 Scenario A 15 4.2 Scenario B 16 4.3 Scenario C 17 4.4 Scenario D 18 4.5 Scenario E 19 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 XML Schema for detaljert teknisk dokumentasjon. Ferdig schema kan lastes ned (.xsd). Beskrivelse av alle elementer finnes i dokumentet Data Dictionary. 2.1 Oversikt er en melding fra et transportselskap til oppdragsgiver for tømmertransporten. Meldingen er i utgangspunktet en bekreftelse på et mottatt Transportoppdrag, men den kan også være et resultat av et manuelt registrert oppdrag hos transportselskapet. 2.1.1 Meldingstyper Meldingstypen (TroppdrbekrType) angir meldingens funksjon: TroppdrbekrType = OppdragBekreftelse Svar på mottatt transportoppdrag TroppdrbekrType = ForespørselSvar Svar på mottatt transportforespørsel TroppdrbekrType = Bekreftelse Resultat av en manuelt registrert ordre hos transportselskapet (det foreligger ingen melding av typen Transportoppdrag). En slik melding krever ikke svar fra mottaker. 2.1.2 Transportoppdrag forretningsregler Den etterfølgende tabellen lister hvilke forretningsregler som gjelder for meldingen dersom TroppdrbekrType = OppdragBekreftelse eller ForespørselSvar: Referanse Regel En melding må ha status på meldings-, hode- og spesifikasjonsnivå. TroppdrbekrStatus må ha verdiene Akseptert, Avslått eller Betinget TroppdrbekrHodeStatus må ha verdiene Akseptert, Avslått, Endret eller Ingen TroppdrbekrSpesStatus må ha verdiene Akseptert, Avslått, Endret eller Ingen En melding må inneholde alle TroppdrSpesifikasjoner fra det opprinnelige transportoppdraget. Linjenummeret på et spesifikasjonselement skal være lik linjenummeret på tilsvarende spesifikasjonselement i transportoppdraget. Dersom status på meldingsnivå = Akseptert, skal status på hode- og spesifikasjonsnivå = Akseptert. Dersom status på meldingsnivå = Avslått, skal status på hode- og spesifikasjonsnivå = Avslått. Dersom status på meldingsnivå = Betinget, skal status på enten hode- og/eller spesifikasjonsnivå = Avslått, Endret eller Ingen. Side 3
Dersom status på meldingsnivå = Betinget, kan ikke status på både hode- og spesifikasjonsnivå = Ingen. Dersom det kun er endring på meldingens hodenivå, skal status på spesifikasjonsnivå = Ingen Dersom det kun er endring på meldingens spesifikasjonsnivå, skal status på hodenivå = Ingen Den etterfølgende tabellen lister hvilke forretningsregler som gjelder for meldingen dersom TroppdrbekrType = Bekreftelse: Referanse Regel 2.1.3 Samhandling Forklaring på aktivitetsdiagrammene: En melding må ha status på meldings-, hode- og spesifikasjonsnivå. En TroppdrbekrSpesifikasjon kan ha kun en varemottaker. Skal samme vare transporteres til forskejllige varemottakere, må det etableres en TroppdrbekrSpesifikasjon for hver varemottaker. En TroppdrbekrSpesifikasjon er entydig definert SpesLinjenr. Linjenumre endres ikke selv om en spesifikasjon blir slettet. Linjenummereringen må ikke være fortløpende. En kan ha kun en vareleverandør, men det kan spesifiseres flere geografiske hentesteder. Transportoppdragbekreftelse må inneholde minst ett element av spesifikasjoner (TroppdrbekrSpesifikasjoner). Et spesifikasjonselement skal tildeles et unikt linjenummer (SpesLinjenr) innenfor et transportoppdrag. Sammen med dokumentnummeret vil dette identifisere spesifikasjonen. Linjenummeret som er tildelt en spesifikasjon, endres ikke ved endring av transportoppdrag. Ved sletting av spesifikasjon, skal linjenummeret ikke gjenbrukes innenfor samme transportordre En TroppdrbekrSpesifikasjon kan ha kun en varemottaker. Skal samme vare transporteres til forskjellige varemottakere, må det etableres en TroppdrbekrSpesifikasjon for hver varemottaker. En TroppdrbekrSpesifikasjon er entydig definert innen et transportoppdrag ved SpesLinjenr. Linjenumre endres ikke selv om en spesifikasjon blir slettet. Linjenummereringen må ikke være fortløpende. Dersom status på meldingsnivå = Ny, må status på hode- og spesifikasjonsnivå også være = Ny Dersom status på meldingsnivå = Kansellert, må status på hode- og spesifikasjonsnivå også være = Kansellert Dersom status på hode- og/eller spesifikasjonsnivå = Endret, må status på meldingsnivå også være = Endret Dersom det kun er endring på meldingens hodenivå, skal status på spesifikasjonsnivå = Ingen Dersom det kun er endring på meldingens spesifikasjonsnivå, skal status på hodenivå = Ingen Side 4
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. 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. Side 5
2.1.3.1 Bekrefte transportoppdrag Bekrefte Transportoppdrag Transportledelse [Har et virkesparti som skal kjøres] Registrer nødvendige opplysninger om oppdraget (opprett innkjøpsordre) Generer og send Transportoppdrag Transportoppdrag Motta Transportoppdrag [Kan ikke påta seg oppdraget med angitte betingelser/data] [Kan påta seg oppdraget] Velg annen leverandør av tjenesten Korriger oppdraget [Kan ikke påta seg oppdraget] [Kan påta seg endret oppdrag] [Kan ikke endre oppdraget] Motta Betinget Bekreftelse [Kan endre oppdraget] Korriger betingelser/ data Merknad: En Betinget Bekreftelse må bekreftes fra oppdragsgiver i form av et nytt Transportoppdrag. Generer og send Betinget Bekreftelse Motta Avslått Transportoppdrag Generer og send Avslått Transportoppdrag Motta Transportoppdrag Bekreftelse Generer og send Transportoppdrag Bekreftelse Side 6
2.1.3.2 Svare på forespørsel om transport Svar på forespørsel om transport Transportledelse [Har et virkesparti som skal kjøres] Registrer nødvendige opplysninger om oppdraget (opprett innkjøpsordre) Generer og send Transportoppdrag Transportoppdrag Motta Transportoppdrag [Kan ikke påta seg oppdraget med angitte betingelser/data] [Kan påta seg oppdraget] [Kan ikke påta seg oppdraget] [Kan påta seg endret oppdrag] Korriger betingelser/ data Generer og send Betinget Bekreftelse Motta Betinget Bekreftelse Generer og send Avslått Transportoppdrag Motta Avslått Transportoppdrag Motta Transportoppdrag Bekreftelse Generer og send Transportoppdrag Bekreftelse Side 7
2.1.3.3 Registrere et transportoppdrag 2.1.4 Behandle meldingen Transportoppdrag Hvordan meldingen skal behandles, avhenger av verdien av statusattributtene på meldings-, hode- og spesifikasjonsnivå. Status på meldingsnivå påvirker mulig status på hode- og spesifikasjonsnivå. Ved første gangs utsendelse skal status på melding, hode og spesifikasjon settes lik Ny. Transportselskapet svarer på denne meldingen med en og status satt til Akseptert. Et transportselskap kan avvise et Transportoppdrag dersom informasjonen ikke tilfredsstiller kravene i standarden. Transportselskapet svarer da med meldingen BusinessAcknowledge og status satt til Avvist. Årsak skal angis. Et transportselskap kan avvise et Transportoppdrag dersom det er feilsendt (inneholder opplysninger som ikke er gjenkjennbare for oppdragsgiver). Transportselskapet svarer da med meldingen BusinessAcknowledge og status satt til Feil. Årsak skal angis. Et transportselskap kan avslå et Transportoppdrag dersom de ikke har kapasitet eller av andre grunner ikke ønsker å påta seg oppdraget. Transportselskapet svarer da med meldingen og status satt til Avslått. Årsak skal angis. Et transportselskap kan foreslå endring i mengder og tider i et Transportoppdrag dersom de ikke har kapasitet eller av andre grunner ikke kan tilfredsstille betingelsene i oppdraget. Transportselskapet svarer da med meldingen og status satt til Betinget. Årsak skal angis. 2.1.4.1 Statusverdier som benyttes Nivå Attributt Verdi Melding troppdrbekrstatus Akseptert Oppdraget er akseptert Avslått Oppdraget er avslått Betinget Oppdraget kan aksepteres med de foreslåtte endringer Ny Indikerer at dette er første forsendelse av inneholdende originale data. Endret Indikerer at innholdet i meldingen er endret i forhold til første versjon/forsendelse. Side 8
Kansellert Utsteder har kansellert denne meldingen. Hode troppdrbekrhodestatus Akseptert Oppdraget er akseptert Avslått Oppdraget avslås på grunn av betingelser i TroppdrHode Ny Indikerer at dette er originale data. Endret Indikerer at innholdet i TroppdrbekrHode er endret i forhold til første versjon/forsendelse. Kansellert Utsteder har kansellert denne meldingen. Ingen Ingen aksjoner er nødvendig for denne delen av meldingen. Brukes dersom andre deler av meldingen er endret. Spesifikasjon troppdrbekrspesstatus Akseptert Oppdraget er akseptert Avslått Oppdraget avslås på grunn av betingelser i TroppdrbekrSpesifikasjoner Ny Indikerer at dette er originale data. Endret Indikerer at innholdet i TroppdrHode er endret i forhold til første versjon/forsendelse. Kansellert Utsteder har kansellert denne meldingen. Ingen Ingen aksjoner er nødvendig for denne delen av meldingen. Brukes dersom andre deler av meldingen er endret. 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). Side 9
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 undertrykt (+ til høyre angir at strukturen kan åpnes). Elementer kan forekomme utenfor den komplekse gruppeboksen hvis de er utvidelser av den definerte datatypen. 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 10
3 Side 11
3.1 Rot-element Rot-elementet består av følgende attributter: MeldingVersjon Gjeldende versjon er 2.0 troppdrbekrtype Gyldige verdier er: OppdragBekreftelse ForespørselSvar Bekreftelse TroppdrbekrStatus Se 2.1.4.1 eller Data Dictionary for gyldige verdier. meldingomsending Indikeret at dokumentet er sendt på nytt uten at det er foretatt endringer i opplysningene. Benyttes dersom en mottager ber om å få sendt dokumentet på nytt. Ja eller Nei. Standardverdi er Nei. Dersom opplysningen mangler i dokumentet, skal standardverdi benyttes. Rotelementet Transportoppdrag består av følgende elementer: TroppdrbekrHode TroppdrbekrSpesifikasjoner 3.2 TroppdrbekrHode TroppdrbekrHode består av følgende attributter: TroppdrbekrHodeStatusType Se 2.1.4.1 eller Data Dictionary for gyldige verdier. TroppdrbekrHode består av følgende elementer: DokumentId Unik identifikasjon av meldingen Avsender Hvilken organisasjon som er utsteder/avsender av denne meldingen. Mottaker Hvilken organisasjon som er mottager av denne meldingen. Melding Mulighet for å legge inn en melding til mottaker. Vareleverandør Hvilken organisasjon som er vareleverandør. Hentested Hvor varen (virket) skal hentes. 3.3 TroppdrbekrSpesifikasjoner En melding kan bestå av flere spesifikasjoner. Minimum en spesifikasjon må forekomme. TroppdrSpesifikasjoner består av følgende attributter: troppdrbekrspesstatus - Se 2.1.4.1 eller Data Dictionary for gyldige verdier. TroppdrSpesifikasjoner består av følgende elementer: SpesLinjenr Linjenummer for denne spesifikasjonen. Sammen med DokumentId vil SpesLinjenr være en unik identifikasjon av denne spesifikasjonen. Varemottaker Hvem som er mottaker av varen. Side 12
Leveringssted Angir hvor varen skal leveres. Sortiment Hvilken vare som skal transporteres. AnnetKvantum Mulighet til å oppgi totalkvantum for denne spesifikasjonen (summen av periodekvantum). PeriodeKvantum Mulighet for å oppgi transportkvantum pr. periode. TroppdrMaling Spesifikasjon av hvordan måling skal foretas. Side 13
4 Eksempler på forretningsmessig bruk av meldingen Eksempler på hvordan statustyper brukes i forbindelse med meldingen Transportoppdrag. I beskrivelsene nedenfor, er det bare vist eksempler for meldingsflyt mellom oppdragsgiver (i hovedsak kjøper i første handelsledd) og transportledelse. Meldingsflyt mellom andre aktører vil være tilsvarende. Modellen blir generell ved å benytte Avsender og Mottager som roller, men det ikke gitt at alle scenarier vil være aktuelle for alle aktører. Når det gjelder forespørsel om transport, blir bruken lik de scenarier som er beskrevet her, men oppdraget vil ikke bli opprettet i transportledelsens system. Scenario A Scenario B Scenario C Scenario D Nytt Transportoppdrag fra oppdragsgiver, bekreftet fra transportledelsen Nytt Transportoppdrag fra oppdragsgiver, avvist av transportledelsen Nytt Transportoppdrag fra oppdragsgiver, deretter kansellering Nytt Transportoppdrag fra oppdragsgiver, betinget bekreftelse fra transportledelsen Scenario E Endring av Transportoppdrag fra oppdragsgiver I beskrivelsene benyttes Business Ack. Dette er bekreftelse som kan sendes for å bekrefte at en melding er mottatt av mottagende system (meldingen er overført). Side 14
4.1 Scenario A Melding Scenario Nytt Transportoppdrag fra oppdragsgiver, bekreftet fra transportledelsen Resultat Initiator Mottager Forutsetninger Trigger Stepp 1 Stepp 2 Transportoppdrag legges inn transportledelsens system Transportledelse (transportselskap) Ingen har utstedt et Transportoppdrag til transportledelsen for transport Transportoppdrag til Transportledelsen (oppdragstaker). Statusfelter i meldingen: TroppdrStatus = Ny TroppdrHodeStatus = Ny TroppdrSpesStatus = Ny Transportledelsen sender til oppdragsgiver. Statusfelter i meldingen: troppdrbekrstatus = Akseptert troppdrbekrhodestatus = Akseptert troppdrbekrspesstatus = Akseptert Side 15
4.2 Scenario B Melding Scenario Nytt Transportoppdrag fra oppdragsgiver, avvist av transportledelsen Transportledelse Mottar Transportoppdrag Mottar BusinessAcknowledge Resultat Initiator Mottager Forutsetninger Trigger Stepp 1 Stepp 2 Transportoppdrag inneholder feil og er ikke akseptert som en gyldig melding Transportledelse (transportselskap) Transportoppdrag inneholder feil som fører til at transportledelsen ikke kan gjenkjenne meldingen som gyldig i sitt system. Ingen for transport Transportoppdrag til Transportledelsen (oppdragstaker). Statusfelter i meldingen: TroppdrStatus = Ny TroppdrHodeStatus = Ny TroppdrSpesStatus = Ny Transportledelsen svarer med BusinessAcknowledge. Statusfelter i meldingen: BusinessAckStatus = Avvist Side 16
4.3 Scenario C Melding Scenario Kansellering av transportoppdrag Transportledelse Mottar Transportoppdrag BusinessAcknowledge Mottar BusinessAcknowledge Resultat Initiator Mottager Forutsetninger Trigger Stepp 1 Stepp 2 Transportoppdrag slettes/tilbakekalles fra transportledelsens system Transportledelse (transportselskap) har utstedt et transportoppdrag som er akseptert av transportledelsen Transportoppdrag er sendt til feil adressat eller skal, av andre grunner, tilbakekalles eller slettes. sender Transportoppdrag til transportledelsen. Statusfelter i meldingen: TroppdrStatus = Kansellert TroppdrHodeStatus = Kansellert TroppdrSpesStatus = Kansellert Transportledelsen sender til oppdragsgiver. Statusfelter i meldingen: troppdrbekrstatus = Akseptert troppdrbekrhodestatus = Akseptert troppdrbekrspesstatus = Akseptert Side 17
4.4 Scenario D Melding Scenario Nytt Transportoppdrag fra oppdragsgiver, betinget bekreftelse fra transportledelsen Resultat Initiator Mottager Forutsetninger Trigger Stepp 1 Stepp 2 Transportoppdrag returneres til oppdragsgiver med endrede betingelser, opprettes ikke i transportledelsens system Transportledelse (transportselskap) Transportledelsen kan ikke oppfylle betingelsene i oppdraget, men kan påta seg oppdraget dersom betingelser endres. har utstedt et transportoppdrag til transportledelsen for transport Transportoppdrag til Transportledelsen (oppdragstaker). Statusfelter i meldingen: TroppdrStatus = Ny TroppdrHodeStatus = Ny TroppdrSpesStatus = Ny Transportledelsen sender til oppdragsgiver. Statusfelter i meldingen: TroppdrbekrStatus = Betinget TroppdrbekrHodeStatus = Endret eller Ingen avhengig av om innholdet i meldingshodet er endret eller ikke. TroppdrbekrSpesStatus = Endret eller Ingen avhengig om innholdet i meldingsspesifikasjonen er endret eller ikke. Side 18
4.5 Scenario E Melding Scenario Endring av Transportoppdrag Transportledelse Mottar Transportoppdrag BusinessAcknowledge Mottar BusinessAcknowledge Resultat Initiator Mottager Forutsetninger Trigger Stepp 1 Stepp 2 Endrings i et transportoppdrag bekreftes mot oppdragsgiver. Transportledelse (transportselskap) har utstedt et transportoppdrag som er akseptert av transportledelsen utsteder en endring av et transportoppdrag sender Transportoppdrag til transportledelsen. Statusfelter i meldingen: TroppdrStatus = Endret TroppdrHodeStatus = Endret eller Ingen avhengig av om innholdet i meldingshodet er endret eller ikke TroppdrSpesStatus = = Endret eller Ingen avhengig av om innholdet i meldingsspesifikasjonen er endret eller ikke. Transportledelsen sender til oppdragsiver. Statusfelter i meldingen: TroppdrbekrStatus = Akseptert TroppdrbekrHodeStatus = Akseptert TroppdrbekrSpesStatus = Akseptert Side 19