Yleistä
Tulkintaohje
Sanomavastaukset
Alv-koodit ja -tunnisteet
Sallitut verkkolaskuoperaattorit
Yleistä
Ohjelmistorajapinta mahdollistaa sekä aineistojen noudon Netvisorista että aineistojen tuonnin Netvisoriin. Rajapinnan tarjoamat resurssit on jaettu ylätason kategorioihin.
Yhteistä kaikille tapahtumille on:
- Päivämäärät ovat ANSI–muodossa
- Maakoodit ovat aina ISO 3166 –muodossa
- Liitteet ovat aina Base64 -enkoodattuna XML-sanomaan
- Tyhjiä elementtejä ei tarvitse kirjoittaa XML-sanomaan, esimerkiksi päivityspyynnössä tyhjä elementti tulkitaan rajapinnassa käskyksi päivittää arvo tyhjäksi
- Pakollisia kenttiä ei tule jättää tyhjäksi
- Elementtien täytyy olla DTD:n mukaisessa järjestyksessä
Skandinaavisten kirjainten (Ä, ä, Ö, ö tai Å, å) saamiseksi käyttöliittymään on sanoman oltava ISO/IEC 8859-15-enkoodatussa muodossa, mutta xml-deklaraatiota ei kuitenkaan tarvita. Netvisorin palvelinpuoli tekee sisällölle tarvittavat esikäsittelyt, jolloin aineiston tulee aina alkaa <root>. Mikäli ääkköset eivät toimi ISO/IEC 8859-15 enkoodatussa muodossa, voidaan enkoodaus muuttaa UTF-8 muotoon.
Tee isot haut ja tietojen siirrot virka-ajan ulkopuolella, jollei niiden siirtoon virka-aikana ole erityistä tarvetta. Tietojen siirron aiheellinen tiheys eroaa resurssi- ja käyttötapauskohtaisesti. Monissa tapauksissa siirto kerran vuorokaudessa tai kuukaudessa riittää. Voit nopeuttaa siirtoja myös sopivilla rajauksilla käyttäen resurssien parametreja.
Tulkintaohje
Ohessa on kuvattu integraatiorajapinnan eri merkintöjen tarkoitus ja tulkinnat.
Eri sanomien XML-rakenne on kuvattu taulukkomuotoisesti niistä kohdista sanomia kun se on mahdollista ja loogista. XML:n rakenteellisuudesta johtuen kuvauksissa on jouduttu käyttämään esimerkiksi viittauksia ohjeistuksen eri kohtiin, jotta kokonaisuus on pysynyt selkeänä.
Rakennekuvausten perusrakenne on seuraava:
Kutsu:
- Perustiedot
- Käytettävä resurssi
- GET - yleensä datan noutoa Netvisorista
- POST - yleensä datan tuontia Netvisoriin
- Parametrit
- Yleensä QueryString:ssä määritettäviä, erotetaan varsinaisesta resurssista ?-merkillä ja tämän jälkeen &-merkillä
- Kaikilla resursseilla ei ole
- Yleensä QueryString:ssä määritettäviä, erotetaan varsinaisesta resurssista ?-merkillä ja tämän jälkeen &-merkillä
- XML-rakenne dataa tuotaessa (POST)
- Kuvattu XML:n rakenne sekä esim. elementtien määrät ja pakollisuus
Mikäli POST-sanomalla käytetään itsesulkevia tageja, niin huomaa että näitä ei lueta ollenkan, mukaanlukien mahdolliset attribuutit. Esimerkiksi asiakaskortin elementtiä <email/> ei lueta ollenkaan, mutta <email></email> taas tyhjentää kyseisen arvon Netvisorin asiakaskortilta.
Vastaus:
Jokaiseen kutsuun vastataan XML-vastauksella, jonka rakenne vastaa suurilta osin kutsua. Sanoman yleisrakenteen voi katsoa alemmasta kappaleesta. Vastaus GET-tyyppisiin noutosanomiin sisältää resurssikohtaisen datarakenteen, joka on kuvattu kussakin resurssikuvauksessa erikseen. POST-tyyppisiin tuontisanomiin tulee sanomasta riippuen vastauksessa Replies-elementti, jonka sisällä on esim. InsertedDataIdentifier-elementti sisältäen lisätyn asian ID-arvon.
Sanomavastaukset
Jokaiseen rajapintakutsuun vastataan vakioidulla sanomavastauksella. GET-tyyppisissä sanomissa vastaus sisältää pyydetyn datan (<resurssikohtainen elementti>) ja POST-tyyppisissä mahdollisesti tapauskohtaisen vastauksen (Replies).
Vastaussanoman yleinen rakenne:
Elementti: Root (1 ilmentymä)
Elementti: Root/ResponseStatus (1 ilmentymä)
Elementti | Muoto | Kuvaus | Esimerkki | Lisätiedot |
Status | Merkkijono | Indikoi tapahtuiko kutsun käsittelyssä virhettä | OK | FAILED |
Status | Merkkijono | Virhevakio ja -kuvaus | Tämä elementti vain jos FAILED tilassa. Ks. Virheden hallinta | |
TimeStamp | Päivämäärä | Vastauksen aikaleima | 01.01.2018 12:00:00 |
Vastauksen tyyppi on sidoksissa dataliikenteen suuntaan:
1. Noudettaessa dataa Netvisorista
Noudettu data on omana elementtinään sanomassa:
Elementti: Root/ResponseStatus/<resurssikohtainen elementti>
2. Tuotaessa dataa Netvisoriin
Vastaus sisältää Replies-elementin ja sen sisällä tapauskohtaisesti dataa:
Elementti: Root/ResponseStatus/Replies (0-1 ilmentymä)
Elementti | Muoto | Kuvaus | Esimerkki | Lisätiedot |
InsertedDataIdentifier | Merkkijono | |||
TAI | ||||
Reply | Merkkijono |
Oheiset elementit esiintyvät 0-n kertaa.
ALV-koodit ja tunnisteet
ALV-koodin ja -prosentin tulee olla yhteensopivat. Tarkista yhteensopivuus alla olevasta taulukosta:
ALV-tunniste | ALV-koodi | ALV-prosentti |
Ei alv-käsittelyä | NONE | 0 |
Kotimaan myynti | KOMY | 0, 10, 14, 24 |
EU-myynti | EUMY | 0 |
EU:n ulkopuolinen myynti | EUUM | 0 |
Kotimaan osto | KOOS | 0, 10, 14, 24 |
EU-osto | EUOS | 0, 10, 14, 24 |
EU-palveluosto | EUPO | 0, 10, 14, 24 |
EU:n ulkopuolinen osto | EUUO | 0, 10, 14, 24 |
100% | 100 | 0 |
312 EU-palvelumyynti | EUPM312 | 0 |
309 EU-palvelumyynti | EUPM309 | 0, 10, 14, 24 |
Muu arvonlisäveroton liikevaihto (310) | MUUL | 0, 10, 14, 24 |
Tavaraostot muista EU-maista, vähennyskelvoton | EVTO | 0, 10, 14, 24 |
Palveluostot muista EU-maista, vähennyskelvoton | EVPO | 0, 10, 14, 24 |
Ei vähennyskelpoinen käännetty verovelvollisuus | EVKV | 0, 10, 14, 24 |
Käänteinen verovelvollisuus | KAVE | 0, 10, 14, 24 |
Rakentamispalvelun myynti | RAMY | 0 |
Rakentamispalvelun osto | RAOS | 0, 10, 14, 24 |
Ei vähennyskelpoinen rakentamispalvelun osto | EVRO | 0, 10, 14, 24 |
EU:n ulkopuolinen maahantuonti ALV | MAAL | 0, 10, 14, 24 |
EU:n ulkopuolinen maahantuonti ALV ei väh.kelp | EVMA | 0, 10, 14, 24 |
KOMY 0% | KOMY0 | 0 |
Sallitut verkkolaskuoperaattorit
Alla lista Netvisorin sallimista verkkolaskuoperaattoreista ja operaattoritunnuksista:
Verkkolaskuoperaattori | Tunnus |
Aktia | HELSFIHH |
Ålandsbanken | AABAFI22 |
Apix Messaging Oy | 003723327487 |
Apix Messaging Oy (vanha tunnus) | 00372332748700001 |
Basware Oyj | BAWCFI22 |
CGI Suomi (ent. Logica) | 003703575029 |
Crediflow Ab | CREDIFLOW |
Danske Bank | DABAFIHH |
DNB Bank ASA, Finland Branch | DNBAFIHX |
Handelsbanken | HANDFIHH |
InExchange Factorum AB | INEXCHANGE |
InExchange Factorum AB(vanhatunnus) | SE556700997101 |
Lexmark Expert Systems AAB | (EXPSYS) |
Open Text Oy | 003708599126 |
Maventa | 003721291126 |
Netbox Finland Oy | 003726044706 |
Nordea | NDEAFIHH |
Notebeat Oy | 003717203971 |
OpusCapita (vanha tunnus 31.12.2018 saakka) | 003710948874 |
OpusCapita Solutions Oy | E204503 |
Osuuspankki | OKOYFIHH |
Pagero | 003723609900 |
PEPPOL | (PEPPOL) |
POP Pankki | POPFFI22 |
PostNord Strålfors Oy | 003701150617 |
Ropo Capital | 003714377140 |
Säästöpankki | ITELFIHH |
S-Pankki/LähiTapiola | SBANFIHH |
Sproom ApS | SPROOM |
Telia / CGI Finland Oyj | 003703575029 |
Tieto Oyj | 003701011385 |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedback