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:

ParametriIlmentymätEsimerkkiKuvaus
method1addadd tai edit
id0...1123Asiakkaan 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):

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
rootrootAggregaatti1  
1customerAggregaatti1  
2customerbaseinformationAggregaatti1  
3internalidentifierMerkkijono, max. 500...1AsiakaskoodiMM123
Attr.typeMerkkijono0...1automatic (mikäli annetaan ja asiakaskoodi jätetään tyhjäksi, käytetään automaattisesti seuraavaa vapaata asiakasnumeroa)automatic
externalidentifierMerkkijono0...1 Y-tunnus tai henkilöasiakkaan henkilötunnus1967543-8
3organizationunitnumberNumero,
max. 17
0...1OVT-tunnus (Vastaanottajan OVT-tunnus, jos tieto poikkeaa yrityksen y-tunnuksesta)*0037AAAAAAAABBBBB
nameMerkkijono, max. 2500...1Asiakkaan nimiMatti Meikäläinen
nameextensionMerkkijono, max. 2500...1Asiakkaan nimen jatkeToimitusjohtaja
streetaddressMerkkijono, max. 800...1KatuosoitePajukuja 1
additionaladdresslineMerkkijono, max. 800...1Osoitteen jatko 
cityMerkkijono, max. 800...1PostitoimipaikkaLappeenranta
postnumberMerkkijono, max. 500...1Postinumero53100
countryMerkkijono0...1 Maatieto (jos ei anneta, tulee oletuksena Suomi)FI
Attr.typeMerkkijono0...1 Maatiedon esitystapaISO-3166
customergroupnameMerkkijono, max. 500...1Asiakasryhmän nimi, asiakas liitetään ryhmään nimen perusteella Jos ryhmää ei ole olemassa, sellainen luodaan.Alennusasiakkaat
phonenumberMerkkijono, max. 800...1Puhelinnumero040 123456
faxnumberMerkkijono, max. 800...1Fax-numero05 123456
emailMerkkijono, max. 2000...1Sähköpostiosoitematti.meikalainen@firma.fi
3homepageuriMerkkijono, max. 800...1www-osoitewww.firma.fi
3isactiveNumero0...10 tai 1, merkitsee onko asiakas aktiivinen. 1
3isprivatecustomerNumero0...10 tai 1, merkitsee onko asiakas henkilöasiakas (1=henkilöasiakas). 0
3emailinvoicingaddressMerkkijono, max. 5000...1Sähköpostilaskutusosoite, pitää olla validi sähköpostiosoite. Voidaan antaa listana ; eroteltuna
matti.meikalainen@firma.fi
2customerfinvoicedetailsAggregaatti0...1  
3finvoiceaddressMerkkijono,
max. 50
1Verkkolaskuosoite, ei voida tuoda ilman verkkolaskuoperaattoritietoaFI109700021497
3finvoiceroutercodeMerkkijono,
max. 50
1Verkkolaskuoperaattorin operaattoritunnus, sallitut operaattorit. Ei voida tuoda ilman verkkolaskuosoitetta.
NDEAFIHH
2customerdeliverydetailsAggregaatti0...1  
3deliverynameMerkkijono, max. 2500...1Toimitusosoitteen nimitietoMaija Mehiläinen
3deliverystreetaddressMerkkijono, max. 800...1ToimitusosoitePajukuja 2
3deliverycityMerkkijono, max. 800...1Toimitusosoitteen postitoimipaikkaLappeenranta
3deliverypostnumberMerkkijono, max. 500...1Toimitusosoitten postinumero53100
3deliverycountryMerkkijono0...1Toimitusosoitteen maatietoFI
Attr.typeMerkkijono0...1Maatiedon esitystapa, aina ISO-3166ISO-3166
2customercontactdetailsAggregaatti0...1  
3contactnameMerkkijono0...1Ei visualisoituna käyttöliittymässä, älä käytä 
3contactpersonMerkkijono, max. 800...1Yhteyshenkilön nimi, tieto viedään käyttöliittymän Sukunimi kenttään
Matti Meikäläinen
3contactpersonemailMerkkijono, max. 2000...1Yhteyshenkilön sähköpostimatti.meikäläinen@firma.fi
3contactpersonphoneMerkkijono, max. 800...1Yhteyshenkilön puhelinnro040 987 254
2customeradditionalinformationAggregaatti0...1  
3commentMerkkijono, max. 2500
0...1Kommentti asiakasrekisteriin 
3customeragreementIdentifierMerkkijono, max. 350...1Sopimustunnus 
3customerreferencenumberMerkkijono0...1Viitenumero tarkisteineen oikeassa muodossa1070
3usecreditorreferencenumber
Numeerinen0..1Käytä RF-viitettä laskutuksessa,
1=päällä 0=pois päältä
1
3useorderreferencenumber
Numeerinen0...1
Käytä tilauksen viitenumeroa laskutuksessa,
1=päällä 0=pois päältä
1
3invoicinglanguageMerkkijono0...1Asiakkaan laskutuskieli, FI, EN tai SE. Mikäli tätä tietoa ei anneta sanomalla, tulee Laskun kieli -kenttään oletuksena SuomiFI
Attr.typeMerkkijonoAina ISO-3166ISO-3166
3invoiceprintchannelformatNumeerinen0...1Laskun tulostusmuoto
1 = Lasku + tilisiirto
2 = Lasku
1
Attr.typeMerkkijono1Aina netvisornetvisor
3yourdefaultreferenceMerkkijono, max. 200
0...1Oletusviitteenne 
3defaulttextbeforeinvoicelinesMerkkijono, max. 500
0...1Oletusteksti ennen laskurivejä 
3defaulttextafterinvoicelinesMerkkijono, max. 500
0...1Oletusteksti jälkeen laskurivien 
3defaultpaymenttermMerkkijono0...1Oletusmaksuehto14 päivää netto
Attr.typeMerkkijono1Maksuehdon tyyppi, netvisor (id) tai customer (nimi)customer
3defaultsecondname
Merkkijono0...1OletusaputoiminimiAputoiminimi
Atrr.typeMerkkijono1Oletusaputoiminimen tyyppi, netvisor (id) tai customer (nimi)
customer
3paymentinterest
Numeerinen0...1Viivästyskorkoprosentti

Mikäli annetaan desimaalilukuna, tulee desimaalierottimena käyttää pilkkua.
5
3balancelimitNumeerinen0...1Tiliraja5000
3receivablesmanagementautomationrule
Merkkijono0...1Muistutusten automaatisääntöHenkilöasiakkaat
Attr.typeMerkkijono1Muistutusten automaatiosäännön tyyppi netvisor (id) tai customer (nimi)customer
3FactoringAccountMerkkijono0...1Asiakkaalla käytettävä Factoring-tiliFactoring-tili
Attr.typeMerkkijono1Factoring-tilin tyyppi netvisor (id) tai customer (nimi)customer
3taxhandlingtypeMerkkijono0...1
Asiakkaan verotuskäsittely, sallitut arvot countrygroup, forcedomestic, notaxhandling ja domesticconstructionservicecountrygroup
3eustandardfinvoiceNumeerinen0...1Käytetäänkö EU-standardin mukaista verkkolaskua. 1 = kyllä, 0 = ei.
1
3defaultsalespersonAggregaatti0...1  
4salespersonidMerkkijono 0...1Oletusmyyjän tunnus 
Attr.typeMerkkijono1Tunnuksen tyyppi, aina netvisornetvisor
2customerdimensiondetailsAggregaatti0...1

3dimensionAggregaatti1...n

4dimensionnameMerkkijono1OletuslaskentakohdeotsikkoProject
4dimensionitemMerkkijono1OletuslaskentakohdeProject 1


Oliko tästä vastauksesta apua? Kyllä Ei

Send feedback
Pahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.