Behandlingen av bokföringsmaterialen är uppdelad i följande funktioner:
Integration | HTTP-metod | Resurs | DTD | Schema | Exempel |
GET | accountingledger.nv |
| |||
POST | accounting.nv | ||||
POST | accountingedit.nv | ||||
GET | accountlist.nv |
| |||
GET | accountingperiodlist.nv |
| |||
GET | vouchertypelist.nv |
Hämta bokföringsmaterial
Resurs: accountingledger.nv
Resursen kan användas för att hämta bokföringsmaterial med olika begränsningar.
Parametrar som används i anropet:
Parameter | Förekomster | Beskrivning | Exempel |
startdate | 1 | Hämtar verifikationer daterade efter ett givet datum | 2012-10-23 |
enddate | 1 | Hämtar verifikationer daterade efter ett givet datum | 2013-10-24 |
accountnumberstart | 0...1 | Hämtar verifikationer med samma kontonummer eller större än det angivna | 3000 |
accountnumberend | 0...1 | Hämtar verifikationer med samma kontonummer eller mindre än det angivna | 3500 |
changedsince | 0...1 | Hämtar nya verifikationer och sådana som har ändrats efter det angivna datumet (du behöver inte ange startdate och enddate när du använder detta) | 2013-01-01 |
lastmodifiedstart | 0...1 | Hämtar verifikationer som har ändrats efter angivet datum | 2015-09-01 |
lastmodifiedend | 0...1 | Hämtar verifikat som har ändrats före angivet datum | 2015-09-02 |
showgenerator | 0...1 | Returnerar information till verifikationen om vem som genererade verifikatet | 1 |
voucherstatus | 0...1 | Hämtar alla, endast giltiga eller raderade och ogiltiga verifikationer. <Voucher>-aggregatets statusattribut indikerar verifikationens status: "valid", "invalidated" eller "deleted" | 1 = alla |
Svar:
Nivå | Element | Form | Förekomster | Beskrivning | Exempel |
root | Root | Aggregat | 1 |
|
|
1 | Vouchers | Aggregat | 1 |
|
|
2 | Voucher | Aggregat | 0...n |
|
|
Attr. | status | Teckensträng | 0...1 | Verifikationens status | "valid", "invalidated" eller "deleted" |
3 | NetvisorKey | Numerisk | 1 | Verifikationens Netvisor-nyckel | 5 |
3 | VoucherDate | Datum | 1 | Verifikationens datum | 2013-12-05 |
3 | VoucherNumber | Numerisk | 1 | Verifikationsnummer | 515144 |
3 | VoucherDescription | Teckensträng | 1 | Beskrivning av verifikationen |
|
3 | VoucherClass | Teckensträng | 1 | Verifikationsslag | Försäljningsfaktura |
3 | LinkedSourceNetvisorKey | Numerisk | 1 | Inköps- eller försäljningsfakturans länkuppgift (fakturans Netvisor Key) | 123 |
Attr. | type | Teckensträng | 1 | Fakturans typ | purchaseinvoice eller salesinvoice |
3 | VoucherNetvisorUri | Teckensträng | 1 | Länk till verifikationen i Netvisor |
|
3 | VoucherLine | Aggregat | 0...n |
|
|
4 | NetvisorKey | Numerisk | 1 | Verifikationsradens Netvisor-nyckel | 6 |
4 | LineSum | Numerisk | 1 | Radens summa | 150,22 |
4 | Description | Teckensträng | 1 | Radbeskrivning |
|
4 | AccountNumber | Numerisk | 1 | Bokföringens kontonummer | 1701 |
4 | VatPercent | Numerisk | 1 | Momsprocent | 24 |
4 | VatCode | Teckensträng | 1 | MOMS-kod |
|
4 | AccountDimension | Teckensträng | 0...1 | Uppföljningsobjekt | Uppföljningsobjekt 1 |
Attr. | netvisorkey | Numerisk | 1 | Uppföljningsobjektets netvisorkey | 2 |
4 | Dimension | Aggregat | 0...1 |
|
|
5 | DimensionName | Teckensträng | 1 | Räkenskapsobjektsrubrik |
|
5 | DimensionItem | Teckensträng | 1 | Räkenskapsobjekt |
|
Importera bokföringsmaterial
Resurs: accounting.nv
För import av verifikationens bilaga över gränssnittet debiteras en transaktionsavgift (debitering för mottagning av e-faktura).
Genom att importera bokföringsmaterial kan du hämta verifikationer, verifikationsrader, raders räkenskapsobjekt och verifikationsbilagor. Verifikationsförfrågan måste adresseras till Accounting.nv-resursen utan parametrar. I ett anrop överförs alltid bara en verifikation. Om ingen nummeruppgift givits för verifikationen, hämtar systemet nästa nummer för den skapade verifikationen från det valda verifikationsslaget.
Verifikationsslag skapade av systemet:
Försäljningsfaktura (FF)
Försäljningsbetalning (FB)
Bank (BK)
Kassa (KT)
Importerade evenemang (PUMP)
Automatisk bokslutsbokföring (B)
Skapade av systemet (AB)
Övriga (ÖV)
Inköpsfaktura (IF)
Inköpsbetalning (IB)
Periodiseringar (P)
Lön (L)
Verifikationsslaget måste importeras med det fullständiga namnet på meddelandet, inte med verifikationsslagets förkortning. Användaren kan lägga till nya verifikationsslag i systemet manuellt.
Formatet på verifikationsradens summa, skattefritt eller inklusive skatt – väljs per verifikation. Om verifikationens räkenskapstyp är skattefri räknar systemet inte längre ut momsraderna och avrundningsskillnaderna i slutet av själva verifikationen, utan verifikationen blir exakt motsvarande som materialet. Vid bruttoberäkning beräknas alltid momsrader och avrundningsrader automatiskt av systemet.
Kontot som valts för verifikationsraden måste finnas i systemet, annars returneras INVALID_DATA-felet med förklaringar. Momskoden hämtas från det givna kontot om den inte har angetts separat. Om användaren anger en momskod som strider mot den momsprocent som valts på raden, returnerar programmet ett fel med förklaringar. Se listan över tillåtna momskoder här.
En negativ radsumma bokförs på kreditsidan och en positiv på debetsidan.
Flera räkenskapsobjekt kan fördelas till en verifikationsrad. Om rubrik- eller objektuppgifterna för ett givet räkenskapsobjekt inte hittas i systemet skapar gränssnittet dem som nya.
I samband med import av en verifikation kan du importera flera bilagor till den. Bilagor transporteras i ett XML-meddelande med base64-kodning.
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 | voucher | Aggregat | 1 |
|
|
2 | calculationmode | Teckensträng | 1 | Verifikationens beräkningsmetod. Behandlas verifikationens rader med netto- (net) eller bruttobehandling (gross) . Vid nettobehandling beräknar systemet inte automatiskt moms- och avrundningsrader | net |
2 | voucherdate | Datum | 1 | Verifikationens datum | 2009-1-1 |
Attr. | format | Teckensträng | 1 | Datumformat, alltid ansi | ansi |
2 | number | Numerisk, max. 9 | 0...1 | Verifikationsnummer Om inget nummer anges hämtar systemet nästa nummer från det valda verifikationsslaget | 1 |
2 | description | Teckensträng | 0...1 | Beskrivning av verifikationen. Det maximala antalet tecken i fältet är 255 tecken. | Beskrivning |
2 | voucherclass | Teckensträng | 1 | Verifikationsslag. Se möjliga verifikationsslag ovan (du kan även skapa egna verifikationsslag i Netvisor). | Försäljningsfaktura |
2 | voucherline | Aggregat | 0...n |
|
|
3 | linesum | Numerisk | 1 | En negativ radsumma bokförs på kreditsidan och en positiv på debetsidan. Summan behandlas med två decimalers noggrannhet. | -100,00 |
Attr. | type | Teckensträng | 0...1 | Summans typ, net (skattefri) gross (inklusive skatt) | net |
3 | description | Teckensträng | 0...1 | Beskrivning av verifikationsraden Det maximala antalet tecken i fältet är 255 tecken. | Beskrivningstext |
3 | accountnumber | Numerisk | 1 | Bokföringens kontonummer (måste finnas i systemet) | 1701 |
3 | vatpercent | Numerisk | 1 | Momsprocent, får inte stå i konflikt med vald momskod. | 24 |
Attr. | vatcode | Teckensträng | 0...1 | Momskod, Om ej angiven, hämtas momskoden bakom kontonumret. Om angiven används alltid den givna. *1) | KOMY |
3 | accountdimension | Teckensträng | 0...1 | Verifikationens uppföljningsobjekt | Uppföljningsobjekt 1 |
Attr. | type | Teckensträng | 1 | Uppföljningsobjektstyp, netvisorkey eller name | name |
3 | dimension | Aggregat | 0...n |
|
|
4 | dimensionname | Teckensträng, max. 50 | 1 | Räkenskapsobjektsrubrik | Projekt 1 |
4 | dimensionitem | Teckensträng, max. 200 | 1 | Räkenskapsobjekt | Löneberäkning |
2 | voucherattachments | Aggregat | 0...1 |
|
|
3 | voucherattachment | Aggregat | 1...n |
|
|
4 | mimetype | Teckensträng | 1 | Bilagans mime-type | Application/pdf |
4 | attachmentdescription | Teckensträng, max. 100 | 1 | Beskrivning |
|
4 | filename | Teckensträng, max. 255 | 1 | Bilagans namn | Beskrivning.pdf |
4 | documentdata | Teckensträng | 1 | base64-kodad bilaga |
|
*1) momskoder: NONE|KOOS|EUOS|EUUO|EUPO|100|KOMY|EUMY|EUUM|EUPM312|EUPM309|MUUL|EVTO|EVPO|RAMY|RAOS|EVRO|EVKV
Se även Momsbehandling och momskoder
Momskod | MOMS-kod | Momsprocent |
Ingen momsbehandling | NONE | 0 |
Inrikesförsäljning | KOMY | 0, 10, 14, 24 |
EU-försäljning | EUMY | 0 |
Försäljning utanför EU | EUUM | 0 |
Inrikesinköp | KOOS | 0, 10, 14, 24 |
EU-inköp | EUOS | 0, 10, 14, 24 |
EU-tjänsteinköp | EUPO | 0, 10, 14, 24 |
Inköp utanför EU | EUUO | 0, 10, 14, 24 |
100 % | 100 | 0 |
312 EU-tjänsteförsäljning | EUPM312 | 0 |
309 EU-tjänsteförsäljning | EUPM309 | 0, 10, 14, 24 |
Övrig momsfri omsättning (310) | MUUL | 0, 10, 14, 24 |
Varuinköp från andra EU-länder, inte avdragsgillt | EVTO | 0, 10, 14, 24 |
Tjänsteinköp från andra EU-länder, inte avdragsgillt | EVPO | 0, 10, 14, 24 |
Icke avdragsgill omvänd skatteskyldighet | EVKV | 0, 10, 14, 24 |
Omvänd skatteskyldighet | KAVE | 0, 10, 14, 24 |
Försäljning av byggtjänster | RAMY | 0 |
Köp av byggtjänster | RAOS | 0, 10, 14, 24 |
Ej avdragsgillt köp av byggtjänster | EVRO | 0, 10, 14, 24 |
Import utanför EU Moms | MAAL | 0, 10, 14, 24 |
Import utanför EU Moms icke avdr. gill | EVMA | 0, 10, 14, 24 |
KOMY 0% | KOMY0 | 0 |
Redigera bokföringsmaterial
Resurs: accountingedit.nv
Genom att redigera bokföringsmaterial kan du redigera verifikationer, verifikationsrader, radernas räkenskapsobjekt och verifikationernas bilagor i Netvisor. Ett verifikationsanrop måste riktas till resursen accountingedit.nv utan parametrar. I ett anrop överförs alltid bara en verifikation. Genom att redigera bokföringsmaterialet kan du redigera verifikationens huvuduppgifter samt verifikationsrader, men för närvarande finns det ingen historik för redigerade huvuduppgifter. Det är inte nödvändigt att ange huvuduppgifter för en verifikation på dess meddelande om endast verifikationsraderna redigeras. Genom att redigera bokföringsmaterialet makuleras verifikationens verifikationsrader. Verifikationsraderna som angivits i redigeringsmeddelandet hämtas till verifikationen som nya verifikationsrader. Om inga verifikationsraders uppgifter anges i redigeringsmeddelandet behandlas de inte alls.
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 | voucher | Aggregat | 1 |
|
|
2 | netvisorkey | Numerisk | 1 | Netvisorkey för verifikationen som ska redigeras. Netvisorkeyn kan hämtas med resursen accountingledger.nv. | |
2 | calculationmode | Teckensträng | 0...1 | Verifikationens beräkningsmetod. Behandlas verifikationens rader med netto- (net) eller bruttobehandling (gross) . Vid nettobehandling beräknar systemet inte automatiskt moms- och avrundningsrader | net |
2 | voucherdate | Datum | 0...1 | Verifikationens datum | 2009-1-1 |
Attr. | format | Teckensträng | 0...1 | Datumformat, alltid ansi | ansi |
2 | number | Numerisk, max. 9 | 0...1 | Verifikationsnummer Om inget nummer anges hämtar systemet nästa nummer från det valda verifikationsslaget | 1 |
2 | description | Teckensträng, max. 255 | 0...1 | Beskrivning av verifikationen. | Beskrivning |
2 | voucherclass | Teckensträng | 0...1 | Verifikationsslag. Se möjliga verifikationsslag ovan (du kan även skapa egna verifikationsslag i Netvisor). | Försäljningsfaktura |
2 | voucherline | Aggregat | 0...n |
|
|
3 | linesum | Numerisk | 1 | En negativ radsumma bokförs på kreditsidan och en positiv på debetsidan. Summan behandlas med två decimalers noggrannhet. | -100,00 |
Attr. | type | Teckensträng | 0...1 | Summans typ, net (skattefri) gross (inklusive skatt) | net |
3 | description | Teckensträng, max. 255 | 0...1 | Beskrivning av verifikationsraden | Beskrivningstext |
3 | accountnumber | Numerisk | 1 | Bokföringens kontonummer (måste finnas i systemet) | 1701 |
3 | vatpercent | Numerisk | 1 | Momsprocent Momsprocent, får inte stå i konflikt med vald momskod. | 24 |
Attr. | vatcode | Teckensträng | 0...1 | Momskod, Om ej angiven, hämtas momskoden bakom kontonumret. Om angiven används alltid den givna. *1) | KOMY |
3 | accountdimension | Teckensträng | 0...1 | Verifikationens uppföljningsobjekt | Uppföljningsobjekt 1 |
Attr. | type | Teckensträng | 1 | Uppföljningsobjektstyp, netvisorkey eller name | name |
3 | dimension | Aggregat | 0...n |
|
|
4 | dimensionname | Teckensträng, max. 50 | 1 | Räkenskapsobjektsrubrik | Projekt 1 |
4 | dimensionitem | Teckensträng, max. 200 | 1 | Räkenskapsobjekt | Löneberäkning |
2 | voucherattachments | Aggregat | 0...1 |
|
|
3 | voucherattachment | Aggregat | 1...n |
|
|
4 | mimetype | Teckensträng | 1 | Bilagans mime-type | Application/pdf |
4 | attachmentdescription | Teckensträng | 1 | Beskrivning |
|
4 | filename | Teckensträng | 1 | Bilagans namn | Beskrivning.pdf |
4 | documentdata | Teckensträng | 1 | base64-kodad bilaga |
|
Hämta hela kontoplanen
Resurs: accountlist.nv
Hämta hela kontoplanen och konton som används för standardkontosättning.
Svar:
Nivå | Element | Form | Förekomster | Beskrivning | Exempel |
Root | Root | Aggregat | 1 |
|
|
1 | AccountList | Aggregat | 1 |
|
|
2 | CompanyDefaultAccounts | Aggregat | 1 |
|
|
3 | TradePayables | Numerisk | 1 |
|
|
3 | PurchaseVATReceivable | Numerisk | 1 |
|
|
3 | RoundingOffDifference | Numerisk | 1 |
|
|
3 | VATpayable | Numerisk | 1 |
|
|
3 | TaxAccount | Numerisk | 1 |
|
|
3 | AdvancePayments | Numerisk | 1 |
|
|
3 | SalesReceivables | Numerisk | 1 |
|
|
3 | SalesVATdebt | Numerisk | 1 |
|
|
3 | Inventory | Numerisk | 1 |
|
|
3 | SalesDiscount | Numerisk | 1 |
|
|
3 | SalesExchangeRateDiffereces | Numerisk | 1 |
|
|
3 | Collection | Numerisk | 1 |
|
|
3 | PurchaseDiscounts | Numerisk | 1 |
|
|
3 | PurchasesExchangeRateDifferences | Numerisk | 1 |
|
|
3 | PurchaseInvoiceAccrual | Numerisk | 1 |
|
|
3 | SalesInvoiceAccrual | Numerisk | 1 |
|
|
3 | PurchaseDomesticDefault | Numerisk | 1 |
|
|
3 | PurchaseEUDefault | Numerisk | 1 |
|
|
3 | PurchaseOutsideEuDefault | Numerisk | 1 |
|
|
3 | SalesDomesticDefault | Numerisk | 1 |
|
|
3 | SalesEUDefault | Numerisk | 1 |
|
|
3 | SalesOutsideEUDefault | Numerisk | 1 |
|
|
3 | Accounts | Aggregat | 1 |
|
|
4 | Account | Aggregat | 1...n |
|
|
5 | NetvisorKey | Numerisk | 1 | Databas-ID |
|
5 | Number | Numerisk | 1 | Kontonummer |
|
5 | Name | Teckensträng | 1 |
|
|
5 | ForeignName | Teckensträng | 0...3 | I praktiken kontots namn på svenska och engelska |
|
Attr. | ISO-3166 | Teckensträng | 1 | fi|en|se |
|
5 | AccountType | Teckensträng | 1 | Kontots typ, antingen account eller accountgroup |
|
5 | FatherNetvisorKey | Numerisk | 1 | Det konto som kontot tillhör. Till exempel har kontonumret 3000 fadern kontogrupp 300 |
|
5 | IsActive | Numerisk | 1 |
|
|
5 | IsCumulative | Numerisk | 1 | Är beräkningen på kontot kumulativ. Med andra ord balanskonto |
|
5 | Sort | Numerisk | 1 |
|
|
5 | EndSort | Numerisk | 1 |
|
|
5 | IsNaturalNegative | Numerisk | 1 | exempelvis Aktiekapital |
|
Hämta räkenskapsperioder
Resurs: accountingperiodlist.nv
Söker företagets räkenskapsperioder och eventuella låsningar.
Returnerar inte data som är en aktiv period. Räknar upp alla räkenskapsperioder i systemet i ordningsföljd.
Svar:
Nivå | Element | Form | Förekomster | Beskrivning | Exempel |
Root | Root | Aggregat | 1 |
|
|
1 | AccountingPeriodList | Aggregat | 1 |
|
|
2 | PeriodLockInformation | Aggregat | 1 |
|
|
3 | AccountingPeriodLockDate | Datum | 1 | Lås period | 2014-12-31 |
Attribut | format | Teckensträng | 1 | Datumformat, alltid ansi | ansi |
3 | VatPeriodLockDate | Datum | 1 | Momslåsning | 2014-12-31 |
Attr. | format | Teckensträng | 1 | Datumformat, alltid ansi | ansi |
3 | PurchaseLockDate | Datum | 1 | Lås inköpsreskontra | 2014-12-31 |
Attr. | format | Teckensträng | 1 | Datumformat, alltid ansi | ansi |
3 | Period | Aggregat | 1...n |
|
|
4 | NetvisorKey | Numerisk | 1 | Periodens NetvisorID | 123 |
4 | Name | Teckensträng | 1 | Periodens namn |
|
4 | BeginDate | Datum | 1 | Periodens begynnelsedatum |
|
Attr. | format | Teckensträng | 1 | Datumformat, alltid ansi | ansi |
4 | EndDate | Datum | 1 | Periodens slutdatum |
|
Attr. | format | Teckensträng | 1 | Datumformat, alltid ansi |
|
Hämta verifikationsslag
Resurs: vouchertypelist.nv
Resursen kan användas för att hämta företagets verifikationsslag och standardverifikationsslag
Svar:
Nivå | Element | Form | Förekomster | Beskrivning | Exempel |
Root | Root | Aggregat | 1 |
|
|
1 | VoucherTypeList | Aggregat | 1 |
|
|
2 | DefaultVoucherTypes | Aggregat | 1 | Standardverifikationsslag |
|
3 | SalesInvoices | Aggregat | 1 | ||
4 | NetvisorKey | Numerisk | 1 | NetvisorID för standardverifikationsslaget Försäljningsfaktura | 123 |
3 | SalesInvoicePayments | Aggregat | 1 | ||
4 | NetvisorKey | Numerisk | 1 | NetvisorID för standardverifikationsslaget Försäljningsprestation | 125 |
3 | PurchaseInvoices | Aggregat | 1 | ||
4 | NetvisorKey | Numerisk | 1 | NetvisorID för standardverifikationsslaget Inköpsfaktura | 128 |
3 | PurchaseInvoicePayments | Aggregat | 1 | ||
4 | NetvisorKey | Numerisk | 1 | NetvisorID för standardverifikationsslaget Inköpsbetalning | 126 |
3 | OtherSystemGeneratedVouchers | Aggregat | 1 | ||
4 | NetvisorKey | Numerisk | 1 | NetvisorID för standardverifikationsslag som genererats av andra system | 129 |
3 | BankStatementViewVouchers | Aggregat | 1 | ||
4 | NetvisorKey | Numerisk | 1 | Standardverifikationsslagets kod för verifikationer genererade från kontoutdragsvyn | 122 |
3 | Accruals | Aggregat | 1 | ||
4 | NetvisorKey | Numerisk | 1 | NetvisorKey för periodiseringarnas standardverifikationsslag | 127 |
2 | VoucherTypes | Aggregat | 1 | Verifikationsslag | |
3 | VoucherType | Aggregat | 1...n | ||
4 | NetvisorKey | Numerisk | 1 | Verifikationsslagets NetvisorID | 121 |
4 | Abbreviation | Teckensträng | 1 | Verifikationsslagets förkortning | FF |
4 | Name | Teckensträng | 1 | Verifikationsslagets namn | Försäljningsfaktura |
4 | ForeignName | Teckensträng | 0...3 | Verifikationsslagets namn på svenska och engelska | |
Attr. | ISO-639-1 | Teckensträng | 1 | fi|en|sv |