Hoppa till huvudinnehåll

Resurser – Kundregister

Funktionerna för hantering av kundregistret uppdelas på följande funktioner:

Integration

HTTP-metod

Resurs

DTD

Schema

Exempel

GET

customerlist.nv

GET

getcustomer.nv

POST

customer.nv

GET

deletecustomer.nv

POST

office.nv

GET

salespersonnellist.nv


Hämta kundlista

Resurs: customerlist.nv

Hämtar Netvisors kundlista. Kundlistan innehåller kundernas basuppgifter (NetvisorID, namn, kundkod, FO-nummer för företagskunder, URI för avancerad sökning av kunduppgifter). Detaljerade kunduppgifter kan härefter hämtas med funktionen Hämta kunduppgifter.

Parametrar som används i anropet:

Parameter

Förekomster

Beskrivning

Exempel

keyword

0...1

Filtrerar en lista med givet keyword. Returnerar en lista med kunder som innehåller kunder med keyword*.

Matchningar söks i fälten Namn, Kundnummer, Företags-ID, CoNamn

changedsince

0...1

Filtrerar leverantörer med ändringar efter givet datum. Datum i formatet YYYY-MM-DDTHH:mm:ss

2014-09-13

customercodelist

0...1

Kommaseparerad lista över kundkoder som returnerar den filtrerade listan. Listan får innehålla högst 100 alfanumeriska kundkoder. Obs! Keyword-parametern kan anges med customercodelist-parametern. I så fall returnerar resursen de kunder som har en kundkod OCH ett keyword som finns på listan i några av de fält som keyword söktes bland.

Om keyword-parametern har givits ignoreras changedsince.

Svar:

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

1

Customerlist

Aggregat

1

2

Customer

Aggregat

0...n

3

NetvisorKey

Nummer

1

Kundens Netvisor ID (Netvisors bas-ID)

123

3

Name

Teckensträng

1

Kundens namn

Kund 1

3

Code

Teckensträng

1

Kundens kod

234

3

Organisationidentifier

Teckensträng

1

Kundens FO-nummer om inte konsumentkund

12345678-9

3

CustomerGroupID

Numerisk

1

Kundgruppens ID som kunden tillhör. Kan även vara tomt.

2

3

CustomerGroupName

Teckensträng

1

Namnet på den kundgrupp som kunden tillhör. Kan även vara tomt.

Kundgrupp 1

3

Uri

Teckensträng

1

Adress för hämtning av kunduppgifter

/getcustomer.nv?id=123


Hämta kunduppgifter

Resurs: getcustomer.nv

Innan hämtning av kunduppgifter från Netvisor ska en kundlista hämtas från vilken kundens ID plockas (NetvisorKey). Med hjälp av detta kan du hämta detaljerade uppgifter. Kunduppgifter kan hämtas antingen för en kund i taget eller med hjälp av parametern idlist för upp till högst 500 kunder.

Parametrar som används i anropet:

Parameter

Förekomster

Exempel

Beskrivning

id

1

123

Den sökta kundens Netvisor ID (Netvisors bas-ID)

idlist

0...1

1,2,3

Returnerar fullständig information om inköpsfakturor i en förfrågan, max. 500 ID:n

<<<<<<<<<<<<<<<<<<<<<<<<<<<<replyoption

0...1

1

Returnerar uppgifter om cirkulationskörningar av kundens försäljningsfordringar

Svar:

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

1

Customer

Aggregat

1

2

CustomerBaseInformation

Aggregat

1

3

NetvisorKey

Numerisk

1

Kundens Netvisor ID

1001

3

InternalIdentifier

Teckensträng

1

Kundkod

MM

3

ExternalIdentifier

Teckensträng

1

FO-nummer

1967543-8

3

OrganizationUnitNumber

Nummer

0...1

EDI-kod:

00371967543815

3

CustomerGroupNetvisorKey

Teckensträng

0...1

Kundgruppens ID

3

CustomerGroupName

Teckensträng

0...1

Kundgruppens namn

3

Name

Teckensträng

1

Kundens namn

Matti Meikäläinen

3

NameExtension

Teckensträng

1

Kundens namntillägg

Verkställande direktör

3

StreetAddress

Teckensträng

1

Gatuadress

Videgränden 1

3

AdditionalStreetAddress

Teckensträng

1

Faktureringsadressens tilläggsfält

3

City

Teckensträng

1

Postanstalt

Villmanstrand

3

PostNumber

Teckensträng

1

Postnummer

53100

3

Country

Teckensträng

0...1

Landskod i ISO 3166-format

FI

Attr.

Type

Teckensträng

0...1

Landskod visas alltid i ISO 3166-format

ISO-3166

3

PhoneNumber

Teckensträng

1

Telefonnummer

040 123 456

3

FaxNumber

Teckensträng

1

Faxnummer

05 123 456

3

Email

Teckensträng

1

E-postadress

3

HomePageUri

Teckensträng

1

www-adress

3

IsActive

Nummer

1

0 eller 1 beroende på om kunden är aktiv

1

3

IsPrivateCustomer

Nummer

1

1 om personkund, 0 om inte personkund

1

3

EmailInvoicingAddress

Teckensträng

1

E-postfaktureringsadress

2

CustomerFinvoiceDetails

Aggregat

1

3

FinvoiceAddress

Teckensträng

1

E-fakturaadress

FI10970021497

3

FinvoiceRouterCode

Teckensträng

1

Nätfakturaoperatör

NDEAFIHH

2

CustomerDeliveryDetails

Aggregat

1

3

DeliveryName

Teckensträng

1

Leveransens namn

3

DeliveryStreetAddress

Teckensträng

1

Leveransadress

3

DeliveryCity

Teckensträng

1

Postanstalt

3

DeliveryPostNumber

Teckensträng

1

Postnummer

3

DeliveryCountry

Teckensträng

0...1

Landsuppgift

Attr.

type

Teckensträng

0...1

Landskod visas alltid i ISO 3166-format

ISO-3166

2

CustomerContactDetails

Aggregat

1

3

ContactPerson

Teckensträng

1

Standardkontaktpersonens namn

3

ContactPersonEmail

Teckensträng

1

Standardkontaktpersonens e-post

3

ContactPersonPhone

Teckensträng

1

Standardkontaktpersonens telefonnummer

2

CustomerContactPersons

Aggregat

0..1

3

CustomerContactPerson

Aggregat

1

4

ContactPersonID

Numerisk

1

Kontaktpersonens NetvisorID

1006

4

ContactPersonFirstName

Teckensträng

1

Kontaktpersonens förnamn

Eric

4

ContactPersonLastName

Teckensträng

1

Kontaktpersonens efternamn

Example

4

ContactPersonPhoneNumber

Numerisk

1

Kontaktpersonens telefonnummer

0501234567

4

ContactPersonEmail

Teckensträng

1

Kontaktpersonens e-postadress

2

CustomerOfficeDetails

Aggregat

0...n

Uppgifter om kundens verksamhetsställe

3

OfficeNetvisorKey

Numerisk

1

Verksamhetsställets Netvisor ID

10

3

OfficeName

Teckensträng

1

Verksamhetsställets namn

Helsingforskontoret

3

OfficePhoneNumber

Teckensträng

1

Verksamhetsställets telefonnummer

040 312 654

3

OfficeTelefaxNumber

Teckensträng

1

Verksamhetsställets fax

05 321 654

3

OfficeIdentifier

Teckensträng

1

Verksamhetsställets ID

verksamhetsställes-ID

3

OfficeContactAddress

Aggregat

1

Verksamhetsställets postnummeruppgifter

4

StreetAddress

Teckensträng

0...1

Gatuadress

Centralgatan 1

4

PostNumber

Teckensträng

0...1

Postnummer

00100

4

City

Teckensträng

0...1

Stad

Helsingfors

4

Country

Teckensträng

0...1

Land

Finland

3

OfficeVisitAddress

Aggregat

1

Uppgifter om verksamhetsställets besöksadress

4

StreetAddress

Teckensträng

0...1

Gatuadress

Centralgatan 1

4

PostNumber

Teckensträng

0...1

Postnummer

00100

4

City

Teckensträng

0...1

Stad

Helsingfors

4

Country

Teckensträng

0...1

Land

Finland

3

OfficeFinvoiceDetails

Aggregat

1

Verksamhetsställets nätfakturauppgifter

4

FinvoiceAddress

Teckensträng

0...1

Nätfakturaadress (IBAN eller OVT)

003716264123

4

FinvoiceRouterCode

Teckensträng

0...1

Nätfakturaoperatör

003721291126

2

CustomerAdditionalInformation

Aggregat

1

3

Comment

Teckensträng

1

Kommentarstext

3

CustomerAgreementIdentifier

Teckensträng

1

Avtalskod

3

ReferenceNumber

Teckensträng

1

Standardreferens

3

YourDefaultReference

Teckensträng

1

Er standardreferens

3

DefaultTextBeforeInvoiceLines

Teckensträng

1

Standardtext före fakturarader

3

DefaultTextAfterInvoiceLines

Teckensträng

1

Standardtext efter fakturarader

3

DefaultPaymentTerm

Teckensträng

1

Standardbetalningsvillkor

14 dagar netto

Attr.

NetvisorKey

Teckensträng

1

NetvisorKey (ID)

2

3

TaxHandlingType

Teckensträng

1

Standardbehandling vid beskattning

Behandling enligt kundens faktureringslandsgrupp

3

BalanceLimit

Decimaltal

1

Kundens kontogräns med två decimalers precision.

3

DefaultSalesPerson

Teckensträng

0...1

Standardförsäljarens namn

3

DiscountPercentage

Nummer

0...1

Rabattprocent

10

3

PriceGroup

Teckensträng

0...1

Namnet på den kundgrupp som kunden tillhör

3

FactoringAccount

Teckensträng

0...1

Kundens factoringkontos namn

Factoring

Attr.

NetvisorKey

Teckensträng

1

Factoringkontots NetvisorID

1

3

InvoicingLanguage

Teckensträng

0...1

Kundens faktureringsspråk

FI

Attr.

type

Teckensträng

1

Landskod visas alltid i ISO 3166-format

ISO-3166

3

CustomerDimensions

Aggregat

0...1

4

Dimension

Aggregat

0...n

5

DimensionName

Teckensträng

1

Kundens räkenskapsobjekts rubrik

Djur

Attr.

NetvisorKey

Teckensträng

1

Räkenskapsobjektets rubrik-ID

4

5

DimensionItem

Teckensträng

1

Kundens räkenskapsobjekt

Katter

Attr.

NetvisorKey

Teckensträng

1

Räkenskapsobjektets NetvisorID

117

2

AdditionalInformation

Aggregat

0...1

3

ReceivablesManagement

Aggregat

1

Cirkulationstider för kundfordringar

4

TurnoverDays

Teckensträng

1

Genomsnittlig betalningstid

42

4

TurnoverDeviation

Teckensträng

1

Betalningsdag i förhållande till förfallodagen

28


Importera kunduppgifter

Resurs: customer.nv

Används för att lägga till en ny kund eller uppdatera en gammal. En sökning efter kundlistan eller kundens fullständiga uppgifter sker med olika anrop.

Om e-faktureringsuppgifter angetts kontrolleras inte e-faktureringsadressens riktighet separat. E-faktureringsoperatören måste dock hittas i systemet.

Nedan finns en lista över e-faktureringsoperatörer och operatörs-ID:n som tillåts av Netvisor:

Nätfakturaoperatör

Kod:

Aktia

HELSFIHH

Ålandsbanken

AABAFI22

Apix Messaging Oy

003723327487

Apix Messaging Oy (gammal kod)

00372332748700001

Basware Abp

BAWCFI22

CGI Finland (f.d. Logica)

003703575029

Danske Bank

DABAFIHH

DNB Bank ASA, Finland Branch

DNBAFIHX

Handelsbanken

HANDFIHH

InExchange Factorum AB

INEXCHANGE

InExchange Factorum AB (gammal kod)

SE556700997101

Lexmark Expert Systems AAB

(EXPSYS)

Open Text Oy

003708599126

Maventa

003721291126

Netbox Finland Oy

003726044706

Nordea

NDEAFIHH

Notebeat Oy

003717203971

OpusCapita (gammal kod till 31.12.2018)

003710948874

OpusCapita Solutions Oy

E204503

Andelsbanken

OKOYFIHH

Pagero

003723609900

PEPPOL

(PEPPOL)

POP Bank

POPFFI22

PostNord Strålfors Oy

003701150617

Ropo Capital

003714377140

Sparbanken

ITELFIHH

S-Banken/LokalTapiola

SBANFIHH

Sproom ApS

SPROOM

Telia/ CGI Finland Abp

003703575029

Tieto Abp

003701011385

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 uppgifter redigeras

Om inte metoden angetts eller kunden som ska uppdateras inte hittas i systemet returneras felet INVALID_DATA med förklaring. För att ta reda på kundens ID ska du först begära kundlistan.

När en kund uppdateras skrivs endast de data som ska uppdateras i XML-meddelandet. Skriv inte in data som du inte vill uppdatera: annars kommer gränssnittet att uppdatera dem till tomma.

salespersonid får du genom att använda funktionen Hämta Försäljarlista.

Data som ska importeras skickas med anropet som XML (POST-data) enligt vidstående beskrivning:

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

root

root

Aggregat

1

1

customer

Aggregat

1

2

customerbaseinformation

Aggregat

1

3

internalidentifier

Teckensträng, max. 50

0...1

Kundkod

MM123

Attr.

type

Teckensträng

0...1

automatic (om kundkoden lämnas tom används nästa lediga kundnummer automatiskt)

automatic

3

externalidentifier

Teckensträng

0...1

FO-nummer

1967543-8

3

organizationunitnumber

Nummer,

max. 17

0...1

EDI-kod (mottagarens EDI-kod om informationen skiljer sig från företagets FO-nummer).

00371967543815

3

name

Teckensträng, max. 250

0...1

Kundens namn

Matti Meikäläinen

3

nameextension

Teckensträng, max. 250

0...1

Kundens namntillägg

Verkställande direktör

3

streetaddress

Teckensträng, max. 80

0...1

Gatuadress

Videgränden 1

3

additionaladdressline

Teckensträng, max. 80

0...1

Adresstillägg

3

city

Teckensträng, max. 80

0...1

Postanstalt

Villmanstrand

3

postnumber

Teckensträng, max. 50

0...1

Postnummer

53100

3

country

Teckensträng

0...1

Landsuppgift (om inget anges är Finland standard)

FI

Attr.

type

Teckensträng

0...1

Landskodens visningssätt

ISO-3166

3

customergroupname

Teckensträng, max. 50

0...1

Kundgruppens namn, kund läggs till gruppen med namn Om gruppen inte finns skapas en.

Rabattkunder

3

phonenumber

Teckensträng, max. 80

0...1

Telefonnummer

040 123456

3

faxnumber

Teckensträng, max. 80

0...1

Faxnummer

05 123456

3

email

Teckensträng, max. 200

0...1

E-postadress

3

homepageuri

Teckensträ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 personkund (1 = personkund).

0

3

emailinvoicingaddress

Teckensträng, max. 500

0...1

E-post för fakturering, måste vara en giltig e-postadress. Kan ges som en lista; separerade

2

customerfinvoicedetails

Aggregat

0...1

3

finvoiceaddress

Teckensträng,

max. 50

1

E-fakturaadress, kan inte importeras utan e-fakturaoperatörsuppgift

FI109700021497

3

finvoiceroutercode

Teckensträng,

max. 50

1

Operatörs-ID för e-faktureringsoperatör, tillåtna operatörer

NDEAFIHH

2

customerdeliverydetails

Aggregat

0...1

3

deliveryname

Teckensträng, max. 250

0...1

Leveransadressens namnuppgift

Maija Mehiläinen

3

deliverystreetaddress

Teckensträng, max. 80

0...1

Leveransadress

Videgränden 2

3

deliverycity

Teckensträng, max. 80

0...1

Leveransadressens postanstaltuppgift

Villmanstrand

3

deliverypostnumber

Teckensträng, max. 50

0...1

Leveransadressens postnummer

53100

3

deliverycountry

Teckensträng

0...1

Leveransadressens landsuppgift

FI

Attr.

type

Teckensträng

0...1

Landskod visas alltid i ISO 3166-format

ISO-3166

2

customercontactdetails

Aggregat

0...1

3

contactname

Teckensträng

0...1

Ej visualiserat i användargränssnittet, använd inte

3

contactperson

Teckensträng, max. 80

0...1

Kontaktpersonens namn, uppgiften exporteras till användargränssnittets Efternamn-fält

Matti Meikäläinen

3

contactpersonemail

Teckensträng, max. 200

0...1

Kontaktpersonens e-postadress

matti.meikälä[email protected]

3

contactpersonphone

Teckensträng, max. 80

0...1

Kontaktpersonens telefonnummer

040 987 254

2

customeradditionalinformation

Aggregat

0...1

3

comment

Teckensträng, max. 2500

0...1

Kommentar till kundregistret

3

customeragreementIdentifier

Teckensträng, max. 35

0...1

Avtalskod

3

customerreferencenumber

Teckensträng

0...1

Referensnummer med autentiserare i korrekt format

1070

3

invoicinglanguage

Teckensträng

0...1

Kundens faktureringsspråk, FI, EN eller SE. Om denna uppgift inte ges är fältet Fakturaspråk som standard finska

FI

Attr.

type

Teckensträng

0...1

Alltid ISO-3166

ISO-3166

3

invoiceprintchannelformat

Numerisk

0...1

Fakturans utskriftsformat

1 = Faktura + girering

2 = Faktura

1

Attr.

type

Teckensträng

1

Alltid netvisor

netvisor

3

yourdefaultreference

Teckensträng, max. 200

0...1

Er standardreferens

3

defaulttextbeforeinvoicelines

Teckensträng, max. 500

0...1

Standardtext före fakturarader

3

defaulttextafterinvoicelines

Teckensträng, max. 500

0...1

Standardtext efter fakturarader

3

defaultpaymentterm

Teckensträng

0...1

Standardbetalningsvillkor

14 dagar netto

Attr.

type

Teckensträng

1

Typ av betalningsvillkor, netvisor (id) eller customer (namn)

customer

3

defaultsecondname

Teckensträng

0...1

Standardbifirma

Bifirma

Attr.

type

Teckensträng

1

Typ av standardbifirma, netvisor (id) ellercustomer (namn)

customer

3

paymentinterest

Numerisk

0...1

Dröjsmålsränteprocent

5

3

balancelimit

Numerisk

0...1

Kontogräns

5000

3

defaultsalesperson

Aggregat

0...1

4

salespersonid

Teckensträng

0...1

Standardförsäljarens ID

Attr.

type

Teckensträng

1

ID-typ, alltid netvisor

netvisor

2

customerdimensiondetails

Aggregat

0...1

3

dimension

Aggregat

1...n

4

dimensionname

Teckensträng

1

Standardräkenskapsobjektets rubrik

Project

4

dimensionitem

Teckensträng

1

Standardräkenskapsobjekt:

Project 1


Ta bort kund

Resurs: deletecustomer.nv

Med resursen kan du ta bort en enskild kund från Netvisor. Om raderingen lyckades, visas meddelandet "OK". Om raderingen misslyckas kommer orsakerna till raderingen att returneras med felmeddelandet, exempelvis "Kunden har fakturor":

Parametrar som används i anropet:

Parameter

Förekomster

Beskrivning

Exempel

customerid

1

Kundens NetvisorKey eller ID

2


Importera kundens verksamhetsställe

Resurs: office.nv

Lägg till och redigera kundens verksamhetsställe.

Parametrar som används i anropet:

Parameter

Förekomster

Beskrivning

Exempel

method

1

Add eller Edit

Add

customerid

1

Kundens NetvisorID

123

officeid

0...1

Verksamhetsställets NetvisorID, obligatoriskt vid redigering av befintligt verksamhetsställe

1

Ytterligare anmärkningar:

  • Med Redigera meddelande kan du radera data genom att ange tagginnehåll tomt.

  • Verksamhetsplatsens namn är obligatoriskt vid nya tillägg.

  • FinvoiceAddress måste vara en giltig EDI eller IBAN.

  • FinvoiceOperator använder samma operatörs-ID som överallt i gränssnittet, se listan ovan.

Data som ska importeras skickas med anropet som xml (POST-data) enligt medföljande beskrivning.

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

Root

root

Aggregat

1

1

office

Aggregat

1

2

name

Teckensträng

1

Verksamhetsställets namn

2

phonenumber

Teckensträng

0...1

Verksamhetsställets telefonnummer

2

telefaxnumber

Teckensträng

0...1

Verksamhetsställets fax

2

officeidentifier

Teckensträng

0...1

Verksamhetsställes-ID

2

officecontactaddress

Aggregat

0...1

Verksamhetsställets postnummeruppgifter

3

streetaddress

Teckensträng

1

Gatuadress

3

postnumber

Teckensträng

1

Postnummer

3

city

Teckensträng

1

Stad

3

country

Teckensträng

1

Landskod

Attr.

type

Teckensträng

1

Alltid ISO-3166

2

officevisitaddress

Aggregat

0...1

Uppgifter om verksamhetsställets besöksadress

3

streetaddress

Teckensträng

1

Gatuadress

3

postnumber

Teckensträng

1

Postnummer

3

city

Teckensträng

1

Stad

3

country

Teckensträng

1

Landskod

Attr.

type

Teckensträng

1

Alltid ISO-3166

2

officefinvoicedetails

Aggregat

0...1

Verksamhetsställets nätfakturauppgifter

3

finvoiceaddress

Teckensträng

1

Nätfakturaadress (IBAN eller OVT)

3

finvoiceroutercode

Teckensträng

1

Nätfakturaoperatör


Hämta försäljarlista

Resurs: salespersonnellist.nv

Hämtar en lista över försäljare.

Svar:

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

Root

root

Aggregat

1

1

SalesPersonnelList

Aggregat

1

2

SalesPerson

Aggregat

0...n

Attr.

NetvisorKey

Teckensträng

1

Försäljarens NetvisorID

1

3

FirstName

Teckensträng

1

Försäljarens förnamn

Matti

3

LastName

Teckensträng

1

Försäljarens efternamn

Försäljningsansvarig

3

ProvisionPercent

Nummer

1

Försäljarens provisionsprocent

10

Fick du svar på din fråga?