Sanomasuositus ja sen yleinen soveltamisohje Tilausperuutus FI029, 200-06-30, v.00 Käyttö: Energiateollisuus Sanasto: UBL Versio: 2.0 Sanoma: OrderCancellation
Sisällysluettelo Sanoma ja sen soveltamisala... 3. Sanoman käyttötarkoitus ja soveltamisen rajaus... 3.2 Soveltamisohjeen sisältö... 3.3 Työryhmän työskentelyyn osallistuneet... 4 2 Dokumentti ja sen yhteydet muihin dokumentteihin... 6 2. Päivitykset... 6 2.2 Esitietovaatimukset... 6 2.3 Aiheeseen liittyvää aineistoa... 6 2.4 Huomioitavaa... 6 3 Tilausperuutusprosessi... 7 3. Prosessin rajaus... 7 3.2 Prosessin osapuolet... 7 3.3 Prosessin vaiheet... 7 4 Sanoman tietosisältö... 0 5 Tilausperuutussanoman rakenne... 3 5. Luokkamalli... 3 5.2 Tietojen suhde toisiinsa... 3 6 Sanoman määrittely... 5 6. Sanoman otsikkotaso... 5 6.. Tilausperuutussanoma (Order Cancellation. Details)... 5 6..2 Peruutettavan tilauksen tiedot (Order Cancellation. Order Reference)... 9 6..3 Tilaajan eli tilausperuutuksen tekijän tiedot (Order Cancellation. Buyer_ Customer Party. Customer Party)... 20 6..4 Tilaajan eli tilausperuutuksen tekijä (Customer Party. Party)... 2 6..5 Tilaajan eli tilausperuutuksen tekijän tunniste (Party. Party Identification)... 23 6..6 Tilaajan eli tilausperuutuksen tekijän nimi (Party. Party Name)... 24 6..7 Tilaajan eli tilausperuutuksen tekijän yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact)... 25 6..8 Toimittajan eli tilausperuutuksen vastaanottajan tiedot (Order. Seller_ Supplier Party. Supplier Party)... 27 6..9 Toimittajan eli tilausperuutuksen vastaanottaja (Supplier Party. Party)... 28 6..0 Toimittajan eli tilausperuutuksen vastaanottajan tunniste (Party. Party Identification)... 29 6.. Toimittajan eli tilausperuutuksen vastaanottajan nimi (Party. Party Name)... 30 7 Sanomaesimerkki... 3 7. UBL tilausperuutussanomaesimerkki... 3 8 Liite : Kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje... 33
Sanoma ja sen soveltamisala. Sanoman käyttötarkoitus ja soveltamisen rajaus Tämä dokumentti sisältää UBL 2.0 -versioon perustuvan OrderCancellation 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 peruutettaessa pientyötilausta. Soveltamisohjeen määrittelemää tilausperuutussanomaa voidaan käyttää peruutettaessa pientyötilaus normaalissa, sopimuspohjaisessa toiminnassa. Osapuolten on kuitenkin sovittava peruutuskäytännöistä ennen sanoman käyttöä. Tällä sanomalla voidaan tehdä vain tilauksen peruutus koskien koko pientyötilaussanomaa. Kaikki peruutettavan tilauksen tiedot menevät off-tilaan sekä tilauksen lähettäjän että vastaanottajan järjestelmissä, kun tilausperuutus lähetetään ja vastaanotetaan. Alkuperäistä tilausta ei kuitenkaan poisteta tilauksen lähettäjän eikä vastaanottajan järjestelmistä. Jos koko tilaus halutaan peruuttaa ja korvata kokonaisuudessaan uudella tilauksella esimerkiksi, kun tilaus on lähtenyt vahingossa tilaajan järjestelmistä toimittajalle, tilauksen muutos tehdään siten, että ensin lähetetään tilausperuutussanoma ja tämän jälkeen lähetetään uusi tilaussanoma, joka sisältää muutetun tilauksen tiedot. Normaaleissa tapauksissa, joissa muutos kohdistuu vain yhteen tai muutamaan tilausriviin, lähetetään kyseiset tilausrivit tilaussanomassa määriltään negatiivisina ja samassa sanomassa oikeat tiedot sisältävät rivit. Kohdistaminen alkuperäisen tilauksen ja muutetun tilauksen välillä tapahtuu rivinumeron ja tuotekoodin avulla. OrderChange-sanomalla voidaan muuttaa ainoastaan päivämääriä ja paikkatietoja. Tilattuja määriä OrderChange-sanomalla ei saa muuttaa. Muutoksien ja peruutuksien tekemisestä sähköisesti on sovittava aina toimittajan kanssa, ennen kuin tilauksia aletaan perua tai muuttaa sähköisesti. Sovellusohje on syntynyt Energiateollisuus ry:n organisoimassa projektissa Sähkönjakeluyhtiöiden ja toimittajayhtiö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..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. 3/33
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 Tilausperuutusprosessi esitetään tämän dokumentin tietosisällön ja sovellusohjeen pohjana oleva tilausperuutusprosessi, sen osapuolet ja vaiheet. Kappaleessa 4 Sanoman tietosisältö on esitetty tilausperuutussanomassa välitettävien tietojen luettelo. Kappaleessa 5 "Tilausperuutussanoman rakenne on esitetty tämän UBL- OrderCancellation-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 sanoman rakenne, käytettävät aggregaatit, elementit, attribuutit ja koodit sekä niiden käyttötarkoitus. Kappaleessa 7 Sanomaesimerkki on esitetty esimerkki OrderCancellationtilausperuutussanoman käytöstä. Liitteessä on esitetty kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje..3 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 toimittajayhtiö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 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 4/33
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 Tekla Oy Tieto Oy Vattenfall Verkko Oy Visma Software Oy Voimatel Oy Timo Mutila Jari Martikainen Tuomas Murumäki Osmo Siirto Kari Väänänen 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 5/33
2 Dokumentti ja sen yhteydet muihin dokumentteihin 2. Päivitykset Pvm/Laatija Versio Kommentit/muutokset 200-06-30 Heikki Laaksamo.00 Ensimmäinen versio 2.2 Esitietovaatimukset Soveltamisohje on tarkoitettu sekä johto- että asiantuntijatason käyttöön. Soveltamisohjeen teknisen taustan ymmärtämistä tukee seuraavien aihealueiden tuntemus: XML, UBL ja ebxml ydinkomponentit. 2.3 Aiheeseen liittyvää aineistoa w3schools XML Tutorial (http://www.w3schools.com/xml/default.asp ) ebxml Core Components Technical Specification (CCTS) 2.0 (http://www.ebxml.org/ ) Universal Business Language 2.0 ( www.oasisopen.org/committees/tc_home.php?wg_abbrev=ubl) NES työryhmän tekemät soveltamisohjeet ( www.nesubl.eu ) United Nations Directories for Electronic Data Interchange for Administration, Commerce and Transport (http://www.unece.org/trade/untdid/welcome.htm ) UN/CEFACT Recommendations (http://www.unece.org/cefact/recommendations/rec_index.htm ) 2.4 Huomioitavaa Soveltamisohje perustuu UBL 2.0 OrderCancellation-sanoman määrityksiin. Määrityksissä on huomioitu myös kansainvälisen NES (Northern European Subset) työryhmän yleiset suositukset. 6/33
3 Tilausperuutusprosessi 3. Prosessin rajaus Tässä prosessikuvauksessa on tarkasteltu ainoastaan tilausperuutusprosessia, jossa tämän dokumentin määrittelemää OrderCancellation-sanomaa voidaan käyttää. Tarkastelussa oletetaan, että tilausperuutus välitetään peruutusprosessissa sähköisesti osapuolten välillä. Tarkastelusta on jätetty pois tilausperuutusta edeltävät vaiheet, kuten tarjouspyynnön ja tarjouksen tekeminen ja käsittely sekä varsinaisen tilauksen tekeminen. Myös varsinaisen peruutusprosessin jälkeiset vaiheet, toisin sanoen tilausperuutuksen vahvistus ja hylkäys, ovat rajattu tämän tarkastelun ulkopuolelle. 3.2 Prosessin osapuolet Seuraavassa taulukossa on esitetty tämän prosessin osapuolet. Osapuoli Tilaaja Toimittaja Rooli Osapuoli, joka tekee tilausperuutuksen. Osapuoli, joka lähettää tilausperuutuksen. Osapuoli, joka vastaanottaa tilausperuutuksen. Osapuoli, joka käsittelee tilausperuutuksen. Osapuoli, joka on vastuussa tilausperuutuksen vaatimista toimenpiteistä. Osapuoli, joka hyväksyy tai hylkää tilausperuutuksen. Osapuoli, joka lähettää tilauksen tekijälle kuittauksen tilauksen peruutuksen vastaanotosta. Osapuoli, joka välittää tilausperuutuksen tiedot huolto- tai korjaustoimenpiteen toteuttajalle. Taulukko 3.2.: Tilausperuutusprosessin osapuolet 3.3 Prosessin vaiheet Kuviossa 3.3. on esitetty tilausperuutusprosessin vaiheet eroteltuna kohdassa 3.2 esitettyjen osapuolien toimintojen mukaan. 7/33
Tilaaja Toimittaja Tehdään tilausperuutus Otetaan vastaan vastaanoton kuittaus Tilausperuutus Tekninen / vastaanoton kuittaus Peruutuksen vastaanotto Vastaanoton kuittaaminen Käsitellään vastaanoton kuittaus Otetaan vastaan peruutusvahvistus Lähetetään tilausperuutus Peruutusvahvistus Peruutuksen käsittely Käsitellään peruutusvahvistus Kuvio 3.3.: Tilausperuutusprosessi 8/33
Seuraavassa taulukossa on selitetty kuviossa 3.3. esitetyn tilausperuutusprosessin vaiheet jaoteltuna osapuolten hoitamien toimintojen mukaan. Osapuoli Toiminta Tilaaja Toimittaja Tilausperuutuksen luonti Tilausperuutuksen lähetys Vastaanoton kuittauksen vastaanotto Vastaanoton kuittauksen käsittely Peruutuksen vahvistuksen vastaanotto Peruutuksen vahvistuksen käsittely Tilausperuutuksen vastaanotto Vastaanoton kuittaus Tilausperuutuksen käsittely Tilaaja luo tilausperuutuksen omassa järjestelmässään. Tilaaja lähettää tilausperuutuksen sähköisesti toimittajalle. Tilaaja ottaa vastaan sanoman vastaanoton kuittauksen, jolla toimittaja ilmoittaa vastaanottaneensa tilausperuutuksen. Tilaaja käsittelee sanoman vastaanoton kuittauksen omissa tietojärjestelmissä. Tilaaja ottaa vastaan tilausperuutuksen vahvistuksen, jolla toimittaja ilmoittaa peruutuksen hyväksymisen. Tilaaja käsittelee tilausperuutuksen vahvistuksen omissa tietojärjestelmissä. Toimittaja vastaanottaa peruutuksen. Toimittaja kuittaa vastaanottaneensa tilausperuutuksen lähettämällä tilaajalle sanoman vastaanoton kuittauksen. Toimittaja käsittelee tilausperuutuksen omissa tietojärjestelmissään ja lähettää tilaajalle peruutusvahvistuksen. Taulukko 3.3.: Tilausperuutusprosessin osapuolikohtaiset vaiheet 9/33
4 Sanoman tietosisältö Seuraavassa taulukossa on esitetty tilausperuutuksen 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 käyttämän tilausperuutussanoman 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. 0/33
Tieto Aggregaatti Kappale P/V Sanoman versio Order Cancellation 6.. P Soveltamisohjeen kehittäjä Order Cancellation 6.. P Soveltamisohjeen tunnus Order Cancellation 6.. P Peruutussanoman tunnus Order Cancellation 6.. P Peruutuksen päivämäärä Order Cancellation 6.. P Perutuksen kellonaika Order Cancellation 6.. V Yleistä tietoa Order Cancellation 6.. V Peruutuksen syy Order Cancellation 6.. P Peruutettavan tilauksen tunnus Order Cancellation. Order Reference 6..2 P Tilaajan tiedot Order Cancellation. Buyer_ Customer Party. Customer Party 6..3 P Tunnus Nimi Order Cancellation. Buyer_ Customer Party. Customer Party. Party. Party Identification Order Cancellation. Buyer_ Customer Party. Customer Party. Party. Party Name 6..5 V 6..6 V Ilmoittaja eli yhteyshenkilö Order Cancellation. Buyer_ Customer Party. Customer Party. Party. Contact 6..7 P Yhteysosasto Order Cancellation. Buyer_ Customer Party. Customer Party. Party. Contact 6..7 V Puhelinnumero Order Cancellation. Buyer_ Customer Party. Customer Party. Party. Contact 6..7 V Sähköpostiosoite Order Cancellation. Buyer_ Customer Party. Customer Party. Party. Contact 6..7 V Toimittajan tiedot Order Cancellation. Seller_ Supplier Party. Supplier Party 6..8 P Tunnus Order Cancellation. Seller_ Supplier Party. Supplier Party. Party. Party Identification 6..0 V Nimi Order Cancellation. Seller_ Supplier Party. Supplier Party. Party. Party Name 6.. V /33
Taulukko 4.: Tilausperuutuksen tietosisältö ja sijainti aggregaatit 2/33
5 Tilausperuutussanoman rakenne 5. Luokkamalli Tässä kappaleessa esitetään UBL 2.0 OrderCancellation-sanoman rakenne käyttäen hyväksi UML-luokkamallia, kun sanomaa käytetään energiateollisuuden sähköntuottajien ja heidän palvelutuottajien välisessä toiminnassa peruutettaessa pientyötilausta. Mallissa on esitetty sanoma vain niiltä osin kuin sen tietosisältö on määritelty Energiateollisuus ry:n organisoimassa projektissa Sähkönjakeluyhtiöiden ja toimittajayhtiöiden tietojärjestelmien yhteensopivuus. Kuviossa 5.. on esitetty tilausperuutussanoman luokkamalli. PartyIdentification -ID OrderCancellation -UBLVersionID -CustomizationID -ProfileID -ID -IssueDate -IssueTime -Note -CancellationNote +Buyer +Seller CustomerParty SupplierParty Party PartyName -Name Contact OrderReference -ID -ID -Name -Telephone -ElectronicMail Kuvio 5..: Tilausperuutussanoman luokkamalli 5.2 Tietojen suhde toisiinsa Tässä luvussa kuviossa 5.2. esitetään sanoman 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öä. 3/33
Tunnustiedot -Tunnus Tilausperuutus -UBLVersionumero -Soveltamisohjeen kehittäjä -Soveltamisohjeen tunnus -Tilausperuutuksen tunnus -Peruutuksen päivämäärä -Peruutuksen kellonaika -Yleistä tietoa -Peruutuksen syy Tilaaja Toimittaja Osapuolitiedot Nimitiedot -Nimi Peruutettava tilaus -Tunnus Yhteystiedot -Tunnus -Nimi -Puhelin -Sähköposti Kuvio 5.2.: Tilausperuutuksen tietojen suhteet 4/33
6 Sanoman määrittely 6. Sanoman otsikkotaso Tässä kappaleessa on esitelty UBL-OrderCancellation-Tilausperuutussanoman 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. Sanomalla on vain otsikkotaso. Kappaleessa esiintyvien taulukoiden lukuohje on kappaleessa Liite : Kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje. 6.. Tilausperuutussanoma (Order Cancellation. Details)..* Elementti / aggregaatti Order Cancellation. Details Order Cancellation. UBL Version Identifier. Identifier Toistokerrat, tyyppi, kuvaus, esimerkki Toisto 0.. Tällä aggregaatilla annetaan tilausperuutussanoman tiedot, jolla aiemmin tehty tilaus voidaan peruuttaa. Esimerkki <OrderCancellation> </OrderCancellation> Toisto 0.. Tyyppi 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". 5/33
Order Cancellation. Customization Identifier. Identifier Order Cancellation. Profile Identifier. Identifier Identification Scheme Agency. Identifier Order Cancellation. Identifier Order Cancellation. Issue Date. Date Order Cancellation. Issue Time. Time Esimerkki <cbc:ublversionid>2.0</cbc:ublversionid> Toisto 0.. Tyyppi Identifier. Type Elementillä annetaan sanoman soveltamisohjeen kehittäjän nimi. Esimerkki <cbc:customizationid>et</cbc:customizationid> Toisto 0.. Tyyppi Identifier. Type TIEKE ry:n soveltamisohjeelle antama tunnus, joka on vakiosti FI029 Attribuutit schemeagencyid Esimerkki <cbc:profileid schemeagencyid="292">fi029 </cbc:profileid> Toisto 0.. Attribuutilla annetaan soveltamisohjeluettelon ylläpitäjän tunnus. Esimerkki schemeagencyid="292" Käytettävät koodit 292 (FI, TIEKE The Information Technology Development Centre of Finland) TIEKE Tietoyhteiskunnan kehittämiskeskus ry Toisto.. Tyyppi Identifier. Type Tilausperuutuksen yksilöivät tunnus. Tämä tunnus palautuu tilaajalle toimittajan vahvistaessa tilausperuutuksen. Huomautus Lähetettäessä tilausperuutuksen testisanomia käytetään sanoman tunnusta, jonka neljä ensimmäistä merkkiä ovat muotoa: TEST Esimerkki <cbc:id>234-c</cbc:id> Toisto.. Tyyppi Date. Type Elementillä annetaan tilausperuutuksen päivämäärä. On suositeltavaa, että päivämäärä on sama, jonka peruutuksen sisällöstä vastaava henkilö voi nähdä järjestelmästään tilausperuutuksen tekopäivämääränä, eikä tilausperuutussanoman 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>2009-0-2</cbc:issuedate> Toisto 0.. Tyyppi Time. Type 6/33
Order Cancellation. Note. Text Elementillä annetaan tilausperuutuksen luontiajanhetki, siis luontihetken tunnit, minuutit ja sekunnit. On suositeltavaa, että ajanhetki on sama, jonka peruutuksen sisällöstä vastaava henkilö voi nähdä järjestelmästään tilausperuutuksen tekoajanhetkenä, eikä tilausperuutussanoman muodostamisajanhetki, joka voi poiketa tästä ajanhetkestä. Kellonaika 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>09:6:08</cbc:issuetime> Toisto Tyyppi 0.. unbounded Text. Type Elementillä annetaan tilausperuutukseen liittyvää yleistä tietoa, jota ei voida antaa OrderCancellation-sanoman muiden elementtien arvona. Huomautus Vain yksi elementin toisto kieltä kohden. Attribuutit languageid Language. Identifier Toisto 0.. Order Cancellation. Cancellation_ Note. Text Esimerkki <cbc:note languageid="fi">tilauksen peruutus perustuu aiemmin käytyyn puhelinkeskusteluun.</cbc:note> Tilausperuutuksen vapaamuotoisen tekstin kieli ilmaistuna standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Toisto.. Tyyppi Text. Type Elementillä annetaan tilausperuutukseen syy tekstimuotoisesti. Attribuutit languageid Language. Identifier Toisto 0.. Esimerkki <cbc:cancellationnote languageid="fi">väärä hälytys. </cbc:cancellationnote> Tilausperuutuksen syyn tekstin kieli ilmaistuna 7/33
Order Cancellation. Order Reference 6..2 Order Cancellation. Buyer_ Customer Party. Customer Party 6..3 Order Cancellation. Seller_ Supplier Party. Supplier Party 6..8 standardin ISO 639 mukaisella kaksikirjaimisella kielikoodilla Esimerkki languageid="fi" Toisto.. unbounded Tyyppi Order Reference. Details Tällä aggregaatilla annetaan sen tilauksen tunnistetiedot, joka tällä sanomalla perutaan. Esimerkki <cac:orderreference> </cac:orderreference> Toisto.. Tyyppi Customer Party. Details Aggregaatilla annetaan tilaajan eli tilausperuutuksen tekijäorganisaationtiedot. Esimerkki <cac:buyercustomerparty> </cac:buyercustomerparty> Toisto.. Tyyppi Supplier Party. Details Aggregaatilla annetaan toimittajan eli tilausperuutuksen vastaanottajaorganisaation tiedot. Esimerkki <cac:sellersupplierparty> </cac:sellersupplierparty> 8/33
6..2 Peruutettavan tilauksen tiedot (Order Cancellation. Order Reference) Elementti / aggregaatti Order Cancellation. Order Reference Toistokerrat, tyyppi, kuvaus, esimerkki Toisto Tyyppi Order Reference. Identifier Toisto.... unbounded Order Reference. Details Tällä aggregaatilla annetaan sen tilauksen tunnistetiedot, joka tällä sanomalla perutaan. Esimerkki <cac:orderreference> </cac:orderreference> Tyyppi Identifier. Type Elementillä annetaan peruutettavan tilauksen tunnus. Esimerkki <cbc:id>234-ab</cbc:id> 9/33
6..3 Tilaajan eli tilausperuutuksen tekijän tiedot (Order Cancellation. Buyer_ Customer Party. Customer Party) Elementti / aggregaatti Order Cancellation. Buyer_ Customer Party. Customer Party Customer Party. Party 6..4 Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. Tyyppi Customer Party. Details Aggregaatilla annetaan tilaajan eli tilausperuutuksen tekijäorganisaation tiedot. Esimerkki <cac:buyercustomerparty> </cac:buyercustomerparty> Toisto 0.. Tyyppi Party. Details Aggregaatilla annetaan tilaajan eli tilausperuutuksen tekijäorganisaation nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:party> </cac:party> 20/33
6..4 Tilaajan eli tilausperuutuksen tekijä (Customer Party. Party) Elementti / aggregaatti Customer Party. Party Toisto 0.. Party. Party Identification 6..5 Toistokerrat, tyyppi, kuvaus, esimerkki Tyyppi Party. Details Aggregaatilla annetaan tilaajan eli tilausperuutuksen tekijäorganisaation nimi-, tunniste- ja yhteystiedot. Esimerkki <cac:party> </cac:party> Toisto Tyyppi 0.. unbounded Party Identification. Details Party. Party Name Toisto 0.. unbounded Aggregaatilla annetaan tilaajan eli tilausperuutuksen tekijäorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> 2/33
6..6 Tyyppi Party Name. Details Aggregaatilla annetaan tilaajan eli tilausperuutuksen tekijäorganisaation nimitiedot. Esimerkki <cac:partyname> </cac:partyname> Party. Contact Toisto 0.. 6..7 Tyyppi Contact. Details Aggregaatilla annetaan tilaajan eli tilausperuutuksen tekijäorganisaation yhteyshenkilön tai -osaston tiedot Esimerkki <cac:contact> </cac:contact> 22/33
6..5 Tilaajan eli tilausperuutuksen tekijän 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 Tyyppi Party Identification. Details Aggregaatilla annetaan tilaajan eli tilausperuutuksen tekijäorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto.. Tyyppi Identifier. Type Elementillä annetaan tilaajan eli tilausperuutuksen tekijäorganisaation tunnus, jolla tilaaja tunnistetaan vastaanottajan järjestelmissä automaattisesti. Tässä elementissä annettava tunnus voi olla esimerkiksi OVT-tunnus, tilaajan tai toimittajan tunnistekoodiston mukainen tunnus. Attribuutit schemeid ja schemeagencyid Esimerkki <cbc:id schemeid="iso 6523" schemeagencyid="5"> 003702345672345</cbc:ID> Toisto 0.. Attribuutilla annetaan osapuolitunnistekoodiston tunnus Esimerkki schemeid="iso 6523" Käytettävät koodit ISO 6523 OVT- tunnus (Structure for the identification of organizations) Toisto 0.. Attribuutilla annetaan osapuolitunnuskoodiston ylläpitäjä. Esimerkki schemeagencyid="5" Käytettävät koodit 5 ISO (International Organization for Standardization) 9 (Assigned by seller or seller's agent) Toimittajan ylläpitämä luettelo 92 (Assigned by buyer or buyer's agent) Tilaajan ylläpitämä luettelo 23/33
6..6 Tilaajan eli tilausperuutuksen tekijän nimi (Party. Party Name) Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Party. Party Name Toisto 0.. unbounded Tyyppi Party Name. Details Aggregaatilla annetaan tilaajan eli tilausperuutuksen tekijäorganisaation nimitiedot. Esimerkki <cac:partyname> </cac:partyname> Party Name. Name Toisto.. Tyyppi Name. Type Elementillä annetaan tilaajan eli tilausperuutuksen tekijäorganisaation nimi Esimerkki <cbc:name>oy Sähkö Ab</cbc:Name> 24/33
6..7 Tilaajan eli tilausperuutuksen tekijän yhteyshenkilö tai -osasto ja yhteystiedot (Party. Contact) Elementti / aggregaatti Party. Contact Toisto 0.. Toistokerrat, tyyppi, kuvaus, esimerkki Tyyppi Contact. Identifier Toisto 0.. Contact. Details Aggregaatilla annetaan tilaajan eli tilausperuutuksen tekijäorganisaation yhteyshenkilön tai -osaston tiedot Esimerkki <cac:contact> </cac:contact> Tyyppi Identifier. Type Elementillä annetaan tilaajan eli tilausperuutuksen tekijä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 Toisto 0.. Tyyppi Name. Type Contact. Telephone. Text Toisto 0.. Contact. Electronic_ Mail. Text Elementillä annetaan tilaajan eli tilausperuutuksen tekijäorganisaation yhteyshenkilön tai -osaston nimi. Esimerkki <cbc:name>olli Ostaja</cbc:Name> Tyyppi Text. Type Elementillä annetaan tilaajan eli tilausperuutuksen tekijäorganisaation yhteyshenkilön tai -osaston puhelinnumero. Huomautus Joko puhelinnumero tai sähköpostiosoite on annettava. Esimerkki <cbc:telephone>03 234 5678<cbc:Telephone> Toisto 0.. Tyyppi Text. Type Elementillä annetaan tilaajan eli tilausperuutuksen 25/33
tekijäorganisaation yhteyshenkilön tai -osaston sähköpostiosoite. Huomautus Joko puhelinnumero tai sähköpostiosoite on annettava. Esimerkki <cbc:electronicmail>olli.ostaja@sahko.fi <cbc:electronicmail> 26/33
6..8 Toimittajan eli tilausperuutuksen vastaanottajan tiedot (Order. Seller_ Supplier Party. Supplier Party) Elementti / aggregaatti Order Cancellation. Seller_ Supplier Party. Supplier Party Supplier Party. Party 6..9 Toistokerrat, tyyppi, kuvaus, esimerkki Toisto.. Tyyppi Supplier Party. Details Aggregaatilla annetaan toimittajan eli tilausperuutuksen vastaanottajaorganisaation tiedot. Esimerkki <cac:sellersupplierparty> </cac:sellersupplierparty> Toisto 0.. Tyyppi Party. Details Aggregaatilla annetaan toimittajan eli tilausperuutuksen vastaanottajaorganisaation nimi- ja tunnistetiedot. Esimerkki <cac:party> </cac:party> 27/33
6..9 Toimittajan eli tilausperuutuksen vastaanottaja (Supplier Party. Party) Elementti / aggregaatti Supplier Party. Party Toisto 0.. Party. Party Identification 6..0 Party. Party Name 6.. Toistokerrat, tyyppi, kuvaus, esimerkki Tyyppi Party. Details Aggregaatilla annetaan toimittajan eli tilausperuutuksen vastaanottajaorganisaation nimi- ja tunnistetiedot. Esimerkki <cac:party> </cac:party> Toisto Tyyppi 0.. unbounded Party Identification. Details Aggregaatilla annetaan toimittajan eli tilausperuutuksen vastaanottajaorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto Tyyppi 0.. unbounded Party Name. Details Aggregaatilla annetaan toimittajan eli tilausperuutuksen vastaanottajaorganisaation nimitiedot Esimerkki <cac:partyname> </cac:partyname> 28/33
6..0 Toimittajan eli tilausperuutuksen vastaanottajan 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 Tyyppi Party Identification. Details Aggregaatilla annetaan toimittajan eli tilausperuutuksen vastaanottajaorganisaation tunnukset, joilla järjestelmät tunnistavat sen automaattisesti siirrettäessä tietoa sähköisesti. Esimerkki <cac:partyidentification> </cac:partyidentification> Toisto.. Tyyppi Identifier. Type Elementillä annetaan toimittajan eli tilausperuutuksen vastaanottajaorganisaation tunnus, jolla toimittaja tunnistetaan vastaanottajan järjestelmissä automaattisesti. Tässä elementissä annettava tunnus voi olla esimerkiksi OVT-tunnus, tilaajan tai toimittajan tunnistekoodiston mukainen tunnus. Attribuutit schemeid ja schemeagencyid Esimerkki <cbc:id schemeid="iso 6523" schemeagencyid="5"> 003723232</cbc:ID> Toisto 0.. Attribuutilla annetaan osapuolitunnistekoodiston tunnus. Esimerkki schemeid="iso 6523" Käytettävät koodit ISO 6523 OVT- tunnus (Structure for the identification of organizations) Toisto 0.. Attribuutilla annetaan osapuolitunnuskoodiston ylläpitäjä. Esimerkki schemeagencyid="5" Käytettävät koodit 5 ISO (International Organization for Standardization) 9 (Assigned by seller or seller's agent) Toimittajan ylläpitämä luettelo 92 (Assigned by buyer or buyer's agent) Tilaajan ylläpitämä luettelo 29/33
6.. Toimittajan eli tilausperuutuksen vastaanottajan nimi (Party. Party Name) Elementti / aggregaatti Toistokerrat, tyyppi, kuvaus, esimerkki Party. Party Name Toisto 0.. unbounded Tyyppi Party Name. Details Aggregaatilla annetaan toimittajan eli tilausperuutuksen vastaanottajaorganisaation nimitiedot. Esimerkki <cac:partyname> </cac:partyname> Party Name. Name Toisto.. Tyyppi Name. Type Elementillä annetaan toimittajan eli tilausperuutuksen vastaanottajaorganisaation nimi. Esimerkki <cbc:name>asennus Oy</cbc:Name> 30/33
7 Sanomaesimerkki Tässä kappaleessa on esimerkkejä UBL-OrderCancellation-tilausperuutuksesta. 7. UBL tilausperuutussanomaesimerkki <?xml version=".0" encoding="utf-8"?> <OrderCancellation xmlns:xsi="http://www.w3.org/200/xmlschema-instance" xmlns:qdt="urn:oasis:names:specification:ubl:schema:xsd:qualifieddatatypes-2" xmlns:ext="urn:oasis:names:specification:ubl:schema:xsd:commonextensioncomponents-2" xmlns:ccts="urn:oasis:names:specification:ubl:schema:xsd:corecomponentparameters-2" xmlns:udt="urn:un:unece:uncefact:data:specification:unqualifieddatatypesschemamodule:2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:commonbasiccomponents-2" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:commonaggregatecomponents-2" xmlns="urn:oasis:names:specification:ubl:schema:xsd:ordercancellation-2" xmlns:clm664="urn:un:unece:uncefact:codelist:specification:664:200" xmlns:clmianamimemediatype="urn:un:unece:uncefact:codelist:specification:ianamimemediatype:2003" xmlns:clm5427="urn:un:unece:uncefact:codelist:specification:5427:200" xmlns:clm5639="urn:un:unece:uncefact:codelist:specification:5639:988"> <cbc:ublversionid>2.0</cbc:ublversionid> <cbc:customizationid>et</cbc:customizationid> <cbc:profileid schemeagencyid="292">fi029</cbc:profileid> <cbc:id>234-c</cbc:id> <cbc:issuedate>2009-0-2</cbc:issuedate> <cbc:issuetime>09:36:08</cbc:issuetime> <cbc:note languageid="fi">tilauksen perustuu aiemmin käytyy puhelinkeskusteluun.</cbc:note> <cbc:cancellationnote languageid="fi">vahingossa toimitettu tilaus</cbc:cancellationnote> 3/33
<cac:orderreference> <cbc:id>234-ab</cbc:id> </cac:orderreference> <cac:buyercustomerparty> <cac:party> <cac:partyidentification> <cbc:id schemeid="iso 6523" schemeagencyid="5">003702345672345</cbc:id> </cac:partyidentification> <cac:partyname> <cbc:name>oy Sähkö Ab</cbc:Name> </cac:partyname> <cac:contact> <cbc:id>46</cbc:id> <cbc:name>olli Ostaja</cbc:Name> <cbc:telephone>03 234 5678</cbc:Telephone> <cbc:electronicmail>olli.ostaja@sahko.fi</cbc:electronicmail> </cac:contact> </cac:party> </cac:buyercustomerparty> <cac:sellersupplierparty> <cac:party> <cac:partyidentification> <cbc:id schemeid="iso 6523" schemeagencyid="5">003723232</cbc:id> </cac:partyidentification> <cac:partyname> <cbc:name>asennus Oy</cbc:Name> </cac:partyname> </cac:party> </cac:sellersupplierparty> </OrderCancellation> 32/33
8 Liite : Kappaleessa 6 Sanoman määrittely esiintyvien taulukoiden lukuohje Aggregaatin rakenne: Aggregaatissa vihreällä aggregaatin elementit Vieressä punaisella ala-aggregaatit Aggregaatin toistojen määrä sanomassa: Vaihtoehdot: valinnainen, esiintyy max. kertaa.. pakollinen, esiintyy kerran 0.. unbounded valinnainen, esiintyy useita kertoja.. unbounded pakollinen, esiintyy useita kertoja Aggregaatin tyyppi, aggregaatilla aina Details Selvitys aggregaatin käytöstä Esimerkki aggregaatin käytöstä sanomassa Aggregaatin nimi (nimi lihavoituna) Elementin toistojen määrä, vaihtoehdot samat kuin aggregaatilla Elementin tyyppi, useita vaihtoehtoja Selvitys elementin käytöstä Aggregaatissa esiintyvän elementin nimi Edellä olevan elementin attribuutti (tiedot harmaalla pohjalla) Aggregaatin ala-aggregaatin nimi ja linkki (lihavoituna) (Toisto-, Tyyppi-, ja Esimerkki-ruutujen selitys sama kuin pääaggregaatilla) Elementin käyttöön liittyvä huomautus Elementin attribuutit, jotka käytössä tässä soveltamisohjeessa Esimerkki elementti käytöstä sanomassa Attribuutin toistojen määrä, Vaihtoehdot: valinnainen, esiintyy max. kertaa.. pakollinen, esiintyy kerran Selvitys attribuutin käytöstä Esimerkki attribuutin käytöstä sanomassa 33/33