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 Meldinger 3 2.1.2 forretningsregler 3 2.1.3 Samhandling 4 2.1.3.1 Bestille (initiere) transport 5 2.1.3.2 Forespørre om transport 6 2.1.4 Behandle meldingen 6 2.1.4.1 Statusverdier som benyttes 7 2.2 Hvordan lese diagrammene 7 3 9 3.1 Rot-element 10 3.2 TroppdrHode 10 3.3 TroppdrSpesifikasjoner 10 4 Eksempler på forretningsmessig bruk av meldingen 12 4.1 Scenario A 13 4.2 Scenario B 14 4.3 Scenario C 15 4.4 Scenario D 16 4.5 Scenario E 17 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 oppdragsgiver for tømmertransporten til et transportselskap. et spesifiserer hvilke leveringssteder virket skal transporteres til og en plan for hvilke mengder som skal transporteres i angitte tidsperioder. inkluderer: Hvem som er oppdragsgiver og hvilke andre aktører som er berørt Varetyper og mengder som skal transporteres Planlagt tidspunkt for når transporten skal gjennomføres 2.1.1 Meldinger Meldingen sendes av oppdragsgiver til transportselskapet (transportselskap er i denne sammenheng en rolle). Meldingstypen (TroppdrType) angir funksjon: TroppdrType = Oppdrag Bestilling/ordre på transportoppdrag. TroppdrType = Forespørsel Forespørsel om transport. 2.1.2 forretningsregler Den etterfølgende tabellen lister hvilke forretningsregler som gjelder for meldingen. Referanse Regel har to meldingstyper (TroppdrType): Oppdrag og Forespørsel Et kan ha kun en vareleverandør, men det kan spesifiseres flere geografiske hentesteder. må inneholde minst ett element av spesifikasjoner (TroppdrSpesifikasjoner). En TroppdrSpesifikasjon kan ha kun en varemottaker. Skal samme vare transporteres til forskjellige varemottakere, må det etableres en troppdrspesifikasjon for hver varemottaker. Et spesifikasjonselement skal tildeles et unikt linjenummer (TroppdrSpesLinjenr) 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 Dersom status på meldingsnivå = Ny, må status på hode- og spesifikasjonsnivå også Side 3
2.1.3 Samhandling 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 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. 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 4
2.1.3.1 Bestille (initiere) transport Initiere Transport Transportledelse [Har et virkesparti som skal kjøres] Registrer nødvendige opplysninger om oppdraget (opprett innkjøpsordre) Generer og send Motta [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. Bekreftelse Generer og send Betinget Bekreftelse Motta Avslått Bekreftelse Generer og send Avslått Motta Bekreftelse Bekreftelse Generer og send Bekreftelse Side 5
2.1.3.2 Forespørre om transport Forespørre Transport Transportledelse [Har et virkesparti som skal kjøres] Registrer nødvendige opplysninger om oppdraget (opprett innkjøpsordre) Generer og send Motta [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 Bekreftelse Generer og send Betinget Bekreftelse Motta Betinget Bekreftelse Bekreftelse Generer og send Avslått Motta Avslått Motta Bekreftelse Bekreftelse Generer og send Bekreftelse 2.1.4 Behandle meldingen 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 Bekreftelse og status satt til Akseptert. Et transportselskap kan avvise et dersom informasjonen ikke tilfredsstiller kravene i standarden. Transportselskapet svarer da med meldingen BusinessAcknowledge og status satt til Avvist. Årsak skal angis. Side 6
Et transportselskap kan avvise et 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 dersom de ikke har kapasitet eller av andre grunner ikke ønsker å påta seg oppdraget. Transportselskapet svarer da med meldingen Bekreftelse og status satt til Avslått. Årsak skal angis. Et transportselskap kan foreslå endring i mengder og tider i et dersom de ikke har kapasitet eller av andre grunner ikke kan tilfredsstille betingelsene i oppdraget. Transportselskapet svarer da med meldingen Bekreftelse og status satt til Betinget. Årsak skal angis. 2.1.4.1 Statusverdier som benyttes Nivå Attributt Verdi Melding TroppdrStatus 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. Kansellert Utsteder har kansellert denne meldingen. Hode TroppdrHodeStatus 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. Spesifikasjon TroppdrSpesStatus Ny Indikerer at dette er originale data. Endret Indikerer at innholdet i TroppdrSpesifikasjoner er endret i forhold til første versjon/forsendelse. Kansellert Utsteder har kansellert denne spesifikasjonen. Ingen Ingen aksjoner er nødvendig for denne spesifikasjonen. 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. Side 7
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 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 8
3 Side 9
3.1 Rot-element Rot-elementet består av følgende attributter: MeldingVersjon Gjeldende versjon er 2.0 TroppdrType Angir om det er en "Forespørsel" om mulig transport eller om det er et "Oppdrag". TroppdrStatus Se 2.1.4.1 for gyldige verdier. meldingomsending Indikerer at dokumentet er sendt på nytt uten at det er foretatt endringer i opplysningene. Benyttes derom en Mottaker ber om å få sendt dokumentet på nytt. Ja eller Nei. Standardverdi er Nei. Dersom opplysningen mangler i dokumentet, skal standardverdi benyttes. Rotelementet består av følgende elementgrupper: TroppdrHode TroppdrSpesifikasjoner 3.2 TroppdrHode TroppdrHode består av følgende attributter: TroppdrHodeStatus Se 2.1.4.1 for gyldige verdier. TroppdrHode består av følgende elementer: DokumentId Unik identifikasjon av meldingen Avsender Hvilken organisasjon som er utsteder av denne meldingen. Mottaker Hvilken organisasjon som er Mottaker av denne meldingen. Vareleverandør Hvilken organisasjon som er vareleverandør. Hentested Hvor varen (virket) skal hentes. 3.3 TroppdrSpesifikasjoner Et kan bestå av flere spesifikasjoner. Minimum en spesifikasjon må forekomme. TroppdrSpesifikasjoner består av følgende attributter: TroppdrSpesStatus Se 2.1.4.1 for gyldige verdier. TroppdrSpesifikasjoner består av følgende elementer: SpesLinjenr Linjenummer for denne spesifikasjonen. Sammen med TroppdrNummer vil TroppdraSpesLinjenr være en unik identifikasjon av denne spesifikasjonen. Varemottaker Hvem som er mottaker av varen. 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 Side 10
transportkvantum pr. periode. TroppdrMaling Spesifikasjon av hvordan måling skal foretas. Side 11
4 Eksempler på forretningsmessig bruk av meldingen Eksempler på hvordan statustyper brukes i forbindelse med meldingen. 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 Mottaker 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 fra oppdragsgiver, bekreftet fra transportledelsen Nytt fra oppdragsgiver, avvist av transportledelsen Nytt fra oppdragsgiver, deretter kansellering Nytt fra oppdragsgiver, betinget bekreftelse fra transportledelsen Scenario E Endring av 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 12
4.1 Scenario A Melding Scenario Nytt fra oppdragsgiver, bekreftet fra transportledelsen Resultat Utsteder Mottaker Forutsetninger Trigger Steg 1 Steg 2 legges inn transportledelsens system Transportledelse (transportselskap) Ingen sender original til transportledelsen. Statusfelter i meldingen: TroppdrStatus = Ny TroppdrHodeStatus = Ny TroppdrSpesStatus = Ny Transportledelsen sender Bekreftelse til oppdragsgiver. Statusfelter i meldingen: TroppdrbekrStatus = Akseptert TroppdrbekrHodeStatus = Akseptert TroppdrbekrSpesStatus = Akseptert Side 13
4.2 Scenario B Melding Scenario Nytt fra oppdragsgiver, avvist av transportledelsen Transportledelse Mottar Mottar BusinessAcknowledge Resultat Utsteder Mottaker Forutsetninger Trigger Steg 1 Steg 2 inneholder feil og er ikke akseptert som en gyldig melding Transportledelse (transportselskap) inneholder feil som fører til at transportledelsen ikke kan kjenne igjen melding som gyldig i sitt system. Ingen sender original til transportledelsen. Statusfelter i meldingen: TroppdrStatus = Ny TroppdrHodeStatus = Ny TroppdrSpesStatus = Ny Transportledelsen svarer med BusinessAcknowledge. Statusfelter i meldingen: BusinessAckStatus = Avvist Side 14
4.3 Scenario C Melding Scenario Nytt fra oppdragsgiver, deretter kansellering Transportledelse Mottar BusinessAcknowledge Mottar Bekreftelse BusinessAcknowledge Resultat Utsteder Mottaker Forutsetninger Trigger Steg 1 Steg 2 opprettes og deretter slettes/tilbakekalles fra transportledelsens system Transportledelse (transportselskap) har utstedt transportoppdrag som er akseptert av transportledelsen. er sendt til feil adressat eller skal, av andre grunner, tilbakekalles eller slettes. sender til transportledelsen. Statusfelter i meldingen: TroppdrStatus = Kansellert TroppdrHodeStatus = Kansellert TroppdrSpesStatus = Kansellert Transportledelsen sender Bekreftelse til oppdragsgiver. Statusfelter i meldingen: TroppdrbekrStatus = Akseptert TroppdrbekrHodeStatus = Akseptert TroppdrbekrSpesStatus = Akseptert Side 15
4.4 Scenario D Melding Scenario Nytt fra oppdragsgiver, betinget bekreftelse fra transportledelsen Resultat Utsteder Mottaker Forutsetninger Trigger Steg 1 Steg 2 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. Ingen sender original til transportledelsen. Statusfelter i meldingen: TroppdrStatus = Ny TroppdrHodeStatus = Ny TroppdrSpesStatus = Ny Transportledelse sender Bekreftelse til oppdragsgiver. Statusfelter i meldingen: TroppdrbekrStatus = Betinget TroppdrbekrHodeStatus = Endret eller Ingen avhengig om innholdet i meldingshodet er endret eller ikke. TroppdrbekrSpesStatus = Endret eller Ingen avhengig om innholdet i meldingsspesifikasjonen er endret eller ikke. Side 16
4.5 Scenario E Melding Scenario Endring av Transportledelse Mottar BusinessAcknowledge Mottar Bekreftelse BusinessAcknowledge Resultat Utsteder Mottaker Forutsetninger Trigger Steg 1 Steg 2 endres i transportledelsens system. Transportledelse (transportselskap) Det er oppstått behov for endring av et transportoppdrag som tidligere er akseptert av transportledelsen Ingen sender til transportledelsen. Statusfelter i meldingen: TroppdrStatus = Endret TroppdrHodeStatus = "Endret eller Ingen avhengig om innholdet i meldingshodet er endret eller ikke. TroppdrSpesStatus = = Endret, Ingen eller "Kansellert avhengig om innholdet i meldingsspesifikasjonen er endret eller ikke. Transportledelsen sender Bekreftelse til oppdragsgiver. Statusfelter i meldingen: TroppdrbekrStatus = Akseptert TroppdrbekrHodeStatus = Akseptert TroppdrbekrSpesStatus = Akseptert Side 17