Resurssi: customerlist.nv
HTTP-metodi: GET
Netvisorin asiakaslistan nouto. Asiakaslista sisältää asiakkaiden perustietoja (NetvisorID, nimi, asiakkaan koodi, Y-tunnus yritysasiakkaille, URI tarkempien asiakastietojen hakuun). Tarkemmat asiakastiedot voidaan tämän jälkeen noutaa käyttäen toimintoa Asiakastietojen nouto.
Kutsussa käytettävät parametrit:
Parametri | Ilmentymiä | Kuvaus | Esimerkki |
keyword | 0...1 | Suodattaa listaa annetulla keywordillä. Palauttaa listalle ne asiakkaat, joilta löytyy keyword*. |
|
changedsince | 0...1 | Suodattaa asiakkuudet, joissa muutoksia annetun päivämäärän jälkeen. Päivämäärä muodossa YYYY-MM-DDThh:mm:ss | 2014-09-13 |
customercodelist | 0...1 | Pilkkueroteltu lista asiakaskoodeja, jonka mukaan suodattaa palautettavat asiakkaat. Lista saa sisältää enintään 100 alfanumeerista asiakaskoodia. Huom! Keyword-parametrin voi antaa customercodelist-parametrin kanssa. Tällöin resurssi palauttaa ne asiakkaat, joilla on listalta löytyvä asiakaskoodi JA keyword jossain keywordin etsimässä kentässä. |
|
emailkeyword | 0...1 | Suodattaa listaa asiakkaan sähköpostiosoitteen perusteella, ja palauttaa ne asiakkaat, joihin sähköpostiosoite täsmää |
Jos keyword-parametri on annettu, changedsince jätetään huomioimatta.
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
1 | Customerlist | Aggregaatti | 1 |
|
|
2 | Customer | Aggregaatti | 0...n |
|
|
3 | Netvisorkey | Numero | 1 | Asiakkaan Netvisor tunnus (Netvisor kanta-id) | 123 |
3 | Name | Merkkijono | 1 | Asiakkaan nimi | Asiakas 1 |
3 | Code | Merkkijono | 1 | Asiakkaan koodi | 234 |
3 | OrganisationIdentifier | Merkkijono | 1 | Asiakkaan yritystunnus jos ei kuluttaja-asiakas | 12345678-9 |
3 | CustomerGroupID | Numeerinen | 1 | Asiakasryhmän ID, johon asiakas kuuluu. Voi olla myös tyhjä. | 2 |
3 | CustomerGroupName | Merkkijono | 1 | Asiakasryhmän nimi, johon asiakas kuuluu. Voi myös olla tyhjä. | Asiakasryhmä 1 |
3 | Uri | Merkkijono | 1 | Osoite, josta voidaan hakea asiakkaan yksityiskohdat | /getcustomer.nv?id=123 |