11.11.2003 1 (9) TEAPPSXML v.2.5 1.1.2004 voimaantulevan laskutussäännöstön vuoksi TEAPPSXML -kuvaus päivittyy eli kuvauksesta tulee käyttöön versio TEAPPSXML v.2.5. Muutokset ovat vapaaehtoisten elementtien ja attribuuttien lisäyksiä, jolloin yhteensopivuus aikaisempien TEAPPSXML -kuvausversioiden kanssa säilyy. TEAPPSXML v.2.5 -kuvaus otetaan käyttöön TietoEnatorin ssa joulukuussa 2003. Seuraavassa on yhteenveto muutoksista INVOICE -rakenteen mukaan ryhmiteltynä. Rakenteiden selkeyttämiseksi mukana on joukko puurakennekuvia. Niissä pakollinen elementti on esitetty yhtenäisellä kehysviivalla ja vapaaehtoinen katkoviivalla. 1) CONTROL ARCHIVE_CONTROL rakenteen loppuun on lisätty vapaaehtoisiksi DIMENSIONS -elementtirakenne laskentakohteet, esiintymistaajuus 0-1 CONTROL_STAMP -elementtirakenne tarkistusmerkintä, esiintymistaajuus 0-1 ACCEPTANCE_STAMP -elementtirakenne hyväksymismerkintä, esiintymistaajuus 0-1 BANK_ACCOUNT_NUMBER -elementti tilinumero, esiintymistaajuus 0-1 IBAN_ACCOUNT_NUMBER -elementti kansainvälinen tilinumero, esiintymistaajuus 0-1 SWIFT_CODE -elementti pankin kansainvälinen nimi, esiintymistaajuus 0-1
11.11.2003 2 (9) 2) HEADER HEADER/CASH_DISCOUNT -rakenteeseen on lisätty seuraavat uudet vapaaehtoiset elementtirakenteet käteisalennuksen täydentämiseksi: o VAT -elementtirakenne käteisalennuksen veron määrä eriteltynä verokannoittain, esiintymistaajuus 0 - n o VAT_TOTAL/AMOUNT -elementtirakenne käteisalennetun summan veron määrä, esiintymistaajuus 0-1 o INVOICE_TOTAL_WITH_CASH_DISCOUNT/AMOUNT - elementtirakenne laskun loppusumma, jossa on huomioitu käteisalennus, esiintymistaajuus 0-1 Käteisalennus 2% 11.3.2004 106.60 23.37 129.97 EUR 6368.43 (22% 23.32 8% 0,05) PER_CENT DATE rakenne CASH_DISCOUNT_A MOUNT/AMOUNT @VAT= EXCLUDED Vero yht. elementtiin VAT_TOTAL/AMOUNT Prosentti elementtiin VAT/RATE Summa elementtiin VAT/VAT_AMOUNT/AM OUNT CASH_DISCOUNT_A MOUNT/AMOUNT @VAT= INCLUDED Esimerkki: Käteisalennusrivin esittäminen HEADER/CASH_DISCOUNT -rakenteessa vakiolayoutilla. HEA- IN- DER/CUR- VOICE_TOTAL_WITH_ RENCY/ CASH_DISCOUNT/AMO CODE UNT HEADER -tasolle on lisätty uusi vapaaehtoinen elementti VAT_TEXT, esiintymistaajuus 0 1, jossa ilmoitetaan onko kyseessä on Kolmikantakauppa tms. Riville tuleva alv-kooditieto sijoitetaan ROW/VAT/FREE_TEXT elementtiin. Maksuehto ilmoitetaan elementissä HEADER/TERMS_OF_PAYMENT.
11.11.2003 3 (9) HEADER -tasolle on lisätty uusi vapaaehtoinen elementti BUYER_REFERENCE, esiintymistaajuus 0 1, ostajan viitteen ilmoittamiseksi. HEADER -tasolle on lisätty uusi vapaaehtoinen elementti DELIVERER_REFERENCE, esiintymistaajuus 0 1, toimittajan viitteen ilmoittamiseksi. HEADER/CONTRACT_INFORMATION rakenteeseen on lisätty erillinen vapaaehtoinen elementtirakenne, CONTRACT_PERIOD, sopimusjaksolle. CONTRACT_PERIOD -elementillä on alirakenteet START_PERIOD ja END_PERIOD. Lisäksi CONTRACT_INFORMATION - rakenteeseen on lisätty vapaaehtoiseksi elementiksi hinnastotieto, PRICELIST -elementti. Molempien lisättyjen rakenteiden esiintymistaajuus on 0-1.
11.11.2003 4 (9) 3) INVOICE -tasolle on lisätty uusi vapaaehtoinen elementtirakenne INVOICE_SENDER, esiintymistaajuus 0 1 TEAPPSXML -kuvauksessa laskun lähettäjän tiedot kerrotaan CONTENT_FRAME/ NET_SERVICE_ID (lähettäjän verkkopalvelutunnus) ja SENDER_DOMAIN (lähettäjän nimi) - elementeissä. Jos laskun lähettäjä on eri kuin laskuttaja (PAYEE) ja lähettäjästä halutaan kertoa vielä enemmän tietoa, niin käytettävissä on INVOICE_SENDER -elementtirakenne. INVOI- CE_SENDER -rakenteen alirakenteena on CUSTOMER_INFORMATION -rakenne. Kyseessä on laskun tietosisältöä täydentävä informatiivinen rakenne. 4) INVOICE -tasolle on lisätty uusi vapaaehtoinen elementtirakenne INVOICE_RECIPIENT, esiintymistaajuus 0 1 TEAPPSXML -kuvauksessa laskun vastaanottajan tiedot kerrotaan RECEIVER -rakenteessa. Jos lasku käsittelee esimerkiksi tilitoimisto vastaanottajan puolesta, voidaan tilitoimiston nimi ym. tiedot kertoa INVOICE_RECIPIENT -elementtirakenteessa. INVOICE_RECIPIENT -rakenteen alirakenteena on CUSTOMER_INFORMATION -rakenne. Kyseessä on laskun tietosisältöä täydentävä informatiivinen rakenne, lasku ohjataan edelleen laskun vastaanottajalle eli RE- CEIVER:lle. 5) Epi Finvoice-kuvauksen Epi-osio on sellaisenaan lisätty TEAPPSXML v.2.5 -kuvauksen INVOICE - rakenteeseen vapaaehtoiseksi elementtirakenteeksi.
11.11.2003 5 (9) 6) RECEIVER RECEIVER rakenteeseen on lisätty vapaaehtoinen elementti MAIL_ID, esiintymistaajuus 0 1. Tätä elementtiä käytetään, jos lasku halutaan toimittaa vastaanottajalle sähköpostitse. MAID_ID -elementin sisältönä on vastaanottajan sähköpostiosoite. 7) ROW Rivitason oletustiliöintirakenteeseen on lisätty toinen tili, CREDIT_ACCOUNT_2 -elementti, esiintymistaajuus 0 1. DEFAULT_ROW_POSTING -rakenteessa on tämän jälkeen mahdollista välittää perustililuettelon mukainen sekä lyhyt että pitkä tilinumero. Kaikkiin TEAPPSXML -kuvauksen DIMENSION -rakenteisiin on lisätty elementti DIMENSI- ON_NAME, esiintymistaajuus 0 1, jossa voi kertoa kustannuspaikan myös tekstinä. Lisäksi DIMENSION_VALUE -elementille on lisätty vapaaehtoinen attribuutti DIMENSI- ON_LENGTH, jossa voi kertoa DIMENSION_VALUE -elementissä olevan arvon pituuden. ROW rakenteeseen on lisätty vapaaehtoinen LOCATION_ID rakenne (esiintymistaajuus 0 1), jolla on seuraavat vapaaehtoiset elementit/elementtirakenteet: USED_QUANTITY käytetty määrä, esiintymistaajuus 0 1 PREVIOUS_METER_READING aikaisempi lukema, esiintymistaajuus 0 1 PREVIOUS_METER_READING_DATE/DATE aikaisempi lukupäivä, esiintymistaajuus 0 1 LATEST_METER_READING uusi lukema, esiintymistaajuus 0 1 LATEST_METER_READING_DATE/DATE uusi lukupäivä, esiintymistaajuus 0 1 CALCULATED_QUANTITY laskutettu määrä, esiintymistaajuus 0 1
11.11.2003 6 (9) Erittelyriville ROW -rakenteeseen on lisätty CURRENCY/CODE ja RATE -elementit, joilla voidaan ilmoittaa erittelyrivin hintatietojen valuutta, jos se poikkeaa laskun loppusumman valuutasta. Ko. rakenteen esiintymistaajuus on 0-1. Laskun loppusumman valuutta kerrotaan edelleen HEADER/CURRENCY -rakenteessa. Tukkuhinnalle on lisätty erillinen vapaaehtoinen elementtirakenne WHOLESALE_PRICE/ AMOUNT laskun rivitietoihin. Ko. rakenteen esiintymistaajuus on 0-1. ROW- rakenteeseen on lisätty vapaaehtoiset elementit TRANSPORT_NOTE, rahtikirjan numero, ja TRANSPORT_DATE, rahtikirjan päivämäärä. Molempien elementtien esiintymistaajuus on 0-1. TRANSPORT_DATE -elementillä on DATE -alirakenne.
11.11.2003 7 (9) ROW/QUANTITY/DELIVERED -elementin esiintymistaajuudeksi on muutettu 0 - n. 8) SUMMARY SUMMARY rakenteeseen on lisätty erillinen vapaaehtoinen elementtirakenne, INTEREST_CHARGE/AMOUNT, viivästyskorkosummalle. INTEREST_CHARGE - elementin esiintymistaajuus on 0-1. SUMMARY rakenteeseen on lisätty erillinen vapaaehtoinen elementtirakenne, ADVANCE_PAYMENT/AMOUNT, maksetulle ennakolle. ADVANCE_PAYMENT - elementin esiintymistaajuus on 0-1.
11.11.2003 8 (9) VAT_SUMMARY -rakenteeseen on lisätty uusi vapaaehtoinen VAT_ADDITIONAL_INFO - rakenne, jossa voidaan tarkentaa veronperustetta. Rakenteella on toistuva alirakenne VAT_INFO, jonka muodostavat elementti BASE_DESCRIPTION ja elementtirakenne BA- SE_AMOUNT/AMOUNT.
11.11.2003 9 (9) 9) CUSTOMER_INFORMATION -elementtirakenne CUSTOMER_INFORMATION rakenteeseen on lisätty erillinen vapaaehtoinen elementti, PARTY_IDENTIFICATION_ID, ovt-tunnukselle informatiiviseksi tiedoksi, esiintymistaajuus 0-1. 10) Muita muutoksia/käyttösuosituksia: Toimittajanumeron eli vastaanottajan laskuttajasta käyttämä asiakasnumeron ilmoittamiseen sopii PAYEE/CUSTOMER_INFORMATION/CUSTOMER_ID. Tämä elementti on mukana jo TEAPPSXML v.2.4 -kuvauksessa. DETAILS_OF_PAYMENT -elementille lisätään vapaaehtoinen attribuutti MESSAGE_TYPE, jossa voi tarkentaa maksuviitteen tyyppiä. ROW/VAT/RATE elementin esiintymistaajuudeksi on muutettu 0 1:ksi eli RATE -elementin pakollisuus tässä rakenteessa poistuu. HEADER/FREE_TEXT ja SUMMARY/FREE_TEXT -elementtien esiintymistaajuudeksi on muutettu 0 - n. ROW/DISCOUNT/DISCOUNT_AMOUNT -elementin esiintymistaajuudeksi on muutettu 0-1. TEAPPSXML v.2.5 -kuvaus on julkinen ja se dokumentaatio ja tekniset tiedostot ovat haettavissa TietoEnatorin RM-kanavalta osoitteesta www.rm.tietoenator.com ja n sivustolta www.tietoenator.fi/laskuhotelli. Tekniset tiedostot julkaistaan testauksen jälkeen viikolla 49-50. Lisätietoja kuvauksesta saa Pirkko Vedenpäältä, email: pirkko.vedenpaa@tietoenator.com. TietoEnator LASKUHOTELLI