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

IntegraatioHTTP-metodiResurssiDTDSkeemaEsimerkki
Myyntisuorituslistan noutoGETsalespaymentlist.nv  Lataa
Myyntisuorituksen tuontiPOSTsalespayment.nvsalespayment.dtd Lataa
Ostosuorituksen noutoGETpaymentlist.nv  Lataa
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 alku2015-10-23
enddate0...1Päivämäärärajauksen loppu2015-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älkeen2019-12-10 12:00
lastmodifiedend 0...1Hakee myyntisuoritukset, joita on muutettu ennen annettua päivämäärää2019-12-20 12:00

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
3PaymentAccountNumberMerkkijono1Suorituksentilinumero mikäli oli pankkitiliFI12 3456 xxx
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. 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):

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ä kohdeNetvisorista.
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

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

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 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):

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
rootrootAggregaatti1

1paymentAggregaatti1  
2bankpaymentmessagetypeMerkkijono1Viestintyyppi:
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
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
25.5.2016
2AmountNumeerinen1Summa10,00

 


xml
xml
(833 Bytes)
xml
xml
(235 Bytes)
xml

Oliko tästä vastauksesta apua? Kyllä Ei

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.