Transaksjonsstandard for virkesomsetningen i Norge. Transportert virke. Versjon 2.0. Desember 2007 SKOG-DATA AS

Transkript

1 Transaksjonsstandard for virkesomsetningen i Norge Transportert virke Versjon 2.0 Desember 2007 SKOG-DATA AS

2 Innhold 1 INNLEDNING 3 2 DOKUMENTASJON AV MELDING OM TRANSPORTERT VIRKE Oversikt Meldingstyper TransportertVirke forretningsregler Regler for meldingstypen TransportertVirke Samhandling Transport av virke solgt gjennom salgsorganisasjon (to handelsledd) Transport av virke solgt gjennom flere handelsledd Behandle meldingen TransportertVirke Statusverdier som benyttes Hvordan lese diagrammene 6 3 LAYOUT PÅ TRANSPORTERTVIRKE TransportertVirke Rot-element TrvirkHode TrvirkSpesifikasjoner 10 4 EKSEMPLER PÅ FORRETNINGSMESSIG BRUK AV MELDINGEN Scenario A Scenario B Scenario C Scenario D 15 Side 2

3 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 melding om transportert virke Beskrivelsen i dette dokumentet er ikke komplett med tanke på tekniske spesifikasjoner. Det henvises til dokumentet Transportert virke XML Schema for detaljert teknisk dokumentasjon. Ferdig schema kan lastes ned (TransportertVirke.xsd). Beskrivelse av alle elementer finnes i dokumentet Data Dictionary. I den videre beskrivelsen brukes betegnelsen TransportertVirke om denne meldingen. 2.1 Oversikt TransportertVirke er en melding fra transportledelsen (ofte transportselskapet) om varer (virke) som er transportert fra spesifisert hentested til spesifisert leveringssted. Dokumentet inneholder opplysninger om transportavstand og eventuelle tilleggstjenester (lossing, kipping) som transportøren har utført for å kunne gjennomføre transporten. TransportertVirke inkluderer: Referanse til oppdragsgivers transportoppdrag Hvem som er oppdragsgiver og hvilke andre aktører som er berørt Varetyper og mengder som er transportert Tidspunkt for når transporten er gjennomført Meldingstyper Det finnes kun en meldingstype for TransportertVirke TransportertVirke forretningsregler Den etterfølgende tabellen lister hvilke forretningsregler som gjelder for hver meldingstype Regler for meldingstypen TransportertVirke Referanse Regel TransportertVirke har alltid en mottaker og en avsender TransportertVirke har alltid en aktør med rolle Transportør TransportertVirke må inneholde minst ett element av TrvirkSpesifikasjoner Samhandling 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. Side 3

4 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 Transport av virke solgt gjennom salgsorganisasjon (to handelsledd) Samhandlingen forutsetter at det er kjøper i første handelsledd som initierer (er oppdragsgiver for) transport. Transportledelsen mottar en lasskvittering fra transportør. Lasskvitteringen er enten registrert på PDA eller via WEB-løsning. På bakgrunn av lasskvitteringen sendes TransportertVirke til oppdragsgiver, vareleverandør og varemottaker. Kopi går til den organisasjon som skal utføre måling. Ved salg gjennom ett handelsledd, vil det bli en meldingsmottaker mindre (oppdragsgiver og varemottager vil være samme organisasjon). Side 4

5 Transport av virke solgt gjennom flere handelsledd. Transportert Virke Oppdragsgiver / Handelsledd Neste handelsledd Motta Transportert Virke Varer er videresolgt Generer og send Transportert Virke TransportertVirke Motta Transportert Virke Under forutsetning av at det er første kjøper som initierer transport, må TransportertVirke sendes fra handelsledd til handelsledd fram til selger i siste handelsledd Behandle meldingen TransportertVirke 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 Original. Oppdragsgiver kan svare på denne meldingen med en bekreftelse (Business Acknowledge). Denne meldingen er ikke påkrevd og skal kun benyttes etter avtale mellom partene. En oppdragsgiver kan avvise en TransportertVirke dersom informasjonen ikke tilfredsstiller kravene i standarden. Oppdragsgiver svarer da med meldingstype Business Acknowledge og status satt til Avvist. En oppdragsgiver kan avvise en TransportertVirke dersom den er feilsendt (inneholder opplysninger som ikke er gjenkjennbare for oppdragsgiver). Oppdragsgiver svarer da med meldingstype Business Acknowledge og status satt til Avvist Statusverdier som benyttes Nivå Attributt Verdi Melding TrvirkStatus Endret Indikerer at innholdet i meldingen er endret i forhold til første versjon/forsendelse. Kansellert Utsteder har kansellert denne meldingen. Ny Indikerer at dette er første forsendelse av TransportertVirke inneholdende originale data. Hode TrvirkHodeStatus Endret Indikerer at innholdet i TrvirkHode er endret i forhold til første versjon/forsendelse. Ingen Ingen aksjoner er nødvendig for denne delen av meldingen. Brukes dersom andre deler av meldingen er endret. Kansellert Utsteder har kansellert denne meldingen. Ny Indikerer at dette er originale data. Side 5

6 Spesifikasjon TrvirkSpesStatus Endret Indikerer at innholdet i TrvirkHode er endret i forhold til første versjon/forsendelse. Ingen Ingen aksjoner er nødvendig for denne delen av meldingen. Brukes dersom andre deler av meldingen er endret. Kansellert Utsteder har kansellert denne meldingen. Ny Indikerer at dette er originale data. 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. 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

7 3 Layout på TransportertVirke Side 7

8 3.1 TransportertVirke Rot-element Rot-elementet TransportertVirke består av følgende attributter: MeldingVersjon Gjeldende versjon er 2.0 TrvirkStatus Se og Data Dictionry 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. Rot-elementet TransportertVirke består av følgende elementer: TrvirkHode TrvirkSpesifikasjoner Side 8

9 3.2 TrvirkHode TrvirkHode består av følgende attributter: TrvirkHodeStatus Se og Data Dictionry for gyldige verdier TrvirkHode 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 mottager av denne meldingen. Vareleverandør Hvilken organisasjon som er vareleverandør. DokumentRefranse Referanse til andre dokumenter. Registrert Dato og eventuell tid når informasjonen ble registrert. Utfort Dato og eventuell tid når transport ble utført. Endret Dato og eventuell tid når informasjon ble endret. AnnenDato Felt for å angi andre dato/tid elementer enn de som ser spesifikt navngitt. Se Data Dictionary for gyldige verdier. Hentested Hvor varen (virket) er hentet. Leveringssted Hvor varen er levert. Transportavstand Kjørelengde. BK BK-kode og tilhørende tekst Kipping Påført kode for kipping Lossing Påført kode for lossing TransportSone Angitt transportsone KjoreprisOppgitt Kode som angir om transportør har påført kjørepris. Terminal Identifiserer terminal hvis aktuelt. FerdigKjørt Kode (Ja/Nei) som forteller om dette var siste lass. Melding Plass for fritekst Jernbanevogn Referanse til jernbanevogn Side 9

10 3.3 TrvirkSpesifikasjoner Det skal alltid være minst en spesifikasjon (vare eller sortiment). Ved transport av flere sortimenter, angis en spesifikasjon pr. sortiment. TrvirkSpesifikasjoner består av følgende attributter: TrvirkSpesStatus Se og Data Dictionry for gyldige verdier TrvirkSpesifikasjoner består av følgende elementer: SpesLinjenr Linjenummer for denne spesifikasjonen. Sammen med DokumentId vil SpesLinjenr være en unik identifikasjon av denne spesifikasjonen. DokumentSpesReferanse Referanse til spesifikasjonslinje i et annet dokument Sortiment Hvilken vare (sortiment) denne spesifikasjonen gjelder for Kvantum Mengde av varen. Det er mulig å oppgi flere kvantum, for eksempel kubikkmeter og antall stokker. Side 10

11 4 Eksempler på forretningsmessig bruk av meldingen Eksempler på hvordan statustyper brukes i forbindelse med meldingen TransportertVirke. I beskrivelsene nedenfor er det bare vist eksempler for meldingsflyt mellom transportledelse og oppdragsgiver. 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. Scenario A Scenario B Scenario C Ny TransportertVirke fra transportledelse (Utsteder) Ny TransportertVirke fra transportledelse, avvist av oppdragsgiver Ny TransportertVirke fra transportledelse, deretter kansellering Scenario D Endring av TransportertVirke I beskrivelsene benyttes Business Ack. Dette er bekreftelse som sendingsprotokollen bruker for å bekrefte at en melding er mottatt av mottagende system (meldingen er overført). Side 11

12 4.1 Scenario A Melding TransportertVirke Scenario Ny TransportertVirke fra transportledelse Resultat Utsteder Mottager Forutsetninger Trigger Stepp 1 TransportertVirke legges inn oppdragsgivers system Transportledelse (transportselskap) Oppdragsgiver Det forutsettes at oppdragsgiver har sendt en Transportordre og at denne er godtatt av transportselskap. Mottatt Lasskvittering Transportledelse sender original TransportertVirke til mottaker. Statusfelter i meldingen: TrvirkStatus = Ny TrvirkHodeStatus = Ny TrvirktSpesStatus = Ny Side 12

13 4.2 Scenario B Melding TransportertVirke Scenario Ny TransportertVirke fra transportledelse, avvist av mottager Resultat Utsteder Mottager Forutsetninger Trigger Stepp 1 Stepp 2 TransportertVirke inneholder feil og er ikke akseptert som en gyldig melding Transportledelse (transportselskap) Oppdragsgiver TransportertVirke inneholder feil som fører til at oppdragsgiver ikke kan kjenne igjen melding som gyldig i sitt system. Mottatt Lasskvittering Transportledelse sender original TransportertVirke til mottaker. Statusfelter i meldingen: TrvirkStatus = Ny TrvirkHodeStatus = Ny TrvirktSpesStatus = Ny Mottager returnerer meldingen BusinessAcknoeldge til utsteder. Statusfelter i meldingen: BusinessackStatus = Avvist Side 13

14 4.3 Scenario C Melding TransportertVirke Scenario Ny TransportertVirke fra transportledelse, deretter kansellering Resultat Utsteder Mottager Forutsetninger Trigger Stepp 1 Stepp 2 TransportertVirke slettes/tilbakekalles fra oppdragsgivers system Transportledelse (transportselskap) Oppdragsgiver TransportertVirke er sendt til feil addressat eller skal, av andre grunner, tilbakekalles eller slettes. Mottatt Lasskvittering og deretter oppdaget feil som krever kansellering Transportledelse sender original TransportertVirke til mottaker. Statusfelter i meldingen: TrvirkStatus = Ny TrvirkHodeStatus = Ny TrvirktSpesStatus = Ny Transportledelse sender TransportertVirke til mottager. Statusfelter i meldingen: TrvirkStatus = Kansellert TrvirkHodeStatus = Kansellert TrvirkSpesStatus = Kansellert Side 14

15 4.4 Scenario D Melding TransportertVirke Scenario Endring av TransportertVirke Resultat Utsteder Mottager Forutsetninger Trigger Stepp 1 Stepp 2 TransportertVirke endres i oppdragsgivers system. Transportledelse (transportselskap) Oppdragsgiver Det er oppdaget feil i meldingsinnholdet. Mottatt Lasskvittering og deretter oppdaget feil som krever endring Transportledelse sender original TransportertVirke til mottaker. Statusfelter i meldingen: TrvirkStatus = Ny TrvirkHodeStatus = Ny TrvirkSpesStatus = Ny Transportledelse sender TransportertVirke til mottager. Statusfelter i meldingen: TrvirkStatus = Endret TrvirkHodeStatus = Endret eller Ingen avhengig om innholdet i meldingshodet er endret eller ikke. TrvirkSpesStatus = Endret eller Ingen avhengig om innholdet i meldingsspesifikasjonen er endret eller ikke. Side 15