Get customer details getcustomer.nv

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 name	Occurs	Description	Example
id	1	ID of the customer	123
idlist	0...1	Can be used to get the details of several customers with given id. Max. 500 identifiers	1,2,3
replyoption	0...1	Returns customer's invoicing history details.	1

Response:

Level	Element name	Type and length	Occurs	Description	Example
1	Customer	Aggr.	1
2	CustomerBaseInformation	Aggr.	1
3	NetvisorKey	Integer	1	Customer Netvisor key	1001
3	InternalIdentifier	String	1	Customer code	MM
3	ExternalIdentifier	String	1	Organization identifier	1234567-8
3	OrganizationUnitNumber	Integer	0...1	Organization unit number	0037123456715
3	CustomerGroupNetvisorKey	String	0...1	Netvisor identifier of customer group
3	CustomerGroupName	String	0...1	Name of the customer group
3	Name	String	1	Name of the customer	Matti Meikäläinen
3	NameExtension	String	1	Extension for the name of the customer	Toimitusjohtaja
3	StreetAddress	String	1	Customer's street address	Pajukuja 1
3	AdditionalStreetAddress	String	1	Address extension
3	City	String	1	Customer's post office	Lappeenranta
3	PostNumber	String	1	Customer's post number	53100
3	Country	String	0...1	Country code	FI
Attr.	Type	String	0...1	Always ISO-3166	ISO-3166
3	PhoneNumber	String	1	Customer's phone number	040 123 4567
3	FaxNumber	String	1	Customer's fax number	05 123 4567
3	Email	String	1	Customer's E-mail address	matti.meikalainen@firma.fi
3	EmailInvoicingAddress	String	1	E-mail invoice address	matti.meikalainen@firma.fi
3	HomePageUri	String	1	Customer's web site	www.firma.fi
3	IsActive	Numeric	1	0 or 1, is customer active	1
3	IsPrivateCustomer	Numeric	1	0 or 1. Value 1 indicates customer is a private customer	1
2	CustomerFinvoiceDetails	Aggr.	1
3	FinvoiceAddress	String	1	E-invoice address	FI10970021497
3	FinvoiceRouterCode	String	1	E-invoice operator	NDEAFIHH
2	CustomerDeliveryDetails	Aggr.	1	Customer's default office
3	DeliveryName	String	1	Name for the delivery	Matti Meikäläinen
3	DeliveryStreetAddress	String	1	Delivery address	Pajukuja 1
3	DeliveryCity	String	1	Delivery Post office	Lappeenranta
3	DeliveryPostNumber	String	1	Delivery post number	53100
3	DeliveryCountry	String	0...1	Delivery country	FI
Attr.	type	String	0...1	Always ISO-3166	ISO-3166
2	CustomerContactDetails	Aggr.	1
3	ContactPerson	String	1	Default contact person's name
3	ContactPersonEmail	String	1	Default contact person's E-mail address
3	ContactPersonPhone	String	1	Default contact person's Phone number
2	CustomerContactPersons	Aggr.	0...1
3	CustomerContactPerson	Aggr.	1
4	ContactPersonID	Integer	1	Contact person's NetvisorID	1006
4	ContactPersonFirstName	String	1	Contact person's first name	Eric
4	ContactPersonLastName	String	1	Contact person's last name	Example
4	ContactPersonPhoneNumber	Numeric	1	Contact person's phone number	0501234567
4	ContactPersonEmail	String	1	Contact person's E-mail address	eric.example@company.com
4	ContactPersonOfficeNetvisorKey	Numeric	1	Contact person's office NetvisorID	2
2	CustomerOfficeDetails	Aggr.	0...n	Customer offices details
3	OfficeNetvisorKey	Numeric	1	Office NetvisorID	10
3	OfficeName	String	1	Office name	Helsingin toimisto
3	OfficePhoneNumber	String	1	Office phone	040 312 654
3	OfficeTelefaxNumber	String	1	Office fax	05 321 654
3	OfficeIdentifier	String	1	Office identifier	Officeidentifier
3	OfficeContactAddress	Aggr.	1	Office postal address
4	StreetAddress	String	0...1	Street address	Keskuskatu 1
4	PostNumber	String	0...1	Postcode	00100
4	City	String	0...1	City	Helsinki
4	Country	String	0...1	Country	Finland
3	OfficeVisitAddress	Aggr.	1	Visiting address
4	StreetAddress	String	0...1	Street address	Keskuskatu 1
4	PostNumber	String	0...1	Postcode	00100
4	City	String	0...1	City	Helsinki
4	Country	String	0...1	Country	Finland
3	OfficeFinvoiceDetails	Aggr.	1	Office electronic invoicing details
4	FinvoiceAddress	String	0...1	E-invoice address (IBAN or EIA)	003716264123
4	FinvoiceRouterCode	String	0...1	E-invoice operator code	003721291126
2	CustomerAdditionalInformation	Aggr.	1
3	Comment	String	1	Comment text
3	CustomerAgreementIdentifier	String	1	Contract ID
3	ReferenceNumber	String	1	Standard reference
3	UseCreditorReferenceNumber	Numeric	1	Use RF-reference in invoicing. 1 or 0.	1
3	YourDefaultReference	String	1	Your default reference
3	DefaultTextBeforeInvoiceLines	String	1	Default text before invoice rows
3	DefaultTextAfterInvoiceLines	String	1	Default text after invoice rows
3	DefaultPaymentTerm	String	1	Default payment term	14 days net
Attr.	NetvisorKey	String	1	NetvisorKey (ID)	2
3	TaxHandlingType	String	1	Default tax handling type	countrygroup
3	BalanceLimit	Decimal	1	Customer's balance limit, two decimal accuracy.
3	DefaultSalesPerson	String	0...1	Name of the default sales person
3	DiscountPercentage	Numeric	0...1	Discount percentage	10
3	PriceGroup	String	0...1	Price group in which customer is linked
3	FactoringAccount	String	0...1	Customer's factoring account name	Factoring
Attr.	NetvisorKey	Numeric	1	Factoring account's NetvisorID	1
3	InvoicingLanguage	String	0...1	Customer's invoicing language	FI
Attr.	type	String	1	Always ISO-3166
3	EUStandardFinvoice	Numeric	0...1	E-invoice that complies w/ EU standard. 1= Yes, 0 = No.	1
3	CustomerDimensions	Aggr.	0...1
4	Dimension	Aggr.	0...n
5	DimensionName	String	1	Customer specific dimension header	Animals
Attr.	NetvisorKey	String	1	Dimension header Netvisor ID	4
5	DimensionItem	String	1	Customer specific dimension name	Cats
Attr.	NetvisorKey	String	1	Dimension Netvisor ID	117
2	AdditionalInformation	Aggr.	0...1
3	ReceivablesManagement	Aggr.	1	Customer's invoicing details
4	TurnoverDays	Numeric	1	The turnover days for customer's invoices	42
4	TurnoverDeviation	Numeric	1	The turnover deviation for customer's invoices	28

Did you find it helpful? Yes No

Send feedback