```html

Resource: customer.nv

HTTP-method: POST

Used to add a new customer or update an existing one. Fetching the customer list or complete customer details is done with different requests.

If electronic invoicing details are provided (customerfinvoicedetails), the correctness of the electronic invoicing address is not separately checked. However, the electronic invoice operator must be found in the system.
A list of allowed electronic invoice operators can be found here.

Parameters used in the call:

Parameter Occurrences Example Description
method 1 add add or edit
id 0...1 123 Customer's NetvisorKey
Mandatory when editing customer details

If the method is not provided or the customer to be updated is not found in the system, an INVALID_DATA error with an explanation is returned. The id of the customer to be updated can be obtained by first querying the customer list.
When updating a customer, only the details to be updated are written in the XML message. Do not write data that you do not want to update into the material: otherwise, the interface will update them to empty.

The salespersonid can be obtained using the Salesperson List retrieval.

*In the organizationunitnumber element (receiver's OVT identifier, if the information differs from the company's business ID), you can include some customer-specific information that needs to be conveyed to the recipient with the electronic invoice data, such as a factory number or other unchanging information required by the recipient. This field's information is mapped to the BuyerOrganisationUnitNumber tag in the Finvoice data. Do not place the customer's electronic invoicing address in this field. The Organizationunitnumber element has a validation which requires that the OVT identifier introduced in the element should be in the following format: 12 to 17 digits, and its typical format is 0037AAAAAAAABBBBB where: - 0037 is the Finnish Tax Administration code according to ISO standard 6523 (International Code Designator, ICD) - AAAAAAAA is the business ID including the check digit but without the hyphen - BBBBB is the identifier of the organizational part; not mandatory, numeric, up to five digits, aligned to the left edge of the field.

The data to import is sent with the query as an XML with the following structure (POST-data):

Level Element Format Occurrences Description Example
root root Aggregate 1    
1 customer Aggregate 1    
2 customerbaseinformation Aggregate 1    
3 internalidentifier String, max. 50 0...1 Customer code MM123
Attr. type String 0...1 automatic (if given and customer code is left empty, the next free customer number is used automatically) automatic
externalidentifier String 0...1  Business ID or private customer's social security number 1967543-8
3 organizationunitnumber Number,
max. 17
0...1 OVT identifier (Receiver's OVT identifier, if the information differs from the company's business ID)* 0037AAAAAAAABBBBB
name String, max. 250 0...1 Customer's name Matti Meikäläinen
nameextension String, max. 250 0...1 Extension for name Toimitusjohtaja
streetaddress String, max. 80 0...1 Street address Pajukuja 1
additionaladdressline String, max. 80 0...1 Additional address line  
city String, max. 80 0...1 Post office Lappeenranta
postnumber String, max. 50 0...1 Post number 53100
country String 0...1  Country code (if not provided, Finland is the default) FI
Attr. type String 0...1  Country code format ISO-3166
customergroupname String, max. 50 0...1 Customer group name, customer is linked to the group by name. If the group does not exist, it is created. Alennusasiakkaat
phonenumber String, max. 80 0...1 Phone number 040 123456
faxnumber String, max. 80 0...1 Fax number 05 123456
email String, max. 200 0...1 Email address matti.meikalainen@firma.fi
3 homepageuri String, max. 80 0...1 Website address www.firma.fi
3 isactive Number 0...1 0 or 1, indicates whether the customer is active.  1
3 isprivatecustomer Number 0...1 0 or 1, indicates whether the customer is a private customer (1=private customer).  0
3 emailinvoicingaddress String, max. 500 0...1 Email invoicing address, must be a valid email address. Can be provided as a list separated by ;
matti.meikalainen@firma.fi
2 customerfinvoicedetails Aggregate 0...1    
3 finvoiceaddress String,
max. 50
1 Electronic invoice address, cannot be provided without electronic invoice operator information FI109700021497
3 finvoiceroutercode String,
max. 50
1 Electronic invoice operator code, allowed operators. Cannot be provided without electronic invoice address.
NDEAFIHH
2 customerdeliverydetails Aggregate 0...1    
3 deliveryname String, max. 250 0...1 Delivery address name Maija Mehiläinen
3 deliverystreetaddress String, max. 80 0...1 Delivery street address Pajukuja 2
3 deliverycity String, max. 80 0...1 Delivery post office Lappeenranta
3 deliverypostnumber String, max. 50 0...1 Delivery post number 53100
3 deliverycountry String 0...1 Delivery country code FI
Attr. type String 0...1 Country code format, always ISO-3166 ISO-3166
2 customercontactdetails Aggregate 0...1    
3 contactname String 0...1 Not visualized in the interface, do not use  
3 contactperson String, max. 80 0...1 Contact person's name, information is transferred to the interface's Last Name field
Matti Meikäläinen
3 contactpersonemail String, max. 200 0...1 Contact person's email matti.meikäläinen@firma.fi
3 contactpersonphone String, max. 80 0...1 Contact person's phone number 040 987 254
2 customeradditionalinformation Aggregate 0...1    
3 comment String, max. 2500
0...1 Comment for the customer register  
3 customeragreementIdentifier String, max. 35 0...1 Contract ID  
3 customerreferencenumber String 0...1 Reference number with check digit in correct format 1070
3 usecreditorreferencenumber
Numeric 0..1 Use RF reference for invoicing,
1=on 0=off
1
3 useorderreferencenumber
Numeric 0...1
Use order reference number for invoicing,
1=on 0=off
1
3 invoicinglanguage String 0...1 Customer's invoicing language, FI, EN, or SE. If this information is not provided in the message, the default language for the invoice is Finnish FI
Attr. type String Always ISO-3166 ISO-3166
3 invoiceprintchannelformat Numeric 0...1 Invoice print format
1 = Invoice + bank transfer
2 = Invoice
1
Attr. type String 1 Always netvisor netvisor
3 yourdefaultreference String, max. 200
0...1 Your default reference  
3 defaulttextbeforeinvoicelines String, max. 500
0...1 Default text before invoice lines  
3 defaulttextafterinvoicelines String, max. 500
0...1 Default text after invoice lines  
3 defaultpaymentterm String 0...1 Default payment term 14 days net
Attr. type String 1 Payment term type, netvisor (id) or customer (name) customer
3 defaultsecondname
String 0...1 Default auxiliary business name Auxiliary business name
Attr. type String 1 Default auxiliary business name type, netvisor (id) or customer (name)
customer
3 paymentinterest
Numeric 0...1 Penalty interest percentage

If given as a decimal number, a comma should be used as the decimal separator.
5
3 balancelimit Numeric 0...1 Account limit 5000
3 receivablesmanagementautomationrule
String 0...1 Automatic rule for reminders Private customers
Attr. type String 1 Automatic rule type for reminders netvisor (id) or customer (name) customer
3 FactoringAccount String 0...1 Factoring account used by the customer Factoring account
Attr. type String 1 Factoring account type netvisor (id) or customer (name) customer
3 taxhandlingtype String 0...1
Customer tax handling type, valid values are countrygroup, forcedomestic, notaxhandling and domesticconstructionservice countrygroup
3 eustandardfinvoice Numeric 0...1 Use EU standard compliant e-invoice. 1 = yes, 0 = no.
1
3 defaultsalesperson Aggregate 0...1    
4 salespersonid String  0...1 Default salesperson's id  
Attr. type String 1 Identifier type, always netvisor netvisor
2 customerdimensiondetails Aggregate 0...1

3 dimension Aggregate 1...n

4 dimensionname String 1 Default dimension header
If the header is not found, a new one is created
Project
4 dimensionitem String 1 Default dimension
If the dimension is not found, a new one is created
Project 1
```
This article has been translated using an AI-based translation tool.

Did you find it helpful? Yes No

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