Resurssitarve. Sanomasuositus ja sen yleinen soveltamisohje. FI1036, , v 1.00

Transkriptio

1 Sanomasuositus ja sen yleinen soveltamisohje Resurssitarve FI036, , v.00 Käyttö: Energiateollisuus Sanasto: UBL Versio: 2.0 Sanoma: CatalogueRequest

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 Resurssitarveilmoitusprosessi Prosessin rajaus Prosessin osapuolet Prosessin vaiheet Sanoman tietosisältö... 5 Resurssitarvesanoman rakenne Luokkamalli Tietojen suhde toisiinsa Sanoman määrittely Sanoman otsikkotaso Resurssitarvesanoma (Catalogue Request. Details) Resurssivaraus annettava viimeistään (Catalogue Request. Validity_ Period. Period) Tilaaja (Catalogue Request. Receiver_ Party. Party) Tilaajan tunniste (Party. Party Identification) Tilaajan nimi (Party. Party Name) Tilaajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Toimittaja (Catalogue Request. Provider_ Party. Party) Toimittajan tunniste (Party. Party Identification) Toimittajan nimi (Party. Party Name) Toimittajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Viitetiedot (Catalogue Request. Document Reference) Sanoman rivitaso Resurssitarveilmoitusrivin tiedot (Catalogue Request. Catalogue Request Line) Resurssin primäärinen tarveaikaperiodi (Catalogue Request Line. Line Validity_ Period. Period) Resurssin käyttötiedot (Catalogue Request Line. Required_ Item Location Quantity. Item Location Quantity)... 39

3 6.2.4 Työkohteen osoitetiedot (Item Location Quantity. Applicable Territory_ Address. Address) Työkohteen osoite (Address. Address Line) Resurssin kuvaus (Catalogue Request 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 Resurssitarvesanoman esimerkki Liite : Kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje... 52

4 Sanoma ja sen soveltamisala Tämä dokumentti sisältää UBL 2.0 -versioon perustuvan CatalogueRequest 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ä resurssitarpeita. Soveltamisohjeen määrittelemää resurssitarvesanomaa voidaan käyttää normaalissa tai sopimuspohjaisessa toiminnossa ja sillä voidaan tehdä vain resurssitarveilmoitus. Resurssitarvesanoma lähetetään työnsuunnittelijalle tai projektin suunnittelijalle ja asiakaspalveluun bulkkitavaran toimitusta varten. 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öhön osallistuneet yritykset ja organisaatiot sekä niiden henkilöt. Kappaleessa 2 Dokumentti ja sen yhteydet muihin dokumentteihin esitetään tämän dokumentin ymmärrettävään lukemiseen tarvittavat esitietovaatimukset sekä hyödyllisiä linkkejä ja tämän dokumentin päivitystiedot. Kappaleessa 3 Resurssitarpeen ilmoitusprosessi esitetään tämän dokumentin tietosisällön ja soveltamisohjeen pohjana oleva resurssitarpeen ilmoitusprosessi, sen osapuolet ja vaiheet. Kappaleessa 4 Sanoman tietosisältö on esitetty resurssitarvesanomassa välitettävien tietojen luettelo. Kappaleessa 5 "Resurssi-ilmoitussanoman rakenne on esitetty tämän UBL- CatalogueRequest-sanoman luokkamalli käyttäen hyväksi UML-kuvauskieltä sekä UBLsanoman 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. 4/53

5 Kappaleessa 7 Sanomaesimerkki on esitetty esimerkki UBL- CatalogueRequestresurssitarvesanoman käytöstä. 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/53

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

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

8 3 Resurssitarveilmoitusprosessi 3. Prosessin rajaus Tässä prosessikuvauksessa on tarkasteltu ainoastaan resurssitarveilmoituksen toimitusprosessia, jossa tämän dokumentin määrittelemää CatalogueRequest-sanomaa voidaan käyttää. Tarkastelussa oletetaan, että ilmoitukset välitetään niiden toimitusprosessissa sähköisesti osapuolten välillä. Tarkastelun ulkopuolelle on jätetty resurssitarveilmoitusten toimittamisen jälkeiset vaiheet kuten resurssivarauksen tekeminen ja toimitus, 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 tekee resurssitarveilmoituksen. Osapuoli, joka lähettää resurssitarveilmoituksen. Osapuoli, joka vastaanottaa resurssitarveilmoituksen. Osapuoli, joka käsittelee resurssitarveilmoituksen. Osapuoli, joka tekee resurssivaraukset resurssitarveilmoituksen perusteella. Taulukko 3.2.: Resurssitarveilmoituksen toimitusprosessin osapuolet 3.3 Prosessin vaiheet Kuviossa 3.3. on esitetty resurssitarveilmoituksen toimitusprosessin vaiheet eroteltuna kohdassa 3.2 esitettyjen osapuolien toimintojen mukaan. 8/53

9 Tilaaja Toimittaja Luodaan resurssitarvesanoma Lähetetään resurssitarvesanoma Resurssitarvesanoma Vastaanotetaan resurssitarvesanoma Otetaan vastaan vastaanoton kuittaus Tekninen / vastaanoton kuittaus Käsitellään resurssitarvesanoma Kuitataan vastaanotto Käsitellään vastaanoton kuittaus Resurssivarauksen luonti Kuvio 3.3.: Resurssitarveilmoituksen toimitusprosessi 9/53

10 Seuraavassa taulukossa on selitetty kuviossa 3.3. esitetyn resurssitarveilmoituksen ja resurssivarausilmoituksen toimitusprosessin vaiheet jaoteltuna osapuolten hoitamien toimintojen mukaan. Osapuoli Toiminta Tilaaja Toimittaja Luodaan resurssitarvesanoma Lähetetään resurssitarvesanoma Otetaan vastaan vastaanoton kuittaus Käsitellään vastaanoton kuittaus Vastaanotetaan resurssitarvesanoma Käsitellään resurssitarvesanoma Kuitataan vastaanotto Resurssivaraussanoman luonti Tilaaja luo resurssitarvesanoman omassa järjestelmässään. Tilaaja lähettää resurssitarvesanoman sähköisesti toimittajalle. Tilaaja ottaa vastaan sanoman vastaanoton kuittauksen, jolla toimittaja ilmoittaa vastaanottaneensa resurssitarvesanoman. Tilaaja käsittelee sanoman vastaanoton kuittauksen omissa tietojärjestelmissään. Toimittaja vastaanottaa resurssitarvesanoman. Toimittaja käsittelee resurssitarvesanoman omissa tietojärjestelmissään. Toimittaja kuittaa vastaanottaneensa resurssitarvesanoman lähettämällä tilaajalle sanoman vastaanoton kuittauksen. Toimittaja luo omissa tietojärjestelmissään resurssivaraussanoman. Resurssivarauksen luonti ja toimitus eivät sisälly tarkasteltavaan prosessiin. Taulukko 3.3.: Resurssitarveilmoituksen toimitusprosessin osapuolikohtaiset vaiheet 0/53

11 4 Sanoman tietosisältö Seuraavassa taulukossa on esitetty resurssitarvesanoman 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 resurssitarveilmoituksen 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. /53

12 TIETO Aggregaatti Kappale P/V Sanoman versio Catalogue Request 6.. P Soveltamisohjeen kehittäjä Catalogue Request 6.. P Soveltamisohjeen tunnus Catalogue Request 6.. P Resurssitarvesanoman tunnus Catalogue Request 6.. P Resurssitarvesanoman päivämäärä Catalogue Request 6.. P Resurssitarvesanoman kellonaika Catalogue Request 6.. V Sanoman rooli (tarvesanoma, muutos/tarkennussanoma) Resurssitarvesanoman vapaanmuotoinen teksti Catalogue Request 6.. P Catalogue Request 6.. V Hanketunnus Catalogue Request. Document Reference 6.. P Resurssivaraussanoman tunnus Catalogue Request. Document Reference 6.. V Resurssivaraus annettava viimeistään Catalogue Request. Validity_ Period. Period 0 P Tilaajan tiedot Catalogue Request. Receiver_ Party. Party 6..3 P Tilaajayrityksen tunniste (OVT) Catalogue Request. Receiver_ Party. Party. Party Identification 6..4 P Tilaajayrityksen nimi Catalogue Request. Receiver_ Party. Party. Party Name 6..5 P Tilaajayrityksen yhteyshenkilön tiedot Catalogue Request. Receiver_ Party. Party. Contact 6..6 P Yhteyshenkilö Catalogue Request. Receiver_ Party. Party. Contact 6..6 P Yhteysosasto Catalogue Request. Receiver_ Party. Party. Contact 6..6 V 2/53

13 Puhelinnumero Catalogue Request. Receiver_ Party. Party. Contact 6..6 V Sähköpostiosoite Catalogue Request. Receiver_ Party. Party. Contact 6..6 V Toimittajan tiedot Catalogue Request. Provider_ Party. Party 6..7 P Toimittajayrityksen tunniste (OVT) Catalogue Request. Provider_ Party. Party. Party Identification 6..8 P Toimittajayrityksen nimi Catalogue Request. Provider_ Party. Party. Party Name 6..9 P Toimittajayrityksen yhteyshenkilön tiedot Catalogue Request. Provider_ Party. Party. Contact 6..0 V Yhteyshenkilö Catalogue Request. Provider_ Party. Party. Contact 6..0 V Yhteysosasto Catalogue Request. Provider_ Party. Party. Contact 6..0 V Rivitaso Rivin tunnus Catalogue Request. Catalogue Request Line 6.2. P Resurssin kuvaus (henkilö, laite, materiaali, muu tarve) Catalogue Request. Catalogue Request Line. Item P Nimi (henkilön tai laitteen nimi) Catalogue Request. Catalogue Request Line. Item V Tilaajan tuotekoodi eli nimike (Tilaajan tuotenimike) Tuotekoodi eli nimike (Sähköalan nimike) Catalogue Request. Catalogue Request Line. Item. Buyers_ Item Identification. Item Identification Catalogue Request. Catalogue Request Line. Item. Standard_ Item Identification. Item Identification 3/ V V Vapaamuotoinen kuvaus Catalogue Request. Catalogue Request Line. Item V Tarveaikaperiodi (primäärinen) Catalogue Request. Catalogue RequstLine. Line Validity_ Period. Period P Tarveaikaperiodi (sekundäärinen, jne) Catalogue Request. Catalogue Request Line 6.2. V Määrä Määrän yksikkö Catalogue Request. Catalogue Request Line. Required_ Item Location Quantity. Item Location Quantity Catalogue Request. Catalogue Request Line. Required_ Item Location Quantity. Item Location Quantity P P

14 Työkohteen osoite Catalogue Request. Catalogue Request Line. Required_ Item Location Quantity. Item Location Quantity. Applicable Territory_ Address. Address. Address Line P 4/53

15 5 Resurssitarvesanoman rakenne 5. Luokkamalli Tässä kappaleessa esitetään UBL 2.0 CatalogueRequest-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 resurssitarvesanoman otsikkotason luokkamalli ja kuviossa 5..2 resurssitarvesanoman rivitason luokkamalli. PartyIdentification -ID DocumentReference -ID -DocumentTypeCode -DocumentType CatalogueRequest -UBLVersionID -CustomizationID -ProfileID -ID -IssueDate -IssueTime -Note -Description +Provider +Receiver Party PartyName -Name CatalogueRequestLine -ID -Note..* +Validity Period -EndDate -EndTime Contact -ID -Name -Telephone -ElectronicMail Kuvio 5..: Resurssitarvesanoman otsikkotason luokkamalli 5/53

16 CatalogueRequestLine -ID -Note +LineValidity Period -StartDate -StartTime -EndDate -EndTime +Required Item -Description -Name -AdditionalInformation ItemLocationQuantity -MaximumQuantity +ApplicableTerritory Address +Buyers ItemIdentification -ID +Standard AddressLine -Line Kuvio 5..2: Resurssitarvesanoman rivitason luokkamalli 5.2 Tietojen suhde toisiinsa Tässä luvussa esitetään resurssitarvesanoman 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 resurssitarvesanoman otsikkotason tietojen suhteet ja kuviossa resurssitarvesanoman rivitason tietojen suhteet. 6/53

17 Tunnustiedot -Tunnus Viitetiedot -Tunnus -Viitteen tyyppikoodi -Viitteen tyyppi Resurssitarve -UBL Version numero -Sovellusohjeen kehittäjä -Sovellusohjeen tunnus -Resurssitarveilmoituksen tunnus -Resurssitarveilmoituksen päivämäärä -Resurssitarveilmoituksen kellonaika -Yleistä tietoa -Ilmoituksen tyyppi +Toimittaja Osapuolitiedot Nimitiedot -Nimi..* +Tilaaja Resurssitarverivi -Rivin tunnus -Sekundäärinen tarveaika +Resurssivaraus annettava Yhteystiedot -Tunnus -Nimi -Puhelin -Sähköposti Ajanjaksotiedot -Loppupäivä -Loppukellonaika Kuvio 5.2.: Resurssitarvesanoman otsikkotason tietojen suhteet Resurssitarverivi -Rivin tunnus -Sekundäärinen tarveaika +Primäärinen tarve Ajanjaksotiedot -Alkupäivä -Alkukellonaika -Loppupäivä -Loppukellonaika Tuotetiedot -Resurssin kuvaus -Tuotenimi -Lisätieto Resurssin käyttö -Tarvittava määrä Osoitetiedot Osoite +Tilaajan Nimiketiedot -Tunnus +Sähköalan -Työkohteen osoite Kuvio 5.2.2: Resurssitarvesanoman rivitason tietojen suhteet 7/53

18 6 Sanoman määrittely 6. Sanoman otsikkotaso Sanoman otsikkotasolla välitetään koko dokumenttia koskevat tiedot, kuten dokumentin tunniste, päiväys, voimassaoloaika sekä osapuolitiedot. 6.. Resurssitarvesanoma (Catalogue Request. Details) Catalogue Request. Details Catalogue Request. UBL Version Identifier. Identifier Catalogue Request. Customization Identifier. Identifier Catalogue Request. Profile Identifier. Identifier Catalogue Request. Identifier Catalogue Request. UUID. Identifier Catalogue Request. Name Catalogue Request. Issue Date. Date Catalogue Request. Issue Time. Time Catalogue Request. Note. Text Catalogue Request. Description. Text Catalogue Request. Pricing Update Request_ Indicator. Indicator Catalogue Request. Item Update Request_ Indicator. Indicator Catalogue Request. Line Count. Numeric Catalogue Request. Validity_ Period. Period Catalogue Request. Receiver_ Party. Party Catalogue Request. Provider_ Party. Party Catalogue Request. Seller_ Supplier Party. Supplier Party Catalogue Request. Contractor_ Customer Party. Customer Party Catalogue Request. Requested_ Catalogue Reference. Catalogue Reference Catalogue Request. Referenced_ Contract. Contract Catalogue Request. Trading Terms Catalogue Request. Document Reference Catalogue Request. Applicable Territory_ Address. Address Catalogue Request. Requested_ Language. Language Catalogue Request. Requested_ Classification Scheme. Classification Scheme Catalogue Request. Catalogue Request Line Elementti / aggregaatti Catalogue Request. Details Catalogue Request. UBL Version Identifier. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. Tällä aggregaatilla annetaan resurssitarvesanoman tiedot. Esimerkki <CatalogueRequest> </CatalogueRequest> Toisto 0.. Identifier. Type UBL version numero. Tämän sanoman rakenne ja tämä 8/53

19 Catalogue Request. Customization Identifier. Identifier Catalogue Request. Profile Identifier. Identifier Identification Scheme Agency. Identifier Catalogue Request. Identifier Catalogue Request. Issue Date. Date Catalogu Request. Issue Time. Time 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 292 (FI, TIEKE The Information Technology Development Centre of Finland) TIEKE Tietoyhteiskunnan kehittämiskeskus ry Toisto.. Identifier. Type Resurssitarvesanoman yksilöivät tunnus, jolla se tunnistetaan myöhemmin. 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> 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, 9/53

20 Catalogue request. Note. Text 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:05:5</cbc:issuetime> Toisto 0.. unbounded Text. Type Elementillä annetaan ilmoitukseen liittyvää yleistä tietoa, jota ei voida antaa CatalogueRequest-sanoman muiden elementtien arvona. Huomautus Vain yksi elementin toisto kieltä kohden. Attribuutit languageid Language. Identifier Toisto 0.. Catalogue Request. Description. Text Catalogue Request. Validity_ Period. Period 0 Esimerkki <cbc:note languageid="fi">resurssivaraus pyydetään toimittamaan mahdollisimman pian.</cbc:note> Ilmoituksen vapaamuotoisen tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla. Esimerkki languageid="fi" Toisto 0.. unbounded Text. Type Elementillä annetaan ilmoituksen tyyppi koodimuotoisena. Huomautus Elementti on tarkoitettu vapaamuotoisen tiedon esittämiseen, Koodit mutta tässä se saa koodimuotoisia arvoja. UN/ECE koodiston UN/ECE 225 Message function code mukaisia koodeja ovat: 4 = (Change) Muutos 9 = (Original) Alkuperäinen / uusi Esimerkki <cbc:description>9</cbc:description> Toisto Type 0.. unbounded Period. Details Aggregaatilla annetaan tieto, mihin mennessä toimittajan on viimeistään annettava resurssivaraussanoma eli ilmoitettava resurssien saatavuudesta. Esimerkki <cac:validityperiod> </cac:validityperiod> 20/53

21 Catalogue Request. Receiver_ Party. Party 6..3 Catalogue Request. Provider_ Party. Party 6..7 Catalogue Request. Document Reference 6.. Catalogue Request. Catalogue Request Line 6.2. Toisto.. Party. Details Aggregaatilla annetaan tilaajan eli resurssitarveilmoituksen lähettäjän nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:party> </cac:party> Toisto.. Party. Details Aggregaatilla annetaan toimittajan eli resurssitarveilmoituksen vastaanottajan nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:party> </cac:party> Toisto 0.. unbounded Type Document Reference. Details Tällä aggregaatilla annetaan resurssitarveilmoituksen perustana olevan hankkeen tunnus sekä aiemmin saadun resurssivarauksen tunnus. Esimerkki <cac:documentreference> </cac:documentreference> Toisto.. unbounded Catalogue Line. Details Aggregaatilla annetaan resurssitarverivin tiedot. Esimerkki <cac:cataloguerequestline> </cac:cataloguerequestline> 2/53

22 6..2 Resurssivaraus annettava viimeistään (Catalogue Request. Validity_ Period. Period) Catalogue Request. Validity_ Period. Period Period. Start Date. Date Period. Start Time. Time Period. End Date. Date Period. End Time. Time Period. Duration. Measure Period. Description Code. Code Period. Description. Text Elementti / aggregaatti Catalogue Request. Validity_ Period. Period Toistokerrat, tyyppi, kuvaus, esimerkki Toisto Type Period. End Date. Date Toisto unbounded Period. Details Aggregaatilla annetaan tieto, mihin mennessä toimittajan on viimeistään annettava resurssivarausilmoitus eli tieto resurssien saatavuudesta. Esimerkki <cac:validityperiod> </cac:validityperiod> Date. Type Period. End Time. Time Toisto 0.. Elementillä annetaan päivämäärä, jolloin toimittajan on viimeistään annettava resurssivarausilmoitus. Esimerkki <cbc:enddate> </cbc:enddate> Time. Type Elementillä annetaan päivämäärän kellonaika, jolloin toimittajan on viimeistään annettava resurssivarausilmoitus. 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>2:30:00</cbc:endtime> 22/53

23 6..3 Tilaaja (Catalogue Request. Receiver_ Party. Party) Catalogue Request. Receiver_ Party. Party Party. Mark Care_ Indicator. Indicator Party. Mark Attention_ Indicator. Indicator Party. Website_ URI. Identifier Party. Logo Reference. Identifier Party. Endpoint Identifier. Identifier Party. Party Identification Party. Party Name Party. Language Party. Postal_ Address. Address Party. Physical_ Location. Location Party. Party Tax Scheme Party. Party Legal Entity Party. Contact Party. Person Party. Agent_ Party. Party Elementti / aggregaatti Catalogue Request. Receiver_ Party. Party Party. Party Identification 6..4 Party. Party Name 6..5 Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. Party. Details Aggregaatilla annetaan tilaajan eli resurssitarveilmoituksen lähettäjän nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:receiverparty> </cac:receiverparty> Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan tilaajan tunnus, jolla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto Party. Contact Toisto unbounded Party Name. Details Aggregaatilla annetaan tilaajan nimitiedot. Esimerkki <cac:partyname> </cac:partyname> 23/53

24 6..6 Contact. Details Aggregaatilla annetaan tilaajan yhteyshenkilön tai -osaston tiedot Esimerkki <cac:contact> </cac:contact> 24/53

25 6..4 Tilaajan tunniste (Party. Party Identification) Party. Party Identification Party Identification. Identifier Elementti / aggregaatti Party. Party Identification Party Identification. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan tilaajan tunnus, jolla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto.. Identifier. Type Elementillä annetaan tilaajan tunnus, jolla tilaaja 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 25/53

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

27 6..6 Tilaajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Party. Contact Contact. Identifier Contact. Name Contact. Telephone. Text Contact. Telefax. Text Contact. Electronic_ Mail. Text Contact. Note. Text Contact. Other_ Communication. Communication Elementti / aggregaatti Party. Contact Toisto 0.. Toistokerrat, tyyppi, kuvaus, esimerkki Contact. Details Aggregaatilla annetaan tilaajan yhteyshenkilön tai -osaston tiedot Contact. Identifier Toisto 0.. Esimerkki <cac:contact> </cac:contact> Identifier. Type Elementillä annetaan tilaajan 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 yhteyshenkilön tai osaston nimi. Esimerkki <cbc:name>timo Tilaaja</cbc:Name> Text. Type Elementillä annetaan tilaajan yhteyshenkilön tai -osaston puhelinnumero. Esimerkki <cbc:telephone> <cbc:Telephone> Toisto 0.. Text. Type Elementillä annetaan tilaajan yhteyshenkilön tai -osaston sähköpostiosoite. Esimerkki <cbc:electronicmail>timo.tilaaja@sahko.fi <cbc:electronicmail> 27/53

28 6..7 Toimittaja (Catalogue Request. Provider_ Party. Party) Catalogue Request. Provider_ Party. Party Party. Mark Care_ Indicator. Indicator Party. Mark Attention_ Indicator. Indicator Party. Website_ URI. Identifier Party. Logo Reference. Identifier Party. Endpoint Identifier. Identifier Party. Party Identification Party. Party Name Party. Language Party. Postal_ Address. Address Party. Physical_ Location. Location Party. Party Tax Scheme Party. Party Legal Entity Party. Contact Party. Person Party. Agent_ Party. Party Elementti / aggregaatti Catalogue Request. Provider_ Party. Party Party. Party Identification 6..8 Party. Party Name 6..9 Party. Contact 6..0 Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. Party. Details Aggregaatilla annetaan toimittajan eli resurssitarveilmoituksen vastaanottajan nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:providerparty> </cac:providerparty> Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan toimittajan tunnus, jolla 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 toimittajan nimitiedot Esimerkki <cac:partyname> </cac:partyname> Toisto 0.. Contact. Details 28/53

29 Aggregaatilla annetaan toimittajan yhteyshenkilön tai -osaston tiedot Esimerkki <cac:contact> </cac:contact> 29/53

30 6..8 Toimittajan tunniste (Party. Party Identification) Party. Party Identification Party Identification. Identifier Elementti / aggregaatti Party. Party Identification Party Identification. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan toimittajan tunnus, jolla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto.. Identifier. Type Elementillä annetaan toimittajan 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 30/53

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

32 6..0 Toimittajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Party. Contact Contact. Identifier Contact. Name Contact. Telephone. Text Contact. Telefax. Text Contact. Electronic_ Mail. Text Contact. Note. Text Contact. Other_ Communication. Communication Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Party. Contact Toisto 0.. Contact. Details Aggregaatilla annetaan toimittajan yhteyshenkilön tai -osaston tiedot Esimerkki <cac:contact> </cac:contact> Contact. Identifier Toisto 0.. Identifier. Type Elementillä annetaan toimittajan 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 Elementillä annetaan toimittajan yhteyshenkilön tai -osaston nimi. Esimerkki <cbc:name>tommi Toimittaja</cbc:Name> 32/53

33 6.. Viitetiedot (Catalogue Request. Document Reference) Catalogue Request. Document Reference Document Reference. Identifier Document Reference. Copy_ Indicator. Indicator Document Reference. UUID. Identifier Document Reference. Issue Date. Date Document Reference. Document Type Code. Code Document Reference. Document Type. Text Document Reference. XPath. Text Document Reference. Attachment Elementti / aggregaatti Catalogue Request. Document Reference Document Reference. Identifier Document Reference. Document Type Code. Code Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Type Document Reference. Details Tällä aggregaatilla annetaan resurssitarveilmoituksen perustana olevan hankkeen tunnus sekä aiemmin saadun resurssivarauksen tunnus. Esimerkki <cac:documentreference> </cac:documentreference> Toisto 0.. Identifier. Type Elementillä annetaan sen hankkeen tunnus, johon tämä resurssitarveilmoitus liittyy, sekä aiemmin vastaanotetun resurssivarauksen tunnus, johon tehdään muutoksia tai tarkennuksia. Esimerkki <cbc:id>234-ab</cbc:id> Toisto 0.. Code. Type Elementillä annetaan resurssitarveilmoituksen 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: 220 = (Order) Hanke UN/ECE koodiston 53 mukaisia koodeja ovat: AEO = (Product reservation number) Varausnumero Attribuutit listid ja listagencyid Esimerkki <cbc:documenttypecode listid= UN/ECE00" 33/53

34 Code List. Identifier Toisto 0.. Code List. Agency. Identifier Document Reference. Document Type. Text listagencyid="6">220</cbc:documenttypecode> 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 resurssitarveilmoituksen viitteen tyyppi tekstimuotoisena. Attribuutit languageid Esimerkki <cbc:documenttype languageid="fi">hanke </cbc:documenttype> 34/53

35 6.2 Sanoman rivitaso Sanoman rivitasolla välitetään tarvittavaa resurssia koskevat tiedot, kuten tuotekoodi, tuotteen kuvaus ja määrätiedot Resurssitarveilmoitusrivin tiedot (Catalogue Request. Catalogue Request Line) Catalogue Request. Catalogue Request Line Catalogue Request Line. Identifier Catalogue Request Line. Contract Subdivision. Text Catalogue Request Line. Note. Text Catalogue Request Line. Line Validity_ Period. Period Catalogue Request Line. Required_ Item Location Quantity. Item Location Quantity Catalogue Request Line. Item Elementti / aggregaatti Catalogue Request. Catalogue Request Line Catalogue Request Line. Identifier Catalogue Request Line. Note. Text Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. unbounded Catalogue Line. Details Aggregaatilla annetaan resurssitarveilmoituksen rivin tiedot. Esimerkki <cac:cataloguerequestline> </cac:cataloguerequestline> Toisto.. Identifier. Type Elementillä annetaan resurssitarveilmoituksen rivin tunnus. Esimerkki <cbc:id>003</cbc:id> Toisto 0.. unbounded Text. Type Elementillä annetaan rivin lisätietona sekundääriset tarveaikaperiodit vapaamuotoisena tekstinä. Huomautus Yksi toisto sekundääristä tarveaikaperiodia kohti. Attribuutit languageid Language. Identifier Toisto 0.. Catalogue Request Line. Line Validity_ Period. Period Esimerkki <cbc:note languageid="fi">. sekundäärinen tarveaika </cbc:Note> Vapaamuotoisen tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Toisto 0.. Period. Details Aggregaatilla annetaan resurssin primäärinen tarveaikatieto. Esimerkki <cac:linevalidityperiod> </cac:linevalidityperiod> 35/53

36 Catalogue Request Line. Required_ Item Location Quantity. Item Location Quantity Catalogue Request Line. Item Toisto 0.. unbounded Period. Details Aggregaatilla annetaan tarvittava resurssimäärä ja työkohteen osoite. Esimerkki <cac:requireditemlocationquantity> </cac:requireditemlocationquantity> Toisto.. Item. Details Aggregaatilla annetaan resurssin kuvaustiedot, kuten tuotekoodi ja tuotteen ominaisuudet. Esimerkki <cac:item> </cac:item> 36/53

37 6.2.2 Resurssin primäärinen tarveaikaperiodi (Catalogue Request Line. Line Validity_ Period. Period) Catalogue Request Line. Line Validity_ Period. Period Period. Start Date. Date Period. Start Time. Time Period. End Date. Date Period. End Time. Time Period. Duration. Measure Period. Description Code. Code Period. Description. Text Elementti / aggregaatti Catalogue RequstLine. Line Validity_ Period. Period Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. Period. Start Date. Date Toisto 0.. Period. Details Aggregaatilla annetaan resurssin primäärinen tarveaikatieto. Esimerkki <cac:linevalidityperiod> </cac:linevalidityperiod> Date. Type Period. Start Time. Time Toisto 0.. Elementillä annetaan primäärisen tarveaikaperiorin ensimmäisen päivän päivämäärä. Esimerkki <cbc:startdate> </cbc:startdate> Time. Type Period. End Date. Date Toisto 0.. Elementillä annetaan primäärisen tarveaikaperiorin ensimmäisen päivän kellonaika. Huomautus Jos kellonajan ilmoittamisessa on huomioitava aikavyöhyke, esitetään kellonaika muodossa hh:mm:ss+hh:mm tai hh:mm:ss-hh:mm, missä plus- tai miinus-merkin jälkeen on ilmoitettu ajan poikkeaminen UCT- ajasta (Coordinated Universal Time). Jos kellonaika ilmoitetaan UCT-ajassa, voidaan käyttää merkintää hh.mm:ssz. (UTC korvaa aikaisemmin käytetyn Greenwichin keskiajan (GMT).) Esimerkki <cbc:starttime>08:30:00</cbc:starttime> Date. Type Period. Start Date. Date Toisto 0.. Elementillä annetaan primäärisen tarveaikaperiorin viimeisen päivän päivämäärä. Esimerkki <cbc:enddate> </cbc:enddate> 37/53

38 Time. Type Elementillä annetaan primäärisen tarveaikaperiorin 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> 38/53

39 6.2.3 Resurssin käyttötiedot (Catalogue Request Line. Required_ Item Location Quantity. Item Location Quantity) Catalogue Request Line. Required_ Item Location Quantity. Item Location Quantity Item Location Quantity. Lead Time. Measure Item Location Quantity. Minimum_ Quantity. Quantity Item Location Quantity. Maximum_ Quantity. Quantity Item Location Quantity. Hazardous Risk_ Indicator. Indicator Item Location Quantity. Trading Restrictions. Text Item Location Quantity. Applicable Territory_ Address. Address Item Location Quantity. Price Item Location Quantity. Delivery Unit Item Location Quantity. Applicable_ Tax Category. Tax Category Elementti / aggregaatti Catalogue Request 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 tarvittava resurssimäärä ja työkohteen osoite. Esimerkki <cac:requireditemlocationquantity> Toisto 0.. Attribuutit </cac:requireditemlocationquantity> Quantity. Type Elementillä annetaan tarvittava 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 39/53

40 Item Location Quantity. Applicable Territory_ Address. Address MTR NMP NPL SET TNE Toisto Esimerkki (Metre) Metri (Packs) Pakkaus, kolli (Parcels) Laatikko (Sets) Sarja, erä (Tonne) Tonni 0.. unbounded Address. Details Aggregaatilla annetaan työkohteen osoitetiedot. <cac:applicableterritoryaddress> </cac:applicableterritoryaddress> 40/53

41 6.2.4 Työkohteen osoitetiedot (Item Location Quantity. Applicable Territory_ Address. Address) Item Location Quantity. Applicable Territory_ Address. Address Address. Identifier Address. Address Type Code. Code Address. Address Format Code. Code Address. Postbox. Text Address. Floor. Text Address. Room. Text Address. Street Name. Name Address. Additional_ Street Name. Name Address. Block Name. Name Address. Building Name. Name Address. Building Number. Text Address. Inhouse_ Mail. Text Address. Department. Text Address. Mark Attention. Text Address. Mark Care. Text Address. Plot Identification. Text Address. City Subdivision Name. Name Address. City Name. Name Address. Postal_ Zone. Text Address. Country Subentity. Text Address. Country Subentity Code. Code Address. Region. Text Address. District. Text Address. Timezone Offset. Text Address. Address Line Address. Country Address. Location Coordinate Elementti / aggregaatti Item Location Quantity. Applicable Territory_ Address. Address Address. Address Line Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Address. Details Aggregaatilla annetaan työkohteen osoitetiedot. Esimerkki <cac:applicableterritoryaddress> </cac:applicableterritoryaddress> Toisto 0.. unbounded Address Line. Details Aggregaatilla annetaan työkohteen osoite. Esimerkki <cac:addressline> </cac:addressline> 4/53

42 6.2.5 Työkohteen osoite (Address. Address Line) Address. Address Line Address Line. Line. Text Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Address. Address Line Toisto 0.. unbounded Address Line. Details Aggregaatilla annetaan työkohteen osoite. 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 22, Helsinki</cbc:Line> 42/53

43 6.2.6 Resurssin kuvaus (Catalogue Request Line. Item) Catalogue Request Line. Item Item. Description. Text Item. Pack Quantity. Quantity Item. Pack Size. Numeric Item. Catalogue_ Indicator. Indicator Item. Name Item. Hazardous Risk_ Indicator. Indicator Item. Additional_ Information. Text Item. Keyword. Text Item. Brand Name. Name Item. Model Name. Name Item. Buyers_ Item Identification. Item Identification Item. Sellers_ Item Identification. Item Identification Item. Manufacturers_ Item Identification. Item Identification Item. Standard_ Item Identification. Item Identification Item. Catalogue_ Item Identification. Item Identification Item. Additional_ Item Identification. Item Identification Item. Catalogue_ Document Reference. Document Reference Item. Item Specification_ Document Reference. Document Reference Item. Origin_ Country. Country Item. Commodity Classification Item. Transaction Conditions Item. Hazardous Item Item. Classified_ Tax Category. Tax Category Item. Additional_ Item Property. Item Property Item. Manufacturer_ Party. Party Item. Information Content Provider_ Party. Party Item. Origin_ Address. Address Item. Item Instance 43/53

44 Elementti / aggregaatti Catalogue Request Line. Item Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. 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">tullaan nostamaan erittäin raskaita taakkoja.</cbc:additionalinformation> Vapaamuotoisen tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" 44/53

45 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> 45/53

46 6.2.7 Tilaajan tuotekoodi eli nimike (Item. Buyers_ Item Identification. Item Identification) Item. Buyers_ Item Identification. Item Identification Item Identification. Identifier Item Identification. Extended_ Identifier. Identifier Item Identification. Physical Attribute Item Identification. Measurement_ Dimension. Dimension Item Identification. Issuer_ Party. Party Elementti / aggregaatti Item. Buyers_ Item Identification. Item Identification Item Identification. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki 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>2323</cbc:id> 46/53

47 6.2.8 Sähköalan tuotekoodi eli nimike (Item. Standard_ Item Identification. Item Identification) Item. Standard_ Item Identification. Item Identification Item Identification. Identifier Item Identification. Extended_ Identifier. Identifier Item Identification. Physical Attribute Item Identification. Measurement_ Dimension. Dimension Item Identification. Issuer_ Party. Party Elementti / aggregaatti Item. Standard_ Item Identification. Item Identification Item Identification. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki 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> 47/53

48 7 Sanomaesimerkki Tässä kappaleessa on esimerkki UBL CatalogueRequest-Resurssitarvesanomasta. 7. UBL Resurssitarvesanoman esimerkki <?xml version=".0" encoding="utf-8"?> <CatalogueRequest 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:cataloguerequest-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">fi036</cbc:profileid> <cbc:id>200/0</cbc:id> <cbc:issuedate> </cbc:issuedate> <cbc:issuetime>2:05:5</cbc:issuetime> <cbc:note languageid="fi">resurssivaraus pyydetään toimittamaan mahdollisimman pian.</cbc:note> 48/53

49 <cbc:description>9</cbc:description> <cac:validityperiod> <cbc:enddate> </cbc:enddate> </cac:validityperiod> <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> <cbc:telephone> </cbc:Telephone> </cac:contact> </cac:receiverparty> <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> </cac:contact> 49/53

50 </cac:providerparty> <cac:documentreference> <cbc:id>234-ab</cbc:id> <cbc:documenttypecode listid="00" listagencyid="6">220</cbc:documenttypecode> </cac:documentreference> <cac:cataloguerequestline> <cbc:id>00</cbc:id> <cbc:note languageid="fi">sekundäärinen tarveaika </cbc:Note> <cac:validityperiod> <cbc:startdate> </cbc:startdate> <cbc:starttime>08:30:00</cbc:starttime> <cbc:enddate> </cbc:enddate> <cbc:endtime>4:00:00</cbc:endtime> </cac:validityperiod> <cac:requireditemlocationquantity> <cbc:maximumquantity unitcode="c62"></cbc:maximumquantity> <cac:applicableterritoryaddress> <cac:addressline> <cbc:line>korsitie 27 D 22, Helsinki</cbc:Line> </cac:addressline> </cac:applicableterritoryaddress> </cac:requireditemlocationquantity> <cac:item> <cbc:description languageid="fi">nosturi</cbc:description> <cbc:name>liebherr LTM </cbc:Name> <cbc:additionalinformation languageid="fi">tullaan nostamaan erittäin raskaita taakkoja</cbc:additionalinformation> <cac:buyersitemidentification> <cbc:id>2323</cbc:id> </cac:buyersitemidentification> 50/53

51 </cac:item> </cac:cataloguerequestline> </CatalogueRequest> 5/53

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