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 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.
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, max. 17 | 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 | 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 | usecreditorreferencenumber | Numeerinen | 0..1 | Käytä RF-viitettä laskutuksessa, 1=päällä 0=pois päältä | 1 |
3 | useorderreferencenumber | Numeerinen | 0...1 | Käytä tilauksen viitenumeroa laskutuksessa, 1=päällä 0=pois päältä | 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 = 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 Mikäli annetaan desimaalilukuna, tulee desimaalierottimena käyttää pilkkua. | 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 |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedback