customerlist.nv Get customerlist
GET {{host}}/customerlist.nv?keyword=abc123456675
Get customer list
Retrieve the current list of customers in Netvisor with the resource customerlist.nv. You can use parameters for example keyword, when the search is made by business ID (y-tunnus), customer code, name or co name. Parameter is optional.
If customer already exist in Netvisor, next step is to retrieve list of products.
If the customer is not found, it is created using resource customer.nv.
If customer exist but details are different in Netvisor (for example e-invoice address and operator), edit existing customer using resource customer.nv and use method edit. For editing the Netvisor id of the customer is needed. You got that from the first request customerlist.nv.
<Customer>
<Netvisorkey>1000</Netvisorkey>
<Name>Example Customer</Name>
<Code>101</Code>
<OrganisationIdentifier>1234567-8</OrganisationIdentifier>
<CustomerGroupID>1</CustomerGroupID>
<CustomerGroupName>Customergroup 1</CustomerGroupName>
<Uri>https://isvapi.netvisor.figetcustomer.nv?id=1000</Uri>
</Customer>
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
keyword | string | Filters result list with given keyword. Match is searched from following fields: Name, Customer Code, Organization identifier, CoName. If the keyword parameter is given, changedsince is ignored. | |
changedsince | null | Filters result to contain only customers having change after given date, date in format YYYY-MM-DDTHH:mm:ss | |
customercodelist | null | Filters result with given customercodes. Customercodes should be separated with comma. The list can include maximum of 100 alfanumeric customer codes. | |
Note! Parameter keyword can be used with customercodelist. Filters result with given customercodes AND with given keyword. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
User-Agent | string | ||
X-Netvisor-Authentication-PartnerId | string | Environmentin muuttuja | |
X-Netvisor-Authentication-CustomerId | string | Environmentin muuttuja | |
X-Netvisor-Interface-Language | string | ||
X-Netvisor-Authentication-Timestamp | string | Muodostetaan Pre-request Scriptissä, nousee sieltä Environment muuttujaksi | |
X-Netvisor-Organisation-ID | string | Y-tunnus annetaan Pre-request Scriptissä, nousee sieltä Environment muuttujaksi | |
X-Netvisor-Authentication-Sender | string | Collectionin muuttuja | |
X-Netvisor-Authentication-TransactionId | string | Muodostetaan Pre-request Scriptissä, nousee sieltä Environment muuttujaksi | |
X-Netvisor-Authentication-MACHashCalculationAlgorithm | string | ||
X-Netvisor-Authentication-MAC | string | Muodostetaan Pre-request Scriptissä, nousee sieltä Environment muuttujaksi |