Siirry pääsisältöön

Asiakastietojen nouto getcustomer.nv

Resurssi: getcustomer.nv

HTTP-metodi: GET

Ennen asiakastiedon noutoa Netvisorista on noudettava asiakaslista, josta poimitaan asiakkaan tunniste (NetvisorKey). Tämän avulla voidaan noutaa tarkemmat tiedot. Asiakkaan tiedot voi noutaa joko asiakas kerrallaan tai idlist -parametria käyttämällä maks. 500 asiakkaan tiedot.

Kutsussa käytettävät parametrit:

Parametri

Ilmentymiä

Esimerkki

Kuvaus

id

1

123

Haettavan asiakkaan NetvisorKey eli ID

idlist

0...1

1,2,3

Palauttaa yhdessä pyynnössä täydet tiedot kaikista halutuista asiakkaista, max. 500 ID:tä

replyoption

0...1

1

Palauttaa tiedot asiakkaan myyntisaamisten kiertoajoista

replyoption

0...1

8

Palauttaa tiedon asiakkaan oletuslaskutustavasta BuyerServiceCode

replyoption

0...1

4

Palauttaa tiedon asiakkaan lisätietokentät CustomTags

replyoption

0...1

2

Palauttaa tiedon asiakkaan Automaattiset muistutukset AutomationRule

Vastaus:

Taso

Elementti

Muoto

Ilmentymiä

Kuvaus

Esimerkki

1

Customer

Aggregaatti

1

2

CustomerBaseInformation

Aggregaatti

1

3

NetvisorKey

Numeerinen

1

Asiakkaan Netvisor-tunnus

1001

3

InternalIdentifier

Merkkijono

1

Asiakaskoodi

MM

3

ExternalIdentifier

Merkkijono

1

Y-tunnus

1967543-8

3

OrganizationUnitNumber

Numero

0...1

OVT-tunnus

00371967543815

3

CustomerGroupNetvisorKey

Merkkijono

0...1

Asiakasryhmän tunniste

3

CustomerGroupName

Merkkijono

0...1

Asiakasryhmän nimi

3

Name

Merkkijono

1

Asiakkaan nimi

Matti Meikäläinen

3

NameExtension

Merkkijono

1

Asiakkaan nimen jatke

Toimitusjohtaja

3

StreetAddress

Merkkijono

1

Katuosoite

Pajukuja 1

3

AdditionalStreetAddress

Merkkijono

1

Laskutusosoitteen lisäkenttä

3

City

Merkkijono

1

Postitoimipaikka

Lappeenranta

3

PostNumber

Merkkijono

1

Postinumero

53100

3

Country

Merkkijono

0...1

Maatieto ISO-3166 muodossa

FI

Attr.

type

Merkkijono

0...1

Maatiedon esitystapa, aina ISO-3166

ISO-3166

3

PhoneNumber

Merkkijono

1

Puhelinnumero

040 123 456

3

FaxNumber

Merkkijono

1

Fax-numero

05 123 456

3

Email

Merkkijono

1

Sähköpostiosoite

3

EmailInvoicingAddress

Merkkijono

1

Sähköpostilaskutusosoite

3

HomePageUri

Merkkijono

1

www-osoite

3

IsActive

Numero

1

0 tai 1 riippuen siitä onko asiakas aktiivinen

1

3

IsPrivateCustomer

Numero

1

1 jos on henkilöasiakas, 0 jos ei ole henkilöasiakas

1

2

CustomerFinvoiceDetails

Aggregaatti

1

3

FinvoiceAddress

Merkkijono

1

Verkkolaskuosoite

FI10970021497

3

FinvoiceRouterCode

Merkkijono

1

Verkkolaskuoperaattori

NDEAFIHH

2

CustomerDeliveryDetails

Aggregaatti

1

Asiakkaan oletustoimipaikka

3

DeliveryName

Merkkijono

1

Toimituksen nimi

3

DeliveryStreetAddress

Merkkijono

1

Toimitusosoite

3

DeliveryCity

Merkkijono

1

Postitoimipaikka

3

DeliveryPostNumber

Merkkijono

1

Postinumero

3

DeliveryCountry

Merkkijono

0...1

Maatieto

Attr.

type

Merkkijono

0...1

Maatiedon esitystapa, aina ISO-3166

ISO-3166

2

CustomerContactDetails

Aggregaatti

1

3

ContactPerson

Merkkijono

1

Oletusyhteyshenkilön nimi

3

ContactPersonEmail

Merkkijono

1

Oletusyhteyshenkilön sähköposti

3

ContactPersonPhone

Merkkijono

1

Oletusyhteyshenkilön puhelinnumero

2

CustomerContactPersons

Aggregaatti

0..1

3

CustomerContactPerson

Aggregaatti

1

4

ContactPersonID

Numeerinen

1

Yhteyshenkilön NetvisorID

1006

4

ContactPersonFirstName

Merkkijono

1

Yhteyshenkilön etunimi

Eric

4

ContactPersonLastName

Merkkijono

1

Yhteyshenkilön sukunimi

Example

4

ContactPersonPhoneNumber

Numeerinen

1

Yhteyshenkilön puhelinnumero

0501234567

4

ContactPersonEmail

Merkkijono

1

Yhteyshenkilön sähköpostiosoite

4

ContactPersonOfficeNetvisorKey

Numeerinen

1

Yhteyshenkilön toimipaikan Netvisor-id

2

2

CustomerOfficeDetails

Aggregaatti

0...n

Asiakkaan toimipaikan tiedot

3

OfficeNetvisorKey

Numeerinen

1

Toimipaikan Netvisor-tunnus

10

3

OfficeName

Merkkijono

1

Toimipaikan nimi

Helsingin toimisto

3

OfficePhoneNumber

Merkkijono

1

Toimipaikan puhelinnumero

040 312 654

3

OfficeTelefaxNumber

Merkkijono

1

Toimipaikan faksi

05 321 654

3

OfficeIdentifier

Merkkijono

1

Toimipaikan tunnus

toimipaikkatunnus

3

OfficeContactAddress

Aggregaatti

1

Toimipaikan postiosoitetiedot

4

StreetAddress

Merkkijono

0...1

Katuosoite

Keskuskatu 1

4

PostNumber

Merkkijono

0...1

Postinumero

00100

4

City

Merkkijono

0...1

Kaupunki

Helsinki

4

Country

Merkkijono

0...1

Maa

Suomi

3

OfficeVisitAddress

Aggregaatti

1

Toimipaikan käyntiosoitteen tiedot

4

StreetAddress

Merkkijono

0...1

Katuosoite

Keskuskatu 1

4

PostNumber

Merkkijono

0...1

Postinumero

00100

4

City

Merkkijono

0...1

Kaupunki

Helsinki

4

Country

Merkkijono

0...1

Maa

Suomi

3

OfficeFinvoiceDetails

Aggregaatti

1

Toimipaikan verkkolaskutiedot

4

FinvoiceAddress

Merkkijono

0...1

Verkkolaskuosoite (IBAN tai OVT)

003716264123

4

FinvoiceRouterCode

Merkkijono

0...1

Verkkolaskuoperaattori

003721291126

2

CustomerAdditionalInformation

Aggregaatti

1

3

Comment

Merkkijono

1

Kommenttiteksti

3

CustomerAgreementIdentifier

Merkkijono

1

Sopimustunnus

3

ReferenceNumber

Merkkijono

1

Vakioviite

3

UseCreditorReferenceNumber

Numeerinen

1

Käytetäänkö RF-viitettä laskutuksessa. 1 tai 0

1

3

UseOrderReferenceNumber

Numeerinen

1

Käytä tilauksen viitenumeroa laskutuksessa:

0 tai 1

3

YourDefaultReference

Merkkijono

1

Oletusviitteenne

3

DefaultTextBeforeInvoiceLines

Merkkijono

1

Oletusteksti ennen laskurivejä

3

DefaultTextAfterInvoiceLines

Merkkijono

1

Oletusteksti jälkeen laskurivien

3

DefaultPaymentTerm

Merkkijono

1

Oletusmaksuehto

14 päivää netto

Attr.

NetvisorKey

Merkkijono

1

NetvisorKey (ID)

2

3

TaxHandlingType

Merkkijono

1

Oletusverotuskäsittely

Asiakkaan laskutusmaaryhmän mukainen käsittely

3

BalanceLimit

Desimaaliluku

1

Asiakkaan tiliraja, kahden desimaalin tarkkuudella.

3

DefaultSalesPerson

Merkkijono

0...1

Oletusmyyjän nimi

3

DiscountPercentage

Numero

0...1

Alennusprosentti

10

3

PriceGroup

Merkkijono

0...1

Hintaryhmän nimi johon asiakas on linkitetty

3

FactoringAccount

Merkkijono

0...1

Asiakkaan factoring-tilin nimi

Factoring

Attr.

NetvisorKey

Merkkijono

1

Factoring-tilin NetvisorID

1

3

InvoicingLanguage

Merkkijono

0...1

Asiakkaan laskutuskieli

FI

Attr.

type

Merkkijono

1

Maatiedon esitystapa, aina ISO-3166

ISO-3166

3

EUStandardFinvoice

Numero

0...1

EU-standardin mukainen verkkolasku, 1=kyllä, 0=ei

1

3

InCollectionProhibitation

Numero

1

Perintäkielto, 1=kyllä, 0=ei

1

3

CustomerDimensions

Aggregaatti

0...1

4

Dimension

Aggregaatti

0...n

5

DimensionName

Merkkijono

1

Asiakkaan laskentakohteen otsikko

Eläimet

Attr.

NetvisorKey

Merkkijono

1

Laskentakohteen otsikon Netvisor ID

4

5

DimensionItem

Merkkijono

1

Asiakkaan laskentakohde
​
Jos laskentakohteelle on asetettu tunniste, palautuu tällöin yhdistelmänimi eli tunniste + nimi, esim. "P001 Verkkosivuston uudistus"

Kissat

Attr.

NetvisorKey

Merkkijono

1

Laskentakohteen Netvisor ID

117

5

DimensionItemName

Merkkijono

0...1

Laskentakohteen nimi

Verkkosivuston uudistus

5

DimensionItemCode

Merkkijono

0...1

Laskentakohteen tunniste

P001

2

AdditionalInformation

Aggregaatti

0...1

BuyerServiceCode

Merkkijono

Asiakkaan oletuslaskutustapa

00 - Kuluttajaverkkolasku
​
01 - Suoramaksu
​
/ - ei mitään

3

CustomTag

Merkkijono

1

Lisätietokenttä

Laivatyö alv 0% ALV 58 §

attr.

NetvisorKey

Merkkijono

1

Lisätietokentän NetvisorKey

5

3

ReceivablesManagement

Aggregaatti

1

Myyntisaatavien kiertoajat

4

TurnoverDays

Merkkijono

1

Keskimääräinen maksuaika

42

4

TurnoverDeviation

Merkkijono

1

Maksupäivä suhteessa eräpäivään

28

Muutoshistoria

Päivämäärä

Muutos

Kuvaus

Uudet elementit DimensionItemName ja DimensionItemCode
​
Muutos elementin DimensionItem logiikkaan

Netvisorin uuden laskentakohdekäsittelyn mukaisesti vastauksessa palautuu nyt laskentakohteen tunniste, mikäli laskentakohteelle on annettu Netvisorissa tunniste.
​
Mikäli tunniste on annettu, tällöin myös DimensionItem -elementti palauttaa laskentakohteen tunnisteen nimen yhteydessä.

12.12.2024

Uusi elementti InCollectionProhibitation

Vastaussanomassa palautetaan nyt tieto siitä onko asiakas perintäkiellossa.

9.10.2025

Uudet parametrit

CustomTags ja AutomationRule

Vastasiko tämä kysymykseesi?