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 | - | ||
| 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 | 2015-10-23 |
| enddate | 0...1 | Päivämäärärajauksen loppu | 2015-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 |
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 | 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. Asetus määritellään joko myyntilaskun sanomalla, jos lasku tuodaan rajapinnan yli, tai myynnin perusasetuksissa käyttöliittymässä.
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".
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.
Kutsussa käytettävä parametri:
| Parametri | Ilmentymiä | Kuvaus |
| paymentid | 1 | Poistettavan suorituksen NetvisorKey |
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 | Viestintyyppi: 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 | 25.5.2016 |
| 2 | Amount | Numeerinen | 1 | Summa | 10,00 |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedback