Komponenttikirjasto. Komponenttikirjasto ja sen yleinen soveltamisohje , v 1.01

Transkriptio

1 Toteutettu yhteistyössä Elintarviketeollisuusliitto ry:n ja Päivittäistavarakauppa ry:n kanssa osana Maa- ja metsätalousministeriön kansallista elintarviketalouden laatustrategiaa Komponenttikirjasto ja sen yleinen soveltamisohje Komponenttikirjasto , v 1.01 Käyttö: Kaupan toimiala Sanasto: UBL Versio: 2.0

2 Sisällysluettelo 1 Dokumenttien hallinta Päivitykset Dokumentin rakenne Lyhenteet ja termit Johdanto UBL:n tavoitteet ja hyödyt Soveltamisohjeen perusteet, tarkoitus ja käyttö Soveltamisohjeen sisältö Tekniset määritykset Kooste-elementtien esittämistapa Graafisten kuvausten merkinnät Attribuutit Kooste-elementit Osoite (Address) Alennukset ja lisät (AllowanceCharge) Liite (Attachment) Laskutusviite (BillingReference) Pankkikonttori (Branch) Tuoteluokittelu (CommodityClassification) Lähetyserä (Consignment) Maa (Country) Asiakasosapuoli (CustomerParty) Toimitus (Delivery) Toimitusehdot (DeliveryTerms) Lähetys (Despatch) Mitta-arvo (Dimension) Viite/Liite (DocumentReference) Valuuttakurssi (ExchangeRate) Ulkoinen viite (ExternalReference) Pankkitili (FinancialAccount) Finanssi-instituutio (FinancialInstitution) Tuote (Item) Tuotetunniste (ItemIdentification) Yksilöity tuote (ItemInstance) Tuotteen ominaisuus (ItemProperty)... 40

3 3.23 Riviviite (LineReference) Sijainti (Location) Tuote-erä (LotIdentification) Rahallinen yhteenveto (MonetaryTotal) Tilattu toimituserä (OrderedShipment) Tilausriviviite (OrderLineReference) Tilausviite (OrderReference) Pakkaus (Package) Osapuoli (Party) Osapuolitunniste (PartyIdentification) Osapuolen yritysrekisteritiedot (PartyLegalEntity) Osapuolen nimi (PartyName) Osapuolen verotiedot (PartyTaxScheme) Maksutapa (PaymentMeans) Maksuehdot (PaymentTerms) Ajanjakso (Period) Hinta (Price) Toimituserä (Shipment) Kuljetusetappi (ShipmentStage) Toimittajaosapuoli (SupplierParty) Verokohtelu (TaxCategory) Verolaji (TaxScheme) Verolajin verokantakohtainen erittely (TaxSubtotal) Verolajikohtainen veroerittely (TaxTotal) Kollitiedot (TransportHandlingUnit) Kuljetustapa (TransportMeans)... 75

4 1 Dokumenttien hallinta Tässä dokumentissa on esitetty kaupan toimialan eri sanomilla toistuvien tietojen esittämistapa UBL 2.0 version mukaisena. Ohjelmistototeuttajalle tämä dokumentti antaa kokonaiskuvan tietoista, joita tulee pystyä käsittelemään eri sanomilla. Tätä dokumenttia ei tule käsitellä erillisenä kokonaisuutena vaan yhdessä sanomien soveltamisohjeiden kanssa. 1.1 Päivitykset Pvm/Laatija Juha Ikävalko Heikki Laaksamo Muutokset Ensimmäinen versio Muutettu kappaleessa teksti <oxygen/> XML editorin pyykkinarukuvaa muotoon GEFEG FX ohjelmiston rakennekaaviota Muutettu kappaleessa taulukon sarakkeen Notaatio merkinnät vastaamaan GEFEG FX ohjelmiston kuvioiden notaatioita. Muutettu kappaleen 3 kuvat GEFEG FX ohjelmiston kuviksi. Lisätty lukuun 3.9 Asiakasosapuoli (CustomerParty) käyttökohde OriginatorCustomerParty 1.2 Dokumentin rakenne Dokumentissa listataan kaupan toimialalla käytettävät UBL kirjaston kooste-elementit sekä määritellään ja rajataan niiden tietosisältö. Sanomissa käytettävät kooste-elementit, joiden tietosisältöä on rajattu tai muuten tarkennettu tässä esitettyyn nähden, on esitetty sanomakohtaisissa soveltamisohjeissa kappaleessa Sanomakohtaiset kooste-elementit. 1.3 Lyhenteet ja termit Lyhenne ABIE ASBIE BIE BBIE CAC Kuvaus (Aggregate Business Information Entity) eli kooste-elementti rakentuu (BBIE) peruselementeistä ja (ASBIE) viittauksista toisiin kooste-elementteihin. ABIE muodostuu joukosta toisiinsa liittyviä tietoja kuten osoitetiedot (Address). (Association Business Information Entity) kooste-elementin ominaisuus, joka on viite toiseen kooste-elementtiin. (Business Information Entity) on ydinkomponentti, jolla on tietty liiketoiminnallinen merkitys (Osoite (CC) Toimitusosoite (BIE)) (Basic Business Information Entity) on peruselementti, joka kuvaa yhden kooste-elementin ominaisuuden, kuten postinumeron. (Common Aggregate Components) ovat UBL:n määrittelemiä 4/75

5 uusiokäytettäviä kooste-elementtejä. CBC CC CCT CCTS ebxml EDI SDT UBL UDT W3C XML Schema XML (Common Basic Components) ovat UBL:n määrittelemiä uusiokäytettäviä peruselementtejä. (Core Component) on yleistermi eri ydinkomponenteille. (Core Component Types) ovat CCTS:n määrittämät ydintietotyypit, joihin ydinkomponentit perustuvat. ebxml (Core Component Technical Specification) määrittää syntaksiriippumattomalla tasolla, miten uusiokäytettävät tietoelementit tulee rakentaa. (Electronic Business using XML) on joukko spesifikaatioita, joiden tarkoituksena on mahdollistaa kansainvälinen sähköinen kaupankäynti kaikenkokoisten yritysten välillä. (Electronic Data Interchange) tarkoittaa sähköistä tiedonsiirtotapaa yritystenvälisessä tiedonvälityksessä. (Specialized Data Types) ovat UDT tietotyypeistä johdettuja erikoistuneita tietotyyppejä, joiden tietosisältöä UBL on tarkentanut määrittämällä tietotyypille esimerkiksi sallitut arvot sisältävän koodilistan. (Universal Business Language) määrittää joukon uusiokäytettäviä tietoelementtejä sekä joukon niihin pohjautuvia XML muotoisia sanomia. (Unspecialized Data Types) eli erikoistumattomat tietotyypit ovat UBL:n määritelmähierarkiassa alimpina perustuen CCT tietotyyppeihin. on UBL-sanomien rakenteen kuvaamiseen ja sen oikeellisuuden tarkistamiseen (validointiin) käytetty kieli. (extensible Markup Language) on rakenteellisen tiedon kuvaamiseen käytetty kieli. 5/75

6 2 Johdanto 2.1 UBL:n tavoitteet ja hyödyt UBL-liiketoimintasanasto pohjautuu UN/CEFACTin ja OASIS-organisaation ebxmlhankkeessa aloitettuun työhön toteuttaa toimialariippumaton sähköisen kaupankäynnin viitekehys. UBL määrittää välitettävien sanomien rakenteen ja tietosisällön. Sen mallinnustapa perustuu ebxml Core Components Technical Specification:in (CCTS) määrittämään tapaan muodostaa uusiokäytettäviä tietoelementtejä. XML hyväksyttiin W3C:n suositukseksi vuonna 1998, jonka jälkeen sen käyttö levisi nopeasti eri toimialoille. Tuloksena oli joukko toimialakohtaisia liiketoimintasanastoja. Tällä on joukko varjopuolia: Rinnakkaisten liiketoimintadokumenttien (kuten tilaukset ja laskut) määrittäminen ja ylläpitäminen on resurssien tuhlausta. Useiden sanomamuuntimien (adapterien) luominen ja ylläpitäminen kauppakumppanuuksien mahdollistamiseksi eri toimialoille on vielä suurempaa resurssien tuhlausta. Useiden XML-formaattien olemassa olo vaikeuttaa XML syntaksiin perustuvan liiketoimintaviestinnän integroimista taustajärjestelmiin. Useiden XML formaattien tukeminen tekee käytettävistä työkaluista kalliimpia ja koulutettujen työntekijöiden löytämisestä vaikeampaa. Kansainvälisen toimialariippumattoman XML-sanaston odotetaan tuottavan seuraavia etuja: Alhaisemmat integrointikustannukset, yritysten sisällä sekä niiden välillä, yhteisten tietorakenteiden uusiokäytön myötä Kaupallisten ohjelmistojen alhaisemmat kustannukset, koska on helpompaa kehittää ohjelmisto käsittelemään rajattua kuin rajaamatonta tagi joukkoa Nopeampi oppiminen, koska käyttäjien tulee hallita vain yksi sanasto Alhaisemmat aloituskustannukset Standardoitu koulutus, monia koulutettuja työntekijöitä Suuri joukko järjestelmäintegraattoreita Standardoidut ja edulliset työkalut tiedonkäsittelyyn 2.2 Soveltamisohjeen perusteet, tarkoitus ja käyttö Perusteena työn tekemiselle oli kansallisen suosituksen luominen, joka ehkäisisi yhteentoimimattomien standardien syntymistä ja laskisi näin liiketoimintaprosessien integrointikustannuksia. Tavoitteena on myös nopeuttaa uuden tiedonsiirtotavan omaksumista kansainvälisen kilpailukyvyn säilyttämiseksi ja parantamiseksi. Soveltamisohje on tarkoitettu apuvälineeksi uusien kauppakumppanien välisiin neuvotteluihin sekä pohjaksi mahdollisten kumppanikohtaisten soveltamisohjeiden laatimisille. 6/75

7 2.3 Soveltamisohjeen sisältö Tekniset määritykset Käytettävä merkistö Dokumenttien siirrossa suositellaan käyttämään sekä UBL:n että NES:n suosittamaa UTF-8 merkistöä (Unicode Transformation Format 8). Desimaalien käyttö Desimaalien maksimimääriksi suositellaan seuraavaa: Määrät ja painot Hinnat ja rahasummat Veron määrät Prosentit Valuuttojen vaihtokurssit 7/75 max 4 desimaalia max 4 desimaalia max 4 desimaalia max 4 desimaalia max 6 desimaalia Maksettavat määrät ja muut loppusummatasoiset tiedot saavat sisältää vai kaksi desimaalia. On suositeltavaa, että edellä mainittujen desimaalimäärien ylittyessä desimaalit pyöristetään maksimimittaansa, eikä lukua vain katkaista. On kuitenkin huomattava, että veroerittelyjen ja loppusumman välillä ei saa olla pyöristyksistä johtuvia eroja. W3C XML Schema tietotyyppi xsd:decimal, johon UBL:n numeeriset tietoelementit perustuvat, edellyttää pisteen (.) käyttämistä desimaalierottimena. Lisäksi välilyöntien käyttö tuhaterottimena on kielletty ( ). Valuutan ilmoittaminen Valuuttatieto ilmoitetaan määrätiedon attribuutilla ISO 4217 koodilistan mukaisesti. Päiväyksen muoto UBL:ssä päivämäärät pohjautuvat W3C:n xsd tietotyyppeihin: date, datetime. Päivämäärät (xsd:date) esitetään yhdysviivoin muodossa: YYYY-MM-DD. Aikavyöhyke voidaan tarvittaessa huomioida kahdella eri tapaa. Päivämäärän perään voidaan lisätä Z muodossa Z, kun halutaan esittää, että aika on ilmaistu UTC (GMT) ajassa. Kun halutaan esittää mahdollinen aikavyöhyke, voidaan se ilmaista lisäämällä päivämäärän perään joko positiivinen (+) tai negatiivinen (-) luku, joka ilmoittaa aikaeron UTC:hen muodossa: :00. Aikaleimat (xsd:datetime) (päivämäärä ja kellonaika) esitetään muodossa: YYYY-MM- DDThh:mm:ss, missä T ilmaisee kellonaikaosan alkua. Kuten päivämäärän kohdalla aikaleimassa käytetty aikavyöhyke voidaan ilmaista joko Z merkintää tai aikaeroa kuvaava aikaa käyttäen muodossa: T16:00:00Z tai T16:00:00+02:00. Osapuolten tunnistaminen Sanomien tarkastettavuuden ja mahdollisten virhetilanteiden selvittämisen helpottamiseksi on osapuolen nimi asetettu pakolliseksi osapuolitunnisteen ohella. Tunnisteiden ja koodistojen käyttö Kunkin koodin ja tunnisteen osalta on pyritty määrittämään ensisijainen koodisto tai tunnistejärjestelmä. Käytettäessä ensisijaista koodistoa tai tunnistejärjestelmää on sen yksilöiminen attribuutein vapaaehtoista. Käytettäessä muita koodistoja on attribuuttien käyttö pakollista. Muiden koodistojen käyttö edellyttää lisäksi kumppanikohtaista sopimusta.

8 Yleisimmin käytetyt attribuutit ja niiden mahdolliset arvot on listattu kappaleessa Soveltamisohjeessa käytetyt attribuutit. Tapauskohtaisemmat koodit on listattu kunkin kooste-elementin yhteydessä. Tyhjien elementtien siirtäminen ja käsittely UBL-suosituksen mukaisesti sanomilla ei siirretä tyhjiä elementtejä. Mikäli elementillä ei ole sisältöä, jätetään myös elementin tunniste (tag) siirtämättä. Sanomalla ei siten siirretä tietoja muodossa <Elementtinimi/> tai <Elementtinimi></Elementtinimi>. Sanomalla vain keskeiset tiedot on asetettu pakollisiksi. Tästä huolimatta saattaa olla tilanteita, joissa tietty elementti on standardin mukaan pakollinen, mutta kyseistä tietoa ei ole saatavilla. Tämä koskee erityisesti osia tunnistetiedoista. Seuraavassa on listattu suositeltavat dummy -arvot käytettäväksi näissä tilanteissa: - Tunniste (ID): ID_NOT_AVAILABLE - Koodi (Code): CODE_NOT_AVAILABLE Kooste-elementtien esittämistapa Kappaleeseen 3 Sanoman rakenne esitellään sanomaan sisältyvät kooste-elementit omina kappaleinaan. Kooste-elementtien esitystapa käsitellään lyhyesti tässä kappaleessa. Kukin kappale on otsikoitu kooste-elementin nimen mukaisesti. Mikäli kooste-elementti sisältää viittauksia muihin kooste-elementteihin (ASBIE), on nämä esitetty kyseisen kappaleen alaotsikkoina. Kunkin otsikon alla on notaatio tai notaatiot, jotka ilmaisevat, mitkä ovat kyseisen koosteelementin mahdolliset käyttökohteet. Esimerkiksi notaatio Address.Country ilmaisee, että kooste-elementti Country tiedot voidaan esittää Address kooste-elementin alla. XMLsyntaksina tämä vastaa rakennetta: <Address> <Country> </Country> </Address> Käyttökohteiden jälkeen on tarvittaessa kappale, joka selventää kooste-elementin käyttöä sanomalla. Tätä seuraa kuva kooste-elementin standardimuotoisesta rakenteesta sisältäen myös tiedot, joita ei ole otettu osaksi tämän soveltamisohjeen rajaamaa sanoman tietosisältöä. Kuvan alla on taulukko, jossa on listattu kooste-elementin osat, joita soveltamisohjetyössä on nähty katettavan käyttötarpeen osalta tarvittavan. Listaan on sisällytetty myös mahdolliset lisäykset, jotka on räätälöity osaksi sanomamääritystä. Käytettävät elementtien attribuutit on esitetty taulukossa muodossa ELEMENTIN_NIMI[@ATTRIBUUTIN_NIMI]. Jotta erityyppiset taulukon rivit erottuisivat toisistaan, on taulukkoon lisätty Tyyppi sarake, jonka mahdollisia arvoja ovat: Tyyppi BBIE ATTR Kuvaus (Basic Business Information Entity) on UBL/CCTS-termi, joka ilmaisee kyseessä olevan yksinkertaisen tietoelementin, jolla ei ole sisäistä rakennetta. Tällaisia ovat esimerkiksi tunniste-, koodi- ja päivämäärätiedot. (Attribute) ilmaisee, että kyseessä on BBIE-tietoelementin tarkenne. Esimerkiksi notaatio ID[@schemeID] ilmaisee schemeid:n olevan ID tietoelementin tarkenne. Tarkenne esitetään sanomalla XML-elementin attribuuttina. 8/75

9 ASBIE (Association Business Information Entity) on UBL/CCTS-termi, joka ilmaisee, että kyseessä on viittaus toiseen kooste-elementtiin eli tietoelementtiin, jolla on sisäinen rakenne. Tällaisia ovat esimerkiksi osapuoli- ja osoitetiedot. Attribuuttien osalta Toisto sarake ilmaisee, montako kertaa ko. attribuutti toistuu sen sisältävää elementtiä kohden eli käytännössä, onko se kyseisen elementin suhteen pakollinen vai vapaaehtoinen. Taulukon alla on listattu niiden koodien (Code) ja tunnisteiden (ID) arvot, joille on yleisesti sovittu merkintätapa. Pääosin näitä listoja käytetään elementtien tietosisällön tarkentamiseen eli teknisellä tasolla elementtien attribuuttien arvojen määrittämiseen. Käytettävien koodien osalta on pyritty seuraamaan NES - työryhmän suosituksia. Käytössä on sekä ISO, UN/ECE ja NES koodilistoja, joita on tarpeen vaatiessa täydennetty kotimaisilla Z-alkuisilla koodeilla Graafisten kuvausten merkinnät Sanoman eri tasot on kuvattu tietosisältöä visuaalisesti havainnollistavalla mallilla, jona on käytetty GEFEG FX ohjelmiston rakennekaaviota elementtien suhteista. Alla olevassa taulukossa on listattuna mallissa käytettyjen notaatioiden määritelmät: Notaatio blankko Määritelmä Pakollinen, esiintyy yhden kerran Ei pakollinen, mutta voi esiintyä vain kerran 1..* Elementin tulee esiintyä vähintään kerran ja se voi esiintyä useita kertoja. 0.. * Elementin käyttö on vapaaehtoista, mutta se voi esiintyä useita kertoja Attribuutit Attribuuttien käytön osalta noudatetaan NES-ohjeistusta. UBL elementteihin voidaan sisällyttää attribuutteja tarkentamaan elementin tietosisältöä. Seuraaviin elementtien käyttöön liittyy aina pakollinen attribuutti: Lukumäärä (Quantity), attribuutti: unitcode Mitta (Measure), attribuutti: unitcode Rahamäärien (Amount), attribuutti: currencyid Näiden osalta käytettävät koodit on listattu alla olevassa taulukossa, eikä niitä siten enää erikseen käsitellä kooste-elementtien tietosisällön yhteydessä. NES-suosituksen mukaan seuraavien elementtien käyttöön liittyy ehdollisesti pakollisia attribuutteja: Tunniste (ID), attribuutit: schemeagencyid ja schemeid Koodi (Code), attribuutit: listagencyid ja listid Tunnisteiden osalta schemeid on pakollinen ja schemeagencyid on suositeltava, kun käytetään yleistä ulkoista (external) tunnistejärjestelmää, kuten OVT, GLN tai GTIN. Käytettäessä lähettäjän tai vastaanottajan sisäistä (internal) tunnistejärjestelmää, on attribuuttien käyttö vapaaehtoista lukuun ottamatta osapuolitunnistetta (PartyIdentification.ID), jonka tunnistejärjestelmän ylläpitäjä on yksilöitävä 9/75

10 schemeagencyid -attribuutilla. Yleisesti käytettyjä sisäisiä tunnisteita ovat muun muassa sanoman tai rivin tunniste. Koodien osalta sekä listagencyid ja listid ovat pakollisia, kun käytetään muuta kuin UBL:n suosittelemaa koodilistaa. Käytettäessä UBL:n suosittelemaa listaa, on attribuuttien käyttö vapaaehtoista. UBL:n nimeämissääntöjen mukaisesti kaikki elementit, joiden nimi päättyy esimerkiksi Code -termiin perustuvat Code-tietotyyppiin. Samaan tietotyyppiin perustuvissa elementeissä käytetään samoja attribuutteja. Seuraavassa on listattu UBL:n yleisimmät attribuutit tietotyypeittäin: Tietotyyppi Attribuutti Toisto Määritelmä ID schemeagencyid Tunnistejärjestelmän ylläpitäjän tunniste Käytetään UN/ECE 3055 koodeja. Koodit yleisimmille ylläpitäjille: 1 World Customs Organization 4 International Chamber of Commerce 5 ISO 6 UN/ECE 9 GS1 (entinen EAN) 17 S.W.I.F.T 31 Finnish State Railway 91 Assigned by seller 92 Assigned by buyer 158 Finnish Customs Lisäksi käytetään seuraavia koodeja: CEN European Committee for Standardization NES NES UBL OASIS Universal Business Language ID schemeid Tunnistejärjestelmän tunniste Ei standardoitua listaa. Attribuutin arvo yksilöidään elementtikohtaisesti NESsuosituksen mukaisesti. Code listagencyid Koodilistan ylläpitäjän tunniste Code listid Koodilistan tunniste Käytetään UN/ECE 3055 koodeja. Esimerkit yllä schemeagencyid:n yhteydessä. Käytetään yhdessä listagencyid:n kanssa. Suositeltavia koodistoja ovat etenkin ISO:n ja YK:n EDIFACT koodistot sekä YK:n kauppamenettelysuositukset, jotka yksilöidään 10/75

11 UBL 2.0 version merkintätavan mukaisesti. ISO -koodiston yksilöinti: Text, Name languageid Kielen tunniste ISO [koodiston_tunnistenumero], esimerkiksi ISO 668 YK:n EDIFACT -koodiston yksilöinti: UN/ECE [koodiston_tunnistenumero], esimerkiksi UN/ECE 5025 Kauppamenettelysuosituksen yksilöinti: UN/ECE rec [suosituksen_numero], esimerkiksi UN/ECE rec 20 ISO 639-1:n mukainen kaksikirjaiminen koodi, joka määrittää kielen, jolla elementin tietosisältö on esitetty. Quantity unitcode 1 Lukumäärän yksikkö YK:n kauppamenettelysuosituksen numero 20 mukainen koodi, joka määrittää laskennallisen suureen mittayksikön (Recommendations > List of Recommendation) Measure unitcode 1 Mitta-arvon yksikkö EDIFACT-sanomissa usein käytetty PCE koodi on nykysuosituksessa C62. YK:n kauppamenettelysuosituksen numero 20 mukainen koodi, joka määrittää mitattavan suureen mittayksikön (Recommendations > List of Recommendation) Koodit, yleisimmille mitoille: KGM, kilo MTR, metri MTQ, kuutiometri Amount currencyid 1 Valuuttayksikkö YK:n kauppamenettelysuosituksen numero 9 ja ISO 4217 mukainen koodi, joka määrittää rahamäärän valuutan (Recommendations > List of 11/75

12 Recommendation) Koodit, yleisimmille valuutoille: DKK, Tanskan kruunu EEK, Viron kruunu EUR, Euro NOK, Norjan kruunu RUR, Venäjän rupla SEK, Ruotsin kruunu USD, Yhdysvaltain dollari 12/75

13 3 Kooste-elementit 3.1 Osoite (Address) Item.OriginAddress Location.Address Party.PostalAddress Address. Details Address. Identifier Address. Address Type Code. Code Address. Address Format Code. Code Address. Postbox. Text Address. Floor. Text Address. Room. Text Address. Street Name. Name Address. Additional_ Street Name. Name Address. Block Name. Name Address. Building Name. Name Address. Building Number. Text Address. Inhouse_ Mail. Text Address. Department. Text Address. Mark Attention. Text Address. Mark Care. Text Address. Plot Identification. Text Address. City Subdivision Name. Name Address. City Name. Name Address. Postal_ Zone. Text Address. Country Subentity. Text Address. Country Subentity Code. Code Address. Region. Text Address. District. Text Address. Timezone Offset. Text Address. Address Line Address. Country Address. Location Coordinate Postiosoitteen (PostalAddress) tulee aina sisältää postilokero tai katusoite. Fyysistä paikkaa kuvaavan osoitteen (Location.Address) yhteydessä tulee aina olla katuosoite postilokeron sijaan. Toimitusosoitteessa (DeliveryLocation.Address) katuosoite, postitoimipaikka, postinumero ja maakoodi ovat aina pakollisia tietoja. Postbox BBIE Postilokero StreetName BBIE Katuosoite CityName BBIE Postitoimipaikka PostalZone BBIE Postinumero Country ASBIE Maa 13/75

14 3.2 Alennukset ja lisät (AllowanceCharge) Invoice.AllowanceCharge InvoiceLine.AllowanceCharge Allowance Charge. Details Allowance Charge. Identifier Allowance Charge. Charge_ Indicator. Indicator Allowance Charge. Allowance Charge Reason Code. Code Allowance Charge. Allowance Charge_ Reason. Text Allowance Charge. Multiplier_ Factor. Numeric Allowance Charge. Prepaid_ Indicator. Indicator Allowance Charge. Sequence. Numeric Allowance Charge. Amount Allowance Charge. Base_ Amount. Amount Allowance Charge. Accounting Cost Code. Code Allowance Charge. Accounting Cost. Text Allowance Charge. Tax Category Allowance Charge. Tax Total Allowance Charge. Payment Means ID BBIE Alennuksen/lisän tunniste Toimittajakohtainen tunniste ChargeIndicator BBIE 1 Alennus vai lisä true => lisä, false => alennus AllowanceChargeReasonCode BBIE Alennus-/lisäkoodi AllowanceChargeReason BBIE Alennus-/lisäteksti Peruste alennukselle/lisälle. Käytetään alennusten osalta UBL:n mukaisesti UN/ECE 4465 koodistoa. Lisien osalta käytetään kaupan toimialalla UN/ECE 7161 koodistoa. Sallitut arvot on listattu alla. Voidaan käyttää syykoodin ohessa tarkentamaan alennuksen tai lisän perustetta. MultiplierFactorNumeric BBIE Alennus-/lisäprosentti (kerroin) Käytetään vain alennuksen tai lisän perustearvon yhteydessä. Informatiivinen tieto, joka voidaan antaa lisän tai alennuksen määrän ohella. 14/75

15 SequenceNumeric BBIE Laskentajärjestys Mikäli kaikki alennukset/lisät kohdistuvat samaan perustearvoon, on SequenceNumeric tällöin kunkin kohdalla 1. Amount BBIE 1 Alennuksen/lisän määrä BaseAmount BBIE Alennuksen tai lisän perustearvo TaxCategory ASBIE Verokohtelu AllowanceChargeReasonCode:n attribuutit: Koodisto listagencyid listid Käytetään vain alennus-/lisäprosentin yhteydessä. Informatiivinen tieto, joka voidaan antaa lisän tai alennuksen määrän ohella. Alennukseen/lisään liittyvä verokohtelu. Käytetään, kun alennukseen tai lisään liittyvä verokohtelu eroaa tuotteen verokohtelusta. Alennusten koodit: UN/ECE 4465 (Oletusarvoinen koodisto) ei käytetä ei käytetä Lisien koodit: UN/ECE 7161 (Toimialakohtainen laajennos) 6 UN/ECE 7161 AllowanceChargeReasonCode koodit alennusten osalta [UN/ECE 4465]: Koodi Kuvaus 19 Trade discount Trade discount deducted from payment. Käytetään oletusarvoisesti loppuasiakkaille edelleen menevien alennusten osalta. 74 Quantity discount Adjustment due to a quantity discount. Määräalennus 75 Promotion discount Adjustment due to a promotion discount. Kampanja-alennus 15/75

16 78 Volume discount Discount for reaching or exceeding an agreed accumulated volume. Vuosiostoalennus ZLP Laskutuspalkkio Käytetään oletusarvoisesti keskusliikkeelle suunnattujen alennusten osalta. AllowanceChargeReasonCode koodit lisien osalta [UN/ECE 7161]: Koodi AAT DL FC MAC PC WH Kuvaus Rush delivery Pikatoimituslisä Delivery Toimitusmaksu Freight charge Rahtimaksu Minimum order/billing charge Pientoimituslisä Packaging service Pakkauskulut Warehousing Varastointi 16/75

17 3.3 Liite (Attachment) DocumentReference.Attachment Attachment. Details Attachment. Embedded_ Document. Binary Object Attachment. External Reference Liite välitetään joko binääritiedostona sanoman sisällä tai URI viittauksena erillisesti ladattavaan tiedostoon. Liite ei voi sisältää samanaikaisesti molempia. EmbeddedDocumentBinaryObject BBIE Binääritiedosto ExternalReference ASBIE Ulkoinen viite Liite dokumentti sanomaan sisällytettynä binääritiedostona, jonka metatiedot välitetään XML attribuutteina. Mahdolliset attribuutit on määritelty BinaryObject tietotyypin (UDT) yhteydessä. Viittaus erillisesti ladattavaan dokumenttiin. 17/75

18 3.4 Laskutusviite (BillingReference) Invoice.BillingReference Billing Reference. Details Billing Reference. Invoice_ Document Reference. Document Reference Billing Reference. Self Billed Invoice_ Document Reference. Document Reference Billing Reference. Credit Note_ Document Reference. Document Reference Billing Reference. Self Billed Credit Note_ Document Reference. Document Reference Billing Reference. Debit Note_ Document Reference. Document Reference Billing Reference. Reminder_ Document Reference. Document Reference Billing Reference. Additional_ Document Reference. Document Reference Billing Reference. Billing Reference Line InvoiceDocumentReference ASBIE 1 Laskuviite Käytetään esimerkiksi hyvitys- ja lisäveloituslaskulla viittaamaan edeltävään laskuun, jota hyvitys tai lisäveloitus koskee. 18/75

19 3.5 Pankkikonttori (Branch) FinancialAccount.Branch Branch. Details Branch. Identifier Branch. Name Branch. Financial Institution Branch. Address ID BBIE Pankkikonttorin tunniste FinancialInstitution ASBIE 1 Finanssi-instituution (pankin) tiedot 19/75

20 3.6 Tuoteluokittelu (CommodityClassification) Item.CommodityClassification Commodity Classification. Details Commodity Classification. Nature Code. Code Commodity Classification. Cargo Type Code. Code Commodity Classification. Commodity Code. Code Commodity Classification. Item Classification Code. Code CommodityCode BBIE Tuotetyypin tai tavararyhmän koodi CommodityCode:n attribuutit: Koodisto listagencyid listid Customs article number CN-nimikkeistö, EU:n yhdistetty nimikkeistö, jonka 8-numeroisia nimikkeitä käytetään vienti-ilmoituksissa ja sisäkaupan tilastoilmoituksissa. Harmonised system Tullinimike 2 CV 1 HS National product group code VALTRY (Valtakunnallinen tavararyhmä) ZST GN 20/75

21 3.7 Lähetyserä (Consignment) Shipment.Consignment Samalla lähetyskerralla tavaran lähettäjältä vastaanottajalle toimitettavat tuotteet, joiden kuljettamisessa käytetään yhtä tai useampaa kuljetustapaa. Consignment. Details Consignment. Identifier Consignment. Summary_ Description. Text Consignment. Total_ Invoice Amount. Amount Consignment. Declared Customs_ Value. Amount Consignment. Tariff Description. Text Consignment. Tariff Code. Code Consignment. Insurance Premium Amount. Amount Consignment. Gross_ Weight. Measure Consignment. Net_ Weight. Measure Consignment. Net Net_ Weight. Measure Consignment. Chargeable_ Weight. Measure Consignment. Gross_ Volume. Measure Consignment. Net_ Volume. Measure Consignment. Loading_ Length. Measure Consignment. Remarks. Text Consignment. Hazardous Risk_ Indicator. Indicator Consignment. Consignee_ Party. Party Consignment. Exporter_ Party. Party Consignment. Consignor_ Party. Party Consignment. Importer_ Party. Party Consignment. Carrier_ Party. Party Consignment. Freight Forwarder_ Party. Party Consignment. Notify_ Party. Party Consignment. Original Despatch_ Party. Party Consignment. Final Delivery_ Party. Party Consignment. Original Departure_ Country. Country Consignment. Final Destination_ Country. Country Consignment. Transit_ Country. Country Consignment. Transport_ Contract. Contract Consignment. Original Despatch_ Transportation Service. Transportation Service Consignment. Final Delivery_ Transportation Service. Transportation Service Consignment. Delivery Terms Consignment. Payment Terms Consignment. Freight_ Allowance Charge. Allowance Charge ID BBIE 1 Tavaraerän yksilöivä tunniste 21/75

22 Tullin mahdollisesti vaatima lähetyserän yksilöivä tunniste, jota käytetään tullimenettelyihin vienti- tai tuontitoimituksen missä tahansa vaiheessa, jolloin toimitus on tullimenettelyjen kohteena. ConsigneeParty ASBIE Toimitusterminaalin osapuolitiedot DeliveryTerms ASBIE Toimitusehto (esim. INCOTERMS) 22/75

23 3.8 Maa (Country) Address.Country Country. Details Country. Identification Code. Code Country. Name IdentificationCode BBIE 1 Maakoodi Name BBIE Maan nimi ISO:n 2-kirjaiminen maakoodi, esimerkiksi FI, SE, NO, DK, IS. 23/75

24 3.9 Asiakasosapuoli (CustomerParty) BuyerCustomerParty AccountingCustomerParty OriginatorCustomerParty Customer Party. Details Customer Party. Customer Assigned_ Account Identifier. Identifier Customer Party. Supplier Assigned_ Account Identifier. Identifier Customer Party. Additional_ Account Identifier. Identifier Customer Party. Party Customer Party. Delivery_ Contact. Contact Customer Party. Accounting_ Contact. Contact Customer Party. Buyer_ Contact. Contact Party ASBIE 1 Osapuolitiedot 24/75

25 3.10 Toimitus (Delivery) Order.Delivery OrderResponse.Delivery Invoice.Delivery LineItem.Delivery Shipment.Delivery Delivery. Details Delivery. Identifier Delivery. Quantity Delivery. Minimum_ Quantity. Quantity Delivery. Maximum_ Quantity. Quantity Delivery. Actual_ Delivery Date. Date Delivery. Actual_ Delivery Time. Time Delivery. Latest_ Delivery Date. Date Delivery. Latest_ Delivery Time. Time Delivery. Tracking Identifier. Identifier Delivery. Delivery_ Address. Address Delivery. Delivery_ Location. Location Delivery. Requested Delivery_ Period. Period Delivery. Promised Delivery_ Period. Period Delivery. Estimated Delivery_ Period. Period Delivery. Delivery_ Party. Party Delivery. Despatch ActualDeliveryDate BBIE Toteutunut toimituspäivä Päivämäärä, jolloin toimitus on toimitusehtojen mukaisesti luovutettu eteenpäin. ActualDeliveryTime BBIE Toteutunut toimituskellonaika DeliveryLocation ASBIE Toimitusosoite Kellonaika, jolloin toimitus on toimitusehtojen mukaisesti luovutettu eteenpäin. Toimitusosoite (Location.Address) sekä mahdollinen yksilöity paikkatieto (Location.ID), kuten hyllytysohje. RequestedDeliveryPeriod ASBIE Pyydetty toimitusajankohta 25/75

26 Ostajan määrittämä ajankohta, jolloin tuotteet tulisi toimittaa vastaanottajalle. PromisedDeliveryPeriod ASBIE Vahvistettu toimitusajankohta Myyjän vahvistama ajankohta, jolloin tuotteet toimitetaan vastaanottajalle. DeliveryParty ASBIE Toimituksen vastaanottaja (osapuoli) Despatch ASBIE Lähetystiedot 26/75

27 3.11 Toimitusehdot (DeliveryTerms) Order.DeliveryTerms OrderResponse.DeliveryTerms Invoice.DeliveryTerms Consignment.DeliveryTerms Delivery Terms. Details Delivery Terms. Identifier Delivery Terms. Special_ Terms. Text Delivery Terms. Loss Risk Responsibility Code. Code Delivery Terms. Loss Risk. Text Delivery Terms. Delivery_ Location. Location Delivery Terms. Allowance Charge ID BBIE Toimitusehdon tunniste Ensisijaisesti INCOTERMS 2000 koodisto. Esimerkkiarvo EXW. SpecialTerms BBIE Toimitusehdon lisäklausuuli DeliveryLocation ASBIE Toimitusehdon paikkatieto ID:n attribuutit: Tunnistejärjestelmä schemeagencyid schemeid INCOTERMS (ei pakollinen) INCOTERMS /75

28 3.12 Lähetys (Despatch) Delivery.Despatch Despatch. Details Despatch. Identifier Despatch. Requested_ Despatch Date. Date Despatch. Requested_ Despatch Time. Time Despatch. Estimated_ Despatch Date. Date Despatch. Estimated_ Despatch Time. Time Despatch. Actual_ Despatch Date. Date Despatch. Actual_ Despatch Time. Time Despatch. Despatch_ Address. Address Despatch. Despatch_ Party. Party Despatch. Contact ActualDespatchDate BBIE Toteutunut lähetyspäivämäärä ActualDespatchTime BBIE Toteutunut lähetyskellonaika DespatchAddress ASBIE Lähetysosoite 28/75

29 3.13 Mitta-arvo (Dimension) ItemIdentification.MeasurementDimension TransportHandlingUnit.MeasurementDimension Package.MeasurementDimension Dimension. Details Dimension. Attribute Identifier. Identifier Dimension. Measure Dimension. Description. Text Dimension. Minimum_ Measure. Measure Dimension. Maximum_ Measure. Measure AttributeID BBIE 1 Mitattavan ominaisuuden tunniste Measure BBIE Mitta-arvo AttributeID:n attribuutit: Käytetään oletusarvoisesti UN/ECE 6313 koodistoa. Yleisimmät koodit on listattu alla. Tunnistejärjestelmä schemeagencyid schemeid UN/ECE 6313 Measured attribute code 6 (ei pakollinen) UN/ECE 6313 AttributeID koodit [UN/ECE 6313]: Koodi Kuvaus AAA AAB AAW Unit net weight Yksikkönettopaino Unit gross weight Yksikköbruttopaino Gross volume Tilavuus 29/75

30 3.14 Viite/Liite (DocumentReference) AdditionalDocumentReference (jokaisen UBL dokumentin otsikkotasolla) DocumentReference (jokaisen UBL dokumentin rivitasolla) Sanomaan tai yksittäiseen riviin liittyvä lisäviite tai liite. Document Reference. Details 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 ID BBIE 1 Viitteen tunniste IssueDate BBIE Viitteeseen liittyvä päiväys DocumentTypeCode BBIE Viitteen tyyppikoodi Pakollinen, kun asiayhteys ei yksilöi viitteen tyyppiä, toisin sanoen pakollinen sanoman otsikkotasolla AdditionalDocumentReference ASBIE:n ja rivitasolla DocumentReference ASBIE:n yhteydessä. NES-suosituksen mukaisesti käytetään oletusarvoisesti UN/ECE 1001 koodistoa. Tullaan käyttämään myös UN/ECE 1153 koodeja, joiden sallitut arvot on listattu alla. Attachment ASBIE Liitetiedosto tai URL viittaus DocumentTypeCode:n attribuutit: Koodisto listagencyid listid UN/ECE 1001 ei käytetä ei käytetä UN/ECE UN/ECE /75

31 DocumentTypeCode koodit [UN/ECE 1153]: Koodi ABE ACT AFL AIZ CR OP Kuvaus Declarant s reference number Ulkomaan kaupan viite Unique claims reference number of the sender Lähettäjän reklamaationumero Associated Invoices Liitelaskun tunniste Consolidated invoice number Koontilaskun tunniste Customer Reference Number Asiakkaan viite / merkki Original Purchase Order Alkuperäisen (myymälän) tilauksen tunniste 31/75

32 3.15 Valuuttakurssi (ExchangeRate) Invoice.PaymentExchangeRate Exchange Rate. Details Exchange Rate. Source_ Currency Code. Code Exchange Rate. Source_ Currency Base Rate. Rate Exchange Rate. Target_ Currency Code. Code Exchange Rate. Target_ Currency Base Rate. Rate Exchange Rate. Exchange Market Identifier. Identifier Exchange Rate. Calculation Rate. Rate Exchange Rate. Mathematic Operator Code. Code Exchange Rate. Date Exchange Rate. Foreign Exchange_ Contract. Contract SourceCurrencyCode BBIE 1 Viitevaluutta TargetCurrencyCode BBIE 1 Kohdevaluutta CalculationRate BBIE Vaihtokurssi Valuutta, mistä vaihdetaan. ISO 4217 valuuttakoodit listattu soveltamisohjeen alussa. Valuutta, mihin vaihdetaan. Rahamäärä viitevaluutassa * vaihtokurssi = rahamäärä kohdevaluutassa Date BBIE Vaihtokurssin kiinnityspäivämäärä 32/75

33 3.16 Ulkoinen viite (ExternalReference) Attachment.ExternalRefernce Käytetään liitteiden lataamiseen erillisinä dokumentteina. External Reference. Details External Reference. URI. Identifier External Reference. Document Hash. Text External Reference. Expiry Date. Date External Reference. Expiry Time. Time URI BBIE Dokumentin URI viittaus Esimerkiksi URL osoite, josta dokumentti on ladattavissa. DocumentHash BBIE Dokumentin HASH arvo Vertaamalla ladatun dokumentin hash arvoa ilmoitettuun voidaan tarkistaa, ettei dokumentti ole muuttunut. Käytetään SHA-1 (Secure Hash Algorithm) - algoritmia. ExpiryDate BBIE Latausajankohdan umpeutumispäivämäärä Päivämäärä, johon asti dokumentti on ladattavissa URI osoitteeseen mukaisesta paikasta. ExpiryTime BBIE Latausajankohdan umpeutumiskellonaika Kellonaika, johon asti dokumentti on ladattavissa URI osoitteeseen mukaisesta paikasta. Päivämäärä tietoa tulee käyttää aina tämän tiedon yhteydessä. 33/75

34 3.17 Pankkitili (FinancialAccount) PaymentMeans.PayeeFinancialAccount Financial Account. Details Financial Account. Identifier Financial Account. Name Financial Account. Account Type Code. Code Financial Account. Currency Code. Code Financial Account. Payment_ Note. Text Financial Account. Financial Institution_ Branch. Branch Financial Account. Country ID BBIE 1 Tilinumero CurrencyCode BBIE Tilivaluutta Käytetään ensisijaisesti IBAN numeroa (ISO 13616), joka tuli pakolliseksi kansainvälisessä maksuliikenteessä Euroopassa alkaen. ISO 4217 valuuttakoodit on listattu soveltamisohjeen alussa. FinancialInstitutionBranch ASBIE 1 Pankkikonttorin tiedot ID:n attribuutit: Tunnistejärjestelmä schemeagencyid schemeid International Bank Account Number ei käytetä IBAN 34/75

35 3.18 Finanssi-instituutio (FinancialInstitution) Branch.FinancialInstitution Financial Institution. Details Financial Institution. Identifier Financial Institution. Name Financial Institution. Address ID BBIE 1 Finanssi-instituution tunniste Käytetään ISO 9362 BIC koodia, joka tuli pakolliseksi kansainvälisessä maksuliikenteessä Euroopassa alkaen. Name BBIE Finanssi-instituution nimi ID:n attribuutit: Tunnistejärjestelmä schemeagencyid schemeid Bank Identifier Code 17 (ei pakollinen) BIC 35/75

36 3.19 Tuote (Item) LineItem.Item DespatchLine.Item InvoiceLine.Item Item. Details 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 36/75

37 Name BBIE Tuotenimi BuyersItemIdentification ASBIE Ostajan tuotetunniste SellersItemIdentification ASBIE Myyjän tuotetunniste StandardItemIdentification ASBIE 1 Standardi tuotetunniste EAN (GTIN) tuotetunniste. ID:llä pakollinen attribuutti: schemeid= GTIN AdditionalItemIdentification ASBIE Tuotteen lisätunniste CommodityClassification ASBIE Tuoteluokitus Esimerkiksi tuotteen VALTRY koodi ClassifiedTaxCategory ASBIE Tuotteen verokohtelu Tuotteen ALV-prosentti AdditionalItemProperty ASBIE Tuotteen lisäominaisuus OriginAddress ASBIE Tuotteen alkuperä ItemInstance ASBIE Yksilöity tuote Esimerkiksi kuluttajapakkausten määrä toimituspakkauksessa Ensisijaisesti vain tieto alkuperämaasta Lisätiedot tuotteen yksilöintiin, mm. tuoteerää koskevat tiedot. 37/75

38 3.20 Tuotetunniste (ItemIdentification) Item.BuyersItemIdentification Item.SellersItemIdentification Item.StandardItemIdentification Item.AdditionalItemIdentification Item Identification. Details Item Identification. Identifier Item Identification. Extended_ Identifier. Identifier Item Identification. Physical Attribute Item Identification. Measurement_ Dimension. Dimension Item Identification. Issuer_ Party. Party ID BBIE 1 Tuotteen tunniste MeasurementDimension ASBIE Tuotteen mitat ID:n attribuutit: Tunnistejärjestelmä schemeagencyid schemeid Tunnistejärjestelmä tulee yksilöidä attribuutein, kun kyseessä on muu kuin ostajan tai myyjän tuotetunniste. Käytetään vain standardin tuotetunnisteen (StandardItemIdentification) yhteydessä. Global Trade Item Number (EAN-koodi, GTIN-koodi) 9 (ei pakollinen) GTIN 38/75

39 3.21 Yksilöity tuote (ItemInstance) Item.ItemInstance Item Instance. Details Item Instance. Product Trace_ Identifier. Identifier Item Instance. Manufacture Date. Date Item Instance. Manufacture Time. Time Item Instance. Registration Identifier. Identifier Item Instance. Serial Identifier. Identifier Item Instance. Additional_ Item Property. Item Property Item Instance. Lot Identification ManufactureDate BBIE Tuotteen valmistuspäivä LotIdentification ASBIE Tuote-erän tiedot 39/75

40 3.22 Tuotteen ominaisuus (ItemProperty) Item.AdditionalItemProperty LotIdentification.AdditionalItemProperty Item Property. Details Item Property. Name Item Property. Value. Text Item Property. Usability_ Period. Period Item Property. Item Property Group Name BBIE 1 Ominaisuuden nimi Yleiset nimet on listattu alla. Value BBIE 1 Ominaisuuden arvo Name koodit: Koodi EarliestExpiryDate Kuvaus Tilauksella ostajan pyytämä tuotteen parasta ennen päivämäärä, joka välitetään tuote-erään liittyvänä tietona. (LotIdentification.AdditionalItemProperty) Ominaisuuden arvo (Value) välitetään muodossa YYYY-MM- DD NumberOfRetailPackages Tilauksella tai toimitustietosanomalla oleva lisätieto siitä, montako kuluttajapakkausta kyseinen toimituspakkaus sisältää. (Item.AdditionalItemProperty) 40/75

41 3.23 Riviviite (LineReference) InvoiceLine.DespatchLineReference Line Reference. Details Line Reference. Line Identifier. Identifier Line Reference. UUID. Identifier Line Reference. Line Status Code. Code Line Reference. Document Reference LineID BBIE 1 Riviviite, rivinumero DocumentReference ASBIE Dokumentin tiedot 41/75

42 3.24 Sijainti (Location) Delivery.DeliveryLocation ShipmentStage.UnloadingLocation ShipmentStage.LoadingLocation DeliveryTerms.DeliveryLocation Location. Details Location. Identifier Location. Description. Text Location. Conditions. Text Location. Country Subentity. Text Location. Country Subentity Code. Code Location. Validity_ Period. Period Location. Address ID BBIE Sijainnin tunniste Description BBIE Sijainnin kuvaus Esimerkiksi LOCODE-, GLN tunniste tai myymälän hyllypaikan tunniste. Käytettäessä ostajan ylläpitämään tunnistejärjestelmää (schemeagencyid= 92 ), on oletusarvoisesti kyseessä myymälän hyllypaikka. Mikäli kyseessä on jokin muu ostajan ylläpitämä sijaintitieto, tulee tämä aina yksilöidä schemeid attribuutti avulla UN/ECE 3227 koodiston mukaisesti. Address ASBIE Sijaintiin liittyvät osoitetiedot ID:n attribuutit: Ei käytetä toimitusehdon yhteydessä (DeliveryTerms.DeliveryLocation) Tunnistejärjestelmä schemeagencyid schemeid LOCODE 6 (ei pakollinen) UN/ECE rec 16 Global Location Number (GLN) 9 (ei käytetä) GLN Myymälän hyllypaikka 92 ei käytetä 42/75

43 3.25 Tuote-erä (LotIdentification) ItemInstance.LotIdentification Lot Identification. Details Lot Identification. Lot Number. Identifier Lot Identification. Expiry Date. Date Lot Identification. Additional_ Item Property. Item Property LotNumberID BBIE Tuote-erän numero ExpiryDate BBIE Tuote-erän Parasta ennen -päiväys AdditionalItemProperty ASBIE Tuote-erän lisäominaisuudet 43/75

44 3.26 Rahallinen yhteenveto (MonetaryTotal) Invoice.LegalMonetaryTotal Monetary Total. Details Monetary Total. Line Extension Amount. Amount Monetary Total. Tax Exclusive Amount. Amount Monetary Total. Tax Inclusive Amount. Amount Monetary Total. Allowance Total Amount. Amount Monetary Total. Charge Total Amount. Amount Monetary Total. Prepaid Amount. Amount Monetary Total. Payable_ Rounding Amount. Amount Monetary Total. Payable_ Amount. Amount LineExtensionAmount BBIE 1 Rivien verottomien nettosummien yhteenlaskettu summa. = InvoiceLine.LineExtensionAmount TaxExclusiveAmount BBIE Veroton loppusumma Loppusumma pois lukien ALV, mutta sisältäen muut verot sekä alennukset ja lisät. TaxInclusiveAmount BBIE 1 Verollinen loppusumma =Invoice.LegalMonetaryTotal.LineExtensionAmo unt +/- Invoice.AllowanceCharge.Amount + Invoice.TaxTotal.TaxAmount (missä TaxScheme.ID <> VAT ) =Invoice.LegalMonetaryTotal.TaxExclusiveAmou nt + Invoice.TaxTotal.TaxAmount (missä TaxScheme.ID = VAT ) AllowanceChargeTotal BBIE Alennusten yhteenlaskettu määrä Otsikko- ja rivitasoisten alennusten kokonaissumma. = InvoiceLine.AllowanceCharge.Amount + Invoice.AllowanceCharge.Amount (missä AllowanceCharge.ChargeIndicator = false ) ChargeTotalAmount BBIE Lisien yhteenlaskettu määrä Otsikko- ja rivitasoisten lisien kokonaissumma. = InvoiceLine.AllowanceCharge.Amount + Invoice.AllowanceCharge.Amount (missä 44/75

45 PayableAmount BBIE 1 Maksettava määrä AllowanceCharge.ChargeIndicator = true ) Laskun loppusumma yleisten pyöristyssääntöjen mukaisesti 45/75

46 3.27 Tilattu toimituserä (OrderedShipment) LineItem.OrderedShipment Ordered Shipment. Details Ordered Shipment. Shipment Ordered Shipment. Package Shipment BBIE 1 Toimituserän tiedot 46/75

47 3.28 Tilausriviviite (OrderLineReference) DespatchLine.OrderLineReference InvoiceLine.OrderLineReference Order Line Reference. Details Order Line Reference. Line Identifier. Identifier Order Line Reference. Sales Order_ Line Identifier. Identifier Order Line Reference. UUID. Identifier Order Line Reference. Line Status Code. Code Order Line Reference. Order Reference LineID BBIE 1 Ostotilausrivin tunniste SalesOrderLineID BBIE Myyntitilausrivin tunniste OrderReference ASBIE Tilauksen tiedot 47/75

48 3.29 Tilausviite (OrderReference) OrderResponse.OrderReference OrderResponseSimple.OrderReference DespatchAdvice.OrderRefenrence Invoice.OrderReference OrderLineReference.OrderReference Order Reference. Details Order Reference. Identifier Order Reference. Sales Order Identifier. Identifier Order Reference. Copy_ Indicator. Indicator Order Reference. UUID. Identifier Order Reference. Issue Date. Date Order Reference. Issue Time. Time Order Reference. Customer_ Reference. Text Order Reference. Document Reference ID BBIE 1 Ostajan tilausviite SalesOrderID BBIE Myyjän tilausviite IssueDate BBIE Ostotilauksen päiväys 48/75

49 3.30 Pakkaus (Package) TransportHandlingUnit.ActualPackage Package. Details Package. Identifier Package. Quantity Package. Returnable Material_ Indicator. Indicator Package. Package Level Code. Code Package. Packaging Type Code. Code Package. Packing Material. Text Package. Contained_ Package. Package Package. Goods Item Package. Measurement_ Dimension. Dimension Package. Delivery Unit ID BBIE Pakkauksen tunniste Quantity BBIE Nimikkeen lukumäärä pakkauksessa Toimitustietosanoman rivitasolla määrittää, kuinka suuri määrä toimitetaan tietyssä pakkauksessa. (DespatchLine.Shipment.TransportHandlingUnit. ActualPackage.Quantity) PackageLevelCode BBIE Pakkauksen sijainti pakkaushierarkiassa PackagingTypeCode BBIE Pakkaustyyppi Uloin pakkaustaso saa järjestysnumeron 1, tämän sisällä olevat pakkaukset pakkaustason 2 jne. Jos on esitettävä pakkauksen sijainti lavalla, voidaan se esittää antamalla tiedot pakkauksen sijainnista tietyssä laatikkopinossa ja tietyssä kerroksessa. Käytetään UBL:n mukaisesti YK:n kauppamenettelysuositus nro 21 koodistoa. Yleisimmät koodit on listattu alla. ContainedPackage ASBIE Viittaus pakkauksen sisältämiin pakkauksiin. Käytetään kuvaamaan pakkaushierarkiaa. Tämän yhteydessä voidaan käyttää PackageLevelCode:a. ContainedPackage on tyyppiä PackageType kuten ActualPackage. 49/75

50 MeasurementDimension ASBIE Pakkauksen mittatiedot PackagingTypeCode koodit [UN/ECE rec 21]: Koodi Kuvaus QS BX SA (Box, plastic, solid) Transbox Box Laatikko Sack Säkki 50/75

51 3.31 Osapuoli (Party) CustomerParty.Party SupplierParty.Party Delivery.DeliveryParty Consignment.ConsigneeParty Party. Details 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 PartyIdentification ASBIE 1 Yleinen osapuolitunniste PartyName ASBIE 1 Osapuolen nimi PostalAddress ASBIE Osapuolen postiosoite PartyTaxScheme ASBIE Osapuolen verotiedot 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. Välitetään tarvittaessa laskuttajan ja laskutettavan 51/75

52 osapuolitietojen yhteydessä. Tämä on näiden osapuolien osalta pakollinen tieto kansainvälisessä kaupankäynnissä. PartyLegalEntity ASBIE Osapuolen yritysrekisteritiedot 52/75

53 3.32 Osapuolitunniste (PartyIdentification) Party.PartyIdentification Party Identification. Details Party Identification. Identifier ID BBIE 1 Tunniste Ensisijaisesti OVT tunniste. ID:n attribuutit: Tunnistejärjestelmä schemeagencyid schemeid OVT tunniste ei käytetä ISO 6523 Global Location Number (GLN) 9 (ei pakollinen) GLN Myyjän ylläpitämä osapuolitunniste Ostajan ylläpitämä osapuolitunniste 91 ei käytetä 92 ei käytetä Suomalainen Y-tunnus ei käytetä FI:ORGNR 53/75

54 3.33 Osapuolen yritysrekisteritiedot (PartyLegalEntity) Party.PartyLegalEntity Party Legal Entity. Details Party Legal Entity. Registration_ Name. Name Party Legal Entity. Company Identifier. Identifier Party Legal Entity. Registration_ Address. Address Party Legal Entity. Corporate Registration Scheme CompanyID BBIE 1 Yritysrekisteritunniste (Y-tunnus) CompanyID:n attribuutit: Tunnistejärjestelmä schemeagencyid schemeid Suomalainen Y-tunnus ei käytetä FI:ORGNR Ruotsalainen Y-tunnus ei käytetä SE:ORGNR 54/75

55 3.34 Osapuolen nimi (PartyName) Party.PartyName Party Name. Details Party Name. Name Name BBIE 1 Nimi 55/75

56 3.35 Osapuolen verotiedot (PartyTaxScheme) Party.PartyTaxScheme Party Tax Scheme. Details Party Tax Scheme. Registration_ Name. Name Party Tax Scheme. Company Identifier. Identifier Party Tax Scheme. Tax Level Code. Code Party Tax Scheme. Exemption Reason Code. Code Party Tax Scheme. Exemption_ Reason. Text Party Tax Scheme. Registration_ Address. Address Party Tax Scheme. Tax Scheme CompanyID BBIE 1 Osapuolen verotunniste Esimerkiksi ALV tunniste. TaxScheme ASBIE 1 Verolajin tiedot Esimerkiksi ALV CompanyID:n attribuutit: Tunnistejärjestelmä schemeagencyid schemeid Yrityksen suomalainen ALV-tunniste ei käytetä FI:VAT Yrityksen ruotsalainen ALV-tunniste ei käytetä SE:VAT 56/75