Sanomasuositus ja sen yleinen soveltamisohje Resurssitarve FI036, 200-06-30, v.00 Käyttö: Energiateollisuus Sanasto: UBL Versio: 2.0 Sanoma: CatalogueRequest
Sisällysluettelo Sanoma ja sen soveltamisala... 4. Soveltamisohjeen sisältö... 4.2 Työryhmän työskentelyyn osallistuneet... 5 2 Dokumentti ja sen yhteydet muihin dokumentteihin... 7 2. Päivitykset... 7 2.2 Esitietovaatimukset... 7 2.3 Aiheeseen liittyvää aineistoa... 7 2.4 Huomioitavaa... 7 3 Resurssitarveilmoitusprosessi... 8 3. Prosessin rajaus... 8 3.2 Prosessin osapuolet... 8 3.3 Prosessin vaiheet... 8 4 Sanoman tietosisältö... 5 Resurssitarvesanoman rakenne... 5 5. Luokkamalli... 5 5.2 Tietojen suhde toisiinsa... 6 6 Sanoman määrittely... 8 6. Sanoman otsikkotaso... 8 6.. Resurssitarvesanoma (Catalogue Request. Details)... 8 6..2 Resurssivaraus annettava viimeistään (Catalogue Request. Validity_ Period. Period)... 22 6..3 Tilaaja (Catalogue Request. Receiver_ Party. Party)... 23 6..4 Tilaajan tunniste (Party. Party Identification)... 25 6..5 Tilaajan nimi (Party. Party Name)... 26 6..6 Tilaajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact)... 27 6..7 Toimittaja (Catalogue Request. Provider_ Party. Party)... 28 6..8 Toimittajan tunniste (Party. Party Identification)... 30 6..9 Toimittajan nimi (Party. Party Name)... 3 6..0 Toimittajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact)... 32 6.. Viitetiedot (Catalogue Request. Document Reference)... 33 6.2 Sanoman rivitaso... 35 6.2. Resurssitarveilmoitusrivin tiedot (Catalogue Request. Catalogue Request Line) 35 6.2.2 Resurssin primäärinen tarveaikaperiodi (Catalogue Request Line. Line Validity_ Period. Period)... 37 6.2.3 Resurssin käyttötiedot (Catalogue Request Line. Required_ Item Location Quantity. Item Location Quantity)... 39
6.2.4 Työkohteen osoitetiedot (Item Location Quantity. Applicable Territory_ Address. Address)... 4 6.2.5 Työkohteen osoite (Address. Address Line)... 42 6.2.6 Resurssin kuvaus (Catalogue Request Line. Item)... 43 6.2.7 Tilaajan tuotekoodi eli nimike (Item. Buyers_ Item Identification. Item Identification)... 46 6.2.8 Sähköalan tuotekoodi eli nimike (Item. Standard_ Item Identification. Item Identification)... 47 7 Sanomaesimerkki... 48 7. UBL Resurssitarvesanoman esimerkki... 48 8 Liite : Kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje... 5
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.9.2009 ja loppui 30.6.200. 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/52
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/52
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/52
2 Dokumentti ja sen yhteydet muihin dokumentteihin 2. Päivitykset Pvm/Laatija Versio Kommentit/muutokset 200-06-30 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 (http://www.w3schools.com/xml/default.asp ) ebxml Core Components Technical Specification (CCTS) 2.0 (http://www.ebxml.org/ ) Universal Business Language 2.0 ( www.oasisopen.org/committees/tc_home.php?wg_abbrev=ubl) NES työryhmän tekemät soveltamisohjeet ( www.nesubl.eu ) United Nations Directories for Electronic Data Interchange for Administration, Commerce and Transport (http://www.unece.org/trade/untdid/welcome.htm ) UN/CEFACT Recommendations (http://www.unece.org/cefact/recommendations/rec_index.htm ) 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/52
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/52
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/52
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/52
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. /52
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 6..2 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/52
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 6.2.6 P Nimi (henkilön tai laitteen nimi) Catalogue Request. Catalogue Request Line. Item 6.2.6 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/52 6.2.7 V 6.2.8 V Vapaamuotoinen kuvaus Catalogue Request. Catalogue Request Line. Item 6.2.6 V Tarveaikaperiodi (primäärinen) Catalogue Request. Catalogue RequstLine. Line Validity_ Period. Period 6.2.2 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 6.2.3 P 6.2.3 P
Työkohteen osoite Catalogue Request. Catalogue Request Line. Required_ Item Location Quantity. Item Location Quantity. Applicable Territory_ Address. Address. Address Line 6.2.5 P 4/52
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/52
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 5.2.2 resurssitarvesanoman rivitason tietojen suhteet. 6/52
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/52
6 Sanoman määrittely Tässä kappaleessa on esitelty UBL- CatalogueRequest -Resurssitarveanoman 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.. Resurssitarvesanoma (Catalogue Request. Details) 8/52
Elementti / aggregaatti Catalogue Request. Details Catalogue Request. UBL Version Identifier. Identifier Catalogue Request. Customization Identifier. Identifier Catalogue Request. Profile Identifier. Identifier Identification Scheme Agency. Identifier Catalogue Request. Identifier Catalogue Request. Issue Date. Date 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ä 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. 9/52
Catalogu Request. Issue Time. Time Catalogue request. Note. Text Esimerkki <cbc:issuedate>200-04-0</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, 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 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 20/52
Catalogue Request. Validity_ Period. Period 6..2 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. 9 = (Original) Alkuperäinen / uusi Esimerkki <cbc:description>9</cbc:description> Toisto 0.. unbounded Type Period. Details Aggregaatilla annetaan tieto, mihin mennessä toimittajan on viimeistään annettava resurssivaraussanoma eli ilmoitettava resurssien saatavuudesta. Esimerkki <cac:validityperiod> </cac:validityperiod> 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/52
6..2 Resurssivaraus annettava viimeistään (Catalogue Request. Validity_ Period. Period) Elementti / aggregaatti Catalogue Request. Validity_ Period. Period Toistokerrat, tyyppi, kuvaus, esimerkki Toisto Type Period. End Date. Date Toisto 0.. 0.. 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>200-04-06</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/52
6..3 Tilaaja (Catalogue Request. Receiver_ 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 0.. 0.. unbounded Party Name. Details Aggregaatilla annetaan tilaajan nimitiedot. Esimerkki <cac:partyname> </cac:partyname> 23/52
6..6 Contact. Details Aggregaatilla annetaan tilaajan yhteyshenkilön tai -osaston tiedot Esimerkki <cac:contact> </cac:contact> 24/52
6..4 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 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"> 003702345672345</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/52
6..5 Tilaajan nimi (Party. Party 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/52
6..6 Tilaajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) 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>03 234 5678<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/52
6..7 Toimittaja (Catalogue Request. Provider_ 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/52
Aggregaatilla annetaan toimittajan yhteyshenkilön tai -osaston tiedot Esimerkki <cac:contact> </cac:contact> 29/52
6..8 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 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"> 003723232</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/52
6..9 Toimittajan nimi (Party. Party 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/52
6..0 Toimittajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) 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/52
6.. Viitetiedot (Catalogue Request. Document Reference) 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/52
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/52
6.2 Sanoman rivitaso Sanoman rivitasolla välitetään tarvittavaa resurssia koskevat tiedot, kuten tuotekoodi, tuotteen kuvaus ja määrätiedot. 6.2. Resurssitarveilmoitusrivin tiedot (Catalogue Request. Catalogue Request Line) 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 6.2.2 Esimerkki <cbc:note languageid="fi">. sekundäärinen tarveaika 24. 26.5.200</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/52
Catalogue Request Line. Required_ Item Location Quantity. Item Location Quantity 6.2.3 Catalogue Request Line. Item 6.2.6 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/52
6.2.2 Resurssin primäärinen tarveaikaperiodi (Catalogue Request Line. Line Validity_ Period. Period) 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>200-05-9</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>200-05-2</cbc:enddate> 37/52
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/52
6.2.3 Resurssin käyttötiedot (Catalogue Request Line. Required_ Item Location Quantity. Item Location Quantity) 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/52
Item Location Quantity. Applicable Territory_ Address. Address 6.2.4 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/52
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 6.2.5 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/52
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. 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, 00730 Helsinki</cbc:Line> 42/52
6.2.6 Resurssin kuvaus (Catalogue Request Line. Item) 43/52
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 500-8. </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/52
Item. Buyers_ Item Identification. Item Identification 6.2.7 Item. Standard_ Item Identification. Item Identification 6.2.8 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/52
6.2.7 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>2323</cbc:id> 46/52
6.2.8 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> 47/52
7 Sanomaesimerkki Tässä kappaleessa on esimerkki UBL CatalogueRequest-Resurssitarvesanomasta. 7. UBL Resurssitarvesanoman esimerkki <?xml version=".0" encoding="utf-8"?> <CatalogueRequest xmlns:xsi="http://www.w3.org/200/xmlschema-instance" 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>200-04-0</cbc:issuedate> <cbc:issuetime>2:05:5</cbc:issuetime> <cbc:note languageid="fi">resurssivaraus pyydetään toimittamaan mahdollisimman pian.</cbc:note> <cbc:description>9</cbc:description> 48/52
<cac:validityperiod> <cbc:enddate>200-04-06</cbc:enddate> </cac:validityperiod> <cac:receiverparty> <cac:partyidentification> <cbc:id schemeid="iso 6523" schemeagencyid="5">003702345672345</cbc:id> </cac:partyidentification> <cac:partyname> <cbc:name>oy Sähkö Ab</cbc:Name> </cac:partyname> <cac:contact> <cbc:id>timo.tilaaja@sahko.fi</cbc:id> <cbc:name>timo Tilaaja</cbc:Name> <cbc:telephone>03 234 5678</cbc:Telephone> <cbc:electronicmail>timo.tilaaja@sahko.fi</cbc:electronicmail> </cac:contact> </cac:receiverparty> <cac:providerparty> <cac:partyidentification> <cbc:id schemeid="iso 6523" schemeagencyid="5">003723232</cbc:id> </cac:partyidentification> <cac:partyname> <cbc:name>asennus Oy</cbc:Name> </cac:partyname> <cac:contact> <cbc:id>tommi.toimittaja@asennus.fi</cbc:id> <cbc:name>tommi Toimittaja</cbc:Name> </cac:contact> </cac:providerparty> <cac:documentreference> <cbc:id>234-ab</cbc:id> 49/52
<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 24.-26.5.200</cbc:Note> <cac:validityperiod> <cbc:startdate>200-05-9</cbc:startdate> <cbc:starttime>08:30:00</cbc:starttime> <cbc:enddate>200-05-2</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, 00730 Helsinki</cbc:Line> </cac:addressline> </cac:applicableterritoryaddress> </cac:requireditemlocationquantity> <cac:item> <cbc:description languageid="fi">nosturi</cbc:description> <cbc:name>liebherr LTM 500-8.</cbc:Name> <cbc:additionalinformation languageid="fi">tullaan nostamaan erittäin raskaita taakkoja</cbc:additionalinformation> <cac:buyersitemidentification> <cbc:id>2323</cbc:id> </cac:buyersitemidentification> </cac:item> </cac:cataloguerequestline> </CatalogueRequest> 50/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 5/52
52/52