Sähköisten toimintamallien käytön lisääminen logistiikassa (SÄTKY) Sanomasuositus ja sen yleinen soveltamisohje. Lähetysstatus

Transkriptio

1 Sanomasuositus ja sen yleinen soveltamisohje Lähetysstatus FI1042, , v 1.00 Käyttö: Kuljetus Sanasto: UBL Versio: 2.0 Sanoma: TransportationStatus

2 Sisällysluettelo 1 Sanoma ja sen soveltamisala Sanoman käyttötarkoitus ja soveltamisen rajaus Soveltamisohjeen sisältö Työryhmän työskentelyyn osallistuneet Dokumentti ja sen yhteydet muihin dokumentteihin Päivitykset Esitietovaatimukset Aiheeseen liittyvä aineisto Huomioitavaa Lähetysstatuksen ilmoitusprosessi Prosessin rajaus Prosessin osapuolet Lähetysstatuksen ilmoitusprosessi Sanoman tietosisältö Lähetysstatussanoman rakenne Luokkamalli Sanoman määrittely Sanomataso Lähetysstatussanoma (TransportationStatus. Details) Lähetyksen tiedot ( Consignment) Ilmoituksen lähettäjän tiedot (Consignment. Carrier_ Party. Party) Ilmoituksen lähettäjän tunniste (Party. Party Identification) Ilmoituksen lähettäjän nimi (Party. Party Name) Ilmoituksen vastaanottajan tiedot (Consignment. Notify_ Party. Party) Ilmoituksen vastaanottajan tunniste (Party. Party Identification) Ilmoituksen vastaanottajan nimi (Party. Party Name) Lähetystapahtuman tiedot ( Transport Event) Lähetystapahtuman paikka-, aika- ja mittatiedot (Transport Event. Reported_ Shipment. Shipment) Lähetystapahtuman yksilöintitiedot ( Consignment) Lähetystapahtuman aika- ja paikkatiedot (Shipment. Delivery) Lähetystapahtuman tapahtumapaikka (Delivery. Delivery_ Location. Location) Lähetystapahtuman tapahtumapaikan sijaintitiedot (Location. Address) UBL-TransportationStatus-Lähetysstatus

3 Lähetystapahtuman tapahtumapaikan sijaintikoodinaatit (Address. Location Coordinate) Toimituksen arvioitu saapumisaika (Delivery. Estimated Delivery_ Period. Period) Kuljetuspakkauksen tiedot (Shipment. Transport Handling Unit) Kuljetusyksikön tiedot (Transport Handling Unit. Transport Equipment) Pakkauksen mitta- ja määrätiedot (Transport Handling Unit. Measurement_ Dimension. Dimension) Alhaisin kuljetuksen aikainen havaittu lämpötila (Transport Handling Unit. Minimum_ Temperature. Temperature) Korkein kuljetuksen aikainen havaittu lämpötila (Transport Handling Unit. Maximum_ Temperature. Temperature) Lähetystapahtuman syyn tiedot (Transport Event. Current_ Status. Status) Lähetystapahtumaan liittyvän henkilön tiedot (Transport Event. Contact) Lähetysstatuksen viitteet ( Document Reference) Liitetiedoston tiedot (Document Reference. Attachment) Liitetiedoston web-osoite (Attachment. External Reference) Sanomaesimerkki UBL lähetysstatusanomaesimerkki Liitteet Liite 1: Kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje Liite 2: Z-KOODIT Liite 3: UN/ECE Recommendation N Trade and Transport Status Codes Liite 4: 9013 Status reason description code UBL-TransportationStatus-Lähetysstatus

4 1 Sanoma ja sen soveltamisala 1.1 Sanoman käyttötarkoitus ja soveltamisen rajaus Tämä dokumentti sisältää UBL (Universal Business Language) version 2.0 TransportationStatus sanoman mukaisen sanomakuvauksen ja soveltamisohjeen. Tämä soveltamisohje määrittelee sanoman käytön suomalaisen kuljetusalan ja heidän asiakkaittensa välisessä toiminnassa välitettäessä kuljetuksen statustietoa. Lähetysstatuksesta käytetään toisinaan synonyymejä kuljetusstatus ja kuljetustilanne, mutta tässä soveltamisohjeessa käytetään termiä lähetysstatus. Ilmoitus voidaan antaa lähetystasolla tai kollitasolla tilanteesta riippuen. Tässä sanomassa tietyt tiedot voivat esiintyä sekä otsikko- että rivitasolla. Jos tieto on määritelty otsikkotasolla, vaikuttaa se koko sanomaan kuitenkin niin, että jos sama tieto on määritelty rivitasolla jollakin rivillä, kumoaa tämä kyseisellä rivillä määritelty tieto otsikkotasolla määritellyn tiedon. Sovellusohje on syntynyt Liikenne- ja viestintäministeriön sekä suomalaisten yritysten organisoimassa projektissa Sähköisten toimintamallien käytön lisääminen logistiikassa (SÄTKY). Projekti alkoi ja loppui Soveltamisohjeen on tehnyt TIEKE Tietoyhteiskunnankehittämiskeskus ry. Tämän soveltamisohjeen tarkoituksena on lisätä yritysten halukkuutta ottaa käyttöön UBL/XML-pohjaista sähköistä tiedonsiirtoa, nopeuttaa järjestelmien kehitysprosessia ja vähentää integraatiokustannuksia luomalla yleinen ja yhtäläinen kansallinen suositus. Suosituksella pyritään myös vähentämään tarvetta luoda yritys- tai organisaatiokohtaisia erilaisia suosituksia, jotka eivät välttämättä ole yhteentoimivia. Tavoitteena on myös nopeuttaa uuden tiedonsiirtotavan omaksumista kansainvälisen kilpailukyvyn säilyttämiseksi ja parantamiseksi. Soveltamisohje on tarkoitettu apuvälineeksi yhteistyökumppanien välisiin neuvotteluihin kehitettäessä organisaatioiden välistä sähköistä tiedonsiirtoa. Soveltamisohjetta voidaan käyttää hyväksi kehitettäessä jo olemassa olevien järjestelmien tiedonsiirto-ominaisuuksia. 1.2 Soveltamisohjeen sisältö Kappaleessa 1 Sanoma ja sen soveltamisala on esitetty tämän sanoman ja soveltamisohjeen käyttötarkoitus, soveltamisen rajaus sekä kehityshankkeen työhön osallistuneet yritykset ja organisaatiot sekä niiden henkilöt. Kappaleessa 2 Dokumentti ja sen yhteydet muihin dokumentteihin esitetään tämän dokumentin ymmärrettävään lukemiseen tarvittavat esitietovaatimukset sekä hyödyllisiä linkkejä ja tämän dokumentin päivitystiedot. Kappaleessa 3 Lähetysstatuksen ilmoitusprosessi esitetään tämän soveltamisohjeen pohjana oleva lähetysstatuksen ilmoitusprosessi, sen osapuolet ja vaiheet ilmoitettaessa lähetyksen statusta. UBL-TransportationStatus-Lähetysstatus

5 Kappaleessa 4 Sanoman tietosisältö on esitetty lähetysstatussanomassa välitettävien tietojen luettelo sekä niiden pakollisuus tai valinnaisuus eri kuljetusmuotoja käytettäessä. Kappaleessa 5 "Lähetysstatussanoman rakenne on esitetty tämän UBLtransportationStatus-sanoman luokkamalli käyttäen hyväksi UML-kuvauskieltä. Kappaleessa 6 Sanoman määrittely on esitelty UBL-TransportationStatuslähetysstatussanoman rakenne, käytettävät aggregaatit, elementit, attribuutit ja koodit sekä niiden käyttötarkoitus. Kappaleessa 7 Sanomaesimerkki on esitetty esimerkki UBL-TransportationStatuslähetysstatussanoman käytöstä. Liitteessä on esitetty kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje, sanomassa käytettävät Z-alkuiset koodit, UN/ECE suosituksen 24 (Trade and Transport Status Codes) mukaiset koodit ja UN/EDIFACT hakemiston D.10B koodiston 9013 Status reason description code koodit. 1.3 Työryhmän työskentelyyn osallistuneet Seuraavassa taulukossa on esitetty yritykset ja organisaatiot, jotka ovat osallistuneet Liikenne- ja viestintäministeriön sekä suomalaisten yritysten organisoiman projektin Sähköisten toimintamallien käytön lisääminen logistiikassa (SÄTKY) työhön joko sen ohjaustai projektiryhmässä. Yritys/Organisaatio CHS Holding Oy DB Schenker Oy Henkilö Kaius Perttilä Petri Happonen Ilkka Tirkkonen DSV Road Oy Jukka Iloheimo Marko Tuikkanen Päivi Virkki Edi-soft Finland Oy Elinkeinoelämän keskusliitto EK Elintarviketeollisuusliitto ry Itella Oyj Petri Karjalainen Kyösti Orre Heli Tammivuori Jukka Holm Sari Sirén UBL-TransportationStatus-Lähetysstatus

6 Keslog Oy Logica Suomi Oy Kauko Keskihannu Thomas Häggström Anita Ikonen Logistiikkayritysten liitto ry Pekka Aaltonen Sahti-ryhmä (Logistiikkayritysten liiton Sähköisen tilaamisen edistämisen työryhmä) Liikenne- ja viestintäministeriö Nokian Renkaat Oyj Marko Forsblom Mikko Niininen Ville Nikkola Procomp Solutions Oy Pauli Heikkinen Sanna Peltomaa Rauhala Yhtiöt Oy Jari Lankinen Jukka Sippola Rautaruukki Oyj Harri Hartikainen Tomi Hämäläinen Hannu Juuti Suomen Huolintaliikkeiden Liitto ry TIEKE Tietoyhteiskunnan kehittämiskeskus ry Petri Laitinen Elina Koskentalo Heikki Laaksamo Jari Salo Tuko Logistics Kaarlo Svensson Mikko Aula VR-Yhtymä Oy Kimmo Nykänen Petri Lummepuro Maarit Pitkänen Taulukko 1.3.1: Sähköisten toimintamallien käytön lisääminen logistiikassa (SÄTKY) projektin työryhmätyöskentelyyn osallistuneet UBL-TransportationStatus-Lähetysstatus

7 2 Dokumentti ja sen yhteydet muihin dokumentteihin 2.1 Päivitykset Pvm/Laatija Versio Kommentit/muutokset Heikki Laaksamo 1.00 Ensimmäinen versio 2.2 Esitietovaatimukset Soveltamisohje on tarkoitettu sekä johto- että asiantuntijatason käyttöön. Soveltamisohjeen teknisen taustan ymmärtämistä tukee seuraavien aihealueiden tuntemus: XML, UBL ja ebxml ydinkomponentit. 2.3 Aiheeseen liittyvä aineisto UBL-liiketoimintasanasto ja sähköisten asiakirjojen määrittely (TIEKEn julkaisusarja osa 23) ( ) w3schools XML Tutorial ( ) ebxml Core Components Technical Specification (CCTS) 2.01 ( ) Universal Business Language 2.0 ( NES työryhmän tekemät soveltamisohjeet ( ) United Nations Directories for Electronic Data Interchange for Administration, Commerce and Transport ( ) UN/CEFACT Recommendations ( ) UBL-TransportationStatus-Lähetysstatus

8 2.4 Huomioitavaa Soveltamisohje perustuu UBL version 2.0 TransportationStatus-sanoman määrityksiin. Määrityksissä on noudatettu myös kansainvälisen NES työryhmän suosituksia sanomien tietosisällön ja käytön osalta soveltaen näitä suomalaisen kaupan, teollisuuden ja kuljetusalan tarpeisiin. Soveltamisohjeen tekemisessä on huomioitu myös aiemmin toimineen Kuljetussanoma-työryhmän tekemät suositukset sekä saatavilla olevat kansainväliset suositukset soveltuvin osin. UBL-TransportationStatus-Lähetysstatus

9 3 Lähetysstatuksen ilmoitusprosessi 3.1 Prosessin rajaus Tässä prosessikuvauksessa on tarkasteltu ainoastaan lähetysstatuksen ilmoitusprosessia, jossa tämän dokumentin määrittelemää UN/EDIFACT IFTSTA-sanomaa voidaan käyttää. Tarkastelussa oletetaan, että lähetysstatus välitetään ilmoitusprosessissa sähköisesti osapuolten välillä. Tarkastelusta on jätetty pois lähetystä edeltävät vaiheet, kuten vuositason kuljetussopimusten teko ja siihen liittyvät tarjouspyyntöjen lähetys ja tarjousten teko sekä tilaaminen ja sen vahvistaminen sekä rahtikirjan välitys. Myös varsinaisen lähetystapahtuman jälkeiset vaiheet, kuten laskutus, ovat rajattu tämän tarkastelun ulkopuolelle. 3.2 Prosessin osapuolet Seuraavassa taulukossa on esitetty tämän prosessin osapuolet. Osapuoli Kuljetusyritys Tavaran lähettäjä / Tavaran vastaanottaja / Kolmas osapuoli (agentti, portaali ym.) Rooli Osapuoli, joka ottaa tavaran kuljetettavaksi. Osapuoli, joka on vastuussa kuljetuksen toteuttamisesta. Osapuoli, joka luovuttaa tavaran vastaanottajalle. Osapuoli, lähettää lähetysstatuksen. Osapuoli, joka vastaanottaa lähetysstatuksen. Osapuoli, joka ryhtyy lähetysstatuksen perusteella tarvittaviin toimenpiteisiin. Taulukko 3.2.1: Lähetysstatuksen ilmoitusprosessin osapuolet UBL-TransportationStatus-Lähetysstatus

10 3.3 Lähetysstatuksen ilmoitusprosessi Kuviossa on esitetty lähetysstatuksen ilmoitusprosessin vaiheet eroteltuna kohdassa 3.2 esitettyjen osapuolien toimintojen mukaan. UBL-TransportationStatus-Lähetysstatus

11 Kuvio 3.3.1: Lähetysstatuksen ilmoitusprosessi

12 Seuraavassa taulukossa on selitetty kuviossa esitetyn lähetysstatuksen ilmoitusprosessin vaiheet jaoteltuna osapuolten hoitamien toimintojen mukaan. Osapuoli Toiminta Tavaran lähettäjä / Tavaran vastaanottaja / Kolmas osapuoli (agentti, portaali ym.) Kuljetusyritys Luovutetaan tavara kuljetettavaksi Vastaanotetaan lähetysstatuksen ilmoitus Lähetysstatusilmoituksen käsittely Vastaanotetaan tavara Kuljetustilauksen hyväksyminen Tavaran nouto Kuljetus Lähetysstatuksen luominen Lähetysstatuksen välittäminen Tavaroiden luovutus vastaanottajalle Perilletoimitusilmoituksen välittäminen Tavaran lähettäjä luovuttaa tavaran kuljetusliikkeelle kuljetettavaksi. Tavaran lähettäjä, tavaran vastaanottaja ja tai kolmas osapuoli vastaanottaa lähetysstatuksen ilmoituksen sähköisesti. Tavaran lähettäjä, tavaran vastaanottaja ja tai kolmas osapuoli käsittelee lähetysstatusilmoituksen ja ryhtyy sen vaatimiin toimenpiteisiin. Tavaran vastaanottaja vastaanottaa tavaran. Kuljetusyritys hyväksyy kuljetustilauksen ja aloittaa kuljetuksen järjestelyn. Kuljetusliike toimittaa kuljetuskaluston sovitusti tavaran noutopaikalle ja ottaa tavaran kuljetettavakseen. Kuljetusliike kuljettaa tavaran kuljetustilauksen ja rahtikirjassa määritellyn toimeksiannon mukaisesti. Kuljetusliike luo lähetysstatuksen omissa järjestelmissään, kun lähetystilanne sen vaatii. Kuljetusliike välittää lähetysstatuksen sähköisesti tavaran lähettäjälle, tavaran vastaanottajalle ja/tai kolmannelle osapuolelle. Kuljetusliike luovuttaa sovitusti tavaran vastaanottajalleen. Kuljetusliike ilmoittaa tavaran lähettäjälle tai kolmannelle osapuolelle toimittaneensa tavarat perille. Taulukko 3.3.1: Lähetysstatuksen ilmoitusprosessin osapuolikohtaiset vaiheet UBL-TransportationStatus-Lähetysstatus

13 4 Sanoman tietosisältö Seuraavassa taulukossa on esitetty lähetysstatussanoman tietosisältö sekä sanoman aggregaatti, jossa kyseinen tieto sijaitsee sanomassa. Neljännessä sarakkeessa on esitetty linkkinä viittaus kappaleessa 6 Sanoman määrittely olevaan kyseistä aggregaattiaesittelevään alakappaleeseen. Neljässä oikeanpuoleisassa sarakkeessa on kuljetusmuotokohtainen esitys kyseisen tiedon pakollisuudesta käytettäessä kyseistä kuljetusmuotoa. Sanoman vastaanottaja voi käyttää vastaanottamansa sanoman tietoja siten, kuin heidän tietojärjestelmänsä sen sallii. Vastaanottajan ei siis tarvitse tallettaa järjestelmäänsä tietoa, joka on soveltamisohjeessa merkitty pakolliseksi, mutta sanoman lähettäjän on aina lähetettävä pakolliseksi merkitty tieto. UBL-TransportationStatus-Lähetysstatus

14 Tieto Huomautus / esimerkki Aggregaatti Kappale Autokuljetus Junakuljetus Merikuljetus Lentokuljetus Lähetysstatuksen tunnus Details P P P P Lähetysstatuksen päivämäärä ja kellonaika Details P P P P Osapuolitiedot Rooli Lähetysstatussanoman lähettäjä Consignment. Carrier_ Party. Party P P P P Lähetysstatussanoman vastaanottaja Consignment. Notify_ Party. Party P P P P Yrityksen tunnus OVT-tunnus tai kuljetusliikkeen ylläpitämän tunnusluettelon mukainen Joko nimi tai tunnus ilmoitettava Consignment. Carrier_ Party. Party. Party Identification Consignment. Notify_ Party. Party. Party Identification E E E E Yrityksen nimi Joko nimi tai tunnus ilmoitettava Consignment. Carrier_ Party. Party. Party Name E E E E UBL-TransportationStatus-Lähetysstatus

15 Consignment. Notify_ Party. Party. Party Name Lähetyksen tapahtumatiedot Kuljetusasiakirjan tunnus Rahtikirja, kuljetusliikkeen käyttämä tunnus Consignment P P P P Lähetystapahtuma koodimuotoisena Transport Event V V V V Saapunut: kuljetusväline on saapunut tiettyyn paikkaan Transport Event V V V V Noudettu Transport Event V V V V Vaurioitunut Transport Event V V V V Myöhässä Transport Event V V V V Toimitettu vastaanottajalle Transport Event V V V V Lähtenyt Transport Event V V V V UBL-TransportationStatus-Lähetysstatus

16 Matkalla Kuljetusmuodon tai yksikön vaihto samassa kuljetusyhtiössä Luovutettu jakoon kolmannelle osapuolelle Lastattu Ei noudettu tavaran lähettäjältä Ei noudettu kuljetettu, mutta vastaanottaja ei ole noutanut tavaraa Puuttuu Paluulogistiikka Transport Event Transport Event Transport Event Transport Event Transport Event Transport Event Transport Event Transport Event V V V V V V V V V V V V V V V V V V V V V V V V V V V V V V V V Lähetystapahtuma tekstimuotoisena Lähetystapahtuman syy koodimuotoisena Transport Event Transport Event. Current_ Status. Status V V V V UBL-TransportationStatus-Lähetysstatus

17 Vaurioitunut Tavara puuttuu Kadonnut Kuljetusväline rikkoontunut Pakkausten tunnisteet puuttuvat Sään aiheuttama Lämpötilapoikkeama Viivakoodit puuttuvat Transport Event. Current_ Status. Status Transport Event. Current_ Status. Status Transport Event. Current_ Status. Status Transport Event. Current_ Status. Status Transport Event. Current_ Status. Status Transport Event. Current_ Status. Status Transport Event. Current_ Status. Status Transport Event. Current_ Status. Status V V V V V V V V V V V V V V V V V V V V V V V V V V V V V V V V Lähetystapahtuman syy tekstimuotoisena Transport Event. Current_ Status. Status V V V V UBL-TransportationStatus-Lähetysstatus

18 Lähetystapahtuman viitetiedot Viitteen tyyppi Document Reference V V V V Rahtikirja Kuljetustilaus Lähetyksen vastaanottajan viite Lähetyksen lähettäjän viite Document Reference Document Reference Document Reference Document Reference V V V V V V V V V V V V V V V V Viiteen tunnus Document Reference V V V V Lähetystapahtuman aikatiedot Ajanilmauksen tyyppi V V V V Tapahtuman ajankohta Lähetyksen arvioitu saapumisajankohta Transport Event. Transport Event. Reported_ Shipment. Shipment. Delivery. Estimated Delivery_ Period V V V V V V V V UBL-TransportationStatus-Lähetysstatus

19 Period Päivämäärä / aika Transport Event V V V V Transport Event. Reported_ Shipment. Shipment. Delivery. Estimated Delivery_ Period. Period Lisätiedot Lähetysstatuksen vapaamuotoinen lisäselite Internet-kuvapankin wwwosoite Rikkoontuneen tavaran tiedot Transport Event. Current_ Status. Status Document Reference. Attachment. External Reference Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit V V V V V V V V V V V V Lähetystapahtuman kuittaaja Kuittaajan yritys Transport Event. Contact V V V V UBL-TransportationStatus-Lähetysstatus

20 Kuittaajan nimi Transport Event. Contact V V V V Lähetystapahtuman paikkatiedot Paikan tunnus koodimuotoisena Paikan nimi tekstimuotoisena Paikan koordinaatit Transport Event. Reported_ Shipment. Shipment. Delivery. Delivery_ Location. Location Transport Event. Reported_ Shipment. Shipment. Delivery. Delivery_ Location. Location Transport Event. Reported_ Shipment. Shipment. Delivery. Delivery_ Location. Location. Address. Location Coordinate V V V V V V V V V V V V Pakkausten tiedot Pakkauksen yksilöivä tunnus Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit V V V V UBL-TransportationStatus-Lähetysstatus

21 Kuljetusyksikön tiedot Kuljetusyksikön tunnus Kuljetusyksikön tyyppi Kuljetusyksikön koko ja tyyppi koodimuotoisena Kuljetusyksikön tila Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Transport Equipment Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Transport Equipment Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Transport Equipment V V V V V V V V V V V V Alkuperäinen kuljetusyksikkö Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Transport Equipment V V V V Nykyinen kuljetusyksikkö Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Transport Equipment V V V V UBL-TransportationStatus-Lähetysstatus

22 Mittatiedot Sähköisten toimintamallien käytön lisääminen logistiikassa (SÄTKY) Mittatiedon luonne V V V V Poikkeava Toteutunut Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Measurement_ Dimension. Dimension Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Measurement_ Dimension. Dimension V V V V V V V V Mitta-arvo Paino, tilavuus Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Measurement_ Dimension. Dimension Lukumäärä Lastattu määrä Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Measurement_ Dimension. Dimension V V V V V V V V Lämpötila Mitattu, kun on havaittu poikkeama Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Measurement_ Dimension V V V V UBL-TransportationStatus-Lähetysstatus

23 Dimension Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Minimum_ Temperature. Temperature Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Maximum_ Temperature. Temperature Mittayksikkö Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Measurement_ Dimension. Dimension V V V V Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Minimum_ Temperature. Temperature Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Maximum_ Temperature. Temperature UBL-TransportationStatus-Lähetysstatus

24 Pakkauksen ulottuvuudet Ulottuvuuden luonne V V V V Poikkeava Toteutunut Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Measurement_ Dimension. Dimension Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Measurement_ Dimension. Dimension V V V V V V V V Pituus Leveys Korkeus Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Measurement_ Dimension. Dimension Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Measurement_ Dimension. Dimension Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Measurement_ Dimension V V V V V V V V V V V V UBL-TransportationStatus-Lähetysstatus

25 Dimension Mittayksikkö Transport Event. Reported_ Shipment. Shipment. Transport Handling Unit. Measurement_ Dimension. Dimension V V V V UBL-TransportationStatus-Lähetysstatus

26 5 Lähetysstatussanoman rakenne 5.1 Luokkamalli Tässä kappaleessa kuviossa esitetään UBL 2.0 TransportationStatus-sanoman rakenne käyttäen hyväksi UML-luokkamallia. Mallissa on esitetty sanoma vain niiltä osin kuin sen tietosisältö on määritelty projektissa Sähköisten toimintamallien käytön lisääminen logistiikassa (SÄTKY). UBL-TransportationStatus-Lähetysstatus

27 UBL-TransportationStatus-Lähetysstatus ID -IssueDate -IssueTime TransportationStatus Party Address -ID PartyIdentification -Name PartyName 0..* * -ID -DocumentTypeCode DocumentReference -Name Contact 1 0..* +Carrier 1 -ID ReportedShipment 0..* 1 -ID Consignment 1 1 -OccuranceDate -OccurenceTime -TransportEventTypeCodeDirectionCode -Description TransportEvent -ID -Description -Conditions Location -Description -StatusReasonCode -StatusReason CurrentStatus 1 1..* 1 1..* Delivery 1 1 +Delivery -StartDate -StartTime -EndDate -EndTime Period +EstimatedDelivery 1 -ID -DamageRemarks -ShippingMarks TransportHandlingUnit 0..* 1 +Notify 1 -CoordinateSystemCode -LatitudeDegreesMeasure -LatitudeMinutesMeasure -LatitudeDirectionCode -LongitudeDegreesMeasure -LongitudeMinutesMeasure -LongitudeDirectionCode Location Coordinate AttributeID -Measure -Description Dimension -ID -TransportEquipmentTypeCode -SizeTypeCode -Information TransportEquipment 0..* 1 1 +Measurement 0..* -AttributeID -Measure -Description Temperature 1 +Minimum -AttributeID -Measure -Description Temperature 1 +Maximum Attachment 1 -URI ExternalReference 1 Kuvio 5.1.1: Lähetysstatussanoman luokkamalli

28 6 Sanoman määrittely 6.1 Sanomataso Sanomalla välitetään lähetystatuksen tiedot, kuten osapuolet, lähetystapahtuma ja sen syy- ja poikkeustiedot, tapahtumaan liittyvät aika-, paikka- ja viitetiedot sekä kuittaajan tiedot. Liitteessä 1 on esitetty allaolevien taulukoiden lukuohje Lähetysstatussanoma (TransportationStatus. Details) Elementti / aggregaatti Details UBL Version Identifier. Identifier Customization Identifier. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Tällä aggregaatilla annetaan lähetysstatussanoma, joka sisältää lähetystilanteen ja mahdollisien poikkeamien tiedot. Esimerkki <TransportationStatus> </TransportationStatus> Tyyppi Identifier. Type UBL version numero. Tämän sanoman rakenne ja tämä soveltamisohje perustuvat UBL versioon 2.0. Täten tämä elementti saa vakiosti arvon "2.0". Esimerkki <cbc:ublversionid>2.0</cbc:ublversionid> Tyyppi Identifier. Type Elementillä annetaan sanoman soveltamiohjeen kehittäjän nimi. UBL-TransportationStatus-Lähetysstatus

29 Profile Identifier. Identifier Identification Scheme Agency. Identifier Identifier Issue Date. Date Issue Time. Time Esimerkki <cbc:customizationid>tieke</cbc:customizationid> Tyyppi Identifier. Type TIEKE ry:n sanomasuositukselle antama tunnus, joka on vakiosti FI1042 Attribuutit schemeagencyid Esimerkki <cbc:profileid schemeagencyid="292">fi1042 </cbc:profileid> Attribuutilla annetaan soveltamisohjeluettelon ylläpitäjän tunnus. Esimerkki schemeagencyid="292" Käytettävät koodit 292 (FI, TIEKE The Information Technology Development Centre of Finland) TIEKE Tietoyhteiskunnan kehittämiskeskus ry Toisto Tyyppi Identifier. Type Lähetysstatuksen yksilöivät tunnus, jolla lähetysstatussanoma tunnistetaan myöhemmin. Attribuutit schemeagencyid Esimerkki <cbc:id> </cbc:id> Tyyppi Date. Type Elementillä annetaan lähetysstatuksen päivämäärä. On suositeltavaa, että päivämäärä on sama, jonka lähetysstatuksen sisällöstä vastaava henkilö voi nähdä järjestelmästään lähetysstatuksen tekopäivämääränä, eikä lähetysstatussanoman muodostamispäivämäärä, joka voi poiketa tästä päivämäärästä. Päivämäärän muoto on YYYY-MM-DD. Esimerkki <cbc:issuedate> </cbc:issuedate> Tyyppi Time. Type Elementillä annetaan lähetysstatuksen luontikelloaika, siis luontihetken tunnit, minuutit ja sekunnit. On suositeltavaa, että ajanhetki on sama, jonka lähetysstatuksen sisällöstä vastaava henkilö voi nähdä järjestelmästään lähetysstatuksen tekoajanhetkenä, eikä lähetysstatussanoman muodostamisajanhetki, joka voi poiketa tästä ajanhetkestä. UBL-TransportationStatus-Lähetysstatus

30 Consignment Transport Event Document Reference Kellonajan muoto on hh:mm:ss. Huomautus Jos kellonajan ilmoittamisessa on huomioitava aikavyöhyke, esitetään kellonaika muodossa hh:mm:ss+hh:mm tai hh:mm:ss-hh:mm, missä plus- tai miinus-merkin jälkeen on ilmoitettu ajan poikkeaminen UCT- ajasta (Coordinated Universal Time). Jos kellonaika ilmoitetaan UCT-ajassa, voidaan käyttää merkintää hh.mm:ssz. (UTC korvaa aikaisemmin käytetyn Greenwichin keskiajan (GMT).) Esimerkki <cbc:issuetime>08:52:13</cbc:issuetime> Toisto Tyyppi Consignment. Details Aggregaatilla annetaan sen kuljetusasiakirjan tunnus, joka liittyy lähetykseen, jonka lähetysstatusta raportoidaan, sekä lähetysstatusilmoituksen osapuolet. Huomautus Tämä aggregaatti on sanomassa pakollinen, joten sen on aina esiinnyttävä sanomassa. Esimerkki <cac:consignment> </cac:consignment> Toisto 1.. unbounded Tyyppi Transport Event. Details Aggregaatilla annetaan lähetystapahtuman tiedot. Esimerkki <cac:transportevent> </cac:transportevent> Toisto 0.. unbounded Tyyppi Document Reference. Details Aggregaatilla annetaan lähetysstatukseen liittyviä viitteitä. Esimerkki <cac:documentreference> </cac:documentreference> UBL-TransportationStatus-Lähetysstatus

31 6.1.2 Lähetyksen tiedot ( Consignment) 0..* 0..* Elementti / aggregaatti Consignment Toistokerrat, tyyppi, kuvaus, esimerkki Toisto Tyyppi Consignment. Details Aggregaatilla annetaan sen kuljetusasiakirjan tunnus, joka liittyy kuljetukseen, jonka lähetysstatusta raportoidaan, sekä lähetysstatusilmoituksen osapuolet. Huomautus Tämä aggregaatti on sanomassa pakollinen, joten sen on aina esiinnyttävä sanomassa. UBL-TransportationStatus-Lähetysstatus

32 Consignment. Identifier Toisto Consignment. Carrier_ Party. Party Consignment. Notify_ Party. Party Esimerkki <cac:consignment> </cac:consignment> Tyyppi Identifier. Type Elementillä annetaan kuljetusasiakirjan, kuten rahtikirjan, tunniste. Huomautus Tämä elementti on aggregaatissa pakollinen, mikäli aggregaatti Consignment esiintyy. Jos kuljetusasiakirjan yksilöivää tunnusta ei ole määritelty, voidaan elementin arvona antaa puuttuva tieto XXXXXX. Esimerkki <cac:id> </cac:id> Tyyppi Party. Details Aggregaatilla annetaan kuljettajaorganisaation tiedot eli sen osapuolen tiedot, joka lähettää lähetysstatusilmoituksen. Esimerkki <cac:carrierparty> </cac:carrierparty> Tyyppi Esimerkki Party. Details Aggregaatilla annetaan lähetysstatusilmoituksen vastaanottajan tiedot. <cac:notifyparty> </cac:notifyparty> UBL-TransportationStatus-Lähetysstatus

33 6.1.3 Ilmoituksen lähettäjän tiedot (Consignment. Carrier_ Party. Party) 0..* 0..* 0..* 0..* Elementti / aggregaatti Consignment. Carrier_ Party. Party Party. Party Identification Party. Party Name Toistokerrat, tyyppi, kuvaus, esimerkki Tyyppi Party. Details Aggregaatilla annetaan kuljettajaorganisaation tiedot eli sen osapuolen tiedot, joka lähettää lähetysstatusilmoituksen. Esimerkki <cac:carrierparty> </cac:carrierparty> Toisto 0.. unbounded Tyyppi Party Identification. Details Aggregaatilla annetaan kuljetusorganisaation eli lähetysstatusilmoituksen lähettäjän tunnukset, joilla muiden osapuolten järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto 0.. unbounded Tyyppi Party Name. Details Aggregaatilla annetaan kuljetusorganisaation eli lähetysstatusilmoituksen lähettäjän nimitiedot. UBL-TransportationStatus-Lähetysstatus

34 Esimerkki <cac:partyname> </cac:partyname> UBL-TransportationStatus-Lähetysstatus

35 6.1.4 Ilmoituksen lähettäjän tunniste (Party. Party Identification) Elementti / aggregaatti Party. Party Identification Party Identification. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Tyyppi Party Identification. Details Aggregaatilla annetaan kuljetusorganisaation eli lähetysstatusilmoituksen lähettäjän tunnukset, joilla muiden osapuolten järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto Tyyppi Identifier. Type Elementillä annetaan kuljetusorganisaation eli lähetysstatusilmoituksen lähettäjän tunnus, jolla ilmoituksen lähettäjä tunnistetaan muiden osapuolten järjestelmissä automaattisesti. Tässä elementissä annettava tunnus voi olla esimerkiksi OVT-tunnus tai rahdinkuljettajan tunnistekoodiston mukainen tunnus. Attribuutit schemeid ja schemeagencyid Esimerkki <cbc:id schemeid="iso 6523" schemeagencyid="5"> </cbc:ID> Attribuutilla annetaan osapuolitunnistekoodiston tunnus. Esimerkki schemeid="iso 6523" Käytettävät koodit ISO 6523 OVT- tunnus (Structure for the identification of organizations) Attribuutilla annetaan osapuolitunnuskoodiston ylläpitäjä. Esimerkki schemeagencyid="5" Käytettävät koodit 5 ISO (International Organization for Standardization) 87 (Assigned by carrier) Rahdinkuljettajan ylläpitämä luettelo UBL-TransportationStatus-Lähetysstatus

36 6.1.5 Ilmoituksen lähettäjän nimi (Party. Party Name) Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Party. Party Name Toisto 0.. unbounded Tyyppi Party Name. Details Aggregaatilla annetaan kuljetusorganisaation eli lähetysstatusilmoituksen lähettäjän nimitiedot Esimerkki <cac:partyname> </cac:partyname> Party Name. Name Toisto Tyyppi Name. Type Elementillä annetaan kuljetusorganisaation eli lähetysstatusilmoituksen lähettäjän nimi. Esimerkki <cbc:name>nuppi ja Kärry Oy</cbc:Name> UBL-TransportationStatus-Lähetysstatus

37 6.1.6 Ilmoituksen vastaanottajan tiedot (Consignment. Notify_ Party. Party) 0..* 0..* 0..* 0..* Elementti / aggregaatti Notify_ Party. Party Party. Party Identification Party. Party Name Toistokerrat, tyyppi, kuvaus, esimerkki Tyyppi Party. Details Aggregaatilla annetaan lähetysstatusilmoituksen vastaanottajan tiedot. Esimerkki <cac:notifyparty> </cac:notifyparty> Toisto 0.. unbounded Tyyppi Party Identification. Details Aggregaatilla annetaan lähetysstatusilmoituksen vastaanottajan tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto 0.. unbounded Tyyppi Party Name. Details Aggregaatilla annetaan lähetysstatusilmoituksen UBL-TransportationStatus-Lähetysstatus

38 vastaanottajan nimitiedot. Esimerkki <cac:partyname> </cac:partyname> UBL-TransportationStatus-Lähetysstatus

39 6.1.7 Ilmoituksen vastaanottajan tunniste (Party. Party Identification) Elementti / aggregaatti Party. Party Identification Party Identification. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Tyyppi Party Identification. Details Aggregaatilla annetaan lähetysstatusilmoituksen vastaanottajan tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto Tyyppi Identifier. Type Elementillä annetaan lähetysstatusilmoituksen vastaanottajan tunnus, jolla lähetysstatusilmoituksen vastaanottaja tunnistetaan muiden osapuolten järjestelmissä automaattisesti. Tässä elementissä annettava tunnus voi olla esimerkiksi OVT-tunnus tai rahdinkuljettajan tunnistekoodiston mukainen tunnus. Attribuutit schemeid ja schemeagencyid Esimerkki <cbc:id schemeid="iso 6523" schemeagencyid="5"> </cbc:ID> Attribuutilla annetaan osapuolitunnistekoodiston tunnus. Esimerkki schemeid="iso 6523" Käytettävät koodit ISO 6523 OVT- tunnus (Structure for the identification of organizations) Attribuutilla annetaan osapuolitunnuskoodiston ylläpitäjä. Esimerkki schemeagencyid="5" Käytettävät koodit 5 ISO (International Organization for Standardization) 87 (Assigned by carrier) Rahdinkuljettajan ylläpitämä luettelo UBL-TransportationStatus-Lähetysstatus

40 6.1.8 Ilmoituksen vastaanottajan nimi (Party. Party Name) Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Party. Party Name Toisto 0.. unbounded Tyyppi Party Name. Details Aggregaatilla annetaan lähetysstatusilmoituksen vastaanottajan nimitiedot. Esimerkki <cac:partyname> </cac:partyname> Party Name. Name Toisto Tyyppi Name. Type Elementillä annetaan lähetysstatusilmoituksen vastaanottajan nimi. Esimerkki <cbc:name>tekijät Oy / Lähettämö</cbc:Name> UBL-TransportationStatus-Lähetysstatus

41 6.1.9 Lähetystapahtuman tiedot ( Transport Event) 1..* 0..* Elementti / aggregaatti Transport Event Transport Event. Occurrence Date. Date Transport Event. Occurrence Time. Time Transport Event. Transport Event Type. Code Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 1.. unbounded Tyyppi Transport Event. Details Aggregaatilla annetaan lähetystapahtuman tiedot. Esimerkki <cac:transportevent> </cac:transportevent> Tyyppi Date. Type Elementillä annetaan lähetystapahtuman päivämäärä. Päivämäärän muoto on YYYY-MM-DD. Esimerkki <cbc:occurrencedate> </cbc:occurrencedate> Tyyppi Time. Type Elementillä annetaan lähetystapahtuman luontikelloaika, siis tapahtumahetken tunnit, minuutit ja sekunnit. Kellonajan muoto on hh:mm:ss. Huomautus Jos kellonajan ilmoittamisessa on huomioitava aikavyöhyke, esitetään kellonaika muodossa hh:mm:ss+hh:mm tai hh:mm:ss-hh:mm, missä plus- tai miinus-merkin jälkeen on ilmoitettu ajan poikkeaminen UCT- ajasta (Coordinated Universal Time). Jos kellonaika ilmoitetaan UCT-ajassa, voidaan käyttää merkintää hh.mm:ssz. (UTC korvaa aikaisemmin käytetyn Greenwichin keskiajan (GMT).) Esimerkki <cbc:occurrencetime>08:33:00</cbc:occurrencetime> Tyyppi Code. Type Elementillä annetaan lähetystapahtuma koodimuotoisena. Koodit Käytetään UN/ECE Suosituksen nro 24 (TRADE AND UBL-TransportationStatus-Lähetysstatus

42 TRANSPORT STATUS CODES Revision 5) koodeja. 2 = (Arrival, completed) Saapunut 13 = (Collection/pick-up, completed) Noudettu 18 = (Damaged in the course of transportation) Vaurioitunut 20 = (Delayed, in the course of transportation) Myöhässä 21 = (Delivery, completed) Toimitettu vastaanottajalle 24 = (Departure, completed) Lähtenyt (kuljetysyksikkö lähtenyt) 31 = (En route) Matkalla 41 = (Handover) Kuljetusmuodon tai yksikön vaihto samassa kuljetusyhtiössä vastuut säilyvät voimassa 42 = (Handover delivered) Luovutettu jakoon kolmannelle osapuolelle vastuut loppuvat 48 = (Loading, completed onto a means of transport) Lastattu 53 = (Collection/pick-up, not completed) Ei noudettu tavaran lähettäjältä 55 = (Not collected) Ei noudettu kuljetettu, mutta vastaanottaja ei ole noutanut tavaraa 117 = (Missing) Puuttuu 323 = (Return in progress) Paluulogistiikka HUOM! UN/ECE Suositus nro 24 (TRADE AND TRANSPORT STATUS CODES Revision 5) on kokonaisuudessaan tämän soveltamisohjeen liitteenä Attribuutit listid listagencyid Code List. Identifier Code List. Agency. Identifier Esimerkki <cbc:transporteventtypecode listid= UN/ECE rec 24" listagencyid="6">18</cbc:transporteventtypecode> Attribuutilla annetaan tapahtumakoodiston tunnus. Esimerkki listid="un/ece rec 24" Käytettävät koodit UN/ECE rec 24 UN/ECE suositus 24 TRADE AND TRANSPORT STATUS CODES Revision 5 Attribuutilla annetaan tapahtumakoodiston ylläpitäjä. Esimerkki listagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) 87 (Assigned by carrier) Kuljettajan ylläpitämä luettelo UBL-TransportationStatus-Lähetysstatus

43 Transport Event. Description. Text Tyyppi Text. Type Attribuutit languageid Language. Identifier Transport Event. Reported_ Shipment. Shipment Elementillä annetaan lähetystapahtuma tekstimuotoisena tai tarkentavaa tekstiä koodilla elementissä Transport Event. Transport Event Type. Code ilmaistuun lähetystapahtumaan. Esimerkki <cbc:description languageid="fi"> Vaurioitunut ja auennut kuljetuspakkaus.</cbc:description> Lähetystapahtuman tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Tyyppi Shipment. Details Aggregaatilla annetaan lähetystapahtuman paikka-, aika- ja mittatiedot. Transport Event. Current_ Status. Status Transport Event. Contact Esimerkki <cac:reportedshipment> </cac:reportedshipment> Toisto 1.. unbounded Tyyppi Status. Details Aggregaatilla annetaan lähetystapahtuman syytiedot. Huomautus Tämä aggregaatti on sanomassa pakollinen, mikäli aggregaatti Transport Event esiintyy. Esimerkki <cac:currentstatus> </cac:currentstatus> Toisto 0.. unbounded Tyyppi Contact. Details Aggregaatilla annetaan lähetystilanteeseen liittyvän henkilön nimi. Esimerkki <cac:contact> </cac:contact> UBL-TransportationStatus-Lähetysstatus

44 Lähetystapahtuman paikka-, aika- ja mittatiedot (Transport Event. Reported_ Shipment. Shipment) 0..* 0..* 0..* 0..* Elementti / aggregaatti Transport Event. Reported_ Shipment. Shipment Toistokerrat, tyyppi, kuvaus, esimerkki Tyyppi Shipment. Details Aggregaatilla annetaan lähetystapahtuman paikka-, aika- ja mittatiedot. Esimerkki <cac:reportedshipment> </cac:reportedshipment> Shipment. Identifier Toisto Tyyppi Identifier. Type Elementillä annetaan kuljetuksen yksilöivä tunnus, kuten esimerkiksi rahtikirjan numero. Huomautus Tämä elementti on aggregaatissa pakollinen, mikäli aggregaatti Shipment esiintyy. Jos kuljetuksen yksilöivää tunnusta ei ole määritelty, voidaan elementin arvona antaa puuttuva tieto XXXXXX. Esimerkki <cbc:id> </cbc:id> Shipment. Consignment Toisto Tyyppi Consignment. Details UBL-TransportationStatus-Lähetysstatus

45 Aggregaatilla annetaan lähetyserän tiedot. Huomautus Tämä aggregaatti on sanomassa pakollinen, mikäli aggregaatti Shipment esiintyy. Shipment. Delivery Shipment. Transport Handling Unit Esimerkki <cac:consignment> </cac:consignment> Tyyppi Delivery. Details Aggregaatilla annetaan lähetystapahtumaan liittyviä aika- ja paikkatietoja. Esimerkki <cac:delivery> </cac:delivery> Toisto 0.. unbounded Tyyppi Transport Handling Unit. Details Aggregaatilla annetaan lähetystapahtumaan liittyvien kuljetuspakkauksen tietoja, kuten pakkaustyyppi, pakkausmerkinnät ja mittatiedot. Esimerkki <cac:transporthandlingunit> </cac:transporthandlingunit> UBL-TransportationStatus-Lähetysstatus

46 Lähetystapahtuman yksilöintitiedot ( Consignment) 0..* 0..* Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Shipment. Consignment Toisto Tyyppi Consignment. Details Aggregaatilla annetaan lähetyserän tiedot. Huomautus Tämä aggregaatti on sanomassa pakollinen, joten sen on aina esiinnyttävä sanomassa. UBL-TransportationStatus-Lähetysstatus

47 Esimerkki <cac:consignment> </cac:consignment> Consignment. Identifier Toisto Tyyppi Identifier. Type Elementillä annetaan kuljetusasiakirjan, kuten rahtikirjan, tunnus, johon raportoitava lähetystilanne liittyy. Tämän tunnuksen on oltava sellainen, joka sanoman vastaanottajalla on se omissa tietojärjestelmissään, jolloin hän voi yhdistää lähetyksen ja sen statuksen tiedot. Huomautus Tämä elementti on aggregaatissa pakollinen, mikäli aggregaatti Consignment esiintyy. Jos kuljetusasiakirjan yksilöivää tunnusta ei ole määritelty, voidaan elementin arvona antaa puuttuva tieto XXXXXX. Esimerkki <cac:id> </cac:id> UBL-TransportationStatus-Lähetysstatus

48 Lähetystapahtuman aika- ja paikkatiedot (Shipment. Delivery) Elementti / aggregaatti Shipment. Delivery Delivery. Delivery_ Location. Location Delivery. Estimated Delivery_ Period. Period Toistokerrat, tyyppi, kuvaus, esimerkki Tyyppi Esimerkki Tyyppi Delivery. Details Aggregaatilla annetaan lähetystapahtumaan liittyviä aika- ja paikkatietoja. <cac:delivery> </cac:delivery> Location. Details Aggregaatilla annetaan lähetystapahtuman tapahtumapaikan tiedot. Esimerkki <cac:deliverylocation> </cac:deliverylocation> Tyyppi Period. Details Tällä aggregaatilla annetaan lähetyksen arvioidun saapumisajankohdan tiedot. Esimerkki <cac:estimateddeliveryperiod> </cac:estimateddeliveryperiod> UBL-TransportationStatus-Lähetysstatus

49 Lähetystapahtuman tapahtumapaikka (Delivery. Delivery_ Location. Location) 0..* Elementti / aggregaatti Delivery. Delivery_ Location. Location Toistokerrat, tyyppi, kuvaus, esimerkki Tyyppi Location. Details Aggregaatilla annetaan lähetystapahtuman tapahtumapaikan tiedot. Location. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Esimerkki <cac:deliverylocation> </cac:deliverylocation> Tyyppi Identifier. Type Elementillä annetaan lähetystapahtuman tapahtumapaikka koodimuotoisena. Attribuutit schemeid ja schemeagencyid Esimerkki <cbc:id schemeid="un/ece rec 16" schemeagencyid="6"> FIHEL</cbc:ID> Attribuutilla annetaan paikkakoodiston tunnus. Esimerkki schemeid="un/ece rec 16" Käytettävät koodit 16 (Postcode directory) Postinumeroluettelo 37 (Railway locations) Rautatieliikennepaikkakoodisto 139 (Port) Satamakoodi 145 (Airport/city) Lentokenttä-/kaupunkikoodisto UN/ECE rec 16 UN/ECE suositus 16 Codes for Trade and Transport Locations (LOCODE) Attribuutilla annetaan paikkakoodiston ylläpitäjä. Esimerkki schemeagencyid="6" Käytettävät koodit 3 IATA (International Air Transport Association) Kansainvälinen ilmailu-unioni UBL-TransportationStatus-Lähetysstatus

50 6 UN/ECE (United Nations - Economic Commission for Europe) 31 (FI, Finnish State railway) VR 87 (Assigned by carrier) Kuljettajan ylläpitämä luettelo ZLV Liikennevirasto (Finnish Transport Agency) Location. Description. Text Tyyppi Text. Type Elementillä annetaan lähetystapahtuman tapahtumapaikka tekstimuotoisena. Esimerkki <cbc:description>helsinki</cbc:description> Location. Conditions. Text Tyyppi Text. Type Elementillä annetaan paikan rooli. Koodit 175 = (Activity location) Lähetystapahtuman paikka Esimerkki <cbc:conditions>175</cbc:conditions> Location. Address Tyyppi Address. Details Aggregaatilla annetaan lähetystapahtuman tapahtumapaikan sijaintitiedot. Esimerkki <cac:address> </cac:address> UBL-TransportationStatus-Lähetysstatus

51 Lähetystapahtuman tapahtumapaikan sijaintitiedot (Location. Address) 0..* Elementti / aggregaatti Location. Address Address. Location Coordinate Toistokerrat, tyyppi, kuvaus, esimerkki Tyyppi Address. Details Aggregaatilla annetaan lähetystapahtuman tapahtumapaikan sijaintitiedot. Esimerkki <cac:address> </cac:address> Tyyppi Location Coordinate. Details Aggregaatilla annetaan lähetystapahtuman tapahtumapaikan sijaintikoordinaatit. Esimerkki <cac:locationcoordinate> </cac:locationcoordinate> UBL-TransportationStatus-Lähetysstatus

52 Lähetystapahtuman tapahtumapaikan sijaintikoodinaatit (Address. Location Coordinate) Elementti / aggregaatti Address. Location Coordinate Location Coordinate. Coordinate System Code. Code Location Coordinate. Latitude_ Degrees. Measure Toistokerrat, tyyppi, kuvaus, esimerkki Tyyppi Location Coordinate. Details Aggregaatilla annetaan lähetystapahtuman tapahtumapaikan sijaintikoordinaatit. Esimerkki <cac:locationcoordinate> </cac:locationcoordinate> Tyyppi Code. Type Elementillä annetaan lähetystapahtuman tapahtumapaikan sijaintikoordinaatiston tunnus. Koodit KKJ = Kartastokoordinaattijärjestelmä perustuu ED50 (European Datum 1950) koordinaatistoon EUREF-FIN = Yleiseurooppalaisen ETRS90- koordinaatistojärjestelmän mukaisen ETRF89- koordinaatiston realisaatio Suomessa (määritelty Julkisen hallinnon suosituksessa 153). ETRF89 = (European Terrestrial Reference Frame 1989) Yleiseurooppalaisen ETRS90-koordinaatistojärjestelmän mukainen ETRF89-koordinaatisto WGS84 = (The World Geodetic System (WGS 84)) Esimerkki <cbc:coordinatesystemcode>kkj</cbc: CoordinateSystemCode> Tyyppi Measure. Type Elementillä annetaan lähetystapahtuman tapahtumapaikan sijaintipaikan leveyskoodinaatin asteet. UBL-TransportationStatus-Lähetysstatus

53 Attribuutit unitcode Measure Unit. Code Toisto Location Coordinate. Latitude_ Minutes. Measure Esimerkki <cbc:latitudedegreesmeasure unitcode="dd">62 Oletus </cbc:latitudedegreesmeasure> DD Attribuutilla annetaan mittayksikön tunnus, joka on UN/ECE suosituksen 20 Measurement Unit Code mukainen koodi. Esimerkki unitcode="dd" Käytettävät koodit DD Tyyppi Attribuutit (Degree) Aste Measure. Type Elementillä annetaan lähetystapahtuman tapahtumapaikan sijaintipaikan leveyskoodinaatin minuutit. unitcode Measure Unit. Code Toisto Location Coordinate. Latitude Direction Code. Code Latitude Direction_ Code List. Identifier Esimerkki <cbc:latitudeminutesmeasure unitcode="min"> Oletus <cbc:latitudeminutesmeasure> MIN Attribuutilla annetaan mittayksikön tunnus, joka on UN/ECE suosituksen 20 Measurement Unit Code mukainen koodi. Esimerkki unitcode="min" Käytettävät koodit MIN Tyyppi Koodit Attribuutit Esimerkki Esimerkki Käytettävät koodit (Minute) Minuutti Latitude Direction_ Code. Type Elementillä annetaan lähetystapahtuman tapahtumapaikan sijaintipaikan leveyskoodinaatin suunta päiväntasaajalta ilmaistuna koodimuotoisesti. South = (South) Eteläistä leveyttä North = (North) Pohjoista leveyttä listid ja listagencyid <cbc:latitudedirectioncode listid= Latitude Direction" listagencyid="ubl">north</cbc:latitudedirectioncode> Attribuutilla annetaan leveyspiirin suuntakoodiston tunnus. listid="latitude Direction" UBL-TransportationStatus-Lähetysstatus

54 Latitude Direction_ Code List. Agency. Identifier Location Coordinate. Longitude_ Degrees. Measure Latitude Direction UBL Latitude Direction (leveyspiirin suunta) Attribuutilla annetaan leveyspiirin suuntakoodiston ylläpitäjä. Esimerkki listagencyid="ubl" Käytettävät koodit UBL Tyyppi Attribuutit UBL (Universal Business Language) Measure. Type Elementillä annetaan lähetystapahtuman tapahtumapaikan sijaintipaikan pituuskoordinaatin asteet. unitcode Measure Unit. Code Toisto Location Coordinate. Longitude_ Minutes. Measure Esimerkki <cbc:longitudedegreesmeasure unitcode="dd">23 Oletus </cbc:longitudedegreesmeasure> DD Attribuutilla annetaan mittayksikön tunnus, joka on UN/ECE suosituksen 20 Measurement Unit Code mukainen koodi. Esimerkki unitcode="dd" Käytettävät koodit DD Tyyppi Attribuutit (Degree) Aste Measure. Type Elementillä annetaan lähetystapahtuman tapahtumapaikan sijaintipaikan pituuskoordinaatin minuutit. unitcode Measure Unit. Code Toisto Location Coordinate. Longitude Direction Code. Code Esimerkki <cbc:longitudeminutesmeasure unitcode="min">3.691 Oletus </cbc:longitudeminutesmeasure> MIN Attribuutilla annetaan mittayksikön tunnus, joka on UN/ECE suosituksen 20 Measurement Unit Code mukainen koodi. Esimerkki unitcode="min" Käytettävät koodit MIN Tyyppi (Minute) Minuutti Longitude Direction_ Code. Type Elementillä annetaan lähetystapahtuman tapahtumapaikan sijaintipaikan pituuskoordinaatin suunta meridiaanilta ilmaistuna UBL-TransportationStatus-Lähetysstatus

55 Longitude Direction_ Code List. Identifier Longitude Direction_ Code List. Agency. Identifier koodimuotoisesti. Koodit East = (East) Itäistä pituutta West = (West) Läntistä pituutta Attribuutit listid ja listagencyid Esimerkki <cbc:longitudedirectioncode listid= Longitude Direction" listagencyid="ubl">east</cbc:longitudedirectioncode> Attribuutilla annetaan pituuspiirin suuntakoodiston tunnus. Esimerkki listid="longitude Direction" Käytettävät koodit Longitude Direction UBL Longitude Direction (Pituuspiirin suunta) Attribuutilla annetaan pituuspiirin suuntakoodiston ylläpitäjä. Esimerkki listagencyid="ubl" Käytettävät koodit UBL UBL (Universal Business Language) UBL-TransportationStatus-Lähetysstatus

56 Toimituksen arvioitu saapumisaika (Delivery. Estimated Delivery_ Period. Period) Elementti / aggregaatti Delivery. Estimated Delivery_ Period. Period Toistokerrat, tyyppi, kuvaus, esimerkki Tyyppi Period. Details Tällä aggregaatilla annetaan lähetyksen arvioidun saapumisajankohdan tiedot. Huomautus Tällä aggregaatilla annetaan päivämäärä- ja aikaväli. Jos arvioitu saapumispäivä on tietty päivä ja sen ajanhetki, annetaan elementtien Period. Start Date. Date ja Period. End Date. Date arvona sama päivämäärä ja elementtien Period. Start Time. Time ja Period. End Time. Time sama kellonaika. Period. Start Date. Date Esimerkki <cac:estimateddeliveryperiod> Tyyppi </cac:estimateddeliveryperiod> Date. Type Period. Start Time. Time Elementillä annetaan lähetyksen arvioidun saapumisajan aikaisin päivämäärä. Esimerkki <cbc:startdate> </cbc:startdate> Tyyppi Time. Type Elementillä annetaan lähetyksen arvioidun saapumisajan aikaisimman päivän kellonaika. Huomautus Jos kellonajan ilmoittamisessa on huomioitava aikavyöhyke, esitetään kellonaika muodossa hh:mm:ss+hh:mm tai hh:mm:ss-hh:mm, missä plus- tai miinus-merkin jälkeen on ilmoitettu ajan poikkeaminen UCT- ajasta (Coordinated Universal Time). Jos kellonaika ilmoitetaan UCT-ajassa, voidaan käyttää merkintää hh.mm:ssz. (UTC korvaa UBL-TransportationStatus-Lähetysstatus

57 aikaisemmin käytetyn Greenwichin keskiajan (GMT).) Esimerkki <cbc:starttime>16:00:00</cbc:starttime> Period. End Date. Date Tyyppi Date. Type Elementillä annetaan lähetyksen arvioidun saapumisajan viimeisin päivämäärä. Esimerkki <cbc:enddate> </cbc:enddate> Period. End Time. Time Tyyppi Time. Type Elementillä annetaan lähetyksen arvioidun saapumisajan viimeisimmän päivän kellonaika. Huomautus Jos kellonajan ilmoittamisessa on huomioitava aikavyöhyke, esitetään kellonaika muodossa hh:mm:ss+hh:mm tai hh:mm:ss-hh:mm, missä plus- tai miinus-merkin jälkeen on ilmoitettu ajan poikkeaminen UCT- ajasta (Coordinated Universal Time). Jos kellonaika ilmoitetaan UCT-ajassa, voidaan käyttää merkintää hh.mm:ssz. (UTC korvaa aikaisemmin käytetyn Greenwichin keskiajan (GMT).) Esimerkki <cbc:endtime>17:30:00</cbc:endtime> UBL-TransportationStatus-Lähetysstatus

58 Kuljetuspakkauksen tiedot (Shipment. Transport Handling Unit) 0..* 0..* 0..* 0..* 0..* 0..* Elementti / aggregaatti Shipment. Transport Handling Unit Transport Handling Unit. Identifier Transport Handling Unit. Damage_ Remarks. Text Toistokerrat, tyyppi, kuvaus, esimerkki Toisto Tyyppi 0.. unbounded Transport Handling Unit. Details Aggregaatilla annetaan kuljetuspakkauksen tietoja, kuten pakkaustyyppi ja pakkausmerkinnät. Esimerkki <cac:transporthandlingunit> </cac:transporthandlingunit> Tyyppi Identifier. Type Elementillä annetaan pakkauksen tunnus, kuten merkki tai numero. Esimerkki <cbc:id> b2</cbc:id> Toisto Tyyppi 0.. unbounded Text. Type Elementillä annetaan rikkoutuneen tavaran tai pakkauksen kuvaus. Attribuutit languageid Esimerkki Language. Identifier <cbc:damageremarks languageid="fi">pakkaus kolhiintunut kuljetuksen aikana tapahtuneen kaatumisen vuoksi. </cbc:damageremarks> Vauriokuvauksen tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla UBL-TransportationStatus-Lähetysstatus

59 Transport Handling Unit. Shipping_ Marks. Text Transport Handling Unit. Transport Equipment Transport Handling Unit. Measurement_ Dimension. Dimension Transport Handling Unit. Minimum_ Temperature. Temperature Transport Handling Unit. Maximum_ Temperature. Temperature Esimerkki languageid="fi" Toisto 0.. unbounded Tyyppi Text. Type Elementillä annetaan pakkauksen merkinnät. Esimerkki <cbc:shippingmarks>l8-a55/83</cbc:shippingmarks> Toisto 0.. unbounded Tyyppi Transport Equipment. Details Aggregaatilla annetaan lähetystapahtumaan liittyvän kuljetusyksikön tiedot. Esimerkki <cac:transportequipment> </cac:transportequipment> Toisto 0.. unbounded Tyyppi Dimension. Details Aggregaatilla annetaan kuljetuspakkauksen mittatiedot. Esimerkki <cac:measurementdimension> </cac:measurementdimension> Tyyppi Temperature. Details Aggregaatilla annetaan alhaisin havaittu, kuljetuksen aikainen lämpötila, joka on sallittujen lämpötilarajojen ulkopuolella. Esimerkki <cac:minimumtemperature> </cac:minimumtemperature> Tyyppi Temperature. Details Aggregaatilla annetaan korkein havaittu, kuljetuksen aikainen lämpötila, joka on sallittujen lämpötilarajojen ulkopuolella. Esimerkki <cac:maximumtemperature> </cac:maximumtemperature> UBL-TransportationStatus-Lähetysstatus

60 Kuljetusyksikön tiedot (Transport Handling Unit. Transport Equipment) 0..* 0..* Elementti / aggregaatti Transport Handling Unit. Transport Equipment Transport Equipment. Identifier Transport Equipment. Transport Equipment Type Code. Code Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Tyyppi Transport Equipment. Details Aggregaatilla annetaan lähetystapahtumaan liittyvän kuljetusyksikön tiedot. Esimerkki <cac:transportequipment> </cac:transportequipment> Tyyppi Identifier. Type Elementillä annetaan kuljetusyksikön tunnus. Esimerkki <cbc:id>icsu </cbc:id> Type Transport Equipment Type_ Code. Type Elementillä annetaan kuljetusyksikön tyyppi. Koodit Koodiston UN/ECE 8053 mukaisia koodeja ovat mm.: CN = (Container) Kontti PA = (Pallet) Lava RR = (Rail car) Junan vaunu SW = (Swap body) Vaihtolava TE = (Trailer) Perävaunu ZVT = Kuorma-auto Attribuutit listid ja listagencyid Esimerkki <cbc:transportequipmenttypecode listid= UN/ECE 8053" UBL-TransportationStatus-Lähetysstatus

61 Transport Equipment Type_ Code List. Identifier Transport Equipment Type_ Code List. Agency. Identifier Transport Equipment. Size Type Code. Code listagencyid="6">cn</cbc:transportequipmenttypecode> Attribuutilla annetaan kuljetusyksikön tyyppikoodiston tunnus. Esimerkki listid="un/ece 8053 Käytettävät koodit UN/ECE 8053 UN/ECE koodiston 8053 Equipment type code qualifier Attribuutilla annetaan kuljetusyksikön tyyppikoodiston ylläpitäjän tunnus. Esimerkki listagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) Tyyppi Koodit Code. Type Elementillä annetaan kuljetusyksikön tyyppi ja koko. Koodiston UN/ECE 8155 mukaisia koodeja ovat mm.: 17 = (Semi-trailer) Puoliperävaunu 18 = (Tank container 20 feet) Tankkikontti 20 jalkaa 19 = (Tank container 30 feet) Tankkikontti 30 jalkaa 20 = (Tank container 40 feet) Tankkikontti 40 jalkaa 21 = (Container IC 20 feet) IC-kontti, 20 jalkaa (IC = InterContainer) 22 = (Container IC 30 feet) IC-kontti, 30 jalkaa (IC = InterContainer) 23 = (Container IC 40 feet) IC-kontti, 40 jalkaa IC = InterContainer) Attribuutit listid ja listagencyid Code List. Identifier Code List. Agency. Identifier Esimerkki <cbc:sizetypecode listid= UN/ECE 8155" listagencyid="6">21</cbc:sizetypecode> Attribuutilla annetaan kuljetusyksikkö tyyppi- ja kokokoodiston tunnus. Esimerkki listid="un/ece 8155 Käytettävät koodit UN/ECE 8155 UN/ECE koodiston 8155 Equipment size and type description code Attribuutilla annetaan kuljetusyksikön tyyppi- ja kokokoodiston UBL-TransportationStatus-Lähetysstatus

62 Transport Equipment. Information. Text ylläpitäjän tunnus. Esimerkki listagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) Toisto 0.. unbounded Tyyppi Text. Type Elementillä annetaan koodimuotoinen tieto, onko kuljetusyksikkö alkuperäinen vai nykyinen, käytössä oleva yksikkö, kun kuljetusyksikköä on muutettu lähetyksen aikana Koodit Käytettävät koodit ovat: ZAP = Alkuperäinen kuljetusyksikkö ZNK = Nykyinen kuljetusyksikkö Esimerkki <cbc:information>zap</cbc:information> UBL-TransportationStatus-Lähetysstatus

63 Pakkauksen mitta- ja määrätiedot (Transport Handling Unit. Measurement_ Dimension. Dimension) Elementti / aggregaatti Transport Handling Unit. Measurement_ Dimension. Dimension Dimension. Attribute Identifier. Identifier Identification Scheme. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Tyyppi Dimension. Details Aggregaatilla annetaan kuljetuspakkauksen mittatiedot. Esimerkki <cac:measurementdimension> </cac:measurementdimension> Toisto Tyyppi Identifier. Type Elementillä annetaan kuljetusyksikköön liittyvät mitattavan ominaisuuden tunnistekoodi. Koodit Käytettäviä koodeja ovat: AAB = (Goods item gross weight) Bruttopaino AAF = (Net net weight) Nettopaino ABJ = (Volume) Tilavuus DI = (Diameter) Halkaisija HT = (Height dimension) Korkeus LN = (Length) Pituus SQ = (Shipped quantity) Lastattu määrä TC = (Temperature) Lämpötila WD = (Width dimension) Leveys Attribuutit schemeid ja schemeagencyid Esimerkki <cbc:attributeid schemeid="un/ece 6313" schemeagencyid="6">sq</cbc:attributeid> Attribuutilla annetaan mitattavan ominaisuuden tunnuskoodiston tunnus. Esimerkki schemeid="un/ece 6313" Käytettävät koodit UBL-TransportationStatus-Lähetysstatus

64 Identification Scheme Agency. Identifier UN/ECE 6313 UN/ECE koodisto 6313 Measured attribute code Attribuutilla annetaan mittattavan ominaisuuden tunnuskoodiston ylläpitäjä. Esimerkki schemeagencyid="6" Käytettävät koodit Dimension. Measure 6 UN/ECE (United Nations - Economic Commission for Europe) Tyyppi Measure. Type Attribuutit unitcode Measure Unit. Code Toisto Dimension. Description. Text Elementillä annetaan kuljetusyksikköön liittyvän mitattavan ominaisuuden arvo tai lukumäärä. Esimerkki <cbc:measure unitcode="c62">10</cbc:measure> Attribuutilla annetaan mittayksikön tunnus, joka on UN/ECE suosituksen 20 Measurement Unit Code mukainen koodi. Esimerkki unitcode="c62" Käytettävät koodit C62 CEL CMT FAH FOT INH KGM LTR MMT MTQ MTR TNE Toisto Tyyppi Koodit Esimerkki (One, piece, unit) Kappale (Degree Celsius) Celcius asteet (Centimetre) Senttimetri (Degree Fahrenheit) Fahrenheit asteet (Foot) Jalka (Inch) Tuuma (Kilogram) Kilogramma (Litre) Litra (Millimetre) Millimetri (Cubic metre) Kuutiometri (Metre) Metri (Tonne) Tonni 0.. unbounded Text. Type Elementillä annetaan koodimuotoinen tieto, millaisesta mitta- arvosta on kyse. Käytettävät koodit ovat: 13 = (Observed value) Havaittu (todellinen) mitta-arvo 15 = (Out of range) Poikkeava mitta-arvo <cbc:description>13</cbc:description> UBL-TransportationStatus-Lähetysstatus

65 Alhaisin kuljetuksen aikainen havaittu lämpötila (Transport Handling Unit. Minimum_ Temperature. Temperature) Elementti / aggregaatti Transport Handling Unit. Minimum_ Temperature. Temperature Temperature. Attribute Identifier. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Tyyppi Esimerkki Toisto Tyyppi Koodit Temperature. Details Aggregaatilla annetaan alhaisin havaittu, kuljetuksen aikainen lämpötila, joka on sallittujen lämpötilarajojen ulkopuolella. <cac:minimumtemperature> </cac:minimumtemperature> Identifier. Type Elementillä annetaan lämpötilan tyyppi. Käytettävä koodi on: AAV = (Non operative temperature) Poikkeava lämpötila Attribuutit schemeid ja schemeagencyid Esimerkki <cbc:attributeid schemeid="un/ece 6313" schemeagencyid="6">tc</cbc:attributeid> Attribuutilla annetaan mitattavan ominaisuuden tunnuskoodiston tunnus. Esimerkki schemeid="un/ece 6313" Käytettävät koodit UN/ECE 6313 UN/ECE koodisto 6313 Measured attribute code Attribuutilla annetaan mitattavan ominaisuuden tunnuskoodiston ylläpitäjä. Esimerkki schemeagencyid="6" Käytettävät koodit Temperature. Measure Toisto UN/ECE (United Nations - Economic Commission for Europe) Tyyppi Measure. Type Elementillä annetaan havaittu alhaisin, poikkeava lämpötila. UBL-TransportationStatus-Lähetysstatus

66 Attribuutit unitcode Esimerkki <cbc:measure unitcode="cel">-8.9</cbc:measure> Quantity Unit. Code Toisto Attribuutilla annetaan mittayksikön tunnus, joka on UN/ECE suosituksen 20 Measurement Unit Code mukainen koodi. Esimerkki unitcode="cel" Käytettävät koodit CEL Celsius FAH Fahrenheit UBL-TransportationStatus-Lähetysstatus

67 Korkein kuljetuksen aikainen havaittu lämpötila (Transport Handling Unit. Maximum_ Temperature. Temperature) Elementti / aggregaatti Transport Handling Unit. Maximum_ Temperature. Temperature Temperature. Attribute Identifier. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Tyyppi Esimerkki Toisto Tyyppi Koodit Temperature. Details Aggregaatilla annetaan korkein havaittu, kuljetuksen aikainen lämpötila, joka on sallittujen lämpötilarajojen ulkopuolella. <cac:maximumtemperature> </cac:maximumtemperature> Identifier. Type Elementillä annetaan lämpötilan tyyppi. Käytettävä koodi on: AAV = (Non operative temperature) Poikkeava lämpötila Attribuutit schemeid ja schemeagencyid Esimerkki <cbc:attributeid schemeid="un/ece 6313" schemeagencyid="6">tc</cbc:attributeid> Attribuutilla annetaan mitattavan ominaisuuden tunnuskoodiston tunnus. Esimerkki schemeid="un/ece 6313" Käytettävät koodit UN/ECE 6313 UN/ECE koodisto 6313 Measured attribute code Attribuutilla annetaan mitattavan ominaisuuden tunnuskoodiston ylläpitäjä. Esimerkki schemeagencyid="6" Käytettävät koodit Temperature. Measure Toisto UN/ECE (United Nations - Economic Commission for Europe) Tyyppi Measure. Type Elementillä annetaan havaittu korkein, poikkeava lämpötila. UBL-TransportationStatus-Lähetysstatus

68 Attribuutit unitcode Esimerkki <cbc:measure unitcode="cel">3.8</cbc:measure> Quantity Unit. Code Toisto Attribuutilla annetaan mittayksikön tunnus, joka on UN/ECE suosituksen 20 Measurement Unit Code mukainen koodi. Esimerkki unitcode="cel" Käytettävät koodit CEL Celsius FAH Fahrenheit UBL-TransportationStatus-Lähetysstatus

69 Lähetystapahtuman syyn tiedot (Transport Event. Current_ Status. Status) Elementti / aggregaatti Transport Event. Current_ Status. Status Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 1.. unbounded Tyyppi Status. Details Aggregaatilla annetaan lähetystapahtuman syytiedot. Huomautus Tämä aggregaatti on sanomassa pakollinen, mikäli aggregaatti Transport Event esiintyy. Status. Description. Text Esimerkki <cac:currentstatus> </cac:currentstatus> Tyyppi Text. Type Attribuutit languageid Language. Identifier Status. Status Reason Code. Code Elementillä annetaan lähetystapahtuman yleistä tietoa, jota ei voida antaa muiden elementtien arvoina. Esimerkki <cbc: Description languageid="fi"> Kuljettaja ilmoittanut tavaran vaurioista myös muille osapuolille.</cbc:description> Lähetystapahtuman lisätekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Tyyppi Koodit Code. Type Elementillä annetaan lähetystapahtuman syy koodimuotoisena. Käytettävät koodit ovat 14 = (Damaged) Vaurioitunut 27 = (Goods units missing) Tavara puuttuu 33 = (Lost goods/consignments/equipment) Kadonnut UBL-TransportationStatus-Lähetysstatus

70 34 = (Means of transport damaged) Kuljetusväline rikkoontunut 40 = (Not identified) Pakkausten tunnisteet puuttuvat 63 = (Weather conditions) Säätilan aiheuttama 108 = (Goods not barcoded) Viivakoodit puuttuvat HUOM! UN/ECE 9013-koodisto on kokonaisuudessaan tämän soveltamisohjeen liitteenä Attribuutit listid listagencyid Code List. Identifier Code List. Agency. Identifier Status. Status_ Reason. Text Esimerkki <cac:statusreasoncode listid="un/ece 9013" listagencyid="6">33</cac:statusreasoncode> Attribuutilla annetaan syykoodiston tunnus. Esimerkki listid="un/ece 9013" Käytettävät koodit UN/ECE 9013 UN/ECE koodisto 9013 Status reason description code Attribuutilla annetaan syykoodiston ylläpitäjä. Esimerkki listagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) 87 (Assigned by carrier) Kuljettajan ylläpitämä luettelo Tyyppi Text. Type Attribuutit languageid Language. Identifier Elementillä annetaan lähetystapahtuman syy- tai poikkeustieto tekstimuotoisena tai tarkentavaa tekstiä koodilla elementissä Status. Status Reason Code.Code ilmaistuun lähetystapahtuman syyhyn tai poikkeustilaan. Esimerkki <cbc:statusreason languageid="fi">kadonnut matkan aikana. </cbc:statusreason> Lähetystapahtuman syyn tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" UBL-TransportationStatus-Lähetysstatus

71 Lähetystapahtumaan liittyvän henkilön tiedot (Transport Event. Contact) 0..* Elementti / aggregaatti Transport Event. Contact Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Tyyppi Contact. Details Aggregaatilla annetaan lähetystilanteeseen liittyvän henkilön, kuten kuittaajan, nimi. Esimerkki <cac:contact> </cac:contact> Contact. Name Tyyppi Name. Type Elementillä annetaan lähetystapahtumaan liittyvän henkilön ja hänen edustamansa yhtiön nimi, kuten lähetyksen vastaanottajan eli kuittaajan nimi. Esimerkki <cbc:name> Kalle Kuittaaja</cbc:Name> UBL-TransportationStatus-Lähetysstatus

72 Lähetysstatuksen viitteet ( Document Reference) Elementti / aggregaatti Document Reference Document Reference. Identifier Document Reference. Document Type Code. Code Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Tyyppi Document Reference. Details Aggregaatilla annetaan lähetysstatukseen liittyviä viitteitä. Esimerkki <cac:documentreference> </cac:documentreference> Toisto Tyyppi Identifier. Type Elementillä annetaan lähetysstatuksen viitteen tunnus. Huomautus Tämä elementti on aggregaatissa pakollinen, mikäli aggregaatti Document Reference esiintyy. Jos viitteen yksilöivää tunnusta ei ole määritelty, voidaan elementin arvona antaa puuttuva tieto XXXXXX. Esimerkki <cbc:id>16923-v</cbc:id> Tyyppi Code. Type Elementillä annetaan lähetysstatuksen viitteen tyyppi koodimuotoisena. Huomautus Elementin arvoja on kahdessa eri koodistossa. OASIS on määritellyt UN/ECE koodiston "1001 Document name code" oletusarvoiseksi koodistoksi. Jos tästä koodistosta ei löydy sopivaa koodia, voidaan käyttää UN/ECE koodistoa 1153 Reference qualifier". Koodit UN/ECE koodiston 1001 mukaisia koodeja ovat: 106 = (Transport equipment damage report) Vaurioilmoitus 700 = (Waybill) Rahtikirja UN/ECE koodiston 1153 mukaisia koodeja ovat: AAO = (Consignment identifier, consignee assigned) Vastaanottajan viitenumero UBL-TransportationStatus-Lähetysstatus

73 BN = (Consignment identifier, carrier assigned) Kuljetuksen tilausnumero CU = (Consignment identifier, consignor assigned) Lähettäjän viitenumero Attribuutit listid ja listagencyid Code List. Identifier Code List. Agency. Identifier Document Reference. Attachment Esimerkki <cbc:documenttypecode listid= UN/ECE 1001" listagencyid="6">106</cbc:documenttypecode> Attribuutilla annetaan dokumenttitunnuskoodiston tunnus; joko UN/ECE 1001 tai UN/ECE 1153 Esimerkki listid="un/ece 1001" Käytettävät koodit UN/ECE 1001 UN/ECE koodisto 1001 "Document name code" UN/ECE 1153 UN/ECE koodisto 1153 "Reference qualifier" Attribuutilla annetaan dokumenttitunnuskoodiston ylläpitäjän tunnus Esimerkki listagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) Tyyppi Attachment. Details Aggregaatilla annetaan lähetysstatuksen viitteen liitteet. Esimerkki <cac:attachment> </cac:attachment> UBL-TransportationStatus-Lähetysstatus

74 Liitetiedoston tiedot (Document Reference. Attachment) Elementti / aggregaatti Document Reference. Attachment Attachment. External Reference Toistokerrat, tyyppi, kuvaus, esimerkki Tyyppi Attachment. Details Aggregaatilla annetaan lähetysstatuksen viitteen liitteet. Esimerkki <cac:attachment> </cac:attachment> Tyyppi External Reference. Details Aggregaatilla annetaan lähetysstatukseen liittyvän liitetiedoston web-osoitetiedot. Esimerkki <cac:externalreference> </cac:externalreference> UBL-TransportationStatus-Lähetysstatus

75 Liitetiedoston web-osoite (Attachment. External Reference) Elementti / aggregaatti Attachment. External Reference External Reference. URI. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Tyyppi External Reference. Details Aggregaatilla annetaan lähetysstatukseen liittyvän liitetiedoston web-osoitetiedot. Esimerkki <cac:externalreference> </cac:externalreference> Tyyppi Identifier. Type Elementillä annetaan lähetysstatukseen liittyvän liitetiedoston web-osoite eli URI (Uniform Resource Identifier), kuten esimerkiksi vaurio- tai rahtikirjakuvapankin osoite. Esimerkki <cbc:uri> UBL-TransportationStatus-Lähetysstatus

76 7 Sanomaesimerkki Tässä kappaleessa on esimerkki UBL Transportation Status -lähetysstatussanomasta. 7.1 UBL lähetysstatusanomaesimerkki <?xml version="1.0" encoding="utf-8"?> <TransportationStatus xmlns:xsi=" xmlns:qdt="urn:oasis:names:specification:ubl:schema:xsd:qualifieddatatypes-2" xmlns:ext="urn:oasis:names:specification:ubl:schema:xsd:commonextensioncomponents-2" xmlns:ccts="urn:oasis:names:specification:ubl:schema:xsd:corecomponentparameters-2" xmlns:udt="urn:un:unece:uncefact:data:specification:unqualifieddatatypesschemamodule:2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:commonbasiccomponents-2" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:commonaggregatecomponents-2" xmlns="urn:oasis:names:specification:ubl:schema:xsd:transportation Status-2" xmlns:clm66411="urn:un:unece:uncefact:codelist:specification:66411:2001" xmlns:clmianamimemediatype="urn:un:unece:uncefact:codelist:specification:ianamimemediatype:2003" xmlns:clm54217="urn:un:unece:uncefact:codelist:specification:54217:2001" xmlns:clm5639="urn:un:unece:uncefact:codelist:specification:5639:1988"> <cbc:ublversionid>2.0</cbc:ublversionid> <cbc:customizationid>tieke</cbc:customizationid> <cbc:profileid schemeagencyid="292">fi1042</cbc:profileid> <cbc:id> </cbc:id> UBL-TransportationStatus-Lähetysstatus

77 <cbc:issuedate> </cbc:issuedate> <cbc:issuetime>08:52:13</cbc:issuetime> <cac:consignment> <cbc:id>2252-b/07</cbc:id> <cac:carrierparty> <cac:partyidentification> <cbc:id schemeid="iso 6523" schemeagencyid="5"> </cbc:id> </cac:partyidentification> <cac:partyname> <cbc:name>nuppi ja Kärry Oy</cbc:Name> </cac:partyname> </cac:carrierparty> <cac:notifyparty> <cac:partyidentification> <cbc:id schemeid="iso 6523" schemeagencyid="5"> </cbc:id> </cac:partyidentification> <cac:partyname> <cbc:name>tekijät Oy</cbc:Name> </cac:partyname> </cac:notifyparty> </cac:consignment> <cac:transportevent> <cbc:occurancedate> </cbc:occurancedate> <cbc:occurancetime>08:33:00</cbc:occurancetime> <cbc:transporteventtypecode listid="un/ece rec 24" listagencyid="6">18</cbc:transporteventtypecode> <cbc:description languageid="fi">vaurioitunut ja auennut kuljetuspakkaus.</cbc:description> UBL-TransportationStatus-Lähetysstatus

78 <cac:reportedshipment> <cbc:id> </cbc:id> <cac:consignment> <cbc:id> </cbc:id> </cac:consignment> <cac:delivery> <cac:deliverylocation> <cbc:id schemeid="un/ece rec 16" schemeagencyid="6">fihel</cbc:id> <cbc:description>helsinki</cbc:description> <cbc:conditions>175</cbc:conditions> <cac:address> <cac:locationcoordinate> <cbc:coordinatesystemcode>kkj</cbc:coordinatesystemcode> <cbc:latitudedegreesmeasure unitcode="dd">60</cbc:latitudedegreesmeasure> <cbc:latitudeminutesmeasure unitcode="min">10.033</cbc:latitudeminutesmeasure> <cbc:latitudedirectioncode listid="latitude Direction" listagencyid="ubl">north </cbc:latitudedirectioncode> <cbc:longitudedegreesmeasure unitcode="dd">24</cbc:longitudedegreesmeasure> <cbc:longitudeminutesmeasure unitcode="min">57.691</cbc:longitudeminutesmeasure> <cbc:longitudedirectioncode listid="longitude Direction" listagencyid="ubl">east </cbc:longitudedirectioncode> </cac:locationcoordinate> </cac:address> </cac:deliverylocation> <cac:estimateddeliveryperiod> <cbc:startdate> </cbc:startdate> UBL-TransportationStatus-Lähetysstatus

79 <cbc:starttime>16:00:00</cbc:starttime> <cbc:enddate> </cbc:enddate> <cbc:endtime>17:30:00</cbc:endtime> </cac:estimateddeliveryperiod> </cac:delivery> <cac:transporthandlingunit> <cbc:id> b2</cbc:id> <cbc:damageremarks languageid="fi">pakkaus kolhiintunut kuljetuksen aikana tapahtuneen kaatumisen vuoksi. </cbc:damageremarks> <cbc:shippingmarks>l8-a55/83</cbc:shippingmarks> <cac:transportequipment> <cbc:id>icsu </cbc:id> <cbc:transportequipmenttypecode listid="un/ece 8053" listagencyid="6">cn</cbc:transportequipmenttypecode> <cbc:sizetypecode listid="un/ece 8155" listagencyid="6">21</cbc:sizetypecode> <cbc:information languageid="fi">zap</cbc:information> <cac:measurementdimension> <cbc:attributeid schemeid="un/ece 6313" schemeagencyid="6">ct</cbc:attributeid> <cbc:measure unitcode="c62">1</cbc:measure> </cac:measurementdimension> </cac:transportequipment> <cac:measurementdimension> <cbc:attributeid schemeid="un/ece 6313" schemeagencyid="6">sq</cbc:attributeid> <cbc:measure unitcode="c62">10</cbc:measure> <cbc:description>13</cbc:description> </cac:measurementdimension> <cac:minimumtemperature> UBL-TransportationStatus-Lähetysstatus

80 <cbc:attributeid schemeid="un/ece 6313" schemeagencyid="6">tc</cbc:attributeid> <cbc:measure unitcode="cel">-8.9</cbc:measure> </cac:minimumtemperature> </cac:transporthandlingunit> </cac:reportedshipment> <cac:currentstatus> <cbc:description languageid="fi">kuljettaja ilmoittanut tavaran vaurioista myös muille osapuolille.</cbc:description> <cbc:statusreasoncodecode listid="un/ece 9013" listagencyid="6">14</cbc:statusreasoncodecode> <cbc:statusreason languageid="fi">vaurioitunut matkan aikana.</cbc:statusreason> </cac:currentstatus> <cac:contact> <cbc:name> kalle Kuittaaja</cbc:Name> </cac:contact> </cac:transportevent> <cac:documentreference> <cbc:id>16923-v</cbc:id> <cbc:documenttypecode listid="un/ece 1001" listagencyid="6">106</cbc:documenttypecode> <cac:attachment> <cac:externalreference> <cbc:uri> </cac:externalreference> </cac:attachment> </cac:documentreference> </TransportationStatus> UBL-TransportationStatus-Lähetysstatus

81 8 Liitteet 8.1 Liite 1: Kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje UBL-TransportationStatus-Lähetysstatus