Resurssi: customer.nv
HTTP-metodi: POST
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 (customerfinvoicedetails), ei verkkolaskutusosoitteen oikeellisuutta erikseen tarkisteta. Verkkolaskuoperaattorin tulee kuitenkin löytyä järjestelmästä.
Listaus sallituista verkkolaskuoperaattoreista löytyy täältä.
Kutsussa käytettävät parametrit:
Parametri | Ilmentymät | Esimerkki | Kuvaus |
method | 1 | add | add tai edit |
id | 0...1 | 123 | Asiakkaan NetvisorKey |
useonlyexistingdimensions | 0...1 | 1 | Estää uusien laskentakohdeotsikkojen ja laskentakohteiden automaattisen luonnin. Palauttaa virheen, jos annettua laskentakohdetta ei ole olemassa. |
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.
*Elemetissä organizationunitnumber (vastaanottajan OVT-tunnus, jos tieto poikkeaa yrityksen y-tunnuksesta) kenttään voi laittaa jonkun asiakaskohtaisen tiedon, joka pitää välittyä verkkolaskuaineistolla vastaanottajalle. Esim. tehdasnumero tms. muuttumaton tieto, jonka vastaanottaja vaatii. Tämän kentän tieto menee finvoice-aineistolla tagiin BuyerOrganisationUnitNumber. Kenttään ei pidä laittaa asiakkaan verkkolaskuosoitetta. Organizationunitnumber-elementissä on validointi mikä tarkoittaa että elementissä tuotavan ovt-tunnuksen tulisi olla seuraavanlaista muotoa:12..17 numeroa ja sen tavanomainen muoto on 0037AAAAAAAABBBBB jossa:- 0037 on ISO-standardin 6523 mukainen Suomen verohallinnon koodi (International Code Designator, ICD)- AAAAAAAA on Y-tunnus tarkisteineen mutta ilman väliviivaa- BBBBB on organisaation osan tunnus; ei pakollinen, numeerinen, enintään viisi numeroa, tasataan kentän vasempaan reunaan.
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, | 0...1 | OVT-tunnus (Vastaanottajan OVT-tunnus, jos tieto poikkeaa yrityksen y-tunnuksesta)* | 0037AAAAAAAABBBBB |
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 | ||
3 | homepageuri | Merkkijono, max. 80 | 0...1 | www-osoite | |
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 | |
2 | customerfinvoicedetails | Aggregaatti | 0...1 |
|
|
3 | finvoiceaddress | Merkkijono, | 1 | Verkkolaskuosoite, ei voida tuoda ilman verkkolaskuoperaattoritietoa | FI109700021497 |
3 | finvoiceroutercode | Merkkijono, | 1 | Verkkolaskuoperaattorin operaattoritunnus, sallitut operaattorit. Ei voida tuoda ilman verkkolaskuosoitetta. | NDEAFIHH |
2 | customerdeliverydetails | Aggregaatti | 0...1 | Luo Netvisorin asiakaskortille toimipaikan |
|
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ä[email protected] |
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 | usecreditorreferencenumber | Numeerinen | 0..1 | Käytä RF-viitettä laskutuksessa, | 1 |
3 | useorderreferencenumber | Numeerinen | 0...1 | Käytä tilauksen viitenumeroa laskutuksessa, | 1 |
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 | Aina ISO-3166 | ISO-3166 | |
3 | invoiceprintchannelformat | Numeerinen | 0...1 | Laskun tulostusmuoto | 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 | denyinvoicecollection | Numeerinen | 0...1 | Asiakaskohtainen perintäkielto, arvot 0 ja 1. Arvo 1 asettaa asiakaskohtaisen perintäkiellon. | 1 |
3 | denydelivery | Numeerinen | 0...1 | Asiakaskohtainen toimituskielto, arvot 0 ja 1. Arvo 1 asettaa asiakaskohtaisen toimituskiellon. | 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 |
4 | dimensionitemcode | Merkkijono | 0...1 | Laskentakohteen koodi | DIMC-001 |
4 | dimensionitemname | Merkkijono | 0...1 | Laskentakohteen nimi | Item Name 1 |