Hoppa till huvudinnehåll

Resurser – Inköpsfakturor och Leverantörer

För import av inköpsfaktura över gränssnittet debiteras alltid en transaktionsavgift för nätfaktura.

Observera följande begränsningar när du planerar att hantera inköpsfakturor över gränssnittet:

  • Endast en bilaga kan importeras över gränssnittet för inköpsfakturor, vilken behandlas som en bild på inköpsfaktura.

  • Leverantörsinformationen uppdateras inte automatiskt utgående från inköpsfakturainformationen.

Inköpsfakturor kan även importeras i större partier. Anvisningar för import av större partier hittar du här.

Följande resurser hör till bearbetning av inköpsfakturor och inköpsorder:

Beskrivning

Schema

Netvisor-schematyper

Inköpens schematyper


Hämta inköpsfakturalista

Resurs: purchaseinvoicelist.nv

Parametrar som används i anropet:

Parameter

Förekomster

Beskrivning

Exempel

begininvoicedate

0...1

Inköpsfakturor fr.o.m. datum

2019-05-20

endinvoicedate

0...1

Inköpsfakturor t.o.m. datum

2019-05-30

invoicenumber

0...1

Inköpsfakturans nummerbegränsning

1001

invoicestatus

0...1

Inköpsfakturans statusbegränsning

- Open, Approved = i godkännande

- Accepted = godkänd

Open

lastmodifiedstart

0...1

Hämtar inköpsfakturor som ändrats efter angivet datum. Ska ges i formatet yyyy-MM-ddTHH:mm:ss

2019-05-15T12:00:00

lastmodifiedend

0...1

Hämtar inköpsfakturor som ändrats före angivet datum. Ska ges i formatet yyyy-MM-ddTHH:mm:ss

2019-05-15T18:30:00

purchaseinvoicebatchid

0...1

Begränsar försäljningsfakturorna som importerats i försäljningsfakturapartiet enligt parti-ID. Se beskrivning av hantering av inköpsfakturapartier.

123

Svar:

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

root

Root

Aggregat

1

1

PurchaseInvoiceList

Aggregat

1

2

PurchaseInvoice

Aggregat

0...n

3

NetvisorKey

Numerisk

1

Fakturans identifierare i Netvisor

123

3

InvoiceNumber

Teckensträng

1

Fakturans nummer

345

3

InvoiceDate

Datum

1

Fakturadatum

2013-10-23

Attr.

format

Teckensträng

1

Datumformat, alltidansi

ansi

3

Vendor

Teckensträng

1

Leverantörens namn

Vendor Oy Ab

3

VendorOrganizationIdentifier

Numerisk

1

Leverantörens FO-nummer

1234567-8

3

Sum

Numerisk

1

Fakturans totala belopp

100,00

3

Payments

Numerisk

1

Fakturans betalade summa

30,50

3

OpenSum

Numerisk

1

Fakturans öppna summa

69,50

3

Uri

Teckensträng

1

URI varifrån fullständiga uppgifter om fakturan kan hämtas

/getpurchaseinvoice.nv?netvisorkey=123


Hämta inköpsfaktura

Resurs: getpurchaseinvoice.nv Importerar detaljerade uppgifter om önskad inköpsfaktura.

Parametrar som används i förfrågan:

Parameter

Förekomster

Beskrivning

Exempel

netvisorkey

1

Fakturans identifierare i Netvisor.

123

netvisorkeylist

0...1

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

Maximilängd på begärans URI 2115 tecken.

1,2,3

version

0...1

Återställer en enskild fakturarads (PurchaseInvoiceLine) räkenskapsobjekt in i fakturaradens element

1 = Räkenskapsobjekt utanför fakturaraderna, används som standard eller om parameter inte anges

2 = Räkenskapsobjekt inne i fakturaraderna

2

include

0...1

- actions = Återställer vad man kan göra med en inköpsfaktura (sakgranska, godkänna, avvisa, klar för betalning)

- handlinghistory = Återställ inköpsfakturans behandlingshistoria

- previewimage = Återställ inköpsfakturans bild för förhandsgranskning

- invoiceimage = Återställ inköpsfakturans ursprungliga PDF-bilaga eller om den saknas PDF genererad från e-fakturameddelande

actions

omitattachments

0...1

True = Återställ inte inköpsfakturans bilagor

False = Återställ inköpsfakturans bilagor

Om inga parametrar ges = True

true

Svar:

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

root

Root

Aggregat

1

1

PurchaseInvoice

Aggregat

1

2

PurchaseInvoiceNetvisorKey

Teckensträng

1

Fakturans NetvisorID

1025

2

PurchaseInvoiceNumber

Teckensträng

1

Fakturans nummer

345

2

PurchaseInvoiceDate

Datum

1

Fakturans datum

2014-10-02

Attr.

format

Teckensträng

1

Datumformat, alltid ansi

ansi

2

PurchaseInvoiceDeliveryDate

Datum

1

Fakturans leveransdag

2014-10-04

Attr.

format

Teckensträng

1

Leveransdagens format, alltid ansi

ansi

2

PurchaseInvoiceDueDate

Datum

1

Fakturans förfallodag

2014-10-31

Attr.

format

Teckensträng

1

Förfallodagens format, alltidansi

ansi

2

PurchaseInvoiceValueDate

Datum

1

Fakturans valuteringsdag

2014-10-15

Attr.

format

Teckensträng

1

Valuteringsdag, alltidansi

ansi

2

PurchaseInvoiceReferencenumber

Teckensträng

1

Fakturans referensnummer

12594

2

PurchaseInvoiceVendorBankAccountNumber

Teckensträng

1

Leverantörens bankkontonummer

2

IsPurchaseInvoiceVendorBankAccountDeleted

Teckensträng

1

True eller False. Visar om bankkontot har raderats.

False

2

IsPurchaseInvoiceVendorBankAccountFromSEPARegion

Merkkiono

1

True eller False. Visar om bankkontot är från SEPA-området.

True

2

PurchaseInvoiceAmount

Numerisk

1

Fakturans summa med två decimaler

123,45

2

PurchaseInvoicePaidAmount

Numerisk

1

Summa som betalats av fakturan med två decimaler

100,00

2

ForeignCurrencyAmount

Numerisk

1

Fakturans valutasumma

123,45

2

ForeignCurrencyNameID

Teckensträng

1

Valutakod

EUR

2

InvoiceStatus

Teckensträng

1

Fakturastatus

Obs: återställer alltid för tillfället öppen/open, ofärdig funktionalitet

öppen/open

2

ApprovalStatus

Teckensträng

1

Fakturans godkännandestatus

ny faktura = open

sakgranskning = infactualverification

godkännande = approved

godkänd = accepted

avslagen = acceptorrejected

open

2

PurchaseInvoiceOurReference

Teckensträng

1

Vår referens

012594

2

PurchaseInvoiceYourReference

Teckensträng

1

Er referens

112594

2

PurchaseInvoiceDescription

Teckensträng

1

Fakturans tilläggsuppgift

2

VendorNetvisorKey

Numerisk

1

Leverantörens NetvisorKey

123

2

VendorOrganizationIdentifier

Teckensträng

1

Leverantörens FO-nummer

1234567-8

2

VendorCode

Teckensträng

1

Leverantörskod

23

2

VendorName

Teckensträng

1

Leverantörens namn

Vendor Oy Ab

2

VendorAddressLine

Teckensträng

1

Leverantörens adress

2

VendorPostNumber

Teckensträng

1

Leverantörens postadress

2

VendorTown

Teckensträng

1

Leverantörens postanstalt

2

VendorCountry

Teckensträng

1

Leverantörens landskod

2

Fingerprint

Teckensträng

1

Fakturans identifierare

606F6527D9CAF4BB7B69E4D616FAA78637552960A810FD3B5CC04BFEB6757D4C

2

VoucherID

Numerisk

0...1

Inköpsfaktura verifikationens NetvisorKey

1123

2

IsAccounted

Teckensträng

1

Har inköpsfakturan kontosatts

True

2

PreviewImage

Teckensträng

0...n

När parameterninclude = previewimage används

Attr

AttachmentNetvisorKey

Numerisk

1

Fakturabildens bilagas identifierare

123

2

InvoiceImage

Teckensträng

0..n

Base64-kodad fakturabild i PDF-format, när parametern include = invoiceimage används

Attr

AttachmentNetvisorKey

Numerisk

1

Fakturabildens bilagas identifierare

123

2

Attachments

Aggregat

0...1

3

Attachment

Aggregat

1...n

4

AttachmentBase64Data

Teckensträng

1

Bilagans Base64-kodade data

4

FileName

Teckensträng

1

Bilagans filnamn

Faktura12594.pdf

4

ContentType

Teckensträng

1

Bilagans MIME-typ

Application/pdf

4

Comment

Teckensträng

1

Kommentar på bilaga

2

InvoiceLines

Aggregat

0...1

3

PurchaseInvoiceLine

Aggregat

1...n

4

NetvisorKey

Numerisk

1

Produktens Netvisor-nyckel

4

LineSum

Numerisk

1

Radsumma inklusive skatt

4

LineNetSum

Numerisk

1

Radsumma skattefri

4

UnitPrice

Numerisk

1

Enhetspris (inklusive skatt)

4

VatPercent

Numerisk

1

Momsprocent

4

VatCode

Teckensträng

1

Momskod

4

Description

Teckensträng

0...1

Radförklaring

4

Unit

Teckensträng

0...1

Måttenhet

4

OrderedAmount

Numerisk

1

Antal beställda produkter

4

PurchasePrice

Numerisk

0...1

Inköpspris

4

DeliveredAmount

Numerisk

1

Antal levererade produkter

4

ProductCode

Teckensträng

1

Produktkod

4

DiscountPercentage

Numerisk

1

Rabattprocent

4

ProductName

Teckensträng

1

Artikel

4

AccountingSuggestionBookkeeping

AccountNetvisorKey

Teckensträng

0...1

Netvisorkey för kontosättningsförslagets konto

4

AccountingSuggestionBookkeepingAccount

Teckensträng

0...1

Kontosättningsförslagets konto

4

PurchaseInvoiceDimensions

Aggregat

0...1

Nivåer 4 -5 -6 när versionens parameter är 2

I övriga fall nivå 3-4-5

5

Dimension

Aggregat

1...n

6

DimensionName

Teckensträng

1

Räkenskapsobjektsrubrik

Project

6

DimensionNameNetvisorKey

Teckensträng

1

Räkenskapsobjektets rubrik-ID

2

6

DimensionDetailName

Teckensträng

1

NULL

Project 1

6

DimensionDetailNameNetvisorKey

Teckensträng

1

Räkenskapsobjektets NetvisorID

95

2

LinkedPurchaseOrders

Aggregat

0...1

Om inköpsorder har fogats till inköpsfakturan returneras deras nummer och ID:n

3

PurchaseOrder

Aggregat

1...n

4

OrderNumber

Teckensträng

1

Inköpsorderns nummer

123

4

NetvisorKey

Teckensträng

0...1

Inköpsorderns NetvisorID

Obs! Om numret på inköpsordern har matats in på inköpsfakturan i förväg hittas inköpsordern inte ännu i systemet

10

När parametern actions används läggs följande struktur till slutet av meddelandet:

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

2

PostingLinesAccess

Aggregat

1

Kontosätt inköpsfaktura

3

CanEditPostingLines

Teckensträng

1

True

3

CanUserPostInvoice

Teckensträng

1

False

3

SuggestPostingByDefault

Teckensträng

1

True

3

CanEditAccountingSuggestion

Teckensträng

1

False

2

Actions

Aggregat

1

Vad kan göras åt fakturan med användarens behörighet

3

Action

Aggregat

1...n

4

Id

Teckensträng

1

Möjliga värden:

approved

accepted

reject

pay

accepted

4

Type

Teckensträng

1

Ge resurs med vilken action kan utföras

purchaseinvoicepostingdata

4

Description

Teckensträng

1

Funktionens förklaring

Bekräfta faktura

2

Alerts

Aggregat

1

Om inga larm finns visas endast tag på den övre nivån

3

Alert

Aggregat

1

4

Heading

Teckensträng

1

Rubrik

Fakturan är under låst period

4

Description

Teckensträng

1

Förklaring

Godkännande av fakturan uppdaterar inte dess uppgifter, då den tillhör en låst period

2

Notifications

Aggregat

1

Om inga notiser finns visas endast tag på den övre nivån

3

Notification

Aggregat

1

4

Heading

Teckensträng

1

Rubrik

4

Description

Teckensträng

1

Förklaring

Leverantörens bankkonto har raderats, uppdatera bankkonto

När parametern handlinghistory används läggs följande struktur till slutet av meddelandet:

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

2

HandlingHistory

Aggregat

1

Fakturans bearbetningshistorik

3

HandlingHistoryLine

Aggregat

1...n

4

Type

Teckensträng

1

Transaktion

InvoiceCreated

4

Heading

Teckensträng

1

Rubrik

Skapad

4

Description

Teckensträng

1

Förklaring

Fakturan skapad i systemet

4

Timestamp

Datum

1

Tidsstämpel

2018-01-01 09:45:49.200

Attr.

format

Teckensträng

1

Datumformat, alltidansi

ansi

4

UserName

Teckensträng

1

Av vem utfördes funktionen

Assi Asiatarkastaja

4

UserEmail

Teckensträng

0...1

Föregående användarens e-post i företaget, om den har definierats och användaren är inte "Systemet"

4

UpdatedInformationFields

Aggregat

0...n

Uppdaterade uppgifter

5

FieldName

Teckensträng

1

Tieto

Kontosatt

5

OldValue

Teckensträng

1

Gammalt värde

Nej

5

NewValue

Teckensträng

1

Nytt värde

Ja


Hämtning av bilagor till inköpsfakturor

Resurs: getattachments.nv

Återställer inköpsfakturans bilagor.

Återställer även inköpsfakturans bilaga av Finvoice-typ som bildfil, så att "bilden" av fakturan även kan visas från e-fakturorna.

Parametrar som används i anropet:

Parameter

Förekomster

Beskrivning

Exempel

attachmentsource

1

Alltid purchaseinvoice

purchaseinvoice

netvisorkey

1

Netvisor ID för inköpsfaktura som ska hämtas

123

convertpdfstoimages

0...1

Med värdet true konverteras inköpsfakturans pdf-bilagor till png bilder.

Varje pdf-sida som egen bild

true

Svar:

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

root

Root

Aggregat

1

1

Attachments

Aggregat

1

2

Attachment

Aggregat

1...n

3

AttachmentNetvisorKey

Numerisk

1

Bilagans ID i Netvisor

123

3

AttachmentPageNumber

Numerisk

1

Sidnummer

1

3

FileName

Teckensträng

1

Fakturadatum

Testbild.jpg

3

FileType

Teckensträng

1

image/png

3

Content

Teckensträng

1

Base64-kodad fil

iVBORw0KGgoAAAANSUhEUgAAB


Importera inköpsfaktura

Resurs: purchaseinvoice.nv

För import av inköpsfaktura över gränssnittet debiteras alltid en transaktionsavgift för nätfaktura.

Till inköpsfakturan kan även importeras bilagor enligt dokumentationen. Värdet på fältet InvoiceSource i bilagan måste vara finvoice för att bilagan ska kunna importeras.

Vid import av inköpsfaktura skapas ett leverantörskort om leverantörsinformationen inte finns i Netvisor. Koppling av leverantör vid import av inköpsfaktura sker på följande sätt:

  1. Hämta leverantörer där namnet överensstämmer med den inkomna fakturan och företagets FO-nummer är detsamma som på fakturan.

  2. Hämta leverantörer där företagets FO-nummer stämmer överens med den inkomna fakturan.

  3. Hämta leverantörer med vendorcode

  4. Hämta leverantörer vars namn överensstämmer med inkommen faktura.

Om inget av dessa villkor uppfylls skapas en ny leverantör i systemet.

Leverantörsuppgifterna på inköpsfakturan uppdateras inte automatiskt vid import från leverantörskortet, även om leverantören finns i Netvisors leverantörslista. Därför ska du uppge alla leverantörsuppgifterna separat på inköpsfakturameddelandet.

Inköpsfaktura som ska importeras skickas med anropet som XML (POST-data) enligt vidstående beskrivning.

Nivå

Element

Form och längd

Förekomster

Beskrivning

Exempel

Root

root

Aggregat

1

1

purchaseinvoice

Aggregat

1

2

invoicenumber

Teckensträng

1

Fakturanummer

152212

2

invoicedate

Datum

1

Fakturans datum

2019-01-01

Attr.

format

Teckensträng

1

Datumformat, alltid ansi

ansi

Attr.

findopendate

Teckensträng

0...1

Endast true

true

2

invoicesource

Teckensträng

0...1

finvoice manual, måste vara finvoice för att kunna hämta bilaga. Om Finvoice används, sker en fördröjning på cirka en minut i importen, då fakturan cirkuleras via en Finvoice-handläggare.

manual

2

valuedate

Datum

0...1

Valuteringsdag, krävs för närvarande för import av fakturor trots att den är markerad som alternativ i DTD

2019-01-15

Attr.

format

Teckensträng

1

Valuteringsdagens format, alltid ansi

ansi

2

eventdate

Datum

0...1

Registreringsdag, utifrån vilket fakturans verifikation bildas.

2018-12-31

Attr.

format

Teckensträng

1

Datumformat, alltid ansi

ansi

2

duedate

Datum

1

Fakturans förfallodag

2019-01-31

Attr.

format

Teckensträng

1

Förfallodagens format, alltid ansi

ansi

2

purchaseinvoiceonround

Teckensträng

0...1

Fakturans status, open, approved, eller accepted

open

Attr.

type

Teckensträng

1

Statustyp, alltid netvisor

netvisor

2

vendorcode

Teckensträng

0...1

Om den givits och ny leverantör skapas i samband med import, sparas den också bakom leverantören. Uppdateras inte för befintliga leverantörer

12345

2

vendorname

Teckensträng, max. 250

0...1

Leverantörens namn

Vendor Oy Ab

2

vendoraddressline

Teckensträng, max. 80

0...1

Leverantörens adress

Videgränden 5

2

vendorpostnumber

Teckensträng, max. 50

0...1

Leverantörens postnummer

53100

2

vendorcity

Teckensträng, max. 50

0...1

Leverantörens postanstalt

Villmanstrand

2

vendorcountry

Teckensträng, max. 50

0...1

Leverantörens landskod

FI

2

vendorphonenumber

Teckensträng, max. 80

0...1

Leverantörens telefonnummer

2

vendorfaxnumber

Teckensträng, max. 80

0...1

Leverantörens faxnummer

2

vendoreMail

Teckensträng, max. 80

0...1

Leverantörens e-postadress

2

vendorhomepage

Teckensträng, max. 80

0...1

Leverantörens webbadress

2

amount

Numeric

1

Fakturans summa med två decimaler

100,00

2

accountnumber

Teckensträng

0...1

Leverantörens kontonummer. Använd alltid IBAN-formatet när det är ett IBAN-land. Tilläggsuppgifter.

FI000111234567

2

organizationidentifier

Teckensträng

0...1

Leverantörens FO-nummer

123456-7

2

deliverydate

Datum

0...1

Leveransdatum

2019-01-01

Attr.

format

Teckensträng

1

Leveransdatumets format, alltid ansi

ansi

2

overduefinepercent

Numerisk

0...1

Dröjsmålsavgiftsprocent

5

2

bankreferencenumber

Text, max. 70

0...1

Bankens referensnummer eller inköpsfakturans meddelande

011234

2

ourreference

Text, max. 200

0...1

Vår referens

111234

2

yourreference

Text, max. 200

0...1

Er referens

211234

2

currencycode

Text

0...1

Valutakod, utöver valutakod ska du hämta bankkontouppgifter till meddelandet så att valutan beräknas korrekt.

GBP

2

deliveryterms

Text, max. 255

0...1

Leveransvillkor

2

deliverymethod

Text, max. 255

0...1

Leveranssätt

2

comment

Text, max. 255

0...1

Kommentar

2

checksum

Text

0...1

Kontroll

2

pdfextrapages

Numerisk

0...1

2

readyforaccounting

Numerisk

0...1

Om värdet 1 anges, bildar Netvisor automatiskt en verifikation. Om du inte ger ett värde görs kontosättningen manuellt i Netvisor

1

2

primaryvendormatchtype

Teckensträng

0...1

Den primära leverantörstilldelningen kan ställas in efter värde.

Tillåtna värden:

- code

- name

- organizationid

Om ingen leverantör kan hittas baserat på det angivna värdets fält, iakttas normal ordning för leverantörskoppling.

2

purchaseinvoicelines

Aggregat

1

3

purchaseinvoiceline

Aggregat

1...n

4

productcode

Text, max. 50

0...1

Produktkod

15243

4

productname

Text, max. 200

1

Produktnamn

Kan även lämnas tomt.

Exempelprodukt

4

orderedamount

Numerisk

0...1

Antal beställda produkter

15

4

deliveredamount

Numerisk

1

Antal levererade produkter

10

4

unitname

Text

0...1

Måttenhet. Visas inte i Netvisor på inköpsfaktura,men återställs om inköpsfaktura hämtas från Netvisor med resursen getpurchaseinvoice.nv

st.

4

unitprice

Numerisk

1

Produktens enhetspris inklusive skatt

5,48

4

discountpercentage

Numerisk

0...1

Rabattprocent

1,5

4

vatpercent

Numerisk

1

Momsprocent

24

4

linesum

Numerisk

1

Avrundning till två decimaler

125,25

Attr.

type

Text

1

Alltid brutto

brutto

4

description

Text, max. 200

0...1

Beskrivning

4

sort

Numerisk

0...1

Importens radordningsnummer

1

4

accountingsuggestion

Numerisk

0...1

Kontosättningsförslag. Om detta inte givits används leverantörens standardkontosättningskonto. Momsnummer fastställs på kontosättningsraderna utgående från det som har placerats bakom kontot i Netvisor.

4000

4

dimension

0...n

5

dimensionname

Text, max. 50

1

Räkenskapsobjektsrubrik Om det inte finns en rubrik grundar systemet den

Projekt

5

dimensionitem

Text, max. 200

1

Räkenskapsobjekt. Om objektet inte hittas i systemet grundar systemet det

Projekt 1

2

purchaseinvoicecommentlines

0...1

Kommentarsrad

3

purchaseinvoicecommentline

1...n

4

comment

1

Kommentar

Text

4

sort

0...1

2

purchaseinvoiceattachments

Aggregat

0...1

Netvisor behandlar bilagan som en fakturabild. Endast PDF-filer tillåtna.

3

purchaseinvoiceattachment

Aggregat

1...n

4

mimetype

Teckensträng

1

Bilagans mime-typ

Application/pdf

4

attachmentdescription

Teckensträng

1

Bilagans beskrivning

Faktura 11234

4

filename

Teckensträng

1

Bilagans filnamn

Faktura11234.pdf

4

documentdata

Teckensträng

1

Bilagans data i Base64-format

S89O3Ly1Lr59NBAttr.

Attr.

documenttype

Teckensträng

0...1

Bilagetyp. invoiceimage (bild på faktura) eller otherattachment (annan bilaga). Invoiceimage som standard. Av de många bilagorna av invoiceimage-typ visas bara den första. Om du vill importera mer än en bilaga till fakturan måste de vara av typen otherattachment.

otherattachment


Uppdatera inköpsfakturans godkännandestatus och kontosätt

Resurs: purchaseinvoicepostingdata.nv

Resursen kan användas för att avvisa, sakgranska eller godkänna en inköpsfaktura och för att göra en kontosättning. Vid import kan du även uppge kontosättningsraderna på nytt, det vill säga redigera raderna genom det och kontosätta inköpsfakturaraden som flera kontosättningsrader.

När en resurs anropas, kontrolleras kontosättningsrättigheterna för innehavaren av de i meddelandet fastställda programgränssnittskoderna.

Inköpsfaktura som man vill sakgranska, godkänna eller avvisa måste ha statusen öppen. Raddata är samma som i inköpsfakturameddelandet, raddata som importeras ersätter raddata på inköpsfakturan. Summorna i raduppgifterna måste stämma överens med inköpsfakturans summa, annars stoppas importen till följd av ett fel.

Inköpsfakturan kan konteras utan att ändra status genom att ange IsReadyForAccountingi element 1 och utelämna elementet Status. Beroende på inköpsfakturans status kommer detta antingen att preliminärt kontosätta eller kontosätta fakturan, såsom via användargränssnittet.

Du kan redigera, lägga till och radera kontosättningsrader i inköpsfakturan, om fakturan har status: Ny faktura, Sakgranskad, Godkänd eller Kontosatt. Summan av kontosättningsraderna ska vara samma som fakturans ursprungliga summa. Fakturan får inte vara under en spärrad period.

Om man vill sakgranska, godkänna eller kontosätta en inköpsfaktura, ska användaren av programgränssnittet ha nödvändig behörighet. Användaren bör ha minst en användarprofil för inköpsreskontra.

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

Nivå

Element

Form och längd

Förekomster

Beskrivning

Exempel

root

Root

Aggregat

1

1

PurchaseInvoicePostingData

Aggregat

1

2

PurchaseInvoiceNetvisorKey

Numerisk

1

Inköpsfakturans ID

31646

2

Status

Teckensträng

1

Inköpsfakturans status (status) i vilken ordning de kan ges:

contentsupervisorrejected = förkastad vid sakgranskning

approved = sakgranskad

acceptorrejected = förkastad vid godkännande

accepted = godkänd



Inköpsfakturans status kan inte längre uppdateras till tidigare status eller ges samma status som redan finns på inköpsfakturan.

approved

2

EventDate

Datum

0...1

Bokföringsdag

2019-01-15

Attr.

Format

Teckensträng

1

Bokföringsdagens format, alltid ansi

ansi

2

IsReadyForAccounting

Numerisk

1

Om värdet 1 anges, bildar Netvisor automatiskt en verifikation.

Om du inte ger ett värde görs kontosättningen manuellt i Netvisor

1

2

Comment

Teckensträng, max. 3000 tecken

0...1

Inköpsfakturans kommentar

Kommentar

3

PurchaseInvoicePostingLine

Aggregat

0...n

4

purchaseinvoicelinenetvisorkey

Numerisk

0...1

Inköpsfakturaradens NetvisorID

12345

4

ProductCode

Teckensträng

0...1

Produktkod

123

4

ProductName

Teckensträng

1

Produktnamn. Kan utelämnas genom att ange elementet tomt, men om inköpsfakturaraden innehåller en artikel kommer värdet att skrivas över som tomt.

Exempelprodukt

4

OrderedAmount

Numerisk

0...1

Antal beställda produkter

4

DeliveredAmount

Numerisk

1

Antal levererade produkter

4

UnitName

Teckensträng

0...1

Måttenhet

st.

4

UnitPrice

Numerisk

1

Enhetspris

4

DiscountPercentage

Numerisk

0...1

Rabattprocent

4

VatPercent

Numerisk

1

Momsprocent

Attr.

vatcode

Teckensträng

1

Momsnummer

4

LineSum

Numerisk

1

Avrundning till två decimaler

Attr.

type

Teckensträng

1

Endast gross = "brutto"

gross

4

Description

Teckensträng, max. 200 tecken

0...1

Beskrivning

4

Sort

Numerisk

0...1

Importens radordningsnummer

1

4

AccountingSuggestion

Numerisk

0...1

Kontosättningsförslag, om det inte givits används leverantörens standardkontosättningskonto.

4

Dimension

Aggregat

0...n

5

DimensionName

Teckensträng

1

Räkenskapsobjektsrubrik

5

DimensionItem

Teckensträng

1

NULL


Import av sakgransknings- och godkännandecirkulation

Resurs: purchaseinvoicecirculation.nv

Resursen kan användas för att ställa in, redigera eller radera inköpsfakturans sakgransknings- och godkännandecirkulation.

Identifiering av de personer som ska cirkuleras sker på basis av e-postadressen. Om en person har en e-postadress inställd i Netvisors egna Grundinställningar under Företagsspecifika undantag, ska den e-postadressen användas. Personens e-postadress måste vara unik inom företaget.

Personen som fastställs för cirkulering måste ha tillräckliga reskontrarättigheter i Netvisor för att kunna fungera i den rollen. Dessutom får inte någon leverantörs- eller summagräns utgöra ett hinder för fastställandet. OBS! Användaren av gränssnittet måste ha reskontrarättighet för fastställare av cirkulering.

Gränssnittsresursen kan användas för att fastställa cirkulering för flera inköpsfakturor samtidigt. Om resursen returnerar svaret OK, har fastställandet av alla cirkulationer lyckats. Om ett fel returneras, fastställs ingen cirkulering. I svaret återställs elementet ValidDataIdentifier för varje faktura som kunde ha cirkulerats utan en felsituation.

Cirkulering avlägsnas genom att sakgranskarna och godkännaren inte hämtas till fakturan.

Den sista sakgranskaren blir fakturans huvudsakgranskare.

Fastställande av cirkulationslistor eller en tvingad sakgranskningscirkulering stöds inte. Om inköpsfakturan redan har en cirkulering och någon av personerna i cirkuleringen har godkänt eller sakgranskat fakturan, kan cirkuleringen inte längre ändras via gränssnittet.

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

Nivå

Element

Form och längd

Förekomster

Beskrivning

Exempel

root

Root

Aggregat

1

1

purchaseinvoicecirculations

Aggregat

1

2

purchaseinvoicecirculation

Aggregat

1...n

Cirkulera en inköpsfaktura

3

invoiceidentifier

Aggregat

1

Inköpsfaktura-ID, antingen ID eller fakturanummer

4

netvisorkey

Numerisk

0...1

Inköpsfakturans ID

123

4

invoicenumber

Teckensträng

0...1

Fakturanummer

123

3

factualverificator

Aggregat

0...n

Inköpsfakturans sakgranskare

4

email

Teckensträng

1

E-postadress

3

approver

Aggregat

0...1

Inköpsfakturans godkännare

4

email

Teckensträng

1

E-postadress

hannu.hyväksyjä@yritys.com

3

comment

Teckensträng, max. 250

0...1

Kommentar för behandlingshistorik

Sakgranskare och godkännare har ställts in av utomstående integration X.


Periodisera inköpsfaktura

Resurs: purchaseinvoiceaccrual.nv

En inköpsfaktura kan periodiseras genom att ange start- och sluttid eller starttid och fördelningskurva. Datum anges i par (månad-år). Sluttiden för periodiseringen kan inte infalla före starttiden och starttiden kan vara tidigast samma månad som fakturans bokföringsdag. En faktura som ska periodiseras får inte vara kontosatt. En inköpsfaktura kan inte periodiseras till en spärrad period.

Om en fördelningskurva används, kan månatliga procentsatser anges för periodiseringen. Om start- och sluttidpunkt används, periodiseras de med lika procent under den givna tidsperioden. Till exempel 3/2021-4/2021 periodiserar fakturaraderna till mars och april med 50 %.

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

Nivå

Element

Form och längd

Förekomster

Beskrivning

Exempel

root

Root

Aggregat

1

1

purchaseinvoiceaccrual

Aggregat

1

Periodisering av inköpsfaktura

2

invoiceidentifier

Aggregat

1

Inköpsfaktura-ID, antingen ID eller fakturanummer

3

netvisorkey

Numerisk

0...1

Inköpsfakturans ID

123

3

invoicenumber

Teckensträng

0...1

Fakturanummer

123

2

accrualrule

Aggregat

1

Periodiseringsregel

3

startmonth

Numerisk

1

Periodiseringens begynnelsemånad

12

3

startyear

Numerisk

1

Periodiseringens begynnelseår

2021

3

divisioncurvename

Teckensträng, max. 250

0...1

Fördelningskurvans namn (måste vara individuellt)

Avskrivningar

3

endmonth

Numerisk

0...1

Periodiseringens avslutningsmånad

12

3

endyear

Numerisk

0...1

Periodiseringens avslutningsår

2021


Importera leverantör

Resurs: vendor.nv

Du kan hämta en ny leverantör och redigera existerande leverantör

Vid import av en leverantör returnerar gränssnittet leverantörens NetvisorKey med ett svarsmeddelande. Vi rekommenderar att du sparar denna om du behöver redigera eller hämta din leverantörsinformation senare. NetvisorKey kan tillsvidare inte hämtas över gränssnittet med hjälp av leverantörslistan. I Netvisors användargränssnitt får du veta leverantörens NetvisorKey genom att öppna leverantörskortet och kolla i adressraden under 'id' (t.ex. id = 123).

Meddelande kan användas för att importera uppgift om leverantörens bankkonton. Bankkontona är uppdelade i inhemska och utländska bankkonton. Bankkontona har olika innehåll:

  • Om bankkontoramen inte innehåller ett eget NetvisorKey-värde, ska du lägga till ett nytt bankkonto till leverantören. Om NetvisorKey hittas redigerar du bankkontot.

  • I fältet IsDefault på bankkontot kan kontot fastställas som standardkonto. Om mer än ett True-värde anges, fastställs det i ordningen sista kontot som standardkonto.

Parametrar som används i anropet:

Parameter

Form

Förekomster

Beskrivning

method

Teckensträng

1

Add Lägg till ny leverantör

Edit Redigera befintlig leverantör

netvisorkey

Numerisk

0...1

Leverantörens NetvisorKey

Obligatorisk om method = edit

Data om en girering En inköpsbetalning som ska importeras skickas med anropet som XML (POST-data) enligt beskrivningen nedan.

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

Root

root

Aggregat

1

1

vendor

Aggregat

1

2

vendorbaseinformation

Aggregat

1

3

code

Teckensträng

0...1

Leverantörskod

123

3

name

Teckensträng

1

Leverantörens namn

Testleverantör

3

address

Teckensträng

1

Adress

Toimittajakatu 1

3

postcode

Teckensträng

1

Postkod

00100

3

city

Teckensträng

1

Stad

Helsingfors

3

country

Teckensträng

1

Landskod

FI

Attr.

type

Teckensträng

1

Landskodens typ

ISO-3166

3

organizationid

Teckensträng

0...1

FO-nummer

123456-7

3

groupname

Teckensträng

0...1

Leverantörsgrupp

The leverantörer

3

vendorbankaccounts

Aggregat

0...1

Leverantörens bankkonton

4

vendordomesticbankaccounts

Aggregat

0...1

5

vendordomesticbankaccount

Aggregat

0...8

Finska bankkonton

6

netvisorkey

Numerisk

0...1

Bankkontots NetvisorKey

1

6

iban

Teckensträng

1

Mottagarens kontonummer i IBAN format

FI7536359370000661

6

bankname

Teckensträng

1

Bankens namn

Testbank

6

isdefault

Teckensträng

0...1

Använd som standard

True

4

vendorforeignbankaccounts

Aggregat

0...1

5

vendorforeignbankaccount

Aggregat

0...8

Utländska bankkonton

6

netvisorkey

Numerisk

0...1

Bankkontots NetvisorKey

2

6

bban

Teckensträng

1

Kontonummer i BBAN-format

GB29NWBK60161331926819

6

bicswift

Teckensträng

1

BIC-nummer

BUKBGB22

6

bankname

Teckensträng

1

Bankens namn

Barclays

6

clearingcode

Teckensträng

0...1

Clearingkod

6

clearingnumber

Teckensträng

0...1

Clearingnummer

6

bankaddresss

Teckensträng

0...1

Bankens adress

Bank Street 1

6

country

Teckensträng

1

Landskod

GB

Attr.

type

Teckensträng

1

Landskodens typ

ISO-3166

6

currencycode

Teckensträng

1

Valutakod

GBP

Attr.

type

Teckensträng

1

Valutakodens typ

ISO-4217

6

isdefault

Teckensträng

0...1

Använd som standard

False

6

includeaddresssinforeignpayments

Teckensträng

0...1

Utöver BIC-koden överför även bankens adressuppgifter till betalningsmeddelandet.

True

2

vendorcontactdetails

Aggregat

0...1

Leverantörens kontaktuppgifter

3

phonenumber

Teckensträng

0...1

Telefonnummer

+35850123456

3

email

Teckensträng

0...1

E-post

3

faxnumber

Teckensträng

0...1

Fax

3

contactpersonname

Teckensträng

0...1

Kontaktpersonens namn

Timo Testare

3

contactpersonphonenumber

Teckensträng

0...1

Kontaktpersonens telefonnummer

+35840987654

3

contactpersonemail

Teckensträng

0...1

Kontaktpersonens

3

homepage

Teckensträng

0...1

Webbplats

3

comment

Teckensträng

0...1

Kommentar

No comments

2

vendoradditionalinformation

Aggregat

0...1

3

defaultvatpercent

Numerisk

0...1

Standardmomssats

24

3

ispartialvatreduceprivileged

Teckensträng

0...1

Endast partiell momsavdragsrätt

False

3

paymenttermdiscountpercent

Numerisk

0...1

Rabattprocent

3

paymenttermcashdiscountdays

Numerisk

0...1

Rabatt dagar

3

paymenttermnetdays

Numerisk

0...1

Standardbetalningsvillkor

3

currencycode

Valutakod

0...1

Standardvaluta

EUR

Attr.

type

Teckensträng

1

Valutakodens typ

ISO-4217

3

vendordimensions

Aggregat

0...1

Standardräkenskapsobjekt

4

dimension

Aggregat

1

5

dimensionname

Teckensträng

1

Räkenskapsobjektsrubrik

Project

5

dimensionitem

Teckensträng

1

NULL

Project 1

3

vendoraccountingaccounts

Aggregat

0...1

Leverantörens bokföringskonton

4

vendoraccountingaccount

Aggregat

1...n

5

accountnumber

Teckensträng

1

Bokföringskonto

4000

5

isdefault

Teckensträng

1

Använd som standard

True

3

vendoracceptancedetails

Aggregat

0...1

Sakgranskare

4

vendoracceptancedetail

Aggregat

1...n

5

acceptancename

Teckensträng

0...1

Sakgranskarens namn

Dag Granskare

5

isdefault

Teckensträng

0...1

Använd som standard

False

5

isforced

Teckensträng

0...1


Importera leverantörens uppgifter

Resurs: getvendor.nv

Returnerar leverantörens uppgifter. Leverantörsinformationen hämtas på basis av NetvisorKey eller ändringstidstämpeln. Du kan hämta leverantörernas NetvisorKey:n över gränssnittet genom att använda ändringstidsstämpel.

I Netvisors användargränssnitt får du veta leverantörens NetvisorKey genom att öppna leverantörskortet och kolla i adressraden under 'id' (t.ex. id = 123).

Parametrar som används i anropet:

Parameter

Förekomster

Beskrivning

Exempel

netvisorkey

1

Leverantörens identifierare i Netvisor

Rotelementet i svaret är "vendor"..

1

netvisorkeylist

0...1

Returnerar uppgifter om leverantörer i en begäran.

Observera att du ska hitta en leverantör med alla ID:n som du anger, annars är svaret ett felmeddelande: "Hittar inte leverantör, netvisorkey NNN"

Rotelementet i svaret är "vendors", om det finns flera ID:n i den angivna listan, men "vendor" om endast ett ID anges.

1,2,3

changedsince

0...1

Filtrerar leverantörer med ändringar efter givet datum. Datumet anges i formatet YYYY-MM-DD eller med tidsstämpel YYYY-MM-DDTHH:MM:SS.

Rotelementet i svaret är "vendors", om det finns flera ID:n i listan. Om det inte finns några ändrade leverantörer, är innehållet i elementet vendors tomt.

Om du vill hämta hela leverantörslistan kan du som parameterns datum ange: getvendor.nv?changedsince=1970-01-01

page

0...1

Ett numeriskt värde som kan användas för att hämta leverantörsuppgifter från 500 leverantörssidor. Varje sida måste hämtas med ett eget anrop.

Sidväxlingsinformationen återställs i header-uppgifterna på gränssnittets svarsmeddelande. Exempel:

X-Netvisor-Pagination-Current-Page : 2

X-Netvisor-Pagination-Previous-Page : 1

X-Netvisor-Pagination-Next-Page : 3

X-Netvisor-Pagination-Limit : 100

X-Netvisor-Pagination-Total-Count : 1000

2

Svar:

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

Root

root

Aggregat

1

1

vendor

Aggregat

1

Rotelementet kan vara "vendor" eller "vendors", se parameterbeskrivningarna för detaljerade anvisningar.

2

NetvisorKey

Numerisk

1

Leverantörens NetvisorKey

123

2

vendorbaseinformation

Aggregat

1

3

code

Teckensträng

0...1

Leverantörskod

123

3

name

Teckensträng

1

Leverantörens namn

Testleverantör

3

address

Teckensträng

1

Adress

Toimittajakatu 1

3

postcode

Teckensträng

1

Postkod

00100

3

city

Teckensträng

1

Stad

Helsingfors

3

country

Teckensträng

1

Landskod

FI

Attr.

type

Teckensträng

1

Landskodens typ

ISO-3166

3

organizationid

Teckensträng

1

FO-nummer

1234567-8

3

groupname

Teckensträng

0...1

Leverantörsgrupp

The leverantörer

3

vendorbankaccounts

Aggregat

0...1

Leverantörens bankkonton

4

vendordomesticbankaccounts

Aggregat

0...1

5

vendordomesticbankaccount

Aggregat

0...8

Finska bankkonton

6

netvisorkey

Numerisk

0...1

Bankkontots NetvisorKey

1

6

iban

Teckensträng

1

Kontonummer i IBAN-format

FI7536359370000661

6

bankname

Teckensträng

1

Bankens namn

Testbank

6

isdefault

Teckensträng

0...1

Använd som standard

True

4

vendorforeignbankaccounts

Aggregat

0...1

Utländska bankkonton

5

vendorforeignbankaccount

Aggregat

0...8

Utländskt kontonummer

6

netvisorkey

Numerisk

0...1

Bankkontots NetvisorKey

2

6

iban

Teckensträng

1

Kontonummer i IBAN-format

GB29NWBK60161331926819

6

bicswift

Teckensträng

1

BIC-nummer

BUKBGB22

6

bankname

Teckensträng

1

Bankens namn

Barclays

6

clearingcode

Teckensträng

0...1

Clearing kod

6

clearingnumber

Teckensträng

0...1

Clearing nummer

6

bankaddresss

Teckensträng

0...1

Bankens adress

Bank Street 1

6

country

Teckensträng

1

Landskod

GB

Attr.

type

Teckensträng

1

Landskodens typ

ISO-3166

6

currencycode

Teckensträng

1

Valutakod

GBP

Attr.

type

Teckensträng

1

Valutakodens typ

ISO-4217

6

isdefault

Teckensträng

0...1

Använd som standard

False

6

includeaddresssinforeignpayments

Teckensträng

0...1

Utöver BIC-koden överför även bankens adressuppgifter till betalningsmeddelandet.

True

2

vendorcontactdetails

Aggregat

0...1

Leverantörens kontaktuppgifter

3

phonenumber

Teckensträng

0...1

Telefonnummer

+35850123456

3

email

Teckensträng

0...1

E-post

3

faxnumber

Teckensträng

0...1

Fax

3

contactpersonname

Teckensträng

0...1

Kontaktpersonens namn

Timo Testare

3

contactpersonphonenumber

Teckensträng

0...1

Kontaktpersonens telefonnummer

+35840987654

3

contactpersonemail

Teckensträng

0...1

Kontaktpersonens

3

homepage

Teckensträng

0...1

Webbplats

3

comment

Teckensträng

0...1

Kommentar

No comments

2

vendoradditionalinformation

Aggregat

0...1

3

defaultvatpercent

Numerisk

0...1

Standardmomssats

24

3

ispartialvatreducedprivileged

Teckensträng

0...1

Endast partiell momsavdragsrätt

False

3

paymenttermdiscountpercent

Numerisk

0...1

Rabattprocent

2,5

3

paymenttermcashdiscountsdays

Numerisk

0...1

Rabattdagar

14

3

paymentermnetdays

Numerisk

0...1

Standardbetalningsvillkor

3

3

currencycode

Valutakod

0...1

Standardvaluta

EUR

Attr.

type

Teckensträng

1

Valutakodens typ

ISO-4217

3

vendordimensions

Aggregat

0...1

Standardräkenskapsobjekt

4

dimension

Aggregat

1

5

dimensionname

Teckensträng

1

Räkenskapsobjektsrubrik

Projekt

5

dimensionitem

Teckensträng

1

NULL

Projekt 1

3

vendoraccountingaccounts

Aggregat

0...1

Leverantörens bokföringskonton

4

vendoraccountingaccount

Aggregat

1

5

accountnumber

Teckensträng

1

Bokföringskonto

4000

5

accountname

5

isdefault

Teckensträng

1

Använd som standard

True

3

vendoracceptancedetails

Aggregat

0...1

Sakgranskare

4

vendoracceptancedetail

Aggregat

1...n

5

acceptancename

Teckensträng

0...1

Sakgranskarens namn

Dag Granskare

5

isdefault

Teckensträng

0...1

Använd som standard

False

5

isforced

Teckensträng

0...1

Fick du svar på din fråga?