Resurssi: vendor.nv
HTTP-metodi: POST
Voidaan tuoda uusi toimittaja ja muokata olemassa olevaa toimittajaa.
Toimittajan tuonnin yhteydessä rajapinta palauttaa vastaussanomalla toimittajan NetvisorKey:n. Suosittelemme ottamaan tämän talteen, mikäli toimittajatietoja on tarpeen muokata tai noutaa myöhemmin. Toimittajan NetvisorKey:n saa noudettua rajapinnan yli toimittajalistauksen avulla parametrilla changedsince. Netvisorin käyttöliittymässä toimittajan NetvisorKey:n saa tietoon avaamalla toimittajakortin ja katsomalla sen osoiteriviltä kohdasta 'id' (esim. id=123).
Sanomalla voidaan tuoda tieto toimittajan pankkitileistä. Pankkitilit on jaettu kotimaisiin ja ulkomaisiin pankkitilieihin. Pankkitileillä on erilaiset sisällöt:
Jos pankkitilin kehyksessä ei ole omaa NetvisorKey arvoa, lisätään toimittajalle uusi pankkitili. Mikäli NetvisorKey löytyy muokataan kyseistä pankkitiliä.
Pankkitilin IsDefault kentällä voidaan asettaa tili oletustiliksi. Jos annettu useampi True arvo, asetetaan järjestyksessä viimeinen tili oletustiliksi.
Kutsussa käytettävät parametrit:
Parametri | Muoto | Ilmentymiä | Kuvaus |
method | Merkkijono | 1 | Add Lisää uusi toimittaja |
netvisorkey | Numeerinen | 0...1 | Toimittajan NetvisorKey |
useonlyexistingdimensions | Numeerinen | 0...1 | Estää uusien laskentakohdeotsikkojen ja laskentakohteiden automaattisen luonnin. Palauttaa virheen, jos annettua laskentakohdetta ei ole olemassa. |
Tuotavan toimittajan tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena XML:nä (POST-data):
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 |
|
|
1 | vendor | Aggregaatti | 1 |
|
|
2 | vendorbaseinformation | Aggregaatti | 1 |
|
|
3 | code | Merkkijono | 0...1 | Toimittajakoodi | 123 |
3 | name | Merkkijono | 1 | Toimittajan nimi | Testitoimittaja |
3 | address | Merkkijono | 1 | Osoite | Toimittajakatu 1 |
3 | postcode | Merkkijono | 1 | Postikoodi | 00100 |
3 | city | Merkkijono | 1 | Kaupunki | Helsinki |
3 | country | Merkkijono | 1 | Maakoodi | FI |
Attr. | type | Merkkijono | 1 | Maakoodin tyyppi | ISO-3166 |
3 | organizationid | Merkkijono | 1 | Y-tunnus | 123456-7 |
3 | groupname | Merkkijono | 0...1 | Toimittajaryhmä | The toimittajat |
3 | vendorbankaccounts | Aggregaatti | 0...1 | Toimittajan pankkitilit |
|
4 | vendordomesticbankaccounts | Aggregaatti | 0...1 |
|
|
5 | vendordomesticbankaccount | Aggregaatti | 0...8 | Suomalaiset pankkitilit |
|
6 | netvisorkey | Numeerinen | 0...1 | Pankkitilin NetvisorKey | 1 |
6 | iban | Merkkijono | 1 | Tilinumero IBAN muodossa | FI7536359370000661 |
6 | bankname | Merkkijono | 1 | Pankin nimi | Testipankki |
6 | isdefault | Merkkijono | 0...1 | Käytetäänkö oletuksena | True |
4 | vendorforeignbankaccounts | Aggregaatti | 0...1 |
|
|
5 | vendorforeignbankaccount | Aggregaatti | 0...8 | Ulkomaalaiset pankkitilit |
|
6 | netvisorkey | Numeerinen | 0...1 | Pankkitilin NetvisorKey | 2 |
6 | bban | Merkkijono | 1 | Tilinumero BBAN muodossa | GB29NWBK60161331926819 |
6 | bicswift | Merkkijono | 1 | BIC numero | BUKBGB22 |
6 | bankname | Merkkijono | 1 | Pankin nimi | Barclays |
6 | clearingcode | Merkkijono | 0...1 | Clearingkoodi |
|
6 | clearingnumber | Merkkijono | 0...1 | Clearingnumero |
|
6 | bankaddresss | Merkkijono | 0...1 | Pankin osoite | Bank Street 1 |
6 | country | Merkkijono | 1 | Maakoodi | GB |
Attr. | type | Merkkijono | 1 | Maakoodin tyyppi | ISO-3166 |
6 | currencycode | Merkkijono | 1 | Valuuttakoodi | GBP |
Attr. | type | Merkkijono | 1 | Valuuttakoodin tyyppi | ISO-4217 |
6 | isdefault | Merkkijono | 0...1 | Käytetäänkö oletuksena | False |
6 | includeaddresssinforeignpayments | Merkkijono | 0...1 | Vie pankin osoitetiedot maksusanomalle BIC-koodin lisäksi | True |
2 | vendorcontactdetails | Aggregaatti | 0...1 | Toimittajan yhteystiedot |
|
3 | phonenumber | Merkkijono | 0...1 | Puhelinnumero | +35850123456 |
3 | Merkkijono | 0...1 | Sähköposti | ||
3 | faxnumber | Merkkijono | 0...1 | Faksi |
|
3 | contactpersonname | Merkkijono | 0...1 | Yhteyshenkilön nimi | Timo Testaaja |
3 | contactpersonphonenumber | Merkkijono | 0...1 | Yhteyshenkilön puhelinnumero | +35840987654 |
3 | contactpersonemail | Merkkijono | 0...1 | Yhteyshenkilön | |
3 | homepage | Merkkijono | 0...1 | Kotisivut |
|
3 | comment | Merkkijono | 0...1 | Kommentti | No comments |
2 | vendoradditionalinformation | Aggregaatti | 0...1 |
|
|
3 | usedefaultpaymentterminreceivedinvoices | Merkkijono | 0...1 | False | Käytetäänkö toimittajan oletusmaksuehtoa saapuvissa ostolaskuissa. Oletusmaksuehto asetetaan tarvittavissa elementeissä paymenttermdiscountpercent, paymenttermcashdiscountdays ja paymenttermnetdays. |
3 | defaultvatpercent | Numeerinen | 0...1 | Oletus ALV-kanta | 24 |
3 | ispartialvatreduceprivileged | Merkkijono | 0...1 | Vain osittainen ALV-vähennysoikeu | False |
3 | paymenttermdiscountpercent | Numeerinen | 0...1 | Alennus prosentti |
|
3 | paymenttermcashdiscountdays | Numeerinen | 0...1 | Alennus päivät |
|
3 | paymenttermnetdays | Numeerinen | 0...1 | Oletusmaksuehto |
|
3 | currencycode | Valuuttakoodi | 0...1 | Oletusvaluutta | EUR |
Attr. | type | Merkkijono | 1 | Valuuttakoodin tyyppi | ISO-4217 |
3 | vendordimensions | Aggregaatti | 0...1 | Oletuslaskentakohteet |
|
4 | dimension | Aggregaatti | 1...n |
|
|
5 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko | Project |
5 | dimensionitem | Merkkijono | 1 | Laskentakohde | Project 1 |
5 | dimensionitemcode | Merkkijono | 0...1 | Laskentakohteen koodi | DIMC-001 |
5 | dimensionitemname | Merkkijono | 0...1 | Laskentakohteen nimi | Item Name 1 |
3 | vendoraccountingaccounts | Aggregaatti | 0...1 | Toimittajan kirjanpidon tilit |
|
4 | vendoraccountingaccount | Aggregaatti | 1...n |
|
|
5 | accountnumber | Merkkijono | 1 | Kirjanpidon tili | 4000 |
5 | isdefault | Merkkijono | 1 | Käytetäänkö oletuksena | True |
3 | vendoracceptancedetails | Aggregaatti | 0...1 | Asiatarkastajat |
|
4 | vendoracceptancedetail | Aggregaatti | 1...n |
|
|
5 | acceptancename | Merkkijono | 0...1 | Asiatarkastajan nimi | Taaki Tarkastaja |
5 | isdefault | Merkkijono | 0...1 | Käytetäänkö oletuksena | False |
5 | isforced | Merkkijono | 0...1 |
|
|