Myynti- ja ostosuoritusten sekä tilisiirtojen käsittelyn toiminnot jakautuvat seuraaviin resursseihin:

IntegraatioHTTP-metodiResurssiDTDSkeemaEsimerkki
Myyntisuorituslistan noutoGETsalespaymentlist.nv  Lataa
Myyntisuorituksen tuontiPOSTsalespayment.nvsalespayment.dtd Lataa
Myyntisuorituksen poistoPOSTdeletesalespayment.nv
 -
Poistettujen myyntisuoritusten noutoGETdeletedsalespayments.nv


Myyntisuoritusten massatiliöintiPOSTmasspayments.nv
masspayments.xsd
Lataa
Myyntisuorituksen kohdistusPOSTmatchpayment.nv
matchpayment.xsdLataa
Ostosuorituksen noutoGETpaymentlist.nv  Lataa
Poistettujen ostosuoritusten noutoGETdeletedpurchasepayments.nv


Tilisiirron tilan noutoGETunprocessedoutgoingpayments.nv  Lataa
Tilisiirron tuontiPOSTpayment.nvpayment.dtd Lataa

Myyntisuorituslistan nouto

Resurssi: salespaymentlist.nv

Myyntisuorituslistan noutoon tarkoitettu resurssi.

Kutsussa käytettävät parametrit:

ParametriIlmentymiäKuvausEsimerkki
abovenetvisorkey0...1Rajaa haettavien suoritusten id arvon suuremmaksi kuin annettu arvo 
begindate0...1Päivämäärärajauksen alku2021-10-23
enddate0...1Päivämäärärajauksen loppu2021-10-24
searchbyname0...1Hakee suorituksen nimellä 
limitlinkedpayments0...1Rajaa laskulinkityksen perusteella
0 - suorituksella ei ole laskua linkitettynä
1 - 
suorituksella pitää olla lasku linkitettynä
0
limitbytype0...1Rajaa suorituksen tyypin mukaan
onlycreditloss - listaa pelkät luottotappiot
excludecreditloss - listaa kaikki muut, paitsi ei luottotappioita
excludecreditloss
lastmodifiedstart 0...1Hakee myyntisuoritukset, joita on muutettu annetun päivämäärän jälkeen. Muodossa yyyy-MM-ddTHH:mm:ss2019-12-10T12:00:00
lastmodifiedend 0...1Hakee myyntisuoritukset, joita on muutettu ennen annettua päivämäärää. Muodossa yyyy-MM-ddTHH:mm:ss2019-12-20T12:00:00
invoicenetvisorkey0...1Hakee myyntilaskuun liittyvät suoritukset myyntilaskun NetvisorKey:n perusteella
123
invoicenumber0...1Hakee myyntilaskuun liittyvät suoritukset myyntilaskun laskunumeron perusteella

54684

Vastaus:

TasoElementtiMuotoIlmetymiäKuvausEsimerkki
rootRootAggregaatti1  
1SalespaymentListAggregaatti1  
2SalesPaymentAggregaatti0...n  
3NetvisorKeyNumeerinen1Suorituksen Netvisor avain 
3NameMerkkijonoSuorituksen maksajan nimi 
3DatePäivämääräSuorituksen päivämäärä 
3SumNumeerinenSuorituksen summa 
3ReferenceNumberMerkkijonoSuorituksen viitenumero 
3ForeignCurrencyAmountNumeerinenSuorituksen valuuttasumma 
3InvoiceNumberNumeerinenLaskun numero 
3PaymentAccountNameMerkkijono1Suorituksen pankin/maksutavan nimiKäteinen
3
VoucherID
Numeerinen
1
Suorituksen tositteen NetvisorKey
44
3
LastModifiedTimestamp
Numeerinen
1
Tositteen viimeisin muokkausajankohta
7.10.2021 14:24:42
3PaymentAccountNumberMerkkijono1
Suorituksentilinumero mikäli oli pankkitiliFI12 3456 xxx
3PaymentSourceNumeerinen1Suorituksen lähde
(1 = viitesuoritus
2 = hyvityslasku
3 = rahoituspalvelu
99 = muu)
1
3BankStatusMerkkijonoSuorituksen pankkistatus. OK tai FAILED
OK
3BankStatusErrorDescriptionMerkkijono0...1Virhekuvaus 
Attr.codeMerkkojono0...1Virhekoodi 

Pankkistatuksen virhekoodien selitys:

NO_ACCOUNT_FOUND Tiliä ei löydy
NO_PAYMENT_SERVICE_ACCOUNTEi maksupalvelutili
ERROR_IN_DUE_DATEEräpäivä virheellinen
BALANCE_IS_EXCEEDEDEi veloitettu
PAYER_HAS_CANCELEDMaksaja peruuttanut
FORM_NOT_CORRECTMuotovirhe
BANK_HAS_CANCELLEDPankki peruuttanut
CANCELLATION_NOT_CLEARINGPeruutus ei kohdistu
AUTHORIZATION_IS_MISSINGValtuutus 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):

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
rootrootAggregaatti1  
1salespaymentAggregaatti1  
2sumNumeerinen1Myyntisuorituksen summa10,00
Attr.currencyMerkkijonoValuuttakoodi, jos ei löydy järjestelmästä, palautetaan INVALID_DATA selitteineenEUR
2paymentdatePäivämääräSuorituksen päivämäärä2009-9-5
2targetidentifierMerkkijonoLaskun kohdistustieto1070
Attr.typeMerkkijonoKohdistustiedon tyyppi, netvisor, reference tai invoicenumberinvoicenumber
Attr.targettypeMerkkijono0...1 Suorituksen kohditus, invoice tai orderOrder
2sourcenameMerkkijonoMaksun lähteen nimiPekka Paajanen
2paymentmethodMerkkijonoMaksutapa. Maksutavan nimen tai pankkitilin IBAN-muotoisen numeron tulee löytyä Netvisorista.
pankkikortti
Attr.typeMerkkijonoMaksutavan tyyppi: alternative tai bankaccountalternative
Attr.overrideaccountingaccountnumberNumeerinen0...1 Tositteen kirjanpidon tilin ylikirjoitus, jos tiliä ei löydy, palautetaan INVALID_DATA virhe1900
Attr.overridesalesreceivableaccountnumberNumeerinen0...1 Tositteen myynnin tilin ylikirjoitus2100
2salespaymentvoucherlinesAggregaatti0...nMyyntisuorituksen tositetiedot 
3voucherlineAggregaatti1...nTositerivi 
4linesumNumeerinenRivisumma10,00
Attr.typeMerkkijonoIlmaisee sisältääkö rivisumma veron, net (veroton) tai gross (verollinen)gross 
descriptionMerkkijono0...1 Rivin kuvausMyyntitapahtuma
accountnumberNumeerinenTilin numero1500 
vatpercentNumeerinenVeroprosentti24
Attr.vatcodeMerkkijonoALV-koodi *1KOMY 
4dimensionAggregaatti0...nLaskentakohde 
5dimensionnameMerkkijono1LaskentakohdeotsikkoKäteiskauppa
5dimensionitemMerkkijono1Laskentakohteen nimiMyynti 

*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-tunnisteALV-koodiALV-prosentti
Ei alv-käsittelyäNONE0
Kotimaan myyntiKOMY0, 10, 14, 24
EU-myyntiEUMY0
EU:n ulkopuolinen myyntiEUUM0
Kotimaan ostoKOOS0, 10, 14, 24
EU-ostoEUOS0, 10, 14, 24
EU-palveluostoEUPO0, 10, 14, 24
EU:n ulkopuolinen ostoEUUO0, 10, 14, 24
100%1000
1.1.2010 alkaen tapahtumilla voidaan käyttää seuraavia kausiveroilmoituksen myötä tarvittavia alv-tunnisteita:
312 EU-palvelumyyntiEUPM3120
309 EU-palvelumyyntiEUPM3090
Muu arvonlisäveroton liikevaihto (310)MUUL0, 10, 14, 24
Tavaraostot muista EU-maista, vähennyskelvotonEVTO0, 10, 14, 24
Palveluostot muista EU-maista, vähennyskelvotonEVPO0, 10, 14, 24
Rakentamispalvelun myyntiRAMY0
Rakentamispalvelun ostoRAOS0, 10, 14, 24
Ei vähennyskelpoinen rakentamispalvelun ostoEVRO0, 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:

ParametriIlmentymiäKuvaus
paymentid1Poistettavan suorituksen NetvisorKey

Poistettujen myyntisuoritusten nouto

Resurssi: deletedsalespayments.nv

Resurssilla voi hakea Netvisorista poistettujen myyntisuoritusten tunnistetiedot 7 päivää taaksepäin.

Kutsussa käytettävät parametrit:

ParametriIlmentymiäKuvausEsimerkki
deletedsince1Pakollinen. Hakee tapahtumat, jotka poistettu annetun päivämäärän jälkeen. Tapahtumia voi hakea enintään 7 päivän takaa historiasta
2022-06-08

Vastaus:

TasoElementtiMuoto ja pituusIlmentymiäKuvausEsimerkki
1rootAggregaatti1  
2
DeletedSalesPaymentsAggregaatti1

3DeletedSalesPaymentAggregaatti0...n


4
NetvisorKeyNumeerinen1Myyntisuorituksen Netvisor-avain5
4DeleteDatePäivämäärä1Myyntisuorituksen poistopäivämäärä2022-06-08 15:14
Attr.
formatMerkkijono1Päivämäärän tyyppiansi

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.

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
rootrootAggregaatti1  
1masspaymentsAggregaatti1  
2vouchertypeMerkkijono1Kirjaustapa; Single tai multiple. Jos single, kirjataan suoritukset samalle tositteelle ja jos multiple, kirjataan jokainen suoritus omaksi tositteekseen.single
2
voucherdate
Merkkijono0...1Tositteen päiväys. Pakollinen, jos "vouchertype=single"2021-11-25
2voucherdescriptionPäivämääräTositteen kirjausseliteSuoritukset
2layoutrulenetvisorkeyMerkkijonoTiliöintisäännön NetvisorKey, löydyttävä Netvisorista1
2masspaymentAggregaatti1...n 

3paymentnetvisorkeyMerkkijono1
Suorituksen NetvisorKey3000

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.

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
rootrootAggregaatti1  
1matchpaymentAggregaatti1  
2handlingtype
Merkkijono1Käsittelytapa: normal, rounding, discount, partialpayment, overpayment, notargeting, collection tai creditlossrounding
2
paymentnetvisorkey
Numeerinen
1Suorituksen Netvisor avain
1
2invoicenetvisorkey
Numeerinen
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):

ParametriIlmentymiäKuvausEsimerkki
limitabovenetvisorkey0...1Rajaa haettavien suoritusten id arvon suuremmaksi kuin annettu arvo 
limitbegindate0...1Maksun päivämäärärajauksen alku (ei eräpäivän)2015-10-23
limitenddate0...1Maksun päivämäärärajauksen loppu (ei eräpäivän)2015-10-24
limitreference0...1Rajaa maksun viitenumeron mukaan 
limitinvoiceid0...1Hakee kaikki tietyn ostolaskun maksut1

Vastaus:

TasoElementtiMuotoIlmetymiäKuvausEsimerkki
rootRootAggregaatti1  
1PaymentListAggregaatti1  
2PaymentAggregaatti0...n  
3NetvisorKeyNumeerinen1Suorituksen Netvisor avain 1
3PayerNameMerkkijonoSuorituksen nimi 
3DatePäivämääräSuorituksen päivämäärä 
3HomeCurrencySumNumeerinenSuorituksen summa 
3ForeignCurrencySumNumeerinen1Suorituksen valuuttasumma 
3ReferenceMerkkijonoSuorituksen viitenumero 1070
3InvoiceKeyNumeerinenLaskun Netvisor avain 1
3InvoiceNumberNumeerinenLaskun numero 123
3InvoiceURIMerkkijonoLaskun URI 
3VoucherKeyNumeerinenTositteen Netvisor avain 1
3VoucherNumberNumeerinenTositteen numero 123

Poistettujen ostosuoritusten nouto

Resurssi: deletedpurchasepayments.nv

Resurssilla voi hakea Netvisorista poistettujen ostosuoritusten tunnistetiedot 7 päivää taaksepäin.

Kutsussa käytettävät parametrit:

ParametriIlmentymiäKuvausEsimerkki
deletedsince1Pakollinen. Hakee tapahtumat, jotka poistettu annetun päivämäärän jälkeen. Tapahtumia voi hakea enintään 7 päivän takaa historiasta
2022-06-08

Vastaus:

TasoElementtiMuoto ja pituusIlmentymiäKuvausEsimerkki
1rootAggregaatti1  
2
DeletedPurchasePaymentsAggregaatti1

3DeletedPurchasePaymentAggregaatti0...n


4
NetvisorKeyNumeerinen1Ostosuorituksen Netvisor-avain5
4DeleteDatePäivämäärä1Ostosuorituksen poistopäivämäärä2022-06-08 15:14
Attr.
formatMerkkijono1Päivämäärän tyyppiansi

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.

ParametriIlmentymiäKuvausEsimerkki
idlist1Haetaan lähetettyjen maksujen tilat, idlist = payment.nv resurssin palauttama InsertedDataIdentifier 

Vastaus:

TasoElementtiMuotoIlmetymiäKuvausEsimerkki
rootRootAggregaatti1  
1PaymentsAggregaatti1  
2PaymentAggregaatti0...n  
3IdentifierNumeerinen1Suorituksen Netvisor avain 
3StatusMerkkijonoSuorituksen tila
2 = ok
3 = virheellinen
 
3StatusDescriptionMerkkijonoVirheen tarkempi syy 

Tilisiirron tuonti

Resurssi: payment.nv

Rajapinnan kautta voidaan tuoda uusia tilisiirtoja, jotka hyväksytään tai maksetaan Netvisorin tilisiirtonäkymästä. Tilisiirtoja voidaan tehdä SEPA-alueelle ja vastaanottajan tilinumeron täytyy olla IBAN-muotoinen. Tilinumeron oikeellisuus tarkastetaan tuonnin yhteydessä. BIC-koodin oikeellisuus tarkastetaan, jos Netvisor ei tunnista pankkia vastaanottajan tilinumeron perusteella (Tuetut pankit). Tilisiirtojen valuuttana käytetään Netvisorissa aina euroa. 

Mikäli tilisiirrolle tuodaan menneisyydessä oleva eräpäivä, vaihtaa Netvisor eräpäivän kuluvaan päivään, kun tilisiirto viedään maksuun. Tilisiirtoja on mahdollista muokata tuonnin jälkeen Netvisorissa. Useampia tuotuja tilisiirtoja on mahdollista maksaa samassa maksuerässä, minkä lisäksi normaaleja (Netvisorissa luotuja) ja rajapinnan kautta tuotuja) tilisiirtoja voidaan niputtaa. Kaikki yhtä aikaa maksuun viedyt saman maksutilin ja maksupäivän tilisiirrot maksetaan yhdessä maksuerässä.

Tuotavan tilisiirron tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena XML:nä (POST-data):

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
rootrootAggregaatti1

1paymentAggregaatti1  
2bankpaymentmessagetypeMerkkijono1Viestin tyyppi:
FinnishReference = viitenumero
FreeText = viesti
FinnishReference
2bankpaymentmessageMerkkijono1Tilisiirron viesti: viitenumero tai viesti1071
2recipientAggregaatti1Vastaanottaja 
3organizationcodeMerkkijono0...1 Vastaanottajan y-tunnus1234567-8
3nameMerkkijono1Vastaanottajan nimiVille Valta
3addressMerkkijono0...1Vastaanottajan osoiteValtakatu 51
3postcodeMerkkijono0...1Vastaanottajan postinumero53100
3townMerkkijono0...1Vastaanottajan kaupunkiLappeenranta
3countryMerkkijono0...1Vastaanottajan maa ISO-3166 alpha-2 muodossaFI
2sourcebankaccountnumberNumeerinen1Maksajan tilinumeroFI000998874123
2destinationbankaccountAggregaatti1Vastaanottajan pankkitili 
3banknameMerkkijono1Vastaanottajan pankin nimiHandelsbanken
3bankbranchMerkkijono1Vastaanottajan BICHANDFIHH
3destinationbankaccountnumberMerkkijono1Vastaanottajan tilinumeroFI000111234567
2duedatePäivämäärä1Eräpäivä
Huomaa eräpäivään liittyvät seikat dokumentaatio alusta
2016-05-2525.5.2016
2amountNumeerinen1Summa10,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

 


xml
(511 Bytes)
xml
xml
(230 Bytes)
xml
xml
xml
(175 Bytes)
xml
(1.1 KB)

Oliko tästä vastauksesta apua? Kyllä Ei

Send feedback
Pahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.