Resource: getvendor.nv

HTTP-method: GET

Returns vendor information. Vendor information can be retrieved using NetvisorKey or alteration timestamp. Vendors NetvisorKeys can be retrieved over the api by using the alteration timestamp (changedsince) parameter.

Through Netvisor UI NetvisorKey can be obtained when opening the vendor and looking the serch bar, where is id (e.g. id=123).

Parameters:

ParameterOccursDescriptionExample
netvisorkey1Netvisor key of the vendor. The root element in the response is "vendor"1
netvisorkeylist0...1Can be used to get the details of several vendors with given id. 
Note that there should be a vendor with all given IDs, otherwise the API will return an error message.
The root element in the response is "vendors" if there are several IDs given.
1,2,3
changedsince0...1Filters result to contain only vendors having change after given date, date in format YYYY-MM-DD or time in format YYYY-MM-DDTHH:MM:SS.

The root element in the response is "vendors" if there are several IDs given. If there are no changes vendor details, the content of the vendors element is empty.

page0...1Parameter can be used to get vendors in the groups of 500. Each page must be called in a separate request.

Page information is included in the response header information e.g.
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

Response:

LevelElementTypeOccursDescriptionExample
RootRootAggr.1  
1VendorAggr.1The root element in the response is "vendor" or "vendors", see parameter descriptions. 
2NetvisorKeyNumeric1Vendor's Netvisor Key123
2VendorBaseInformationAggr.1  
3CodeString0...1Vendor code123
3NameString1Vendor nameTestitoimittaja
3AddressString0...1AddressToimittajakatu 1
3PostCodeString0...1Postal code00100
3CityString0...1CityHelsinki
3CountryString0...1County codeFI
Attr.typeString1Type of county codeISO-3166
3OrganizationIdString0...1Business ID (Y-tunnus)123456-7
3GroupNameString0...1Vendor groupThe toimittajat
3VendorBankAccountsAggr.0...1Vendor's bank accounts 
4VendorDomesticBankAccounts Aggr.0...1  
5VendorDomesticBankAccountAggr.0...8Finnish bank accounts 
6NetvisorKeyNumeric0...1Bank account's NetvisorKey1
6IBAN
String1Account number (IBAN)FI7536359370000661
6BankNameString1Bank nameTestipankki
6IsDefaultString0...1Use as a default or notTrue
4VendorForeignBankAccounts  Aggr.0...1  
5VendorForeignBankAccountAggr.0...8Foreign bank accounts 
6NetvisorKeyNumeric0...1Bank account's NetvisorKey2
6BBAN
String1Account number (IBAN)GB29NWBK60161331926819
6BicSwiftString1BIC codeBUKBGB22
6BankNameString1Bank nameBarclays
6ClearingCodeString0...1Clearing code 
6ClearingNumberString0...1Clearing number 
6BankAddresssString0...1Bank addressBank Street 1
6CountryString1Country codeGB
Attr.typeString

1

Country code typeISO-3166
6CurrencyCodeString1Currency codeGBP
Attr.typeString1Currency code typeISO-4217
6IsDefaultString0...1Use as a default or notFalse
6IncludeAddresssInForeignPaymentsString0...1Add bank's address information to payment message besides BIC codeTrue
2VendorContactDetailsAggr.0...1Vendor's contact information 
3PhoneNumberString0...1Phone number+35850123456
3EmailString0...1Emailtoimittaja@toimittajat.fi
3FaxNumberString0...1Fax 
3ContactPersonNameString0...1Contact person's nameTimo Testaaja
3ContactPersonPhoneNumberString0...1Contact person's phone number+35840987654
3ContactPersonEmailString0...1Contact person's emailtimo.testaaja@toimittajat.fi
3HomePageString0...1Home page 
3CommentString0...1CommentNo comments
2VendorAdditionalInformationAggr.0...1  
3DefaultVatPercentNumeric0...1Default VAT number24
3IsPartialVatReducedPrivilegedString0...1Partial VAT reduced priviledgedFalse
3PaymentTermNumeric0...1Default term of payment 3
3VendorDimensionsAggr.0...1Default dimensions 
4DimensionAggr.1Dimension nameKohde
5DimensionNameString1Dimension nameProjects
5DimensionItemString1Dimension itemProject 1
3VendorAccountingAccountsAggr.0...1Vendor accounting accounts 
4VendorAccountingAccountAggr.1...n  
5AccountNumberString1Account number4000
5AccountNameString1Account nameOstot
5IsDefaultString1Use as a default or notTrue
3VendorAcceptanceDetailsAggr.0...1Acceptors 
4VendorAcceptanceDetailAggr.1...n  
5AcceptanceNameString0...1Acceptor nameTaaki Tarkastaja
5IsDefaultString0...1Use as a default or notFalse
5IsForcedString0...1  


Did you find it helpful? Yes No

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