Tilausmuutos. Sanomasuositus ja sen yleinen soveltamisohje. FI1035, , v 1.00

Transkriptio

1 Sanomasuositus ja sen yleinen soveltamisohje Tilausmuutos FI035, , v.00 Käyttö: Energiateollisuus Sanasto: UBL Versio: 2.0 Sanoma: OrderChange

2 Sisällysluettelo 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ää aineistoa Huomioitavaa Tilausmuutosprosessi Prosessin rajaus Prosessin osapuolet Pientyötilausmuutosprosessi Projektitilausmuutosprosessi Sanoman tietosisältö Tilausmuutossanoman rakenne Luokkamalli Tietojen suhde toisiinsa Sanoman määrittely Sanoman otsikkotaso Tilausmuutossanoma (Order Change. Details) Muutettavan tilauksen eli hankkeen tunnus (Order Change. Order Reference) Tarjous (Order Change. Quotation_ Document Reference. Document Reference) Muut viitteet (Order Change. Additional_ Document Reference. Document Reference) Liitetiedosto (Document Reference. Attachment) Liitetiedoston web-osoite (Attachment. External Reference) Tilaajan tiedot (Order Change. Buyer_ Customer Party. Customer Party) Tilaaja (Customer Party. Party) Tilaajan tunniste (Party. Party Identification) Tilaajan nimi (Party. Party Name) Tilaajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Toimittajan tiedot (Order Change. Seller_ Supplier Party. Supplier Party) Toimittaja (Supplier Party. Party) Toimittajan tunniste (Party. Party Identification)... 47

3 6..5 Toimittajan nimi (Party. Party Name) Toimittamiseen liittyvät tiedot (Order Change. Delivery) Toimintopaikan eli työkohteen tiedot (Delivery. Delivery_ Location. Location) Työkohteen osoite (Location. Address) Työkohteena olevan laitteen sijaintipaikan nimitiedot (Address. Address Line) Työkohteen sijaintikoodinaatit (Address. Location Coordinate) Hankkeen suorittamisperiodin tiedot (Delivery. Requested Delivery_ Period. Period) Materiaalitoimituksen päivämäärätiedot (Delivery. Promised Delivery_ Period. Period) Suunniteltu kohteen käyttöönottopäivämäärän tiedot (Delivery. Estimated Delivery_ Period. Period) Materiaalin toimitusosoitteen tiedot (Delivery. Delivery_ Party. Party) Materiaalin toimitusosoitteen tunniste (Party. Party Identification) Materiaalin toimitusosoiteen nimi (Party. Party Name) Materiaalin toimitusosoiteen osoite (Party. Postal_ Address. Address) Materiaalin toimitusosoiteen maa (Address. Country) Materiaalin toimitusosoiteen sijaintikoodinaatit (Address. Location Coordinate) Sanoman rivitaso Tilausmuutosrivin tiedot (Order Change. Order Line) Tehtävän tiedot (Order Line. Line Item) Työhön liittyvät paikkatiedot (Line Item. Delivery) Toimintopaikan eli työkohteen tiedot (Delivery. Delivery_ Location. Location) Työkohteen osoite (Location. Address) Työkohteena olevan laitteen sijaintipaikan nimitiedot (Address. Address Line) Työkohteen sijaintikoodinaatit (Address. Location Coordinate) Tehtävän suorittamisperiodin tiedot (Delivery. Requested Delivery_ Period. Period) Suunniteltu kohteen käyttöönottopäivämäärän tiedot (Delivery. Estimated Delivery_ Period. Period) Tuotteen tuotetiedot (Line Item. Item) Tilaajan tuotekoodi eli nimike (Item. Buyers_ Item Identification. Item Identification) Sähköalan tuotekoodi eli nimike (Item. Standard_ Item Identification. Item Identification) Tilausmuutosrivin viitteet (Order Line. Document Reference) Tilausmuutoksen rivin liitetiedosto (Document Reference. Attachment)... 95

4 6.2.5 Tilausmuutoksen rivin liitetiedoston web-osoite (Attachment. External Reference) Sanoman rivitaso (mittarointi) Vanhaan mittariin liittyvät tiedot (Order. Order Line) Vanhan mittarin tiedot (Order Line. Line Item) Vanhaan mittariin liittyvät aikatiedot (Line Item. Delivery) Mittaroinnin suorittamisperiodin tiedot (Delivery. Requested Delivery_ Period. Period) Vanhan mittarin tuotetiedot (Line Item. Item) Vanhan mittarin tiedot (Item. Buyers_ Item Identification. Item Identification) Vanhan mittarin laitetyypin nimi (Item Identification. Physical Attribute) Vanhan mittalaitteen valmistusnumero (Item. Item Instance) Uuteen mittariin liittyvät tiedot (Order. Order Line) Uuden mittarin tiedot (Order Line. Line Item) Uuteen mittariin liittyvät aikatiedot (Line Item. Delivery) Mittaroinnin suorittamisperiodin tiedot (Delivery. Requested Delivery_ Period. Period) Uuden mittarin tuotetiedot (Line Item. Item) Uuden mittarin tiedot (Item. Manufacturers_ Item Identification. Item Identification) Uuden mittarin laitetyypin nimi (Item Identification. Physical Attribute) Vanhan mittarin tunnus (Order Line. Document Reference) Sanomaesimerkki UBL pientyötilausmuutossanomaesimerkki UBL mittarointitilausmuutossanomaesimerkki Liite : Kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje... 32

5 Sanoma ja sen soveltamisala. Sanoman käyttötarkoitus ja soveltamisen rajaus Tämä dokumentti sisältää UBL 2.0 -versioon perustuvan OrderChange sanoman sanomakuvauksen ja soveltamisohjeen. Tämä soveltamisohje määrittelee sanoman käytön suomalaisen energiateollisuuden sähköntuottajien ja heidän palvelutuottajien välisessä toiminnassa muutettaessa pientyö- tai projektitilausta. Soveltamisohjeen määrittelemää tilausmuutossanomaa voidaan käyttää normaalissa, kertaluonteisessa tai sopimuspohjaisessa tilaustoiminnossa. Tällä sanomalla voidaan tehdä vain tilausmuutos. Varsinainen alkuperäinen tilaus tapahtuu Order-sanomalla ja sen peruutus tapahtuu OrderCancellation-sanomilla. Jos koko tilaus halutaan peruuttaa ja korvata kokonaisuudessaan uudella tilauksella esimerkiksi, kun tilaus on lähtenyt vahingossa tilaajan järjestelmistä toimittajalle, tilausmuutos tehdään siten, että ensin lähetetään tilauksen peruutussanoma ja tämän jälkeen lähetetään uusi tilaussanoma, joka sisältää muutetun tilauksen tiedot. Normaaleissa tapauksissa, joissa muutos kohdistuu vain yhteen tai muutamaan tilausriviin, lähetetään kyseiset tilausrivit tilaussanomassa määriltään negatiivisina ja samassa sanomassa oikeat tiedot sisältävät rivit. Kohdistaminen alkuperäisen tilauksen ja muutetun tilauksen välillä tapahtuu rivinumeron ja tuotekoodin avulla. OrderChange-sanomalla voidaan muuttaa ainoastaan päivämääriä ja paikkatietoja. Tilattuja määriä tällä sanomalla ei saa muuttaa. Yhteyshenkilöiden ja muiden henkilöiden muutokset ilmoitetaan tiedoksiantosanomalla. Muutoksien ja peruutuksien tekemisestä sähköisesti on sovittava aina toimittajan kanssa, ennen kuin tilauksia aletaan perua tai muuttaa sähköisesti. 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 Energiateollisuus ry:n organisoimassa projektissa Sähkönjakeluyhtiöiden ja palveluntuottajayhtiöiden tietojärjestelmien yhteensopivuus. 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 XMLpohjaista 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. 5/32

6 .2 Soveltamisohjeen sisältö Kappaleessa Sanoma ja sen soveltamisala on esitetty tämän sanoman käyttötarkoitus, soveltamisen rajaus sekä kehityshankkeen työ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 Tilausmuutosprosessi esitetään tämän dokumentin tietosisällön ja sovellusohjeen pohjana oleva tilausmuutosprosessi, sen osapuolet ja vaiheet muutettaessa sekä pientyö- että projektitilausta. Kappaleessa 4 Sanoman tietosisältö on esitetty tilausmuutossanomassa välitettävien tietojen luettelo sekä pientyö- että projektitilausmuutoksen tapauksessa. Kappaleessa 5 "Tilausmuutossanoman rakenne on esitetty tämän UBL-OrderChangesanoman luokkamalli käyttäen hyväksi UML-kuvauskieltä sekä UBL-sanoman elementtinimillä että niiden sisältämien tietojen nimillä esitettynä. Kappaleessa 6 Sanoman määrittely on esitelty otsikko- ja rivitason sekä laajennusosan rakenne, käytettävät aggregaatit, elementit, attribuutit ja koodit sekä niiden käyttötarkoitus. Kappaleessa 7 Sanomaesimerkki on esitetty kaksi esimerkkiä UBL-OrderChangetilausmuutossanoman käytöstä. Ensimmäisessä esimerkissä esitetään pientyötilauksen muutostietojen välitys ja toisessa esimerkissä mittarointitilauksen muutostietojen välitys. Liitteessä on esitetty kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje..3 Työryhmän työskentelyyn osallistuneet Seuraavassa taulukossa on esitetty yritykset ja organisaatiot, jotka ovat osallistuneet Energiateollisuus ry:n organisoiman projektin Sähkönjakeluyhtiöiden ja palveluntuottajayhtiöiden tietojärjestelmien yhteensopivuus työhön joko sen ohjaus- tai projektiryhmässä. Yritys/Organisaatio Eltel Networks Oy Empower Oy Henkilö Erkki Leinonen Valter Maasalo Anna Tanskanen Otto Tarkiainen Tommi Dahlroos Antti Herranen Juho Kuivalainen 6/32

7 Energiateollisuus ry (SV -toimiala) ENFO Fingrid Oyj Fortum Sähkönsiirto Oy Frends Oy Headpower Oy Helen Sähköverkko Oy Kaupunkiyhtiöt R 2 / Kuopion Energia Oy Logica Suomi Oy Oy Mercus Software Oy STUL Suomen Energia Urakointi Oy Tekla Oy Tieto Oy Vattenfall Verkko Oy Visma Software Oy Voimatel Oy Pertti Lindberg Pertti Markkanen Jari Hirvonen Arto Matsinen Jari Myllylä Antti Toivanen Timo Mutila Jari Martikainen Tuomas Murumäki Osmo Siirto Kari Väänänen Hannu Salonen Valeri Tiik Arto Kari Esa Tiainen Ari Ala-Sippola Taisto Lehonmaa Jukka Pulkkinen Heli Siponen Lauri Anttila Martti Mäkiranta Antti Sulin Vesa Hänninen Olli Lautiainen Markku Manninen Taulukko.3.: Sähkönjakeluyhtiöiden ja palveluntuottajayhtiöiden tietojärjestelmien yhteensopivuus projektin työryhmätyöskentelyyn osallistuneet 7/32

8 2 Dokumentti ja sen yhteydet muihin dokumentteihin 2. Päivitykset Pvm/Laatija Versio Kommentit/muutokset Heikki Laaksamo.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ää aineistoa w3schools XML Tutorial ( ) ebxml Core Components Technical Specification (CCTS) 2.0 ( ) 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 ( ) 2.4 Huomioitavaa Soveltamisohje perustuu UBL 2.0 OrderChange-sanoman määrityksiin. Määrityksissä on huomioitu myös kansainvälisen NES (Northern European Subset) työryhmän suositukset. 8/32

9 3 Tilausmuutosprosessi 3. Prosessin rajaus Tässä prosessikuvauksessa on tarkasteltu ainoastaan tilausmuutosprosessia, jossa tämän dokumentin määrittelemää OrderChange-sanomaa voidaan käyttää. Tarkastelussa oletetaan, että pientyö- tai projektitilausmuutos välitetään tilausmuutosprosessissa sähköisesti osapuolten välillä. Tarkastelusta on jätetty pois tilausmuutoksen välitystä edeltävät vaiheet, kuten tarjouspyynnön ja tarjouksen tekeminen ja käsittely sekä tuote- ja hintalistan käsittely sekä varsinainen tilaaminen. Myös varsinaisen tilausmuutosprosessin jälkeiset vaiheet, kuten tilauksen vahvistus, toimitus ja laskutus ovat rajattu tämän tarkastelun ulkopuolelle. 3.2 Prosessin osapuolet Seuraavassa taulukossa on esitetty tämän prosessin osapuolet. Osapuoli Tilaaja Toimittaja Rooli Osapuoli, joka tekee pientyö- tai projektitilausmuutoksen. Osapuoli, joka lähettää tilausmuutoksen. Osapuoli, joka myy tilaajalle palveluitaan, joilla toteutetaan pientyö tai projekti. Osapuoli, joka vastaanottaa tilausmuutoksen. Osapuoli, joka käsittelee tilausmuutoksen. Osapuoli, joka on vastuussa pientyön tai projektin toteuttamisesta. Taulukko 3.2.: Tilausmuutosprosessin osapuolet 3.3 Pientyötilausmuutosprosessi Kuviossa 3.3. on esitetty pientyötilausmuutosprosessin vaiheet eroteltuna kohdassa 3.2 esitettyjen osapuolien toimintojen mukaan. 9/32

10 Tilaaja Toimittaja Luodaan tilausmuutos Lähetetään tilausmuutos Otetaan vastaan vastaanoton kuittaus Tilausmuutos Tekninen / vastaanoton kuittaus Vastaanotetaan tilausmuutos Kuitataan vastaanotto Käsitellään vastaanoton kuittaus Tarvitaan tarkennuksia Tilausmuutoksen tiedot riittäviä Otetaan vastaan tarkennuspyyntö Tilausmuutoksen tarkennuspyyntö Lähetetään tarkennuspyyntö Käsitellään tilausmuutos Tehdään tilausmuutoksen tarkennus Tilausmuutos hyväksytään Tilausmuutos hylätään Lähetetään tarkennettu tilausmuutos Tarkennettu tilausmuutos Tilauksen vahvistus Hylkäyskäsittely Kuvio 3.3.: Pientyötilausmuutosprosessi 0/32

11 Seuraavassa taulukossa on selitetty kuviossa 3.3. esitetyn pientyötilausmuutosprosessin vaiheet jaoteltuna osapuolten hoitamien toimintojen mukaan. Osapuoli Toiminta Tilaaja Toimittaja Luodaan tilausmuutos Lähetetään tilausmuutos Otetaan vastaan vastaanoton kuittaus Käsitellään vastaanoton kuittaus Otetaan vastaan tarkennuspyyntö Tehdään tilausmuutoksen tarkennus Lähetetään tarkennettu tilausmuutos Vastaanotetaan tilausmuutos Kuitataan vastaanotto Pientilausmuutoksen tietojen riittävyyden tarkastus Tilaaja luo pientyötilauksen muuoksen omassa järjestelmässään. Tilaaja lähettää pientyötilausmuutoksen sähköisesti toimittajalle. Tilaaja ottaa vastaan sanoman vastaanoton kuittauksen, jolla toimittaja ilmoittaa vastaanottaneensa pientyötilausmuutoksen. Tilaaja käsittelee sanoman vastaanoton kuittauksen omissa tietojärjestelmissään. Tilaaja ottaa vastaan pientyötilausmuutoksen tarkennuspyynnön, jolla toimittaja esittää tarkennustarpeensa vastaanottamaansa pientyötilausmuutokseen. Tilaaja tekee pientyötilausmuutokseen toimittajan pyytämät tarkennukset. Tilaaja lähettää tarkennetun pientyötilausmuutoksen sähköisesti toimittajalle. Toimittaja vastaanottaa pientyötilausmuutoksen. Toimittaja kuittaa vastaanottaneensa pientyötilausmuutoksen lähettämällä tilaajalle sanoman vastaanoton kuittauksen. Toimittaja tarkastaa pientyötilauksen muuoksen tietosisällön. Tietosisällön tarkastuksen tuloksena havaitaan, että pientyötilausmuutoksen tietosisältö on riittävä tilausmuutoksen käsittelyä varten pientyötilausmuutokseen tarvitaan tarkennuksia, koska sen tietosisällöstä puuttuu tietoja, joita tarvitaan pientyötilausmuutoksen käsittelyä varten /32

12 Lähetetään tarkennuspyyntö Käsitellään tilausmuutos Tilausmuutoksen hylkääminen Tilausmuutoksen hyväksyminen Toimittaja lähettää tilaajalle tilausmuutoksen tarkennuspyynnön, jossa esitetään niiden puutteiden täydentämistä, jotka havaittiin pientilauksenmuutoksen tietosisällön tarkastuksessa. Toimittaja käsittelee pientyötilausmuutoksen, jonka tietosisältö on riittävä käsittelyn kannalta Toimittaja ilmoittaa pientyötilausmuutoksen hylkäämisestä tilaajalle sovitulla tavalla. Hylkäämisilmoitusprosessi ei kuulu tarkasteltavaan prosessiin. Toimittaja vahvistaa pientyötilausmuutoksen tilaajalle sovitulla tavalla. Tilausvahvistusprosessi ei kuulu tarkasteltavaan prosessiin. Taulukko 3.3.: Pientyötilausmuutosprosessin osapuolikohtaiset vaiheet 3.4 Projektitilausmuutosprosessi Kuviossa 3.4. on esitetty projektitilausmuutosprosessin vaiheet eroteltuna kohdassa 3.2 esitettyjen osapuolien toimintojen mukaan. 2/32

13 Tilaaja Toimittaja Luodaan tilausmuutos Lähetetään tilausmuutos Tilausmuutos Vastaanotetaan tilausmuutos Otetaan vastaan vastaanoton kuittaus Käsitellään vastaanoton kuittaus Tekninen / vastaanoton kuittaus Kuitataan vastaanotto Verrataan tilausmuutosta tarjoukseen Tilausmuutos vastaa tarjousta Tilausmuutos ei vastaa tarjousta Hylkäyskäsittely Tilausmuutoksen vahvistus Kuvio 3.4.: Projektitilausmuutosprosessi 3/32

14 Seuraavassa taulukossa on selitetty kuviossa 3.4. esitetyn projektitilausmuutosprosessin vaiheet jaoteltuna osapuolten hoitamien toimintojen mukaan. Osapuoli Toiminta Tilaaja Toimittaja Luodaan tilausmuutos Lähetetään tilausmuutos Vastaanotetaan vastaanoton kuittaus Käsitellään vastaanoton kuittaus Vastaanotetaan tilausmuutos Kuitataan vastaanotto Verrataan tilausmuutosta tarjoukseen Tilausmuutoksen hylkääminen Tilausmuutoksen hyväksyminen Tilaaja luo projektitilausmuutoksen omassa järjestelmässään. Tilaus ja sen muutos perustuvat aiemmin vastaanotettuun projektitarjoukseen. Projektitarjouksen teko ja vastaanotto eivät sisälly tähän prosessiin. Tilaaja lähettää projektitilausmuutoksen sähköisesti toimittajalle. Tilaaja ottaa vastaan sanoman vastaanoton kuittauksen, jolla toimittaja ilmoittaa vastaanottaneensa projektitilausmuutoksen. Tilaaja käsittelee sanoman vastaanoton kuittauksen omissa tietojärjestelmissään. Toimittaja vastaanottaa projektitilausmuutoksen. Toimittaja kuittaa vastaanottaneensa projektitilausmuutoksen lähettämällä tilaajalle sanoman vastaanoton kuittauksen. Toimittaja tarkastaa projektitilausmuutoksen ja vastaavan tarjouksen vastaavuuden. Tarkastuksen tuloksena havaitaan, että projektitilausmuutos vastaa tarjousta projektitilausmuutos ei vastaa tarjousta Toimittaja ilmoittaa tilaajalle sovitulla tavalla, ettei projektitilausmuutos vastaa tarjousta, ja hylkää tilausmuutoksen. Hylkäämisprosessiin kuuluu mahdollinen uusi tarjouskierros, uuden tilauksen lähetyksen pyytäminen tai koko tilausprosessin päättäminen. Hylkäämisilmoitusprosessi ei kuulu tarkasteltavaan prosessiin. Toimittaja vahvistaa projektitilausmuutoksen tilaajalle sovitulla tavalla. Tilausvahvistusprosessi ei kuulu tarkasteltavaan prosessiin. Taulukko 3.3.: Projektitilausmuutosprosessin osapuolikohtaiset vaiheet 4/32

15 4 Sanoman tietosisältö Seuraavassa taulukossa on esitetty pientyö- / projektitilausmuutossanoman tietosisältö sekä sanoman aggregaatti, jossa kyseinen tieto sijaitsee sanomassa. Kolmannessa ja neljännessä sarakkeessa on ilmoitus, esiintyykö tieto pientyö- tai projektitilausmuutoksessa. Viidennessä sarakkeessa on esitetty linkkinä viittaus kappaleessa 6 Sanoman määrittely olevaan kyseistä aggregaattia esittelevään alakappaleeseen. Kuudennessa sarakkeessa on esitetty tiedon pakollisuus energiateollisuuden käyttämän tilausmuutossanoman välitysprosessissa (P = pakollinen, V = valinnainen, R = ehdollinen (tiedon esiintyminen sanomassa riippuu jonkin toisen tiedon esiintymisestä)). 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. 5/32

16 TIETO Aggregaatti Pientyötilaus Projektitilaus Kappale P/V Sanoman versio Order Change X X 6.. P Soveltamisohjeen kehittäjä Order Change X X 6.. P Soveltamisohjeen tunnus Order Change X X 6.. P Tilausmuutoksen tunnus Order Change X X 6.. P Tilausmuutoksen päivämäärä Order Change X X 6.. P Tilausmuutoksen kellonaika Order Change X X 6.. V Yleistä tietoa Order Change X X 6.. V Viitetiedot Muutettavan tilauksen tunnus eli hanketunnus Tarjouksen tunnus Ylätason tilaus ID (parent) Ylätason tilauksen tyyppi Ylätason tilauksen tyypin nimi Liitetiedosto Order Change. Order Reference X X 6..2 P Order Change. Quotation_ Document Reference. Document Reference Order Change. Additional_ Document Reference. Document Reference Order Change. Additional_ Document Reference. Document Reference Order Change. Additional_ Document Reference. Document Reference Order Change. Additional_ Document Reference. Document Reference. Attachment X 6..3 V X X 6..4 V X X 6..4 V X X 6..4 V X X 6..5 V 6/32

17 Liitetiedoston web-osoite Tilaajan tiedot Tilaajayrityksen tunniste (OVT) Tilaajayrityksen nimi Ilmoittaja eli yhteyshenkilö Yhteysosasto Puhelinnumero Sähköpostiosoite Order Change. Additional_ Document Reference. Document Reference. Attachment. External Reference Order Change. Buyer_ Customer Party. Customer Party Order Change. Buyer_ Customer Party. Customer Party. Party. Party Identification Order Change. Buyer_ Customer Party. Customer Party. Party. Party Name Order Change. Buyer_ Customer Party. Customer Party. Party. Contact Order Change. Buyer_ Customer Party. Customer Party. Party. Contact Order Change. Buyer_ Customer Party. Customer Party. Party. Contact Order Change. Buyer_ Customer Party. Customer Party. Party. Contact X X 6..5 V X X 6..7 P X X 6..9 P X X 6..0 V X X 6.. P X X 6.. V X X 6.. V X X 6.. V Toimittajan tiedot Order Change. Seller_ Supplier Party. Supplier Party X X 6..2 P Toimittajayrityksen tunniste (OVT) Toimitajayrityksen nimi Työn suorittamistiedot Työkohteen paikkatiedot Order Change. Seller_ Supplier Party. Supplier Party. Party. Party Identification Order Change. Seller_ Supplier Party. Supplier Party. Party. Party Name X X 6..4 P X X 6..5 V Työkohteen tunnus Order Change. Delivery. Delivery_ Location. Location X X 6..7 V 7/32

18 Työkohde tekstimuotoisena Order Change. Delivery. Delivery_ Location. Location X X 6..7 V Käyttöpaikan tunnus Työkohteen sijaintihuone Työkohteen lähiosoite Työkohteen osoitteen postitoimipaikka Työkohteen osoitteen postinumero Työkohteena olevan laitteen käyttöpaikan nimi Työkohteen sijaintikoordinaatiston tunnus Työkohteen paikan X-koordinaatti (asteet ja minuutit) Työkohteen paikan Y-koordinaatti (asteet ja minuutit) Työkohteen aikatiedot Hankkeen alkurajapäivämäärä Hankkeen loppurajapäivämäärä Tilaajan toimittamien tarvikkeiden toimituspäivämäärä (Materiaalitoimitus päivämäärä) Order Change. Delivery. Delivery_ Location. Location. Address Order Change. Delivery. Delivery_ Location. Location. Address Order Change. Delivery. Delivery_ Location. Location. Address Order Change. Delivery. Delivery_ Location. Location. Address Order Change. Delivery. Delivery_ Location. Location. Address Order Change. Delivery. Delivery_ Location. Location. Address. Address Line Order Change. Delivery. Delivery_ Location. Location. Address. Location Coordinate Order Change. Delivery. Delivery_ Location. Location. Address. Location Coordinate Order Change. Delivery. Delivery_ Location. Location. Address. Location Coordinate Order Change. Delivery. Requested Delivery_ Period. Period Order Change. Delivery. Requested Delivery_ Period. Period Order Change. Delivery. Promised Delivery_ Period. Period 8/32 X X 6..8 V X X 6..8 V X X 6..8 V X X 6..8 V X X 6..8 V X X 6..9 V X X V X X V X X V X X 6..2 V X X 6..2 V X X V

19 Suunniteltu kohteen käyttöönottopäivä (Luvattu käyttöönottopäivä) Materiaalin purkauspaikka (Materiaalin toimitusosoite) Toimitusosoitteen tunniste (OVT) Toimitusosoitteen nimi Toimitusosoitteen osoite Toimitusosoitteen maa Toimitusosoitteen sijaintikoordinaatiston tunnus Order Change. Delivery. Estimated Delivery_ Period. Period X X V Order Change. Delivery. Delivery_ Party. Party X X V Order Change. Delivery. Delivery_ Party. Party. Party Identification Order Change. Delivery. Delivery_ Party. Party. Party Name Order Change. Delivery. Delivery_ Party. Party. Postal_ Address. Address Order Change. Delivery. Delivery_ Party. Party. Postal_ Address. Address. Country Order Change. Delivery. Delivery_ Party. Party. Postal_ Address. Address. Location Coordinate X X V X X V X X V X X V X X V Toimitusosoitteen X-koordinaatti (asteet ja minuutit) Toimitusosoitteen Y-koordinaatti (asteet ja minuutit) Order Change. Delivery. Delivery_ Party. Party. Postal_ Address. Address. Location Coordinate Order Change. Delivery. Delivery_ Party. Party. Postal_ Address. Address. Location Coordinate X X V X X V Rivitason tiedot 6.2 Tilausrivin lisätietoa Order Change. Order Line X X 6.2. V Työyksikkökäsittelyn rivinumero eli tilaajan rivinumero Order Change. Order Line. Line Item X X P Tehtävän paikkatiedot 0 Työkohteen tunnus Order Change. Order Line. Line Item. Delivery. X X V 9/32

20 Työkohde tekstimuotoisena Käyttöpaikan tunnus Työkohteen sijaintihuone Työkohteen lähiosoite Työkohteen osoitteen postitoimipaikka Työkohteen osoitteen postinumero Työkohteena olevan laitteen käyttöpaikan nimi Työkohteen sijaintikoordinaatiston tunnus Työkohteen paikan X-koordinaatti (asteet ja minuutit) Työkohteen paikan Y-koordinaatti (asteet ja minuutit) Työnsuorittamisen aikatiedot Työn alkurajapäivämäärä Delivery_ Location. Location Order Change. Order Line. Line Item. Delivery. Delivery_ Location. Location Order Change. Order Line. Line Item. Delivery. Delivery_ Location. Location. Address Order Change. Order Line. Line Item. Delivery. Delivery_ Location. Location. Address Order Change. Order Line. Line Item. Delivery. Delivery_ Location. Location. Address Order Change. Order Line. Line Item. Delivery. Delivery_ Location. Location. Address Order Change. Order Line. Line Item. Delivery. Delivery_ Location. Location. Address Order Change. Order Line. Line Item. Delivery. Delivery_ Location. Location. Address. Address Line Order Change. Order Line. Line Item. Delivery. Delivery_ Location. Location. Address. Location Coordinate Order Change. Order Line. Line Item. Delivery. Delivery_ Location. Location. Address. Location Coordinate Order Change. Order Line. Line Item. Delivery. Delivery_ Location. Location. Address. Location Coordinate Order Change. Order Line. Line Item. Delivery. Requested Delivery_ Period. Period X X V X X V X X V X X V X X V X X V X X X X V X X V X X V X X V V 20/32

21 Työn loppurajapäivämäärä Suunniteltu kohteen käyttöönottopäivä (Luvattu käyttöönottopäivä) Tuote- eli nimiketiedot Order Change. Order Line. Line Item. Delivery. Requested Delivery_ Period. Period Order Change. Order Line. Line Item. Delivery. Estimated Delivery_ Period. Period X X V X X V Nimike tekstimuodossa Order Change. Order Line. Line Item. Item X X V Työyksikön kuvaus (pitkä teksti) Order Change. Order Line. Line Item. Item X X V Nimikkeeseen liittyvää yleistä tekstiä Order Change. Order Line. Line Item. Item X X V Tilaajan tuotekoodi eli nimike (Tilaajan tuotenimike) Tuotekoodi eli nimike (Sähköalan nimike) Order Change. Order Line. Line Item. Item. Buyers_ Item Identification. Item Identification Order Change. Order Line. Line Item. Item. Standard_ Item Identification. Item Identification X X 6.2. P(R) X X P(R) Tilausmuutosrivin viitteet Tilausmuutosrivin viitteen tunnus Order Change. Order Line. Document Reference X X V Tilausrivin liitetiedosto Tilausrivin liitetiedoston web-osoite Order Change. Order Line. Document Reference. Attachment Order Change. Order Line. Document Reference. Attachment. External Reference X X V X X V HUOMAUTUS: Mittarointiin voi tulla muutos vain mittaroinnin suorittamisajankohtaan rivitasolla. 2/32

22 5 Tilausmuutossanoman rakenne 5. Luokkamalli Tässä kappaleessa esitetään UBL 2.0 OrderChange-sanoman rakenne käyttäen hyväksi UML-luokkamallia. Mallissa on esitetty sanoma vain niiltä osin kuin sen tietosisältö on määritelty Energiateollisuus ry:n organisoimassa projektissa Sähkönjakeluyhtiöiden ja palveluntuottajayhtiöiden tietojärjestelmien yhteensopivuus. Kuviossa 5.. on esitetty tilausmuutossanoman otsikkotason luokkamalli ja kuviossa 5..2 tilausmuutossanoman rivitason luokkamalli. PartyIdentification -ID PartyName OrderReference -ID -DocumentTypeCode OrderLine -Note OrderChange -UBLVersionNumber -CustomizationID -ProfileID -ID -IssueDate -IssueTime -Note +Seller +Buyer CustomerParty SupplierParty..* Party +Delivery -Name +Quotation DocumentReference -ID -DocumentTypeCode -DocumentType +Additional Contact -ID -Name -Telephone -ElectronicMail +Postal Attachment -EmbeddedDocumentBinaryObject..* Address -ID -Room -StreetName -CityName -PostalZone +PromisededDelivery -StartDate -EndDate Delivery Period +RequestedDelivery +EstimatedDelivery +Delivery ExternalReference -URI Location -ID -Description Country -IdentificationCode -Line AddressLine Location Coordinate -CoordinateSystemCode -LatitudeDegreesMeasure -LatitudeMinutesMeasure -LatitudeDirectionCode -LongitudeDegreesMeasure -LongitudeMinutesMeasure -LongitudeDirectionCode Kuvio 5..: Tilausmuutossanoman otsikkotason luokkamalli 22/32

23 DocumentReference -ID -DocumentTypeCode -DocumentType OrderLine -Note AddressLine -Line Attachment -EmbeddedDocumentBinaryObject ExternalReference -URI -ID LineItem Delivery +Delivery Location -ID -Description Address -ID -Room -StreetName -CityName -PostalZone +RequestedDelivery +Buyers Item -Description -Name -AdditionalInformation ItemIdentification -ID +Standard +Manufacturers ItemInstance -SerialID Period -StartDate -EndDate PhysicalAttribute -AttributeID -DescriptionCode -Description +EstimatedDelivery Location Coordinate -CoordinateSystemCode -LatitudeDegreesMeasure -LatitudeMinutesMeasure -LatitudeDirectionCode -LongitudeDegreesMeasure -LongitudeMinutesMeasure -LongitudeDirectionCode Kuvio 5..2: Tilausmuutossanoman rivitason luokkamalli 5.2 Tietojen suhde toisiinsa Tässä luvussa esitetään tilausmuutossanoman tietojen suhteet toisiinsa käyttäen UMLluokkamallia. Kuvioissa on esitetty tiedot niillä nimillä, joilla ne esiintyvät kappaleessa 6 esiintyvien taulukoiden -osissa, joissa esitetään suomeksi aggregaattien ja elementtien käyttöä. Kuviossa 5.2. on esitetty tilausmuutossanoman otsikkotason tietojen suhteet ja kuviossa tilausmuutossanoman rivitason tietojen suhteet. 23/32

24 Muutettavan tilauksen tiedot -Tunnus -Tilauksen tyyppi Tunnustiedot -Tunnus Nimitiedot -Nimi..* Tilausmuutosrivi -Lisätiedot Tilausmuutos -UBL version numero -Sovellusohjeen kehittäjä -Sovellusohjeen tunnus -Tilausmuutoksen tunnus -Tilausmuutoksen päivämäärä -Tilausmuutoksen kellonaika -Yleistä tietoa +Tarjous Viitetiedot -Tunnus -Viitteen tyyppikoodi -Viitteen tyyppi Tilaaja Toimittaja +Muut..* Osapuolitiedot +Toimitusosoite -Tunnus -Nimi -Puhelin -Sähköposti Yhteystiedot Liite -Sisäinen liite..* Osoitetiedot -Tunnus -Huone -Katuosoite -Postitoimipaikkas -Postinumero Toimitustiedot Ulkoinen liite -URI Laitteen käyttöpaikka -Käyttöpaikan nimi +Suorittaminen +Materiaalitoimitus Ajanjaksotiedot -Alkupäivä -Loppupäivä +Käyttöönotto Toimintopaikka -Tunnus - Maatiedot -Maakoodi Sijaintikoordinaatit -Koordinaatistosysteemi -Leveyskoordinaatin asteet -Leveyskoordinaatin minuutit -Leveyskoordinaatin suunta -Pituuskoordinaatin asteet -Pituuskoordinaatin minuutit -Pituuskoordinaatin suunta Kuvio 5.2.: Tilausmuutossanoman otsikkotason tietojen suhteet 24/32

25 Viitetiedot -Tunnus -Viitteen tyyppikoodi -Viitteen tyyppi Tilausmuutosrivi -Lisätiedot Laitteen käyttöpaikka -Käyttöpaikan nimi Liite -Sisäinen liite Ulkoinen liite -URI Tehtävän tiedot -Tilausmuutosrivin tunnus Toimitustiedot Toimintopaikka -Tunnus - Osoitetiedot -Tunnus -Huone -Katuosoite -Postitoimipaikkas -Postinumero Tuotetiedot -Työyksikön kuvaus -Tuotenimi -Lisätieto Valmistusnumerotiedot -Valmistusnumero +Suorittaminen Ajanjaksotiedot -Alkupäivä -Loppupäivä +Käyttöönotto Sijaintikoordinaatit -Koordinaatistosysteemi -Leveyskoordinaatin asteet -Leveyskoordinaatin minuutit -Leveyskoordinaatin suunta -Pituuskoordinaatin asteet -Pituuskoordinaatin minuutit -Pituuskoordinaatin suunta +Sähköalan +Valmistajan Nimiketiedot -Tunnus +Tilaajan Laitetyypin tiedot -Ominaisuus -Laitetyyppikoodi -Laitetyypin nimi Kuvio 5.2.2: Tilausmuutossanoman rivitason tietojen suhteet 25/32

26 6 Sanoman määrittely Tässä kappaleessa on esitelty UBL-OrderChange-tilausmuutossanoman rakenne, käytettävät aggregaatit, elementit, attribuutit ja koodit sekä niiden käyttötarkoitus niiltä osin, kuin ne on määritelty Energiateollisuus ry:n organisoimassa projektissa Sähkönjakeluyhtiöiden ja palveluntuottajayhtiöiden tietojärjestelmien yhteensopivuus. Kappaleessa esiintyvien taukoiden lukuohje on kappaleessa Liite : Kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje. 6. Sanoman otsikkotaso Sanoman otsikkotasolla välitetään koko dokumenttia koskevat tiedot, kuten dokumentin tunniste, päiväys, viitetiedot, koko tilausmuutosta koskevat osapuolitiedot sekä työnsuorittamiseen tarvittavat paikkaan ja aikaan liittyvät muutostiedot. 26/32

27 6.. Tilausmuutossanoma (Order Change. Details) Order Change. Details Order Change. UBL Version Identifier. Identifier Order Change. Customization Identifier. Identifier Order Change. Profile Identifier. Identifier Order Change. Identifier Order Change. Sales Order Identifier. Identifier Order Change. Copy_ Indicator. Indicator Order Change. UUID. Identifier Order Change. Issue Date. Date Order Change. Issue Time. Time Order Change. Sequence_ Number. Identifier Order Change. Note. Text Order Change. Requested Invoice_ Currency Code. Code Order Change. Document_ Currency Code. Code Order Change. Pricing_ Currency Code. Code Order Change. Tax_ Currency Code. Code Order Change. Customer Reference. Text Order Change. Accounting Cost Code. Code Order Change. Accounting Cost. Text Order Change. Line Count. Numeric Order Change. Validity_ Period. Period Order Change. Order Reference Order Change. Quotation_ Document Reference. Document Reference Order Change. Originator_ Document Reference. Document Reference Order Change. Additional_ Document Reference. Document Reference Order Change. Contract Order Change. Signature Order Change. Buyer_ Customer Party. Customer Party Order Change. Seller_ Supplier Party. Supplier Party Order Change. Originator_ Customer Party. Customer Party Order Change. Freight Forwarder_ Party. Party Order Change. Accounting_ Customer Party. Customer Party Order Change. Accounting_ Supplier Party. Supplier Party Order Change. Delivery Order Change. Delivery Terms Order Change. Payment Means Order Change. Transaction Conditions Order Change. Allowance Charge Order Change. Destination_ Country. Country Order Change. Tax Total Order Change. Anticipated_ Monetary Total. Monetary Total..* Order Change. Order Line Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki 27/32

28 Order Change. Details Order Change. UBL Version Identifier. Identifier Order Change. Customization Identifier. Identifier Order Change. Profile Identifier. Identifier Identification Scheme Agency. Identifier Tällä aggregaatilla annetaan tilausmuutossanoman tiedot, joilla muutetaan aiemmin lähetetyn tilauksen tietoja. Huomautus Tällä sanomalla muutetaan ainoastaan paikka- ja aikatietoja. Esimerkki <Order> </Order> 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> Identifier. Type Elementillä annetaan sanoman soveltamiohjeen kehittäjän nimi. Esimerkki <cbc:customizationid>et</cbc:customizationid> Identifier. Type TIEKE ry:n soveltamisohjeelle antama tunnus, joka on vakiosti FI035. Attribuutit schemeagencyid Esimerkki <cbc:profileid schemeagencyid="292">fi035 </cbc:profileid> Attribuutilla annetaan soveltamisohjeluettelon ylläpitäjän tunnus. Esimerkki schemeagencyid="292" Käytettävät koodit Order Change. Identifier Toisto.. Order Change. Issue Date. Date 292 (FI, TIEKE The Information Technology Development Centre of Finland) TIEKE Tietoyhteiskunnan kehittämiskeskus ry Identifier. Type Pientyö- tai projektitilausmuutoksen yksilöivät tunnus. Tämä tunnus välittyy hankkeen eri sanomissa liittäen myöhemmin muut lähetettävät sanomat tähän tilausmuutokseen. Esimerkki <cbc:id>234-c</cbc:id> Toisto.. Date. Type Elementillä annetaan tilausmuutoksen päivämäärä. On 28/32

29 Order Change. Issue Time. Time suositeltavaa, että päivämäärä on sama, jonka tilausmuutoksen sisällöstä vastaava henkilö voi nähdä järjestelmästään muutoksentekopäivämääränä, eikä tilausmuutossanoman 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> Time. Type Elementillä annetaan tilausmuutoksen luontikelloaika, siis muutoshetken tunnit, minuutit ja sekunnit. On suositeltavaa, että ajanhetki on sama, jonka tilausmuutoksen sisällöstä vastaava henkilö voi nähdä järjestelmästään muutoksentekoajanhetkenä, eikä tilausmuutossanoman muodostamisajanhetki, joka voi poiketa tästä ajanhetkestä. 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>0:3:02</cbc:issuetime> Order Change. Note. Text Toisto 0.. unbounded Text. Type Attribuutit languageid Elementillä annetaan tilausmuutokseen liittyvää yleistä tietoa, jota ei voida antaa OrderChange-sanoman muiden elementtien arvona, kuten työtilauksen kuvaus. Esimerkki <cbc:note languageid="fi">varoituslaatan asennus </cbc:note> Language. Identifier Order Change. Order Reference Tilauksen vapaamuotoisen tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Toisto.. Order Reference. Details 29/32

30 6..2 Tällä aggregaatilla annetaan muutettavan, alkuperäisen Order Change. Quotation_ Document Reference. Document Reference 6..3 Order Change. Additional_ Document Reference. Document Reference 6..4 Order Change. Buyer_ Customer Party. Customer Party 6..7 Order Change. Seller_ Supplier Party. Supplier Party 6..2 Order Change. Delivery 6..6 Order Change. Order Line 6.2. tilauksen eli hankkeen tunnistetiedot. Esimerkki <cac:orderreference> </cac:orderreference> Document Reference. Details Tällä aggregaatilla annetaan sen tarjouksen tunnistetiedot, johon projektitilaus ja sen muutos perustuu. Esimerkki <cac:quotationdocumentreference> Toisto </cac:quotationdocumentreference> 0.. unbounded Document Reference. Details Aggregaatilla annetaan tilaukseen ja sen muutokseen liittyviä muita viitteitä kuin tarjous tai alkuperäinen tilaus. Esimerkki <cac:additionaldocumentreference> Toisto.. </cac:additionaldocumentreference> Customer Party. Details Huomautus Aggregaatilla annetaan tilaajaorganisaation tiedot. Esimerkki <cac:buyercustomerparty> </cac:buyercustomerparty> Toisto.. Supplier Party. Details Aggregaatilla annetaan toimittajaorganisaation tiedot. Esimerkki <cac:sellersupplierparty> </cac:sellersupplierparty> Toisto Esimerkki Toisto 0.. unbounded Delivery. Details Aggregaatilla annetaan materiaalin toimittamiseen liittyviä muutostietoja, kuten muuttunut materiaalin toimituspäivä ja -osoite. <cac:delivery> </cac:delivery>.. unbounded Order Line. Details Aggregaatilla annetaan tilausmuutoksen tilausrivin tiedot. Esimerkki <cac:orderline> </cac:orderline> 30/32

31 6..2 Muutettavan tilauksen eli hankkeen tunnus (Order Change. Order Reference) Order Change. Order Reference Order Reference. Identifier Order Reference. Sales Order Identifier. Identifier Order Reference. Copy_ Indicator. Indicator Order Reference. UUID. Identifier Order Reference. Issue Date. Date Order Reference. Issue Time. Time Order Reference. Customer_ Reference. Text Order Reference. Document Reference Elementti / aggregaatti Order Change. Order Reference Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. Order Reference. Identifier Toisto.. Document Reference. Document Type Code. Code Order Reference. Details Tällä aggregaatilla annetaan muutettavan, alkuperäisen tilauksen eli hankkeen tunnistetiedot. Esimerkki <cac:orderreference> </cac:orderreference> Identifier. Type Elementillä annetaan muutettavan, alkuperäisen tilauksen eli hankkeen tunnus. Esimerkki <cbc:id>234-ab</cbc:id> Code. Type Elementillä annetaan alkuperäisen tilauksen tyyppi koodimuotoisena; 220 = (Order) Tilaus Attribuutit listid ja listagencyid Esimerkki Code List. Identifier Code List. Agency. Identifier Oletusarvo UN/ECE 00 <cbc:documenttypecode listid= UN/ECE00" listagencyid="6">220</cbc:documenttypecode> Attribuutilla annetaan tilaustyyppikoodiston tunnus. Esimerkki listid="un/ece 00" Käytettävät koodit UN/ECE 00 UN/ECE koodisto 00 "Document name code" Oletusarvo 6 Attribuutilla annetaan tilaustyyppikoodiston ylläpitäjän tunnus 3/32

32 Esimerkki listagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) 32/32

33 6..3 Tarjous (Order Change. Quotation_ Document Reference. Document Reference) Order Change. Quotation_ Document Reference. Document Reference Document Reference. Identifier Document Reference. Copy_ Indicator. Indicator Document Reference. UUID. Identifier Document Reference. Issue Date. Date Document Reference. Document Type Code. Code Document Reference. Document Type. Text Document Reference. XPath. Text Document Reference. Attachment Elementti / aggregaatti Order Change. Quotation_ Document Reference. Document Reference Document Reference. Identifier Document Reference. Document Type Code. Code Toistokerrat, tyyppi, kuvaus, esimerkki Document Reference. Details Tällä aggregaatilla annetaan sen tarjouksen tunnistetiedot, johon projektitilaus ja sen muutos perustuu. Esimerkki <cac:quotationdocumentreference> Toisto.. </cac:quotationdocumentreference> Identifier. Type Elementillä annetaan sen tarjouksen tunnus, johon projektitilaus ja sen muutos perustuu. Esimerkki <cbc:id>267b/09</cbc:id> Code. Type Elementillä annetaan tarjouksen tyyppi koodimuotoisena: 30 = (Offer / quotation) Tarjous Attribuutit listid ja listagencyid Esimerkki Code List. Identifier Code List. Agency. Identifier Oletusarvo UN/ECE 00 <cbc:documenttypecode listid= UN/ECE00" listagencyid="6">30</cbc:documenttypecode> Attribuutilla annetaan tarjoustyyppikoodiston tunnus. Esimerkki listid="un/ece 00" Käytettävät koodit UN/ECE 00 UN/ECE koodisto 00 "Document name code" Oletusarvo 6 Attribuutilla annetaan tarjoustyyppikoodiston ylläpitäjän tunnus Esimerkki listagencyid="6" 33/32

34 Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) 34/32

35 6..4 Muut viitteet (Order Change. Additional_ Document Reference. Document Reference) Order Change. Additional_ Document Reference. Document Reference Document Reference. Identifier Document Reference. Copy_ Indicator. Indicator Document Reference. UUID. Identifier Document Reference. Issue Date. Date Document Reference. Document Type Code. Code Document Reference. Document Type. Text Document Reference. XPath. Text Document Reference. Attachment Elementti / aggregaatti Order Change. Additional_ Document Reference. Document Reference Document Reference. Identifier Document Reference. Document Type Code. Code Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Document Reference. Details Aggregaatilla annetaan tilaukseen ja sen muutokseen liittyviä muita viitteitä kuin tarjous tai alkuperäinen tilaus. Esimerkki <cac:additionaldocumentreference> </cac:additionaldocumentreference> Toisto.. Identifier. Type Elementillä annetaan tilausmuutoksen viitteen tunnus. Huomautus Tämä elementti on pakollinen. Jos tilausmuutokseen ei liity viitettä, vaan aggregaatin ala-aggregaateilla välitetään sanoman liitetiedostoja tai Internet-osoitteita, annetaan tämän elementin arvona merkkijono XXXXXX Esimerkki <cbc:id>22</cbc:id> Code. Type Elementillä annetaan tilauksen muutoksen viitteen tyyppi koodimuotoisena. Huomautus Elementin arvoja on kahdessa eri koodistossa. OASIS on määritellyt UN/ECE koodiston "00 Document name code" oletusarvoiseksi koodistoksi. Jos tästä koodistosta ei löydy sopivaa koodia, voidaan käyttää UN/ECE koodistoa 53 Reference qualifier". Koodit UN/ECE koodiston 00 mukaisia koodeja ovat: 226 = (Call off order) Ylätason tilaus Attribuutit listid ja listagencyid 35/32

36 Esimerkki Code List. Identifier Code List. Agency. Identifier Document Reference. Document Type. Text <cbc:documenttypecode listid= UN/ECE00" listagencyid="6">226</cbc:documenttypecode> Attribuutilla annetaan viitteen tunnuskoodiston tunnus; joko UN/ECE 00 tai UN/ECE 53 Esimerkki listid="un/ece 00" Käytettävät koodit UN/ECE 00 UN/ECE koodisto 00 "Document name code" UN/ECE 53 UN/ECE koodisto 53 "Reference qualifier" Attribuutilla annetaan viitteen tunnuskoodiston ylläpitäjän tunnus Esimerkki listagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) Text. Type Elementillä annetaan tilausmuutoksen viitteen tyyppi tekstimuotoisena. Attribuutit languageid Language. Identifier Document Reference. Attachment 6..5 Esimerkki <cbc:documenttype languageid="fi">ylätason tilaus </cbc:documenttype> Tilausmuutoksen viitteen tekstimuotoisen tyypin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla. Esimerkki languageid="fi" Attachment. Details Aggregaatilla annetaan tilausmuutokseen liittyvä liite. Huomautus Lähetettävien liitetiedostojen koosta partnereitten on sovittava keskenään, jotta tietokoneitten kapasiteetti ei kuormittuisi liikaa sanoman prosessoinnissa. Esimerkki <cac:attachment> </cac:attachment> 36/32

37 6..5 Liitetiedosto (Document Reference. Attachment) Document Reference. Attachment Attachment. Embedded_ Document. Binary Object Attachment. External Reference Elementti / aggregaatti Document Reference. Attachment Attachment. Embedded_ Document. Binary Object Attachment. External Reference 6..6 Toistokerrat, tyyppi, kuvaus, esimerkki Attachment. Details Aggregaatilla annetaan tilausmuutokseen liittyvä liite. Huomautus Lähetettävien liitetiedostojen koosta partnereitten on sovittava keskenään, jotta tietokoneitten kapasiteetti ei kuormittuisi liikaa sanoman prosessoinnissa. Esimerkki <cac:attachment> </cac:attachment> Binary Object. Type Elementillä annetaan tilausmuutoksen liite sanoman sisäisenä binäärisenä suurena oliona (Binary Large Object eli BLOB). Esimerkki <cbc:embeddeddocumentbinaryobject> liitetiedosto binäärisenä suurena oliona </cbc:embeddeddocumentbinaryobject> External Reference. Details Aggregaatilla annetaan tilausmuutokseen liittyvän liitetiedoston web-osoitetiedot. Esimerkki <cac:externalreference> </cac:externalreference> 37/32

38 6..6 Liitetiedoston web-osoite (Attachment. External Reference) Attachment. External Reference External Reference. URI. Identifier External Reference. Document Hash. Text External Reference. Expiry Date. Date External Reference. Expiry Time. Time Elementti / aggregaatti Attachment. External Reference External Reference. URI. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki External Reference. Details Aggregaatilla annetaan tilausmuutokseen liittyvän liitetiedoston web-osoitetiedot. Esimerkki <cac:externalreference> </cac:externalreference> Identifier. Type Elementillä annetaan tilausmuutoksen liitetiedoston web-osoite eli URI (Uniform Resource Identifier) Esimerkki <cbc:uri> 38/32

39 6..7 Tilaajan tiedot (Order Change. Buyer_ Customer Party. Customer Party) Order Change. Buyer_ Customer Party. Customer Party Customer Party. Customer Assigned_ Account Identifier. Identifier Customer Party. Supplier Assigned_ Account Identifier. Identifier Customer Party. Additional_ Account Identifier. Identifier Customer Party. Party Customer Party. Delivery_ Contact. Contact Customer Party. Accounting_ Contact. Contact Customer Party. Buyer_ Contact. Contact Elementti / aggregaatti Order Change. Buyer_ Customer Party. Customer Party Customer Party. Party 6..8 Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. Customer Party. Details Huomautus Aggregaatilla annetaan tilaajaorganisaation tiedot. Esimerkki <cac:buyercustomerparty> </cac:buyercustomerparty> Party. Details Aggregaatilla annetaan tilaajaorganisaation nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:party> </cac:party> 39/32

40 6..8 Tilaaja (Customer Party. Party) Customer Party. Party Party. Mark Care_ Indicator. Indicator Party. Mark Attention_ Indicator. Indicator Party. Website_ URI. Identifier Party. Logo Reference. Identifier Party. Endpoint Identifier. Identifier Party. Party Identification Party. Party Name Party. Language Party. Postal_ Address. Address Party. Physical_ Location. Location Party. Party Tax Scheme Party. Party Legal Entity Party. Contact Party. Person Party. Agent_ Party. Party Elementti / aggregaatti Customer Party. Party Party. Party Identification 6..9 Party. Party Name 6..0 Toistokerrat, tyyppi, kuvaus, esimerkki Party. Details Aggregaatilla annetaan tilaajaorganisaation nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:party> </cac:party> Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan tilaajaorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto 0.. unbounded Party Name. Details Aggregaatilla annetaan tilaajaorganisaation nimitiedot. 40/32

41 Party. Contact 6.. Esimerkki <cac:partyname> </cac:partyname> Contact. Details Aggregaatilla annetaan tilaajaorganisaation yhteyshenkilön tai -osaston tiedot Esimerkki <cac:contact> </cac:contact> 4/32

42 6..9 Tilaajan tunniste (Party. Party Identification) Party. Party Identification Party Identification. Identifier Elementti / aggregaatti Party. Party Identification Party Identification. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan tilaajaorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto.. Identifier. Type Elementillä annetaan tilaajaorganisaation tunnus, jolla tilaaja tunnistetaan vastaanottajan järjestelmissä automaattisesti. Tässä elementissä annettava tunnus voi olla esimerkiksi OVT-tunnus, tilaajan tai toimittajan 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) 9 (Assigned by seller or seller's agent) Toimittajan ylläpitämä luettelo 92 (Assigned by buyer or buyer's agent) Tilaajan ylläpitämä luettelo 42/32

43 6..0 Tilaajan nimi (Party. Party Name) Party. Party Name Party Name. Name Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Party. Party Name Toisto 0.. unbounded Party Name. Details Aggregaatilla annetaan tilaajaorganisaation nimitiedot. Esimerkki <cac:partyname> </cac:partyname> Party Name. Name Toisto.. Name. Type Elementillä annetaan tilaajaorganisaation nimi Esimerkki <cbc:name>oy Sähkö Ab</cbc:Name> 43/32

44 6.. Tilaajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Party. Contact Contact. Identifier Contact. Name Contact. Telephone. Text Contact. Telefax. Text Contact. Electronic_ Mail. Text Contact. Note. Text Contact. Other_ Communication. Communication Elementti / aggregaatti Party. Contact Toistokerrat, tyyppi, kuvaus, esimerkki Contact. Identifier Contact. Details Aggregaatilla annetaan tilaajaorganisaation yhteyshenkilön tai -osaston tiedot Esimerkki <cac:contact> </cac:contact> Identifier. Type Elementillä annetaan tilaajaorganisaation yhteyshenkilön tai -osaston tunnus Huomautus Henkilön tunnuksena suositellaan käytettäväksi henkilön sähköpostiosoitetta. Esimerkki <cbc:id>46</cbc:id> Contact. Name Name. Type Contact. Telephone. Text Contact. Electronic_ Mail. Text Elementillä annetaan tilaajaorganisaation yhteyshenkilön tai -osaston nimi. Esimerkki <cbc:name>timo Tilaaja</cbc:Name> Text. Type Elementillä annetaan tilaajaorganisaation yhteyshenkilön tai -osaston puhelinnumero. Esimerkki <cbc:telephone> <cbc:Telephone> Text. Type Elementillä annetaan tilaajaorganisaation yhteyshenkilön tai -osaston sähköpostiosoite. Esimerkki <cbc:electronicmail>timo.tilaaja@sahko.fi <cbc:electronicmail> 44/32

45 6..2 Toimittajan tiedot (Order Change. Seller_ Supplier Party. Supplier Party) Order Change. Seller_ Supplier Party. Supplier Party Supplier Party. Customer Assigned_ Account Identifier. Identifier Supplier Party. Additional_ Account Identifier. Identifier Supplier Party. Data Sending Capability. Text Supplier Party. Party Supplier Party. Despatch_ Contact. Contact Supplier Party. Accounting_ Contact. Contact Supplier Party. Seller_ Contact. Contact Elementti / aggregaatti Order. Seller_ Supplier Party. Supplier Party Supplier Party. Party 6..3 Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. Supplier Party. Details Aggregaatilla annetaan toimittajaorganisaation tiedot. Esimerkki <cac:sellersupplierparty> </cac:sellersupplierparty> Party. Details Aggregaatilla annetaan toimittajaorganisaation nimi- ja tunnistetiedot. Esimerkki <cac:party> </cac:party> 45/32

46 6..3 Toimittaja (Supplier Party. Party) Supplier Party. Party Party. Mark Care_ Indicator. Indicator Party. Mark Attention_ Indicator. Indicator Party. Website_ URI. Identifier Party. Logo Reference. Identifier Party. Endpoint Identifier. Identifier Party. Party Identification Party. Party Name Party. Language Party. Postal_ Address. Address Party. Physical_ Location. Location Party. Party Tax Scheme Party. Party Legal Entity Party. Contact Party. Person Party. Agent_ Party. Party Elementti / aggregaatti Supplier Party. Party Party. Party Identification 6..4 Party. Party Name 6..5 Toistokerrat, tyyppi, kuvaus, esimerkki Party. Details Aggregaatilla annetaan toimittajaorganisaation nimi- ja tunnistetiedot. Esimerkki <cac:party> </cac:party> Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan toimittajaorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto 0.. unbounded Party Name. Details Aggregaatilla annetaan toimittajaorganisaation nimitiedot Esimerkki <cac:partyname> </cac:partyname> 46/32

47 6..4 Toimittajan tunniste (Party. Party Identification) Party. Party Identification Party Identification. Identifier Elementti / aggregaatti Party. Party Identification Party Identification. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan toimittajaorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto.. Identifier. Type Elementillä annetaan toimittajaorganisaation tunnus, jolla toimittaja tunnistetaan vastaanottajan järjestelmissä automaattisesti. Tässä elementissä annettava tunnus voi olla esimerkiksi OVT-tunnus, tilaajan tai toimittajan 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) 9 (Assigned by seller or seller's agent) Toimittajan ylläpitämä luettelo 92 (Assigned by buyer or buyer's agent) Tilaajan ylläpitämä luettelo 47/32

48 6..5 Toimittajan nimi (Party. Party Name) Party. Party Name Party Name. Name Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Party. Party Name Toisto 0.. unbounded Party Name. Details Aggregaatilla annetaan toimittajaorganisaation nimitiedot. Esimerkki <cac:partyname> </cac:partyname> Party Name. Name Toisto.. Name. Type Elementillä annetaan toimittajaorganisaation nimi Esimerkki <cbc:name>asennus Oy</cbc:Name> 48/32

49 6..6 Toimittamiseen liittyvät tiedot (Order Change. Delivery) Order Change. Delivery Delivery. Identifier Delivery. Quantity Delivery. Minimum_ Quantity. Quantity Delivery. Maximum_ Quantity. Quantity Delivery. Actual_ Delivery Date. Date Delivery. Actual_ Delivery Time. Time Delivery. Latest_ Delivery Date. Date Delivery. Latest_ Delivery Time. Time Delivery. Tracking Identifier. Identifier Delivery. Delivery_ Address. Address Delivery. Delivery_ Location. Location Delivery. Requested Delivery_ Period. Period Delivery. Promised Delivery_ Period. Period Delivery. Estimated Delivery_ Period. Period Delivery. Delivery_ Party. Party Delivery. Despatch Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Order Change. Delivery Toisto 0.. unbounded Delivery. Delivery_ Location. Location 6..7 Delivery. Requested Delivery_ Period. Period 6..2 Esimerkki Delivery. Details Aggregaatilla annetaan materiaalin toimittamiseen liittyviä muutostietoja, kuten muuttunut materiaalin toimituspäivä ja -osoite. <cac:delivery> </cac:delivery> Location. Details Aggregaattia annetaan koko tilausmuutosta koskevan toimintopaikan eli työkohteen muutostiedot. Huomautus Tätä aggregaattia ja sen ala-aggregaatteja käytetään vain, jos tilausmuutokseen liittyy yksi toimintopaikka eli työkohde. Jos tilausmuutokseen liittyy useita työkohteita, annetaan tiedot rivitasolla. Esimerkki <cac:deliverylocation> </cac:deliverylocation> Period. Details Aggregaatilla annetaan koko hankkeen suorittamisperiodin muutostiedot. Huomautus Tällä aggregaatilla annetaan päivämäärä- ja aikaväli. Jos hankkeen suorittamisperiodi on tietty päivä, annetaan elementtien Period. Start Date. Date ja Period. End Date. Date 49/32

50 Delivery. Promised Delivery_ Period. Period Delivery. Estimated Delivery_ Period. Period Delivery. Delivery_ Party. Party arvona sama päivämäärä. Esimerkki <cac:requesteddeliveryperiod> </cac:requesteddeliveryperiod> Period. Details Aggregaattia annetaan sovittu materiaalitoimituksen päivämäärän muutos. Huomautus Tällä aggregaatilla annetaan päivämäärä- ja aikaväli. Jos toimituspäivämäärä on tietty päivä, annetaan elementtien Period. Start Date. Date ja Period. End Date. Date arvona sama päivämäärä. Esimerkki <cac:promiseddeliveryperiod> </cac:promiseddeliveryperiod> Period. Details Aggregaattia annetaan koko hanketta koskeva suunniteltu (luvattu) kohteen käyttöönottopäivän muutos. Huomautus Tällä aggregaatilla annetaan päivämäärä- ja aikaväli. Jos suunniteltu (luvattu) kohteen käyttöönottopäivä on tietty päivä, annetaan elementtien Period. Start Date. Date ja Period. End Date. Date arvona sama päivämäärä. Esimerkki <cac:estimateddeliveryperiod> </cac:estimateddeliveryperiod> Party. Details Aggregaatilla annetaan materiaalin purkauspaikan muutostiedot eli muuttunut materiaalin toimitusosoite. Esimerkki <cac:deliveryparty> </cac:deliveryparty> 50/32

51 6..7 Toimintopaikan eli työkohteen tiedot (Delivery. Delivery_ Location. Location) Delivery. Delivery_ Location. Location Location. Identifier Location. Description. Text Location. Conditions. Text Location. Country Subentity. Text Location. Country Subentity Code. Code Location. Validity_ Period. Period Location. Address Elementti / aggregaatti Delivery. Delivery_ Location. Location Toistokerrat, tyyppi, kuvaus, esimerkki Location. Details Aggregaattia annetaan koko tilausmuutosta koskevan toimintopaikan eli työkohteen muutostiedot. Huomautus Tätä aggregaattia ja sen ala-aggregaatteja käytetään vain, jos tilausmuutokseen liittyy yksi toimintopaikka eli työkohde. Jos tilausmuutokseen liittyy useita työkohteita, annetaan tiedot rivitasolla. Location. Identifier Identification Scheme Agency. Identifier Esimerkki <cac:deliverylocation> </cac:deliverylocation> Attribuutit Identifier. Type Elementillä annetaan toimintopaikan tunnus eli työkohteen tunnus tilaajan järjestelmissä (esim. mittarin tunnus). schemeagencyid Esimerkki <cbc:id>2a</cbc:id> Attribuutilla annetaan toimintopaikkakoodiston ylläpitäjä. Esimerkki schemeagencyid="92" Käytettävät koodit Location. Description. Text Location. Address (Assigned by buyer or buyer's agent) Tilaajan ylläpitämä luettelo Text. Type Elementillä annetaan toimintopaikka eli työkohde tekstimuotoisena. Esimerkki <cbc:description>varastopaikka 48</cbc:Description> Address. Details Aggregaatilla annetaan työkohteen osoiteen muutostiedot. Esimerkki <cac:address> </cac:address> 5/32

52 6..8 Työkohteen osoite (Location. Address) Location. Address Address. Identifier Address. Address Type Code. Code Address. Address Format Code. Code Address. Postbox. Text Address. Floor. Text Address. Room. Text Address. Street Name. Name Address. Additional_ Street Name. Name Address. Block Name. Name Address. Building Name. Name Address. Building Number. Text Address. Inhouse_ Mail. Text Address. Department. Text Address. Mark Attention. Text Address. Mark Care. Text Address. Plot Identification. Text Address. City Subdivision Name. Name Address. City Name. Name Address. Postal_ Zone. Text Address. Country Subentity. Text Address. Country Subentity Code. Code Address. Region. Text Address. District. Text Address. Timezone Offset. Text Address. Address Line Address. Country Address. Location Coordinate Elementti / aggregaatti Delivery. Address Toistokerrat, tyyppi, kuvaus, esimerkki Address. Identifier Address. Details Aggregaatilla annetaan työkohteen osoiteen muutostiedot. Esimerkki <cac:address> </cac:address> Identifier. Type Elementillä annetaan työnkohteena olevan laitteen käyttöpaikan numero eli sähkön käyttöpaikan tunnus (esim. huoneiston numero) Esimerkki <cbc:id>2</cbc:id> Address. Room. Text Address. Street Name. Name Text. Type Elementillä annetaan työkohteen sijaintihuone. Esimerkki <cbc:room>32</cbc:room> Name. Type 52/32

53 Address. City Name. Name Address. Postal_ Zone. Text Address. Address Line 6..9 Address. Location Coordinate Elementillä annetaan työkohteen lähiosoite. Esimerkki <cbc:streetname>voimantie 99</cbc:StreetName> Name. Type Elementillä annetaan työkohteen postitoimipaikka. Esimerkki <cbc:cityname>tampere</cbc:cityname> Text. Type Elementillä annetaan työkohteen postinumero. Esimerkki <cbc:postalzone>33680</cbc:postalzone> Toisto 0.. unbounded Address Line. Details Aggregaatilla annetaan työkohteen olevan laitteen käyttöpaikan nimen muutostiedot. Esimerkki <cac:addressline> </cac:addressline> Location Coordinate. Details Aggregaatilla annetaan työkohteen muuttuneet sijaintikoordinaatit. Esimerkki <cac:locationcoordinate> </cac:locationcoordinate> 53/32

54 6..9 Työkohteena olevan laitteen sijaintipaikan nimitiedot (Address. Address Line) Address. Address Line Address Line. Line. Text Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Address. Address Line Toisto 0.. unbounded Address Line. Details Aggregaatilla annetaan työkohteen olevan laitteen käyttöpaikan nimen muutostiedot. Esimerkki <cac:addressline> </cac:addressline> Address Line. Line. Text Toisto.. Text. Type Työnkohteena olevan laitteen käyttöpaikan nimi eli sähkön käyttöpaikan nimi (esim. mittarin käyttöpaikan tunnuksen selite) Esimerkki <cbc:line>huoneisto 2</cbc:Line> 54/32

55 6..20 Työkohteen sijaintikoodinaatit (Address. Location Coordinate) Address. Location Coordinate Location Coordinate. Coordinate System Code. Code Location Coordinate. Latitude_ Degrees. Measure Location Coordinate. Latitude_ Minutes. Measure Location Coordinate. Latitude Direction Code. Code Location Coordinate. Longitude_ Degrees. Measure Location Coordinate. Longitude_ Minutes. Measure Location Coordinate. Longitude Direction Code. Code Elementti / aggregaatti Address. Location Coordinate Location Coordinate. Coordinate System Code. Code Location Coordinate. Latitude_ Degrees. Measure Toistokerrat, tyyppi, kuvaus, esimerkki Location Coordinate. Details Aggregaatilla annetaan työkohteen muuttuneet sijaintikoordinaatit. Esimerkki <cac:locationcoordinate> </cac:locationcoordinate> Koodit Code. Type Elementillä annetaan työkohteen sijaintikoordinaatiston tunnus. KKJ = Kartastokoordinaattijärjestelmä perustuu ED50 (European Datum 950) koordinaatistoon EUREF-FIN = Yleiseurooppalaisen ETRS90- koordinaatistojärjestelmän mukaisen ETRF89- koordinaatiston realisaatio Suomessa (määritelty Julkisen hallinnon suosituksessa 53) ETRF89 = (European Terrestrial Reference Frame 989) Yleiseurooppalaisen ETRS90-koordinaatisto- järjestelmän mukainen ETRF89-koordinaatisto Esimerkki <cbc:coordinatesystemcode>kkj</cbc: Attribuutit CoordinateSystemCode> Measure. Type Elementillä annetaan työkohteen sijaintipaikan leveyskoodinaatin asteet. unitcode Measure Unit. Code Toisto.. Esimerkki <cbc:latitudedegreesmeasure unitcode="dd">62 </cbc:latitudedegreesmeasure> 55/32

56 Location Coordinate. Latitude_ Minutes. Measure Oletus 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 Attribuutit (Degree) Aste Measure. Type Elementillä annetaan työkohteen sijaintipaikan leveyskoodinaatin minuutit. unitcode Measure Unit. Code Toisto.. Location Coordinate. Latitude Direction Code. Code Latitude Direction_ Code List. Identifier Latitude Direction_ Code List. Agency. 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 Koodit Attribuutit Esimerkki Esimerkki Käytettävät koodit (Minute) Minuutti Latitude Direction_ Code. Type Elementillä annetaan työkohteen 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" Latitude Direction UBL Latitude Direction (leveyspiirin suunta) Attribuutilla annetaan leveyspiirin suuntakoodiston ylläpitäjä. Esimerkki listagencyid="ubl" Käytettävät koodit UBL UBL (Universal Business Language) 56/32

57 Location Coordinate. Longitude_ Degrees. Measure Attribuutit Measure. Type Elementillä annetaan työkohteen sijaintipaikan pituuskoodinaatin 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 Attribuutit (Degree) Aste Measure. Type Elementillä annetaan työkohteen sijaintipaikan pituuskoodinaatin minuutit. unitcode Measure Unit. Code Toisto.. Location Coordinate. Longitude Direction Code. Code Longitude Direction_ Code List. Identifier Esimerkki <cbc:longitudeminutesmeasure unitcode="min">3.69 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 Koodit Attribuutit Esimerkki (Minute) Minuutti Longitude Direction_ Code. Type Elementillä annetaan työkohteen sijaintipaikan pituuskoodinaatin suunta meridiaanilta ilmaistuna koodimuotoisesti. East = (East) Itäistä pituutta West = (West) Läntistä pituutta listid ja listagencyid <cbc:longitudedirectioncode listid= Longitude Direction" listagencyid="ubl">east</cbc:longitudedirectioncode> Attribuutilla annetaan pituuspiirin suuntakoodiston tunnus. 57/32

58 Longitude Direction_ Code List. Agency. Identifier 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) 58/32

59 6..2 Hankkeen suorittamisperiodin tiedot (Delivery. Requested Delivery_ Period. Period) Delivery. Requested Delivery_ Period. Period Period. Start Date. Date Period. Start Time. Time Period. End Date. Date Period. End Time. Time Period. Duration. Measure Period. Description Code. Code Period. Description. Text Elementti / aggregaatti Delivery. Requested Delivery_ Period. Period Toistokerrat, tyyppi, kuvaus, esimerkki Period. Start Date. Date Period. Details Aggregaatilla annetaan koko hankkeen suorittamisperiodin muutostiedot. Huomautus Tällä aggregaatilla annetaan päivämäärä- ja aikaväli. Jos hankkeen suorittamisperiodi on tietty päivä, annetaan elementtien Period. Start Date. Date ja Period. End Date. Date arvona sama päivämäärä. Esimerkki <cac:requesteddeliveryperiod> </cac:requesteddeliveryperiod> Date. Type Period. End Date. Date Elementillä annetaan hankkeen muuttunut alkurajapäivämäärä. Esimerkki <cbc:startdate> </cbc:startdate> Date. Type Elementillä annetaan hankkeen muuttunut loppurajapäivämäärä. Esimerkki <cbc:enddate> </cbc:enddate> 59/32

60 6..22 Materiaalitoimituksen päivämäärätiedot (Delivery. Promised Delivery_ Period. Period) Delivery. Promised Delivery_ Period. Period Period. Start Date. Date Period. Start Time. Time Period. End Date. Date Period. End Time. Time Period. Duration. Measure Period. Description Code. Code Period. Description. Text Elementti / aggregaatti Delivery. Promised Delivery_ Period. Period Toistokerrat, tyyppi, kuvaus, esimerkki Period. Start Date. Date Period. Details Aggregaattia annetaan sovittu materiaalitoimituksen päivämäärän muutos. Huomautus Tällä aggregaatilla annetaan päivämäärä- ja aikaväli. Jos toimituspäivämäärä on tietty päivä, annetaan elementtien Period. Start Date. Date ja Period. End Date. Date arvona sama päivämäärä. Esimerkki <cac:promiseddeliveryperiod> </cac:promiseddeliveryperiod> Date. Type Period. End Date. Date Elementillä annetaan muuttunut materiaalin ensimmäinen toimituspäivä. Esimerkki <cbc:startdate> </cbc:startdate> Date. Type Elementillä annetaan muuttunut materiaalin viimeinen toimituspäivä. Esimerkki <cbc:enddate> </cbc:enddate> 60/32

61 6..23 Suunniteltu kohteen käyttöönottopäivämäärän tiedot (Delivery. Estimated Delivery_ Period. Period) Delivery. Estimated Delivery_ Period. Period Period. Start Date. Date Period. Start Time. Time Period. End Date. Date Period. End Time. Time Period. Duration. Measure Period. Description Code. Code Period. Description. Text Elementti / aggregaatti Delivery. Estimated Delivery_ Period. Period Toistokerrat, tyyppi, kuvaus, esimerkki Period. Start Date. Date Period. Details Aggregaattia annetaan koko hanketta koskeva suunniteltu (luvattu) kohteen käyttöönottopäivän muutos. Huomautus Tällä aggregaatilla annetaan päivämäärä- ja aikaväli. Jos suunniteltu (luvattu) kohteen käyttöönottopäivä on tietty päivä, annetaan elementtien Period. Start Date. Date ja Period. End Date. Date arvona sama päivämäärä. Esimerkki <cac:estimateddeliveryperiod> </cac:estimateddeliveryperiod> Date. Type Period. End Date. Date Elementillä annetaan muuttunut kohteen suunniteltu (luvattu) ensimmäinen käyttöönottopäivä. Esimerkki <cbc:startdate> </cbc:startdate> Date. Type Elementillä annetaan muuttunut kohteen suunniteltu (luvattu) viimeinen käyttöönottopäivä. Esimerkki <cbc:enddate> </cbc:enddate> 6/32

62 6..24 Materiaalin toimitusosoitteen tiedot (Delivery. Delivery_ Party. Party) Delivery. Delivery_ Party. Party Party. Mark Care_ Indicator. Indicator Party. Mark Attention_ Indicator. Indicator Party. Website_ URI. Identifier Party. Logo Reference. Identifier Party. Endpoint Identifier. Identifier Party. Party Identification Party. Party Name Party. Language Party. Postal_ Address. Address Party. Physical_ Location. Location Party. Party Tax Scheme Party. Party Legal Entity Party. Contact Party. Person Party. Agent_ Party. Party Elementti / aggregaatti Delivery. Delivery_ Party. Party Party. Party Identification Party. Party Name Party. Postal_ Address. Address Toistokerrat, tyyppi, kuvaus, esimerkki Party. Details Aggregaatilla annetaan materiaalin purkauspaikan muutostiedot eli muuttunut materiaalin toimitusosoite. Esimerkki <cac:deliveryparty> </cac:deliveryparty> Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan materiaalin toimitusosoitteen tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto 0.. unbounded Party Name. Details Aggregaatilla annetaan materiaalin toimitusosoitteen nimitiedot Esimerkki <cac:partyname> </cac:partyname> Address. Details 62/32

63 6..27 Aggregaatilla annetaan muuttuneet materiaalin toimitusosoitteen osoitetiedot. Esimerkki <cac:postaladdress> </cac:postaladdress> 63/32

64 6..25 Materiaalin toimitusosoitteen tunniste (Party. Party Identification) Party. Party Identification Party Identification. Identifier Elementti / aggregaatti Party. Party Identification Party Identification. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan materiaalin toimitusosoitteen tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto.. Identifier. Type Elementillä annetaan materiaalin toimitusosoitteen tunnus, jolla materiaalin toimitusosoite tunnistetaan vastaanottajan järjestelmissä automaattisesti. Tässä elementissä annettava tunnus voi olla esimerkiksi OVT-tunnus, tilaajan tai toimittajan 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) 9 (Assigned by seller or seller's agent) Toimittajan ylläpitämä luettelo 92 (Assigned by buyer or buyer's agent) Tilaajan ylläpitämä luettelo 64/32

65 6..26 Materiaalin toimitusosoiteen nimi (Party. Party Name) Party. Party Name Party Name. Name Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Party. Party Name Toisto 0.. unbounded Party Name. Details Aggregaatilla annetaan materiaalin toimitusosoitteen nimitiedot. Esimerkki <cac:partyname> </cac:partyname> Party Name. Name Toisto.. Name. Type Elementillä annetaan materiaalin toimitusosoitteen nimi. Esimerkki <cbc:name>piilopaikka Oy</cbc:Name> 65/32

66 6..27 Materiaalin toimitusosoiteen osoite (Party. Postal_ Address. Address) Party. Postal_ Address. Address Address. Identifier Address. Address Type Code. Code Address. Address Format Code. Code Address. Postbox. Text Address. Floor. Text Address. Room. Text Address. Street Name. Name Address. Additional_ Street Name. Name Address. Block Name. Name Address. Building Name. Name Address. Building Number. Text Address. Inhouse_ Mail. Text Address. Department. Text Address. Mark Attention. Text Address. Mark Care. Text Address. Plot Identification. Text Address. City Subdivision Name. Name Address. City Name. Name Address. Postal_ Zone. Text Address. Country Subentity. Text Address. Country Subentity Code. Code Address. Region. Text Address. District. Text Address. Timezone Offset. Text Address. Address Line Address. Country Address. Location Coordinate Elementti / aggregaatti Party. Postal_ Address. Address Address. Street Name. Name Address. City Name. Name Address. Postal_ Zone. Text Toistokerrat, tyyppi, kuvaus, esimerkki Address. Details Aggregaatilla annetaan muuttuneet materiaalin toimitusosoitteen osoitetiedot. Esimerkki <cac:postaladdress> </cac:postaladdress> Name. Type Elementillä annetaan materiaalin toimitusosoitteen lähiosoite. Esimerkki <cbc:streetname>voimantie 99</cbc:StreetName> Name. Type Elementillä annetaan materiaalin toimitusosoitteen postitoimipaikka. Esimerkki <cbc:cityname>tampere</cbc:cityname> Text. Type 66/32

67 Address. Country Address. Location Coordinate Elementillä annetaan materiaalin toimitusosoitteen postinumero. Esimerkki <cbc:postalzone>33680</cbc:postalzone> Country. Details Aggregaatilla annetaan materiaalin toimitusosoitteen maatiedot. Esimerkki <cac:country> </cac:country> Location Coordinate. Details Aggregaatilla annetaan materiaalin toimitusosoitteen muuttuneet sijaintikoordinaatit. Esimerkki <cac:locationcoordinate> </cac:locationcoordinate> 67/32

68 6..28 Materiaalin toimitusosoiteen maa (Address. Country) Address. Country Country. Identification Code. Code Country. Name Elementti / aggregaatti Address. Country Country. Identification Code. Code Country Identification_ Code List. Identifier Country Identification_ Code List. Agency. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Country. Details Aggregaatilla annetaan materiaalin toimitusosoitteen maatiedot. Esimerkki <cac:country> </cac:country> Country Identification_ Code. Type Elementillä annetaan materiaalin toimitusosoitteen maakoodi. Maakoodi on ISO standardin 366- mukainen kaksikirjaiminen koodi. Attribuutit listid ja listagencyid Esimerkki Oletus <cbc:identificationcode listid= ISO366-" listagencyid="6">fi</cbc:identificationcode> ISO366- Attribuutilla annetaan maakoodiston tunnus. Esimerkki listid="iso366-" Käytettävät koodit ISO366- ISO 366 Countries (kaksikirjaiminen maakoodi) Oletus 6 Attribuutilla annetaan maakoodiston ylläpitäjä. Esimerkki listagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) 68/32

69 6..29 Materiaalin toimitusosoiteen sijaintikoodinaatit (Address. Location Coordinate) Address. Location Coordinate Location Coordinate. Coordinate System Code. Code Location Coordinate. Latitude_ Degrees. Measure Location Coordinate. Latitude_ Minutes. Measure Location Coordinate. Latitude Direction Code. Code Location Coordinate. Longitude_ Degrees. Measure Location Coordinate. Longitude_ Minutes. Measure Location Coordinate. Longitude Direction Code. Code Elementti / aggregaatti Address. Location Coordinate Location Coordinate. Coordinate System Code. Code Location Coordinate. Latitude_ Degrees. Measure Toistokerrat, tyyppi, kuvaus, esimerkki Location Coordinate. Details Aggregaatilla annetaan materiaalin toimitusosoitteen muuttuneet sijaintikoordinaatit. Esimerkki <cac:locationcoordinate> </cac:locationcoordinate> Code. Type Elementillä annetaan materiaalin toimitusosoitteen sijaintikoordinaatiston tunnus. Koodit KKJ = Kartastokoordinaattijärjestelmä perustuu ED50 (European Datum 950) koordinaatistoon EUREF-FIN = Yleiseurooppalaisen ETRS90- koordinaatistojärjestelmän mukaisen ETRF89- koordinaatiston realisaatio Suomessa (määritelty Julkisen hallinnon suosituksessa 53) ETRF89 = (European Terrestrial Reference Frame 989) Yleiseurooppalaisen ETRS90-koordinaatistojärjestelmän mukainen ETRF89-koordinaatisto Esimerkki <cbc:coordinatesystemcode>kkj </cbc:coordinatesystemcode> Measure. Type Elementillä annetaan materiaalin toimitusosoitteen sijaintipaikan leveyskoodinaatin asteet. Attribuutit unitcode Esimerkki <cbc:latitudedegreesmeasure unitcode="dd">62 </cbc:latitudedegreesmeasure> 69/32

70 Measure Unit. Code Toisto.. Location Coordinate. Latitude_ Minutes. Measure Oletus 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 Attribuutit (Degree) Aste Measure. Type Elementillä annetaan materiaalin toimitusosoitteen sijaintipaikan leveyskoodinaatin minuutit. unitcode Measure Unit. Code Toisto.. Location Coordinate. Latitude Direction Code. Code Latitude Direction_ Code List. Identifier Latitude Direction_ Code List. Agency. 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 Koodit Attribuutit Esimerkki Esimerkki Käytettävät koodit (Minute) Minuutti Latitude Direction_ Code. Type Elementillä annetaan materiaalin toimitusosoitteen 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" Latitude Direction UBL Latitude Direction (leveyspiirin suunta) Attribuutilla annetaan leveyspiirin suuntakoodiston ylläpitäjä. Esimerkki listagencyid="ubl" Käytettävät koodit 70/32

71 Location Coordinate. Longitude_ Degrees. Measure UBL Attribuutit UBL (Universal Business Language) Measure. Type Elementillä annetaan materiaalin toimitusosoitteen sijaintipaikan pituuskoodinaatin 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 Attribuutit (Degree) Aste Measure. Type Elementillä annetaan materiaalin toimitusosoitteen sijaintipaikan pituuskoodinaatin minuutit. unitcode Measure Unit. Code Toisto.. Location Coordinate. Longitude Direction Code. Code Esimerkki <cbc:longitudeminutesmeasure unitcode="min">3.69 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 Koodit Attribuutit Esimerkki Longitude Direction_ (Minute) Minuutti Longitude Direction_ Code. Type Elementillä annetaan materiaalin toimitusosoitteen sijaintipaikan pituuskoodinaatin suunta meridiaanilta ilmaistuna koodimuotoisesti. East = (East) Itäistä pituutta West = (West) Läntistä pituutta listid ja listagencyid <cbc:longitudedirectioncode listid= Longitude Direction" listagencyid="ubl">east</cbc:longitudedirectioncode> 7/32

72 Code List. Identifier Longitude Direction_ Code List. Agency. Identifier 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) 72/32

73 6.2 Sanoman rivitaso Sanoman rivitasolla välitetään tilattavaa tehtävää koskevat muutostiedot, kuten työkohteen tai tehtävän suorittamisen ajan muutostiedot. Mittarointiin liittyvät rivitason tiedot esitetään omana rivitason kuvauksenaan yleisen rivitason kuvauksen jälkeen Tilausmuutosrivin tiedot (Order Change. Order Line) Order Change. Order Line Order Line. Substitution Status Code. Code Order Line. Note. Text Order Line. Line Item Order Line. Seller Proposed Substitute_ Line Item. Line Item Order Line. Seller Substituted_ Line Item. Line Item Order Line. Buyer Proposed Substitute_ Line Item. Line Item Order Line. Catalogue_ Line Reference. Line Reference Order Line. Quotation_ Line Reference. Line Reference Order Line. Document Reference Elementti / aggregaatti Order Change. Order Line Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. unbounded Order Line. Details Aggregaatilla annetaan tilausmuutoksen rivin tiedot. Esimerkki <cac:orderline> </cac:orderline> Order Line. Note. Text Text. Type Elementillä annetaan tilausmuutosrivin lisätietoa. Huomautus Tällä elementtillä annetaan tietoja, joita ei voida antaa minkään muun elementin arvona. Attribuutit languageid Esimerkki <cbc:note languageid="fi">asennettavan laitteen takuutodistukset on toimitettava tilaajalle sovitusti.</cbc:note> Language. Identifier Tilausmuutosrivin vapaamuotoisen tekstin kieli ilmaistuna 73/32

74 Order Line. Line Item Order Line. Document Reference standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla. Esimerkki languageid="fi" Toisto.. Line Item. Details Aggregaatilla annetaan tilatun pientyön tai projektin tehtävän muutostiedot. Esimerkki <cac:lineitem> </cac:lineitem> Toisto 0.. unbounded Document Reference. Details Aggregaatilla annetaan tilausmuutoksen riviin liittyvät viitteet. Esimerkki <cac:documentreference> </cac:documentreference> 74/32

75 6.2.2 Tehtävän tiedot (Order Line. Line Item) Order Line. Line Item Line Item. Identifier Line Item. Sales_ Order Identifier. Identifier Line Item. UUID. Identifier Line Item. Note. Text Line Item. Line Status Code. Code Line Item. Quantity Line Item. Line Extension Amount. Amount Line Item. Total_ Tax Amount. Amount Line Item. Minimum_ Quantity. Quantity Line Item. Maximum_ Quantity. Quantity Line Item. Minimum_ Backorder. Quantity Line Item. Maximum_ Backorder. Quantity Line Item. Inspection Method. Code Line Item. Partial Delivery Indicator. Indicator Line Item. Back Order Allowed Indicator. Indicator Line Item. Accounting Cost Code. Code Line Item. Accounting Cost. Text Line Item. Delivery Line Item. Delivery Terms Line Item. Originator_ Party. Party Line Item. Ordered Shipment Line Item. Pricing Reference Line Item. Allowance Charge Line Item. Price Line Item. Item Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Order Line. Line Item Toisto.. Line Item. Details Aggregaatilla annetaan tilatun pientyön tai projektin tehtävän muutostiedot. Esimerkki <cac:lineitem> </cac:lineitem> Line Item. Identifier Toisto.. Identifier. Type Elementillä annetaan tilausmuutosrivin tunnus. Esimerkki <cbc:id>003</cbc:id> Line Item. Delivery Toisto 0.. unbounded 0 Delivery. Details Aggregaatilla annetaan tehtävään liittyvät muuttuneet paikka- ja aikatiedot. Esimerkki <cac:delivery> </cac:delivery> Line Item. Item Toisto Item. Details Aggregaatilla annetaan työyksikön tuotetiedot, kuten tuotekoodi ja nimi. Esimerkki <cac:item> </cac:item> 75/32

76 6.2.3 Työhön liittyvät paikkatiedot (Line Item. Delivery) Line Item. Delivery Delivery. Identifier Delivery. Quantity Delivery. Minimum_ Quantity. Quantity Delivery. Maximum_ Quantity. Quantity Delivery. Actual_ Delivery Date. Date Delivery. Actual_ Delivery Time. Time Delivery. Latest_ Delivery Date. Date Delivery. Latest_ Delivery Time. Time Delivery. Tracking Identifier. Identifier Delivery. Delivery_ Address. Address Delivery. Delivery_ Location. Location Delivery. Requested Delivery_ Period. Period Delivery. Promised Delivery_ Period. Period Delivery. Estimated Delivery_ Period. Period Delivery. Delivery_ Party. Party Delivery. Despatch Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Line Item. Delivery Toisto 0.. unbounded Delivery. Delivery_ Location. Location Delivery. Requested Delivery_ Period. Period Delivery. Details Aggregaatilla annetaan tehtävään liittyvät muuttuneet paikka- ja aikatiedot. Esimerkki <cac:delivery> </cac:delivery> Location. Details Aggregaattia annetaan toimitopaikan eli työkohteen muutostiedot. Huomautus Tätä aggregaattia ja sen ala-aggregaatteja käytetään vain, jos tilausmuutokseen liittyy useita toimintopaikkoja eli työkohtaita. Jos tilausmuutokseen liittyy vain yksi työkohde, annetaan tiedot otsikkotasolla. Esimerkki <cac:deliverylocation> </cac:deliverylocation> Period. Details Aggregaatilla annetaan tehtävän muuttuneet suorittamisperiodin tiedot. Huomautus Tällä aggregaatilla annetaan päivämäärä- ja aikaväli. Jos tehtävän suorittamisperiodi on tietty päivä, annetaan elementtien Period. Start Date. Date ja Period. End Date. Date 76/32

77 Delivery. Estimated Delivery_ Period. Period arvona sama päivämäärä. Esimerkki <cac:requesteddeliveryperiod> </cac:requesteddeliveryperiod> Period. Details Aggregaattia annetaan muuttunut suunniteltu (luvattu) kohteen käyttöönottopäivä. Huomautus Tällä aggregaatilla annetaan päivämäärä- ja aikaväli. Jos suunniteltu töiden aloituspäivä on tietty päivä, annetaan elementtien Period. Start Date. Date ja Period. End Date. Date arvona sama päivämäärä. Esimerkki <cac:estimateddeliveryperiod> </cac:estimateddeliveryperiod> 77/32

78 6.2.4 Toimintopaikan eli työkohteen tiedot (Delivery. Delivery_ Location. Location) Delivery. Delivery_ Location. Location Location. Identifier Location. Description. Text Location. Conditions. Text Location. Country Subentity. Text Location. Country Subentity Code. Code Location. Validity_ Period. Period Location. Address Elementti / aggregaatti Delivery. Delivery_ Location. Location Toistokerrat, tyyppi, kuvaus, esimerkki Location. Identifier Identification Scheme Agency. Identifier Location. Details Aggregaattia annetaan toimitopaikan eli työkohteen muutostiedot. Huomautus Tätä aggregaattia ja sen ala-aggregaatteja käytetään vain, jos tilausmuutokseen liittyy useita toimintopaikkoja eli työkohtaita. Jos tilausmuutokseen liittyy vain yksi työkohde, annetaan tiedot otsikkotasolla. Esimerkki <cac:deliverylocation> </cac:deliverylocation> Attribuutit Identifier. Type Elementillä annetaan toimintopaikan tunnus eli työkohteen tunnus tilaajan järjestelmissä (esim. mittarin tunnus). schemeagencyid Esimerkki <cbc:id>2a</cbc:id> Attribuutilla annetaan toimintopaikkakoodiston ylläpitäjä. Esimerkki schemeagencyid="92" Käytettävät koodit Location. Description. Text Location. Address (Assigned by buyer or buyer's agent) Tilaajan ylläpitämä luettelo Text. Type Elementillä annetaan toimintopaikka eli työkohde tekstimuotoisena. Esimerkki <cbc:description>varastopaikka 50</cbc:Description> Address. Details Aggregaatilla annetaan työkohteen muuttuneet osoitetiedot. Esimerkki <cac:address> </cac:address> 78/32

79 6.2.5 Työkohteen osoite (Location. Address) Location. Address Address. Identifier Address. Address Type Code. Code Address. Address Format Code. Code Address. Postbox. Text Address. Floor. Text Address. Room. Text Address. Street Name. Name Address. Additional_ Street Name. Name Address. Block Name. Name Address. Building Name. Name Address. Building Number. Text Address. Inhouse_ Mail. Text Address. Department. Text Address. Mark Attention. Text Address. Mark Care. Text Address. Plot Identification. Text Address. City Subdivision Name. Name Address. City Name. Name Address. Postal_ Zone. Text Address. Country Subentity. Text Address. Country Subentity Code. Code Address. Region. Text Address. District. Text Address. Timezone Offset. Text Address. Address Line Address. Country Address. Location Coordinate Elementti / aggregaatti Location. Address Toistokerrat, tyyppi, kuvaus, esimerkki Address. Identifier Address. Details Aggregaatilla annetaan työkohteen muuttuneet osoitetiedot. Esimerkki <cac:address> </cac:address> Identifier. Type Elementillä annetaan työnkohteena olevan laitteen käyttöpaikan numero eli sähkön käyttöpaikan tunnus (esim. huoneiston numero) Esimerkki <cbc:id>2</cbc:id> Address. Room. Text Address. Street Name. Name Text. Type Elementillä annetaan työkohteen sijaintihuone. Esimerkki <cbc:room>32</cbc:room> Name. Type 79/32

80 Address. City Name. Name Address. Postal_ Zone. Text Address. Address Line Address. Location Coordinate Elementillä annetaan työkohteen lähiosoite. Esimerkki <cbc:streetname>voimantie 99</cbc:StreetName> Name. Type Elementillä annetaan työkohteen postitoimipaikka. Esimerkki <cbc:cityname>tampere</cbc:cityname> Text. Type Elementillä annetaan työkohteen postinumero. Esimerkki <cbc:postalzone>33680</cbc:postalzone> Toisto 0.. unbounded Address Line. Details Aggregaatilla annetaan työkohteen olevan laitteen käyttöpaikan muuttuneet nimitiedot. Esimerkki <cac:addressline> </cac:addressline> Location Coordinate. Details Aggregaatilla annetaan työkohteen muuttuneet sijaintikoordinaatit. Esimerkki <cac:locationcoordinate> </cac:locationcoordinate> 80/32

81 6.2.6 Työkohteena olevan laitteen sijaintipaikan nimitiedot (Address. Address Line) Address. Address Line Address Line. Line. Text Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Address. Address Line Toisto 0.. unbounded Address Line. Details Aggregaatilla annetaan työkohteen olevan laitteen käyttöpaikan muuttuneet nimitiedot. Esimerkki <cac:addressline> </cac:addressline> Address Line. Line. Text Toisto.. Text. Type Työnkohteena olevan laitteen käyttöpaikan nimi eli sähkön käyttöpaikan nimi (esim. mittarin käyttöpaikan tunnuksen selite) Esimerkki <cbc:line>huoneisto 3</cbc:Line> 8/32

82 6.2.7 Työkohteen sijaintikoodinaatit (Address. Location Coordinate) Address. Location Coordinate Location Coordinate. Coordinate System Code. Code Location Coordinate. Latitude_ Degrees. Measure Location Coordinate. Latitude_ Minutes. Measure Location Coordinate. Latitude Direction Code. Code Location Coordinate. Longitude_ Degrees. Measure Location Coordinate. Longitude_ Minutes. Measure Location Coordinate. Longitude Direction Code. Code Elementti / aggregaatti Address. Location Coordinate Location Coordinate. Coordinate System Code. Code Location Coordinate. Latitude_ Degrees. Measure Toistokerrat, tyyppi, kuvaus, esimerkki Location Coordinate. Details Aggregaatilla annetaan työkohteen muuttuneet sijaintikoordinaatit. Esimerkki <cac:locationcoordinate> </cac:locationcoordinate> Koodit Code. Type Elementillä annetaan työkohteen sijaintikoordinaatiston tunnus. KKJ = Kartastokoordinaattijärjestelmä perustuu ED50 (European Datum 950) koordinaatistoon EUREF-FIN = Yleiseurooppalaisen ETRS90- koordinaatistojärjestelmän mukaisen ETRF89- koordinaatiston realisaatio Suomessa (määritelty Julkisen hallinnon suosituksessa 53) ETRF89 = (European Terrestrial Reference Frame 989) Yleiseurooppalaisen ETRS90-koordinaatisto- järjestelmän mukainen ETRF89-koordinaatisto Esimerkki <cbc:coordinatesystemcode>kkj</cbc: Attribuutit CoordinateSystemCode> Measure. Type Elementillä annetaan työkohteen sijaintipaikan leveyskoodinaatin asteet. unitcode Measure Unit. Code Toisto.. Esimerkki <cbc:latitudedegreesmeasure unitcode="dd">62 </cbc:latitudedegreesmeasure> 82/32

83 Location Coordinate. Latitude_ Minutes. Measure Oletus 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 Attribuutit (Degree) Aste Measure. Type Elementillä annetaan työkohteen sijaintipaikan leveyskoodinaatin minuutit. unitcode Measure Unit. Code Toisto.. Location Coordinate. Latitude Direction Code. Code Latitude Direction_ Code List. Identifier Latitude Direction_ Code List. Agency. 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 Koodit Attribuutit Esimerkki Esimerkki Käytettävät koodit (Minute) Minuutti Latitude Direction_ Code. Type Elementillä annetaan työkohteen 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" Latitude Direction UBL Latitude Direction (leveyspiirin suunta) Attribuutilla annetaan leveyspiirin suuntakoodiston ylläpitäjä. Esimerkki listagencyid="ubl" Käytettävät koodit UBL UBL (Universal Business Language) 83/32

84 Location Coordinate. Longitude_ Degrees. Measure Attribuutit Measure. Type Elementillä annetaan työkohteen sijaintipaikan pituuskoodinaatin 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 Attribuutit (Degree) Aste Measure. Type Elementillä annetaan työkohteen sijaintipaikan pituuskoodinaatin minuutit. unitcode Measure Unit. Code Toisto.. Location Coordinate. Longitude Direction Code. Code Longitude Direction_ Code List. Identifier Esimerkki <cbc:longitudeminutesmeasure unitcode="min">3.69 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 Koodit Attribuutit Esimerkki (Minute) Minuutti Longitude Direction_ Code. Type Elementillä annetaan työkohteen sijaintipaikan pituuskoodinaatin suunta meridiaanilta ilmaistuna koodimuotoisesti. East = (East) Itäistä pituutta West = (West) Läntistä pituutta listid ja listagencyid <cbc:longitudedirectioncode listid= Longitude Direction" listagencyid="ubl">east</cbc:longitudedirectioncode> Attribuutilla annetaan pituuspiirin suuntakoodiston tunnus. 84/32

85 Longitude Direction_ Code List. Agency. Identifier 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) 85/32

86 6.2.8 Tehtävän suorittamisperiodin tiedot (Delivery. Requested Delivery_ Period. Period) Delivery. Requested Delivery_ Period. Period Period. Start Date. Date Period. Start Time. Time Period. End Date. Date Period. End Time. Time Period. Duration. Measure Period. Description Code. Code Period. Description. Text Elementti / aggregaatti Delivery. Requested Delivery_ Period. Period Toistokerrat, tyyppi, kuvaus, esimerkki Period. Details Aggregaatilla annetaan tehtävän muuttuneet suorittamisperiodin tiedot. Period. Start Date. Date Huomautus Tällä aggregaatilla annetaan päivämäärä- ja aikaväli. Jos tehtävän suorittamisperiodi on tietty päivä, annetaan elementtien Period. Start Date. Date ja Period. End Date. Date arvona sama päivämäärä. Esimerkki <cac:requesteddeliveryperiod> </cac:requesteddeliveryperiod> Date. Type Period. End Date. Date Elementillä annetaan tehtävän muuttunut alkurajapäivämäärä. Esimerkki <cbc:startdate> </cbc:startdate> Date. Type Elementillä annetaan tehtävän muuttunut loppurajapäivämäärä. Esimerkki <cbc:enddate> </cbc:enddate> 86/32

87 6.2.9 Suunniteltu kohteen käyttöönottopäivämäärän tiedot (Delivery. Estimated Delivery_ Period. Period) Delivery. Estimated Delivery_ Period. Period Period. Start Date. Date Period. Start Time. Time Period. End Date. Date Period. End Time. Time Period. Duration. Measure Period. Description Code. Code Period. Description. Text Elementti / aggregaatti Delivery. Estimated Delivery_ Period. Period Toistokerrat, tyyppi, kuvaus, esimerkki Period. Start Date. Date Period. Details Aggregaattia annetaan muuttunut suunniteltu (luvattu) kohteen käyttöönottopäivä. Huomautus Tällä aggregaatilla annetaan päivämäärä- ja aikaväli. Jos suunniteltu (luvattu) kohteen käyttöönottopäivä on tietty päivä, annetaan elementtien Period. Start Date. Date ja Period. End Date. Date arvona sama päivämäärä. Esimerkki <cac:estimateddeliveryperiod> </cac:estimateddeliveryperiod> Date. Type Period. End Date. Date Elementillä annetaan kohteen muuttunut suunniteltu (luvattu) ensimmäinen käyttöönottopäivä. Esimerkki <cbc:startdate> </cbc:startdate> Date. Type Elementillä annetaan kohteen muuttunut suunniteltu (luvattu) viimeinen käyttöönottopäivä. Esimerkki <cbc:enddate> </cbc:enddate> 87/32

88 6.2.0 Tuotteen tuotetiedot (Line Item. Item) Line Item. Item Item. Description. Text Item. Pack Quantity. Quantity Item. Pack Size. Numeric Item. Catalogue_ Indicator. Indicator Item. Name Item. Hazardous Risk_ Indicator. Indicator Item. Additional_ Information. Text Item. Keyword. Text Item. Brand Name. Name Item. Model Name. Name Item. Buyers_ Item Identification. Item Identification Item. Sellers_ Item Identification. Item Identification Item. Manufacturers_ Item Identification. Item Identification Item. Standard_ Item Identification. Item Identification Item. Catalogue_ Item Identification. Item Identification Item. Additional_ Item Identification. Item Identification Item. Catalogue_ Document Reference. Document Reference Item. Item Specification_ Document Reference. Document Reference Item. Origin_ Country. Country Item. Commodity Classification Item. Transaction Conditions Item. Hazardous Item Item. Classified_ Tax Category. Tax Category Item. Additional_ Item Property. Item Property Item. Manufacturer_ Party. Party Item. Information Content Provider_ Party. Party Item. Origin_ Address. Address Item. Item Instance 88/32

89 Elementti / aggregaatti Line Item. Item Toisto.. Toistokerrat, tyyppi, kuvaus, esimerkki Item. Details Aggregaatilla annetaan työyksikön tuotetiedot, kuten tuotekoodi ja nimi. Esimerkki <cac:item> </cac:item> Item. Description. Text Toisto 0.. unbounded Text. Type Attribuutit languageid Language. Identifier Elementillä annetaan työyksikön kuvaus (pitkä teksti). Esimerkki <cbc:description languageid="fi">hengenvaar/livsfara,,5mm paksu</cbc:description> tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Item. Name Name. Type Elementillä annetaan tuotenimi, joka esiintyy esimerkiksi tuoteluettelossa tuotekoodin kanssa. Huomautus Tilausmuutoksessa tuotenimi voi muuttua, mutta tuotekoodi ei saa muuttua. Attribuutit languageid Language. Identifier Item. Additional_ Information. Text Esimerkki <cbc:name languageid="fi">varoituskilpi</cbc:name> Nimitekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Text. Type Attribuutit languageid Language. Identifier Elementillä annetaan tuotteeseen liittyvää muuta tietoa, jota ei voida antaa muiden elementtien arvona. Esimerkki <cbc:additionalinformation languageid="fi">pylväs viljapellolla. Kiinnitysajankohdasta sovittava pellon omistajan kanssa. </cbc:additionalinformation> Työkohteeseen liittyvän muun tiedon kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla 89/32

90 Item. Buyers_ Item Identification. Item Identification 6.2. Item. Standard_ Item Identification. Item Identification Esimerkki languageid="fi" Item Identification. Details Aggregaatilla annetaan tilaajan tuotekoodi- eli nimiketiedot. Esimerkki <cac:buyersitemidentification> </cac:buyersitemidentification> Item Identification. Details Aggregaatilla annetaan sähköalan tuotekoodi- eli nimiketiedot. Esimerkki <cac:standarditemidentification> </cac:standarditemidentification> 90/32

91 6.2. Tilaajan tuotekoodi eli nimike (Item. Buyers_ Item Identification. Item Identification) Item. Buyers_ Item Identification. Item Identification Item Identification. Identifier Item Identification. Extended_ Identifier. Identifier Item Identification. Physical Attribute Item Identification. Measurement_ Dimension. Dimension Item Identification. Issuer_ Party. Party Elementti / aggregaatti Item. Buyers_ Item Identification. Item Identification Item Identification. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Item Identification. Details Aggregaatilla annetaan tilaajan tuotekoodi- eli nimiketiedot. Esimerkki <cac:buyersitemidentification> </cac:buyersitemidentification> Toisto.. Identifier. Type Elementillä annetaan tilaajan tuotekoodi eli nimike. Huomautus Tilausmuutoksessa tuotekoodi ei saa muuttua. Esimerkki <cbc:id>zt203</cbc:id> 9/32

92 6.2.2 Sähköalan tuotekoodi eli nimike (Item. Standard_ Item Identification. Item Identification) Item. Standard_ Item Identification. Item Identification Item Identification. Identifier Item Identification. Extended_ Identifier. Identifier Item Identification. Physical Attribute Item Identification. Measurement_ Dimension. Dimension Item Identification. Issuer_ Party. Party Elementti / aggregaatti Item. Standard_ Item Identification. Item Identification Item Identification. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Item Identification. Details Aggregaatilla annetaan sähköalan tuotekoodi- eli nimiketiedot. Esimerkki <cac:standarditemidentification> </cac:standarditemidentification> Toisto.. Identifier. Type Elementillä annetaan sähköalan tuotekoodi eli nimike. Huomautus Tilausmuutoksessa tuotekoodi ei saa muuttua. Esimerkki <cbc:id>645065</cbc:id> 92/32

93 6.2.3 Tilausmuutosrivin viitteet (Order Line. Document Reference) Order Line. Document Reference Document Reference. Identifier Document Reference. Copy_ Indicator. Indicator Document Reference. UUID. Identifier Document Reference. Issue Date. Date Document Reference. Document Type Code. Code Document Reference. Document Type. Text Document Reference. XPath. Text Document Reference. Attachment Elementti / aggregaatti Order Line. Document Reference Document Reference. Identifier Document Reference. Document Type Code. Code Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Document Reference. Details Aggregaatilla annetaan tilausmuutoksen riviin liittyvät viitteet. Esimerkki <cac:documentreference> </cac:documentreference> Toisto.. Identifier. Type Elementillä annetaan tilausmuutoksen rivin viitteen tunnus. Huomautus Tämä elementti on pakollinen. Jos tilausmuutoksen riviin ei liity viitettä, vaan aggregaatin ala-agregaateilla välitetään rivin liitetiedostoja tai Internet-osoitteita, annetaan tämän elementin arvona merkkijono XXXXXX. Esimerkki <cbc:id> </cbc:id> Code. Type Elementillä annetaan tilausmuutoksen rivin viitteen tyyppi koodimuotoisena. Huomautus Elementin arvoja on kahdessa eri koodistossa. OASIS on määritellyt UN/ECE koodiston "00 Document name code" oletusarvoiseksi koodistoksi. Jos tästä koodistosta ei löydy sopivaa koodia, voidaan käyttää UN/ECE koodistoa 53 Reference qualifier". Koodit UN/ECE koodiston 53 mukaisia koodeja ovat: JB = (Job number) Työ Attribuutit listid ja listagencyid Esimerkki <cbc:documenttypecode listid= UN/ECE53" listagencyid="6">jb</cbc:documenttypecode> 93/32

94 Code List. Identifier Code List. Agency. Identifier Document Reference. Document Type. Text Attribuutilla annetaan viitteen tunnuskoodiston tunnus; joko UN/ECE 00 tai UN/ECE 53 Esimerkki listid="un/ece 53" Käytettävät koodit UN/ECE 00 UN/ECE koodisto 00 "Document name code" UN/ECE 53 UN/ECE koodisto 53 "Reference qualifier" Attribuutilla annetaan viitteen tunnuskoodiston ylläpitäjän tunnus Esimerkki listagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) Text. Type Elementillä annetaan tilausmuutoksen rivin viitteen tyyppi tekstimuotoisena. Attribuutit languageid Language. Identifier Document Reference. Attachment Esimerkki <cbc:documenttype languageid="fi">työnumero </cbc:documenttype> Tilausmuutoksen viitteen tekstimuotoisen tyypin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla. Esimerkki languageid="fi" Attachment. Details Aggregaatilla annetaan tilausmuutoksen riviin liittyvä liite. Huomautus Lähetettävien liitetiedostojen koosta partnereitten on sovittava keskenään, jotta tietokoneitten kapasiteetti ei kuormittuisi liikaa sanoman prosessoinnissa. Esimerkki <cac:attachment> </cac:attachment> 94/32

95 6.2.4 Tilausmuutoksen rivin liitetiedosto (Document Reference. Attachment) Document Reference. Attachment Attachment. Embedded_ Document. Binary Object Attachment. External Reference Elementti / aggregaatti Document Reference. Attachment Attachment. Embedded_ Document. Binary Object Attachment. External Reference Toistokerrat, tyyppi, kuvaus, esimerkki Attachment. Details Aggregaatilla annetaan tilausmuutoksen riviin liittyvä liite. Huomautus Lähetettävien liitetiedostojen koosta partnereitten on sovittava keskenään, jotta tietokoneitten kapasiteetti ei kuormittuisi liikaa sanoman prosessoinnissa. Esimerkki <cac:attachment> </cac:attachment> Binary Object. Type Elementillä annetaan tilausmuutoksen rivin liite sanoman sisäisenä binäärisenä suurena oliona (Binary Large Object eli BLOB). Esimerkki <cbc:embeddeddocumentbinaryobject> liitetiedosto binäärisenä suurena oliona </cbc:embeddeddocumentbinaryobject> External Reference. Details Aggregaatilla annetaan tilausmuutoksen riviin liittyvän liitetiedoston web-osoitetiedot. Esimerkki <cac:externalreference> </cac:externalreference> 95/32

96 6.2.5 Tilausmuutoksen rivin liitetiedoston web-osoite (Attachment. External Reference) Attachment. External Reference External Reference. URI. Identifier External Reference. Document Hash. Text External Reference. Expiry Date. Date External Reference. Expiry Time. Time Elementti / aggregaatti Attachment. External Reference External Reference. URI. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki External Reference. Details Aggregaatilla annetaan tilausmuutoksen riviin liittyvän liitetiedoston web-osoitetiedot. Esimerkki <cac:externalreference> </cac:externalreference> Identifier. Type Elementillä annetaan tilausmuutoksen rivin liitetiedoston webosoite eli URI (Uniform Resource Identifier) Esimerkki <cbc:uri> 96/32

97 6.3 Sanoman rivitaso (mittarointi) Sanoman rivitasolla välitetään tilattavaa mittarointia koskevat muutostiedot. Mittarointiin voi tulla muutos vain mittaroinnin suorittamisajankohtaan rivitasolla Vanhaan mittariin liittyvät tiedot (Order. Order Line) Order. Order Line Order Line. Substitution Status Code. Code Order Line. Note. Text Order Line. Line Item Order Line. Seller Proposed Substitute_ Line Item. Line Item Order Line. Seller Substituted_ Line Item. Line Item Order Line. Buyer Proposed Substitute_ Line Item. Line Item Order Line. Catalogue_ Line Reference. Line Reference Order Line. Quotation_ Line Reference. Line Reference Order Line. Document Reference 97/32

98 Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Order. Order Line Toisto.. unbounded Order Line. Details Aggregaatilla annetaan vanhaan mittariin liittyvät tiedot. Esimerkki <cac:orderline> </cac:orderline> Order Line. Note. Text Text. Type Elementillä annetaan mittarointiin liittyvän laitteen laji. Huomautus Tällä elementtillä ilmoitetaan, minkälaisen laitteen tietoja annetaan, esimerkiksi vanha mittari, uusi mittari, vanha ohjauslaite. Attribuutit languageid Esimerkki <cbc:note languageid="fi">vanha mittari</cbc:note> Language. Identifier Mittaroinnin tilausrivin vapaamuotoisen tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla. Esimerkki languageid="fi" Order Line. Line Item Toisto Line Item. Details Aggregaatilla annetaan vanhan mittarin tiedot. Esimerkki <cac:lineitem> </cac:lineitem> 98/32

99 6.3.2 Vanhan mittarin tiedot (Order Line. Line Item) Order Line. Line Item Line Item. Identifier Line Item. Sales_ Order Identifier. Identifier Line Item. UUID. Identifier Line Item. Note. Text Line Item. Line Status Code. Code Line Item. Quantity Line Item. Line Extension Amount. Amount Line Item. Total_ Tax Amount. Amount Line Item. Minimum_ Quantity. Quantity Line Item. Maximum_ Quantity. Quantity Line Item. Minimum_ Backorder. Quantity Line Item. Maximum_ Backorder. Quantity Line Item. Inspection Method. Code Line Item. Partial Delivery Indicator. Indicator Line Item. Back Order Allowed Indicator. Indicator Line Item. Accounting Cost Code. Code Line Item. Accounting Cost. Text Line Item. Delivery Line Item. Delivery Terms Line Item. Originator_ Party. Party Line Item. Ordered Shipment Line Item. Pricing Reference Line Item. Allowance Charge Line Item. Price Line Item. Item Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Order Line. Line Item Toisto.. Line Item. Details Aggregaatilla annetaan vanhan mittarin tiedot. Esimerkki <cac:lineitem> </cac:lineitem> Line Item. Identifier Toisto.. Identifier. Type Elementillä annetaan tilausmuutoksen rivin tunnus. Esimerkki <cbc:id>003</cbc:id> Line Item. Delivery Toisto 0.. unbounded Delivery. Details Aggregaatilla annetaan vanhaan mittariin liittyvät mittaroinnin muuttuneet aikatiedot. Esimerkki <cac:delivery> </cac:delivery> Line Item. Item Toisto Item. Details Aggregaatilla annetaan vanhan mittarin tuotekoodi. Esimerkki <cac:item> </cac:item> 99/32

100 6.3.3 Vanhaan mittariin liittyvät aikatiedot (Line Item. Delivery) Line Item. Delivery Delivery. Identifier Delivery. Quantity Delivery. Minimum_ Quantity. Quantity Delivery. Maximum_ Quantity. Quantity Delivery. Actual_ Delivery Date. Date Delivery. Actual_ Delivery Time. Time Delivery. Latest_ Delivery Date. Date Delivery. Latest_ Delivery Time. Time Delivery. Tracking Identifier. Identifier Delivery. Delivery_ Address. Address Delivery. Delivery_ Location. Location Delivery. Requested Delivery_ Period. Period Delivery. Promised Delivery_ Period. Period Delivery. Estimated Delivery_ Period. Period Delivery. Delivery_ Party. Party Delivery. Despatch Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Line Item. Delivery Toisto 0.. unbounded Delivery. Requested Delivery_ Period. Period Delivery. Details Aggregaatilla annetaan vanhaan mittariin liittyvät mittaroinnin muuttuneet aikatiedot. Esimerkki <cac:delivery> </cac:delivery> Period. Details Aggregaatilla annetaan mittaroinnin suorittamisperiodin muutostiedot. Huomautus Tällä aggregaatilla annetaan päivämäärä- ja aikaväli. Jos tehtävän suorittamisperiodi on tietty päivä, annetaan elementtien Period. Start Date. Date ja Period. End Date. Date arvona sama päivämäärä. Esimerkki <cac:requesteddeliveryperiod> </cac:requesteddeliveryperiod> 00/32

101 6.3.4 Mittaroinnin suorittamisperiodin tiedot (Delivery. Requested Delivery_ Period. Period) Delivery. Requested Delivery_ Period. Period Period. Start Date. Date Period. Start Time. Time Period. End Date. Date Period. End Time. Time Period. Duration. Measure Period. Description Code. Code Period. Description. Text Elementti / aggregaatti Delivery. Requested Delivery_ Period. Period Toistokerrat, tyyppi, kuvaus, esimerkki Period. Start Date. Date Period. Details Aggregaatilla annetaan mittaroinnin suorittamisperiodin muutostiedot. Huomautus Tällä aggregaatilla annetaan päivämäärä- ja aikaväli. Jos tehtävän suorittamisperiodi on tietty päivä, annetaan elementtien Period. Start Date. Date ja Period. End Date. Date arvona sama päivämäärä. Esimerkki <cac:requesteddeliveryperiod> </cac:requesteddeliveryperiod> Date. Type Period. End Date. Date Elementillä annetaan mittaroinnin muuttunut alkurajapäivämäärä. Esimerkki <cbc:startdate> </cbc:startdate> Date. Type Elementillä annetaan mittaroinnin muuttunut loppurajapäivämäärä. Esimerkki <cbc:enddate> </cbc:enddate> 0/32

102 6.3.5 Vanhan mittarin tuotetiedot (Line Item. Item) Line Item. Item Item. Description. Text Item. Pack Quantity. Quantity Item. Pack Size. Numeric Item. Catalogue_ Indicator. Indicator Item. Name Item. Hazardous Risk_ Indicator. Indicator Item. Additional_ Information. Text Item. Keyword. Text Item. Brand Name. Name Item. Model Name. Name Item. Buyers_ Item Identification. Item Identification Item. Sellers_ Item Identification. Item Identification Item. Manufacturers_ Item Identification. Item Identification Item. Standard_ Item Identification. Item Identification Item. Catalogue_ Item Identification. Item Identification Item. Additional_ Item Identification. Item Identification Item. Catalogue_ Document Reference. Document Reference Item. Item Specification_ Document Reference. Document Reference Item. Origin_ Country. Country Item. Commodity Classification Item. Transaction Conditions Item. Hazardous Item Item. Classified_ Tax Category. Tax Category Item. Additional_ Item Property. Item Property Item. Manufacturer_ Party. Party Item. Information Content Provider_ Party. Party Item. Origin_ Address. Address Item. Item Instance 02/32

103 Elementti / aggregaatti Line Item. Item Toisto.. Item. Buyers_ Item Identification. Item Identification Item. Item Instance Toistokerrat, tyyppi, kuvaus, esimerkki Item. Details Aggregaatilla annetaan vanhan mittarin tuotekoodi. Esimerkki <cac:item> </cac:item> Item Identification. Details Aggregaatilla annetaan vanhan mittarin tiedot. Esimerkki <cac:buyersitemidentification> Toisto </cac:buyersitemidentification> 0.. unbounded Item Instance. Details Aggregaatilla annetaan vanhan mittarin valmistusnumero. Esimerkki <cac:iteminstance> </cac:iteminstance> 03/32

104 6.3.6 Vanhan mittarin tiedot (Item. Buyers_ Item Identification. Item Identification) Item. Buyers_ Item Identification. Item Identification Item Identification. Identifier Item Identification. Extended_ Identifier. Identifier Item Identification. Physical Attribute Item Identification. Measurement_ Dimension. Dimension Item Identification. Issuer_ Party. Party Elementti / aggregaatti Item. Buyers_ Item Identification. Item Identification Item Identification. Identifier Item Identification. Physical Attribute Toistokerrat, tyyppi, kuvaus, esimerkki Item Identification. Details Aggregaatilla annetaan vanhan mittarin tiedot. Esimerkki <cac:buyersitemidentification> </cac:buyersitemidentification> Toisto.. Identifier. Type Elementillä annetaan vanhan mittarin verkkoyhtiön antama tunnus, joka näkyy etupanelissa ja laskulla. Esimerkki <cbc:id>72578</cbc:id> Toisto 0.. unbounded Physical Attribute. Details Aggregaatilla annetaan vanhan mittarin laitetyypin nimi. Esimerkki <cac:physicalattribute> </cac:physicalattribute> 04/32

105 6.3.7 Vanhan mittarin laitetyypin nimi (Item Identification. Physical Attribute) Item Identification. Physical Attribute Physical Attribute. Attribute Identifier. Identifier Physical Attribute. Position Code. Code Physical Attribute. Description Code. Code Physical Attribute. Description. Text Elementti / aggregaatti Item Identification. Physical Attribute Physical Attribute. Attribute Identifier. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Physical Attribute. Description Code. Code Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Physical Attribute. Details Aggregaatilla annetaan vanhan mittarin laitetyypin nimi. Esimerkki <cac:physicalattribute> </cac:physicalattribute> Toisto.. Identifier. Type Elementillä annetaan vanhan mittarin ominaisuuden tunnistekoodi. Koodit Käytettäviä koodeja ovat: 8 = (Product) Laitetyyppi Attribuutit schemeid ja schemeagencyid Esimerkki <cbc:attributeid schemeid="un/ece 708" schemeagencyid="6">8</cbc:attributeid> Attribuutilla annetaan tuoteominaisuuskoodiston tunnus. Esimerkki schemeid="un/ece 708" Käytettävät koodit UN/ECE 708 UN/ECE koodisto 708 Item characteristic code Attribuutilla annetaan tuoteominaisuuskoodiston ylläpitäjä. Esimerkki schemeagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) Code. Type Elementillä annetaan vanhan mittarin laitetyyppi koodimuotoisena. Attribuutit listagencyid Esimerkki <cbc:descriptioncode listagencyid="92">valmet K2N 05/32

106 Code List. Agency. Identifier Physical Attribute. Description. Text </cbc:descriptioncode> Attribuutilla annetaan ominaisuusarvokoodiston ylläpitäjän tunnus. Esimerkki listagencyid="92" Käytettävät koodit 92 (Assigned by buyer or buyer's agent) Ostajan ylläpitämä luettelo Toisto 0.. unbounded Text. Type Elementillä annetaan vanhan mittarin laitetyypin nimi tekstimuotoisena. Attribuutit languageid Language. Identifier Esimerkki <cbc:description languageid="fi">valmet Kolmivaihe kilowattituntimittari malli K2N</cbc:Description> Tuotteen ominaisuuden tekstitiedon kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" 06/32

107 6.3.8 Vanhan mittalaitteen valmistusnumero (Item. Item Instance) Item. Item Instance Item Instance. Product Trace_ Identifier. Identifier Item Instance. Manufacture Date. Date Item Instance. Manufacture Time. Time Item Instance. Registration Identifier. Identifier Item Instance. Serial Identifier. Identifier Item Instance. Additional_ Item Property. Item Property Item Instance. Lot Identification Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Item. Item Instance Toisto 0.. unbounded Item Instance. Serial Identifier. Identifier Item Instance. Details Aggregaatilla annetaan vanhan mittarin valmistusnumero. Esimerkki <cac:iteminstance> </cac:iteminstance> Identifier. Type Elementillä annetaan vanhan mittarin valmistusnumero. Esimerkki <cbc:serialid>52863</cbc:serialid> 07/32

108 6.3.9 Uuteen mittariin liittyvät tiedot (Order. Order Line) Order. Order Line Order Line. Substitution Status Code. Code Order Line. Note. Text Order Line. Line Item Order Line. Seller Proposed Substitute_ Line Item. Line Item Order Line. Seller Substituted_ Line Item. Line Item Order Line. Buyer Proposed Substitute_ Line Item. Line Item Order Line. Catalogue_ Line Reference. Line Reference Order Line. Quotation_ Line Reference. Line Reference Order Line. Document Reference Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Order. Order Line Toisto.. unbounded Order Line. Details Aggregaatilla annetaan uuteen mittariin liittyvät tiedot. Esimerkki <cac:orderline> </cac:orderline> Order Line. Note. Text Text. Type Elementillä annetaan mittarointiin liittyvän laitteen laji. Huomautus Tällä elementtillä ilmoitetaan, minkälaisen laitteen tietoja annetaan, esimerkiksi vanha mittari, uusi mittari, vanha ohjauslaite. Attribuutit languageid Esimerkki <cbc:note languageid="fi">uusi mittari</cbc:note> Language. Identifier Tilausrivin vapaamuotoisen tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Order Line. Line Item Toisto Line Item. Details Aggregaatilla annetaan uuden mittarin tiedot. 08/32

109 Order Line. Document Reference Esimerkki <cac:lineitem> </cac:lineitem> Toisto 0.. unbounded Document Reference. Details Aggregaatilla annetaan sen vanhan mittarin tunnus, joka korvataan uudella mittarilla. Esimerkki <cac:documentreference> </cac:documentreference> 09/32

110 6.3.0 Uuden mittarin tiedot (Order Line. Line Item) Order Line. Line Item Line Item. Identifier Line Item. Sales_ Order Identifier. Identifier Line Item. UUID. Identifier Line Item. Note. Text Line Item. Line Status Code. Code Line Item. Quantity Line Item. Line Extension Amount. Amount Line Item. Total_ Tax Amount. Amount Line Item. Minimum_ Quantity. Quantity Line Item. Maximum_ Quantity. Quantity Line Item. Minimum_ Backorder. Quantity Line Item. Maximum_ Backorder. Quantity Line Item. Inspection Method. Code Line Item. Partial Delivery Indicator. Indicator Line Item. Back Order Allowed Indicator. Indicator Line Item. Accounting Cost Code. Code Line Item. Accounting Cost. Text Line Item. Delivery Line Item. Delivery Terms Line Item. Originator_ Party. Party Line Item. Ordered Shipment Line Item. Pricing Reference Line Item. Allowance Charge Line Item. Price Line Item. Item Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Order Line. Line Item Toisto.. Line Item. Details Aggregaatilla annetaan uuden mittarin tiedot. Esimerkki <cac:lineitem> </cac:lineitem> Line Item. Identifier Toisto.. Identifier. Type Elementillä annetaan tilausmuutoksen rivin tunnus. Esimerkki <cbc:id>005</cbc:id> Line Item. Delivery Toisto 0.. unbounded 6.3. Delivery. Details Aggregaatilla annetaan uuteen mittariin liittyvät mittaroinnin muuttuneet aikatiedot. Esimerkki <cac:delivery> </cac:delivery> Line Item. Item Toisto Item. Details Aggregaatilla annetaan uuden mittarin tiedot, kuten tuotekoodi. Esimerkki <cac:item> </cac:item> 0/32

111 6.3. Uuteen mittariin liittyvät aikatiedot (Line Item. Delivery) Line Item. Delivery Delivery. Identifier Delivery. Quantity Delivery. Minimum_ Quantity. Quantity Delivery. Maximum_ Quantity. Quantity Delivery. Actual_ Delivery Date. Date Delivery. Actual_ Delivery Time. Time Delivery. Latest_ Delivery Date. Date Delivery. Latest_ Delivery Time. Time Delivery. Tracking Identifier. Identifier Delivery. Delivery_ Address. Address Delivery. Delivery_ Location. Location Delivery. Requested Delivery_ Period. Period Delivery. Promised Delivery_ Period. Period Delivery. Estimated Delivery_ Period. Period Delivery. Delivery_ Party. Party Delivery. Despatch Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Line Item. Delivery Toisto 0.. unbounded Delivery. Requested Delivery_ Period. Period Delivery. Details Aggregaatilla annetaan uuteen mittariin liittyvät mittaroinnin muuttuneet aikatiedot. Esimerkki <cac:delivery> </cac:delivery> Period. Details Aggregaatilla annetaan mittaroinnin muuttuneet suorittamisperiodin tiedot. Huomautus Tällä aggregaatilla annetaan päivämäärä- ja aikaväli. Jos tehtävän suorittamisperiodi on tietty päivä, annetaan elementtien Period. Start Date. Date ja Period. End Date. Date arvona sama päivämäärä. Esimerkki <cac:requesteddeliveryperiod> </cac:requesteddeliveryperiod> /32

112 6.3.2 Mittaroinnin suorittamisperiodin tiedot (Delivery. Requested Delivery_ Period. Period) Delivery. Requested Delivery_ Period. Period Period. Start Date. Date Period. Start Time. Time Period. End Date. Date Period. End Time. Time Period. Duration. Measure Period. Description Code. Code Period. Description. Text Elementti / aggregaatti Delivery. Requested Delivery_ Period. Period Toistokerrat, tyyppi, kuvaus, esimerkki Period. Start Date. Date Period. Details Aggregaatilla annetaan mittaroinnin muuttuneet suorittamisperiodin tiedot. Huomautus Tällä aggregaatilla annetaan päivämäärä- ja aikaväli. Jos tehtävän suorittamisperiodi on tietty päivä, annetaan elementtien Period. Start Date. Date ja Period. End Date. Date arvona sama päivämäärä. Esimerkki <cac:requesteddeliveryperiod> </cac:requesteddeliveryperiod> Date. Type Period. End Date. Date Elementillä annetaan mittaroinnin muuttunut alkurajapäivämäärä. Esimerkki <cbc:startdate> </cbc:startdate> Date. Type Elementillä annetaan mittaroinnin muuttunut loppurajapäivämäärä. Esimerkki <cbc:enddate> </cbc:enddate> 2/32

113 6.3.3 Uuden mittarin tuotetiedot (Line Item. Item) Line Item. Item Item. Description. Text Item. Pack Quantity. Quantity Item. Pack Size. Numeric Item. Catalogue_ Indicator. Indicator Item. Name Item. Hazardous Risk_ Indicator. Indicator Item. Additional_ Information. Text Item. Keyword. Text Item. Brand Name. Name Item. Model Name. Name Item. Buyers_ Item Identification. Item Identification Item. Sellers_ Item Identification. Item Identification Item. Manufacturers_ Item Identification. Item Identification Item. Standard_ Item Identification. Item Identification Item. Catalogue_ Item Identification. Item Identification Item. Additional_ Item Identification. Item Identification Item. Catalogue_ Document Reference. Document Reference Item. Item Specification_ Document Reference. Document Reference Item. Origin_ Country. Country Item. Commodity Classification Item. Transaction Conditions Item. Hazardous Item Item. Classified_ Tax Category. Tax Category Item. Additional_ Item Property. Item Property Item. Manufacturer_ Party. Party Item. Information Content Provider_ Party. Party Item. Origin_ Address. Address Item. Item Instance 3/32

114 Elementti / aggregaatti Line Item. Item Toisto.. Item. Manufacturers_ Item Identification. Item Identification Toistokerrat, tyyppi, kuvaus, esimerkki Item. Details Aggregaatilla annetaan uuden mittarin tiedot, kuten tuotekoodi. Esimerkki <cac:item> </cac:item> Item Identification. Details Aggregaatilla annetaan uuden mittarin tiedot. Esimerkki <cac:manufacturersitemidentification> </cac:manufacturersitemidentification> 4/32

115 6.3.4 Uuden mittarin tiedot (Item. Manufacturers_ Item Identification. Item Identification) Item. Manufacturers_ Item Identification. Item Identification Item Identification. Identifier Item Identification. Extended_ Identifier. Identifier Item Identification. Physical Attribute Item Identification. Measurement_ Dimension. Dimension Item Identification. Issuer_ Party. Party Elementti / aggregaatti Item. Manufacturers_ Item Identification. Item Identification Item Identification. Identifier Item Identification. Physical Attribute Toistokerrat, tyyppi, kuvaus, esimerkki Item Identification. Details Aggregaatilla annetaan uuden mittarin tiedot. Esimerkki <cac:manufacturersitemidentification> </cac:manufacturersitemidentification> Toisto.. Identifier. Type Elementillä annetaan uuden mittarin tunnus, Huomautus Tämä elementti on pakollinen, kun aggregaatti esiiintyy. jos uuden mittarin tunnus ei ole tiedossa, annetaan tämän elementin arvona merkkijono XXXXXX Esimerkki <cbc:id>xxxxxx</cbc:id> Toisto 0.. unbounded Physical Attribute. Details Aggregaatilla annetaan uuden mittarin ominaisuustietoja, kuten laitetyyppi. Esimerkki <cac:physicalattribute> </cac:physicalattribute> 5/32

116 6.3.5 Uuden mittarin laitetyypin nimi (Item Identification. Physical Attribute) Item Identification. Physical Attribute Physical Attribute. Attribute Identifier. Identifier Physical Attribute. Position Code. Code Physical Attribute. Description Code. Code Physical Attribute. Description. Text Elementti / aggregaatti Item Identification. Physical Attribute Physical Attribute. Attribute Identifier. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Physical Attribute. Description Code. Code Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Physical Attribute. Details Aggregaatilla annetaan uuden mittarin laitetyypin nimi. Esimerkki <cac:physicalattribute> </cac:physicalattribute> Toisto.. Identifier. Type Elementillä annetaan uuden mittarin ominaisuuden tunnistekoodi. Koodit Käytettäviä koodeja ovat: 8 = (Product) Laitetyyppi Attribuutit schemeid ja schemeagencyid Esimerkki <cbc:attributeid schemeid="un/ece 708" schemeagencyid="6">8</cbc:attributeid> Attribuutilla annetaan tuoteominaisuuskoodiston tunnus. Esimerkki schemeid="un/ece 708" Käytettävät koodit UN/ECE 708 UN/ECE koodisto 708 Item characteristic code Attribuutilla annetaan tuoteominaisuuskoodiston ylläpitäjä. Esimerkki schemeagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) Code. Type Elementillä annetaan uuden mittarin laitetyyppi koodimuotoisena. Attribuutit listagencyid Esimerkki <cbc:descriptioncode listagencyid="90">eo7ol 6/32

117 Code List. Agency. Identifier Physical Attribute. Description. Text </cbc:descriptioncode> Attribuutilla annetaan ominaisuusarvokoodiston ylläpitäjän tunnus. Esimerkki listagencyid="90" Käytettävät koodit 90 (Assigned by manufacturer) Valmistajan ylläpitämä luettelo Toisto 0.. unbounded Text. Type Elementillä annetaan uuden mittarin laitetyypin nimi tekstimuotoisena. Attribuutit languageid Language. Identifier Esimerkki <cbc:description languageid="fi">enermet</cbc:description> Tuotteen ominaisuuden tekstitiedon kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" 7/32

118 6.3.6 Vanhan mittarin tunnus (Order Line. Document Reference) Order Line. Document Reference Document Reference. Identifier Document Reference. Copy_ Indicator. Indicator Document Reference. UUID. Identifier Document Reference. Issue Date. Date Document Reference. Document Type Code. Code Document Reference. Document Type. Text Document Reference. XPath. Text Document Reference. Attachment Elementti / aggregaatti Order Line. Document Reference Document Reference. Identifier Document Reference. Document Type Code. Code Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Document Reference. Details Aggregaatilla annetaan sen vanhan mittarin tunnus, joka korvataan uudella mittarilla. Esimerkki <cac:documentreference> </cac:documentreference> Toisto.. Identifier. Type Elementillä annetaan vanhan mittarin tunnus, joka on aiemmin annettu vanhan mittarin tietojen yhteydessä aggregaatissa Item. Buyers_ Item Identification. Item Identification elementin Item Identification. Identifier arvona. Esimerkki <cbc:id>72578</cbc:id> Code. Type Elementillä annetaan uuden mittarin viitteen tyyppi koodimuotoisena. Huomautus Elementin arvoja on kahdessa eri koodistossa. OASIS on määritellyt UN/ECE koodiston "00 Document name code" oletusarvoiseksi koodistoksi. Jos tästä koodistosta ei löydy sopivaa koodia, voidaan käyttää UN/ECE koodistoa 53 Reference qualifier". Koodit UN/ECE koodiston 53 mukaisia koodeja ovat: AMK = (Replaced meter unit number) Vanhan mittarin tunnus Attribuutit listid ja listagencyid Esimerkki <cbc:documenttypecode listid= UN/ECE53" listagencyid="6">amk</cbc:documenttypecode> 8/32

119 Code List. Identifier Code List. Agency. Identifier Attribuutilla annetaan viitteen tunnuskoodiston tunnus; joko UN/ECE 00 tai UN/ECE 53 Esimerkki listid="un/ece 53" Käytettävät koodit UN/ECE 00 UN/ECE koodisto 00 "Document name code" UN/ECE 53 UN/ECE koodisto 53 "Reference qualifier" Attribuutilla annetaan viitteen tunnuskoodiston ylläpitäjän tunnus Esimerkki listagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) 9/32

120 7 Sanomaesimerkki Tässä kappaleessa on kaksi esimerkkiä UBL-OrderChange-tilausmuutoksesta. Ensimmäisessä esimerkissä esitetään pientyötilauksen muutostietojen välitys ja toisessa esimerkissä mittarointitilauksen muutostietojen välitys. 7. UBL pientyötilausmuutossanomaesimerkki <?xml version=".0" encoding="utf-8"?> <OrderChange 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:orderchange-2" xmlns:clm664="urn:un:unece:uncefact:codelist:specification:664:200" xmlns:clmianamimemediatype="urn:un:unece:uncefact:codelist:specification:ianamimemediatype:2003" xmlns:clm5427="urn:un:unece:uncefact:codelist:specification:5427:200" xmlns:clm5639="urn:un:unece:uncefact:codelist:specification:5639:988" xmlns:tieke="urn: <cbc:ublversionid>2.0</cbc:ublversionid> <cbc:customizationid>et</cbc:customizationid> <cbc:profileid schemeid="292">fi035</cbc:profileid> <cbc:id>234-c</cbc:id> <cbc:issuedate> </cbc:issuedate> 20/32

121 <cbc:issuetime>0:3:02</cbc:issuetime> <cbc:note languageid="fi">sähkökaapin oven asennus</cbc:note> <cac:orderreference> <cbc:id>234-ab</cbc:id> </cac:orderreference> <cac:quotationdocumentreference> <cbc:id>267b/09</cbc:id> </cac:quotationdocumentreference> <cac:additionaldocumentreference> <cbc:id>22</cbc:id> <cbc:documenttypecode listid="un/ece 00" listagencyid="6">226</cbc:documenttypecode> </cac:additionaldocumentreference> <cac:buyercustomerparty> <cac:party> <cac:partyidentification> <cbc:id schemeid="iso 6523" schemeagencyid="5"> </cbc:id> </cac:partyidentification> <cac:partyname> <cbc:name>oy Sähkö Ab</cbc:Name> </cac:partyname> <cac:contact> <cbc:name>timo Tilaaja</cbc:Name> <cbc:telephone> </cbc:Telephone> </cac:contact> </cac:party> </cac:buyercustomerparty> <cac:sellersupplierparty> 2/32

122 <cac:party> <cac:partyidentification> <cbc:id schemeid="iso 6523" schemeagencyid="5"> </cbc:id> </cac:partyidentification> <cac:partyname> <cbc:name>asennus Oy</cbc:Name> </cac:partyname> </cac:party> </cac:sellersupplierparty> <cac:delivery> <cac:deliverylocation> <cbc:id schemeagencyid="92">2a</cbc:id> <cbc:description>varastopaikka 48</cbc:Description> <cac:address> <cbc:id>2</cbc:id> <cbc:room>32</cbc:room> <cbc:streetname>voimantie 99</cbc:StreetName> <cbc:cityname>tampere</cbc:cityname> <cbc:postalzone>33680</cbc:postalzone> <cac:addressline> <cbc:line>huoneisto 2</cbc:Line> </cac:addressline> <cac:locationcoordinate> <cbc:coordinatesystemcode>euref-fin</cbc:coordinatesystemcode> <cbc:latitudedegreesmeasure unitcode="dd">62</cbc:latitudedegreesmeasure> <cbc:latitudeminutesmeasure unitcode="min">34.033</cbc:latitudeminutesmeasure> <cbc:latitudedirectioncode listid="latitude Direction" listagencyid="ubl">north</cbc:latitudedirectioncode> <cbc:longitudedegreesmeasure unitcode="dd">23</cbc:longitudedegreesmeasure> <cbc:longitudeminutesmeasure unitcode="min">3.69</cbc:longitudeminutesmeasure> 22/32

123 <cbc:longitudedirectioncode listid="longitude Direction" listagencyid="ubl">east </cbc:longitudedirectioncode> </cac:locationcoordinate> </cac:address> </cac:deliverylocation> <cac:requesteddeliveryperiod> <cbc:startdate> </cbc:startdate> <cbc:enddate> </cbc:enddate> </cac:requesteddeliveryperiod> <cac:promiseddeliveryperiod> <cbc:startdate> </cbc:startdate> <cbc:enddate> </cbc:enddate> </cac:promiseddeliveryperiod> <cac:estimateddeliveryperiod> <cbc:startdate> </cbc:startdate> <cbc:enddate> </cbc:enddate> </cac:estimateddeliveryperiod> <cac:deliveryparty> <cac:partyidentification> <cbc:id schemeid="iso 6523" schemeagencyid="5"> </cbc:id> </cac:partyidentification> <cac:partyname> <cbc:name>piilopaikka Oy</cbc:Name> </cac:partyname> <cac:postaladdress> <cbc:streetname>voimatie 99</cbc:StreetName> <cbc:cityname>tampere</cbc:cityname> <cbc:postalzone>33680</cbc:postalzone> <cac:country> 23/32

124 <cbc:identificationcode listid="iso366-" listagencyid="6">fi</cbc:identificationcode> </cac:country> <cac:locationcoordinate> <cbc:coordinatesystemcode>euref-fin</cbc:coordinatesystemcode> <cbc:latitudedegreesmeasure unitcode="dd">62</cbc:latitudedegreesmeasure> <cbc:latitudeminutesmeasure unitcode="min">34.033</cbc:latitudeminutesmeasure> <cbc:latitudedirectioncode listid="latitude Direction" listagencyid="ubl">north</cbc:latitudedirectioncode> <cbc:longitudedegreesmeasure unitcode="dd">23</cbc:longitudedegreesmeasure> <cbc:longitudeminutesmeasure unitcode="min">3.69</cbc:longitudeminutesmeasure> <cbc:longitudedirectioncode listid="longitude Direction" listagencyid="ubl">east </cbc:longitudedirectioncode> </cac:locationcoordinate> </cac:postaladdress> </cac:deliveryparty> </cac:delivery> <cac:orderline> <cbc:note languageid="fi">asennettavan laitteen takuutodistukset on toimitettava tilaajalle sovitusti.</cbc:note> <cac:lineitem> <cbc:id>003</cbc:id> <cac:delivery> <cac:deliverylocation> <cbc:id schemeagencyid="92">2a</cbc:id> <cbc:description>varastopaikka 50</cbc:Description> <cac:address> <cbc:id>34</cbc:id> <cbc:room>234</cbc:room> <cbc:streetname>voimantie 99</cbc:StreetName> <cbc:cityname>tampere</cbc:cityname> <cbc:postalzone>33680</cbc:postalzone> 24/32

125 <cac:addressline> <cbc:line>huoneisto 34</cbc:Line> </cac:addressline> <cac:locationcoordinate> <cbc:coordinatesystemcode>euref-fin</cbc:coordinatesystemcode> <cbc:latitudedegreesmeasure unitcode="dd">62</cbc:latitudedegreesmeasure> <cbc:latitudeminutesmeasure unitcode="min">34.052</cbc:latitudeminutesmeasure> <cbc:latitudedirectioncode listid="latitude Direction" listagencyid="ubl">north </cbc:latitudedirectioncode> <cbc:longitudedegreesmeasure unitcode="dd">23</cbc:longitudedegreesmeasure> <cbc:longitudeminutesmeasure unitcode="min">3.705</cbc:longitudeminutesmeasure> <cbc:longitudedirectioncode listid="longitude Direction" listagencyid="ubl">east </cbc:longitudedirectioncode> </cac:locationcoordinate> </cac:address> </cac:deliverylocation> <cac:requesteddeliveryperiod> <cbc:startdate> </cbc:startdate> <cbc:enddate> </cbc:enddate> </cac:requesteddeliveryperiod> <cac:estimateddeliveryperiod> <cbc:startdate> </cbc:startdate> <cbc:enddate> </cbc:enddate> </cac:estimateddeliveryperiod> </cac:delivery> <cac:item> <cbc:description languageid="fi">ps X60X600 HARMAA OVI</cbc:Description> <cbc:name>ps X60X600 HAR OVI</cbc:Name> <cbc:additionalinformation languageid="fi">asennuksesta sovittava huoneiston omistajan kanssa 25/32

126 </cbc:additionalinformation> <cac:buyersitemidentification> <cbc:id>zt203</cbc:id> </cac:buyersitemidentification> <cac:standarditemidentification> <cbc:id>723238</cbc:id> </cac:standarditemidentification> </cac:item> </cac:lineitem> <cac:documentreference> <cbc:id> </cbc:id> <cbc:documenttypecode listid="un/ece 53" listagencyid="6">jb</cbc:documenttypecode> </cac:documentreference> </cac:orderline> </OrderChange> 7.2 UBL mittarointitilausmuutossanomaesimerkki <?xml version=".0" encoding="utf-8"?> <OrderChange 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" 26/32

127 xmlns="urn:oasis:names:specification:ubl:schema:xsd:orderchange-2" xmlns:clm664="urn:un:unece:uncefact:codelist:specification:664:200" xmlns:clmianamimemediatype="urn:un:unece:uncefact:codelist:specification:ianamimemediatype:2003" xmlns:clm5427="urn:un:unece:uncefact:codelist:specification:5427:200" xmlns:clm5639="urn:un:unece:uncefact:codelist:specification:5639:988" xmlns:tieke="urn: <cbc:ublversionid>2.0</cbc:ublversionid> <cbc:customizationid>et</cbc:customizationid> <cbc:profileid schemeid="292">fi035</cbc:profileid> <cbc:id>234-c</cbc:id> <cbc:issuedate> </cbc:issuedate> <cbc:issuetime>0:3:02</cbc:issuetime> <cbc:note languageid="fi">mittarointityö</cbc:note> <cac:orderreference> <cbc:id>234-ab</cbc:id> </cac:orderreference> <cac:quotationdocumentreference> <cbc:id>267b/09</cbc:id> </cac:quotationdocumentreference> <cac:additionaldocumentreference> <cbc:id>22</cbc:id> <cbc:documenttypecode listid="un/ece 00" listagencyid="6">226</cbc:documenttypecode> </cac:additionaldocumentreference> <cac:buyercustomerparty> <cac:party> <cac:partyidentification> <cbc:id schemeid="iso 6523" schemeagencyid="5"> </cbc:id> </cac:partyidentification> <cac:partyname> 27/32

128 <cbc:name>oy Sähkö Ab</cbc:Name> </cac:partyname> <cac:contact> <cbc:name>timo Tilaaja</cbc:Name> <cbc:telephone> </cbc:Telephone> </cac:contact> </cac:party> </cac:buyercustomerparty> <cac:sellersupplierparty> <cac:party> <cac:partyidentification> <cbc:id schemeid="iso 6523" schemeagencyid="5"> </cbc:id> </cac:partyidentification> <cac:partyname> <cbc:name>asennus Oy</cbc:Name> </cac:partyname> </cac:party> </cac:sellersupplierparty> <cac:delivery> <cac:deliveryparty> <cac:partyidentification> <cbc:id schemeid="iso 6523" schemeagencyid="5"> </cbc:id> </cac:partyidentification> <cac:partyname> <cbc:name>piilopaikka Oy</cbc:Name> </cac:partyname> <cac:postaladdress> 28/32

129 <cbc:streetname>voimatie 99</cbc:StreetName> <cbc:cityname>tampere</cbc:cityname> <cbc:postalzone>33680</cbc:postalzone> <cac:country> <cbc:identificationcode listid="iso366-" listagencyid="6">fi</cbc:identificationcode> </cac:country> <cac:locationcoordinate> <cbc:coordinatesystemcode>euref-fin</cbc:coordinatesystemcode> <cbc:latitudedegreesmeasure unitcode="dd">62</cbc:latitudedegreesmeasure> <cbc:latitudeminutesmeasure unitcode="min">34.033</cbc:latitudeminutesmeasure> <cbc:latitudedirectioncode listid="latitude Direction" listagencyid="ubl">north</cbc:latitudedirectioncode> <cbc:longitudedegreesmeasure unitcode="dd">23</cbc:longitudedegreesmeasure> <cbc:longitudeminutesmeasure unitcode="min">3.69</cbc:longitudeminutesmeasure> <cbc:longitudedirectioncode listid="longitude Direction" listagencyid="ubl">east </cbc:longitudedirectioncode> </cac:locationcoordinate> </cac:postaladdress> </cac:deliveryparty> </cac:delivery> <cac:orderline> <cbc:note languageid="fi">vanha mittari</cbc:note> <cac:lineitem> <cbc:id>00</cbc:id> <cac:delivery> <cac:requesteddeliveryperiod> <cbc:startdate> </cbc:startdate> <cbc:enddate> </cbc:enddate> </cac:requesteddeliveryperiod> </cac:delivery> 29/32

130 <cac:item> <cac:buyersitemidentification> <cbc:id>72578</cbc:id> <cac:physicalattribute> <cbc:attributeid schemeid="un/ece 708" schemeagencyid="6">8</cbc:attributeid> <cbc:descriptioncode listagencyid="92">valmet K2N</cbc:DescriptionCode> <cbc:description languageid="fi">valmet Kolmivaihe, kilowattituntimittari malli K2N</cbc:Description> </cac:physicalattribute> </cac:buyersitemidentification> <cac:iteminstance> <cbc:serialid>592</cbc:serialid> </cac:iteminstance> </cac:item> </cac:lineitem> </cac:orderline> <cac:orderline> <cbc:note languageid="fi">uusi mittari</cbc:note> <cac:lineitem> <cbc:id>002</cbc:id> <cac:delivery> <cac:requesteddeliveryperiod> <cbc:startdate> </cbc:startdate> <cbc:enddate> </cbc:enddate> </cac:requesteddeliveryperiod> </cac:delivery> <cac:item> <cac:manufacturersitemidentification> <cbc:id>xxxxxx</cbc:id> <cac:physicalattribute> 30/32

131 <cbc:attributeid schemeid="un/ece 708" schemeagencyid="6">8</cbc:attributeid> <cbc:descriptioncode listagencyid="92">eo7ol</cbc:descriptioncode> <cbc:description languageid="fi">enermet</cbc:description> </cac:physicalattribute> </cac:manufacturersitemidentification> </cac:item> </cac:lineitem> <cac:documentreference> <cbc:id>72578</cbc:id> <cbc:documenttypecode listid="un/ece 53" listagencyid="6">amk</cbc:documenttypecode> </cac:documentreference> </cac:orderline> </OrderChange> 3/32

132 8 Liite : Kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje Aggregaatin rakenne: Aggregaatissa vihreällä aggregaatin elementit Vieressä punaisella ala-aggregaatit Aggregaatin toistojen määrä sanomassa: Vaihtoehdot: valinnainen, esiintyy max. kertaa.. pakollinen, esiintyy kerran 0.. unbounded valinnainen, esiintyy useita kertoja.. unbounded pakollinen, esiintyy useita kertoja Aggregaatin tyyppi, aggregaatilla aina Details Selvitys aggregaatin käytöstä Esimerkki aggregaatin käytöstä sanomassa Aggregaatin nimi (nimi lihavoituna) Elementin toistojen määrä, vaihtoehdot samat kuin aggregaatilla Elementin tyyppi, useita vaihtoehtoja Selvitys elementin käytöstä Aggregaatissa esiintyvän elementin nimi Edellä olevan elementin attribuutti (tiedot harmaalla pohjalla) Aggregaatin ala-aggregaatin nimi ja linkki (lihavoituna) (Toisto-, -, ja Esimerkki-ruutujen selitys sama kuin pääaggregaatilla) Elementin käyttöön liittyvä huomautus Elementin attribuutit, jotka käytössä tässä soveltamisohjeessa Esimerkki elementti käytöstä sanomassa Attribuutin toistojen määrä, Vaihtoehdot: valinnainen, esiintyy max. kertaa.. pakollinen, esiintyy kerran Selvitys attribuutin käytöstä Esimerkki attribuutin käytöstä sanomassa 32/32