Resurssivaraus. Sanomasuositus ja sen yleinen soveltamisohje. FI1039, , v 1.00

Transkriptio

1 Sanomasuositus ja sen yleinen soveltamisohje Resurssivaraus FI039, , v.00 Käyttö: Energiateollisuus Sanasto: UBL Versio: 2.0 Sanoma: Catalogue

2 Sisällysluettelo Sanoma ja sen soveltamisala Soveltamisohjeen sisältö Työryhmän työskentelyyn osallistuneet Dokumentti ja sen yhteydet muihin dokumentteihin Päivitykset Esitietovaatimukset Aiheeseen liittyvää aineistoa Huomioitavaa Resurssi-ilmoitusprosessi Prosessin rajaus Prosessin osapuolet Prosessin vaiheet Sanoman tietosisältö Resurssi-ilmoitussanoman rakenne Luokkamalli Tietojen suhde toisiinsa Sanoman määrittely Sanoman otsikkotaso Resurssivaraussanoma (Catalogue. Details) Resurssivarauksen hyväksyntä annettava viimeistään (Catalogue. Validity_ Period. Period) Hankkeen tiedot (Catalogue. Referenced_ Contract. Contract) Toimittaja (Catalogue. Provider_ Party. Party) Toimittajan tunniste (Party. Party Identification) Toimittajan nimi (Party. Party Name) Toimittajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Tilaaja (Catalogue. Receiver_ Party. Party) Tilaajan tunniste (Party. Party Identification) Tilaajan nimi (Party. Party Name) Tilaajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Sanoman rivitaso Ilmoitusrivin tiedot (Catalogue. Catalogue Line) Resurssin varausaika (Catalogue Line. Line Validity_ Period. Period) Resurssin varaustiedot (Catalogue Line. Required_ Item Location Quantity. Item Location Quantity) Työkohteen osoitetiedot (Item Location Quantity. Applicable Territory_ Address. Address)... 44

3 6.2.5 Työkohteen osoite (Address. Address Line) Resurssin varaustunnus (Catalogue Line. Document Reference) Resurssin kuvaus (Catalogue Line. Item) Tilaajan tuotekoodi eli nimike (Item. Buyers_ Item Identification. Item Identification) Sähköalan tuotekoodi eli nimike (Item. Standard_ Item Identification. Item Identification) Sanomaesimerkki UBL Resurssivaraussanoman esimerkki Liite : Kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje... 57

4 Sanoma ja sen soveltamisala Tämä dokumentti sisältää UBL 2.0 -versioon perustuvan Catalogue 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 välitettäessä resurssivarauksia aiemmin saapuneeseen resurssitarveilmoitukseen. Soveltamisohjeen määrittelemää resurssisanomaa voidaan käyttää normaalissa tai sopimuspohjaisessa toiminnossa ja sillä voidaan tehdä vain varausilmoitus. 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. Soveltamisohje 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.. 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 Resurssi-ilmoitusprosessi esitetään tämän dokumentin tietosisällön ja soveltamisohjeen pohjana oleva resurssivarausilmoitusprosessi, sen osapuolet ja vaiheet. Kappaleessa 4 Sanoman tietosisältö on esitetty resurssivaraussanomassa välitettävien tietojen luettelo. Kappaleessa 5 "Resurssivaraussanoman rakenne on esitetty tämän UBL-Cataloguesanoman 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 rakenne, käytettävät aggregaatit, elementit, attribuutit ja koodit sekä niiden käyttötarkoitus. Kappaleessa 7 Sanomaesimerkki on esitetty esimerkki UBL-Catalogue-resurssivaraussanoman käytöstä. 4/58

5 Liitteessä on esitetty kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje..2 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 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 Henkilö Erkki Leinonen Valter Maasalo Anna Tanskanen Otto Tarkiainen Tommi Dahlroos Antti Herranen Juho Kuivalainen 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 5/58

6 Suomen Energia Urakointi Oy Tekla Oy Tieto Oy Vattenfall Verkko Oy Visma Software Oy Voimatel Oy 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 6/58

7 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 Catalogue-sanoman määrityksiin. Määrityksissä on huomioitu myös kansainvälisen NES (Northern European Subset) työryhmän suositukset. 7/58

8 3 Resurssi-ilmoitusprosessi 3. Prosessin rajaus Tässä prosessikuvauksessa on tarkasteltu ainoastaan resurssivarausilmoituksen toimitusprosessia, jossa tämän dokumentin määrittelemää Catalogue-sanomaa voidaan käyttää. Tarkastelussa oletetaan, että ilmoitukset välitetään niiden toimitusprosessissa sähköisesti osapuolten välillä. Tarkastelun ulkopuolelle on jätetty resurssitarveilmoituksen lähettäminen sekä resurssivarausilmoitusten toimittamisen jälkeiset vaiheet kuten tarjouspyynnön teko ja lähetys, tarjousprosessi, tilaaminen, tilauksen vahvistus, toimitus ja laskutus. Tämän prosessin ulkopuolelle jätettyjen vaiheiden kuvaus sisältyy kyseisiin vaiheisiin liittyvien sanomien soveltamisohjeisiin, jotka ovat syntyneet projektissa Sähkönjakeluyhtiöiden ja palveluntuottajayhtiöiden tietojärjestelmien yhteensopivuus. 3.2 Prosessin osapuolet Seuraavassa taulukossa on esitetty tämän prosessin osapuolet. Osapuoli Tilaaja Toimittaja Rooli Osapuoli, joka vastaanottaa resurssivarausilmoituksen. Osapuoli, joka käsittelee resurssivarausilmoituksen. Osapuoli, joka tekee ja toimittaa muutetun tai tarkennetun resurssitarveilmoituksen. Osapuoli, joka tekee resurssivaraukset saamansa resurssitarveilmoituksen perusteella. Osapuoli, joka tekee resurssivarausilmoituksen. Osapuoli, joka lähettää resurssivarausilmoituksen. Taulukko 3.2.: Resurssivarausilmoituksen toimitusprosessin osapuolet 3.3 Prosessin vaiheet Kuviossa 3.3. on esitetty resurssivarausilmoituksen toimitusprosessin vaiheet eroteltuna kohdassa 3.2 esitettyjen osapuolien toimintojen mukaan. 8/58

9 Toimittaja Tilaaja Luodaan resurssivaraussanoma Resurssivaraussanoma Resurssitarvesanoma Lähetetään resurssivaraussanoma Lähetetään muutettu tai tarkennettu resurssitarveilmoitus Vastaanotetaan resurssivaraussanoma Varataan resurssit alustavasti Vastaanotetaan automaattinen vastaanoton kuittaussanoma Käsitellään automaattinen vastaanoton kuittaussanoma Automaattinen vastaanoton kuittaussanoma Luodaan automaattinen vastaanoton kuittaussanoma Lähetetään automaattinen vastaanoton kuittaussanoma Käsitellään resurssivaraussanoma Varaustiedot riittäviä Tarvitaan muutoksia ja tarkennuksia Luodaan muutettu tai tarkennettu resurssitarveilmoitus Hylätään resurssivaraus Hyväksytään resurssivaraus Vastaanotetaan varauksen hyväksymisilmoitus Varauksen hyväksymisilmoitus Hylkäyskäsittely Luodaan varauksen hyväksymisilmoitus Lähetetään varauksen hyväksymisilmoitus Varataan resurssit Suoritetaan resurssivarauksen vaatimat tehtävät Kuvio 3.3.: Resurssitarveilmoituksen ja resurssivarausilmoituksen toimitusprosessi 9/58

10 Seuraavassa taulukossa on selitetty kuviossa 3.3. esitetyn resurssivarausilmoituksen toimitusprosessin vaiheet jaoteltuna osapuolten hoitamien toimintojen mukaan. Osapuoli Toiminta Tilaaja Vastaanotetaan resurssivaraussanoma Luodaan automaattinen vastaanoton kuittaussanoma Lähetetään automaattinen vastaanoton kuittaussanoma Käsitellään resurssivaraussanoma Luodaan muutettu tai tarkennettu resurssitarveilmoitus Hyväksytään tai hylätään resurssivaraussanoma Hylätään resurssivaraus Hyväksytään resurssivaraus Luodaan resurssivarauksen hyväksymisilmoitus Lähetetään resurssivarauksen Tilaaja ottaa vastaan toimittajan lähettämän resurssivaraussanoman. Tilaaja luo omissa tietojärjestelmissään automaattisen vastaanottokuittauksen. Tilaaja lähettää automaattisen vastaanottokuittauksen toimittajalle. Tilaaja käsittelee resurssivarauksen omissa tietojärjestelmissään. Käsittelyn perusteella varaustiedot havaitaan: riittäviksi tarvitsevan muutoksia tai tarkennuksia Tilaaja tekee resurssitarveilmoitukseen muutoksia ja tarkennuksia (siirrytään kohtaan Lähetetään muutettu tai tarkennettu resurssitarveilmoitus ). Tilaaja käsittelee resurssivarauksen, jonka tiedot ovat riittävät, omissa tietojärjestelmissään. Käsittelyn perusteella resurssivaraus: hyväksytään hylätään Tilaaja hylkää toimittajan lähettämän resurssivarauksen ja ilmoittaa hylkäämisestä sovitulla tavalla toimittajalle. Hylkäysprosessi ei kuulu tarkasteltavaan prosessiin. Tilaaja hyväksyy resurssivarauksen. Tilaaja luo omissa tietojärjestelmissään resurssivarauksen hyväksymisilmoituksen. Tilaaja lähettää resurssivarauksen hyväksymisilmoituksen sähköisesti toimittajalle. 0/58

11 hyväksymisilmoitus Toimittaja Suoritetaan resurssiilmoituksen vaatimimat tehtävät Lähetetään muutettu tai tarkennettu resurssitarveilmoitus Luodaan resurssivaraussanoma Lähetetään resurssivaraussanoma Varataan resurssit alustavasti Vastaanotetaan automaattinen vastaanoton kuittaussanoma Käsitellään automaattinen vastaanoton kuittaussanoma Vastaanotetaan varauksen hyväksymisilmoitus Varataan resurssit Tilaaja ryhtyy resurssivarauksen vaatimiin tehtäviin. Tilaaja lähettää muutetun tai tarkennetun resurssitarvesanoman sähköisesti toimittajalle. Toimittaja luo omissa tietojärjestelmissään resurssivaraussanoman. Toimittaja lähettää tilaajalle sähköisesti resurssivaraussanoman. Toimittaja varaa resurssit alustavasti, niin että ne ovat tilaajalle toimitettavaissa tilaajan hyväksyttyä resurssivarauksen. Toimittaja ottaa vastaan sanoman automaattisen vastaanoton kuittauksen, jolla tilaaja ilmoittaa vastaanottaneensa resurssivaraussanoman. Toimittaja käsittelee sanoman vastaanoton kuittauksen omissa tietojärjestelmissään. Toimittaja ottaa vastaan resurssivarauksen hyväksymisilmoituksen. Toimittaja varaa resurssit resurssivarausilmoituksen mukaisesti. Taulukko 3.3.: Resurssivarausilmoituksen toimitusprosessin osapuolikohtaiset vaiheet HUOMAUTUS: Resurssivarauksen hyväksymisilmoitus lähetetään yleisellä vastaanottokuittaussanomalla. Tilaaja voi peruuttaa resurssivarauksen samalla ilmoituksella kuin millä hyväksyminen tehdään. /58

12 4 Sanoman tietosisältö Seuraavassa taulukossa on esitetty resurssivaraussanoman tietosisältö sekä sanoman aggregaatti, jossa kyseinen tieto sijaitsee sanomassa. Kolmannessa sarakkeessa on esitetty linkkinä viittaus kappaleessa 6 Sanoman määrittely olevaan kyseistä aggregaattia esittelevään alakappaleeseen. Neljännessä sarakkeessa on esitetty tiedon pakollisuus energiateollisuuden sähköntuottajien ja heidän palvelutuottajien resurssivaraussanomien 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. 2/58

13 TIETO Aggregaatti Kappale P/V Varaussanoman tietosisältö 6.. Sanoman versio Catalogue 6.. P Soveltamisohjeen kehittäjä Catalogue 6.. P Soveltamisohjeen tunnus Catalogue 6.. P Varaussanoman tunnus Catalogue 6.. P Varaussanoman päivämäärä Catalogue 6.. P Varaussanoman kellonaika Catalogue 6.. Varaussanoman vapaanmuotoinen Catalogue 6.. V teksti Hanketunnus Catalogue. Referenced_ Contract. Contract 6..3 P Resurssitarvesanoman tunnus Catalogue. Referenced_ Contract. Contract 6..3 P Resurssivarauksen hyväksyminen Catalogue. Validity_ Period. Period 6..2 P annettava viimeistään Toimittajan tiedot Catalogue. Provider_ Party. Party 6..4 P Toimittajayrityksen tunniste (OVT) Catalogue. Provider_ Party. Party. Party Identification 6..5 P Toimittajayrityksen nimi Catalogue. Provider_ Party. Party. Party Name 6..6 P Toimittajayrityksen yhteyshenkilön Catalogue. Provider_ Party. Party. Contact 6..7 p 3/58

14 tiedot Yhteyshenkilö Catalogue. Provider_ Party. Party. Contact 6..7 P Yhteysosasto Catalogue. Provider_ Party. Party. Contact 6..7 V Puhelinnumero Catalogue. Provider_ Party. Party. Contact 6..7 V Sähköpostiosoite Catalogue. Provider_ Party. Party. Contact 6..7 V Tilaajan tiedot Catalogue. Receiver_ Party. Party 6..8 P Tilaajayrityksen tunniste (OVT) Catalogue. Receiver_ Party. Party. Party Identification 6..9 p Tilaajayrityksen nimi Catalogue. Receiver_ Party. Party. Party Name 6..0 p Tilaajayrityksen yhteyshenkilön tiedot Catalogue. Receiver_ Party. Party. Contact 6.. V Yhteyshenkilö Catalogue. Receiver_ Party. Party. Contact 6.. V Yhteysosasto Catalogue. Receiver_ Party. Party. Contact 6.. V Puhelinnumero Catalogue. Receiver_ Party. Party. Contact 6.. V Sähköpostiosoite Catalogue. Receiver_ Party. Party. Contact 6.. V Rivitaso Catalogue. Catalogue Line 6.2 P Resurssivarauksen rivin tunnus Catalogue. Catalogue Line 6.2. P Resurssin kuvaus (henkilö, laite, materiaali, muu tarve) Catalogue. Catalogue Line. Item P Nimi (henkilön tai laitteen nimi) Catalogue. Catalogue Line. Item V Tilaajan tuotekoodi eli nimike (Tilaajan tuotenimike) Catalogue. Catalogue Line. Item. Buyers_ Item Identification. Item Identification V 4/58

15 Tuotekoodi eli nimike (Sähköalan nimike) Catalogue Request. Catalogue Request Line. Item. Standard_ Item Identification. Item Identification V Vapaamuotoinen kuvaus Catalogue. Catalogue Line. Item V Varausaikaperiodi Catalogue. Catalogue Line. Line Validity_ Period. Period P Määrä Määrän yksikkö Catalogue. Catalogue Line. Required_ Item Location Quantity. Item Location Quantity Catalogue. Catalogue Line. Required_ Item Location Quantity. Item Location Quantity P P Työkohteen osoite Catalogue. Catalogue Line. Required_ Item Location Quantity. Item Location Quantity. Applicable Territory_ Address. Address. Address Line P Resurssin varaustunnus Catalogue. Catalogue Line. Document Reference P 5/58

16 5 Resurssi-ilmoitussanoman rakenne 5. Luokkamalli Tässä kappaleessa esitetään UBL 2.0 Catalogue-sanoman rakenne käyttäen hyväksi UMLluokkamallia. 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 resurssivaraussanoman otsikkotason luokkamalli ja kuviossa 5..2 resurssivaraussanoman rivitason luokkamalli. PartyIdentification -ID Contract -ID -ContractTypeCode -ContractType +Referenced Catalogue -UBLVersionID -CustomizationID -ProfileID -ID -IssueDate -IssueTime -Note +Provider +Receiver Party PartyName -Name CatalogueRequestLine -ID..* +Validity Period -EndDate -EndTime Contact -ID -Name -Telephone -ElectronicMail Kuvio 5..: Resurssivaraussanoman otsikkotason luokkamalli 6/58

17 DocumentReference -ID -DocumentTypeCode -DocumentType CatalogueLine -ID +LineValidity Period -StartDate -StartTime -EndDate -EndTime +Required Item -Description -Name -AdditionalInformation ItemLocationQuantity -MaximumQuantity +ApplicableTerritory Address +Buyers ItemIdentification -ID +Standard AddressLine -Line Kuvio 5..2: Resurssivaraussanoman rivitason luokkamalli 5.2 Tietojen suhde toisiinsa Tässä luvussa esitetään resurssivaraussanoman 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 resurssivaraussanoman otsikkotason tietojen suhteet ja kuviossa resurssivaraussanoman rivitason tietojen suhteet. 7/58

18 Tunnustiedot -Tunnus Resurssivaraus Viitetiedot -Tunnus -Viitteen tyyppikoodi -Viitteen tyyppi -UBL Version numero -Sovellusohjeen kehittäjä -Sovellusohjeen tunnus -Resurssivarauksen tunnus -Resurssivarauksen päivämäärä -Resurssivarauksen kellonaika -Yleistä tietoa +Toimittaja Osapuolitiedot Nimitiedot -Nimi +Tilaaja..* Resurssitarverivi -Rivin tunnus +Resurssivarauksen hyväksyntä annettava Yhteystiedot -Tunnus -Nimi -Puhelin -Sähköposti Ajanjaksotiedot -Loppupäivä -Loppukellonaika Kuvio 5.2.: Resurssivaraussanoman otsikkotason tietojen suhteet Varaustunnus -Tunnus -Varaustunnuksen tyyppikoodi -Varaustunnuksen tyyppi Resurssitarverivi -Rivin tunnus +Varausaika Ajanjaksotiedot -Alkupäivä -Alkukellonaika -Loppupäivä -Loppukellonaika Tuotetiedot -Resurssin kuvaus -Tuotenimi -Lisätieto Resurssin käyttö -Varattu määrä Osoitetiedot Osoite +Tilaajan Nimiketiedot -Tunnus +Sähköalan -Työkohteen osoite Kuvio 5.2.2: Resurssivaraussanoman rivitason tietojen suhteet 8/58

19 6 Sanoman määrittely Tässä kappaleessa on esitelty UBL- Catalogue -Resurssivaraussanoman 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 taulukoiden 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, voimassaoloaika sekä osapuolitiedot. 6.. Resurssivaraussanoma (Catalogue. Details)..* Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Catalogue. Details Toisto 0.. Tällä aggregaatilla annetaan resurssitarve- ja resurssivaraus- 9/58

20 Catalogue. UBL Version Identifier. Identifier Catalogue. Customization Identifier. Identifier Catalogue. Profile Identifier. Identifier Identification Scheme Agency. Identifier sanoman tiedot. Esimerkki <Catalogue> </Catalogue> Toisto 0.. 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> Toisto 0.. Identifier. Type Elementillä annetaan sanoman soveltamiohjeen kehittäjän nimi. Esimerkki <cbc:customizationid>et</cbc:customizationid> Toisto 0.. Identifier. Type TIEKE ry:n soveltamisohjeelle antama tunnus, joka on vakiosti FI036 Attribuutit schemeagencyid Esimerkki <cbc:profileid schemeagencyid="292">fi036</cbc:profileid> Toisto 0.. Attribuutilla annetaan soveltamisohjeluettelon ylläpitäjän tunnus. Esimerkki schemeagencyid="292" Käytettävät koodit Catalogue. Identifier Toisto.. Catalogue. Issue Date. Date 292 (FI, TIEKE The Information Technology Development Centre of Finland) TIEKE Tietoyhteiskunnan kehittämiskeskus ry Identifier. Type Resurssivaraussanoman yksilöivät tunnus, jolla se tunnistetaan myöhemmin. On suositeltavaa, että resurssivarausilmoitukselle annetaan sama tunnus, kuin sen synnyttävällä resurssitarveilmoituksella on. Esimerkki <cbc:id>200/0</cbc:id> Toisto.. Date. Type Elementillä annetaan ilmoituksen päivämäärä. On suositeltavaa, että päivämäärä on sama, jonka ilmoituksen sisällöstä vastaava henkilö voi nähdä järjestelmästään ilmoituksen tekopäivä- määränä, eikä ilmoitussanoman 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> 20/58

21 Catalogue. Issue Time. Time Toisto 0.. Time. Type Elementillä annetaan ilmoituksen luontikelloaika, siis luontihetken tunnit, minuutit ja sekunnit. On suositeltavaa, että ajanhetki on sama, jonka ilmoituksen sisällöstä vastaava henkilö voi nähdä järjestelmästään ilmoituksen tekoajanhetkenä, eikä ilmoitussanoman 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>:2:25</cbc:issuetime> Catalogue. Note. Text Toisto 0.. unbounded Text. Type Elementillä annetaan ilmoitukseen liittyvää yleistä tietoa, jota ei voida antaa Catalogue-sanoman muiden elementtien arvona. Huomautus Vain yksi elementin toisto kieltä kohden. Attribuutit languageid Language. Identifier Toisto 0.. Catalogue. Validity_ Period. Period 6..2 Catalogue. Referenced_ Contract. Contract 6..3 Esimerkki <cbc:note languageid="fi">hyväksymisilmoitus pyydetään toimittamaan mahdollisimman pian.</cbc:note> Ilmoituksen vapaamuotoisen tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Toisto Type 0.. unbounded Period. Details Aggregaatilla annetaan tieto siitä, milloin tilaajan on ilmoitettava resurssivarauksen hyväksymisestä tai hylkäämisestä. Esimerkki <cac:validityperiod> </cac:validityperiod> Toisto Type 0.. unbounded Contract. Details Tällä aggregaatilla annetaan ilmoituksen perustana oleva hanketunnus ja resurssitarvesanoman tunnus. 2/58

22 Catalogue. Provider_ Party. Party 6..4 Catalogue. Receiver_ Party. Party 6..8 Catalogue. Catalogue Line 6.2. Esimerkki <cac:referencedcontract> </cac:referencedcontract> Toisto.. Party. Details Aggregaatilla annetaan toimittajan eli ilmoituksen lähettäjäorganisaation nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:party> </cac:party> Toisto.. Party. Details Aggregaatilla annetaan tilaajan ilmoituksen vastaanottajaorganisaation nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:party> </cac:party> Toisto.. unbounded Catalogue Line. Details Aggregaatilla annetaan ilmoitusrivin tiedot. Esimerkki <cac:catalogueline> </cac:catalogueline> 22/58

23 6..2 Resurssivarauksen hyväksyntä annettava viimeistään (Catalogue. Validity_ Period. Period) Elementti / aggregaatti Catalogue. Validity_ Period. Period Toistokerrat, tyyppi, kuvaus, esimerkki Toisto Type Period. End Date. Date Toisto unbounded Period. Details Aggregaatilla annetaan tieto siitä, milloin tilaajan on ilmoitettava resurssivarauksen hyväksymisestä tai hylkäämisestä. Esimerkki <cac:validityperiod> </cac:validityperiod> Date. Type Period. End Time. Time Toisto 0.. Elementillä annetaan päivämäärä, jolloin tilaajan on viimeistään annettava resurssivarauksen hyväksyminen tai hylkääminen. Esimerkki <cbc:enddate> </cbc:enddate> Time. Type Elementillä annetaan päivämäärän kellonaika, jolloin tilaajan on viimeistään annettava resurssivarauksen hyväksyminen tai hylkääminen. Huomautus Jos kellonajan ilmoittamisessa on huomioitava aikavyöhyke, esitetään kellonaika muodossa hh:mm:ss+hh:mm tai hh:mm:ss-hh:mm, missä plus- tai miinus-merkin jälkeen on ilmoitettu ajan poikkeaminen UCT- ajasta (Coordinated Universal Time). Jos kellonaika ilmoitetaan UCT-ajassa, voidaan käyttää merkintää hh.mm:ssz. (UTC korvaa aikaisemmin käytetyn Greenwichin keskiajan (GMT).) Esimerkki <cbc:endtime>6:00:00</cbc:endtime> 23/58

24 6..3 Hankkeen tiedot (Catalogue. Referenced_ Contract. Contract) Elementti / aggregaatti Catalogue. Referenced_ Contract. Contract Toistokerrat, tyyppi, kuvaus, esimerkki Toisto Type Contract. Identifier Toisto 0.. Contract. Contract Type Code. Code 0.. unbounded Contract. Details Tällä aggregaatilla annetaan resurssivarauksen perustana oleva hankkeen tunnus ja resurssitarvesanoman tunnus. Esimerkki <cac:referencedcontract> </cac:referencedcontract> Identifier. Type Elementillä annetaan resurssivarauksen viitteen tunnus. Huomautus Resurssitarveilmoituksen tunnus annetaan tässä aggregaatissa, jos resurssivarauksen tunnus poikkeaan resurssitarveilmoituksen tunnuksesta. Esimerkki <cbc:id>234-ab</cbc:id> Toisto 0.. Code. Type Elementillä annetaan resurssivarauksen viitteen tyyppi koodimuotoisena. Huomautus Elementin arvoja on kahdessa eri koodistossa. OASIS on Koodit 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". UN/ECE koodiston 00 mukaisia koodeja ovat: 220 = (Order) Hanke UN/ECE koodiston 53 mukaisia koodeja ovat: APN = (Purchaser's request reference) Resurssitarveilmoitus Attribuutit listid ja listagencyid Esimerkki Code List. Identifier Toisto 0.. <cbc:contracttypecode listid= UN/ECE00" listagencyid="6">220</cbc:contracttypecode> 24/58

25 Code List. Agency. Identifier Contract. Contract Type. Text Attribuutilla annetaan dokumenttitunnuskoodiston 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" Toisto 0.. Attribuutilla annetaan dokumenttitunnuskoodiston ylläpitäjän tunnus Esimerkki listagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) Toisto 0.. Text. Type Elementillä annetaan resurssivarauksen viitteen tyyppi tekstimuotoisena. Attribuutit languageid Esimerkki <cbc:contracttype languageid="fi">hanke </cbc:contracttype> 25/58

26 6..4 Toimittaja (Catalogue. Provider_ Party. Party) Elementti / aggregaatti Catalogue. Provider_ Party. Party Party. Party Identification 6..5 Party. Party Name 6..6 Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. Party. Details Aggregaatilla annetaan toimittajan eli resurssivarausilmoituksen lähettäjäorganisaation nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:providerparty> </cac:providerparty> Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan toimittajan eli resurssivarausilmoituksen lähettäjäorganisaation 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 26/58

27 Party. Contact 6..7 Aggregaatilla annetaan toimittajan eli resurssivarausilmoituksen lähettäjäorganisaation nimitiedot Esimerkki <cac:partyname> </cac:partyname> Toisto 0.. Contact. Details Aggregaatilla annetaan toimittajan eli resurssivarausilmoituksen lähettäjäorganisaation yhteyshenkilön tai -osaston tiedot Esimerkki <cac:contact> </cac:contact> 27/58

28 6..5 Toimittajan 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 toimittajan eli resurssivarausilmoituksen lähettäjäorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto.. Identifier. Type Elementillä annetaan ilmoituksen toimittajan eli resurssivarausilmoituksen lähettäjäorganisaation tunnus, jolla toimittaja tunnistetaan partnerin 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> Toisto 0.. Attribuutilla annetaan osapuolitunnistekoodiston tunnus. Esimerkki schemeid="iso 6523" Käytettävät koodit ISO 6523 OVT- tunnus (Structure for the identification of organizations) Toisto 0.. 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 28/58

29 6..6 Toimittajan nimi (Party. Party Name) Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Party. Party Name Toisto 0.. unbounded Party Name. Details Aggregaatilla annetaan toimittajan eli resurssivarausilmoituksen lähettäjäorganisaation nimitiedot. Esimerkki <cac:partyname> </cac:partyname> Party Name. Name Toisto.. Name. Type Elementillä annetaan toimittajan eli resurssivarausilmoituksen lähettäjäorganisaation nimi Esimerkki <cbc:name>asennus Oy</cbc:Name> 29/58

30 6..7 Toimittajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Elementti / aggregaatti Party. Contact Toisto 0.. Toistokerrat, tyyppi, kuvaus, esimerkki Contact. Identifier Toisto 0.. Contact. Details Aggregaatilla annetaan toimittajan eli resurssivarausilmoituksen lähettäjäorganisaation yhteyshenkilön tai -osaston tiedot Esimerkki <cac:contact> </cac:contact> Identifier. Type Elementillä annetaan toimittajan eli resurssivarausilmoituksen lähettäjäorganisaation yhteyshenkilön tai -osaston tunnus Huomautus Henkilön tunnuksena suositellaan käytettäväksi henkilön sähköpostiosoitetta. Esimerkki <cbc:id>6</cbc:id> Contact. Name Toisto 0.. Name. Type Contact. Telephone. Text Toisto 0.. Contact. Electronic_ Mail. Text Elementillä annetaan toimittajan eli resurssivarausilmoituksen lähettäjäorganisaation yhteyshenkilön tai -osaston nimi. Esimerkki <cbc:name>tommi Toimittaja</cbc:Name> Text. Type Elementillä annetaan toimittajan eli resurssivarausilmoituksen lähettäjäorganisaation yhteyshenkilön tai -osaston puhelinnumero. Esimerkki <cbc:telephone> <cbc:Telephone> Toisto 0.. Text. Type Elementillä annetaan toimittajan eli resurssivarausilmoituksen lähettäjäorganisaation yhteyshenkilön tai -osaston 30/58

31 sähköpostiosoite. Esimerkki <cbc:electronicmail> 3/58

32 6..8 Tilaaja (Catalogue. Receiver_ Party. Party) Elementti / aggregaatti Catalogue. Receiver_ Party. Party Party. Party Identification 6..9 Party. Party Name 6..0 Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. Party. Details Aggregaatilla annetaan tilaajan eli resurssivarausilmoituksen vastaanottajaorganisaation nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:receiverparty> </cac:receiverparty> Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan tilaajan eli resurssivarausilmoituksen vastaanottajaorganisaation 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 tilaajan eli resurssivarausilmoituksen vastaanottajaorganisaation nimitiedot 32/58

33 Party. Contact 6.. Esimerkki <cac:partyname> </cac:partyname> Toisto 0.. Contact. Details Aggregaatilla annetaan tilaajan eli resurssivarausilmoituksen vastaanottajaorganisaation yhteyshenkilön tai -osaston tiedot Esimerkki <cac:contact> </cac:contact> 33/58

34 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 tilaajan eli resurssivarausilmoituksen vastaanottajaorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto.. Identifier. Type Elementillä annetaan tilaajan eli resurssivarausilmoituksen vastaanottajaorganisaation tunnus, jolla ilmoituksen vastaanottaja tunnistetaan partnerin 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> Toisto 0.. Attribuutilla annetaan osapuolitunnistekoodiston tunnus. Esimerkki schemeid="iso 6523" Käytettävät koodit ISO 6523 OVT- tunnus (Structure for the identification of organizations) Toisto 0.. 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 34/58

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

36 6.. Tilaajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Elementti / aggregaatti Party. Contact Toisto 0.. Toistokerrat, tyyppi, kuvaus, esimerkki Contact. Identifier Toisto 0.. Contact. Details Aggregaatilla annetaan tilaajan eli resurssivarausilmoituksen vastaanottajaorganisaation yhteyshenkilön tai -osaston tiedot. Esimerkki <cac:contact> </cac:contact> Identifier. Type Elementillä annetaan tilaajan eli resurssivarausilmoituksen vastaanottojaorganisaation 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 Toisto 0.. Name. Type Contact. Telephone. Text Toisto 0.. Contact. Electronic_ Mail. Text Elementillä annetaan tilaajan eli resurssivarausilmoituksen vastaanottajaorganisaation yhteyshenkilön tai -osaston nimi. Esimerkki <cbc:name>timo Tilaaja</cbc:Name> Text. Type Elementillä annetaan tilaajan eli resurssivarausilmoituksen vastaanottajaorganisaation yhteyshenkilön tai -osaston puhelinnumero. Esimerkki <cbc:telephone> <cbc:Telephone> Toisto 0.. Text. Type Elementillä annetaan tilaajan eli resurssivarausilmoituksen vastaanottajaorganisaation yhteyshenkilön tai -osaston 36/58

37 sähköpostiosoite. Esimerkki <cbc:electronicmail> 37/58

38 6.2 Sanoman rivitaso Sanoman rivitasolla välitetään resurssia koskevat tiedot, kuten tuotekoodi, tuotteen kuvaus ja määrätiedot Ilmoitusrivin tiedot (Catalogue. Catalogue Line) Elementti / aggregaatti Catalogue. Catalogue Line Toistokerrat, tyyppi, kuvaus, esimerkki Toisto Catalogue Line. Identifier Toisto.... unbounded Catalogue Line. Details Aggregaatilla annetaan resurssivarausilmoitusrivin tiedot. Esimerkki <cac:catalogueline> </cac:catalogueline> Identifier. Type 38/58

39 Catalogue Line. Line Validity_ Period. Period Catalogue Line. Required_ Item Location Quantity. Item Location Quantity Catalogue Line. Document Reference Catalogue Line. Item Elementillä annetaan resurssivarausilmoitusrivin tunnus. Esimerkki <cbc:id>003</cbc:id> Toisto 0.. Period. Details Aggregaatilla annetaan resurssin varausaika. Esimerkki <cac:linevalidityperiod> </cac:linevalidityperiod> Toisto 0.. unbounded Period. Details Aggregaatilla annetaan varattu resurssimäärä ja työkohteen osoite. Esimerkki <cac:requireditemlocationquantity> </cac:requireditemlocationquantity> Toisto 0.. unbounded Document Reference. Details Aggregaatilla annetaan resurssin varaustunnus. Esimerkki <cac:documentreference> </cac:documentreference> Toisto.. Item. Details Aggregaatilla annetaan resurssin kuvaustiedot, kuten tuotekoodi ja tuotteen ominaisuudet. Esimerkki <cac:item> </cac:item> 39/58

40 6.2.2 Resurssin varausaika (Catalogue Line. Line Validity_ Period. Period) Elementti / aggregaatti Catalogue Line. Line Validity_ Period. Period Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. Period. Start Date. Date Toisto 0.. Period. Details Aggregaatilla annetaan resurssin varausaika. Esimerkki <cac:linevalidityperiod> </cac:linevalidityperiod> Date. Type Elementillä annetaan varausajan ensimmäisen päivän päivämäärä. Period. Start Time. Time Toisto 0.. Esimerkki <cbc:startdate> </cbc:startdate> Time. Type Elementillä annetaan varausajan ensimmäisen päivän kellonaika. Period. End Date. Date Toisto 0.. 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:starttime>08:30:00</cbc:starttime> Date. Type Period. Start Date. Date Toisto 0.. Elementillä annetaan varausajan viimeisen päivän päivämäärä. Esimerkki <cbc:enddate> </cbc:enddate> Time. Type 40/58

41 Elementillä annetaan varausajan viimeisen päivän kellonaika. Huomautus Jos kellonajan ilmoittamisessa on huomioitava aikavyöhyke, esitetään kellonaika muodossa hh:mm:ss+hh:mm tai hh:mm:ss-hh:mm, missä plus- tai miinus-merkin jälkeen on ilmoitettu ajan poikkeaminen UCTajasta (Coordinated Universal Time). Jos kellonaika ilmoitetaan UCT-ajassa, voidaan käyttää merkintää hh.mm:ssz. (UTC korvaa aikaisemmin käytetyn Greenwichin keskiajan (GMT)). Esimerkki <cbc:endtime>4:00:00</cbc:endtime> 4/58

42 6.2.3 Resurssin varaustiedot (Catalogue Line. Required_ Item Location Quantity. Item Location Quantity) Elementti / aggregaatti Catalogue Line. Required_ Item Location Quantity. Item Location Quantity Item Location Quantity. Maximum_ Quantity. Quantity Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Period. Details Aggregaatilla annetaan varattu resurssimäärä ja työkohteen osoite. Esimerkki <cac:requireditemlocationquantity> Toisto 0.. Attribuutit </cac:requireditemlocationquantity> Quantity. Type Elementillä annetaan varattu resurssimäärä. unitcode Quantity Unit. Code Toisto.. Esimerkki <cbc:maximumquantity unitcode="c62"> </cbc:maximumquantity> Attribuutilla annetaan mittayksikön tunnus, joka on UN/ECE suosituksen 20 Measurement Unit Code mukainen koodi. Esimerkki unitcode="c62" Käytettävät koodit BE CL C62 DAY D97 HUR KGM LTR MIN MTK MTQ (Bundle) Nippu (Coil) Kela (One, Unit, Piece) Kappale (Day) Päivä (Pallet/unit load) Lava (Hour) Tunti (Kilogram) Kilogramma (Litre) Litra (Minute) Minuutti (Square metre) Neliömetri (Qubic metre) Kuutiometri 42/58

43 Item Location Quantity. Applicable Territory_ Address. Address MTR NMP NPL SET TNE Toisto (Metre) Metri (Packs) Pakkaus, kolli (Parcels) Laatikko (Sets) Sarja, erä (Tonne) Tonni 0.. unbounded Address. Details Aggregaatilla annetaan työkohteen osoitetiedot. Huomautus Tätä aggregaattia käytetään vain, jos käyttöpaikka eroaa resurssitarveilmoituksessa esitetystä paikasta. Esimerkki <cac:applicableterritoryaddress> </cac:applicableterritoryaddress> 43/58

44 6.2.4 Työkohteen osoitetiedot (Item Location Quantity. Applicable Territory_ Address. Address) Elementti / aggregaatti Item Location Quantity. Applicable Territory_ Address. Address Address. Address Line Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Address. Details Aggregaatilla annetaan työkohteen osoitetiedot. Huomautus Tätä aggregaattia käytetään vain, jos käyttöpaikka eroaa resurssitarveilmoituksessa esitetystä paikasta. Esimerkki <cac:applicableterritoryaddress> </cac:applicableterritoryaddress> Toisto 0.. unbounded Address Line. Details Aggregaatilla annetaan työkohteen osoite. Huomautus Tätä aggregaattia käytetään vain, jos käyttöpaikka eroaa resurssitarveilmoituksessa esitetystä paikasta. Esimerkki <cac:addressline> </cac:addressline> 44/58

45 6.2.5 Työkohteen osoite (Address. Address Line) Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Address. Address Line Toisto 0.. unbounded Address Line. Details Aggregaatilla annetaan työkohteen osoite. Huomautus Tätä aggregaattia käytetään vain, jos käyttöpaikka eroaa resurssitarveilmoituksessa esitetystä paikasta. Esimerkki <cac:addressline> </cac:addressline> Address Line. Line. Text Toisto.. Text. Type Elementillä annetaan työkohteen osoite vapaamuotoisena tekstinä. Esimerkki <cbc:line>korsitie 27 D 8, Helsinki</cbc:Line> 45/58

46 6.2.6 Resurssin varaustunnus (Catalogue Line. Document Reference) Elementti / aggregaatti Catalogue Line. Document Reference Document Reference. Identifier Document Reference. Document Type Code. Code Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Document Reference. Details Aggregaatilla annetaan resurssin varaustunnus. Esimerkki <cac:documentreference> Toisto.. </cac:documentreference> Identifier. Type Elementillä annetaan resurssin varaustunnus. Esimerkki <cbc:id>2223</cbc:id> Toisto 0.. Code. Type Elementillä annetaan resurssin varaustyyppi koodimuotoisena. Huomautus Elementin arvoja on kahdessa eri koodistossa. OASIS on Koodit 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". UN/ECE koodiston 53 mukaisia koodeja ovat: AEO = (Product reservation number) Varaustunnus Attribuutit listid ja listagencyid Esimerkki Code List. Identifier Toisto 0.. <cbc:documenttypecode listid= UN/ECE53" listagencyid="6">aeo</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 46/58

47 Code List. Agency. Identifier Document Reference. Document Type. Text UN/ECE 00 UN/ECE koodisto 00 "Document name code" UN/ECE 53 UN/ECE koodisto 53 "Reference qualifier" Toisto 0.. 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) Toisto 0.. Text. Type Attribuutit languageid Language. Identifier Toisto 0.. Elementillä annetaan resurssin varaustyyppi tekstimuotoisena. Esimerkki <cbc:documenttype languageid="fi">varaustunnus </cbc:documenttype> Tilauksen viitteen tekstimuotoisen tyypin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla. Esimerkki languageid="fi" 47/58

48 6.2.7 Resurssin kuvaus (Catalogue Line. Item) 48/58

49 Elementti / aggregaatti Catalogue Line. Item Toisto.. Toistokerrat, tyyppi, kuvaus, esimerkki Item. Details Aggregaatilla annetaan resurssin kuvaustiedot, kuten tuotekoodi ja tuotteen ominaisuudet. Esimerkki <cac:item> </cac:item> Item. Description. Text Toisto 0.. Text. Type Elementillä annetaan resurssin nimeä tarkempi kuvaus eli pitkä teksti. Attribuutit languageid Language. Identifier Toisto 0.. Esimerkki <cbc:despciption languageid="fi">nosturi<cbc:description> Tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Item. Name Toisto 0.. Name. Type Attribuutit languageid Language. Identifier Toisto 0.. Item. Additional_ Information. Text Elementillä annetaan resurssin nimi, joka esiintyy esimerkiksi tuoteluettelossa tuotekoodin kanssa. Esimerkki <cbc:name languageid="fi"> Liebherr LTM </cbc:name> Nimitekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Toisto 0.. Text. Type Elementillä annetaan resurssiin liittyvää muuta tietoa, jota ei voida antaa minkään muun elementin arvona, kuten käsittelyohjeita. Attribuutit languageid Language. Identifier Toisto 0.. Esimerkki <cbc:additionalinformation languageid="fi">painorajoitukset huomioitava</cbc:additionalinformation> Vapaamuotoisen tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" 49/58

50 Item. Buyers_ Item Identification. Item Identification Item. Standard_ Item Identification. Item Identification Toisto 0.. Item Identification. Details Aggregaatilla annetaan tilaajan tuotekoodi- eli nimiketiedot. Esimerkki <cac:buyersitemidentification> </cac:buyersitemidentification> Toisto 0.. Item Identification. Details Aggregaatilla annetaan sähköalan tuotekoodi- eli nimiketiedot. Esimerkki <cac:standarditemidentification> </cac:standarditemidentification> 50/58

51 6.2.8 Tilaajan tuotekoodi eli nimike (Item. Buyers_ Item Identification. Item Identification) Elementti / aggregaatti Item. Buyers_ Item Identification. Item Identification Item Identification. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. Item Identification. Details Aggregaatilla annetaan tilaajan tuotekoodi- eli nimiketiedot. Esimerkki <cac:buyersitemidentification> </cac:buyersitemidentification> Toisto.. Identifier. Type Elementillä annetaan tilaajan tuotekoodi eli nimike. Esimerkki <cbc:id>zt203</cbc:id> 5/58

52 6.2.9 Sähköalan tuotekoodi eli nimike (Item. Standard_ Item Identification. Item Identification) Elementti / aggregaatti Item. Standard_ Item Identification. Item Identification Item Identification. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. 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. Esimerkki <cbc:id>645065</cbc:id> 52/58

53 7 Sanomaesimerkki Tässä kappaleessa on esimerkki UBL Catalogue-Resurssivaraussanomasta. 7. UBL Resurssivaraussanoman esimerkki <?xml version=".0" encoding="utf-8"?> <Catalogue 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:catalogue-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"> <cbc:ublversionid>2.0</cbc:ublversionid> <cbc:customizationid>et</cbc:customizationid> <cbc:profileid schemeid="292">fi039</cbc:profileid> <cbc:id>200/0</cbc:id> <cbc:issuedate> </cbc:issuedate> <cbc:issuetime>:2:25</cbc:issuetime> <cbc:note languageid="fi">hyväksymisilmoitus pyydetään toimittamaan mahdollisimman pian.</cbc:note> <cac:validityperiod> 53/58

54 <cbc:enddate> </cbc:enddate> <cbc:endtime>6:00:00</cbc:endtime> </cac:validityperiod> <cac:referencedcontract> <cbc:id>234-ab</cbc:id> <cbc:contracttypecode listid="un/ece 00" listagencyid="6">220 </cbc:contracttypecode> </cac:referencedcontract> <cac:providerparty> <cac:partyidentification> <cbc:id schemeid="iso 6523" schemeagencyid="5"> </cbc:id> </cac:partyidentification> <cac:partyname> <cbc:name>asennus Oy</cbc:Name> </cac:partyname> <cac:contact> <cbc:name>tommi Toimittaja</cbc:Name> <cbc:telephone> </cbc:Telephone> </cac:contact> </cac:providerparty> <cac:receiverparty> <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> 54/58