Massaluettelo. Sanomasuositus ja sen yleinen soveltamisohje. FI1040, , v 1.00

Transkriptio

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

2 Sisällysluettelo Sanoma ja sen soveltamisala Soveltamisohjeen sisältö Työryhmän työskentelyyn osallistuneet Dokumentti ja sen yhteydet muihin dokumentteihin Päivitykset Esitietovaatimukset Aiheeseen liittyvä aineisto Huomioitavaa Massaluettelon toimitusprosessi Prosessin rajaus Prosessin osapuolet Prosessin vaiheet Sanoman tietosisältö Massaluettelosanoman rakenne Luokkamalli Tietojen suhde toisiinsa Sanoman määrittely Sanoman otsikkotaso Massaluettelosanoma (Catalogue. Details) Viitetiedot (Catalogue. Referenced_ Contract. Contract) Viitteet (Contract. Contract_ Document Reference. Document Reference) Liitetiedosto (Document Reference. Attachment) Liitetiedoston web-osoite (Attachment. External Reference) Tilaaja tiedot (Catalogue. Provider_ Party. Party) Tilaajan tunniste (Party. Party Identification) Tilaajan nimi (Party. Party Name) Tilaajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Toimittajan tiedot (Catalogue. Receiver_ Party. Party) Toimittajan tunniste (Party. Party Identification) Toimittajan nimi (Party. Party Name) Toimittajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Sanoman rivitaso Massaluettelorivin tiedot (Catalogue. Catalogue Line) Tuotteen kuvaus (Catalogue Line. Item) Tilaajan tuotekoodi eli nimike (Item. Buyers_ Item Identification. Item Identification)... 48

3 6.2.4 Sähköalan tuotekoodi eli nimike (Item. Standard_ Item Identification. Item Identification) Tuotteeseen liittyvät viitteet (Item. Item Specification_ Document Reference. Document Reference) Liitetiedosto (Document Reference. Attachment) Liitetiedoston web-osoite (Attachment. External Reference) Sanomaesimerkki UBL massaluetteloesimerkki Liite : Kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje... 58

4 Sanoma ja sen soveltamisala Tämä dokumentti sisältää UBL 2.0 -versioon perustuvan Catalogue sanoman sanomakuvauksen ja soveltamisohjeen. Tämä soveltamisohje määrittelee sanoman käytön suomalaisen energiateollisuuden sähköntuottajien ja heidän palvelutuottajien välisessä toiminnassa toimitettaessa massaluettelotietoja tarjouksen tekemiseksi. Soveltamisohjeen määrittelemää massaluettelosanomaa voidaan käyttää normaalissa tai sopimuspohjaisessa toiminnossa ja sillä voidaan välittää vain massaluettelo. Tässä sanomassa tietyt tiedot voivat esiintyä sekä otsikko- että rivitasolla. Jos tieto on määritelty otsikkotasolla, vaikuttaa se koko sanomaan kuitenkin niin, että jos sama tieto on määritelty rivitasolla jollakin rivillä, kumoaa tämä kyseisellä rivillä määritelty tieto otsikkotasolla määritellyn tiedon. Sovellusohje on syntynyt Energiateollisuus ry:n organisoimassa projektissa Sähkönjakeluyhtiöiden ja palveluntuottajayhtiöiden tietojärjestelmien yhteensopivuus. Projekti alkoi ja loppui Soveltamisohjeen on tehnyt TIEKE Tietoyhteiskunnankehittämiskeskus ry. Tämän soveltamisohjeen tarkoituksena on lisätä yritysten halukkuutta ottaa käyttöön XMLpohjaista sähköistä tiedonsiirtoa, nopeuttaa järjestelmien kehitysprosessia ja vähentää integraatiokustannuksia luomalla yleinen ja yhtäläinen kansallinen suositus. Suosituksella pyritään myös vähentämään tarvetta luoda yritys- tai organisaatiokohtaisia erilaisia suosituksia, jotka eivät välttämättä ole yhteentoimivia. Tavoitteena on myös nopeuttaa uuden tiedonsiirtotavan omaksumista kansainvälisen kilpailukyvyn säilyttämiseksi ja parantamiseksi. Soveltamisohje on tarkoitettu apuvälineeksi yhteistyökumppanien välisiin neuvotteluihin kehitettäessä organisaatioiden välistä sähköistä tiedonsiirtoa. Soveltamisohjetta voidaan käyttää hyväksi kehitettäessä jo olemassa olevien järjestelmien tiedonsiirto-ominaisuuksia.. Soveltamisohjeen sisältö Kappaleessa Sanoma ja sen soveltamisala on esitetty tämän sanoman käyttötarkoitus, soveltamisen rajaus sekä kehityshankkeen työn osallistuneet yritykset ja organisaatiot sekä niiden henkilöt. Kappaleessa 2 Dokumentti ja sen yhteydet muihin dokumentteihin esitetään tämän dokumentin ymmärrettävään lukemiseen tarvittavat esitietovaatimukset sekä hyödyllisiä linkkejä ja tämän dokumentin päivitystiedot. Kappaleessa 3 Massaluettelon välitysprosessi esitetään tämän dokumentin tietosisällön ja sovellusohjeen pohjana oleva massaluettelon välitysprosessi, sen osapuolet ja vaiheet. Kappaleessa 4 Sanoman tietosisältö on esitetty massaluettelosanomassa välitettävien tietojen luettelo. Kappaleessa 5 "Massaluettelosanoman rakenne on esitetty tämän UBL-Cataloguesanoman luokkamalli käyttäen hyväksi UML-kuvauskieltä sekä UBL-sanoman elementtinimillä että niiden sisältämien tietojen nimillä esitettynä. Kappaleessa 6 Sanoman määrittely on esitelty otsikko- ja rivitason rakenne, käytettävät aggregaatit, elementit, attribuutit ja koodit sekä niiden käyttötarkoitus. Kappaleessa 7 Sanomaesimerkki on esitetty esimerkki UBL-Cataloguemassaluettelosanoman käytöstä. 4/59

5 Liitteessä on esitetty kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje..2 Työryhmän työskentelyyn osallistuneet Seuraavassa taulukossa on esitetty yritykset ja organisaatiot, jotka ovat osallistuneet Energiateollisuus ry:n organisoiman projektin Sähkönjakeluyhtiöiden ja palveluntuottajayhtiöiden tietojärjestelmien yhteensopivuus työhön joko sen ohjaus- tai projektiryhmässä. Yritys/Organisaatio Eltel Networks Oy Empower Oy Energiateollisuus ry (SV -toimiala) ENFO Fingrid Oyj Fortum Sähkönsiirto Oy Frends Oy Headpower Oy Helen Sähköverkko Oy Kaupunkiyhtiöt R 2 / Kuopion Energia Oy Logica Suomi Oy Oy Mercus Software Oy STUL Suomen Energia Urakointi Oy 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 Ari Ala-Sippola 5/59

6 Taisto Lehonmaa Tekla Oy Tieto Oy Vattenfall Verkko Oy Visma Software Oy Voimatel Oy 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/59

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ä aineisto w3schools XML Tutorial ( ) ebxml Core Components Technical Specification (CCTS) 2.0 ( ) Universal Business Language 2.0 ( NES työryhmän tekemät soveltamisohjeet ( ) United Nations Directories for Electronic Data Interchange for Administration, Commerce and Transport ( ) UN/CEFACT Recommendations ( ) 2.4 Huomioitavaa Soveltamisohje perustuu UBL 2.0 Catalogue-sanoman määrityksiin. Määrityksissä on huomioitu myös kansainvälisen NES (Northern European Subset) työryhmän suositukset. 7/59

8 3 Massaluettelon toimitusprosessi 3. Prosessin rajaus Tässä prosessikuvauksessa on tarkasteltu ainoastaan massaluettelon toimitusprosessia, jossa tämän dokumentin määrittelemää Catalogue-sanomaa voidaan käyttää. Tarkastelussa oletetaan, että massaluettelo välitetään toimitusprosessissa sähköisesti osapuolten välillä. Tarkastelun ulkopuolelle on jätetty massaluettelon toimittamista edeltävät vaiheet, kuten resurssitarpeiden ilmoitus ja varaus sekä tarjouspyynnön teko ja lähetys sekä myös massaluettelon toimittamisen jälkeiset vaiheet, kuten 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 massaluettelon. Osapuoli, joka lähettää massaluettelon. Osapuoli, joka tekee tarkennetun massaluettelo. Osapuoli, joka lähettää tarkennetun massaluettelon. Osapuoli, joka vastaanottaa massaluettelon. Osapuoli, joka käsittelee massaluettelon. Osapuoli, joka tekee tarjouksen massaluettelon ja tarjouspyynnön tietojen perusteella. Taulukko 3.2.: Massaluettelon toimitusprosessin osapuolet 3.3 Prosessin vaiheet Kuviossa 3.3. on esitetty massaluettelon toimitusprosessin vaiheet eroteltuna kohdassa 3.2 esitettyjen osapuolien toimintojen mukaan. 8/59

9 Tilaaja Toimittaja Luodaan massaluettelo Lähetetään massaluettelo Massaluettelo Vastaanotetaan massaluettelo Otetaan vastaan vastaanoton kuittaus Tekninen / vastaanoton kuittaus Kuitataan vastaanotto Käsitellään vastaanoton kuittaus Käsitellään massaluettelo Lähetetään tarkennettu massaluettelo Luodaan tarkennettu massaluettelo Käsitellään tarkennuspyyntö Massaluettelo sisältää riittävät tiedot Tarjouksen teko Massaluettelo ei sisällä riittävästi tietoa Luodaan tarkennuspyyntö Vastaanotetaan tarkennuspyyntö Tarkennuspyyntö Lähetetään tarkennuspyyntö Kuvio 3.3.: Massaluettelon toimitusprosessi 9/59

10 Seuraavassa taulukossa on selitetty kuviossa 3.3. esitetyn massaluettelon toimitusprosessin vaiheet jaoteltuna osapuolten hoitamien toimintojen mukaan. Osapuoli Toiminta Tilaaja Toimittaja Luodaan massaluettelo Lähetetään massaluettelo Otetaan vastaan vastaanoton kuittaus Käsitellään vastaanoton kuittaus Vastaanotetaan tarkennuspyyntö Käsitellään tarkennuspyyntö Luodaan tarkennettu massaluettelo Lähetetään tarkennettu massaluettelo Vastaanotetaan massaluettelo Kuitataan vastaanotto Käsitellään massaluettelo Luodaan tarkennuspyyntö Lähetetään tarkennuspyyntö Tilaaja luo massaluettelosanoman omassa järjestelmässään. Tilaaja lähettää massaluettelosanoman sähköisesti toimittajalle. Tilaaja ottaa vastaan sanoman vastaanoton kuittauksen, jolla toimittaja ilmoittaa vastaanottaneensa massaluettelosanoman. Tilaaja käsittelee sanoman vastaanoton kuittauksen omissa tietojärjestelmissään. Tilaaja ottaa vastaan massaluettelon tarkennuspyynnön. Tilaaja käsittelee massaluettelon tarkennuspyynnön. Tilaaja tekee massaluetteloon tarkennuksia toimittajan esittämien tarpeiden mukaan. Tilaaja lähettää tarkennetun massaluettelosanoman sähköisesti toimittajalle. Toimittaja vastaanottaa massaluettelosanoman. Toimittaja kuittaa vastaanottaneensa massaluettelosanoman lähettämällä tilaajalle sanoman vastaanoton kuittauksen. Toimittaja käsittelee massaluettelosanoman omissa tietojärjestelmissään. Käsittelyn perusteella massaluettelon tiedot havaitaan: riittäviksi tarvitsevan tarkennuksia Toimittaja luo tarkennuspyynnön. Toimittaja lähettää tarkennuspyynnön tilaajalle. 0/59

11 Tarjouksen teko Toimittaja tekee tarjouksen käyttäen hyväksi massaluettelosanomalla saapuneita tietoja. Taulukko 3.3.: Massaluettelon toimitusprosessin osapuolikohtaiset vaiheet /59

12 4 Sanoman tietosisältö Seuraavassa taulukossa on esitetty massaluettelosanoman 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 massaluettelon välitysprosessissa (P = pakollinen, V = valinnainen, R = ehdollinen (tiedon esiintyminen sanomassa riippuu jonkin toisen tiedon esiintymisestä)). Sanoman vastaanottaja voi käyttää vastaanottamansa sanoman tietoja siten, kuin heidän tietojärjestelmänsä sen sallii. Vastaanottajan ei siis tarvitse tallettaa järjestelmäänsä tietoa, joka on soveltamisohjeessa merkitty pakolliseksi, mutta sanoman lähettäjän on aina lähetettävä pakolliseksi merkitty tieto. 2/59

13 Tieto Aggregaatti Kappale P/V Sanoman versio Catalogue 6.. P Soveltamisohjeen kehittäjä Catalogue 6.. P Sanoman soveltamisohjeen tunnus Catalogue 6.. P Massaluettelon tunnus Catalogue 6.. P Päivämäärä Catalogue 6.. P Kellonaika Catalogue 6.. V Yleistä tietoa Catalogue 6.. V Viitteet Tarjouspyynnön tunnus Catalogue. Referenced_ Contract. Contract 6..2 P Piirustusnumero Catalogue. Referenced_ Contract. Contract. Contract_ Document Reference. Document Reference 6..3 V Piirustus Liitetiedosto Liitetiedoston web-osoite Catalogue. Referenced_ Contract. Contract. Contract_ Document Reference. Document Reference Catalogue. Referenced_ Contract. Contract. Contract_ Document Reference. Document Reference. Attachment Catalogue. Referenced_ Contract. Contract. Contract_ Document Reference. Document Reference. Attachment. External Reference 6..3 V 6..4 V 6..5 V Tilaajan tiedot Catalogue. Provider_ Party. Party 6..6 P Tunnus Catalogue. Provider_ Party. Party. Party Identification 6..7 P 3/59

14 Nimi Catalogue. Provider_ Party. Party. Party Name 6..8 V Yhteyshenkilö Catalogue. Provider_ Party. Party. Contact 6..9 P Yhteysosasto Catalogue. Provider_ Party. Party. Contact 6..9 V Puhelinnumero Catalogue. Provider_ Party. Party. Contact 6..9 V Sähköpostiosoite Catalogue. Provider_ Party. Party. Contact 6..9 V Toimittajan tiedot Catalogue. Receiver_ Party. Party 6..0 P Tunnus Catalogue. Receiver_ Party. Party. Party Identification 6.. P Nimi Catalogue. Receiver_ Party. Party. Party Name 6..2 V Yhteyshenkilö Catalogue. Receiver_ Party. Party. Contact 6..3 V Yhteysosasto Catalogue. Receiver_ Party. Party. Contact 6..3 V Rivin tiedot Catalogue. Catalogue Line 6.2 P Rivin tunnus Catalogue. Catalogue Line 6.2. P Riviin liittyvää yleistietoa Catalogue. Catalogue Line 6.2. V Tuotekoodi (tilaaja) Tuotekoodi (sähköala) Catalogue. Catalogue Line. Item. Buyers_ Item Identification. Item Identification Catalogue. Catalogue Line. Item. Standard_ Item Identification. Item Identification V (R) V (R) Tuotteen nimi Catalogue. Catalogue Line. Item V (R) Tuotteen kuvaus (pitkä teksti) Catalogue. Catalogue Line. Item V 4/59

15 Tuotteeseen liittyvää yleistietoa Catalogue. Catalogue Line. Item V Määrä Catalogue. Catalogue Line 6.2. P Määrän yksikkö Catalogue. Catalogue Line 6.2. P Rivin viitteet Piirustusnumero Piirustus Tuotteen kuva Liitetiedosto Liitetiedoston web-osoite Catalogue. Catalogue Line. Item. Item Specification_ Document Reference. Document Reference Catalogue. Catalogue Line. Item. Item Specification_ Document Reference. Document Reference Catalogue. Catalogue Line. Item. Item Specification_ Document Reference. Document Reference Catalogue. Catalogue Line. Item. Item Specification_ Document Reference. Document Reference Catalogue. Catalogue Line. Item. Item Specification_ Document Reference. Document Reference. Attachment Catalogue. Catalogue Line. Item. Item Specification_ Document Reference. Document Reference. Attachment. External Reference V V V V V V 5/59

16 5 Massaluettelosanoman rakenne 5. Luokkamalli Tässä kappaleessa esitetään UBL 2.0 Catalogue-sanoman rakenne käyttäen hyväksi UMLluokkamallia. Mallissa on esitetty sanoma vain niiltä osin kuin sen tietosisältö on määritelty Energiateollisuus ry:n organisoimassa projektissa Sähkönjakeluyhtiöiden ja palveluntuottajayhtiöiden tietojärjestelmien yhteensopivuus. Kuviossa 5.. on esitetty massaluettelosanoman otsikkotason luokkamalli ja kuviossa 5..2 massaluettelosanoman rivitason luokkamalli. PartyIdentification -ID Contract -ID -ContractTypeCode -ContractType +Contract +Referenced Catalogue -UBLVersionID -CustomizationID -ProfileID -ID -IssueDate -IssueTime -Note +Provider +Receiver Party PartyName -Name DocumentReference -ID -DocumentTypeCode -DocumentType Attachment -EmbeddedDocumentBinaryObject..* CatalogueRequestLine -ID -Note -ContentUnitQuantity Contact -ID -Name -Telephone -ElectronicMail ExternalReference -URI Kuvio 5..: Massaluettelosanoman otsikkotason luokkamalli 6/59

17 CatalogueRequestLine -ID -Note -ContentUnitQuantity Item -Description -Name -AdditionalInformation +Specification DocumentReference -ID -DocumentTypeCode -DocumentType +Buyers ItemIdentification -ID +Standard Attachment -EmbeddedDocumentBinaryObject ExternalReference -URI Kuvio 5..2: Massaluettelosanoman rivitason luokkamalli 5.2 Tietojen suhde toisiinsa Tässä luvussa esitetään massaluettelosanoman 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 massaluettelosanoman otsikkotason tietojen suhteet ja kuviossa massaluettelosanoman rivitason tietojen suhteet. 7/59

18 Tunnustiedot -Tunnus Massaluettelo Tarjouspyyntö -Tunnus -Tarjouspyynnön tyypiikoodi -Tarjouspyynnön tyyppi -UBL Version numero -Sovellusohjeen kehittäjä -Sovellusohjeen tunnus -Massaluettelon tunnus -Massaluettelon päivämäärä -Massaluettelon kellonaika -Yleistä tietoa +Toimittaja Osapuolitiedot Nimitiedot -Nimi +Tilaaja Viitetiedot -Tunnus -Viitteen tyyppikoodi -Viitteen tyyppi..* Resurssitarverivi -Rivin tunnus -Rivin yleistietoa -Määrä Yhteystiedot -Tunnus -Nimi -Puhelin -Sähköposti Liite -Sisäinen liite Ulkoinen liite -URI Kuvio 5.2.: Massaluettelosanoman otsikkotason tietojen suhteet 8/59

19 Resurssitarverivi -Rivin tunnus -Rivin yleistietoa -Määrä Tuotetiedot -Tuotteen kuvaus -Tuotenimi -Lisätieto Viitetiedot +Tilaajan Nimiketiedot -Tunnus +Sähköalan -Tunnus -Viitteen tyyppikoodi -Viitteen tyyppi Liite -Sisäinen liite Ulkoinen liite -URI Kuvio 5.2.2: Massaluettelosanoman rivitason tietojen suhteet 9/59

20 6 Sanoman määrittely Tässä kappaleessa on esitelty UBL- Catalogue -Massaluettelosanoman 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.. Massaluettelosanoma (Catalogue. Details)..* Elementti / aggregaatti Catalogue. Details Toistokerrat, tyyppi, kuvaus, esimerkki 20/59

21 Catalogue. UBL Version Identifier. Identifier Catalogue. Customization Identifier. Identifier Catalogue. Profile Identifier. Identifier Identification Scheme Agency. Identifier Tällä aggregaatilla annetaan massaluettelosanoman tiedot. Esimerkki <Catalogue> </Catalogue> Identifier. Type UBL version numero. Tämän sanoman rakenne ja tämä soveltamisohje perustuvat UBL versioon 2.0. Täten tämä elementti saa vakiosti arvon "2.0". Esimerkki <cbc:ublversionid>2.0</cbc:ublversionid> Identifier. Type Elementillä annetaan sanoman soveltamiohjeen kehittäjän nimi. Esimerkki <cbc:customizationid>et</cbc:customizationid> Identifier. Type TIEKE ry:n sovellusohjeelle antama tunnus, joka on vakiosti FI040. Attribuutit schemeagencyid Esimerkki <cbc:profileid schemeagencyid="292">fi040</cbc:profileid> Attribuutilla annetaan soveltamisohjeluettelon ylläpitäjän tunnus. Esimerkki schemeagencyid="292" Käytettävät koodit Catalogue. Identifier Toisto.. Catalogue. Issue Date. Date Catalogue. Issue Time. Time 292 (FI, TIEKE The Information Technology Development Centre of Finland) TIEKE Tietoyhteiskunnan kehittämiskeskus ry Identifier. Type Massaluettelosanoman yksilöivät tunnus, jolla se tunnistetaan myöhemmin. Esimerkki <cbc:id> p</cbc:id> Toisto.. Date. Type Elementillä annetaan massaluettelo päivämäärä. On suositeltavaa, että päivämäärä on sama, jonka massaluettelon sisällöstä vastaava henkilö voi nähdä järjestelmästään massaluettelon tekopäivämääränä, eikä massaluettelosanoman muodostamispäivämäärä, joka voi poiketa tästä päivämäärästä. Päivämäärän muoto on YYYY-MM-DD. Esimerkki <cbc:issuedate> </cbc:issuedate> Time. Type 2/59

22 Elementillä annetaan massaluettelon luontikelloaika, siis luontihetken tunnit, minuutit ja sekunnit. On suositeltavaa, että ajanhetki on sama, jonka massaluettelon sisällöstä vastaava henkilö voi nähdä järjestelmästään massaluettelon tekoajanhetkenä, eikä massaluettelosanoman muodostamisajanhetki, joka voi poiketa tästä ajanhetkestä. Kellonajan muoto on hh:mm:ss. Huomautus Jos kellonajan ilmoittamisessa on huomioitava aikavyöhyke, esitetään kellonaika muodossa hh:mm:ss+hh:mm tai hh:mm:ss-hh:mm, missä plus- tai miinus-merkin jälkeen on ilmoitettu ajan poikkeaminen UCT- ajasta (Coordinated Universal Time). Jos kellonaika ilmoitetaan UCT-ajassa, voidaan käyttää merkintää hh.mm:ssz. (UTC korvaa aikaisemmin käytetyn Greenwichin keskiajan (GMT).) Esimerkki <cbc:issuetime>0:59:5</cbc:issuetime> Catalogue. Note. Text Toisto 0.. unbounded Text. Type Elementillä annetaan massaluetteloon liittyvää yleistä tietoa, jota ei voida antaa Catalogue-sanoman muiden elementtien arvona. Huomautus Vain yksi elementin toisto kieltä kohden. Attribuutit languageid Language. Identifier Catalogue. Referenced_ Contract. Contract 6..2 Catalogue. Provider_ Party. Party 6..6 Esimerkki <cbc:note languageid="fi">mahdolliset tarkennuspyynnöt pyydetään toimittamaan mahdollisimman pian sanomassa ilmoitetulle yhdyshenkilölle.</cbc:note> Massaluettelon vapaamuotoisen tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla. Esimerkki languageid="fi" Toisto Type 0.. unbounded Contract. Details Tällä aggregaatilla annetaan sen tarjouspyynnön tunnus, johon massaluettelo liittyy. Esimerkki <cac:referencedcontract> </cac:referencedcontract> Toisto.. Party. Details Aggregaatilla annetaan tilaajan eli massaluettelon lähettäjäorganisaation nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:party> </cac:party> 22/59

23 Catalogue. Receiver_ Party. Party 6..0 Catalogue. Catalogue Line 6.2. Toisto.. Party. Details Aggregaatilla annetaan toimittajan eli massaluettelon vastaanottajaorganisaation nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:party> </cac:party> Toisto.. unbounded Catalogue Line. Details Aggregaatilla annetaan ilmoitusrivin tiedot. Esimerkki <cac:catalogueline> </cac:catalogueline> 23/59

24 6..2 Viitetiedot (Catalogue. Referenced_ Contract. Contract) Elementti / aggregaatti Catalogue. Referenced_ Contract. Contract Toistokerrat, tyyppi, kuvaus, esimerkki Toisto Type Contract. Identifier Contract. Contract Type Code. Code 0.. unbounded Contract. Details Tällä aggregaatilla annetaan sen tarjouspyynnön tunnus, johon massaluettelo liittyy. Esimerkki <cac:referencedcontract> </cac:referencedcontract> Identifier. Type Elementillä annetaan tarjouspyynnön tunnus. Esimerkki <cbc:id>22367</cbc:id> Code. Type Elementillä annetaan massaluettelon viitteen tyyppi koodimuotoisena. Huomautus Elementin arvoja on kahdessa eri koodistossa. OASIS on Koodit määritellyt UN/ECE koodiston "00 Document name code" oletusarvoiseksi koodistoksi. Jos tästä koodistosta ei löydy sopivaa koodia, voidaan käyttää UN/ECE koodistoa 53 Reference qualifier". UN/ECE koodiston 00 mukaisia koodeja ovat: 3 = (Request for quote) Tarjouspyyntö Attribuutit listid ja listagencyid Esimerkki Code List. Identifier <cbc:contracttypecode listid= UN/ECE00" listagencyid="6">3</cbc:contracttypecode> 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" 24/59

25 Code List. Agency. Identifier Contract. Contract Type. Text Contract. Contract_ Document Reference. Document Reference 6..3 UN/ECE 53 UN/ECE koodisto 53 "Reference qualifier" 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) Text. Type Elementillä annetaan massaluettelon viitteen tyyppi tekstimuotoisena. Attribuutit languageid Esimerkki <cbc:contracttype languageid="fi">tarjouspyyntö </cbc:contracttype> Toisto 0.. unbounded Document Reference. Details Aggregaatilla annetaan massaluetteloon liittyviä viitteitä. Esimerkki <cac:contractdocumentreference> </cac:contractdocumentreference> 25/59

26 6..3 Viitteet (Contract. Contract_ Document Reference. Document Reference) Elementti / aggregaatti Contract. Contract_ Document Reference. Document Reference Document Reference. Identifier Document Reference. Document Type Code. Code Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Document Reference. Details Aggregaatilla annetaan massaluetteloon liittyviä viitteitä. Esimerkki <cac:contractdocumentreference> Toisto.. </cac:contractdocumentreference> Identifier. Type Elementillä annetaan massaluettelon viitteen tunnus. Esimerkki <cbc:id> /3</cbc:id> Code. Type Elementillä annetaan massaluettelon viitteen tyyppi koodimuotoisena. Huomautus Elementin arvoja on kahdessa eri koodistossa. OASIS on Koodit määritellyt UN/ECE koodiston "00 Document name code" oletusarvoiseksi koodistoksi. Jos tästä koodistosta ei löydy sopivaa koodia, voidaan käyttää UN/ECE koodistoa 53 Reference qualifier". UN/ECE koodiston 00 mukaisia koodeja ovat: 74 = (Drawing) Piirustus UN/ECE koodiston 53 mukaisia koodeja ovat: AAL = (Drawing number) Piirustusnumero Attribuutit listid ja listagencyid Code List. Identifier Esimerkki <cbc:documenttypecode listid= UN/ECE 00" listagencyid="6">74</cbc:documenttypecode> Attribuutilla annetaan viitteen tunnuskoodiston tunnus; 26/59

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

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

29 6..5 Liitetiedoston web-osoite (Attachment. External Reference) Elementti / aggregaatti Attachment. External Reference External Reference. URI. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki External Reference. Details Aggregaatilla annetaan massaluetteloon liittyvän liitetiedoston web-osoitetiedot. Esimerkki <cac:externalreference> </cac:externalreference> Identifier. Type Elementillä annetaan massaluettelon liitetiedoston web-osoite eli URI (Uniform Resource Identifier) Esimerkki <cbc:uri> 29/59

30 6..6 Tilaaja tiedot (Catalogue. Provider_ Party. Party) Elementti / aggregaatti Catalogue. Provider_ Party. Party Party. Party Identification 6..7 Party. Party Name 6..8 Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. Party. Details Aggregaatilla annetaan tilaajan eli massaluettelon lähettäjäorganisaation nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:providerparty> </cac:providerparty> Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan tilaajan eli massaluettelon lähettäjäorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto 0.. unbounded Party Name. Details Aggregaatilla annetaan tilaajan eli massaluettelon 30/59

31 Party. Contact 6..9 lähettäjäorganisaation nimitiedot Esimerkki <cac:partyname> </cac:partyname> Contact. Details Aggregaatilla annetaan tilaajan eli massaluettelon lähettäjäorganisaation yhteyshenkilön tai -osaston tiedot. Esimerkki <cac:contact> </cac:contact> 3/59

32 6..7 Tilaajan tunniste (Party. Party Identification) Elementti / aggregaatti Party. Party Identification Party Identification. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan tilaajan eli massaluettelon lähettäjäorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto.. Identifier. Type Elementillä annetaan tilaajan eli massaluettelon lähettäjäorganisaation tunnus, jolla massaluettelon lähettäjä 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> Attribuutilla annetaan osapuolitunnistekoodiston tunnus. Esimerkki schemeid="iso 6523" Käytettävät koodit ISO 6523 OVT- tunnus (Structure for the identification of organizations) Attribuutilla annetaan osapuolitunnuskoodiston ylläpitäjä. Esimerkki schemeagencyid="5" Käytettävät koodit 5 ISO (International Organization for Standardization) 9 (Assigned by seller or seller's agent) Toimittajan ylläpitämä luettelo 92 (Assigned by buyer or buyer's agent) Tilaajan ylläpitämä luettelo 32/59

33 6..8 Tilaajan nimi (Party. Party Name) Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Party. Party Name Toisto 0.. unbounded Party Name. Details Aggregaatilla annetaan tilaajan eli massaluettelon lähettäjäorganisaation nimitiedot Esimerkki <cac:partyname> </cac:partyname> Party Name. Name Toisto.. Name. Type Elementillä annetaan tilaajan eli ilmoituksen lähettäjäorganisaation nimi Esimerkki <cbc:name>oy Sähkö Ab</cbc:Name> 33/59

34 6..9 Tilaajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Elementti / aggregaatti Party. Contact Toistokerrat, tyyppi, kuvaus, esimerkki Contact. Identifier Contact. Details Aggregaatilla annetaan tilaajan eli massaluettelon lähettäjäorganisaation yhteyshenkilön tai -osaston tiedot. Esimerkki <cac:contact> </cac:contact> Identifier. Type Elementillä annetaan tilaajan eli massaluettelon lähettäjäorganisaation yhteyshenkilön tai -osaston tunnus Huomautus Henkilön tunnuksena suositellaan käytettäväksi henkilön sähköpostiosoitetta. Esimerkki <cbc:id>46</cbc:id> Contact. Name Name. Type Contact. Telephone. Text Contact. Electronic_ Mail. Text Elementillä annetaan tilaajan eli massaluettelon lähettäjäorganisaation yhteyshenkilön tai -osaston nimi. Esimerkki <cbc:name>timo Tilaaja</cbc:Name> Text. Type Elementillä annetaan tilaajan eli massaluettelon lähettäjäorganisaation yhteyshenkilön tai -osaston puhelinnumero. Esimerkki <cbc:telephone> <cbc:Telephone> Text. Type Elementillä annetaan tilaajan eli massaluettelon lähettäjäorganisaation yhteyshenkilön tai -osaston 34/59

35 sähköpostiosoite. Esimerkki 35/59

36 6..0 Toimittajan tiedot (Catalogue. Receiver_ Party. Party) Elementti / aggregaatti Catalogue. Receiver_ Party. Party Party. Party Identification 6.. Party. Party Name 6..2 Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. Party. Details Aggregaatilla annetaan toimittajan eli massaluettelon vastaanottajaorganisaation nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:receiverparty> </cac:receiverparty> Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan toimittajan eli massaluettelon vastaanottajaorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto 0.. unbounded Party Name. Details Aggregaatilla annetaan toimittajan eli massaluettelon 36/59

37 Party. Contact 6..3 vastaanottajaorganisaation nimitiedot. Esimerkki <cac:partyname> </cac:partyname> Contact. Details Aggregaatilla annetaan toimittajan eli massaluettelon vastaanottajaorganisaation yhteyshenkilön tai -osaston tiedot. Esimerkki <cac:contact> </cac:contact> 37/59

38 6.. Toimittajan tunniste (Party. Party Identification) Elementti / aggregaatti Party. Party Identification Party Identification. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan toimittajan eli massaluettelon vastaanottajaorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto.. Identifier. Type Elementillä annetaan toimittajan eli massaluettelon vastaanottajaorganisaation tunnus, jolla massaluettelon vastaanottaja tunnistetaan partnerin järjestelmissä automaattisesti. Tässä elementissä annettava tunnus voi olla esimerkiksi OVTtunnus, tilaajan tai toimittajan tunnistekoodiston mukainen tunnus. Attribuutit schemeid ja schemeagencyid Esimerkki <cbc:id schemeid="iso 6523" schemeagencyid="5"> </cbc:ID> Attribuutilla annetaan osapuolitunnistekoodiston tunnus. Esimerkki schemeid="iso 6523" Käytettävät koodit ISO 6523 OVT- tunnus (Structure for the identification of organizations) Attribuutilla annetaan osapuolitunnuskoodiston ylläpitäjä. Esimerkki schemeagencyid="5" Käytettävät koodit 5 ISO (International Organization for Standardization) 9 (Assigned by seller or seller's agent) Toimittajan ylläpitämä luettelo 38/59

39 92 (Assigned by buyer or buyer's agent) Tilaajan ylläpitämä luettelo 39/59

40 6..2 Toimittajan nimi (Party. Party Name) Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Party. Party Name Toisto 0.. unbounded Party Name. Details Aggregaatilla annetaan toimittajan eli massaluettelon vastaanottajaorganisaation nimitiedot. Esimerkki <cac:partyname> </cac:partyname> Party Name. Name Toisto.. Name. Type Elementillä annetaan toimittajan eli massaluettelon vastaanottajaorganisaation nimi. Esimerkki <cbc:name>asennus Oy</cbc:Name> 40/59

41 6..3 Toimittajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Party. Contact Contact. Details Aggregaatilla annetaan toimittajan eli massaluettelon vastaanottajaorganisaation yhteyshenkilön tai -osaston tiedot. Esimerkki <cac:contact> </cac:contact> Contact. Identifier Identifier. Type Elementillä annetaan toimittajan eli massaluettelon vastaanottojaorganisaation yhteyshenkilön tai -osaston tunnus. Huomautus Henkilön tunnuksena suositellaan käytettäväksi henkilön sähköpostiosoitetta. Esimerkki <cbc:id>46</cbc:id> Contact. Name Name. Type Elementillä annetaan toimittajan eli massaluettelon vastaanottajaorganisaation yhteyshenkilön tai -osaston nimi. Esimerkki <cbc:name>tommi Toimittaja</cbc:Name> 4/59

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

43 Elementillä annetaan massaluettelorivin tunnus. Esimerkki <cbc:id>003</cbc:id> Catalogue Line. Note. Text Toisto 0.. unbounded Text. Type Elementillä annetaan massaluetteloriviin liittyvää yleistä tietoa, jota ei voida antaa rivin muiden elementtien arvona. Huomautus Vain yksi elementin toisto kieltä kohden. Attribuutit languageid Language. Identifier Catalogue Line. Content Unit. Quantity Esimerkki <cbc:note languageid="fi">huom! Uusi tuote, joka korvaa aiemmin käytetyn.</cbc:note> Vapaamuotoisen tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Quantity. Type Attribuutit unitcode Quantity Unit. Code Toisto.. Elementillä annetaan tuotteen tarvittava määrä. Esimerkki <cbc:contentunitquantity unitcode="c62">25 </cbc:contentunitquantity> 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 MTR NMP NPL SET (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 (Metre) Metri (Packs) Pakkaus, kolli (Parcels) Laatikko (Sets) Sarja, erä 43/59

44 Catalogue Line. Item TNE (Tonne) Tonni Toisto.. Item. Details Aggregaatilla annetaan tuotteen kuvaustiedot, kuten nimi ja tuotekoodi. Esimerkki <cac:item> </cac:item> 44/59

45 6.2.2 Tuotteen kuvaus (Catalogue Line. Item) 45/59

46 Elementti / aggregaatti Catalogue Line. Item Toisto.. Toistokerrat, tyyppi, kuvaus, esimerkki Item. Details Aggregaatilla annetaan tuotteen kuvaustiedot, kuten nimi ja tuotekoodi. Esimerkki <cac:item> </cac:item> Item. Description. Text Toisto 0.. unbounded Text. Type Elementillä annetaan tuotteen nimeä tarkempi tuotteen kuvaus eli pitkä teksti. Attribuutit languageid Language. Identifier Esimerkki <cbc:description languageid="fi">hengenvaar/livsfara,,5mm paksu</cbc:description> Tuotekuvaustekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Item. Name Name. Type Attribuutit languageid Language. Identifier Item. Additional_ Information. Text Elementillä annetaan tuotteen nimi eli nimike, joka esiintyy esimerkiksi tuoteluettelossa tuotekoodin kanssa. Esimerkki <cbc:name languageid="fi">varoituskilpi</cbc:name> Nimitekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Text. Type Elementillä annetaan tuotteeseen liittyvää muuta tietoa, jota ei voida antaa minkään muun elementin arvona, kuten käsittelyohjeita. Attribuutit languageid Language. Identifier Esimerkki <cbc:additionalinformation languageid="fi">varoituskilven tekstin oltava sekä suomeksi että ruotsiksi. </cbc:additionalinformation> Vapaamuotoisen tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla 46/59

47 Item. Buyers_ Item Identification. Item Identification Item. Standard_ Item Identification. Item Identification Item. Item Specification_ Document Reference. Document Reference Esimerkki languageid="fi" Item Identification. Details Aggregaatilla annetaan tilaajan tuotekoodi- eli nimiketiedot. Esimerkki <cac:buyersitemidentification> </cac:buyersitemidentification> Item Identification. Details Aggregaatilla annetaan sähköalan tuotekoodi- eli nimiketiedot. Esimerkki <cac:standarditemidentification> </cac:standarditemidentification> Toisto 0.. unbounded Transaction Condition. Details Aggregaatilla annetaan tuotteeseen liittyviä viitteitä. Esimerkki <cac:itemspecificationdocumentreference> </cac:itemspecificationdocumentreference> 47/59

48 6.2.3 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 Item Identification. Details Aggregaatilla annetaan tilaajan tuotekoodi- eli nimiketiedot. Esimerkki <cac:buyersitemidentification> </cac:buyersitemidentification> Toisto.. Identifier. Type Elementillä annetaan tilaajan tuotekoodi eli nimike. Huomautus Joko tuotteen nimi tai tuotekoodi on annettava. Esimerkki <cbc:id>zt203</cbc:id> 48/59

49 6.2.4 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 Item Identification. Details Aggregaatilla annetaan sähköalan tuotekoodi- eli nimiketiedot. Esimerkki <cac:standarditemidentification> </cac:standarditemidentification> Toisto.. Identifier. Type Elementillä annetaan sähköalan tuotekoodi eli nimike. Huomautus Joko tuotteen nimi tai tuotekoodi on annettava. Esimerkki <cbc:id>645065</cbc:id> 49/59

50 6.2.5 Tuotteeseen liittyvät viitteet (Item. Item Specification_ Document Reference. Document Reference) Elementti / aggregaatti Item. Item Specification_ Document Reference. Document Reference Document Reference. Identifier Document Reference. Document Type Code. Code Toistokerrat, tyyppi, kuvaus, esimerkki Toisto Esimerkki Toisto unbounded Transaction Condition. Details Aggregaatilla annetaan tuotteeseen liittyviä viitteitä. <cac:itemspecificationdocumentreference> </cac:itemspecificationdocumentreference> Identifier. Type Elementillä annetaan tuotteeseen liittyvän viitteen tunnus. Esimerkki <cbc:id>234/200</cbc:id> Code. Type Elementillä annetaan tuotteen viitteen tyyppi koodimuotoisena. Huomautus Elementin arvoja on kahdessa eri koodistossa. OASIS on Koodit määritellyt UN/ECE koodiston "00 Document name code" oletusarvoiseksi koodistoksi. Jos tästä koodistosta ei löydy sopivaa koodia, voidaan käyttää UN/ECE koodistoa 53 Reference qualifier". UN/ECE koodiston 00 mukaisia koodeja ovat: 74 = (Drawing) Piirustus UN/ECE koodiston 53 mukaisia koodeja ovat: AAL = (Drawing number) Piirustusnumero ASK = (Picture of actual product) Tuotteen kuva Attribuutit listid ja listagencyid Code List. Identifier Esimerkki <cbc:documenttypecode listid= UN/ECE 53" listagencyid="6">ask</cbc:documenttypecode> Attribuutilla annetaan viitteen tunnuskoodiston tunnus; joko UN/ECE 00 tai UN/ECE 53 50/59

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

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

53 6.2.7 Liitetiedoston web-osoite (Attachment. External Reference) Elementti / aggregaatti Attachment. External Reference External Reference. URI. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki External Reference. Details Aggregaatilla annetaan tuotteeseen liittyvän liitetiedoston web-osoitetiedot. Esimerkki <cac:externalreference> </cac:externalreference> Identifier. Type Elementillä annetaan tuotteen liitetiedoston web-osoite eli URI (Uniform Resource Identifier) Esimerkki <cbc:uri> 53/59

54 7 Sanomaesimerkki Tässä kappaleessa on esimerkki UBL Catalogue-Massaluettelosanomasta. 7. UBL massaluetteloesimerkki <?xml version=".0" encoding="utf-8"?> <Catalogue xmlns:xsi=" xmlns:qdt="urn:oasis:names:specification:ubl:schema:xsd:qualifieddatatypes-2" xmlns:ext="urn:oasis:names:specification:ubl:schema:xsd:commonextensioncomponents-2" xmlns:ccts="urn:oasis:names:specification:ubl:schema:xsd:corecomponentparameters-2" xmlns:udt="urn:un:unece:uncefact:data:specification:unqualifieddatatypesschemamodule:2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:commonbasiccomponents-2" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:commonaggregatecomponents-2" xmlns="urn:oasis:names:specification:ubl:schema:xsd:catalogue-2" xmlns:clm664="urn:un:unece:uncefact:codelist:specification:664:200" xmlns:clmianamimemediatype="urn:un:unece:uncefact:codelist:specification:ianamimemediatype:2003" xmlns:clm5427="urn:un:unece:uncefact:codelist:specification:5427:200" xmlns:clm5639="urn:un:unece:uncefact:codelist:specification:5639:988"> <cbc:ublversionid>2.0</cbc:ublversionid> <cbc:customizationid>et</cbc:customizationid> <cbc:profileid schemeid="292">fi040</cbc:profileid> <cbc:id> p</cbc:id> <cbc:issuedate> </cbc:issuedate> <cbc:issuetime>0:59:5</cbc:issuetime> <cbc:note languageid="fi">mahdolliset tarkennuspyynöt pyydetään toimittamaan mahdollisimmen pian.</cbc:note> <cac:referencedcontract> 54/59

55 <cbc:id>22367</cbc:id> <cbc:contracttypecode listid="un/ece 00" listagencyid="6">3</cbc:contracttypecode> <cac:additionaldocumentreference> <cbc:id>223-5c</cbc:id> <cbc:documenttypecode listid="un/ece 00" listagencyid="6">74</cbc:documenttypecode> </cac:additionaldocumentreference> </cac:referencedcontract> <cac:providerparty> <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:providerparty> <cac:receiverparty> <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> 55/59

56 </cac:contact> </cac:receiverparty> <cac:catalogueline> <cbc:id>00</cbc:id> <cbc:note languageid="fi">huom! Uusi tuote, joka korvaa aiemmin käytetyn.</cbc:note> <cbc:contentunitquantity unitcode="c62">25</cbc:contentunitquantity> <cac:documentreference> <cbc:id>2223</cbc:id> <cbc:documenttypecode listid="53" listagencyid="6">aeo</cbc:documenttypecode> </cac:documentreference> <cac:item> <cbc:description languageid="fi">hengenvaar/livsfara,,5 mm paksu</cbc:description> <cbc:name>varoituskilpi</cbc:name> <cbc:additionalinformation languageid="fi">varoituskilven tekstin oltava sekä suomeksi että ruotsiksi. </cbc:additionalinformation> <cac:buyersitemidentification> <cbc:id>zt203</cbc:id> </cac:buyersitemidentification> <cac:standarditemidentification> <cbc:id>645065</cbc:id> </cac:standarditemidentification> <cac:itemspecificationdocumentreference> <cbc:id>234/200</cbc:id> <cbc:documenttypecode listid="53" listagencyid="6">ask</cbc:documenttypecode> <cac:attachment> <cbc:embeddeddocumentbinaryobject>liitetiedosto binäärisenä suurena oliona </cbc:embeddeddocumentbinaryobject> <cac:externalreference> <cbc:uri> </cac:externalreference> </cac:attachment> 56/59