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

KeyDatatypeRequiredDescription
keywordstringFilters 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.
changedsincenullFilters result to contain only customers having change after given date, date in format YYYY-MM-DDTHH:mm:ss
customercodelistnullFilters 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

KeyDatatypeRequiredDescription
Content-Typestring
User-Agentstring
X-Netvisor-Authentication-PartnerIdstringEnvironmentin muuttuja
X-Netvisor-Authentication-CustomerIdstringEnvironmentin muuttuja
X-Netvisor-Interface-Languagestring
X-Netvisor-Authentication-TimestampstringMuodostetaan Pre-request Scriptissä, nousee sieltä Environment muuttujaksi
X-Netvisor-Organisation-IDstringY-tunnus annetaan Pre-request Scriptissä, nousee sieltä Environment muuttujaksi
X-Netvisor-Authentication-SenderstringCollectionin muuttuja
X-Netvisor-Authentication-TransactionIdstringMuodostetaan Pre-request Scriptissä, nousee sieltä Environment muuttujaksi
X-Netvisor-Authentication-MACHashCalculationAlgorithmstring
X-Netvisor-Authentication-MACstringMuodostetaan Pre-request Scriptissä, nousee sieltä Environment muuttujaksi