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 Edit Muokkaa olemassa olevaa toimittajaa |
| netvisorkey | Numeerinen | 0...1 | Toimittajan NetvisorKey Pakollinen jos method = edit |
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 | toimittaja@toimittajat.fi | |
| 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 | timo.testaaja@toimittajat.fi |
| 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 |
| 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 |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedbackPahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.