Toteutettu yhteistyössä Elintarviketeollisuusliitto ry:n ja Päivittäistavarakauppa ry:n kanssa osana maa- ja metsätalousministeriön kansallista elintarviketalouden laatustrategiaa Yleinen koostetieto ja sen soveltamisohje Osapuolitiedot 2007-03-21 Käyttö: Kaupan toimiala Sanasto: UBL Versio: 2.0
Komponentti: CustomerParty, SupplierParty, Party
Sisällysluettelo 1 Dokumenttien hallinta... 4 1.1 Päivitykset... 4 1.2 Esitietovaatimukset... 4 2 Määrittelyt... 4 2.1 Osapuoliroolit eri sanomilla... 4 2.2 Luokkamalli... 5 2.3 Osapuolen tietosisältö... 5 2.4 Roolikohtainen tietosisältö... 6 3 Esimerkit... 6
1 Dokumenttien hallinta Tässä dokumentissa on esitetty kaupan toimialan eri sanomilla toistuvien osapuolitietojen esittämistapa UBL 2.0 version mukaisena. Tätä dokumenttia ei tule käsitellä itsenäisenä kokonaisuutena vaan yhdessä sanomien soveltamisohjeiden sekä komponenttikirjaston kanssa. 1.1 Päivitykset Pvm/Laatija 2007-03-21 Juha Ikävalko Muutokset Ensimmäinen versio 1.2 Esitietovaatimukset Soveltamisohje soveltuu sekä johto- että asiantuntijatason käyttöön. Soveltamisohjeen teknisen taustan ymmärtämistä edesauttaa seuraavien aihealueiden tuntemus: XML, UBL ja ebxml ydinkomponentit. 2 Määrittelyt 2.1 Osapuoliroolit eri sanomilla Kaupan toimialan sanomiin sisältyvät seuraavat osapuoliroolit, perässä (P) mikäli pakollinen kyseisellä sanomalla: Tilaus & tilausvahvistus Tilauskuittaus Toimitustieto Lasku Ostaja (BuyerCustomerParty) X (P) X (P) X X Myyjä (SellerSupplierParty) X (P) X (P) X Laskutettava (AccountingCustomerParty) X X X (P) Laskuttaja (AccountingSupplierParty) Toimituksen vastaanottaja (DeliveryCustomerParty, DeliveryParty) Lähettäjä (DespatchSupplierParty) X (P) X (P) X (P) X (P) X (P) Toimitusterminaali (ConsigneeParty) X X Oletusarvoisesti ostaja ja laskutettava ovat yksi ja sama osapuoli, kuin myös myyjä, laskuttaja ja lähettäjä. Kullakin sanomalla välitetään näissä tapauksissa vain pakolliseksi asetetun osapuoliroolin mukaiset tiedot. 4/7
2.2 Luokkamalli Seuraavassa on esitetty osapuolitiedot luokkamallina. CustomerParty ja SupplierParty luokkiin sisältyy standardin mukaan joukko lisätietoja suhteessa Party luokkaan. Näille lisätiedoille ei ole nähty tässä yhteydessä tarvetta. Siten CustomerParty, SupplierParty ja Party tyyppisten osapuolitietojen maksimitietosisältö on näiden soveltamisohjeiden puitteissa sama. 2.3 Osapuolen tietosisältö Elementti Tyyppi Kuvaus PartyIdentification ASBIE Yleinen osapuolitunniste PartyName ASBIE Osapuolen nimi Käytetään ensisijaisesti OVT tunnistetta. Mikäli käytettävissä on vain yrityksen Y-tunnus, välitetään se yleisenä osapuolitunnisteena sekä osapuolen yritysrekisteritunnisteena. Tunnistejärjestelmän yksilöivät attribuutit on listattu komponenttikirjaston yhteydessä. PostalAddress ASBIE Osapuolen postiosoite PartyTaxScheme ASBIE Osapuolen verotiedot 5/7
Välitetään tarvittaessa laskuttajan ja laskutettavan osapuolitietojen yhteydessä. Tämä on näiden osapuolien osalta pakollinen tieto kansainvälisessä kaupankäynnissä. PartyLegalEntity ASBIE Osapuolen yritysrekisteritiedot 2.4 Roolikohtainen tietosisältö Seuraavassa on listattu osapuolitietojen esiintyminen eri osapuoliroolien yhteydessä. Ostaja Myyjä Laskutettava Laskuttaja Toimituksen vastaanottaja Lähettäjä Toimitusterminaali PartyIdentification 1 1 1 1 1 1 1 PartyName 1 1 1 1 1 1 1 PostalAddress 0..1 0..1 0..1 0..1 0 0 0 PartyTaxScheme 0..n 0..n 0..n 0..n 0 0 0 PartyLegalEntity 0..1 0..1 0..1 0..1 0..1 0..1 0..1 3 Esimerkit Seuraavassa on esitetty CustomerParty luokan käyttö Ostaja osapuoliroolissa kahden esimerkin avulla. 1. Esimerkki (attribuutit jätetty pois) <cac:buyercustomerparty> <cac:party> <cac:partyidentification> <cbc:id>ostajan_ovt_tunniste</cbc:id> </cac:partyidentification> <cac:partyname> <cbc:name>ostajan_nimi</cbc:name> </cac:partyname> <cac:postaladdress> <cbc:streetname>katuosoite</cbc:streetname> <cbc:cityname>postitoimipaikka</cbc:cityname> <cbc:postalzone>postinumero</cbc:postalzone> <cac:country> <cbc:identificationcode>iso3166-1_maakoodi</cbc:identificationcode> 6/7
</cac:country> </cac:postaladdress> <cac:partytaxscheme> <cbc:companyid>yrityksen_alv_tunnus</cbc:companyid> <cac:taxscheme> <cbc:id>verolajin_tunniste</cbc:id> </cac:taxscheme> </cac:partytaxscheme> <cac:partylegalentity> <cbc:companyid>yrityksen_y_tunnus</cbc:companyid> </cac:partylegalentity > </cac:party> </cac:buyercustomerparty> 2. Esimerkki <cac:buyercustomerparty> <cac:party> <cac:partyidentification> <cbc:id schemeid= ISO 6523 >00371234567812345</cbc:ID> </cac:partyidentification> <cac:partyname> <cbc:name>ostaja Oy Ab</cbc:Name> </cac:partyname> <cac:postaladdress> <cbc:streetname>mannerheimintie 1</cbc:StreetName> <cbc:cityname>helsinki</cbc:cityname> <cbc:postalzone>00100</cbc:postalzone> <cac:country> <cbc:identificationcode>fi</cbc:identificationcode> <cbc:name>suomi</cbc:name> </cac:country> </cac:postaladdress> <cac:partytaxscheme> <cbc:companyid schemeid= FI:VAT >FI12345678</cbc:CompanyID> <cac:taxscheme> <cbc:id schemeid= UN/ECE 5153 >VAT</cbc:ID> </cac:taxscheme> </cac:partytaxscheme> <cac:partylegalentity> <cbc:companyid schemeid= FI:ORGNR >1234567-8</cbc:CompanyID> </cac:partylegalentity > </cac:party> </cac:buyercustomerparty> 7/7