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 Obligatorisk när kundens information redigeras |
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, max. 17 | 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 | matti.meikalainen@firma.fi | |
| 3 | homepageuri | Sträng, max. 80 | 0...1 | www-adress | www.firma.fi |
| 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 ; | matti.meikalainen@firma.fi |
| 2 | customerfinvoicedetails | Aggregat | 0...1 | ||
| 3 | finvoiceaddress | Sträng, max. 50 | 1 | E-fakturaadress, kan inte föras in utan e-fakturaoperatörsinformation | FI109700021497 |
| 3 | finvoiceroutercode | Sträng, max. 50 | 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äinen@firma.fi |
| 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=på 0=av | 1 |
| 3 | useorderreferencenumber | Numerisk | 0...1 | Använd orderreferensnummer vid fakturering, 1=på 0=av | 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 = Faktura + girering 2 = Faktura | 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 Om det ges som decimaltal, ska decimalseparatorn vara ett kommatecken. | 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 | 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 Om rubriken inte finns, skapas en ny | Project |
| 4 | dimensionitem | Sträng | 1 | Standard kostnadsobjekt Om kostnadsobjektet inte finns, skapas en ny | Project 1 |
Hjälpte det här svaret? Ja Nej
Send feedback