Import av Försäljningsfaktura eller -order salesinvoice.nv

Resurs: salesinvoice.nv

HTTP-metod: POST

Gränssnittet möjliggör import eller uppdatering till Netvisor av en försäljningsfaktura, dess produkt-, kommentar- och delsummorader, bilagor, verifikatrader för fakturan samt kundspecifika fält för fakturan.

Obligatoriska fält i denna resurs är:

Fakturan kan även importeras i statusen "Luonnos" (invoicedraft). En utkastfaktura får inget fakturanummer och bokföringsverifikat kan inte importeras till utkastet. Utkastet kan uppdateras till faktura med metoden edit.

En kreditfaktura importeras via gränssnittet enligt samma meddelandestruktur som en försäljningsfaktura. Meddelandet avviker endast så till vida att kvantiteten (SalesInvoiceProductlineQuantity) och slutsumman (SalesInvoiceAmount) anges som negativa tal i meddelandet. Produktens enhetspris (Productunitprice) ska anges som ett positivt värde. Om momsbelopp (salesInvoiceProductLineVatSum) och radsumma (salesInvoiceProductLineSum) anges i försäljningsfakturans meddelande ska även dessa anges som negativa tal. En kreditfaktura som importeras via gränssnittet matchas inte automatiskt mot en befintlig försäljningsfaktura. Matchningen ska göras antingen via gränssnittet med resursen matchcreditnote.nv eller manuellt, anvisning till funktionen: Hyvityslaskun kohdistaminen veloituslaskuun

Netvisor avrundar nettosumman per rad och fakturans summa vid import via gränssnittet till två decimaler. Detta kan i vissa fall orsaka avrundningsdifferenser som måste avstämmas med ett verifikat. Om man vill undvika avrundningsdifferenser kan enhets-, rad- och momssummor importeras färdigavrundade med två decimaler.

Fakturerings- och leveranskunder kopplas till försäljningsfakturan antingen med Netvisors nyckel eller kundens egen nyckel. Netvisor-nyckeln är databas-ID:t i Netvisor och kundens egen nyckel är den kundkod användaren har gett kunden. Nycklarna fås genom att hämta kundens uppgifter med kundlista-begäran som gränssnittet erbjuder.

Om endast uppgiften invoicingcustomeridentifier importeras i meddelandet hämtas kundens fakturaadress och leveransadress från kundkortet i Netvisor. Om adresser importeras i fakturamaterialet används dessa på försäljningsfakturan.

Som fakturaspråk används det fakturaspråk (finska, svenska eller engelska) som har definierats bakom kunden i Netvisor. Det är inte möjligt att importera fakturaspråket tillsammans med försäljningsfakturans uppgifter.

Netvisors prisfaktorer och kundpriser beaktas på fakturaraderna när man anger attributet "pricetype" på elementet salesinvoiceamount i försäljningsfakturans meddelande och sätter värdet "netvisor" på pricetype. Dessutom ska värdet i elementet SalesInvoiceAmount vara 0 för att fakturans slutsumma ska beräknas korrekt utifrån radsummorna. Därutöver ska man ange attributet "type" med värdet "netvisor" på elementet productunitprice för fakturaraden och värdet i elementet productunitprice kan vara 0.

Försäljningsfakturans och försäljningsorderns PDF-bild skapas enligt Netvisors fakturamall. Det är inte möjligt att använda en egen fakturamall som fakturabild. Vid behov kan fakturabilden importeras till försäljningsfakturan som bilaga (se avsnittet salesinvoiceattachments i anvisningen).

Vid sändning av fakturan till kunden föreslår Netvisor som standard alltid den "mest elektroniska" kanalen beroende på vilka faktureringsuppgifter som har angivits på kundkortet i Netvisor. Försäljningsfakturan försöker i första hand skickas som e-faktura, i andra hand som e-postfaktura och i sista hand som pappersfaktura. Fakturans sändningskanal kan ändras i fakturans sändningsvy och denna uppgift kan inte importeras via meddelandet. E-faktura meddelandet skapas i formatet Finvoice 3.0. Adresser för e-faktura och e-postfaktura hämtas för sändning av försäljningsfakturan alltid från uppgifterna på kundkortet i Netvisor. Adresser för e-faktura och e-postfaktura kan inte importeras via försäljningsfakturans meddelande.

Om en alternativ faktureringskund har definierats på kundkortet i Netvisor för den aktuella kunden hämtar gränssnittet automatiskt fakturaadressuppgifterna till den importerade fakturan från den alternativa faktureringskunden. I detta fall används inte fakturaadressuppgifterna i materialet.

En försäljningsfaktura som har importerats i statusen Unsent kan redigeras efter import så länge fakturan inte har ett bokföringsverifikat. Om försäljningsfakturan importeras i statusen open är redigering spärrad eftersom fakturans bokföringsverifikat då skapas i samband med importen.

Periodisering av försäljningsfakturan kan göras antingen på faktura- eller radnivå och antingen med jämn fördelning eller med fördelningskurva. Periodiseringsuppgifterna kan importeras till försäljningsfakturan på en oskickad eller öppen faktura. Periodiseringsverifikaten skapas utifrån uppgifterna i meddelandet efter att fakturan har skickats, eller så skapas verifikaten för en öppen faktura automatiskt av systemet i samband med importen. Observera att periodisering för en enda månad endast är möjlig om periodiseringen inte görs till samma månad som fakturadatumets månad. Om fakturadatumets månad t.ex. är april kan periodisering göras till framtiden, dvs. till maj eller senare. Periodisering till dåtid kan inte längre göras.

Nedan beskrivs meddelandestrukturen för import av försäljningsfaktura till Netvisor:

Parametrar som används i anropet:

| Parameter | Förekomster | Beskrivning | Exempel |
| --- | --- | --- | --- |
| Method | 1 | add eller edit, samt append för försäljningsorder (order). När metoden edit används måste alla ursprungliga uppgifter för ordern/fakturan anges i meddelandet. En faktura med verifikat kan inte redigeras.
När metoden append används måste ordern ha statusen odelivered eller unfactured. I rubriken anges kompletta uppgifter, utan rader kan endast rubrikuppgifter uppdateras. Nya rader läggs till sist i ordern och läggs till i orderns slutsumma om summan (salesinvoiceamount) inte angavs i meddelandet. | edit |
| Id | 0...1 | Id för fakturan som ska uppdateras, krävs om method är edit eller append | 165 |
| useonlyexistingdimensions | 0...1 | 1 | Förhindrar automatisk skapning av nya kostnadsobjektrubriker och kostnadsobjekt. Returnerar fel om det angivna kostnadsobjektet inte finns.
​
1=spärr aktiverad |

Uppgifterna som importeras skickas med anropet som xml (POST-data) enligt beskrivningen nedan. Observera att beskrivningen är uppdelad i flera tabeller:

| Nivå | Element | Form och längd | Förekomster | Beskrivning | Exempel |
| --- | --- | --- | --- | --- | --- |
| Root | root | Aggregat | 1 | | |
| 1 | salesinvoice | Aggregat | 1 | | |
| 2 | salesinvoicenumber | Heltal, max 18 tecken | 0...1 | Fakturanummer, om inte angivet hämtar Netvisor ett nytt automatiskt. Anges inte för utkast.
​
Obs! Vid skapande av factoring-faktura måste man beakta längden på fakturanumret. Fakturanumret ska då vara 1–8 tecken långt.
​ | 123456 |
| 2 | salesinvoicedate | Datum | 1 | Fakturadatum (även valutadatum)
​ | 2020-12-31 |
| Attr. | format | Sträng | 1 | Fakturadatumets format, alltid ansi | ansi |
| 2 | salesinvoiceeventdate | Datum | 0...1 | Fakturans bokföringsdatum. Verifikatet skapas på detta datum. | 2021-01-01 |
| Attr. | format | Sträng | 1 | Bokföringsdatumets format, alltid ansi | ansi |
| 2 | salesinvoiceduedate | Datum | 0...1 | Fakturans förfallodag, obligatorisk om inget betalningsvillkor har angivits. När förfallodag anges uppdateras fakturans betalningsvillkor i Netvisor till 'Förfallodag'. Meddelandet får inte innehålla både förfallodag och betalningsvillkor, endast det ena elementet anges. | 2020-12-31 |
| Attr. | format | Sträng | 1 | Fakturans förfallodags format | ansi |
| 2 | salesinvoicevaluedate | Datum | 0...1 | Fakturans valutadatum.
Om angivet tillämpas betalningsvillkorets nettodagar på valutadatumet | 2020-12-31 |
| Attr. | format | Sträng | 1 | Valutadatumets format | ansi |
| 2 | salesinvoicedeliverydate | Datum | 0...1 | Fakturans leverans-/ankomstdag | 2020-12-31 |
| Attr. | format | Sträng | 1 | Leveransdatumets format | ansi |
| 2 | salesinvoicedeliverytocustomerdate | Datum eller veckonummer | 0...1 | Leveranstid hos kunden
Datum eller veckonummer
Endast för försäljningsorder | 2020-W12 |
| Attr. | format | Sträng | 1 | Leveranstid hos kunden, format | ansi |
| Attr. | type | Sträng | 1 | Leveranstid hos kunden
date eller weeknumber | weeknumber |
| 2 | salesinvoicewaybillidentifier | Sträng, max 35 tecken | 0...1 | Fraktsedelsnummer
Endast för försäljningsorder | 033000050143 |
| 2 | salesinvoiceproductpackagepallet | Heltal | 0...1 | Endast för försäljningsorder! Försäljningsorderns förpackning | 11 |
| Attr. | type | Sträng | 1 | Typ av pallkodsystem, GS1 | GS1 |
| Attr. | amount | Sträng | 0...1 | Antal pallar | 2 |
| 2 | salesinvoicereferencenumber | Referensnummer | 0...1 | Fakturans referensnummer, i korrekt format med kontrollsiffra.
Om inte angivet skapar Netvisor ett referensnummer till fakturan. | 1070 |
| 2 | salesinvoiceamount | Numerisk | 1 | Fakturans slutsumma inklusive eventuella skatter.
Om angivet beräknar Netvisor inte slutsumman utifrån fakturaraderna.
​
Kan anges som noll eller tom <salesinvoiceamount />, då beräknas slutsumman från fakturaraderna.
​
​Obs. om du importerar skickade fakturor rekommenderas det att importera slutsumman.
​ | 100,99 |
| Attr. | iso4217currencycode | Sträng | 0...1 | Fakturans valuta i ISO 4217-format. Standard är företagets hemvaluta. | USD |
| Attr. | currencyrate | Sträng | 0...1 | Valutakurs. Om inte angivet används Europeiska centralbankens dagskurs. Om kursen inte hittas använder systemet automatiskt värdet 1. | 1,33 |
| Attr. | pricetype | Sträng | 0...1 | Pris­typ.
​netvisor eller customer. Customer gör ingenting.
Om värdet är netvisor beaktas Netvisors prisfaktorer och kundpriser på fakturaraderna. Värdet i SalesInvoiceAmount ska vara 0 för att fakturans slutsumma ska beräknas korrekt från radsummorna. | netvisor |
| 2 | selleridentifier | Sträng | 0...1 | Säljlänkning på fakturan.
Om säljaren ska länkas till en säljare som finns i Netvisor måste både säljarens länkning och säljarens namn (elementet sellername) anges i meddelandet.
​
Netvisors säljaruppgifter kan hämtas med resursen: Myyjälistan nouto, listan returnerar netvisorkey som används vid säljlänkning. | 1 |
| Attr. | type | Sträng | 1 | Typ av säljlänkning,
​netvisor (netvisorkey) eller customer (namn)
​
Länkning kan göras med säljarens netvisorkey (primärt) eller säljarens namn. När länkning och säljarens namn importeras i meddelandet visas som säljare på fakturan namnet på säljaren vars ID motsvarar i Netvisor. Om länkning görs med namn jämförs den angivna strängen fram- och baklänges med säljlistan i Netvisor. Om säljaren inte hittas i Netvisor med netvisorkey meddelar gränssnittet att uppgifterna är bristfälliga. | netvisor |
| 2 | sellername | Sträng, max 50 | 0...1 | Säljarens namn. Om säljlänkning inte importeras i meddelandet och försäljningsfakturan redigeras efter import i Netvisor försvinner säljaruppgiften från fakturan.
​ | Matti Mallikas |
| 2 | invoicetype | Sträng | 0...1 | Typ av uppgift som importeras, invoice (försäljningsfaktura) eller order (order) eller invoicedraft (utkast). Standard är invoice | invoice |
| 2 | salesinvoicestatus | Sträng | 1 | Fakturans eller orderns status.
Status anges inte för utkast.
För faktura open eller unsent.
För order delivered eller undelivered. | open |
| Attr. | type | Sträng | 1 | Statusens format | netvisor |
| 2 | salesinvoicefreetextbeforelines | Sträng, max 500 | 0...1 | Text före fakturaraderna | |
| 2 | salesinvoicefreetextafterlines | Sträng, max 500 | 0...1 | Text efter fakturaraderna | |
| 2 | salesinvoiceourreference | Sträng, max 200 | 0...1 | Uppgiften i fältet "Vår referens" | |
| 2 | salesinvoiceyourreference | Sträng, max 200 | 0...1 | Uppgiften i fältet "Er referens" | |
| 2 | salesinvoiceprivatecomment | Sträng, max 500 | 0...1 | Interna tilläggsuppgifter, skrivs inte ut på fakturan | |
| 2 | invoicingcustomeridentifier | Sträng | 1 | Länkning av faktureringskund till kundkort. Kunden måste finnas i Netvisor. Om enbart invoicingcustomeridentifier anges hämtas kundens namn, fakturaadress och leveransadress från kundkortet i Netvisor. | MM |
| Attr. | type | Sträng | 1 | Typ av länkning: customer (=kundkod), netvisor (=Netvisors databas-id), eller organizationunitnumber (=OVT-tunnus)
​​ | customer |
| Attr. | contactpersonid | Sträng | 0...1 | Kundens kontaktpersons NetvisorID. Fås genom att hämta kundens uppgifter. | 4012 |
| 2 | invoicingcustomername | Sträng, max 250 | 0...1 | Faktureringskundens namn. Hämtas från kundkortet om uppgiften inte importeras. | Matti |
| 2 | invoicingcustomernameextension | Sträng, max 250 | 0...1 | Tillägg till faktureringskundens namn. Hämtas från kundkortet om uppgiften inte importeras. | Meikäläinen |
| 2 | invoicingcustomeraddressline | Sträng, max 100 | 0...1 | Faktureringskundens adress. Hämtas från kundkortet om uppgiften inte importeras. | Pajukuja 1 |
| 2 | invoicingcustomeradditionaladdressline | Sträng, max 100 | 0...1 | Faktureringskundens adress. Hämtas från kundkortet om uppgiften inte importeras. | |
| 2 | invoicingcustomerpostnumber | Sträng, max 50 | 0...1 | Faktureringskundens postnummer. Hämtas från kundkortet om uppgiften inte importeras. | 53100 |
| 2 | invoicingcustomertown | Sträng, max 50 | 0...1 | Faktureringskundens postanstalt. Hämtas från kundkortet om uppgiften inte importeras. | Lappeenranta |
| 2 | invoicingcustomercountrycode | Sträng | 0...1 | Faktureringskundens landuppgift. Hämtas från kundkortet om uppgiften inte importeras. | FI |
| Attr. | type | Sträng | 1 | Landkodens format | ISO-3166 |
| 2 | officeidentifier | Sträng | 0...1 | Verksamhetsställetikett, i Netvisor den kod som finns i uppgifterna för verksamhetsställe, OBS! detta är inte verksamhetsställets Netvisorkey. Verksamhetsställets kod kan anges i meddelandet, varvid motsvarande verksamhetsställe (eller första träff) söks hos kunden eller skapas vid behov (type=automatic)
OBS! Om type=automatic måste verksamhetsställets namn och alla adressuppgifter anges i meddelandet | ​ |
| Attr. | type | Sträng | 0...1 | automatic när man vill att verksamhetsstället ska skapas enligt uppgifterna i försäljningsfakturans meddelande. OBS! I detta fall måste verksamhetsställets namn och alla adressuppgifter anges i meddelandet | ​ |
| 2 | deliveryoffice | Sträng | 0...1 | Koppling till verksamhetsställe, kopplas till verksamhetsställe på kundkortet i Netvisor. Adressuppgifter är inte obligatoriska; om adressuppgifter inte anges hämtas adresserna från verksamhetsställets uppgifter.
​ | ​ |
| Attr. | type | Sträng | 1 | Typ av länkning:
​Customer = Verksamhetsställets namn
​Netvisor = Verksamhetsställets Netvisor databas-ID | ​ |
| 2 | deliveryaddressname | Sträng, max 250 | 0...1 | Leveranskundens namn, hämtas inte från Netvisor. Måste anges om leveransadress ska visas på fakturan. | Maija |
| 2 | deliveryaddressline | Sträng, max 100 | 0...1 | Leveransadress | Pajukuja 2 |
| 2 | deliveryaddresspostnumber | Sträng, max 50 | 0...1 | Postnummer för leveransadress | 55100 |
| 2 | deliveryaddresstown | Sträng, max 50 | 0...1 | Postanstalt för leveransadress | Imatra |
| 2 | deliveryaddresscountrycode | Sträng | 0...1 | Landskod för leveransadress, hämtas inte från Netvisor | FI |
| Attr. | type | Sträng | 1 | Landkodens format | ISO-3166 |
| 2 | deliverymethod | Sträng, max 50 | 0...1 | Leveranssätt. Om leveranssättet inte finns läggs det till. | Asennettuna |
| 2 | deliveryterm | Sträng, max 50 | 0...1 | Leveransvillkor. Om leveransvillkoret inte finns läggs det till. | Sopimuksen mukaan |
| 2 | salesinvoicetaxhandlingtype | Sträng | 0...1 | Skattehantering. countrygroup, forcedomestic, domesticconstructionservice eller notaxhandling *2
Om inte angivet hämtas det från kundens uppgifter | countrygroup |
| 2 | paymenttermnetdays | Numerisk | 1 | Nettodagar för betalningsvillkor, obligatoriskt om förfallodag inte angivits.
Fakturadatum + nettodagar för betalningsvillkor = fakturans förfallodag.
Betalningsvillkoret skapas enligt kundens fakturaspråk: "14 päivää netto / 14 dagar netto / 14 days net".
​
Meddelandet får inte innehålla både förfallodag och betalningsvillkor.
Betalningsvillkoret behöver inte finnas i Netvisor, det skapas vid behov automatiskt vid import.
​ | 14 |
| 2 | paymenttermcashdiscountdays | Numerisk | 0...1 | Kassarabattdagar i betalningsvillkoret. Betalningsvillkoret skapas enligt kundens fakturaspråk, t.ex.: "14 päivää netto, 5 päivää". Endast fakturaspecifikt.
​ | 5 |
| 2 | paymenttermcashdiscount | Numerisk | 0...1 | Kassarabatt i betalningsvillkoret. Betalningsvillkoret skapas enligt kundens fakturaspråk, t.ex.: "14 päivää netto, 5 päivää -10%". Endast fakturaspecifikt.
​ | 10 |
| Attr. | type | Sträng | 1 | Typ av betalningsvillkor, alltid percentage | percentage |
| 2 | paymentterm | Numerisk | 0...1 | Betalningsvillkorets NetvisorKey, obligatoriskt om förfallodag inte har angivits. Om angivet kan nettodagar, kassarabattdagar och kassarabatt inte anges separat. | 1 |
| Attr. | type | Sträng | 1 | Typ av betalningsvillkor:
​netvisor = kopplas till betalningsvillkor enligt NetvisorKey
​customerdefault = kundens standardbetalningsvillkor
​companydefault = företagets standardbetalningsvillkor
​default = kundens standardbetalningsvillkor används i första hand. Om kundens standard inte är angiven används företagets standardbetalningsvillkor | netvisor |
| 2 | expectpartialpayments | Numerisk | 0...1 | Delbetalningar. 1 = ja, 0 = nej, standard 0. Om fakturan tar emot delbetalningar matchas till fakturan även betalningar som ligger utanför toleranserna för kassarabatt. | 1 |
| 2 | overridevouchersalesreceivablesaccountnumber | Numerisk | 0...1 | Bokföringskonto som vid behov kan användas för att åsidosätta Netvisors standard kundfordringskonto. Fungerar endast för fakturor med status open. | 1703 |
| 2 | salesinvoiceagreementidentifier | Sträng,
max 35 | 0...1 | Avtalsidentifierare, hämtas inte från kundkortet | |
| 2 | printchannelformat | Sträng | 0...1 | Fakturans utskriftsformat
​netvisor: 1 eller 2
customer: Lasku + tilisiirto eller Lasku
Om inte angivet används utskriftsformatet i kundens uppgifter. | 1 |
| Attr. | type | Sträng | 1 | _netvisor eller customer | netvisor |
| 2 | secondname | Sträng | 0...1 | Bifirma | Testiaputoiminimi |
| Attr. | type | Sträng | 1 | netvisor (NetvisorKey för bifirman, dvs. Netvisors databas-ID) eller customer (bifirmans namn)
​ | customer |
| 2 | overriderateofoverdue | Numerisk | 0...1 | Dröjsmålsränteprocent, åsidosätter Netvisors standard | 5,5 |
| 2 | ordernumber | Sträng
max 70 | 0...1 | Externt ordernummer | 258741 |
| 2 | proposedaccount | Numerisk | 0...1 | Kundens bokföringskonto. I Netvisor fältet "Tiliöintiehdotus" (Försäljningsfaktura funktioner > Tilläggsuppgifter > Tiliöintiehdotus) | 1011 |
| Attr. | type | Sträng | 1 | customer | customer |
| 2 | accountdimensiontext | Sträng, max 35 | 0...1 | Kundens kostnadsställe, fakturaspecifikt. I Netvisor under försäljningsfakturans tilläggsuppgifter, fältet "Kustannuspaikkatieto". Kan även importeras på radnivå, se dokumentationen nedan. | kustannuspaikka |
| 2 | collectioncost | Numerisk | 0...1 | Indrivningskostnad. Endast positiva värden (och 0) tillåtna. Endast för försäljningsfaktura. | 15 |
| 2 | isthirdpartysales | Numerisk | 0...1 | Triangulering, 0 eller 1. 1 skapar valet "Kolmikantakauppa" i fakturans tilläggsuppgifter. Endast för försäljningsfaktura. | 1 |
| 2 | salesinvoicetaxhandlingclause | Numerisk | 0...1
​ | Skattetext på fakturan *5 Närmare anvisning för användning av detta element finns längst ner i anvisningen | ​ |
| 2 | denyinvoicecollection | Numerisk | 0...1
​ | Fakturaspecifikt indrivningsförbud, 0 eller 1. 1 sätter fakturaspecifikt indrivningsförbud. Endast för försäljningsfaktura. | ​ |
| 2 | invoicelines | Aggregat | 1 | | |

Fakturan kan ha produkt-, kommentar- och delsummorader. Kommentarrader påverkar inte försäljningsfakturans slutsumma. Produkten på en produktrad måste vara skapad i Netvisor när försäljningsfakturan importeras till Netvisor. Import av försäljningsfaktura skapar alltså inte nya produkter. Produkten på försäljningsfakturaraden länkas till en produkt i produktregistret med produktkod, netvisorkey dvs. produktens databas-ID eller produktens primära eller sekundära EAN-kod. Produktens namn, pris och andra uppgifter på fakturan kan dock ändras i Netvisor så länge inget bokföringsverifikat har skapats för fakturan.

I Netvisor finns det som standard en temporär produkt med produktkod TEMP, men denna kan inte användas via gränssnittet. Du kan dock skapa nya temporära produkter i Netvisors användargränssnitt på samma sätt som andra produkter via övre högra hörnet 'Luo uusi' > 'Tuote'.

Val av moms-kod för fakturans produktrad är obligatoriskt. Se listan över tillåtna moms-koder i anvisningen Arvonlisäveron käsittely ja järjestelmän ALV-tunnisteet eller i denna listning. Momskoden används vid skapande av verifikat enligt uppgifterna på fakturaraden när fakturan importeras till Netvisor i statusen Avoin. Om fakturan importeras i statusen Lähettämätön sparas på verifikatet den moms-kod som finns på bokföringskontot bakom produkten i Netvisor. Om skattehantering (SalesInvoiceTaxHandlingType) inte anges i försäljningsfakturans meddelande hämtas den från kundens uppgifter.

Om fakturaraderna innehåller produkt-, delsumma- och kommentarrader blir ordningen på fakturaraderna i systemet densamma som i det importerade materialet.

Periodisering kan anges per fakturarad antingen med jämn fördelning eller med fördelningskurva. Vid periodisering med jämn fördelning anges elementen endmonth och endyear, men vid periodisering med fördelningskurva anges dessa inte. Vid periodisering med fördelningskurva anges elementet divisioncurvename. Observera att periodisering för en enda månad endast är möjlig om periodiseringen inte görs till samma månad som fakturadatumets månad. Om fakturadatumets månad t.ex. är april kan periodisering göras till framtiden, dvs. till maj eller senare. Periodisering till dåtid kan inte längre göras.

Fakturaspecifika kostnadsobjekt stöds inte när försäljningsfakturor importeras via integration. Om kostnadsobjektsinformation som importeras via gränssnittet ska användas måste kostnadsobjekt användas per fakturarad (inställningen finns under Försäljning > Inställningar > Basinformation och inställningar > Försäljningens basinformation > Standardkostnadsobjekt för försäljningsfakturor > Fakturaspecifik/radspecifik). Om fakturaspecifika kostnadsobjekt ska användas måste dessa anges på försäljningsfakturorna manuellt (Försäljningsfaktura funktioner > Fakturaspecifika kostnadsobjekt). Om standardkostnadsobjekt har angetts bakom kund och produkter kommer dessa med på fakturan som importeras via gränssnittet om radspecifika kostnadsobjekt används och kostnadsobjektinformation inte har importerats i fakturameddelandet.

Strukturen för aggregatet InvoiceLine är följande när man vill importera en produktrad:

| Nivå | Element | Form och längd | Förekomster | Beskrivning | Exempel |
| --- | --- | --- | --- | --- | --- |
| 3 | invoiceline | Aggregat | 1...n | | |
| 4 | salesinvoiceproductline | Aggregat | 1 | | |
| 5 | productidentifier | Sträng | 1 | Länkning till produkt. Produkten måste vara skapad i Netvisor.
Kan vara antingen produktkod, netvisorkey dvs. produktens databas-ID eller produktens primära eller sekundära EAN-kod. | |
| Attr. | type | Sträng | 1 | Typ av länkning:
- customer (produktkod)
- netvisor (netvisorkey)
​- primaryeancode
(Produktens primära EAN-kod)
- secondaryeancode
(Produktens sekundära EAN-kod) | netvisor |
| 5 | productname | Sträng, max 200 | 1 | Produktens namn. Om elementet lämnas tomt hämtas namnet bakom produkten i Netvisor.
​
Om man vill utnyttja språkversionerna på produktkortet i Netvisor ska elementet lämnas tomt.
​ | Testituote |
| 5 | productunitprice | Numerisk, max 12 decimaler | 1 | Produktens enhetspris, hämtas inte bakom produkten. | 10,05 |
| Attr. | type | Sträng | 1 | Typ av enhetspris, net (exkl. moms) eller gross (inkl. moms)
Om Netvisors prisfaktorer och kundpriser ska beaktas på fakturaraderna ska värdet vara netvisor. Då kan värdet i productunitprice-elementet vara 0.
​ | net |
| 5 | productunitpurchaseprice | Numerisk | 0...1 | Produktens inköpspris, avrundat till två decimaler. På försäljningsfakturan fältet inköpspris.
​
Om värdet 0 importeras används inköpspriset från produktkortet i Netvisor.
​ | 1,05 |
| Attr. | type | Sträng | 1 | Typ av inköpspris, alltid net | net |
| 5 | productvatpercentage | Numerisk | 1 | Produktens momsprocent, får inte stå i konflikt med moms-koden. Momsprocenter hanteras i Netvisor: Taloushallinto > Asetukset> Kirjanpidon asetukset > Kirjanpidon ja velvotteiden asetukset > Verokantojen hallinta *1 | 24 |
| Attr. | vatcode | Sträng | 1 | Moms-kod, listning av moms-koder finns här. | KOMY |
| 5 | salesinvoiceproductlinequantity | Numerisk | 1 | Kvantitet. Kan vara heltal eller decimaltal. Max åtta decimaler (t.ex. 3,55555555). | 5 |
| 5 | salesinvoiceproductlinediscountpercentage | Numerisk | 0...1 | Rabattprocent. Om attributet netvisor anges hämtas rabattprocenten från kundkortet i Netvisor | 10 |
| Attr. | type | Sträng | ​ | netvisor, om attributet anges lämnas elementets värde tomt | netvisor |
| 5 | salesinvoiceproductlinefreetext | Sträng, max 512 | 0...1 | Fritext på produktraden (radförklaring) | Vapaata tekstiä |
| 5 | salesinvoiceproductlinevatsum | Numerisk | 0...1 | Radens momsbelopp. Anges om Netvisors beräknade momsbelopp ska ersättas. | 11,00 |
| 5 | salesinvoiceproductlinesum | Numerisk | 0...1 | Radens slutsumma inkl. moms. Anges om Netvisors beräknade radsumma ska ersättas. | 50,00 |
| | Obs! både salesinvoiceproductlinesum och salesinvoiceproductlinevatsum krävs för att de angivna beloppen ska användas. | Obs! både salesinvoiceproductlinesum och salesinvoiceproductlinevatsum krävs för att de angivna beloppen ska användas. | Obs! både salesinvoiceproductlinesum och salesinvoiceproductlinevatsum krävs för att de angivna beloppen ska användas. | Obs! både salesinvoiceproductlinesum och salesinvoiceproductlinevatsum krävs för att de angivna beloppen ska användas. | Obs! både salesinvoiceproductlinesum och salesinvoiceproductlinevatsum krävs för att de angivna beloppen ska användas. |
| 5 | salesinvoiceproductlineinventoryid | Numerisk | 0...1 | Produktens lager databas-ID för raden. | 1 |
| 5 | accountingaccountsuggestion | Numerisk | 0...1 | Förslag till kontering. Kontot måste finnas i systemet. | 3000 |
| 5 | dimension | Aggregat | 0...n | | |
| 6 | dimensionname | Sträng, max 50 | 1 | Kostnadsobjektrubrik, om rubriken inte hittas skapas den av systemet | Projekti |
| 6 | dimensionitem | Sträng max 200 | 1 | Kostnadsobjekt | Palkanlaskenta |
| 6 | dimensionitemcode | Sträng | 0...1 | Kostnadsobjektets kod
​
(när detta har angivits ignoreras elementet dimensionitem) | DIMC-001 |
| 6 | dimensionitemname | Sträng | 0...1 | Kostnadsobjektets namn
​
(när detta har angivits ignoreras elementet dimensionitem) | Item Name 1 |
| 5 | provisionpercentage | Numerisk | 0...1 | Provision i procent för fakturaraden | 12 |
| 5 | accrualrule | Aggregat | 0...1 | Radvis periodiseringsregel, kan användas antingen med jämn fördelning ELLER fördelningskurva.
​ | |
| 6 | startmonth | Numerisk | 1 | Startmånad | 9 |
| 6 | startyear | Numerisk | 1 | Startår | 2020 |
| 6 | endmonth | Numerisk | 0...1 | Slutmånad (använd endast vid periodisering med jämn fördelning) | 12 |
| 6 | endyear | Numerisk | 0...1 | Slutår (använd endast vid periodisering med jämn fördelning) | 2020 |
| 6 | divisioncurvename | Sträng | 0...1 | Fördelningskurva (använd endast vid periodisering med fördelningskurva)
Fördelningskurvan måste finnas i Netvisor. Hanteras i vyn 'Taloushallinto > Budjetoinnin asetukset > Jakokäyrät' | neljännesvuosi |
| 5 | productunitname | Sträng, max 14 | 0...1 | Produktens enhet. Om inte angivet används enheten på produktkortet i Netvisor. Gäller inte företag som använder Laajennettu tuotehallinta. | kpl |
| 5 | deliverydate | Numerisk | 0...1 | Leveransdatum för orderrad. Endast för försäljningsorder. | 2021-06-01 |
| Attr. | format | Sträng | 1 | Typ av datum, alltid ansi. | ansi |
| 5 | ordernumber | Sträng | 0...1 | I Netvisor externt ordernummer. I Finvoice-meddelandet RowIdentifier, högsta antal tecken för radspecifikt ordernummer är 35 tecken | 35
​ |
| 5 | deliveryidentifier | Sträng | 0...1 | I Netvisor leveransnummer. I Finvoice-meddelandet RowDeliveryIdentifier | 1000 |
| 5 | proposedaccount | Numerisk | 0...1 | Kundens bokföringskonto. I Netvisor på fakturaraden kundens förslag till kontering. | 1011 |
| Attr. | type | Sträng | 1 | customer | customer |
| 5 | accountdimensiontext | Sträng, max 35 | 0...1 | Kundens kostnadsställe. Kundens kostnadsställe, radvis. | kustannuspaikka |

Om en kommentarrad importeras är strukturen för aggregatet InvoiceLine följande:

Om en delsummarad ska importeras är strukturen för aggregatet InvoiceLine följande:

Efter den valda strukturen fortsätter man enligt följande:

| Nivå | Element | Form och längd | Förekomster | Beskrivning | Exempel |
| --- | --- | --- | --- | --- | --- |
| 2 | invoicevoucherlines | Aggregat | 0...1 | ​ | Anges endast om verifikat för försäljningsfakturan ska skapas via gränssnittet. I annat fall skapar Netvisor verifikatet för försäljningsfakturan. |
| 3 | calculationmode | Sträng | 0...1 | Beräkningssätt för verifikatet. Ska verifikatet behandlas brutto (gross) eller netto (net). Om elementet inte anges är standard alltid brutto (gross).
OBS! Vid nettobehandling beräknar systemet inte automatiskt moms- och avrundningsdifferensrader
​ | net |
| 3 | voucherline | Aggregat | 1...n | | |
| 4 | linesum | Numerisk | 1 | Belopp. Positivt tal bokförs i debet och negativt i kredit | 100 |
| Attr. | type | Sträng | | Typ av belopp, net (exkl. moms) gross (inkl. moms) | net |
| 4 | description | Sträng, max 255 | 0...1 | Förklaring | Förklaring |
| 4 | accountnumber | Sträng | 1 | Kontonummer. Måste finnas i systemet | 3000 |
| 4 | vatpercent | Numerisk | 1 | Momsprocent, får inte stå i konflikt med moms-koden. | 24 |
| Attr. | vatcode | Numerisk | 1 | Moms-kod | KOMY |
| 4 | accountdimension | Sträng | 0...1 | Verifikatets uppföljningsobjekt | Uppföljningsobjekt 1 |
| Attr. | type | Sträng | 1 | Typ av identifieringsuppgift för uppföljningsobjekt, netvisorkey | name |
| 5 | dimension | Aggregat | 0...n | | |
| 6 | dimensionname | Sträng | 1 | Kostnadsobjektrubrik, skapas av systemet om den inte finns | Projekti |
| 6 | dimensionitem | Sträng | 1 | Kostnadsobjektets namn | Palkanlaskenta |
| 6 | dimensionitemcode | Sträng | 0...1 | Kostnadsobjektets kod
​
(när detta har angivits ignoreras elementet dimensionitem) | DIMC-001 |
| 6 | dimensionitemname | Sträng | 0...1 | Kostnadsobjektets namn
​
(när detta har angivits ignoreras elementet dimensionitem) | Item Name 1 |
| 2 | accrualrule | Aggregat | 0...1 | Fakturaspecifik periodiseringsregel, kan användas antingen med jämn fördelning ELLER fördelningskurva.
​ | |
| 3 | startmonth | Numerisk | 1 | Startmånad | 9 |
| 3 | startyear | Numerisk | 1 | Startår | 2020 |
| 3 | endmonth | Numerisk | 0...1 | Slutmånad (använd endast vid periodisering med jämn fördelning) | 12 |
| 3 | endyear | Numerisk | 0...1 | Slutår (använd endast vid periodisering med jämn fördelning) | 2020 |
| 3 | divisioncurvename | Sträng | 0...1 | Fördelningskurva (använd endast vid periodisering med fördelningskurva)
Fördelningskurvan måste finnas i Netvisor. Hanteras i vyn 'Taloushallinto > Budjetoinnin asetukset > Jakokäyrät' | neljännesvuosi |
| 2 | salesinvoiceattachments | Aggregat | 0...1 | Mer information om maxstorlek för bilagor till e-fakturor och e-postfakturor finns i denna anvisning. | |
| 3 | salesinvoiceattachment | Aggregat | 1...n | | |
| 4 | mimetype | Sträng | 1 | Bilagans MIME-typ | Application/pdf |
| 4 | attachmentdescription | Sträng, max 100 | 1 | Beskrivning av bilagan | kuvaus |
| 4 | filename | Sträng, max 255 | 1 | Bilagans filnamn | attachment.pdf |
| 4 | documentdata | Sträng | 1 | Bilagan base64-kodad | |
| Attr. | type | Sträng | 0...1 | Bilagans typ har ingen betydelse, alla bilagor fungerar både med e-faktura, e-postfaktura och pappersfaktura. Elementet kan utelämnas.
​ | pdf |
| 4 | printbydefault | Heltal | 0...1 | Anger om bilagan automatiskt skickas med fakturan till kunden. När värdet 1 anges för elementet skickas bilagan som standard med fakturan. Om elementet inte anges i meddelandet eller värdet är 0 skickas bilagan inte som standard med fakturan.
I användargränssnittet fältet "Lähetetään laskun mukana | 1 |
| 2 | customtags | Aggregat | 0...1 | | ​ |
| 3 | tag | Aggregat | 1...n | ​ | ​ |
| 4 | tagname | Sträng | 1 | Namn på kundens tilläggsuppgiftsfält i Netvisor | Lisätietokenttä 1 |
| 4 | tagvalue | Sträng | 1 | Värde i tilläggsuppgiftsfältet | Lisätieto |
| Attr. | type | Sträng | 1 | Typ av tilläggsuppgiftsfält: float (decimaltal), date (datum), text (text)* eller enum (urvalslista). | text |

*1) Får inte stå i konflikt med momsprocenten. Tillåtna moms-koder och -identifierare finns här.
Se också Arvonlisäveron käsittely ja ALV-tunnisteet
​

*2) Om SalesInvoiceTaxHandlingType är annat än DomesticConstructionService sätts den ändå till värdet domesticconstructionservice om fakturan har minst en rad vars moms-kod är RAMY. Alla rader på fakturan måste ha samma moms-kod.

*3) I samband med import av försäljningsfaktura kan man dessutom skriva separata verifikatrader i materialet om verifikatet ska skapas manuellt genom integration. Systemet respekterar användarens verifikatrader i materialet och skapar inte verifikatet automatiskt om dessa rader har angivits. Verifikatraderna för fakturan motsvarar verifikatraderna i import av bokföringsmaterial. OBS! Verifikat kan inte importeras för order.

*4) Periodiseringsverifikatet får automatiskt samma kostnadsobjektsinformation som har angivits på försäljningsfakturaraderna.
*5) Skattetext på fakturan. Skattetext på fakturan kan importeras till försäljningsfakturan med gränssnittsresursen salesinvoice.nv i elementet salesinvoicetaxhandlingclause. Funktionaliteten för detta element är sådan att man vid importen ska ange databas-ID för skattetexten och då används motsvarande befintlig skattetext i Netvisor. Egen text kan inte läggas till i fältet och Netvisors standardtexter kan inte redigeras. ID-nummer kan inte hämtas separat via gränssnittet.

Nedan en lista över skattetexter och ID-nummer för varje skattetext:

NoTaxSales = 1
ReverseCharge = 2
NoTaxExportOfGoods = 3
NoTaxIntraCommunitySupply = 4
NoTaxTransportOfGoodsOutsideEU = 5
Triangulation = 6
SelfBilling = 7
ReverseChargeDirectiveArticle44 = 8
AVL19Delivery = 9
AVL34Sales = 10
AVL37Sales = 11
AVL61Sales = 12
AVL71Transport = 13
AVL8ReverseCharge = 14
AVL8dReverseCharge = 15
AVL130a = 16
ConstructionPoolOrLaunch = 17
AVL58 = 18
AVL45Sales = 19
ProfitMarginSystemSecondHandGoods = 20

​Dessa motsvarar skattetexterna:
Veroton myynti = 1
Käännetty verovelvollisuus = 2
ALV 0 %, veroton myynti EU:n ulkopuolelle = 3
ALV 0 %, yhteisömyynti = 4
ALV 0 %, tavaran kuljetus EU:n ulkopuolelle = 5
Kolmikantakauppa = 6
Itselaskutus = 7
Käännetty verovelvollisuus, arvonlisäverodirektiivi 44 art. = 8
AVL 19 a §:ssä tarkoitettu luovutus = 9
AVL 34 §:ssä tarkoitettu myynti = 10
AVL 37 §:ssä tarkoitettu myynti = 11
AVL 61 §:ssä tarkoitettu osittain vähennyskelvottomassa käytössä olleen tavaran/palvelun myynti = 12
AVL 71 § 2 k., maahantuotavan tavaran kuljetus = 13
AVL 8 c §, käännetty verovelvollisuus = 14
AVL 8 d §, käännetty verovelvollisuus = 15
AVL 130 a §:ssä tarkoitettu myynti = 16
Rakennusaltaassa tai vesillelaskun jälkeen (lasku ilman ALV:a) = 17
AVL 58§ = 18
AVL 45 §:ssä tarkoitettu myynti = 19
AVL 79 a §, voittomarginaalijärjestelmä - käytetyt tavarat = 20
​
​

​

Förändringshistorik

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.