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... 3

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/3

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/3

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/3

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/3

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/3

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/3

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 /3

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/3

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/3

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/3

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/3

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 Order Change. Order Reference X X 6..2 P Tarjouksen tunnus Ylätason tilaus ID (parent) Ylätason tilauksen tyyppi Ylätason tilauksen tyypin nimi Liitetiedosto 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/3

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/3

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/3 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 X X V Työkohteen tunnus Order Change. Order Line. Line Item. Delivery. X X V 9/3

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/3

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/3

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/3

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/3

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/3

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/3

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/3

27 6.. Tilausmuutossanoma (Order Change. Details)..* Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki 27/3

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/3

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/3

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/3

31 6..2 Muutettavan tilauksen eli hankkeen tunnus (Order Change. Order 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/3

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

33 6..3 Tarjous (Order Change. Quotation_ Document Reference. Document Reference) 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/3

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

35 6..4 Muut viitteet (Order Change. Additional_ Document Reference. Document Reference) 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/3

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/3

37 6..5 Liitetiedosto (Document Reference. Attachment) 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/3

38 6..6 Liitetiedoston web-osoite (Attachment. External Reference) 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/3

39 6..7 Tilaajan tiedot (Order Change. Buyer_ Customer Party. Customer Party) 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/3

40 6..8 Tilaaja (Customer 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/3

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/3

42 6..9 Tilaajan tunniste (Party. Party Identification) Elementti / aggregaatti Party. Party Identification Party Identification. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded 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/3

43 6..0 Tilaajan nimi (Party. Party 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/3

44 6.. Tilaajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) 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/3

45 6..2 Toimittajan tiedot (Order Change. Seller_ Supplier Party. Supplier Party) 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/3