Sanomasuositus ja sen yleinen soveltamisohje Massaluettelo FI040, 200-06-30, v.00 Käyttö: Energiateollisuus Sanasto: UBL Versio: 2.0 Sanoma: Catalogue
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ä aineisto... 7 2.4 Huomioitavaa... 7 3 Massaluettelon toimitusprosessi... 8 3. Prosessin rajaus... 8 3.2 Prosessin osapuolet... 8 3.3 Prosessin vaiheet... 8 4 Sanoman tietosisältö... 2 5 Massaluettelosanoman rakenne... 6 5. Luokkamalli... 6 5.2 Tietojen suhde toisiinsa... 7 6 Sanoman määrittely... 20 6. Sanoman otsikkotaso... 20 6.. Massaluettelosanoma (Catalogue. Details)... 20 6..2 Viitetiedot (Catalogue. Referenced_ Contract. Contract)... 24 6..3 Viitteet (Contract. Contract_ Document Reference. Document Reference)... 26 6..4 Liitetiedosto (Document Reference. Attachment)... 28 6..5 Liitetiedoston web-osoite (Attachment. External Reference)... 29 6..6 Tilaaja tiedot (Catalogue. Provider_ Party. Party)... 30 6..7 Tilaajan tunniste (Party. Party Identification)... 32 6..8 Tilaajan nimi (Party. Party Name)... 33 6..9 Tilaajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact)... 34 6..0 Toimittajan tiedot (Catalogue. Receiver_ Party. Party)... 36 6.. Toimittajan tunniste (Party. Party Identification)... 38 6..2 Toimittajan nimi (Party. Party Name)... 40 6..3 Toimittajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact)... 4 6.2 Sanoman rivitaso... 42 6.2. Massaluettelorivin tiedot (Catalogue. Catalogue Line)... 42 6.2.2 Tuotteen kuvaus (Catalogue Line. Item)... 45 6.2.3 Tilaajan tuotekoodi eli nimike (Item. Buyers_ Item Identification. Item Identification)... 48
6.2.4 Sähköalan tuotekoodi eli nimike (Item. Standard_ Item Identification. Item Identification)... 49 6.2.5 Tuotteeseen liittyvät viitteet (Item. Item Specification_ Document Reference. Document Reference)... 50 6.2.6 Liitetiedosto (Document Reference. Attachment)... 52 6.2.7 Liitetiedoston web-osoite (Attachment. External Reference)... 53 7 Sanomaesimerkki... 54 7. UBL massaluetteloesimerkki... 54 8 Liite : Kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje... 58
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.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ö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
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
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
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ä aineisto 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 Catalogue-sanoman määrityksiin. Määrityksissä on huomioitu myös kansainvälisen NES (Northern European Subset) työryhmän suositukset. 7/59
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
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
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
Tarjouksen teko Toimittaja tekee tarjouksen käyttäen hyväksi massaluettelosanomalla saapuneita tietoja. Taulukko 3.3.: Massaluettelon toimitusprosessin osapuolikohtaiset vaiheet /59
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
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
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 6.2.3 V (R) 6.2.4 V (R) Tuotteen nimi Catalogue. Catalogue Line. Item 6.2.2 V (R) Tuotteen kuvaus (pitkä teksti) Catalogue. Catalogue Line. Item 6.2.2 V 4/59
Tuotteeseen liittyvää yleistietoa Catalogue. Catalogue Line. Item 6.2.2 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 6.2.5 V 6.2.5 V 6.2.5 V 6.2.5 V 6.2.6 V 6.2.7 V 5/59
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
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 5.2.2 massaluettelosanoman rivitason tietojen suhteet. 7/59
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
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
6 Sanoman määrittely 6. Sanoman otsikkotaso Sanoman otsikkotasolla välitetään koko dokumenttia koskevat tiedot, kuten dokumentin tunniste, päiväys, voimassaoloaika sekä osapuolitiedot. 6.. Massaluettelosanoma (Catalogue. Details) Catalogue. Details Catalogue. UBL Version Identifier. Identifier Catalogue. Customization Identifier. Identifier Catalogue. Profile Identifier. Identifier Catalogue. Identifier Catalogue. UUID. Identifier Catalogue. Name Catalogue. Issue Date. Date Catalogue. Issue Time. Time Catalogue. Revision Date. Date Catalogue. Revision Time. Time Catalogue. Note. Text Catalogue. Description. Text Catalogue. Version. Identifier Catalogue. Previous_ Version. Identifier Catalogue. Line Count. Numeric Catalogue. Validity_ Period. Period Catalogue. Referenced_ Contract. Contract Catalogue. Signature Catalogue. Provider_ Party. Party Catalogue. Receiver_ Party. Party Catalogue. Seller_ Supplier Party. Supplier Party Catalogue. Contractor_ Customer Party. Customer Party Catalogue. Trading Terms..* Catalogue. Catalogue Line Elementti / aggregaatti Catalogue. Details Catalogue. UBL Version Identifier. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki 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ä 20/59
Catalogue. Customization Identifier. Identifier Catalogue. Profile Identifier. Identifier Identification Scheme Agency. Identifier 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>200-583-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>200-06-8</cbc:issuedate> Time. Type 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ä. 2/59
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 Catalogue. Receiver_ Party. Party 6..0 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> Toisto.. Party. Details Aggregaatilla annetaan toimittajan eli massaluettelon vastaanottajaorganisaation nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:party> </cac:party> Catalogue. Catalogue Toisto.. unbounded 22/59
Line 6.2. Catalogue Line. Details Aggregaatilla annetaan ilmoitusrivin tiedot. Esimerkki <cac:catalogueline> </cac:catalogueline> 23/59
6..2 Viitetiedot (Catalogue. Referenced_ Contract. Contract) Catalogue. Referenced_ Contract. Contract Contract. Identifier Contract. Issue Date. Date Contract. Issue Time. Time Contract. Contract Type Code. Code Contract. Contract Type. Text Contract. Validity_ Period. Period Contract. Contract_ Document Reference. Document Reference 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
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
6..3 Viitteet (Contract. Contract_ Document Reference. Document Reference) Contract. Contract_ Document Reference. Document Reference Document Reference. Identifier Document Reference. Copy_ Indicator. Indicator Document Reference. UUID. Identifier Document Reference. Issue Date. Date Document Reference. Document Type Code. Code Document Reference. Document Type. Text Document Reference. XPath. Text Document Reference. Attachment Elementti / aggregaatti 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>52335-224/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
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
6..4 Liitetiedosto (Document Reference. Attachment) Document Reference. Attachment Attachment. Embedded_ Document. Binary Object Attachment. External Reference 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
6..5 Liitetiedoston web-osoite (Attachment. External Reference) Attachment. External Reference External Reference. URI. Identifier External Reference. Document Hash. Text External Reference. Expiry Date. Date External Reference. Expiry Time. Time 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>www.esimerkit.com/tuoteluettelo/200</cbc:uri> 29/59
6..6 Tilaaja tiedot (Catalogue. Provider_ Party. Party) Catalogue. Provider_ Party. Party Party. Mark Care_ Indicator. Indicator Party. Mark Attention_ Indicator. Indicator Party. Website_ URI. Identifier Party. Logo Reference. Identifier Party. Endpoint Identifier. Identifier Party. Party Identification Party. Party Name Party. Language Party. Postal_ Address. Address Party. Physical_ Location. Location Party. Party Tax Scheme Party. Party Legal Entity Party. Contact Party. Person Party. Agent_ Party. Party Elementti / aggregaatti Catalogue. 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
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
6..7 Tilaajan tunniste (Party. Party Identification) Party. Party Identification Party Identification. Identifier Elementti / aggregaatti Party. Party Identification Party Identification. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan tilaajan 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"> 003702345672345</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
6..8 Tilaajan nimi (Party. Party Name) Party. Party Name Party Name. Name Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Party. Party Name Toisto 0.. unbounded Party Name. Details Aggregaatilla annetaan tilaajan 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
6..9 Tilaajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Party. Contact Contact. Identifier Contact. Name Contact. Telephone. Text Contact. Telefax. Text Contact. Electronic_ Mail. Text Contact. Note. Text Contact. Other_ Communication. Communication Elementti / aggregaatti Party. Contact 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>03 234 5678<cbc:Telephone> Text. Type Elementillä annetaan tilaajan eli massaluettelon lähettäjäorganisaation yhteyshenkilön tai -osaston 34/59
sähköpostiosoite. Esimerkki <cbc:electronicmail>timo.tilaaja@sahko.fi<cbc:electronicmail> 35/59
6..0 Toimittajan tiedot (Catalogue. Receiver_ Party. Party) Catalogue. Receiver_ Party. Party Party. Mark Care_ Indicator. Indicator Party. Mark Attention_ Indicator. Indicator Party. Website_ URI. Identifier Party. Logo Reference. Identifier Party. Endpoint Identifier. Identifier Party. Party Identification Party. Party Name Party. Language Party. Postal_ Address. Address Party. Physical_ Location. Location Party. Party Tax Scheme Party. Party Legal Entity Party. Contact Party. Person Party. Agent_ Party. Party Elementti / aggregaatti Catalogue. 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
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
6.. Toimittajan tunniste (Party. Party Identification) Party. Party Identification Party Identification. Identifier Elementti / aggregaatti Party. Party Identification Party Identification. Identifier Identification Scheme. Identifier Identification Scheme Agency. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan toimittajan 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"> 003723232</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
92 (Assigned by buyer or buyer's agent) Tilaajan ylläpitämä luettelo 39/59
6..2 Toimittajan nimi (Party. Party Name) Party. Party Name Party Name. Name Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Party. Party Name Toisto 0.. unbounded Party Name. Details Aggregaatilla annetaan toimittajan 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
6..3 Toimittajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Party. Contact Contact. Identifier Contact. Name Contact. Telephone. Text Contact. Telefax. Text Contact. Electronic_ Mail. Text Contact. Note. Text Contact. Other_ Communication. Communication Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Party. Contact 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
6.2 Sanoman rivitaso Sanoman rivitasolla välitetään tavaraan koskevat tiedot, kuten tuotekoodi, tuotteen kuvaus ja määrätiedot. 6.2. Massaluettelorivin tiedot (Catalogue. Catalogue Line) Catalogue. Catalogue Line Catalogue Line. Identifier Catalogue Line. Action Code. Code Catalogue Line. Life Cycle Status Code. Code Catalogue Line. Contract Subdivision. Text Catalogue Line. Note. Text Catalogue Line. Orderable_ Indicator. Indicator Catalogue Line. Orderable_ Unit. Text Catalogue Line. Content Unit. Quantity Catalogue Line. Order Quantity Increment. Numeric Catalogue Line. Minimum_ Order Quantity. Quantity Catalogue Line. Maximum_ Order Quantity. Quantity Catalogue Line. Warranty_ Information. Text Catalogue Line. Pack Level Code. Code Catalogue Line. Contractor_ Customer Party. Customer Party Catalogue Line. Seller_ Supplier Party. Supplier Party Catalogue Line. Warranty_ Party. Party Catalogue Line. Warranty Validity_ Period. Period Catalogue Line. Line Validity_ Period. Period Catalogue Line. Item Comparison Catalogue Line. Component_ Related Item. Related Item Catalogue Line. Accessory_ Related Item. Related Item Catalogue Line. Required_ Related Item. Related Item Catalogue Line. Replacement_ Related Item. Related Item Catalogue Line. Complementary_ Related Item. Related Item Catalogue Line. Required_ Item Location Quantity. Item Location Quantity Catalogue Line. Document Reference Catalogue Line. Item 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
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
Catalogue Line. Item 6.2.2 TNE (Tonne) Tonni Toisto.. Item. Details Aggregaatilla annetaan tuotteen kuvaustiedot, kuten nimi ja tuotekoodi. Esimerkki <cac:item> </cac:item> 44/59
6.2.2 Tuotteen kuvaus (Catalogue Line. Item) Catalogue Line. Item Item. Description. Text Item. Pack Quantity. Quantity Item. Pack Size. Numeric Item. Catalogue_ Indicator. Indicator Item. Name Item. Hazardous Risk_ Indicator. Indicator Item. Additional_ Information. Text Item. Keyword. Text Item. Brand Name. Name Item. Model Name. Name Item. Buyers_ Item Identification. Item Identification Item. Sellers_ Item Identification. Item Identification Item. Manufacturers_ Item Identification. Item Identification Item. Standard_ Item Identification. Item Identification Item. Catalogue_ Item Identification. Item Identification Item. Additional_ Item Identification. Item Identification Item. Catalogue_ Document Reference. Document Reference Item. Item Specification_ Document Reference. Document Reference Item. Origin_ Country. Country Item. Commodity Classification Item. Transaction Conditions Item. Hazardous Item Item. Classified_ Tax Category. Tax Category Item. Additional_ Item Property. Item Property Item. Manufacturer_ Party. Party Item. Information Content Provider_ Party. Party Item. Origin_ Address. Address Item. Item Instance 45/59
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
Item. Buyers_ Item Identification. Item Identification 6.2.3 Item. Standard_ Item Identification. Item Identification 6.2.4 Item. Item Specification_ Document Reference. Document Reference 6.2.5 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
6.2.3 Tilaajan tuotekoodi eli nimike (Item. Buyers_ Item Identification. Item Identification) Item. Buyers_ Item Identification. Item Identification Item Identification. Identifier Item Identification. Extended_ Identifier. Identifier Item Identification. Physical Attribute Item Identification. Measurement_ Dimension. Dimension Item Identification. Issuer_ Party. Party Elementti / aggregaatti Item. Buyers_ Item Identification. Item Identification Item Identification. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki 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
6.2.4 Sähköalan tuotekoodi eli nimike (Item. Standard_ Item Identification. Item Identification) Item. Standard_ Item Identification. Item Identification Item Identification. Identifier Item Identification. Extended_ Identifier. Identifier Item Identification. Physical Attribute Item Identification. Measurement_ Dimension. Dimension Item Identification. Issuer_ Party. Party Elementti / aggregaatti Item. Standard_ Item Identification. Item Identification Item Identification. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki 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
6.2.5 Tuotteeseen liittyvät viitteet (Item. Item Specification_ Document Reference. Document Reference) Item. Item Specification_ Document Reference. Document Reference Document Reference. Identifier Document Reference. Copy_ Indicator. Indicator Document Reference. UUID. Identifier Document Reference. Issue Date. Date Document Reference. Document Type Code. Code Document Reference. Document Type. Text Document Reference. XPath. Text Document Reference. Attachment Elementti / aggregaatti Item. Item Specification_ Document Reference. Document Reference Document Reference. Identifier Document Reference. Document Type Code. Code Toistokerrat, tyyppi, kuvaus, esimerkki Toisto Esimerkki Toisto.. 0.. 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
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 6.2.6 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