Resource: getcustomer.nv

HTTP-method: GET

In order to retrieve the wanted customer details, the customer ID is needed. This can be picked from the customerlist.

Querystring parameters:

Parameter nameOccursDescriptionExample
id1ID of the customer 123
idlist0...1Can be used to get the details of several customers with given id. Max. 500 identifiers
1,2,3
replyoption
0...1Returns customer's invoicing history details.1

Response:

LevelElement nameType and lengthOccursDescriptionExample
1CustomerAggr.1  
2CustomerBaseInformationAggr.1  
3NetvisorKeyInteger1Customer Netvisor key1001
3InternalIdentifierString1Customer codeMM
3ExternalIdentifierString1Organization identifier1234567-8
3OrganizationUnitNumberInteger0...1Organization unit number0037123456715
3CustomerGroupNetvisorKeyString0...1Netvisor identifier of customer group 
3CustomerGroupNameString0...1Name of the customer group 
3NameString 1Name of the customerMatti Meikäläinen
3NameExtensionString 1Extension for the name of the customerToimitusjohtaja
3StreetAddressString 1Customer's street addressPajukuja 1
3AdditionalStreetAddressString1Address extension 
 3CityString 1Customer's post officeLappeenranta
3PostNumberString1Customer's post number53100
3CountryString0...1Country codeFI
Attr.TypeString 0...1Always ISO-3166ISO-3166
3PhoneNumberString 1Customer's phone number040 123 4567
3FaxNumberString 1Customer's fax number05 123 4567
3EmailString 1Customer's E-mail addressmatti.meikalainen@firma.fi
3EmailInvoicingAddressString1E-mail invoice addressmatti.meikalainen@firma.fi
3HomePageUriString 1Customer's web sitewww.firma.fi
3IsActiveNumeric10 or 1, is customer active  1  
3IsPrivateCustomerNumeric10 or 1. Value 1 indicates customer is a private customer1
2CustomerFinvoiceDetailsAggr.1  
3FinvoiceAddressString1E-invoice addressFI10970021497
3FinvoiceRouterCodeString 1E-invoice operatorNDEAFIHH
2CustomerDeliveryDetailsAggr.1 Customer's default office 
3DeliveryNameString 1Name for the deliveryMatti Meikäläinen
3DeliveryStreetAddressString1Delivery addressPajukuja 1
3DeliveryCityString1Delivery Post officeLappeenranta
3DeliveryPostNumberString1Delivery post number53100
3DeliveryCountryString0...1Delivery countryFI
Attr.typeString 0...1Always ISO-3166ISO-3166
2CustomerContactDetailsAggr.1  
3ContactPersonString 1Default contact person's name 
3ContactPersonEmailString 1Default contact person's E-mail address 
3ContactPersonPhoneString 1Default contact person's Phone number 
2CustomerContactPersonsAggr.0...1  
3CustomerContactPersonAggr.1  
4ContactPersonIDInteger1Contact person's NetvisorID1006
4ContactPersonFirstNameString1Contact person's first nameEric
4ContactPersonLastNameString1Contact person's last nameExample
4ContactPersonPhoneNumberNumeric1Contact person's phone number0501234567
4ContactPersonEmailString1Contact person's E-mail addresseric.example@company.com
4ContactPersonOfficeNetvisorKeyNumeric1Contact person's office NetvisorID2
2CustomerOfficeDetailsAggr.0...nCustomer offices details
 
3OfficeNetvisorKeyNumeric
1Office NetvisorID10
3OfficeNameString1Office nameHelsingin toimisto
3OfficePhoneNumberString1Office phone 040 312 654
3OfficeTelefaxNumberString1Office fax
05 321 654
3OfficeIdentifierString1Office identifierOfficeidentifier
3OfficeContactAddressAggr.1Office postal address
 
4StreetAddressString0...1Street addressKeskuskatu 1
4PostNumberString0...1Postcode00100
4CityString0...1CityHelsinki
4CountryString0...1CountryFinland
3OfficeVisitAddressAggr.1Visiting address
 
4StreetAddressString0...1Street addressKeskuskatu 1
4PostNumberString0...1Postcode00100
4CityString0...1CityHelsinki
4CountryString0...1CountryFinland
3OfficeFinvoiceDetailsAggr.1Office electronic invoicing details
 
4FinvoiceAddressString0...1E-invoice address (IBAN or EIA)003716264123
4FinvoiceRouterCodeString0...1E-invoice operator code003721291126
2CustomerAdditionalInformationAggr.1  
3CommentString 1Comment text 
3CustomerAgreementIdentifierString1Contract ID 
3ReferenceNumberString 1Standard reference 
3UseCreditorReferenceNumberNumeric1Use RF-reference in invoicing. 1 or 0.1
3YourDefaultReferenceString1Your default reference 
3DefaultTextBeforeInvoiceLinesString1Default text before invoice rows 
3DefaultTextAfterInvoiceLinesString1Default text after invoice rows 
3DefaultPaymentTermString1Default payment term14 days net
Attr.NetvisorKey String1NetvisorKey (ID)2
3TaxHandlingTypeString1Default tax handling typecountrygroup
3BalanceLimitDecimal 1Customer's balance limit, two decimal accuracy. 
3DefaultSalesPersonString0...1Name of the default sales person 
3DiscountPercentageNumeric0...1Discount percentage10
3PriceGroupString0...1Price group in which customer is linked 
3FactoringAccountString0...1Customer's factoring account nameFactoring
Attr.NetvisorKeyNumeric1Factoring account's NetvisorID1
3InvoicingLanguage
String0...1Customer's invoicing languageFI
Attr. typeString
1Always ISO-3166

3EUStandardFinvoiceNumeric0...1E-invoice that complies w/ EU standard. 1= Yes, 0 = No.
1
3CustomerDimensionsAggr.0...1

4DimensionAggr.0...n

5DimensionNameString1Customer specific dimension headerAnimals
Attr.NetvisorKeyString1Dimension header Netvisor ID4
5DimensionItemString1Customer specific dimension nameCats
Attr.NetvisorKeyString1Dimension Netvisor ID117
2AdditionalInformationAggr.0...1

3ReceivablesManagement
Aggr.1Customer's invoicing details
4TurnoverDays
Numeric1The turnover days for customer's invoices42
4TurnoverDeviation
Numeric1The turnover deviation for customer's invoices28


Did you find it helpful? Yes No

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