Resurssi: getvendor.nv

HTTP-metodi: GET

Palauttaa toimittajan tiedot. Toimittajan tiedot noudetaan NetvisorKey:n tai muutosaikaleiman perusteella. Toimittajien NetvisorKey:t saa noudettua rajapinnan yli käyttämällä muutosaikaleima (changedsince) parametria.

Netvisorin käyttöliittymässä toimittajan NetvisorKey:n saa tietoon avaamalla toimittajakortin ja katsomalla sen osoiteriviltä kohdasta 'id' (esim. id=123).

Kutsussa käytettävät parametrit:

ParametriIlmentymiäKuvausEsimerkki
netvisorkey1Toimittajan tunniste Netvisorissa.
Vastauksen juurielementtinä "vendor".
 1
netvisorkeylist0...1Palauttaa yhdessä pyynnössä tiedot toimittajista.
Huomioithan, että kaikilla annetuilla ID:illä on löydyttävä toimittaja, muuten tulee vastauksena pelkkä virhe: "Toimittajaa ei löydy, netvisorkey NNN".

Vastauksen juurielementtinä on "vendors", jos annetussa listassa on useita ID:itä, mutta"vendor" jos annettu vain yksi ID.
1,2,3
changedsince0...1Suodattaa toimittajat, joissa muutoksia annetun päivämäärän jälkeen. Päivämäärällä annetaan muodossa YYYY-MM-DD tai aikaleimalla YYYY-MM-DDTHH:MM:SS.
Vastauksen juurielementtinä on "vendors" jos listassa on useita ID:itä. Jos muuttuneita toimittaja ei ole, vendors-elementin sisältö on tyhjä.
Mikäli halutaan noutaa koko toimittajalistaus, parametrin päivämääränä voi antaa: getvendor.nv?changedsince=1970-01-01

page0...1Numeerinen arvo, jolla voi hakea toimittajatietoja 500 toimittajan sivuissa. Jokainen sivu pitää hakea omalla kutsullaan.

Sivutuksen tiedot palautetaan rajapinnan vastaussanoman header-tiedoissa. Esim:
X-Netvisor-Pagination-Current-Page : 2
X-Netvisor-Pagination-Previous-Page : 1
X-Netvisor-Pagination-Next-Page : 3
X-Netvisor-Pagination-Limit : 100
X-Netvisor-Pagination-Total-Count : 1000
2

Vastaus:

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
RootRootAggregaatti1  
1VendorAggregaatti1Juurielementti voi olla "vendor" tai "vendors", katso parametrien kuvauksista tarkemmat ohjeet. 
2NetvisorKeyNumeerinen1Toimittajan NetvisorKey123
2VendorBaseInformationAggregaatti1  
3CodeMerkkijono0...1Toimittajakoodi123
3NameMerkkijono1Toimittajan nimiTestitoimittaja
3AddressMerkkijono1OsoiteToimittajakatu 1
3PostCodeMerkkijono1Postikoodi00100
3CityMerkkijono1KaupunkiHelsinki
3CountryMerkkijono1MaakoodiFI
Attr.typeMerkkijono1Maakoodin tyyppi
ISO-3166
3OrganizationIdMerkkijono1Y-tunnus1234567-8
3GroupNameMerkkijono0...1ToimittajaryhmäThe toimittajat
3VendorBankAccountsAggregaatti0...1Toimittajan pankkitilit
 
4VendorDomesticBankAccounts Aggregaatti0...1  
5VendorDomesticBankAccountAggregaatti0...8Suomalaiset pankkitilit
 
6NetvisorKeyNumeerinen0...1Pankkitilin NetvisorKey
1
6IBAN
Merkkijono1Tilinumero IBAN muodossa
FI7536359370000661
6BankNameMerkkijono1Pankin nimi
Testipankki
6IsDefaultMerkkijono0...1Käytetäänkö oletuksenaTrue
4VendorForeignBankAccounts Aggregaatti0...1 Ulkomaalaiset pankkitilit
 
5VendorForeignBankAccountAggregaatti0...8Ulkomaalainen pankkitili 
6NetvisorKeyNumeerinen0...1Pankkitilin NetvisorKey2
6BBAN
Merkkijono1Tilinumero BBAN muodossaGB29NWBK60161331926819
6BicSwiftMerkkijono1BIC numero
BUKBGB22
6BankNameMerkkijono1Pankin nimiBarclays
6ClearingCodeMerkkijono0...1Clearing koodi
 
6ClearingNumberMerkkijono0...1Clearing numero
 
6BankAddresssMerkkijono0...1Pankin osoite
Bank Street 1
6CountryMerkkijono1MaakoodiGB
Attr.typeMerkkijono

1

Maakoodin tyyppiISO-3166
6CurrencyCodeMerkkijono1ValuuttakoodiGBP
Attr.typeMerkkijono1Valuuttakoodin tyyppiISO-4217
6IsDefaultMerkkijono0...1Käytetäänkö oletuksenaFalse
6IncludeAddresssInForeignPaymentsMerkkijono0...1Vie pankin osoitetiedot maksusanomalle BIC-koodin lisäksiTrue
2VendorContactDetailsAggregaatti0...1Toimittajan yhteystiedot 
3PhoneNumberMerkkijono0...1Puhelinnumero+35850123456
3EmailMerkkijono0...1Sähköpostitoimittaja@toimittajat.fi
3FaxNumberMerkkijono0...1Faksi 
3ContactPersonNameMerkkijono0...1Yhteyshenkilön nimi
Timo Testaaja
3ContactPersonPhoneNumberMerkkijono0...1Yhteyshenkilön puhelinnumero
+35840987654
3ContactPersonEmailMerkkijono0...1Yhteyshenkilön timo.testaaja@toimittajat.fi
3HomePageMerkkijono0...1Kotisivut 
3CommentMerkkijono0...1KommenttiNo comments
2VendorAdditionalInformationAggregaatti0...1
 
6

UseDefaultPaymentTermInReceivedInvoices
Merkkijono0...1Käytä aina oletusmaksuehtoa saapuvissa laskuissa
True
3DefaultVatPercentNumeerinen0...1Oletus ALV-kanta24
3IsPartialVatReducedPrivilegedMerkkijono0...1Vain osittainen ALV-vähennysoikeusFalse
3PaymentTermNumeerinen0...1Oletusmaksuehto
3VendorDimensionsAggregaatti0...1Oletuslaskentakohteet 
4DimensionAggregaatti1

5DimensionNameMerkkijono1LaskentakohdeotsikkoProjekti
5DimensionItemMerkkijono 1LaskentakohdeProjekti 1
3VendorAccountingAccountsAggregaatti0...1Toimittajan kirjanpidon tilit 
4VendorAccountingAccountAggregaatti1  
5AccountNumberMerkkijono 1Kirjanpidon tili4000
5AccountName



5IsDefaultMerkkijono 1Käytetäänkö oletuksenaTrue
3VendorAcceptanceDetailsAggregaatti0...1Asiatarkastajat 
4VendorAcceptanceDetailAggregaatti1...n  
5AcceptanceNameMerkkijono 0...1Asiatarkastajan nimiTaaki Tarkastaja
5IsDefaultMerkkijono 0...1Käytetäänkö oletuksenaFalse
5IsForcedMerkkijono 0...1  


Oliko tästä vastauksesta apua? Kyllä Ei

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