Asiakasrekisterin käsittelyn toiminnot jakautuvat seuraaviin toimintoihin:
Integraatio | HTTP-metodi | Resurssi | DTD | Skeema | Esimerkki |
Asiakaslistan nouto | GET | customerlist.nv | Lataa | ||
Asiakastietojen nouto | GET | getcustomer.nv | Lataa | ||
Asiakastietojen tuonti | POST | customer.nv | Lataa | Lataa | |
Asiakkaan poisto | GET | deletecustomer.nv | |||
Asiakkaan toimipaikan tuonti | POST | office.nv | Lataa | Lataa | |
Asiakkaan yhteyshenkilön tuonti | POST | contactperson.nv | |||
Myyjälistan nouto | GET | salespersonnellist.nv | Lataa |
Huomaathan artikkelin asiakasrekisterin päivityksen suositelluista toimintamalleista.
Asiakaslistan nouto
Resurssi: customerlist.nv
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*. Osumaa etsitään kentistä Nimi, Asiakasnumero, Y-tunnus, CoNimi | |
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ä. |
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 |
Asiakastietojen nouto
Resurssi: getcustomer.nv
Ennen asiakastiedon noutoa Netvisorista on noudettava asiakaslista, josta poimitaan asiakkaan tunniste (NetvisorKey). Tämän avulla voidaan noutaa tarkemmat tiedot. Asiakkaan tiedot voi noutaa joko asiakas kerrallaan tai idlist -parametria käyttämällä maks. 500 asiakkaan tiedot.
Kutsussa käytettävät parametrit:
Parametri | Ilmentymiä | Esimerkki | Kuvaus |
id | 1 | 123 | Haettavan asiakkaan NetvisorKey eli ID |
idlist | 0...1 | 1,2,3 | Palauttaa yhdessä pyynnössä täydet tiedot kaikista halutuista asiakkaista, max. 500 ID:tä |
replyoption | 0...1 | 1 | Palauttaa tiedot asiakkaan myyntisaamisten kiertoajoista |
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
1 | Customer | Aggregaatti | 1 | ||
2 | CustomerBaseInformation | Aggregaatti | 1 | ||
3 | NetvisorKey | Numeerinen | 1 | Asiakkaan Netvisor-tunnus | 1001 |
3 | InternalIdentifier | Merkkijono | 1 | Asiakaskoodi | MM |
3 | ExternalIdentifier | Merkkijono | 1 | Y-tunnus | 1967543-8 |
3 | OrganizationUnitNumber | Numero | 0...1 | OVT-tunnus | 00371967543815 |
3 | CustomerGroupNetvisorKey | Merkkijono | 0...1 | Asiakasryhmän tunniste | |
3 | CustomerGroupName | Merkkijono | 0...1 | Asiakasryhmän nimi | |
3 | Name | Merkkijono | 1 | Asiakkaan nimi | Matti Meikäläinen |
3 | NameExtension | Merkkijono | 1 | Asiakkaan nimen jatke | Toimitusjohtaja |
3 | StreetAddress | Merkkijono | 1 | Katuosoite | Pajukuja 1 |
3 | AdditionalStreetAddress | Merkkijono | 1 | Laskutusosoitteen lisäkenttä | |
3 | City | Merkkijono | 1 | Postitoimipaikka | Lappeenranta |
3 | PostNumber | Merkkijono | 1 | Postinumero | 53100 |
3 | Country | Merkkijono | 0...1 | Maatieto ISO-3166 muodossa | FI |
Attr. | Type | Merkkijono | 0...1 | Maatiedon esitystapa, aina ISO-3166 | ISO-3166 |
3 | PhoneNumber | Merkkijono | 1 | Puhelinnumero | 040 123 456 |
3 | FaxNumber | Merkkijono | 1 | Fax-numero | 05 123 456 |
3 | Merkkijono | 1 | Sähköpostiosoite | matti.meikalainen@firma.fi | |
3 | EmailInvoicingAddress | Merkkijono | 1 | Sähköpostilaskutusosoite | matti.meikalainen@firma.fi |
3 | HomePageUri | Merkkijono | 1 | www-osoite | www.firma.fi |
3 | IsActive | Numero | 1 | 0 tai 1 riippuen siitä onko asiakas aktiivinen | 1 |
3 | IsPrivateCustomer | Numero | 1 | 1 jos on henkilöasiakas, 0 jos ei ole henkilöasiakas | 1 |
2 | CustomerFinvoiceDetails | Aggregaatti | 1 | ||
3 | FinvoiceAddress | Merkkijono | 1 | Verkkolaskuosoite | FI10970021497 |
3 | FinvoiceRouterCode | Merkkijono | 1 | Verkkolaskuoperaattori | NDEAFIHH |
2 | CustomerDeliveryDetails | Aggregaatti | 1 | Asiakkaan oletustoimipaikka | |
3 | DeliveryName | Merkkijono | 1 | Toimituksen nimi | |
3 | DeliveryStreetAddress | Merkkijono | 1 | Toimitusosoite | |
3 | DeliveryCity | Merkkijono | 1 | Postitoimipaikka | |
3 | DeliveryPostNumber | Merkkijono | 1 | Postinumero | |
3 | DeliveryCountry | Merkkijono | 0...1 | Maatieto | |
Attr. | type | Merkkijono | 0...1 | Maatiedon esitystapa, aina ISO-3166 | ISO-3166 |
2 | CustomerContactDetails | Aggregaatti | 1 | ||
3 | ContactPerson | Merkkijono | 1 | Oletusyhteyshenkilön nimi | |
3 | ContactPersonEmail | Merkkijono | 1 | Oletusyhteyshenkilön sähköposti | |
3 | ContactPersonPhone | Merkkijono | 1 | Oletusyhteyshenkilön puhelinnumero | |
2 | CustomerContactPersons | Aggregaatti | 0..1 | ||
3 | CustomerContactPerson | Aggregaatti | 1 | ||
4 | ContactPersonID | Numeerinen | 1 | Yhteyshenkilön NetvisorID | 1006 |
4 | ContactPersonFirstName | Merkkijono | 1 | Yhteyshenkilön etunimi | Eric |
4 | ContactPersonLastName | Merkkijono | 1 | Yhteyshenkilön sukunimi | Example |
4 | ContactPersonPhoneNumber | Numeerinen | 1 | Yhteyshenkilön puhelinnumero | 0501234567 |
4 | ContactPersonEmail | Merkkijono | 1 | Yhteyshenkilön sähköpostiosoite | eric.example@firma.fi |
4 | ContactPersonOfficeNetvisorKey | Numeerinen | 1 | Yhteyshenkilön toimipaikan Netvisor-id | 2 |
2 | CustomerOfficeDetails | Aggregaatti | 0...n | Asiakkaan toimipaikan tiedot | |
3 | OfficeNetvisorKey | Numeerinen | 1 | Toimipaikan Netvisor-tunnus | 10 |
3 | OfficeName | Merkkijono | 1 | Toimipaikan nimi | Helsingin toimisto |
3 | OfficePhoneNumber | Merkkijono | 1 | Toimipaikan puhelinnumero | 040 312 654 |
3 | OfficeTelefaxNumber | Merkkijono | 1 | Toimipaikan faksi | 05 321 654 |
3 | OfficeIdentifier | Merkkijono | 1 | Toimipaikan tunnus | toimipaikkatunnus |
3 | OfficeContactAddress | Aggregaatti | 1 | Toimipaikan postiosoitetiedot | |
4 | StreetAddress | Merkkijono | 0...1 | Katuosoite | Keskuskatu 1 |
4 | PostNumber | Merkkijono | 0...1 | Postinumero | 00100 |
4 | City | Merkkijono | 0...1 | Kaupunki | Helsinki |
4 | Country | Merkkijono | 0...1 | Maa | Suomi |
3 | OfficeVisitAddress | Aggregaatti | 1 | Toimipaikan käyntiosoitteen tiedot | |
4 | StreetAddress | Merkkijono | 0...1 | Katuosoite | Keskuskatu 1 |
4 | PostNumber | Merkkijono | 0...1 | Postinumero | 00100 |
4 | City | Merkkijono | 0...1 | Kaupunki | Helsinki |
4 | Country | Merkkijono | 0...1 | Maa | Suomi |
3 | OfficeFinvoiceDetails | Aggregaatti | 1 | Toimipaikan verkkolaskutiedot | |
4 | FinvoiceAddress | Merkkijono | 0...1 | Verkkolaskuosoite (IBAN tai OVT) | 003716264123 |
4 | FinvoiceRouterCode | Merkkijono | 0...1 | Verkkolaskuoperaattori | 003721291126 |
2 | CustomerAdditionalInformation | Aggregaatti | 1 | ||
3 | Comment | Merkkijono | 1 | Kommenttiteksti | |
3 | CustomerAgreementIdentifier | Merkkijono | 1 | Sopimustunnus | |
3 | ReferenceNumber | Merkkijono | 1 | Vakioviite | |
3 | UseCreditorReferenceNumber | Numeerinen | 1 | Käytetäänkö RF-viitettä laskutuksessa. 1 tai 0 | 1 |
3 | YourDefaultReference | Merkkijono | 1 | Oletusviitteenne | |
3 | DefaultTextBeforeInvoiceLines | Merkkijono | 1 | Oletusteksti ennen laskurivejä | |
3 | DefaultTextAfterInvoiceLines | Merkkijono | 1 | Oletusteksti jälkeen laskurivien | |
3 | DefaultPaymentTerm | Merkkijono | 1 | Oletusmaksuehto | 14 päivää netto |
Attr. | NetvisorKey | Merkkijono | 1 | NetvisorKey (ID) | 2 |
3 | TaxHandlingType | Merkkijono | 1 | Oletusverotuskäsittely | Asiakkaan laskutusmaaryhmän mukainen käsittely |
3 | BalanceLimit | Desimaaliluku | 1 | Asiakkaan tiliraja, kahden desimaalin tarkkuudella. | |
3 | DefaultSalesPerson | Merkkijono | 0...1 | Oletusmyyjän nimi | |
3 | DiscountPercentage | Numero | 0...1 | Alennusprosentti | 10 |
3 | PriceGroup | Merkkijono | 0...1 | Hintaryhmän nimi johon asiakas on linkitetty | |
3 | FactoringAccount | Merkkijono | 0...1 | Asiakkaan factoring-tilin nimi | Factoring |
Attr. | NetvisorKey | Merkkijono | 1 | Factoring-tilin NetvisorID | 1 |
3 | InvoicingLanguage | Merkkijono | 0...1 | Asiakkaan laskutuskieli | FI |
Attr. | type | Merkkijono | 1 | Maatiedon esitystapa, aina ISO-3166 | ISO-3166 |
3 | EUStandardFinvoice | Numero | 0...1 | EU-standardin mukainen verkkolasku, 1=kyllä, 0=ei | 1 |
3 | CustomerDimensions | Aggregaatti | 0...1 | ||
4 | Dimension | Aggregaatti | 0...n | ||
5 | DimensionName | Merkkijono | 1 | Asiakkaan laskentakohteen otsikko | Eläimet |
Attr. | NetvisorKey | Merkkijono | 1 | Laskentakohteen otsikon Netvisor ID | 4 |
5 | DimensionItem | Merkkijono | 1 | Asiakkaan laskentakohde | Kissat |
Attr. | NetvisorKey | Merkkijono | 1 | Laskentakohteen Netvisor ID | 117 |
2 | AdditionalInformation | Aggregaatti | 0...1 | ||
3 | ReceivablesManagement | Aggregaatti | 1 | Myyntisaatavien kiertoajat | |
4 | TurnoverDays | Merkkijono | 1 | Keskimääräinen maksuaika | 42 |
4 | TurnoverDeviation | Merkkijono | 1 | Maksupäivä suhteessa eräpäivään | 28 |
Asiakastietojen tuonti
Resurssi: customer.nv
Käytetään uuden asiakkaan lisäämiseen tai vanhan päivittämiseen. Asiakaslistan tai asiakkaan täydellisten tietojen haku tapahtuvat eri pyynnöillä.
Jos verkkolaskutustiedot annetaan, ei verkkolaskutusosoitteen oikeellisuutta erikseen tarkisteta. Verkkolaskuoperaattorin tulee kuitenkin löytyä järjestelmästä.
Alla lista Netvisorin sallimista verkkolaskuoperaattoreista ja operaattoritunnuksista:
Verkkolaskuoperaattori | Tunnus |
Aktia | HELSFIHH |
Ålandsbanken | AABAFI22 |
Apix Messaging Oy | 003723327487 |
Apix Messaging Oy (vanha tunnus) | 00372332748700001 |
Basware Oyj | BAWCFI22 |
CGI Suomi (ent. Logica) | 003703575029 |
Crediflow Ab | CREDIFLOW |
Danske Bank | DABAFIHH |
DNB Bank ASA, Finland Branch | DNBAFIHX |
Handelsbanken | HANDFIHH |
InExchange Factorum AB | INEXCHANGE |
InExchange Factorum AB(vanhatunnus) | SE556700997101 |
Lexmark Expert Systems AAB | (EXPSYS) |
Open Text Oy | 003708599126 |
Maventa | 003721291126 |
Netbox Finland Oy | 003726044706 |
Nordea | NDEAFIHH |
Notebeat Oy | 003717203971 |
OpusCapita (vanha tunnus 31.12.2018 saakka) | 003710948874 |
OpusCapita Solutions Oy | E204503 |
Osuuspankki | OKOYFIHH |
Pagero | 003723609900 |
PEPPOL | PEPPOL |
POP Pankki | POPFFI22 |
PostNord Strålfors Oy | 003701150617 |
Ropo Capital | 003714377140 |
Säästöpankki | ITELFIHH |
S-Pankki/LähiTapiola | SBANFIHH |
Sproom ApS | SPROOM |
Telia/CGI Finland Oyj | 003703575029 |
Tieto Oyj | 003701011385 |
Kutsussa käytettävät parametrit:
Parametri | Ilmentymät | Esimerkki | Kuvaus |
method | 1 | Add | Add tai Edit |
id | 0...1 | 123 | Asiakkaan NetvisorKey Pakollinen, kun asiakkaan tietoja muokataan |
Mikäli metodia ei ole annettu tai päivitettävää asiakasta ei löydy järjestelmästä, palautetaan INVALID_DATA –virhe selitteineen. Päivitettävän asiakkaan id:n saa tietoon kysymällä ensin asiakaslistaa.
Asiakkaan päivityksessä XML-sanomaan kirjoitetaan vain päivitettävät tiedot. Aineistoon ei tule kirjoittaa tietoja, joita ei haluta päivittää: muuten rajapinta päivittää ne tyhjäksi.
salespersonid:n saa käyttämällä Myyjälistan noutoa.
Tuotavat tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena xml:nä (POST-data):
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
root | root | Aggregaatti | 1 | ||
1 | customer | Aggregaatti | 1 | ||
2 | customerbaseinformation | Aggregaatti | 1 | ||
3 | internalidentifier | Merkkijono, max. 50 | 0...1 | Asiakaskoodi | MM123 |
Attr. | type | Merkkijono | 0...1 | automatic (mikäli annetaan ja asiakaskoodi jätetään tyhjäksi, käytetään automaattisesti seuraavaa vapaata asiakasnumeroa) | automatic |
3 | externalidentifier | Merkkijono | 0...1 | Y-tunnus tai henkilöasiakkaan henkilötunnus | 1967543-8 |
3 | organizationunitnumber | Numero, max. 17 | 0...1 | OVT-tunnus (Vastaanottajan OVT-tunnus, jos tieto poikkeaa yrityksen y-tunnuksesta) | 00371967543815 |
3 | name | Merkkijono, max. 250 | 0...1 | Asiakkaan nimi | Matti Meikäläinen |
3 | nameextension | Merkkijono, max. 250 | 0...1 | Asiakkaan nimen jatke | Toimitusjohtaja |
3 | streetaddress | Merkkijono, max. 80 | 0...1 | Katuosoite | Pajukuja 1 |
3 | additionaladdressline | Merkkijono, max. 80 | 0...1 | Osoitteen jatko | |
3 | city | Merkkijono, max. 80 | 0...1 | Postitoimipaikka | Lappeenranta |
3 | postnumber | Merkkijono, max. 50 | 0...1 | Postinumero | 53100 |
3 | country | Merkkijono | 0...1 | Maatieto (jos ei anneta, tulee oletuksena Suomi) | FI |
Attr. | type | Merkkijono | 0...1 | Maatiedon esitystapa | ISO-3166 |
3 | customergroupname | Merkkijono, max. 50 | 0...1 | Asiakasryhmän nimi, asiakas liitetään ryhmään nimen perusteella Jos ryhmää ei ole olemassa, sellainen luodaan. | Alennusasiakkaat |
3 | phonenumber | Merkkijono, max. 80 | 0...1 | Puhelinnumero | 040 123456 |
3 | faxnumber | Merkkijono, max. 80 | 0...1 | Fax-numero | 05 123456 |
3 | Merkkijono, max. 200 | 0...1 | Sähköpostiosoite | matti.meikalainen@firma.fi | |
3 | homepageuri | Merkkijono, max. 80 | 0...1 | www-osoite | www.firma.fi |
3 | isactive | Numero | 0...1 | 0 tai 1, merkitsee onko asiakas aktiivinen. | 1 |
3 | isprivatecustomer | Numero | 0...1 | 0 tai 1, merkitsee onko asiakas henkilöasiakas (1=henkilöasiakas). | 0 |
3 | emailinvoicingaddress | Merkkijono, max. 500 | 0...1 | Sähköpostilaskutusosoite, pitää olla validi sähköpostiosoite. Voidaan antaa listana ; eroteltuna | matti.meikalainen@firma.fi |
2 | customerfinvoicedetails | Aggregaatti | 0...1 | ||
3 | finvoiceaddress | Merkkijono, max. 50 | 1 | Verkkolaskuosoite, ei voida tuoda ilman verkkolaskuoperaattoritietoa | FI109700021497 |
3 | finvoiceroutercode | Merkkijono, max. 50 | 1 | Verkkolaskuoperaattorin operaattoritunnus, sallitut operaattorit. Ei voida tuoda ilman verkkolaskuosoitetta. | NDEAFIHH |
2 | customerdeliverydetails | Aggregaatti | 0...1 | ||
3 | deliveryname | Merkkijono, max. 250 | 0...1 | Toimitusosoitteen nimitieto | Maija Mehiläinen |
3 | deliverystreetaddress | Merkkijono, max. 80 | 0...1 | Toimitusosoite | Pajukuja 2 |
3 | deliverycity | Merkkijono, max. 80 | 0...1 | Toimitusosoitteen postitoimipaikka | Lappeenranta |
3 | deliverypostnumber | Merkkijono, max. 50 | 0...1 | Toimitusosoitten postinumero | 53100 |
3 | deliverycountry | Merkkijono | 0...1 | Toimitusosoitteen maatieto | FI |
Attr. | type | Merkkijono | 0...1 | Maatiedon esitystapa, aina ISO-3166 | ISO-3166 |
2 | customercontactdetails | Aggregaatti | 0...1 | ||
3 | contactname | Merkkijono | 0...1 | Ei visualisoituna käyttöliittymässä, älä käytä | |
3 | contactperson | Merkkijono, max. 80 | 0...1 | Yhteyshenkilön nimi, tieto viedään käyttöliittymän Sukunimi kenttään | Matti Meikäläinen |
3 | contactpersonemail | Merkkijono, max. 200 | 0...1 | Yhteyshenkilön sähköposti | matti.meikäläinen@firma.fi |
3 | contactpersonphone | Merkkijono, max. 80 | 0...1 | Yhteyshenkilön puhelinnro | 040 987 254 |
2 | customeradditionalinformation | Aggregaatti | 0...1 | ||
3 | comment | Merkkijono, max. 2500 | 0...1 | Kommentti asiakasrekisteriin | |
3 | customeragreementIdentifier | Merkkijono, max. 35 | 0...1 | Sopimustunnus | |
3 | customerreferencenumber | Merkkijono | 0...1 | Viitenumero tarkisteineen oikeassa muodossa | 1070 |
3 | invoicinglanguage | Merkkijono | 0...1 | Asiakkaan laskutuskieli, FI, EN tai SE. Mikäli tätä tietoa ei anneta sanomalla, tulee Laskun kieli -kenttään oletuksena Suomi | FI |
Attr. | type | Merkkijono | 0...1 | Aina ISO-3166 | ISO-3166 |
3 | invoiceprintchannelformat | Numeerinen | 0...1 | Laskun tulostusmuoto 1 = Lasku + tilisiirto 2 = Lasku | 1 |
Attr. | type | Merkkijono | 1 | Aina netvisor | netvisor |
3 | yourdefaultreference | Merkkijono, max. 200 | 0...1 | Oletusviitteenne | |
3 | defaulttextbeforeinvoicelines | Merkkijono, max. 500 | 0...1 | Oletusteksti ennen laskurivejä | |
3 | defaulttextafterinvoicelines | Merkkijono, max. 500 | 0...1 | Oletusteksti jälkeen laskurivien | |
3 | defaultpaymentterm | Merkkijono | 0...1 | Oletusmaksuehto | 14 päivää netto |
Attr. | type | Merkkijono | 1 | Maksuehdon tyyppi, netvisor (id) tai customer (nimi) | customer |
3 | defaultsecondname | Merkkijono | 0...1 | Oletusaputoiminimi | Aputoiminimi |
Atrr. | type | Merkkijono | 1 | Oletusaputoiminimen tyyppi, netvisor (id) tai customer (nimi) | customer |
3 | paymentinterest | Numeerinen | 0...1 | Viivästyskorkoprosentti | 5 |
3 | balancelimit | Numeerinen | 0...1 | Tiliraja | 5000 |
3 | receivablesmanagementautomationrule | Merkkijono | 0...1 | Muistutusten automaatisääntö | Henkilöasiakkaat |
Attr. | type | Merkkijono | 1 | Muistutusten automaatiosäännön tyyppi netvisor (id) tai customer (nimi) | customer |
3 | FactoringAccount | Merkkijono | 0...1 | Asiakkaalla käytettävä Factoring-tili | Factoring-tili |
Attr. | type | Merkkijono | 1 | Factoring-tilin tyyppi netvisor (id) tai customer (nimi) | customer |
3 | taxhandlingtype | Merkkijono | 0...1 | Asiakkaan verotuskäsittely, sallitut arvot countrygroup, forcedomestic, notaxhandling ja domesticconstructionservice | countrygroup |
3 | eustandardfinvoice | Numeerinen | 0...1 | Käytetäänkö EU-standardin mukaista verkkolaskua. 1 = kyllä, 0 = ei. | 1 |
3 | defaultsalesperson | Aggregaatti | 0...1 | ||
4 | salespersonid | Merkkijono | 0...1 | Oletusmyyjän tunnus | |
Attr. | type | Merkkijono | 1 | Tunnuksen tyyppi, aina netvisor | netvisor |
2 | customerdimensiondetails | Aggregaatti | 0...1 | ||
3 | dimension | Aggregaatti | 1...n | ||
4 | dimensionname | Merkkijono | 1 | Oletuslaskentakohdeotsikko | Project |
4 | dimensionitem | Merkkijono | 1 | Oletuslaskentakohde | Project 1 |
Asiakkaan poisto
Resurssi: deletecustomer.nv
Resurssilla voidaan poistaa yksittäinen asiakas Netvisorista. Vastauksena "OK" viesti, jos poisto onnistuu. Jos poisto epäonnistuu, palautetaan virheviestin mukana syyt poiston epäonnistumiselle, esim. "Asiakkaalla on laskuja".
Kutsussa käytettävä parametri:
Parametri | Ilmentymiä | Kuvaus | Esimerkki |
customerid | 1 | Asiakkaan NetvisorKey eli ID | 2 |
Asiakkaan toimipaikan tuonti
Resurssi: office.nv
Asiakkaan toimipaikan tietojen lisääminen ja muokkaus.
Kutsussa käytettävät parametrit:
Parametri | Ilmentymät | Kuvaus | Esimerkki |
method | 1 | Add tai Edit | Add |
customerid | 1 | Asiakkaan Netvisor-tunnus | 123 |
officeid | 0...1 | Toimipaikan Netvisor-tunnus, pakollinen muokatessa olemassaolevaa toimipaikkaa | 1 |
Lisähuomioita:
- Edit-sanomalla voi poistaa tietoja antamalla ko. tagin sisällön tyhjänä.
- Toimipaikan nimi on pakollinen tieto, joten se ei voi koskaan olla tyhjä.
- FinvoiceAddress pitää olla kelvollinen OVT- tai IBAN-tunnus.
- FinvoiceOperator käy samat operaattoritunnukset kuin kaikkialla muuallakin rajapinnassa, kts. lista ylempää.
Tuotavat tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena XML:nä (POST-data):
Taso | Elementti | Muoto | Ilmentymät | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 | ||
1 | office | Aggregaatti | 1 | ||
2 | name | Merkkijono | 1 | Toimipaikan nimi | |
2 | phonenumber | Merkkijono | 0...1 | Toimipaikan puhelinnumero | |
2 | telefaxnumber | Merkkijono | 0...1 | Toimipaikan faksi | |
2 | officeidentifier | Merkkijono | 0...1 | Toimipaikkatunnus | |
2 | emailinvoicingaddress | Merkkijono | 0...1 | Toimipaikan laskutussähköposti | |
2 | officecontactaddress | Aggregaatti | 0...1 | Toimipaikan postiosoitetiedot | |
3 | streetaddress | Merkkijono | 1 | Katuosoite | |
3 | postnumber | Merkkijono | 1 | Postinumero | |
3 | city | Merkkijono | 1 | Kaupunki | |
3 | country | Merkkijono | 1 | Maakoodi | |
Attr. | type | Merkkijono | 1 | Aina ISO-3166 | |
2 | officevisitaddress | Aggregaatti | 0...1 | Toimipaikan käyntiosoitteentiedot | |
3 | streetaddress | Merkkijono | 1 | Katuosoite | |
3 | postnumber | Merkkijono | 1 | Postinumero | |
3 | city | Merkkijono | 1 | Kaupunki | |
3 | country | Merkkijono | 1 | Maakoodi | |
Attr. | type | Merkkijono | 1 | Aina ISO-3166 | |
2 | officefinvoicedetails | Aggregaatti | 0...1 | Toimipaikan verkkolaskutiedot | |
3 | finvoiceaddress | Merkkijono | 1 | Verkkolaskuosoite (IBAN tai OVT) | |
3 | finvoiceroutercode | Merkkijono | 1 | Verkkolaskuoperaattori |
Asiakkaan yhteyshenkilön tuonti
Resurssi: contactperson.nv
Resurssilla voi tuoda asiakaskortille yhteyshenkilöitä.
Tuotavat tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena xml:nä (POST-data):
Taso | Elementti | Muoto | Ilmentymät | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 | ||
1 | contactperson | Aggregaatti | 1 | ||
2 | method | method | 1 | add|edit|delete | |
2 | customeridentifier | Numeerinen | 1 | Asiakkaan netvisorkey | 12 |
Attr. | type | Merkkijono | 1 | netvisor | netvisor |
2 | contactpersonidentifier | Merkkijono | 0...1 | Yhteyshenkilön netvisorkey, tulee antaa edit ja delete sanomilla | 1 |
Attr. | type | Merkkijono | 1 | netvisor | netvisor |
2 | isdefault | Merkkijono | 0...1 | True, asettaa yhteyshenkilön asiakkaan oletukseksi, ei mahdollista oletuksen poistoa | true |
2 | firstname | Merkkijono, max. 100 | 1 | Etunimi | |
2 | lastname | Merkkijono, max. 100 | 1 | Sukunimi | |
2 | language | Merkkijono | 1 | FI|EN|SE | |
Attr. | type | Merkkijono | 1 | Aina ISO-3166 | |
2 | phonenumber | Numeerinen, max. 80 | 0...1 | Puhelinnumero | |
2 | Merkkijono, max. 200 | 0...1 | Sähköpostiosoite | ||
2 | title | Merkkijono, max. 200 | 0...1 | ||
2 | officeidentifier | Merkkijono | 0...1 | Yhteyshenkilön toimipaikan netvisorkey, 0 -arvolla tyhjentää | |
Atrr. | type | Merkkijono | 1 | netvisor | |
2 | positionidentifier | Merkkijono | 0...1 | Yhteyshenkilön aseman netvisorkey, 0-arvolla tyhjentää | |
Attr. | type | Merkkijono | 1 | netvisor | |
2 | contactpersonaddress | Aggregaatti | 1 | ||
3 | streetaddress | Merkkijono, max. 80 | 0...1 | Osoite | |
3 | postnumber | Numeerinen, max. 50 | 0...1 | Postinumero | |
3 | city | Merkkijono, maks. 80 | 0...1 | Kaupunki | |
3 | country | Merkkijono | 0...1 | Maa | |
Attr. | type | Merkkijono | 1 | Aina ISO-3166 |
Myyjälistan nouto
Resurssi: salespersonnellist.nv
Noutaa listan myyjistä.
Vastaus:
Taso | Elementti | Muoto | Ilmentymät | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 | ||
1 | SalesPersonnelList | Aggregaatti | 1 | ||
2 | SalesPerson | Aggregaatti | 0...n | ||
Attr. | NetvisorKey | Merkkijono | 1 | Myyjän netvisor-tunnus | 1 |
3 | FirstName | Merkkijono | 1 | Myyjän etunimi | Matti |
3 | LastName | Merkkijono | 1 | Myyjän sukunimi | Myyntivastaava |
3 | ProvisionPercent | Numero | 1 | Myyjän provisioprosentti | 10 |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedback