Toteutumatieto - Toimitusluettelo

Transkriptio

1 Sanomasuositus ja sen yleinen soveltamisohje Toteutumatieto - Toimitusluettelo FI034, , v.00 Käyttö: Energiateollisuus Sanasto: UBL Versio: 2.0 Sanoma: DespatchAdvice

2 Sisällysluettelo Sanoma ja sen soveltamisala Sanoman käyttötarkoitus ja soveltamisen rajaus Soveltamisohjeen sisältö Työryhmän työskentelyyn osallistuneet Dokumentti ja sen yhteydet muihin dokumentteihin Päivitykset Esitietovaatimukset Aiheeseen liittyvää aineistoa Huomioitavaa Pientyön, projektin ja mittaroinnin tehtävien suoritusprosessi Prosessin rajaus Prosessin osapuolet Prosessin vaiheet Sanoman tietosisältö Työn alla / valmis -ilmoitussanoman rakenne Luokkamalli Tietojen suhde toisiinsa Sanoman määrittely Sanoman otsikkotaso Hankkeen toteutumatieto- ja toimitusluettelosanoma (Despatch Advice. Details) Tilauksen tiedot (Despatch Advice. Order Reference) Muut viitteet (Despatch Advice. Additional_ Document Reference. Document Reference) Toimittajan tiedot (Despatch Advice. Despatch_ Supplier Party. Supplier Party) Toimittaja (Supplier Party. Party) Toimittajan tunniste (Party. Party Identification) Toimittajan nimi (Party. Party Name) Sanoman kuittaaja eli toimittajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Tilaajan tiedot (Despatch Advice. Delivery_ Customer Party. Customer Party) Tilaaja (Customer Party. Party) Tilaajan tunniste (Party. Party Identification) Tilaajan nimi (Party. Party Name) Sanoman rivitaso Toteutumatieto- ja toimitusluettelosanoman rivin tiedot (Despatch Advice. Despatch Line)... 39

3 6.2.2 Rivin viitteet (Despatch Line. Document Reference) Tuotteen tiedot (Despatch Line. Item) Tilaajan tuotekoodi eli nimike (Item. Buyers_ Item Identification. Item Identification) Sähköalan tuotekoodi eli nimike (Item. Standard_ Item Identification. Item Identification) Tuotteen toimittamistiedot (Despatch Line. Shipment) Toimitustiedot (Shipment. Consignment) Tuotteen arvotiedot (Shipment. Goods Item) Tuotteen hintatiedot (Goods Item. Invoice Line) Rivin verotiedot (Invoice Line. Tax Total) Rivin verokantakohtaiset tiedot (Tax Total. Tax Subtotal) Rivin verokohtelutiedot (Tax Subtotal. Tax Category) Veroerittelyn verolajitiedot (Tax Category. Tax Scheme) Tuotteen hintatiedot (Invoice Line. Price) Sanomaesimerkki UBL-Toteumatieto-Toimitustieto-sanomaesimerkki Liite : Kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje... 68

4 Sanoma ja sen soveltamisala. Sanoman käyttötarkoitus ja soveltamisen rajaus Tämä dokumentti sisältää UBL 2.0 -versioon perustuvan DespatchAdvice 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 raportoitaessa hankkeessa käytettyjen materiaalien ja toteutuneiden työtuntien määriä. Soveltamisohjeen määrittelemää toteutumatieto toimitusluettelo - sanomaa voidaan käyttää normaalissa, kertaluonteisessa tai sopimuspohjaisessa toiminnossa. Samaan hankkeeseen voidaan lähettää useita toteutumatieto toimitusluettelo sanomia. 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..2 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 Toteutumatieto - toimitusluettelo sanoman välitysprosessi esitetään tämän dokumentin tietosisällön ja sovellusohjeen pohjana oleva Toteutumatieto - toimitusluettelo sanoman välitysprosessi, sen osapuolet ja vaiheet. Kappaleessa 4 Sanoman tietosisältö on esitetty Toteutumatieto - toimitusluettelo sanomassa välitettävien tietojen luettelo. 4/68

5 Kappaleessa 5 " Toteutumatieto - toimitusluettelo sanoman rakenne on esitetty tämän UBL- DespatchAdvice-sanoman luokkamalli käyttäen hyväksi UML-kuvauskieltä sekä UBLsanoman elementtinimillä että niiden sisältämien tietojen nimillä esitettynä. Kappaleessa 6 Sanoman määrittely on esitelty otsikkotason ja rivitason rakenne, käytettävät aggregaatit, elementit, attribuutit ja koodit sekä niiden käyttötarkoitus. Kappaleessa 7 Sanomaesimerkki on esitetty esimerkki UBL-DespatchAdvice-sanoman Toteutumatieto - toimitusluettelo sanoman käytöstä. Liitteessä on esitetty kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje.. 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 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 5/68

6 Logica Suomi Oy Oy Mercus Software Oy STUL Suomen Energia Urakointi Oy Tekla Oy Tieto Oy Vattenfall Verkko Oy Visma Software Oy Voimatel Oy Hannu Salonen Valeri Tiik Arto Kari Esa Tiainen Ari Ala-Sippola Taisto Lehonmaa Jukka Pulkkinen Heli Siponen Lauri Anttila Martti Mäkiranta Antti Sulin Vesa Hänninen Olli Lautiainen Markku Manninen Taulukko.3.: Sähkönjakeluyhtiöiden ja palveluntuottajayhtiöiden tietojärjestelmien yhteensopivuus projektin työryhmätyöskentelyyn osallistuneet 6/68

7 2 Dokumentti ja sen yhteydet muihin dokumentteihin 2. Päivitykset Pvm/Laatija Versio Kommentit/muutokset Heikki Laaksamo.00 Ensimmäinen versio 2.2 Esitietovaatimukset Soveltamisohje on tarkoitettu sekä johto- että asiantuntijatason käyttöön. Soveltamisohjeen teknisen taustan ymmärtämistä tukee seuraavien aihealueiden tuntemus: XML, UBL ja ebxml ydinkomponentit. 2.3 Aiheeseen liittyvää aineistoa w3schools XML Tutorial ( ) ebxml Core Components Technical Specification (CCTS) 2.0 ( ) Universal Business Language 2.0 ( NES työryhmän tekemät soveltamisohjeet ( ) United Nations Directories for Electronic Data Interchange for Administration, Commerce and Transport ( ) UN/CEFACT Recommendations ( ) 2.4 Huomioitavaa Soveltamisohje perustuu UBL 2.0 DespatchAdvice-sanoman määrityksiin. Määrityksissä on noudatettu myös kansainvälisen NES työryhmän suosituksia sanomien tietosisällön ja käytön osalta soveltaen näitä suomalaisen kiinteistöalan tarpeisiin. 7/68

8 3 Pientyön, projektin ja mittaroinnin tehtävien suoritusprosessi 3. Prosessin rajaus Tässä prosessikuvauksessa on tarkasteltu ainoastaan hankkeessa käytettyjen materiaalien ja toteutuneiden työtuntien raportointiprosessia, jonka ilmoittamiseen tämän dokumentin määrittelemää DespatchAdvice-sanomaa voidaan käyttää. Tarkastelussa oletetaan, että ilmoitus välitetään raportointiprosessissa sähköisesti osapuolten välillä. Tarkastelusta on jätetty pois toteutumatietojen tai toimitusluettelon lähettämistä edeltävät vaiheet, kuten tilauksen ja sen vastaanottokuittauksen lähetys ja käsittely sekä varsinainen hankkeen toteuttaminen. Myös toteutumatietojen ja toimitusluettelon lähetyksen jälkeiset vaiheet, kuten laskutus ja maksatus, ovat rajattu tämän tarkastelun ulkopuolelle. 3.2 Prosessin osapuolet Seuraavassa taulukossa on esitetty tämän prosessin osapuolet. Osapuoli Toimittaja Tilaaja Rooli Osapuoli, joka saattaa valmiiksi pientyön, projektin ja mittaroinnin tilauksen määrittelemät tehtävät. Osapuoli, joka tekee ilmoitukset hankkeessa käytetyistä materiaaleista ja toteutuneista työtunneista. Osapuoli, joka lähettää ilmoitukset hankkeessa käytetyistä materiaaleista ja toteutuneista työtunneista. Osapuoli, joka on tilannut pientyön, projektin tai mittaroinnin. Osapuoli, joka vastaanottaa ilmoitukset hankkeessa käytetyistä materiaaleista ja toteutuneista työtunneista. Osapuoli, joka vastaanottaa ilmoitukset hankkeessa käytetyistä materiaaleista ja toteutuneista työtunneista. Taulukko 3.2.: Hankkeen toteutumatietojen ja toimitusluettelon välityksen osapuolet 3.3 Prosessin vaiheet Kuviossa 3.3. on esitetty hankkeen toteutumatietojen ja toimitusluettelon välityksen vaiheet eroteltuna kohdassa 3.2 esitettyjen osapuolien toimintojen mukaan. 8/68

9 Toimittaja Tilaaja Luodaan toimitustietosanoma Vastaanotetaan automaattinen vastaanoton kuittaussanoma Käsitellään automaattinen vastaanoton kuittaussanoma Lähetetään toimitustietosanoma Toimitustietosanoma Automaattinen vastaanoton kuittaussanoma Vastaanotetaan toimitustietosanoma Luodaan automaattinen vastaanoton kuittaussanoma Lähetetään automaattinen vastaanoton kuittaussanoma Käsitellään toimitustietosanoma Toimitustietosanoma hyväksytään Toimitustietosanoma hylätään Vastaanotetaan sovellustason kuittaussanoma Käsitellään sovellustason kuittaussanoma Sovellustason kuittaussanoma Luodaan sovellustason kuittaussanoma Lähetetään sovellustason kuittaussanoma Kuvio 3.3.: Hankkeen toteutumatietojen ja toimitusluettelon välityksen vaiheet 9/68

10 Seuraavassa taulukossa on selitetty kuviossa 3.3. esitetyn hankkeen toteutumatietojen ja toimitusluettelon välityksen vaiheet jaoteltuna osapuolten hoitamien toimintojen mukaan. Osapuoli Toiminta Toimittaja Tilaaja Luodaan toimitustietosanoman Lähetetään toimitustietosanoma Vastaanotetaan automaattinen vastaanoton kuittaussanoma Käsitellään automaattinen vastaanoton kuittaussanoma Vastaanotetaan sovellustason kuittaussanoma Käsitellään sovellustason kuittaussanoma Vastaanotetaan toimitustietosanoma Luodaan automaattinen vastaanoton kuittaussanoma Lähetetään automaattinen vastaanoton kuittaussanoma Käsitellään toimitustietosanoma Toimittaja luo toimitustietosanoman omissa tietojärjestelmissään. Toimittaja lähettää toimitustietosanoman sähköisesti tilaajalle. Toimittaja vastaanottaa toimitustietosanoman vastaanoton automaattisen kuittaussanoman tilaajalta. Toimittaja käsittelee toimitustietosanoman vastaanoton automaattisen kuittaussanoman omissa tietojärjestelmissään. Toimittaja vastaanottaa toimitustietosanoman vastaanoton sovellustason kuittaussanoman tilaajalta. Toimittaja käsittelee toimitustietosanoman vastaanoton sovellustason kuittaussanoman omissa tietojärjestelmissään. Tilaaja vastaanottaa toimitustietosanoman toimittajalta. Tilaaja luo toimitustietosanoman automaattisen vastaanoton kuittaussanoman omissa tietojärjestelmissään. Tilaaja lähettää toimitustietosanoman automaattisen vastaanoton kuittaussanoman toimittajalle. Tilaaja käsittelee toimitustietosanoman omissa tietojärjestelmissään. Käsittelyn tuloksena toimitustietosanoma 0/68

11 hyväksytään hylätään Luodaan sovellustason kuittaussanoma Lähetetään sovellustason kuittaussanoma Tilaaja luo toimitustietosanoman sovellustason kuittaussanoman omissa tietojärjestelmissään, jolla tilaaja ilmoittaa toimitustietosanoman hyväksymisestä tai hylkäyksestä. Tilaaja lähettää toimitustietosanoman sovellustason kuittaussanoman toimittajalle. Taulukko 3.3.: Hankkeen toteutumatietojen ja toimitusluettelon välityksen määrittelemien tehtävien suoritusprosessin osapuolikohtaiset vaiheet /68

12 4 Sanoman tietosisältö Seuraavassa taulukossa on esitetty hankkeen toteutumatieto- ja toimitusluettelosanoman 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 pientyön, projektin ja mittaroinnin toteutumatietojen 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/68

13 Tieto Aggregaatti Kappale P/V Sanoman versio Despatch Advice 6.. P Soveltamisohjeen kehittäjä Despatch Advice 6.. P Soveltamisohjeen tunnus Despatch Advice 6.. P Toimitustietosanoman tunnus Despatch Advice 6.. P Päivämäärä Despatch Advice 6.. P Kellonaika Despatch Advice 6.. V Tieto laskutusvalmiudesta Despatch Advice 6.. V Toimitustietosanoman tyyppi Despatch Advice 6.. V Yleistä tietoa Despatch Advice 6.. V Viitteet Tilausnumero Despatch Advice. Order Reference 6..2 P Sopimusnumero Hinnaston tunnus Despatch Advice. Additional_ Document Reference. Document Reference Despatch Advice. Additional_ Document Reference. Document Reference Toimittajan tiedot V 6..3 V Tunnus (OVT) Despatch Advice. Despatch_ Supplier Party. Supplier Party. Party. Party Identification 6..6 P 3/68

14 Nimi Despatch Advice. Despatch_ Supplier Party. Supplier Party. Party. Party Name 6..7 V Ilmoittaja eli yhteyshenkilö Despatch Advice. Despatch_ Supplier Party. Supplier Party. Party. Contact 6..8 V Yhteysosasto Despatch Advice. Despatch_ Supplier Party. Supplier Party. Party. Contact 6..8 V Puhelinnumero Despatch Advice. Despatch_ Supplier Party. Supplier Party. Party. Contact 6..8 V Sähköpostiosoite Despatch Advice. Despatch_ Supplier Party. Supplier Party. Party. Contact 6..8 V Tilaajan tiedot 6..9 Tunnus (OVT) Nimi Rivin tiedot Despatch Advice. Delivery_ Customer Party. Customer Party. Party. Party Identification Despatch Advice. Delivery_ Customer Party. Customer Party. Party. Party Name 6.. P 6..2 V Rivin tunnus Despatch Advice. Despatch Line 6.2. P Riviin liittyvää yleistietoa Despatch Advice. Despatch Line 6.2. V Työtunnit Despatch Advice. Despatch Line 6.2. V Tuotekoodi Sähköalan tuotekoodi Despatch Advice. Despatch Line. Item. Buyers_ Item Identification. Item Identification Despatch Advice. Despatch Line. Item. Standard_ Item Identification. Item Identification V V Tuotteen nimi Despatch Advice. Despatch Line. Item V Määrä Despatch Advice. Despatch Line 6.2. V 4/68

15 Määrän yksikkö Despatch Advice. Despatch Line 6.2. V Hintatiedot Yksikköhinta Hinnan valuutta Yksikköhinnan perustearvo Hinnan määräytymisperuste (sopimushinta, hinnastohinta) Hinnan typpi (verollinen tai veroton brutto- tai nettohinta) Despatch Advice. Despatch Line. Shipment. Goods Item. Invoice Line. Price Despatch Advice. Despatch Line. Shipment. Goods Item. Invoice Line. Price Despatch Advice. Despatch Line. Shipment. Goods Item. Invoice Line. Price Despatch Advice. Despatch Line. Shipment. Goods Item. Invoice Line. Price Despatch Advice. Despatch Line. Shipment. Goods Item. Invoice Line. Price V V V V V Veroton nettohinta Despatch Advice. Despatch Line. Shipment. Goods Item. Invoice Line V Verokohtelu Veroprosentti Verolaji Verolaijikohtainen vero Verojen yhteissumma Despatch Advice. Despatch Line. Shipment. Goods Item. Invoice Line. Tax Total. Tax Subtotal. Tax Category Despatch Advice. Despatch Line. Shipment. Goods Item. Invoice Line. Tax Total. Tax Subtotal. Tax Category Despatch Advice. Despatch Line. Shipment. Goods Item. Invoice Line. Tax Total. Tax Subtotal. Tax Category. Tax Scheme Despatch Advice. Despatch Line. Shipment. Goods Item. Invoice Line. Tax Total. Tax Subtotal Despatch Advice. Despatch Line. Shipment. Goods Item. Invoice Line. Tax Total 5/ V V V 6.2. V V

16 Rivin viitteet Kustannuspaikka Despatch Advice. Despatch Line. Document Reference V Päärivin numero Despatch Advice. Despatch Line. Document Reference V Taulukko 4.: Hankkeen toteutumatieto- ja toimitusluettelosanoman tietosisältö ja sijaintiaggregaatit 6/68

17 5 Työn alla / valmis -ilmoitussanoman rakenne 5. Luokkamalli Tässä kappaleessa esitetään UBL 2.0 DespatchAdvice-sanoman rakenne käyttäen hyväksi UML-luokkamallia. Mallissa on esitetty sanoma vain niiltä osin kuin sen tietosisältö on määritelty Energiateollisuus ry:n organisoimassa projektissa Sähkönjakeluyhtiöiden ja palveluntuottajayhtiöiden tietojärjestelmien yhteensopivuus. Kuviossa 5.. on esitetty hankkeen toteutumatieto- ja toimitusluettelosanoman otsikkotason luokkamalli ja kuviossa 5..2 hankkeen toteutumatieto- ja toimitusluettelosanoman rivitason luokkamalli. PartyIdentification -ID..* DespatchLine -ID -Note -DeliveredQuantity DespatchAdvice -UBLVersionID -CustomizationID -ProfileID -ID -IssueDate -IssueTime -DocumentStatusCode -DespatchAdviceTypeCode -Note -ID OrderReference +Delivery +Despatch CustomerParty +Additional DocumentReference -ID -DocumentTypeCode -DocumentType SupplierParty Party Contact -ID -Name -Telephone -ElectronicMail PartyName -Name Kuvio 5..: Hankkeen toteutumatieto- ja toimitusluettelosanoman otsikkotason luokkamalli 7/68

18 DocumentReference -ID -DocumentTypeCode -DocumentType Shipment -ID -ID -Note -DeliveredQuantity Consignment -ID DespatchLine +Buyers Item -Description -Name ItemIdentification -ID +Standard GoodsItem -ID InvoiceLine -ID -LineExtensionAmount TaxTotal TaxSubtotal -TaxAmount -TaxableAmount -TaxAmount TaxCategory -ID -Percent Price -PriceAmount -BaseQuantity -PriceTypeCode -PriceType TaxScheme -ID Kuvio 5..2: Hankkeen toteutumatieto- ja toimitusluettelosanoman rivitason luokkamalli 5.2 Tietojen suhde toisiinsa Tässä luvussa esitetään sanoman tietojen suhteet toisiinsa käyttäen UML-luokkamallia. 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 hankkeen toteutumatieto- ja toimitusluettelosanoman otsikkotason tietojen suhde toisiinsa nähden ja kuviossa on esitetty rivitason tietojen suhde toisiinsa nähden. 8/68

19 Tunnustiedot -Tunnus..* Ilmoituksen rivi -Rivin tunnus -Yleistä tietoa -Toimitettu määrä -UBL Version numero -Sovellusohjeen kehittäjä -Sovellusohjeen tunnus -Sanoman tunnus -Sanoman päivämäärä -Sanoman kellonaika -Laskutusvalmius -Sanoman tyyppi -Yleistä tietoa Tilaus -Tunnus Työn alla / valmis -ilmoitus Viitetiedot +Muu viite -Tunnus -Viitteen tyyppikoodi -Viitteen tyyppi Tilaaja Toimittaja Osapuolitiedot Yhteystiedot -Tunnus -Nimi -Puhelin -Sähköposti Nimitiedot -Nimi Kuvio 5.2.: Hankkeen toteutumatieto- ja toimitusluettelosanoman tietojen suhteet otsikkotasolla Viitetiedot -Tunnus -Viitteen tyyppikoodi -Viitteen tyyppi Ilmoituksen rivi -Rivin tunnus -Yleistä tietoa -Toimitettu määrä Tuotteen toimittamistiedot -Tunnus Tehtävän tiedot -Tuotteen kuvaus -Tuotenimi Toimitustiedot -Tunnus +Tilaajan Nimiketiedot -Tunnus +Sähköalan Tuotteen arvotiedot -Tuotetunnus Tuotteen hintatiedot -Rivin tunnus -Veroton nettohinta Veroerittely -Verojen kokonaismäärä Verokantakohtaiset tiedot -Veron perustearvo -Veron määrä Verotustiedot -Verokohtelu -Veroprosentti Hintatiedot -Yksikköhinta -Hinnan peruste -määräytymisperuste -Hinnan tyyppi Verolajitiedot -Verolaji Kuvio 5.2.2: Hankkeen toteutumatieto- ja toimitusluettelosanoman tietojen suhteet rivitasolla 9/68

20 6 Sanoman määrittely Tässä kappaleessa on esitelty UBL- DespatchAdvice Toteumatieto Toimitusluettelosanoman 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 taukoiden 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 sekä osapuolitiedot. 6.. Hankkeen toteutumatieto- ja toimitusluettelosanoma (Despatch Advice. Details)..* Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Despatch Advice. Details Toisto 0.. Tällä aggregaatilla annetaan hankkeen toteutumatieto- ja toimitusluettelosanoman tiedot. 20/68

21 Despatch Advice. UBL Version Identifier. Identifier Despatch Advice. Customization Identifier. Identifier Despatch Advice. Profile Identifier. Identifier Identification Scheme Agency. Identifier Esimerkki <DespatchAdvice> </DespatchAdvice> Toisto 0.. Identifier. Type UBL version numero. Tämän sanoman rakenne ja tämä soveltamisohje perustuvat UBL versioon 2.0. Täten tämä elementti saa vakiosti arvon "2.0". Esimerkki <cbc:ublversionid>2.0</cbc:ublversionid> Toisto 0.. Identifier. Type Elementillä annetaan sanoman soveltamisohjeen kehittäjän nimi. Esimerkki <cbc:customizationid>et</cbc:customizationid> Toisto 0.. Identifier. Type TIEKE ry:n soveltamisohjeelle antama tunnus, joka on vakiosti FI034 Attribuutit schemeagencyid Esimerkki <cbc:profileid schemeagencyid="292">fi034 Toisto 0.. </cbc:profileid> Attribuutilla annetaan soveltamisohjeluettelon ylläpitäjän tunnus. Esimerkki schemeagencyid="292" Käytettävät koodit Despatch Advice. Identifier Toisto.. Despatch Advice. Issue Date. Date 292 (FI, TIEKE The Information Technology Development Centre of Finland) TIEKE Tietoyhteiskunnan kehittämiskeskus ry Identifier. Type Hankkeen toteutumatieto- ja toimitusluettelosanoman yksilöivä tunnus, jolla sanoma tunnistetaan myöhemmin. Esimerkki <cbc:id>7255-0/c</cbc:id> Toisto.. Date. Type Elementillä annetaan toteutumatieto- ja toimitusluettelosanoman päivämäärä. On suositeltavaa, että päivämäärä on sama, jonka sanoman sisällöstä vastaava henkilö voi nähdä järjestelmästään sanoman tekopäivämääränä, eikä sanoman 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> 2/68

22 Despatch Advice. Issue Time. Time Despatch Advice. Document Status Code. Code Toisto 0.. Time. Type Elementillä annetaan toteutumatieto- ja toimitusluettelosanoman luontikelloaika, siis luontihetken tunnit, minuutit ja sekunnit. On suositeltavaa, että ajanhetki on sama, jonka sanoman sisällöstä vastaava henkilö voi nähdä järjestelmästään sanoman tekoajanhetkenä, eikä sanoman 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>08:45:03</cbc:issuetime> Toisto 0.. Koodit Code. Type Elementillä annetaan tieto, että kyseiseen hankkeeseen tai sen osaan ei tule enää Toteumatieto-Toimitusluettelo-sanomia ja hankkeeseen tai sen osaan liittyvä lasku voidaan muodostaa. UN/ECE koodiston 225 mukaisia koodeja ovat: 22 = (Final transmission) Viimeinen sanoma Attribuutit listid ja listagencyid Code List. Identifier Toisto 0.. Code List. Agency. Identifier Esimerkki <cbc:documentstatuscode listid= UN/ECE 225" Vakioarvo UN/ECE 225 listagencyid="6">22</cbc:documentstatuscode> Attribuutilla annetaan sanoman tilakoodiston tunnus. Esimerkki listid="un/ece 225" Käytettävät koodit UN/ECE 225 UN/ECE koodisto 225 "Message function code" Toisto 0.. Vakioarvo 6 Attribuutilla annetaan dokumenttityyppikoodiston ylläpitäjän tunnus. Esimerkki listagencyid="6" Käytettävät koodit 22/68

23 Despatch Advice. Despatch Advice Type Code. Code 6 UN/ECE (United Nations - Economic Commission for Europe) Toisto 0.. Code. Type Elementillä annetaan toteutumatieto- ja toimitusluettelosanoman tyyppi, jolla ilmoitetaan sanoman rooli. Koodit UN/ECE koodiston 00 mukaisia koodeja ovat: 35 = (Despatch Advice) Toimitusluettelo Attribuutit listid ja listagencyid Code List. Identifier Toisto 0.. Code List. Agency. Identifier Despatch Advice. Note. Text Esimerkki <cbc:despatchadvicetypecode listid= UN/ECE 00" Vakioarvo UN/ECE 00 listagencyid="6">35</cbc:despatchadvicetypecode> Attribuutilla annetaan dokumenttityyppikoodiston tunnus. Esimerkki listid="un/ece 00" Käytettävät koodit UN/ECE 00 UN/ECE koodisto 00 "Document name code" Toisto 0.. Vakioarvo 6 Attribuutilla annetaan dokumenttityyppikoodiston ylläpitäjän tunnus. Esimerkki listagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Toisto Europe) 0.. unbounded Text. Type Elementillä annetaan toteutumatieto- ja toimitusluettelo- sanomaan liittyvää yleistä tietoa, jota ei voida antaa DespatchAdvice-sanoman muiden elementtien arvona. Huomautus Vain yksi elementin toisto kieltä kohden. Attribuutit languageid Language. Identifier Toisto 0.. Despatch Advice. Order Reference Esimerkki <cbc:note languageid="fi">lisäys aiemmin lähetettyyn sanomaan.</cbc:note> Toimitusluettelon vapaamuotoisen tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla. Esimerkki languageid="fi" Toisto 0.. unbounded Order Reference. Details 23/68

24 6..2 Tällä aggregaatilla annetaan sen tilauksen tunnistetiedot, Despatch Advice. Additional_ Document Reference. Document Reference 6..3 Despatch Advice. Despatch_ Supplier Party. Supplier Party 6..4 Despatch Advice. Delivery_ Customer Party. Customer Party 6..9 Despatch Advice. Despatch Line 6.2. johon tämä toteutumatieto- ja toimitusluettelosanoman liittyy. Esimerkki <cac:orderreference> </cac:orderreference> Toisto 0.. unbounded Document Reference. Details Aggregaatilla annetaan toteutumatieto- ja toimitusluettelo- sanomaan liittyviä muita viitteitä kuin tilaus. Esimerkki <cac:additionaldocumentreference> Toisto.. </cac:additionaldocumentreference> Supplier Party. Details Aggregaatilla annetaan toimittajaorganisaation tiedot eli osapuolen, joka on toteuttanut tilauksen tehtävät. Esimerkki <cac:despatchsupplierparty> </cac:despatchsupplierparty> Toisto.. Customer Party. Details Aggregaatilla annetaan tilaajaorganisaation tiedot. Esimerkki <cac:deliverycustomerparty> </cac:deliverycustomerparty> Toisto.. unbounded Despatch Line. Details Aggregaatilla annetaan toteutumatieto- ja toimitusluettelo- sanoman rivitason tiedot. Esimerkki <cac:despatchline> </cac:despatchline> 24/68

25 6..2 Tilauksen tiedot (Despatch Advice. Order Reference) Elementti / aggregaatti Despatch Advice. Order Reference Toistokerrat, tyyppi, kuvaus, esimerkki Toisto Order Reference. Identifier Toisto unbounded Order Reference. Details Tällä aggregaatilla annetaan sen tilauksen tunnistetiedot, johon tämä toteutumatieto- ja toimitusluettelosanoman liittyy. Esimerkki <cac:orderreference> </cac:orderreference> Identifier. Type Elementillä annetaan sen tilauksen tunnus, johon tämä toteutumatieto- ja toimitusluettelosanoma liittyy. Esimerkki <cbc:id>234-ab</cbc:id> 25/68

26 6..3 Muut viitteet (Despatch Advice. Additional_ Document Reference. Document Reference) Elementti / aggregaatti Despatch Advice. Additional_ 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 toteutumatieto- ja toimitusluettelo- sanomaan liittyviä muita viitteitä kuin tilaus. Esimerkki <cac:additionaldocumentreference> Toisto.. </cac:additionaldocumentreference> Identifier. Type Elementillä annetaan toteutumatieto- ja toimitusluettelosanoman viitteen tunnus. Esimerkki <cbc:id>4634-ac</cbc:id> Toisto 0.. Code. Type Elementillä annetaan toteutumatieto- ja toimitusluettelosanoman 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: 9 = (Price/sales catalogue) Hinnasto 35 = (Contract) Sopimus Attribuutit listid ja listagencyid Code List. Identifier Toisto 0.. Esimerkki <cbc:documenttypecode listid= UN/ECE 00" listagencyid="6">35</cbc:documenttypecode> 26/68

27 Code List. Agency. Identifier Document Reference. Document Type. Text Attribuutilla annetaan dokumenttitunnuskoodiston tunnus; joko UN/ECE 00 tai UN/ECE 53 Esimerkki listid="un/ece 00" Käytettävät koodit UN/ECE 00 UN/ECE koodisto 00 "Document name code" UN/ECE 53 UN/ECE koodisto 53 "Reference qualifier" Toisto 0.. Attribuutilla annetaan dokumenttitunnuskoodiston ylläpitäjän tunnus Esimerkki listagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) Toisto 0.. Text. Type Attribuutit languageid Language. Identifier Toisto 0.. Elementillä annetaan toteutumatieto- ja toimitusluettelo- sanoman viitteen tyyppi tekstimuotoisena. Esimerkki <cbc:documenttype languageid="fi">sopimus </cbc:documenttype> Rivin viitteen tekstimuotoisen tyypin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla. Esimerkki languageid="fi" 27/68

28 6..4 Toimittajan tiedot (Despatch Advice. Despatch_ Supplier Party. Supplier Party) Elementti / aggregaatti Despatch Advice. Despatch_ Supplier Party. Supplier Party Supplier Party. Party 6..5 Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. Supplier Party. Details Aggregaatilla annetaan toimittajaorganisaation tiedot eli osapuolen, joka on toteuttanut tilauksen tehtävät. Esimerkki <cac:despatchsupplierparty> </cac:despatchsupplierparty> Toisto 0.. Party. Details Aggregaatilla annetaan toimittajaorganisaation nimi-, tunnisteja yhteystiedot. Esimerkki <cac:party> </cac:party> 28/68

29 6..5 Toimittaja (Supplier Party. Party) Elementti / aggregaatti Supplier Party. Party Toisto 0.. Party. Party Identification 6..6 Party. Party Name 6..7 Toistokerrat, tyyppi, kuvaus, esimerkki Party. Details Aggregaatilla annetaan toimittajaorganisaation nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:party> </cac:party> Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan toimittajaorganisaation 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 toimittajaorganisaation nimitiedot. 29/68

30 Party. Contact 6..8 Esimerkki <cac:partyname> </cac:partyname> Toisto 0.. Contact. Details Aggregaatilla annetaan sanoman kuittaajan eli toimittajaorganisaation yhteyshenkilön tai -osaston tiedot. Esimerkki <cac:contact> </cac:contact> 30/68

31 6..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 toimittajaorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto.. Identifier. Type Elementillä annetaan toimittajaorganisaation tunnus, jolla toimittaja tunnistetaan partnerin järjestelmissä automaattisesti. Tässä elementissä annettava tunnus voi olla esimerkiksi OVT-tunnus, tilaajan tai toimittajan tunnistekoodiston mukainen tunnus. Attribuutit schemeid ja schemeagencyid Esimerkki <cbc:id schemeid="iso 6523" schemeagencyid="5"> </cbc:ID> Toisto 0.. Attribuutilla annetaan osapuolitunnistekoodiston tunnus. Esimerkki schemeid="iso 6523" Käytettävät koodit ISO 6523 OVT- tunnus (Structure for the identification of organizations) Toisto 0.. Attribuutilla annetaan osapuolitunnuskoodiston ylläpitäjä. Esimerkki schemeagencyid="5" Käytettävät koodit 5 ISO (International Organization for Standardization) 9 (Assigned by seller or seller's agent) Toimittajan ylläpitämä luettelo 92 (Assigned by buyer or buyer's agent) Tilaajan ylläpitämä luettelo 3/68

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

33 6..8 Sanoman kuittaaja eli toimittajan yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Elementti / aggregaatti Party. Contact Toisto 0.. Toistokerrat, tyyppi, kuvaus, esimerkki Contact. Identifier Toisto 0.. Contact. Details Aggregaatilla annetaan sanoman kuittaajan eli toimittajaorganisaation yhteyshenkilön tai -osaston tiedot Esimerkki <cac:contact> </cac:contact> Identifier. Type Elementillä annetaan kuittaajan eli toimittajaorganisaation yhteyshenkilön tai -osaston tunnus Huomautus Henkilön tunnuksena suositellaan käytettäväksi henkilön sähköpostiosoitetta. Esimerkki <cbc:id>46</cbc:id> Contact. Name Toisto 0.. Name. Type Contact. Telephone. Text Toisto 0.. Contact. Electronic_ Mail. Text Elementillä annetaan ilmoituksen kuittaajan eli toimittajaorganisaation yhteyshenkilön tai -osaston nimi. Esimerkki <cbc:name>kalle Kuittaaja</cbc:Name> Text. Type Elementillä annetaan ilmoituksen kuittaajan eli toimittajaorganisaation yhteyshenkilön tai -osaston puhelinnumero. Esimerkki <cbc:telephone> <cbc:Telephone> Toisto 0.. Text. Type Elementillä annetaan ilmoituksen kuittaajan eli toimittajaorganisaation yhteyshenkilön tai -osaston 33/68

34 sähköpostiosoite. Esimerkki <cbc:electronicmail> 34/68

35 6..9 Tilaajan tiedot (Despatch Advice. Delivery_ Customer Party. Customer Party) Elementti / aggregaatti Despatch Advice. Delivery_ Customer Party. Customer Party Customer Party. Party 6..0 Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. Customer Party. Details Aggregaatilla annetaan tilaajaorganisaation tiedot. Esimerkki <cac:deliverycustomerparty> </cac:deliverycustomerparty> Toisto 0.. Party. Details Aggregaatilla annetaan tilaajan nimi-, ja tunnistetiedot. Esimerkki <cac:party> </cac:party> 35/68

36 6..0 Tilaaja (Customer Party. Party) Elementti / aggregaatti Customer Party. Party Toisto 0.. Party. Party Identification 6.. Party. Party Name 6..2 Toistokerrat, tyyppi, kuvaus, esimerkki Party. Details Aggregaatilla annetaan tilaajan nimi- ja tunnistetiedot. Esimerkki <cac:party> </cac:party> Toisto 0.. unbounded Party Identification. Details Aggregaatilla annetaan tilaajan 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 tilaajaorganisaation nimitiedot. Esimerkki <cac:partyname> </cac:partyname> 36/68

37 6.. 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 tilaajaorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto.. Identifier. Type Elementillä annetaan tilaajaorganisaation tunnus, jolla tilaaja tunnistetaan partnerin järjestelmissä automaattisesti. Tässä elementissä annettava tunnus voi olla esimerkiksi OVT-tunnus, tilaajan tai toimittajan tunnistekoodiston mukainen tunnus. Attribuutit schemeid ja schemeagencyid Esimerkki <cbc:id schemeid="iso 6523" schemeagencyid="5"> </cbc:ID> Toisto 0.. Attribuutilla annetaan osapuolitunnistekoodiston tunnus. Esimerkki schemeid="iso 6523" Käytettävät koodit ISO 6523 OVT- tunnus (Structure for the identification of organizations) Toisto 0.. Attribuutilla annetaan osapuolitunnuskoodiston ylläpitäjä. Esimerkki schemeagencyid="5" Käytettävät koodit 5 ISO (International Organization for Standardization) 37/68

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

39 6.2 Sanoman rivitaso Sanoman rivitasolla välitetään suoritettua tehtävää koskevat tiedot, kuten hankkeessa käytetty materiaaliin määrä sekä toteutuneet työtunnit Toteutumatieto- ja toimitusluettelosanoman rivin tiedot (Despatch Advice. Despatch Line)..* Elementti / aggregaatti Despatch Advice. Despatch Line Toistokerrat, tyyppi, kuvaus, esimerkki Toisto Despatch Line. Identifier Toisto.... unbounded Despatch Line. Details Aggregaatilla annetaan toteutumatieto- ja toimitusluettelo- sanoman rivitason tiedot. Esimerkki <cac:despatchline> </cac:despatchline> Identifier. Type Elementillä annetaan toteutumatieto- ja toimitusluettelosanoman rivin tunnus. Huomautus Rivin tunnuksen on oltava sama kuin sillä tilauksella, johon tämä toimitus perustuu. Esimerkki <cbc:id></cbc:id> Despatch Line. Note. Text Toisto 0.. Text. Type Elementillä annetaan toteutumatieto- ja toimitusluettelo- sanoman rivin kommentti ja muuta lisätietoa. Huomautus Tällä elementillä annetaan tietoja, joita ei voida antaa toteutumatieto- ja toimitusluettelosanoman rivin minkään muun elementin arvona. Attribuutit languageid 39/68

40 Language. Identifier Toisto 0.. Despatch Line. Delivered_ Quantity. Quantity Esimerkki <cbc:note languageid="fi">lisäys aiemmin lähetettyihin tietoihin</cbc:note> Toteutumatieto- ja toimitusluettelo-sanoman rivin vapaamuotoisen tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla. Esimerkki languageid="fi" Toisto 0.. Attribuutit Quantity. Type Elementillä annetaan toimitettu määrä tai toteutunut työaika. unitcode Quantity Unit. Code Toisto.. Despatch Line. Document Reference Esimerkki <cbc:deliveredquantity unitcode="c62">2 </cbc:deliveredquantity> 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 TNE Toisto (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ä (Tonne) Tonni 0.. unbounded Document Reference. Details Aggregaatilla annetaan toteutumatieto- ja toimitusluettelo- sanoman riviin liittyvät viitteet, kuten esimerkiksi kustannuspaikat ja alarivitekniikassa päärivin tunnus. Huomautus Jos tuote koostuu osista, osat ilmoitetaan omina riveinään 40/68

41 Despatch Line. Item Despatch Line. Shipment Despatch Line aggregaatin ja sen alarggregaattien avulla. Viittaus pääriviin tapahtuu kyseisen Despatch Line aggregaatin Document Reference aggregaatilla, missä elementti Document Reference. Document Type Code. Code saa arvon LI ja elementissä Document Reference. Identifier esitetään päärivin tunnus. Esimerkki <cac:documentreference> </cac:documentreference> Toisto.. Item. Details Aggregaatilla annetaan tuotteen tiedot. Esimerkki <cac:item> </cac:item> Toisto 0.. unbounded Shipment. Details Aggregaatilla annetaan tuotteeseen liittyviä toimitustietoja. Esimerkki <cac:shipment> </cac:shipment> 4/68

42 6.2.2 Rivin viitteet (Despatch Line. Document Reference) Elementti / aggregaatti Despatch Line. Document Reference Document Reference. Identifier Document Reference. Document Type Code. Code Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. unbounded Document Reference. Details Aggregaatilla annetaan toteutumatieto- ja toimitusluettelosanoman riviin liittyvät viitteet, kuten esimerkiksi kustannuspaikat ja alarivitekniikassa päärivin tunnus. Huomautus Jos tuote koostuu osista, osat ilmoitetaan omina riveinään Despatch Line aggregaatin ja sen alarggregaattien avulla. Viittaus pääriviin tapahtuu kyseisen Despatch Line aggregaatin Document Reference aggregaatilla, missä elementti Document Reference. Document Type Code. Code saa arvon LI ja elementissä Document Reference. Identifier esitetään päärivin tunnus. Esimerkki <cac:documentreference> </cac:documentreference> Toisto.. Identifier. Type Elementillä annetaan toteutumatieto- ja toimitusluettelosanoman rivin viitteen tunnus. Esimerkki <cbc:id>345</cbc:id> Toisto 0.. Code. Type Elementillä annetaan toteutumatieto- ja toimitusluettelosanoman rivin viitteen tyyppi koodimuotoisena. Huomautus Elementin arvoja on kahdessa eri koodistossa. OASIS on määritellyt UN/ECE koodiston "00 Document name code" oletusarvoiseksi koodistoksi. Jos tästä koodistosta ei löydy sopivaa koodia, voidaan käyttää UN/ECE koodistoa 53 Reference qualifier". Koodit UN/ECE koodiston 53 mukaisia koodeja ovat: 42/68

43 AV = (Account payable number) Kustannuspaikan tunnus LI = (Document line identifier) Päärivin tunnus käytettäessä alarivitekniikkaa Attribuutit listid ja listagencyid Esimerkki Code List. Identifier Toisto 0.. Code List. Agency. Identifier Document Reference. Document Type. Text <cbc:documenttypecode listid= UN/ECE53" listagencyid="6">av</cbc:documenttypecode> Attribuutilla annetaan viitteen tunnuskoodiston tunnus; joko UN/ECE 00 tai UN/ECE 53 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" Toisto 0.. Attribuutilla annetaan viitteen tunnuskoodiston ylläpitäjän tunnus Esimerkki listagencyid="6" Käytettävät koodit 6 UN/ECE (United Nations - Economic Commission for Europe) Toisto 0.. Text. Type Attribuutit languageid Language. Identifier Toisto 0.. Elementillä annetaan toteutumatieto- ja toimitusluettelo- sanoman rivin viitteen tyyppi tekstimuotoisena. Esimerkki <cbc:documenttype languageid="fi">kustannuspaikka </cbc:documenttype> Rivin viitteen tekstimuotoisen tyypin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla. Esimerkki languageid="fi" 43/68

44 6.2.3 Tuotteen tiedot (Despatch Line. Item) 44/68

45 Elementti / aggregaatti Despatch Line. Item Toisto.. Toistokerrat, tyyppi, kuvaus, esimerkki Item. Details Aggregaatilla annetaan tuotteen tiedot. Esimerkki <cac:item> </cac:item> Item. Description. Text Toisto 0.. unbounded Text. Type Attribuutit languageid Language. Identifier Toisto 0.. Elementillä annetaan tuotteen kuvaus (pitkä teksti). Esimerkki <cbc:description languageid="fi">hengenvaar/livsfara,,5mm paksu</cbc:description> tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Item. Name Toisto 0.. Name. Type Attribuutit languageid Language. Identifier Toisto 0.. Item. Buyers_ Item Identification. Item Identification Item. Standard_ Item Identification. Item Identification Elementillä annetaan tuotenimi, 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" Toisto 0.. Item Identification. Details Aggregaatilla annetaan tilaajan tuotekoodi- eli nimiketiedot. Esimerkki <cac:buyersitemidentification> Toisto 0.. </cac:buyersitemidentification> Item Identification. Details Aggregaatilla annetaan sähköalan tuotekoodi- eli nimiketiedot. Esimerkki <cac:standarditemidentification> </cac:standarditemidentification> 45/68

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

47 6.2.5 Sähköalan tuotekoodi eli nimike (Item. Standard_ Item Identification. Item Identification) Elementti / aggregaatti Item. Standard_ Item Identification. Item Identification Item Identification. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. Item Identification. Details Aggregaatilla annetaan sähköalan tuotekoodi- eli nimiketiedot. Esimerkki <cac:standarditemidentification> </cac:standarditemidentification> Toisto.. Identifier. Type Elementillä annetaan sähköalan tuotekoodi eli nimike. Esimerkki <cbc:id>645065</cbc:id> 47/68

48 6.2.6 Tuotteen toimittamistiedot (Despatch Line. Shipment) Elementti / aggregaatti Despatch Line. Shipment Toistokerrat, tyyppi, kuvaus, esimerkki Toisto Shipment. Identifier Toisto.. Shipment. Consignment unbounded Shipment. Details Aggregaatilla annetaan tuotteeseen liittyviä toimitustietoja. Esimerkki <cac:shipment> </cac:shipment> Identifier. Type Elementillä annetaan tehtävän tunnus. Huomautus Tämä elementti on sanomassa pakollinen, mikäli aggregaatti Shipment esiintyy. Jos tehtävän tunnusta ei ole määritelty voidaan elementin arvona antaa puuttuva tieto XXXXXX. Esimerkki <cbc:id>xxxxxx</cbc:id> Toisto.. Consignment. Details Aggregaatilla annetaan toimitustiedot. Huomautus Tämä aggregaatti on sanomassa pakollinen, mikäli aggregaatti Shipment esiintyy. Esimerkki <cac:consignment> </cac:consignment> 48/68

49 Shipment. Goods Item Toisto 0.. unbounded Goods Item. Details Aggregaatilla annetaan tuotteen arvotietoja. Esimerkki <cac:goodsitem> </cac:goodsitem> 49/68

50 6.2.7 Toimitustiedot (Shipment. Consignment) Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Shipment. Consignment Toisto.. Consignment. Details Aggregaatilla annetaan toimitustiedot. Huomautus Tämä aggregaatti on sanomassa pakollinen, mikäli aggregaatti Shipment esiintyy. Esimerkki <cac:consignment> </cac:consignment> 50/68

51 Consignment. Identifier Toisto.. Identifier. Type Elementillä annetaan toimituksen tunnus. Huomautus Tämä elementti on sanomassa pakollinen, mikäli aggregaatti Shipment esiintyy. Jos tehtävän tunnusta ei ole käytössä, asetetaan tämän elementin arvoksi XXXXXX. Esimerkki <cbc:id>xxxxxx</cbc:id> 5/68

52 6.2.8 Tuotteen arvotiedot (Shipment. Goods Item) Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Shipment. Goods Item Toisto 0.. unbounded Goods Item. Details Aggregaatilla annetaan tuotteen arvotietoja. Esimerkki <cac:goodsitem> </cac:goodsitem> Goods Item. Identifier Toisto.. Identifier. Type Elementillä annetaan tuotteen tunnus. Huomautus Tämä elementti on aggregaatissa pakollinen, mikäli aggregaatti Goods Item esiintyy. Tunnus on sama kuin aggregaatissa Item. Buyers_ Item Identification. Item Identification tai Item. Standard_ Item Identification. Item Identification annettu tunnus. Jos tuotteen tunnusta ei ole määritelty, voidaan elementin arvona antaa puuttuva tieto XXXXXX. Esimerkki <cbc:id>645065</cbc:id> Goods Item. Invoice Line Toisto 0.. unbounded Type Invoice Line. Details Aggregaatilla annetaan tuotteen hintatiedot. Esimerkki <cac:invoiceline> </cac:invoiceline> 52/68

53 6.2.9 Tuotteen hintatiedot (Goods Item. Invoice Line) Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Goods Item. Invoice Line Toisto 0.. unbounded Type Invoice Line. Details Aggregaatilla annetaan tuotteen hintatiedot. Esimerkki <cac:invoiceline> </cac:invoiceline> Invoice Line. Identifier Toisto.. Identifier. Type Elementillä annetaan rivin tunnus joka tässä tapauksessa on sama kuin toteutumatieto- ja toimitusluettelosanoman rivin tunnus. Huomautus Rivin tunnuksen on oltava sama kuin sillä tilauksella, johon 53/68