Hoppa till huvudinnehåll

Hämtning av kunduppgifter getcustomer.nv

Resurssi: getcustomer.nv

HTTP-metodi: GET

Innan kundinformation hämtas från Netvisor måste en kundlista hämtas, från vilken kundens identifierare (NetvisorKey) tas. Med detta kan mer detaljerad information hämtas. Kundens information kan hämtas antingen en kund i taget eller genom att använda idlist-parametern för att hämta information om max. 500 kunder.

Parametrar som används i anropet:

Parametri

Förekomster

Exempel

Beskrivning

id

1

123

NetvisorKey eller ID för den kund som ska hämtas

idlist

0...1

1,2,3

Returnerar fullständig information om alla önskade kunder i ett anrop, max. 500 ID:n

replyoption

0...1

1

Returnerar information om kundens omsättningstider för försäljningsfordringar

replyoption

0...1

8

Returnerar information om kundens standardfakturametod BuyerServiceCode

replyoption

0...1

4

Returnerar information om kundens tilläggsinformationsfält CustomTags

replyoption

0...1

2

Returnerar information om kundens automatiska påminnelser AutomationRule

Svar:

Nivå

Element

Format

Förekomster

Beskrivning

Exempel

1

Customer

Aggregat

1

2

CustomerBaseInformation

Aggregat

1

3

NetvisorKey

Numerisk

1

Kundens Netvisor-identifierare

1001

3

InternalIdentifier

Sträng

1

Kundkod

MM

3

ExternalIdentifier

Sträng

1

Fo-nummer

1967543-8

3

OrganizationUnitNumber

Nummer

0...1

OVT-nummer

00371967543815

3

CustomerGroupNetvisorKey

Sträng

0...1

Identifierare för kundgrupp

3

CustomerGroupName

Sträng

0...1

Namn på kundgrupp

3

Name

Sträng

1

Kundens namn

Matti Meikäläinen

3

NameExtension

Sträng

1

Förlängning av kundens namn

VD

3

StreetAddress

Sträng

1

Gatuadress

Pajukuja 1

3

AdditionalStreetAddress

Sträng

1

Extra fält för faktureringsadress

3

City

Sträng

1

Postanstalt

Lappeenranta

3

PostNumber

Sträng

1

Postnummer

53100

3

Country

Sträng

0...1

Landsinformation i ISO-3166 format

FI

Attr.

type

Sträng

0...1

Presentation av landsinformation, alltid ISO-3166

ISO-3166

3

PhoneNumber

Sträng

1

Telefonnummer

040 123 456

3

FaxNumber

Sträng

1

Faxnummer

05 123 456

3

Email

Sträng

1

E-postadress

3

EmailInvoicingAddress

Sträng

1

E-postfaktureringsadress

3

HomePageUri

Sträng

1

Webbadress

3

IsActive

Nummer

1

0 eller 1 beroende på om kunden är aktiv

1

3

IsPrivateCustomer

Nummer

1

1 om det är en privatkund, 0 om det inte är en privatkund

1

2

CustomerFinvoiceDetails

Aggregat

1

3

FinvoiceAddress

Sträng

1

E-fakturaadress

FI10970021497

3

FinvoiceRouterCode

Sträng

1

E-fakturaoperatör

NDEAFIHH

2

CustomerDeliveryDetails

Aggregat

1

Kundens standardverksamhetsställe

3

DeliveryName

Sträng

1

Leveransens namn

3

DeliveryStreetAddress

Sträng

1

Leveransadress

3

DeliveryCity

Sträng

1

Postanstalt

3

DeliveryPostNumber

Sträng

1

Postnummer

3

DeliveryCountry

Sträng

0...1

Landsinformation

Attr.

type

Sträng

0...1

Presentation av landsinformation, alltid ISO-3166

ISO-3166

2

CustomerContactDetails

Aggregat

1

3

ContactPerson

Sträng

1

Namn på standardkontaktperson

3

ContactPersonEmail

Sträng

1

E-post för standardkontaktperson

3

ContactPersonPhone

Sträng

1

Telefonnummer för standardkontaktperson

2

CustomerContactPersons

Aggregat

0..1

3

CustomerContactPerson

Aggregat

1

4

ContactPersonID

Numerisk

1

NetvisorID för kontaktperson

1006

4

ContactPersonFirstName

Sträng

1

Förnamn på kontaktperson

Eric

4

ContactPersonLastName

Sträng

1

Efternamn på kontaktperson

Example

4

ContactPersonPhoneNumber

Numerisk

1

Telefonnummer för kontaktperson

0501234567

4

ContactPersonEmail

Sträng

1

E-postadress för kontaktperson

4

ContactPersonOfficeNetvisorKey

Numerisk

1

Netvisor-id för kontaktpersonens kontor

2

2

CustomerOfficeDetails

Aggregat

0...n

Information om kundens kontor

3

OfficeNetvisorKey

Numerisk

1

Netvisor-identifierare för kontor

10

3

OfficeName

Sträng

1

Kontorets namn

Helsingfors kontor

3

OfficePhoneNumber

Sträng

1

Kontorets telefonnummer

040 312 654

3

OfficeTelefaxNumber

Sträng

1

Kontorets fax

05 321 654

3

OfficeIdentifier

Sträng

1

Kontorets identifierare

kontorsidentifierare

3

OfficeContactAddress

Aggregat

1

Postadressinformation för kontor

4

StreetAddress

Sträng

0...1

Gatuadress

Keskuskatu 1

4

PostNumber

Sträng

0...1

Postnummer

00100

4

City

Sträng

0...1

Stad

Helsingfors

4

Country

Sträng

0...1

Land

Finland

3

OfficeVisitAddress

Aggregat

1

Besöksadressinformation för kontor

4

StreetAddress

Sträng

0...1

Gatuadress

Keskuskatu 1

4

PostNumber

Sträng

0...1

Postnummer

00100

4

City

Sträng

0...1

Stad

Helsingfors

4

Country

Sträng

0...1

Land

Finland

3

OfficeFinvoiceDetails

Aggregat

1

E-fakturainformation för kontor

4

FinvoiceAddress

Sträng

0...1

E-fakturaadress (IBAN eller OVT)

003716264123

4

FinvoiceRouterCode

Sträng

0...1

E-fakturaoperatör

003721291126

2

CustomerAdditionalInformation

Aggregat

1

3

Comment

Sträng

1

Kommentartext

3

CustomerAgreementIdentifier

Sträng

1

Avtalsidentifierare

3

ReferenceNumber

Sträng

1

Standardreferens

3

UseCreditorReferenceNumber

Numerisk

1

Används RF-referens vid fakturering. 1 eller 0

1

3

UseOrderReferenceNumber

Numerisk

1

Använd beställningens referensnummer vid fakturering:

0 eller 1

3

YourDefaultReference

Sträng

1

Er standardreferens

3

DefaultTextBeforeInvoiceLines

Sträng

1

Standardtext före fakturarader

3

DefaultTextAfterInvoiceLines

Sträng

1

Standardtext efter fakturarader

3

DefaultPaymentTerm

Sträng

1

Standardbetalningsvillkor

14 dagar netto

Attr.

NetvisorKey

Sträng

1

NetvisorKey (ID)

2

3

TaxHandlingType

Sträng

1

Standard skattehantering

Hantering enligt kundens faktureringslandsgrupp

3

BalanceLimit

Decimal

1

Kundens kontogräns, med två decimalers noggrannhet.

3

DefaultSalesPerson

Sträng

0...1

Namn på standardförsäljare

3

DiscountPercentage

Nummer

0...1

Rabattprocent

10

3

PriceGroup

Sträng

0...1

Namn på prisgrupp som kunden är länkad till

3

FactoringAccount

Sträng

0...1

Namn på kundens factoringkonto

Factoring

Attr.

NetvisorKey

Sträng

1

NetvisorID för factoringkonto

1

3

InvoicingLanguage

Sträng

0...1

Kundens faktureringsspråk

FI

Attr.

type

Sträng

1

Presentation av landsinformation, alltid ISO-3166

ISO-3166

3

EUStandardFinvoice

Nummer

0...1

E-faktura enligt EU-standard, 1=ja, 0=nej

1

3

InCollectionProhibitation

Nummer

1

Indrivningsförbud, 1=ja, 0=nej

1

3

CustomerDimensions

Aggregat

0...1

4

Dimension

Aggregat

0...n

5

DimensionName

Sträng

1

Rubrik för kundens kostnadsobjekt

Djur

Attr.

NetvisorKey

Sträng

1

Netvisor ID för kostnadsobjektets rubrik

4

5

DimensionItem

Sträng

1

Kundens kostnadsobjekt

Om ett kostnadsobjekt har ett angivet ID returneras nu ett kombinerat namn, dvs. ID + namn, t.ex. "P001 Verkkosivuston uudistus"

Katter

Attr.

NetvisorKey

Sträng

1

Netvisor ID för kostnadsobjekt

117

5

DimensionItemName

Sträng

0...1

Namn på kostnadsobjekt

Verkkosivuston uudistus

5

DimensionItemCode

Sträng

0...1

Identifierare för kostnadsobjekt

P001

2

AdditionalInformation

Aggregat

0...1

BuyerServiceCode

Sträng

Kundens standardfakturametod

00 - Konsument e-faktura

01 - Suoramaksu

/ - ei mitään

3

CustomTag

Sträng

1

Tilläggsinformationsfält

Laivatyö alv 0% MOMS 58 §

attr.

NetvisorKey

Sträng

1

NetvisorKey för tilläggsinformationsfält

5

3

ReceivablesManagement

Aggregat

1

Omsättningstider för försäljningsfordringar

4

TurnoverDays

Sträng

1

Genomsnittlig betalningstid

42

4

TurnoverDeviation

Sträng

1

Betalningsdag i förhållande till förfallodag

28

Förändringshistorik

Datum

Ändring

Beskrivning

Nya element DimensionItemName och DimensionItemCode

Ändring i logiken för elementet DimensionItem

Enligt Netvisors nya hantering av kostnadsobjekt returneras nu kostnadsobjektets identifierare i svaret, om ett ID har angetts i Netvisor.

Om ett ID har angetts returnerar då även elementet DimensionItem kostnadsobjektets identifierare tillsammans med namnet.

12.12.2024

Nytt element InCollectionProhibitation

I svarsmeddelandet returneras nu information om kunden är under indrivningsförbud.

9.10.2025

Nya parametrar

CustomTags och AutomationRule

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.

Fick du svar på din fråga?