Myynti- ja ostosuoritusten sekä tilisiirtojen käsittelyn toiminnot jakautuvat seuraaviin resursseihin:
| Integraatio | HTTP-metodi | Resurssi | DTD | Skeema | Esimerkki |
| Myyntisuorituslistan nouto | GET | salespaymentlist.nv | Lataa | ||
| Myyntisuorituksen tuonti | POST | salespayment.nv | salespayment.dtd | Lataa | |
| Myyntisuorituksen poisto | POST | deletesalespayment.nv | - | ||
| Myyntisuoritusten massatiliöinti | POST | masspayments.nv | masspayments.xsd | Lataa | |
| Myyntisuorituksen kohdistus | POST | matchpayment.nv | matchpayment.xsd | Lataa | |
| Ostosuorituksen nouto | GET | paymentlist.nv | Lataa | ||
| Tilisiirron tilan nouto | GET | unprocessedoutgoingpayments.nv | Lataa | ||
| Tilisiirron tuonti | POST | payment.nv | payment.dtd | Lataa |
Myyntisuorituslistan nouto
Resurssi: salespaymentlist.nv
Myyntisuorituslistan noutoon tarkoitettu resurssi.
Kutsussa käytettävät parametrit:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| abovenetvisorkey | 0...1 | Rajaa haettavien suoritusten id arvon suuremmaksi kuin annettu arvo | |
| begindate | 0...1 | Päivämäärärajauksen alku | 2021-10-23 |
| enddate | 0...1 | Päivämäärärajauksen loppu | 2021-10-24 |
| searchbyname | 0...1 | Hakee suorituksen nimellä | |
| limitlinkedpayments | 0...1 | Rajaa laskulinkityksen perusteella 0 - suorituksella ei ole laskua linkitettynä 1 - suorituksella pitää olla lasku linkitettynä | 0 |
| limitbytype | 0...1 | Rajaa suorituksen tyypin mukaan onlycreditloss - listaa pelkät luottotappiot excludecreditloss - listaa kaikki muut, paitsi ei luottotappioita | excludecreditloss |
| lastmodifiedstart | 0...1 | Hakee myyntisuoritukset, joita on muutettu annetun päivämäärän jälkeen. Muodossa yyyy-MM-ddTHH:mm:ss | 2019-12-10T12:00:00 |
| lastmodifiedend | 0...1 | Hakee myyntisuoritukset, joita on muutettu ennen annettua päivämäärää. Muodossa yyyy-MM-ddTHH:mm:ss | 2019-12-20T12:00:00 |
| invoicenetvisorkey | 0...1 | Hakee myyntilaskuun liittyvät suoritukset myyntilaskun NetvisorKey:n perusteella | 123 |
| invoicenumber | 0...1 | Hakee myyntilaskuun liittyvät suoritukset myyntilaskun laskunumeron perusteella | 54684 |
Vastaus:
| Taso | Elementti | Muoto | Ilmetymiä | Kuvaus | Esimerkki |
| root | Root | Aggregaatti | 1 | ||
| 1 | SalespaymentList | Aggregaatti | 1 | ||
| 2 | SalesPayment | Aggregaatti | 0...n | ||
| 3 | NetvisorKey | Numeerinen | 1 | Suorituksen Netvisor avain | |
| 3 | Name | Merkkijono | 1 | Suorituksen maksajan nimi | |
| 3 | Date | Päivämäärä | 1 | Suorituksen päivämäärä | |
| 3 | Sum | Numeerinen | 1 | Suorituksen summa | |
| 3 | ReferenceNumber | Merkkijono | 1 | Suorituksen viitenumero | |
| 3 | ForeignCurrencyAmount | Numeerinen | 1 | Suorituksen valuuttasumma | |
| 3 | InvoiceNumber | Numeerinen | 1 | Laskun numero | |
| 3 | PaymentAccountName | Merkkijono | 1 | Suorituksen pankin/maksutavan nimi | Käteinen |
| 3 | VoucherID | Numeerinen | 1 | Suorituksen tositteen NetvisorKey | 44 |
| 3 | LastModifiedTimestamp | Numeerinen | 1 | Tositteen viimeisin muokkausajankohta | 7.10.2021 14:24:42 |
| 3 | PaymentAccountNumber | Merkkijono | 1 | Suorituksentilinumero mikäli oli pankkitili | FI12 3456 xxx |
| 3 | BankStatus | Merkkijono | 1 | Suorituksen pankkistatus. OK tai FAILED | OK |
| 3 | BankStatusErrorDescription | Merkkijono | 0...1 | Virhekuvaus | |
| Attr. | code | Merkkojono | 0...1 | Virhekoodi |
Pankkistatuksen virhekoodien selitys:
| NO_ACCOUNT_FOUND | Tiliä ei löydy |
| NO_PAYMENT_SERVICE_ACCOUNT | Ei maksupalvelutili |
| ERROR_IN_DUE_DATE | Eräpäivä virheellinen |
| BALANCE_IS_EXCEEDED | Ei veloitettu |
| PAYER_HAS_CANCELED | Maksaja peruuttanut |
| FORM_NOT_CORRECT | Muotovirhe |
| BANK_HAS_CANCELLED | Pankki peruuttanut |
| CANCELLATION_NOT_CLEARING | Peruutus ei kohdistu |
| AUTHORIZATION_IS_MISSING | Valtuutus puuttuu |
Myyntisuorituksen tuonti
Resurssi: salespayment.nv
Resurssi myyntisuoritusten tuontia varten. Suoritus voidaan kohdistaa myyntilaskulle tai -tilaukselle.
Suorituksen kohdistus myyntilaskulle tai -tilaukselle voidaan tehdä NetvisorKey:n, lasku-/tilausnumeron tai viitenumeron avulla. Myyntilasku/-tilaus tulee olla olemassa ennen kuin sille tuodaan suoritus. Jos suoritus on tuotu ennen myyntilaskua/ se ei kohdistu enää automaattisesti. Myyntisuoritus ei myöskään kohdistu myyntilaskulle automaattisesti, mikäli lasku on Maksettu-tilassa.
Jos myyntilasku, jolle myyntisuoritus tuodaan, ottaa vastaan osasuorituksia, suoritus lisätään aina tarkkana summana. Jos myyntilasku ei hyväksy osasuorituksia, suorituksen summan tulee olla myyntilaskun kassa-alennus toleranssin sisällä.
Jos lähettämättömälle laskulle halutaan tuoda myyntisuoritus, pitää myyntilaskun ottaa vastaan osasuorituksia, että myyntisuoritus kohdistuu laskulle oikein. Jos myyntilasku tuodaan rajapinnan yli, osasuorituksien vastaanotto kerrotaan myyntilaskun sanomalla elementissä "expectpartialpayments". Jos myyntilasku tehdään suoraan Netvisorin käyttöliittymässä, osasuoritusten vastaanotto määritellään myynnin perusasetuksissa.
Myyntitilaukselle voidaan tuoda myyntisuoritus ja se kirjautuu tilaukselle ennakkosuorituksena. Kun tilauksesta muodostetaan lasku, siirtyvät ennakkosuoritukset laskulle suorituksiksi. Mikäli laskulle tuodaan koko summan kattava suoritus ja tilauksesta muodostetaan lasku, tulee laskun tilaksi automaattisesti "Maksettu". Huomioi, että kun suoritus tuodaan ennakkosuorituksena, tulee elementille 'paymentmethod' antaa attribuutti "overridesalesreceivableaccountnumber" (tositteen myynnin tilin ylikirjoitus). Tiliksi annetaan Netvisorin kirjanpidon asetuksissa määritetty Ennakkosuoritusten tili (esimerkiksi 2861 Saadut ennakot).
Tuotavan myyntisuorituksen tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena xml:nä (POST-data):
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| root | root | Aggregaatti | 1 | ||
| 1 | salespayment | Aggregaatti | 1 | ||
| 2 | sum | Numeerinen | 1 | Myyntisuorituksen summa | 10,00 |
| Attr. | currency | Merkkijono | 1 | Valuuttakoodi, jos ei löydy järjestelmästä, palautetaan INVALID_DATA selitteineen | EUR |
| 2 | paymentdate | Päivämäärä | 1 | Suorituksen päivämäärä | 2009-9-5 |
| 2 | targetidentifier | Merkkijono | 1 | Laskun kohdistustieto | 1070 |
| Attr. | type | Merkkijono | 1 | Kohdistustiedon tyyppi, netvisor, reference tai invoicenumber | invoicenumber |
| Attr. | targettype | Merkkijono | 0...1 | Suorituksen kohditus, invoice tai order | Order |
| 2 | sourcename | Merkkijono | 1 | Maksun lähteen nimi | Pekka Paajanen |
| 2 | paymentmethod | Merkkijono | 1 | Maksutapa. Maksutavan nimen tai pankkitilin IBAN-muotoisen numeron tulee löytyä kohdeNetvisorista. | pankkikortti |
| Attr. | type | Merkkijono | 1 | Maksutavan tyyppi: alternative tai bankaccount | alternative |
| Attr. | overrideaccountingaccountnumber | Numeerinen | 0...1 | Tositteen kirjanpidon tilin ylikirjoitus, jos tiliä ei löydy, palautetaan INVALID_DATA virhe | 1900 |
| Attr. | overridesalesreceivableaccountnumber | Numeerinen | 0...1 | Tositteen myynnin tilin ylikirjoitus | 2100 |
| 2 | salespaymentvoucherlines | Aggregaatti | 0...n | Myyntisuorituksen tositetiedot | |
| 3 | voucherline | Aggregaatti | 1...n | Tositerivi | |
| 4 | linesum | Numeerinen | 1 | Rivisumma | 10,00 |
| Attr. | type | Merkkijono | 1 | Ilmaisee sisältääkö rivisumma veron, net (veroton) tai gross (verollinen) | gross |
| 4 | description | Merkkijono | 0...1 | Rivin kuvaus | Myyntitapahtuma |
| 4 | accountnumber | Numeerinen | 1 | Tilin numero | 1500 |
| 4 | vatpercent | Numeerinen | 1 | Veroprosentti | 24 |
| Attr. | vatcode | Merkkijono | 1 | ALV-koodi *1 | KOMY |
| 4 | dimension | Aggregaatti | 0...n | Laskentakohde | |
| 5 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko | Käteiskauppa |
| 5 | dimensionitem | Merkkijono | 1 | Laskentakohteen nimi | Myynti |
*1) NONE, KOOS, EUOS, EUUO, EUPO, 100, KOMY, EUMY, EUUM, EUPM312, EUPM309, MUUL, EVTO, EVPO
Katsothan myös Arvonlisäveron käsittely ja ALV-tunnisteet
| 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 |
| 1.1.2010 alkaen tapahtumilla voidaan käyttää seuraavia kausiveroilmoituksen myötä tarvittavia alv-tunnisteita: | ||
| 312 EU-palvelumyynti | EUPM312 | 0 |
| 309 EU-palvelumyynti | EUPM309 | 0 |
| 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 |
| Rakentamispalvelun myynti | RAMY | 0 |
| Rakentamispalvelun osto | RAOS | 0, 10, 14, 24 |
| Ei vähennyskelpoinen rakentamispalvelun osto | EVRO | 0, 10, 14, 24 |
Myyntisuorituksen poisto
Resurssi: deletesalespayment.nv
Resurssilla voidaan poistaa olemassa oleva myyntisuoritus. Viitesuoritusten ja lukituille kausille kuuluvien suoritusten poisto ei ole sallittua. Myyntisuorituksen poisto mitätöi samalla myös tositteen.
Kutsussa käytettävä parametri:
| Parametri | Ilmentymiä | Kuvaus |
| paymentid | 1 | Poistettavan suorituksen NetvisorKey |
Myyntisuoritusten massatiliöinti
Resurssi: masspayments.nv
Resurssilla on mahdollista massatiliöidä myyntisuorituksia. Resurssille annetaan tositteen tyyppinä "single" tai "multiple" sen mukaan, halutaanko suoritukset kirjata samalle vai eri tositteille. Tyyppiä "single" käytettäessä tieto "voucherdate" on pakollinen. Annettava tositteen päivä tai annetut suoritukset eivät saa kuulua lukitulle kaudelle.
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| root | root | Aggregaatti | 1 | ||
| 1 | masspayments | Aggregaatti | 1 | ||
| 2 | vouchertype | Merkkijono | 1 | Kirjaustapa; Single tai multiple. Jos single, kirjataan suoritukset samalle tositteelle ja jos multiple, kirjataan jokainen suoritus omaksi tositteekseen. | single |
| 2 | voucherdate | Merkkijono | 0...1 | Tositteen päiväys. Pakollinen, jos "vouchertype=single" | 2021-11-25 |
| 2 | voucherdescription | Päivämäärä | 1 | Tositteen kirjausselite | Suoritukset |
| 2 | layoutrulenetvisorkey | Merkkijono | 1 | Tiliöintisäännön NetvisorKey, löydyttävä Netvisorista | 1 |
| 2 | masspayment | Aggregaatti | 1...n | ||
| 3 | paymentnetvisorkey | Merkkijono | 1 | Suorituksen NetvisorKey | 3000 |
Myyntisuorituksen kohdistus
Resurssi: matchpayment.nv
Resurssilla on mahdollista kohdistaa myyntisuoritus myyntilaskulle tai myyntitilaukselle. Käsittelytapojat ovat seuraavat: "normal" (normaali), "rounding" (pyöristys), "discount" (alennus), "partialpayment" (osasuoritus), "overpayment" (ylisuoritus), "notargeting" (ei kohdisteta), "collection" (perintä) tai "creditloss" (luottotappio). Käsittelytavat toimivat samalla tavalla, kuin Netvisorin käyttöliittymässä.
Jotta kohdistus voidaan tehdä, tulee sekä myyntilasku tai -tilaus että myyntisuoritus löytyä Netvisorista. Myyntisuoritus ei saa olla kohdistettuna myyntilaskulle tai -tilaukselle. Kohdistus tehdään myyntilaskun- tai tilauksen Netvisor Keyn ja myyntisuorituksen Netvisor Keyn avulla.
Jos käsittelytapana käytetään arvoa notargeting, ei elementti "invoicenetvisorkey" ole pakollinen. Tällöin suorituksesta muodostetaan tosite maksutilin ja myyntisaamisten oletustilin mukaisesti, mutta sitä ei kohdisteta mihinkään myyntilaskuun.
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| root | root | Aggregaatti | 1 | ||
| 1 | matchpayment | Aggregaatti | 1 | ||
| 2 | handlingtype | Merkkijono | 1 | Käsittelytapa: normal, rounding, discount, partialpayment, overpayment, notargeting, collection tai creditloss | rounding |
| 2 | paymentnetvisorkey | Numeerinen | 1 | Suorituksen Netvisor avain | 1 |
| 2 | invoicenetvisorkey | Numeerinen | 1 | Laskun Netvisor avain (ei pakollinen, mikäli käsittelytapa on notargeting) | 1 |
Ostosuorituksen nouto
Resurssi: paymentlist.nv
Resurssilla voidaan noutaa ostolaskun maksutiedot ja tarkastaa onko ostolasku maksettu vai ei.
Kutsussa käytettävät parametrit (QueryString):
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| limitabovenetvisorkey | 0...1 | Rajaa haettavien suoritusten id arvon suuremmaksi kuin annettu arvo | |
| limitbegindate | 0...1 | Maksun päivämäärärajauksen alku (ei eräpäivän) | 2015-10-23 |
| limitenddate | 0...1 | Maksun päivämäärärajauksen loppu (ei eräpäivän) | 2015-10-24 |
| limitreference | 0...1 | Rajaa maksun viitenumeron mukaan | |
| limitinvoiceid | 0...1 | Hakee kaikki tietyn ostolaskun maksut | 1 |
Vastaus:
| Taso | Elementti | Muoto | Ilmetymiä | Kuvaus | Esimerkki |
| root | Root | Aggregaatti | 1 | ||
| 1 | PaymentList | Aggregaatti | 1 | ||
| 2 | Payment | Aggregaatti | 0...n | ||
| 3 | NetvisorKey | Numeerinen | 1 | Suorituksen Netvisor avain | 1 |
| 3 | PayerName | Merkkijono | 1 | Suorituksen nimi | |
| 3 | Date | Päivämäärä | 1 | Suorituksen päivämäärä | |
| 3 | HomeCurrencySum | Numeerinen | 1 | Suorituksen summa | |
| 3 | ForeignCurrencySum | Numeerinen | 1 | Suorituksen valuuttasumma | |
| 3 | Reference | Merkkijono | 1 | Suorituksen viitenumero | 1070 |
| 3 | InvoiceKey | Numeerinen | 1 | Laskun Netvisor avain | 1 |
| 3 | InvoiceNumber | Numeerinen | 1 | Laskun numero | 123 |
| 3 | InvoiceURI | Merkkijono | 1 | Laskun URI | |
| 3 | VoucherKey | Numeerinen | 1 | Tositteen Netvisor avain | 1 |
| 3 | VoucherNumber | Numeerinen | 1 | Tositteen numero | 123 |
Tilisiirron tilan nouto
Resurssi: unprocessedoutgoingpayments.nv
Rersurssia käyttäen voidaan noutaa rajapinnan kautta lähetettyjen tilisiirtojen tilannetieto. Jos maksu on käsittelyssä ja pankista ei olla saatu palautetta, resurssi ei palauta mitään.
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| idlist | 1 | Haetaan lähetettyjen maksujen tilat, idlist = payment.nv resurssin palauttama InsertedDataIdentifier |
Vastaus:
| Taso | Elementti | Muoto | Ilmetymiä | Kuvaus | Esimerkki |
| root | Root | Aggregaatti | 1 | ||
| 1 | Payments | Aggregaatti | 1 | ||
| 2 | Payment | Aggregaatti | 0...n | ||
| 3 | Identifier | Numeerinen | 1 | Suorituksen Netvisor avain | |
| 3 | Status | Merkkijono | 1 | Suorituksen tila 2 = ok 3 = virheellinen | |
| 3 | StatusDescription | Merkkijono | 1 | Virheen tarkempi syy |
Tilisiirron tuonti
Resurssi: payment.nv
Rajapinnan kautta voidaan tuoda tilisiirto, joka pitää käydä hyväksymässä Netvisorin tilisiirtonäkymässä. Tilinumero pitää olla suomalainen ja IBAN -muotoinen, rajapinta tarkistaa tilinumeron ennen kuin tilisiirto viedään yritykseen. Tilisiirtojen valuuttana käytetään Netvisorissa aina euroa. Tilisiirtoja on mahdollista tehdä ainoastaan euromaksualueelle.
Mikäli tilisiirrolle tuodaan menneisyydessä oleva eräpäivä, vaihtaa Netvisor eräpäivän kuluvaan päivään, kun se laitetaan maksuun. Tilisiirtoa ei ole mahdollista muokata enää Netvisorissa.
Tuotavan tilisiirron tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena XML:nä (POST-data):
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| root | root | Aggregaatti | 1 | ||
| 1 | payment | Aggregaatti | 1 | ||
| 2 | bankpaymentmessagetype | Merkkijono | 1 | Viestin tyyppi: FinnishReference = viitenumero FreeText = viesti | FinnishReference |
| 2 | bankpaymentmessage | Merkkijono | 1 | Tilisiirron viesti: viitenumero tai viesti | 1071 |
| 2 | recipient | Aggregaatti | 1 | Vastaanottaja | |
| 3 | organizationcode | Merkkijono | 0...1 | Vastaanottajan y-tunnus | 1234567-8 |
| 3 | name | Merkkijono | 1 | Vastaanottajan nimi | Ville Valta |
| 3 | address | Merkkijono | 0...1 | Vastaanottajan osoite | Valtakatu 51 |
| 3 | postcode | Merkkijono | 0...1 | Vastaanottajan postinumero | 53100 |
| 3 | town | Merkkijono | 0...1 | Vastaanottajan kaupunki | Lappeenranta |
| 2 | sourcebankaccountnumber | Numeerinen | 1 | Maksajan tilinumero | FI000998874123 |
| 2 | destinationbankaccount | Aggregaatti | 1 | Vastaanottajan pankkitili | |
| 3 | bankname | Merkkijono | 1 | Vastaanottajan pankin nimi | Handelsbanken |
| 3 | bankbranch | Merkkijono | 1 | Vastaanottajan BIC | HANDFIHH |
| 3 | destinationbankaccountnumber | Merkkijono | 1 | Vastaanottajan tilinumero | FI000111234567 |
| 2 | duedate | Päivämäärä | 1 | Eräpäivä Huomaa eräpäivään liittyvät seikat dokumentaatio alusta | 2016-05-2525.5.2016 |
| 2 | amount | Numeerinen | 1 | Summa | 10,00 |
| 2 | paymentgroup | Aggregaatti | 0...1 | ||
| 3 | paymentgrouppayment | Aggregaatti | 0...n | Maksuryhmä | |
| 4 | sum | Numeerinen | 1 | Maksuryhmän summa | |
| 4 | reference | Numeerinen | 1 | Maksuryhmän viitenumero |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedback