Resurs: customer.nv
HTTP-metod: POST
Används för att lägga till en ny kund eller uppdatera en befintlig. Hämtning av kundlistan eller kundens fullständiga information sker med olika förfrågningar.
Om e-faktureringsuppgifter ges (customerfinvoicedetails), kontrolleras inte e-fakturaadressens korrekthet separat. E-fakturaoperatören måste dock finnas i systemet.
En lista över tillåtna e-fakturaoperatörer finns här.
Parametrar som används i anropet:
Parameter | Förekomster | Exempel | Beskrivning |
method | 1 | add | add eller edit |
id | 0...1 | 123 | Kundens NetvisorKey |
useonlyexistingdimensions | 0...1 | 1 | Förhindrar automatisk skapning av nya kostnadsobjektrubriker och kostnadsobjekt. Returnerar ett fel om det angivna kostnadsobjektet inte finns. |
Om metoden inte har angetts eller den kund som ska uppdateras inte finns i systemet, returneras INVALID_DATA-fel med förklaring. Id för den kund som ska uppdateras kan erhållas genom att först fråga kundlistan.
Vid uppdatering av kund skrivs endast den information som ska uppdateras i XML-meddelandet. Materialet ska inte innehålla information som inte ska uppdateras: annars uppdaterar gränssnittet dem till tomma.
salespersonid kan erhållas genom att använda försäljarlistan.
*I elementet organizationunitnumber (mottagarens OVT-kod, om informationen skiljer sig från företagets Fo-nummer) kan man lägga till någon kundspecifik information som måste överföras med e-fakturamaterialet till mottagaren. T.ex. fabriksnummer eller annan oföränderlig information som mottagaren kräver. Denna information går i finvoice-materialet till taggen BuyerOrganisationUnitNumber. Fältet ska inte innehålla kundens e-fakturaadress. I organizationunitnumber-elementet finns en validering som innebär att den OVT-kod som ska föras in i elementet bör ha följande format: 12..17 siffror och dess vanliga format är 0037AAAAAAAABBBBB där:- 0037 är den finska skattemyndighetens kod enligt ISO-standard 6523 (International Code Designator, ICD)- AAAAAAAA är Fo-nummer med kontrollsiffra men utan bindestreck- BBBBB är organisationens delkod; inte obligatorisk, numerisk, högst fem siffror, justeras till fältets vänstra kant.
Den information som ska överföras skickas med anropet som en xml enligt följande beskrivning (POST-data):
Nivå | Element | Format | Förekomster | Beskrivning | Exempel |
root | root | Aggregat | 1 |
|
|
1 | customer | Aggregat | 1 |
|
|
2 | customerbaseinformation | Aggregat | 1 |
|
|
3 | internalidentifier | Sträng, max. 50 | 0...1 | Kundkod | MM123 |
Attr. | type | Sträng | 0...1 | automatic (om det ges och kundkoden lämnas tom, används automatiskt nästa lediga kundnummer) | automatic |
3 | externalidentifier | Sträng | 0...1 | Fo-nummer eller personbeteckning för privatkund | 1967543-8 |
3 | organizationunitnumber | Nummer, | 0...1 | OVT-kod (mottagarens OVT-kod, om informationen skiljer sig från företagets Fo-nummer)* | 0037AAAAAAAABBBBB |
3 | name | Sträng, max. 250 | 0...1 | Kundens namn | Matti Meikäläinen |
3 | nameextension | Sträng, max. 250 | 0...1 | Kundens namnförlängning | Verkställande direktör |
3 | streetaddress | Sträng, max. 80 | 0...1 | Gatuadress | Pajukuja 1 |
3 | additionaladdressline | Sträng, max. 80 | 0...1 | Adressförlängning |
|
3 | city | Sträng, max. 80 | 0...1 | Postanstalt | Lappeenranta |
3 | postnumber | Sträng, max. 50 | 0...1 | Postnummer | 53100 |
3 | country | Sträng | 0...1 | Landsinformation (om det inte ges, är standard Finland) | FI |
Attr. | type | Sträng | 0...1 | Presentation av landsinformation | ISO-3166 |
3 | customergroupname | Sträng, max. 50 | 0...1 | Kundgruppens namn, kunden kopplas till gruppen baserat på namnet. Om gruppen inte finns, skapas en ny. | Rabattkunder |
3 | phonenumber | Sträng, max. 80 | 0...1 | Telefonnummer | 040 123456 |
3 | faxnumber | Sträng, max. 80 | 0...1 | Faxnummer | 05 123456 |
3 | Sträng, max. 200 | 0...1 | E-postadress | ||
3 | homepageuri | Sträng, max. 80 | 0...1 | www-adress | |
3 | isactive | Nummer | 0...1 | 0 eller 1, anger om kunden är aktiv. | 1 |
3 | isprivatecustomer | Nummer | 0...1 | 0 eller 1, anger om kunden är en privatkund (1=privatkund). | 0 |
3 | emailinvoicingaddress | Sträng, max. 500 | 0...1 | E-fakturaadress, måste vara en giltig e-postadress. Kan ges som en lista separerad med ; | |
2 | customerfinvoicedetails | Aggregat | 0...1 |
|
|
3 | finvoiceaddress | Sträng, | 1 | E-fakturaadress, kan inte föras in utan e-fakturaoperatörsinformation | FI109700021497 |
3 | finvoiceroutercode | Sträng, | 1 | E-fakturaoperatörens operatörskod, tillåtna operatörer. Kan inte föras in utan e-fakturaadress. | NDEAFIHH |
2 | customerdeliverydetails | Aggregat | 0...1 | Skapar en plats på kundkortet i Netvisor |
|
3 | deliveryname | Sträng, max. 250 | 0...1 | Namninformation för leveransadress | Maija Mehiläinen |
3 | deliverystreetaddress | Sträng, max. 80 | 0...1 | Leveransadress | Pajukuja 2 |
3 | deliverycity | Sträng, max. 80 | 0...1 | Leveransadressens postanstalt | Lappeenranta |
3 | deliverypostnumber | Sträng, max. 50 | 0...1 | Leveransadressens postnummer | 53100 |
3 | deliverycountry | Sträng | 0...1 | Leveransadressens landsinformation | FI |
Attr. | type | Sträng | 0...1 | Presentation av landsinformation, alltid ISO-3166 | ISO-3166 |
2 | customercontactdetails | Aggregat | 0...1 |
|
|
3 | contactname | Sträng | 0...1 | Ej visualiserad i gränssnittet, använd inte |
|
3 | contactperson | Sträng, max. 80 | 0...1 | Kontaktpersonens namn, informationen förs till gränssnittets Efternamn-fält | Matti Meikäläinen |
3 | contactpersonemail | Sträng, max. 200 | 0...1 | Kontaktpersonens e-post | matti.meikälä[email protected] |
3 | contactpersonphone | Sträng, max. 80 | 0...1 | Kontaktpersonens telefonnummer | 040 987 254 |
2 | customeradditionalinformation | Aggregat | 0...1 |
|
|
3 | comment | Sträng, max. 2500 | 0...1 | Kommentar till kundregistret |
|
3 | customeragreementIdentifier | Sträng, max. 35 | 0...1 | Avtalsidentifierare |
|
3 | customerreferencenumber | Sträng | 0...1 | Referensnummer med kontrollsiffra i rätt format | 1070 |
3 | usecreditorreferencenumber | Numerisk | 0..1 | Använd RF-referens vid fakturering, | 1 |
3 | useorderreferencenumber | Numerisk | 0...1 | Använd orderreferensnummer vid fakturering, | 1 |
3 | invoicinglanguage | Sträng | 0...1 | Kundens faktureringsspråk, FI, EN eller SE. Om denna information inte ges med meddelandet, är standard fakturaspråk finska | FI |
Attr. | type | Sträng | Alltid ISO-3166 | ISO-3166 | |
3 | invoiceprintchannelformat | Numerisk | 0...1 | Fakturans utskriftsformat | 1 |
Attr. | type | Sträng | 1 | Alltid netvisor | netvisor |
3 | yourdefaultreference | Sträng, max. 200 | 0...1 | Standardreferens |
|
3 | defaulttextbeforeinvoicelines | Sträng, max. 500 | 0...1 | Standardtext före fakturarader |
|
3 | defaulttextafterinvoicelines | Sträng, max. 500 | 0...1 | Standardtext efter fakturarader |
|
3 | defaultpaymentterm | Sträng | 0...1 | Standardbetalningsvillkor | 14 dagar netto |
Attr. | type | Sträng | 1 | Typ av betalningsvillkor, netvisor (id) eller customer (namn) | customer |
3 | defaultsecondname | Sträng | 0...1 | Standard bifirma | Bifirma |
Atrr. | type | Sträng | 1 | Typ av standard bifirma, netvisor (id) eller customer (namn) | customer |
3 | paymentinterest | Numerisk | 0...1 | Dröjsmålsränta | 5 |
3 | balancelimit | Numerisk | 0...1 | Kontogräns | 5000 |
3 | receivablesmanagementautomationrule | Sträng | 0...1 | Automatiseringsregel för påminnelser | Privatkunder |
Attr. | type | Sträng | 1 | Typ av automatiseringsregel för påminnelser netvisor (id) eller customer (namn) | customer |
3 | FactoringAccount | Sträng | 0...1 | Factoringkonto som används av kunden | Factoringkonto |
Attr. | type | Sträng | 1 | Typ av factoringkonto netvisor (id) eller customer (namn) | customer |
3 | taxhandlingtype | Sträng | 0...1 | Kundens skattehantering, tillåtna värden countrygroup, forcedomestic, notaxhandling och domesticconstructionservice | countrygroup |
3 | eustandardfinvoice | Numerisk | 0...1 | Används EU-standard e-faktura. 1 = ja, 0 = nej. | 1 |
3 | denyinvoicecollection | Numerisk | 0...1 | Kundspecifik indrivningsförbud, värden 0 och 1. Värde 1 ställer kundspecifik indrivningsförbud. | 1 |
3 | denydelivery | Numerisk | 0...1 | Kundspecifik leveransförbud, värden 0 och 1. Värde 1 ställer kundspecifik leveransförbud. | 1 |
3 | defaultsalesperson | Aggregat | 0...1 |
|
|
4 | salespersonid | Sträng | 0...1 | Standard försäljarens id |
|
Attr. | type | Sträng | 1 | Id-typ, alltid netvisor | netvisor |
2 | customerdimensiondetails | Aggregat | 0...1 | ||
3 | dimension | Aggregat | 1...n | ||
4 | dimensionname | Sträng | 1 | Standard kostnadsobjektrubrik | Project |
4 | dimensionitem | Sträng | 1 | Standard kostnadsobjekt | Project 1 |
4 | dimensionitemcode | Sträng | 0...1 | Kostnadsobjektets kod | DIMC-001 |
4 | dimensionitemname | Sträng | 0...1 | Kostnadsobjektets namn | Item Name 1 |
Denna artikel har översatts med hjälp av ett AI-baserat översättningsverktyg. Innehållet eller formuleringen i dessa instruktioner kan avvika från dem i andra instruktioner eller i programvaran.