Innan du hämtar en försäljningsfaktura måste du hämta listan över försäljningsfakturor där du hittar försäljningsfakturans kod. Med hjälp av koden kan du hämta mer detaljerad information om en försäljningsfaktura åt gången. När du importerar försäljningsfakturor, försäljningsorder och kreditnotor bör du ta hänsyn till att kund- och produktregistren är uppdaterade. Läs tips om behandling av material här.
Försäljningsfakturor kan importeras i större partier med import av partier. Anvisningar för import av större partier hittar du här.
Behandlingen av försäljningsfakturor är uppdelad i följande funktioner:
Integration | HTTP-metod | Resurs | DTD | Schema | Exempel |
Hämta försäljningsfaktura- eller orderlista | GET | salesinvoicelist.nv | Fakturalista Ladda ner Orderlista Ladda ner | ||
Hämta försäljningsfaktura eller order | GET | getsalesinvoice.nv / getorder.nv | Faktura Ladda ner Order Ladda ner | ||
Hämta försäljningsfaktura, försäljningsorder eller kreditnota | POST | salesinvoice.nv | Ladda ner | Ladda ner | |
Hämta kundlista | GET | salespersonnellist.nv | Ladda ner | ||
Ta bort försäljningsfaktura | GET | deletesalesinvoice.nv | - | ||
Uppdatering av försäljningsfakturans status | POST | updatesalesinvoicestatus.nv | - | ||
Fakturering och leverans av försäljningsorder | POST | salesorderinvoicing.nv | Ladda ner | ||
Importera kommentar från försäljningsorderns eller försäljningsfakturans behandlingshistorik | POST | salesinvoicecomment.nv | Ladda ner |
Hämta försäljningsfaktura eller orderlista
Resurs: salesinvoicelist.nv
Med denna resurs kan du söka ListType-parameterns värde genom att växla mellan antingen försäljningsfakturalistan eller försäljningsorderlistan.
Parametrar som används i anropet:
Parameter | Förekomster | Beskrivning | Exempel |
listtype | 0...1 | Inget värde vid hämtning av försäljningsfakturalista och preinvoice vid hämtning av orderlista | |
invoicesabovenetvisorkey | 0...1 | Begränsar alla fakturor/order enligt angivet databas-ID | 165 |
begininvoicedate | 0...1 | Fakturor/order med större eller lika stort datum | 2012-01-01 |
endinvoicedate | 0...1 | Fakturor/order med större eller lika stort datum | 2012-12-31 |
invoicenumber | 0...1 | Fakturor/order med mindre eller lika stort datum | |
invoicestatus | 0...1 | Begränsar listan enligt fakturastatus (används inte för order), se tabell. Hämtar både från fältet InvoiceStatus och SubStatus-attributet. | open |
lastmodifiedstart | 0...1 | Hämtar försäljningsfakturor som ändrats efter angivet datum. | 2012-10-23 |
lastmodifiedend | 0...1 | Hämtar försäljningsfakturor som ändrats före angivet datum | 2012-10-24 |
salesinvoicebatchid | 0...1 | Begränsar försäljningsfakturorna som importerats i fakturapartiet enligt ett partispecifikt ID. Se beskrivning för hantering av försäljningsfakturapartier. | |
customercode | 0...1 | Begränsar listan enligt kundkod | 1234567 |
customernetvisorkey | 0...1 | Begränsar listan enligt kundens NetvisorID | 11 |
secondname | 0...1 | Begränsar listan enligt bifirmans försäljningsfakturor | Bifirma Ab |
secondnamenetvisorkey | 0...1 | Begränsar försäljningsfakturor i listan enligt bifirmans NetvisorID | 2 |
invoicingcustomercontrycode | 0...1 | Begränsar försäljningsfakturor i listan enligt kundens faktureringsland | DE |
<<<<<<<<<<<<<<<<<<<<<<<<<<<<replyoption | 0...1 | Returnerar fakturans interna kommentar. Värdet är alltid 0. | 1 |
Parametern InvoiceStatus kan ha följande värden:
InvoiceStatus | Listar fakturor med status | Motsvarande begrepp på svenska i Netvisors användargränssnitt |
open | OPEN, OVERDUE, REMINDED, REQUESTED, COLLECTED | Öppen, Förfallen, Påmind, Anmärkt, Indrivs |
overdue | OVERDUE, REMINDED, REQUESTED, COLLECTED | |
paid | PAID | Betalt |
unsent | UNSENT | Osänd |
creditloss | CREDITLOSS | Kreditförlust |
rejected | REJECTED | Förkastad |
Svar:
Nivå | Element | Form | Förekomster | Beskrivning | Exempel |
Root | Root | Aggregat | 1 | ||
1 | SalesInvoiceList | Aggregat | 1 | ||
2 | SalesInvoice | Aggregat | 0...n | max. 500 fakturor | |
3 | NetvisorKey | Numerisk | 1 | Fakturans identifierare i Netvisor | 165 |
3 | InvoiceNumber | Teckensträng | 1 | Fakturans nummer | 54122 |
3 | InvoiceDate | Datum | 1 | Fakturans datum | 2013-11-09 |
Attr. | format | Teckensträng | 1 | Fakturadatumformat, alltidansi | ansi |
3 | InvoiceStatus | Teckensträng | 1 | Fakturans eller orderns status, returnerar försäljningsfakturans betalningsstatus. | se. tabell |
Attr. | substatus | Teckensträng | 0...1 | Fakturans understatus, returnerar status för försäljningsfakturornas fordran: open, overdue, reminded, requested eller collected. Används inte för order | open |
Attr. | isincollection | Numerisk | 1 | Anger om fakturan är i extern indrivning eller inte (Intrum/Duetto). Används inte för order | 0 tai 1 |
3 | CustomerCode | Teckensträng | 1 | Faktureringskundens kundkod | |
3 | CustomerName | Teckensträng | 1 | Faktureringskundens namn | |
3 | ReferenceNumber | Referensnummer | 1 | Referensnummer | |
3 | InvoiceSum | Numerisk | 1 | Fakturans summa med två decimaler | 123,45 |
3 | OpenSum | Numerisk | 1 | Fakturans öppna summa med två decimaler, pris inklusive skatt | 45,67 |
3 | Uri | Teckensträng | 1 | Fullständiga uppgifter för faktura eller order | se. tabell |
3 | AdditionalInformation | Aggregat | 0...1 | Läggs till i svaret om parametern replyoption har lagts till i anropet. | |
4 | PrivateComment | Teckensträng | 1 | Fakturans interna kommentar |
Skillnader i returvärden mellan fakturor och orderlistor:
InvoiceStatus | URI | |
Faktura | open, creditloss, paid, unsent, rejected | /getsalesinvoice.nv?netvisorkey=165 |
Order | archived, undelivered, delivered, billed | /getorder.nv?netvisorkey=165 |
Hämta försäljningsfaktura eller order
Resurs: getsalesinvoice.nv eller getorder.nv
Innan du hämtar en försäljningsfaktura måste du hämta en lista över försäljningsfakturor, där du hittar försäljningsfakturans kod. Med hjälp av koden kan du hämta mer detaljerad information om en försäljningsfaktura åt gången. Om ordningen på fakturans eller kommentarernas rader redigerats i Netvisors användargränssnitt, behåller gränssnittet den ordning som användaren ställt in.
Samma resurs kan användas för att hämta en försäljningsorder. Följer samma uppbyggnad och samma parametrar finns tillgängliga.
Parametrar som används i anropet:
Parameter | Förekomster | Beskrivning | Exempel |
netvisorkey | 1 | NetvisorID för fakturan som ska hämtas (obs. inte obligatorisk om parametern netvisorkeylist anges; en alternativ parameter med netvisorkeylist) | 165 |
pdfimage | 0...1 | Om ingen parameter anges, sker samma sak som om man ger pdfimage = lastsentprintservice lastsentprintservice returnerar en pdf som skickats till utskriftstjänsten i LastSentInvoicePDFBase64Data-fältet returnerar en pdf som skickats till utskriftstjänsten i LastSentInvoicePDFBase64Data-fältet nopdf returnerar inget | |
showprocesshistory | 0...1 | Returnerar utskrifts/sändningshistorikinformationen som även visas på försäljningsfakturan i ProcessHistory-elementet | 1 |
includeattachments | 0...1 | Returnerar alla fakturabilagor som Base64-kodade | 1 |
showcommentlines | 0...1 | Returnerar i InvoiceLine-aggregatet fakturans rader för kommentarer | 1 |
netvisorkeylist | 0...1 | Returnerar fullständiga uppgifter om ialla önskade fakturor i en förfrågan, max. 500 ID:n (Obs. alternativ parameter med netvisorkey, endast en anges) | 1,2,3 |
includedocuments | 0...1 | Returnerar order relaterade till fakturan när försäljningsfakturan hämtas. Returnerar fakturor relaterade till ordern när försäljningsordern hämtas. | 1 |
Exempel: getsalesinvoice.nv?netvisorkey=1234&pdfimage=pdf&showprocesshistory=1
Exempel: getsorder.nv?netvisorkey=1234&pdfimage=pdf&showprocesshistory=1
Svar:
Nivå | Element | Form | Förekomster | Beskrivning | Exempel |
Root | Root | Aggregat | 1 | ||
1 | SalesInvoice | Aggregat | 1 | ||
2 | SalesInvoiceNetvisorKey | Teckensträng | 1 | Fakturans NetvisorID | 1234 |
2 | SalesInvoiceNumber | Teckensträng | 1 | Fakturans nummer | |
2 | SalesInvoiceDate | Datum | 1 | Fakturadatum | 2021-01-27 |
Attr. | format | Teckensträng | 1 | Datumformat, alltid ansi | ansi |
2 | SalesInvoiceEventDate | Datum | 1 | Fakturans bokföringsdag | 2021-02-01 |
Attr. | format | Teckensträng | 1 | Datumformat, alltid ansi | ansi |
2 | SalesInvoiceValueDate | Datum | 1 | Fakturans valuteringsdag (returneras tom till ordern) | 2021-01-27 |
Attr. | format | Teckensträng | 1 | Datumformat, alltid ansi | ansi |
2 | SalesInvoiceDeliveryDate | Datum | 1 | Fakturans leveransdatum | 2021-01-27 |
Attr. | format | Teckensträng | 1 | Datumformat, alltid ansi | ansi |
2 | SalesInvoiceDueDate | Datum | 1 | Fakturans förfallodag | 2021-01-27 |
Attr. | format | Teckensträng | 1 | Datumformat, alltid ansi | ansi |
2 | SalesInvoiceReferencenumber | Teckensträng | 1 | Fakturans referensnummer | 7659221 |
2 | SalesInvoiceAmount | Numerisk | 1 | Fakturans slutsumma | 124,50 |
Attr. | iso4217currencycode | Teckensträng | 0...1 | Slutsummans valuta | USD |
Attr. | currencyrate | Numerisk | 0...1 | Valutans växelkurs | 0,91 |
2 | SalesInvoiceCollectionCost | Numerisk | Indrivningskostnader | 10,00 | |
2 | SellerIdentifier | Teckensträng | 1 | Försäljar-ID (namn) | Matti Meikäläinen |
Attr. | type | Teckensträng | 1 | Typ av identifierare för försäljaren, alltid name (försäljarens namn) | name |
2 | InvoiceStatus | Teckensträng | 1 | Faktura-/orderstatus | Betalt |
Attr. | status | Teckensträng | 1 | Faktura-/orderstatuskod. På fakturan: open, paid, unsent, overdue, reminded, requested, collected, creditloss eller rejected. På ordern: archived, undelivered, delivered eller billed | paid |
2 | InvoiceVoucher | Teckensträng | 0...1 | Verifikationsnummer. Om det inte finns någon verifikation returneras inga uppgifter. | 27 |
Attr. | NetvisorKey | Teckensträng | 1 | Verifikationens NetvisorID | 2001 |
2 | SalesInvoiceFreeTextBeforeLines | Teckensträng | 1 | Fritext före fakturarader | |
2 | SalesInvoiceFreeTextAfterLines | Teckensträng | 1 | Fritext efter fakturarader | |
2 | SalesInvoiceOurReference | Teckensträng | 1 | Vår referens | |
2 | SalesInvoiceYourReference | Teckensträng | 1 | Er referens | |
2 | SalesInvoicePrivateComment | Teckensträng | 1 | Kommentar som inte syns på fakturan | |
2 | SalesInvoiceAgreementIdentifier | Teckensträng | 1 | Avtalskod | |
2 | InvoicingCustomerCode | Teckensträng | 1 | Faktureringskundens kundkod | 12 |
2 | InvoicingCustomerName | Teckensträng | 1 | Faktureringskundens namn | Visma Solutions Oy |
2 | InvoicingCustomerNameExtension | Teckensträng | 1 | Faktureringskundens namns tilläggsuppgift | Netvisor |
2 | InvoicingCustomerNetvisorKey | Teckensträng | 1 | Faktureringskundens NetvisorID | 123 |
2 | InvoicingCustomerOrganizationIdentifier | Teckensträng | 1 | Faktureringskundens NetvisorID | 1 om personkund, 0 om inte personkund |
2 | InvoicingCustomerAddressline | Teckensträng | 1 | Faktureringskundens namn | PB 316 |
2 | InvoicingCustomerAdditionalAddressLine | Teckensträng | 1 | Faktureringskundens namns tilläggsuppgift | |
2 | InvoicingCustomerPostnumber | Teckensträng | 1 | Faktureringskundens namn | 50123 |
2 | InvoicingCustomerTown | Teckensträng | 1 | Faktureringskundens namn | Villmanstrand |
2 | InvoicingCustomerCountryCode | Teckensträng | 1 | Faktureringskundens namn | FINLAND |
2 | MatchPartialPaymentsByDefault | Teckensträng | 1 | Ja eller Nej | Ja |
2 | DeliveryAddressName | Teckensträng | 1 | Leveransadressens namn | |
2 | DeliveryAddressLine | Teckensträng | 1 | Leveransadressens namn | |
2 | DeliveryAddressPostnumber | Teckensträng | 1 | Leveransadressens postnummer | |
2 | DeliveryAddressTown | Teckensträng | 1 | Leveransadressens namn | |
2 | DeliveryAddressCountryCode | Teckensträng | 1 | Leveransadressens namn | |
2 | DeliveryMethod | Teckensträng | 1 | Leveranssätt | Exporteras |
2 | DeliveryTerm | Teckensträng | 1 | Leveransvillkor | Fritt hos leverantören |
2 | PaymentTermNetDays | Teckensträng | 1 | Betalningsvillkor dagar. Returnera som tomt element om fakturans betalningsvillkor är förfallodag | 11 |
2 | PaymentTermCashDiscountDays | Teckensträng | 1 | Kontantrabattdagar. Returnera som tomt element om fakturans betalningsvillkor är förfallodag | 5 |
2 | PaymentTermCashDiscount | Teckensträng | 1 | Kontantrabattens belopp. Returnera som tomt element om fakturans betalningsvillkor är förfallodag | 10 |
Attr. | type | Teckensträng | 1 | Kontantrabattbeloppets typ, alltid percentage | percentage |
2 | Waybillidentifier | Teckensträng | 1 | Fraktsedelns nummer | 033000050143 |
2 | DeliveryToCustomerDate | Teckensträng | 0...1 | Leverans av order till kund, datum | 2021-1-27 |
Attr. | format | Teckensträng | 1 | Datumtyp, alltid ansi | ansi |
2 | DeliveryToCustomerWeek | Teckensträng | 0...1 | Leverans av order till kund, vecka | 42/2020 |
2 | TaxHandlingClause | Teckensträng | 1 | Försäljningsfakturans skattetext | MomsL 8 c §, omvänd skatteskyldighet |
Attr. | NetvisorKey | Teckensträng | 1 | Skattetextens NetvisorID | 14 |
2 | DeliveryOfficeIdentifier | 1 | |||
2 | ContactPersonNetvisorKey | Numerisk | 0...1 | Kontaktpersonens NetvisorID | 123 |
2 | ContactPersonFirstName | Teckensträng | 0...1 | Kontaktpersonens förnamn | Matti |
2 | ContactPersonLastName | Teckensträng | 0...1 | Kontaktpersonens efternamn | Meikäläinen |
2 | ContactPersonPhoneNumber | Numerisk | 0...1 | Kontaktpersonens telefonnummer | 050-1234567 |
2 | ContactPersonEmail | Teckensträng | 0...1 | Kontaktpersonens e-postadress | matti.meikalainen@firma.fi |
2 | LastSentInvoicePDFBase64Data | Base64 | 0...1 | Senast skickad fakturas PDF-uppgift | S89O3Ly1Lr59NB |
2 | InvoiceLines | Aggregat | 1 | ||
3 | InvoiceLine | Aggregat | 1 | ||
4 | SalesInvoiceProductLine | Aggregat | 0...n | ||
5 | NetvisorKey | Teckensträng | 1 | Fakturaradens ID | 17536 |
5 | ProductIdentifier | Teckensträng | 1 | Produktkod | TEMP1 |
Attr. | type | Teckensträng | 1 | Typ av produktidentifierare, alltid customer | customer |
5 | ProductName | Teckensträng | 1 | Produktens namn | Exempelprodukt |
5 | ProductNetvisorKey | Teckensträng | 1 | Produktens NetvisorID | |
5 | ProductUnitPrice | Numerisk | 1 | Produktens enhetspris | 7,00 |
5 | ProductPurchasePrice | Numerisk | 1 | Produktens anskaffningspris | |
5 | ProductVatPercentage | Teckensträng | 1 | Produktens skatteprocent | 24 |
Attr. | VatCode | Teckensträng | 1 | Skattekod | KOMY |
5 | ProductPrimaryEanCode | Teckensträng | 1 | Primär EAN-kod | |
5 | ProductSecondaryEanCode | Teckensträng | 1 | Sekundär EAN-kod | |
5 | SalesInvoiceProductLineQuantity | Numerisk | 1 | Produktmängd | 1 |
5 | SalesInvoiceProductLineDeliveryDate | Datum | 0...1 | Försäljningsorderradens leveransdag | 2021-04-16 |
5 | SalesInvoiceProductLineDiscountPercentage | Numerisk | 1 | Rabattprocent | 0 |
5 | SalesInvoiceProductLineFreeText | Teckensträng | 1 | Fritext på produktrad (radbeskrivning) | |
5 | SalesInvoiceProductLineVatSum | Numerisk | 1 | Radens skattesumma med två decimaler | 1,68 |
5 | SalesInvoiceProductLineLinesum | Numerisk | 1 | Radens skattesumma med två decimaler | 8,68 |
5 | SalesInvoiceProductLineInventoryID | Numerisk | 0...1 | Produktens lager-ID | 1 |
5 | SalesInvoiceProductLineInventoryName | Teckensträng | 0...1 | Produktens lagers namn | Exempellager |
5 | AccountingAccountSuggestion | Teckensträng | 1 | Kontosättningsförslag | 551 |
5 | dimension | Teckensträng | 0..n | ||
6 | dimensionname | Teckensträng | 1 | Räkenskapsobjektsrubrik | Kostnadsställe |
6 | dimensionitem | Teckensträng | 1 | NULL | Helsingfors |
5 | ProvisionPercentage | Numerisk | 1 | Fakturaradens provisionsprocent | 12 |
4 | SalesInvoiceCommentLine | Aggregat | 0...n | ||
5 | Comment | Teckensträng | 1 | Kommentarstext | Fakturans kommentar |
3 | SalesInvoiceAttachments | Aggregat | 0...1 | ||
4 | SalesinvoiceAttachment | Aggregat | 1...n | ||
5 | mimetype | Teckensträng | 1 | Innehållets filformat | image/jpeg |
5 | attachmentdescription | Teckensträng | 1 | Bilagans beskrivning | |
5 | filename | Teckensträng | 1 | Filnamn | Exempel_bild.jpg |
5 | documentdata | Base64 | 1 | Base64-kodad bilaga | S89O3Ly1Lr59NBS89 |
3 | documents | Aggregat | 1 | Fakturor/order relaterade till order/fakturor | |
4 | salesorder | Aggregat | 1...n | Obs. om en order hämtas är elementnamnet salesinvoice | |
5 | netvisorkey | Numerisk | 1 | Netvisor-ID för order i anslutning till en faktura Netvisor-ID för faktura i anslutning till en order | 12345 |
4 | ordernumber | Numerisk | 1 | Ordernummer för order i anslutning till en faktura Fakturanummer för faktura i anslutning till en order Obs. om en order hämtas är elementnamnet invoicenumber | 1001 |
Hämta försäljningsfaktura, försäljningsorder eller kreditnota
Resurs: salesinvoice.nv
Gränssnittet låter dig importera eller uppdatera en försäljningsfaktura, dess produkt- och kommentarsrader, bilagor, fakturans verifikationsrader och fakturans kundspecifika fält till Netvisor.
De obligatoriska fälten i den här resursen är:
- Faktura-/orderdatum
- Fakturans/orderns slutsumma
- Faktura-/orderstatus
- Faktureringskundens länkningsuppgift
- Betalningsvillkorets nettodagar eller förfallodag.
- Minst en fakturarad med följande uppgifter:
- Produktens länkningsuppgift
- Produktens namn
- Produktens enhetspris
- Produktens momsprocent och momskod
- Styckeantal
Fakturan kan även hämtas i läget "Utkast" (invoicedraft). Utkastet får inget fakturanummer och inga verifikationsuppgifter kan hämtas till utkastet. Utkastet kan uppdateras till en faktura genom metoden
Kreditnotan importeras över gränssnittet genom att följa meddelandestrukturen på försäljningsfakturan. Den enda skillnaden är att antalet (SalesInvoiceProductlineQuantity) och slutsumman (SalesInvoiceAmount) är inställda på negativa tal i meddelandet. Om försäljningsfakturans meddelande anger momsbeloppet (salesInvoiceProductLineVatSum) och radsumman (salesInvoiceProductLineSum), bör även dessa anges som negativa tal.
En kreditnota som importeras över gränssnittet fördelas inte automatiskt till en befintlig försäljningsfaktura. Koppling ska alltid göras manuellt, anvisningar för funktionen: Tilldela kreditnota till debetnota.
Netvisor avrundar nettoradens summa och fakturans summa till en noggrannhet på två decimaler när de hämtas genom gränssnittet. I vissa fall kan detta resultera i avrundningsskillnader, som måste avstämmas med en verifikation. Om avrundningsskillnader inte önskas kan enhets-, rad- och momsbelopp avrundas till två decimaler på förhand
Fakturerings- och leveranskunder tilldelas försäljningsfakturan antingen utifrån en Netvisor-nyckel eller kundspecifik nyckel. Netvisor-nyckeln är databasens ID i Netvisor och den kundspecifika nyckeln är den kundkod som användaren gett åt kunden. Nycklarna erhålls genom att hämta kundens uppgifter med en begäran om en kundlista som tillhandahålls av gränssnittet.
Endast invoicingcustomeridentifier-uppgifter kan importeras med meddelande. På det här sättet hämtas kundens faktureringsadress och leveransadress från Netvisors kundkort till Netvisors faktura. Om materialet innehåller vilken som helst annan information om faktureringskunden (t.ex. postadress), så kommer informationen inte längre att hämtas från kundkortet till fakturan.
Fakturaspråket (finska, svenska eller engelska) som är angivet för kunden i Netvisor används som fakturaspråk.
I Netvisor tas priskoefficienterna och kundpriserna i beaktande på fakturaraderna, detta sker genom att ange i försäljningsfaktura meddelandet under salesinvoiceamount-elementet en ”pricetype”- attribut, som pricetype värde ges ”netvisor”. Dessutom måste SalesInvoiceAmount- elementets värde vara 0, så att fakturans slutgiltiga beloppet beräknas korrekt från radsummorna. Utöver detta måste man ge fakturaradens productunitprice-elementet en ”type”-attribut, även detta värde ska vara ”netvisor”, och productunitprice- elementets värde kan vara 0.
I Netvisor skickas alltid en försäljningsfaktura till kunden som standard via den "mest elektroniska" kanalen, beroende på vilka faktureringsuppgifter som finns på Netvisors kundkort. I första hand skickas en försäljningsfaktura som e-faktura, i andra hand som e-postfaktura och som sista alternativ som en pappersfaktura. Det är möjligt att ändra via vilken kanal försäljningsfakturan skickas. Detta görs i sändningsvyn och denna information kan inte importeras via meddelande. E-fakturadressen och e-postfakturaadressen för en försäljningsfaktura hämtas alltid från Netvisors kundkort.
Om en alternativ faktureringskund anges för målkunden, hämtar gränssnittet automatiskt faktureringsadressens uppgifter för den importerade fakturan från den alternativa faktureringskunden. I det här fallet kommer inte uppgifterna om faktureringsadressen i filen att användas.
Periodisering av en försäljningsfaktura kan göras på antingen faktura- eller fakturaradsnivå samt enligt jämn fördelning eller fördelningskurva. När det gäller en försäljningsfaktura kan periodiseringsuppgifter hämtas för en inte skickad eller öppen faktura. Periodiseringsverifikationer genereras baserat på den information som hämtats med meddelande efter att fakturan skickats. Alternativt genereras en öppen fakturas verifikation automatiskt av systemet i samband med import. När du importerar en periodisering för en försäljningsfaktura med accrualrule-strukturen, är det i gränssnittet inte möjligt att importera verifikationsrader (invoicevoucherlines) till försäljningsfakturan. Observera att en periodisering av en månad endast är möjlig om periodiseringen för fakturan inte görs för samma månad som är fakturans dateringsmånad. Till exempel, om fakturans dateringsmånad är april, så kan periodiseringen göras för framtiden, dvs. för maj eller från och med då. Det går inte att göra periodisering för det förflutna.
Följande beskriver meddelandestrukturen för att importera en försäljningsfaktura till Netvisor:
Parametrar som används i anropet:
Parameter | Förekomster | Beskrivning | Exempel |
Method | 1 | add eller edit. Vid användning av metoden edit ska all originalinformation om ordern/fakturan lämnas genom meddelande. | edit |
Id | 0...1 | ID för fakturan som ska uppdateras, krävs om method är edit | 165 |
Uppgifter som ska hämtas skickas med anropet som xml (POST-data) enligt bifogad beskrivning. 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 det inte anges hämtar Netvisor automatiskt ett nytt. Anges inte för utkast. | 123456 |
2 | salesinvoicedate | Datum | 1 | Fakturadatum (även valuteringsdag) | 2020-12-31 |
Attr. | format | Teckensträng | 1 | Fakturans datumformat, alltidansi | ansi |
2 | salesinvoiceeventdate | Datum | 0...1 | Fakturans bokföringsdag. Ett redovisningsverifikat skapas för denna dag. | 2021-01-01 |
Attr. | format | Teckensträng | 1 | Fakturans bokföringsdags format, alltidansi | ansi |
2 | salesinvoiceduedate | Datum | 0...1 | Fakturans förfallodag, obligatorisk uppgift om inget betalningsvillkor anges. Meddelandet får inte ha både förfallodag och betalningsvillkor, endast ett element anges. | 2020-12-31 |
Attr. | format | Teckensträng | 1 | Fakturans förfallodags format | ansi |
2 | salesinvoicevaluedate | Datum | 0...1 | Fakturans valuteringsdag. Om angiven tillämpas nettodagarna i betalningsvillkoren på valuteringsdagen | 2020-12-31 |
Attr. | format | Teckensträng | 1 | Fakturans valuteringsdags format | ansi |
2 | salesinvoicedeliverydate | Datum | 0...1 | Fakturans leverans-/ankomstdatum | 2020-12-31 |
Attr. | format | Teckensträng | 1 | Leveransdagens 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 | Teckensträng | 1 | Leveranstid hos kunden, format | ansi |
Attr. | type | Teckensträng | 1 | Leveranstid hos kunden date eller weeknumber | weeknumber |
2 | salesinvoicewaybillidentifier | Teckensträng, max. 35 tecken | 0...1 | Fraktsedelns nummer 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 | Teckensträng | 1 | Lastpallkodtyp, GS1 | GS1 |
Attr. | amount | Teckensträng | 0...1 | Antal lastpallar | 2 |
2 | salesinvoicereferencenumber | Referensnummer | 0...1 | Fakturans referensnummer med kontroller i korrekt format Om det inte anges kommer Netvisor att generera ett referensnummer för fakturan. | 1070 |
2 | salesinvoiceamount | Numerisk | 1 | Fakturans slutsumma, inklusive eventuella skatter. Om den anges kommer Netvisor inte att beräkna totalsumman baserat på fakturaraderna. Kan anges tomt <salesinvoiceamount />, varvid slutsumman beräknas utifrån fakturaraderna. Obs. Om du importerar fakturor som skickats rekommenderas import av slutsumman. | 100,99 |
Attr. | iso4217currencycode | Teckensträng | 0...1 | Fakturans valuta i ISO 4217-format Företagets hemvaluta anges som standard. | USD |
Attr. | currencyrate | Teckensträng | 0...1 | Valutakurs. Om den inte angivits kommer Europeiska centralbankens dagliga växelkurs att användas. Om ingen kurs hittas använder systemet automatiskt värdet 1. | 1,33 |
Attr. | pricetype | Teckensträng | 0...1 | Pristyp. netvisor eller customer. Customer gör ingenting om värdet är netvisor, fakturaraderna tar hänsyn till netvisors priskoefficienter och kundpriser. SalesInvoiceAmount-värdet måste vara 0 för att fakturans slutsumman ska beräknas korrekt utifrån radsummorna. | netvisor |
2 | selleridentifier | Teckensträng | 0...1 | Försäljarlänk till faktura. Om du vill fördela försäljaruppgifter till en försäljare som finns i Netvisor måste du ange både försäljarens länkuppgifter och försäljarens namn (sellername-elementet) i meddelandet. Netvisors försäljaruppgifter kan hämtas med resursen: Importera försäljarlista, returnerar listan den netvisorkey som användes för att länka försäljaren. | 1 |
Attr. | type | Teckensträng | 1 | Typ av försäljarlänk, netvisor (netvisorkey) eller customer (namn) Länken kan göras med försäljarens netvisorkey (primär) eller försäljarens namn. När länkuppgifterna och namnet på försäljaren importeras med meddelandet, blir namnet på försäljaren som har motsvarande ID i Netvisor, försäljare på fakturan. Om länken upprättas med namn, jämförs den givna teckensträngen fram- och baklänges med Netvisors lista över försäljare. Om försäljaren inte kan hittas med hjälp av netvisorkey på Netvisor meddelar gränssnittet om ofullständiga uppgifter. | netvisor |
2 | sellername | Teckensträng, max. 50 | 0...1 | Försäljarens namn. Om försäljarlänken inte importeras med meddelande och försäljningsfakturan redigeras i Netvisor efter import, kommer försäljaruppgifterna att försvinna på försäljningsfakturan. | Matti Mallikas |
2 | invoicetype | Teckensträng | 0...1 | Typ av data som ska importeras, invoice (försäljningsfaktura) eller order (order) eller invoicedraft (utkast). Som standard invoice | invoice |
2 | salesinvoicestatus | Teckensträng | 1 | Faktura-/orderstatus Inget utrymme ges till utkastet. För faktura open eller unsent. För order delivered eller undelivered. | open |
Attr. | type | Teckensträng | 1 | Statusformat | netvisor |
2 | salesinvoicefreetextbeforelines | Teckensträng, max. 500 | 0...1 | Fritext före fakturarader | |
2 | salesinvoicefreetextafterlines | Teckensträng, max. 500 | 0...1 | Fritext efter fakturarader | |
2 | salesinvoiceourreference | Teckensträng, max. 200 | 0...1 | Vår referens-fältets uppgift | |
2 | salesinvoiceyourreference | Teckensträng, max. 200 | 0...1 | Er referens-fältets uppgift | |
2 | salesinvoiceprivatecomment | Teckensträng, max. 500 | 0...1 | Privat kommentar, skrivs inte ut på fakturor. | |
2 | invoicingcustomeridentifier | Teckensträng | 1 | Faktureringskundens länk, kunden måste finnas i Netvisor. Kundens namn, faktureringsadress och leveransadress hämtas till fakturan från Netvisors kundkort, om inga andra uppgifter om faktureringskunden anges i materialet (exempelvis postadress). | MM |
Attr. | type | Teckensträng | 1 | Typ av länkningsuppgift: customer (=kundkod), netvisor (=Netvisor bas-id) eller organizationunitnumber (=EDI-kod) | customer |
Attr. | contactpersonid | Teckensträng | 0...1 | Kundens kontaktpersons NetvisorID Erhålls genom att hämta kundens uppgifter. | 4012 |
2 | invoicingcustomername | Teckensträng, max. 250 | 0...1 | Faktureringskundens namn. Söker med kundkort, om endast invoicingcustomeridentifier anges utan andra kunduppgifter. | Matti |
2 | invoicingcustomernameextension | Teckensträng, max. 250 | 0...1 | Faktureringskundens namns tilläggsuppgift. Söker med kundkort, om endast invoicingcustomeridentifier anges utan andra kunduppgifter. | Meikäläinen |
2 | invoicingcustomeraddressline | Teckensträng, max. 100 | 0...1 | Faktureringskundens adress. Söker med kundkort, om endast invoicingcustomeridentifier anges utan andra kunduppgifter. | Videgränden 1 |
2 | invoicingcustomeradditionaladdressline | Teckensträng, max. 100 | 0...1 | Faktureringskundens adress. Söker med kundkort, om endast invoicingcustomeridentifier anges utan andra kunduppgifter. | |
2 | invoicingcustomerpostnumber | Teckensträng, max. 50 | 0...1 | Faktureringskundens postnummer. Söker med kundkort, om endast invoicingcustomeridentifier anges utan andra kunduppgifter. | 53100 |
2 | invoicingcustomertown | Teckensträng, max. 50 | 0...1 | Faktureringskundens postanstalt. Söker med kundkort, om endast invoicingcustomeridentifier anges utan andra kunduppgifter. | Villmanstrand |
2 | invoicingcustomercountrycode | Teckensträng | 0...1 | Faktureringskundens landsuppgift. Söker med kundkort, om endast invoicingcustomeridentifier anges utan andra kunduppgifter. | FI |
Attr. | type | Teckensträng | 1 | Landsuppgiftens format | ISO-3166 |
2 | officeidentifier | Teckensträng | 0...1 | Kod för verksamhetsställe, i Netvisor koden som finns i verksamhetsställets uppgifter. OBS! detta är inte verksamhetsställets Netvisorkey. Koden för verksamhetsstället kan anges genom ett meddelande, varvid kundens verksamhetsställe (eller den första relevanta) ifråga söks. Vid behov kan en ny skapas (type=automatic) OBS! I detta fall ska meddelandet innehålla verksamhetsställets namn och alla adressuppgifter | |
Attr. | type | Teckensträng | 0...1 | automatic, när du vill att verksamhetsstället ska skapas enligt uppgifterna i försäljningsfakturameddelandet. OBS! I detta fall ska meddelandet innehålla verksamhetsställets namn och alla adressuppgifter | |
2 | deliveryoffice | Teckensträng | 0...1 | Tilldelar verksamhetsställe på Netvisors kundkort. OBS! Meddelandet ska innehålla verksamhetsställets namn och alla adressuppgifter | |
Attr. | type | Teckensträng | 1 | Länkningsuppgiftens typ: Customer = Verksamhetsställets namn Netvisor = Verksamhetsställets grundläggande NetvisorID | |
2 | deliveryaddressname | Teckensträng, max. 250 | 0...1 | Leveranskundens namn, hämtas inte från Netvisor. Bör anges om du vill att leveransadressen ska finnas på fakturan. | Maija |
2 | deliveryaddressline | Teckensträng, max. 100 | 0...1 | Leveransadress, hämtas inte från Netvisor | Videgränden 2 |
2 | deliveryaddresspostnumber | Teckensträng, max. 50 | 0...1 | Leveransadressens postnummer | 55100 |
2 | deliveryaddresstown | Teckensträng, max. 50 | 0...1 | Leveransadressens postanstalt, hämtas inte från Netvisor | Imatra |
2 | deliveryaddresscountrycode | Teckensträng | 0...1 | Leveransadressens landskod, hämtas inte från Netvisor | FI |
Attr. | type | Teckensträng | 1 | Landsuppgiftens format | ISO-3166 |
2 | deliverymethod | Teckensträng, max. 50 | 0...1 | Leveranssätt. Om inget leveranssätt hittas, läggs det till. | Installerad |
2 | deliveryterm | Teckensträng, max. 50 | 0...1 | Leveransvillkor. Hittas inga leveransvillkor, läggs de till. | Enligt avtal |
2 | salesinvoicetaxhandlingtype | Teckensträng | 0...1 | Skattebehandlingssätt. countrygroup, forcedomestic, domesticconstructionservice eller notaxhandling Om det inte anges hämtas det från kundens uppgifter | countrygroup |
2 | paymenttermnetdays | Numerisk | 1 | Betalningsvillkorets nettodagar, obligatorisk uppgift om inget betalningsvillkor anges. Fakturans datum + Betalningsvillkor för nettodagar = Fakturans förfallodag. Betalningsvillkoren utformas enligt kundens faktureringsspråk: "14 päivää netto / 14 dagar netto / 14 days net". Meddelandet får inte innehålla både förfallodag och betalningsvillkor. Betalningsvillkoren behöver inte finnas på Netvisor, vid behov skapas de automatiskt i samband med importen. | 14 |
2 | paymenttermcashdiscountdays | Numerisk | 0...1 | Kassarabattdagar i betalningsvillkoret. Betalningsvillkoret utformas enligt kundens faktureringsspråk, enligt kundens faktureringsspråk, t.ex. "14 dagar netto, 5 dagar". Endast fakturaspecifik. | 5 |
2 | paymenttermcashdiscount | Numerisk | 0...1 | Betalningsvillkorets kassarabatt. Betalningsvillkoren utformas enligt kundens faktureringsspråk t.ex.: "14 dagar netto, 5 dagar -10 %". Endast fakturaspecifik. | 10 |
Attr. | type | Teckensträng | 1 | Betalningsvillkorets typ, alltid percentage | percentage |
2 | expectpartialpayments | Numerisk | 0...1 | Delbetalningar. 1 = ja, 0 = nej, standard är 0. Om fakturan erhåller delbetalningar är fakturan även föremål för betalningar som ligger utanför kontantrabattoleranserna. | 1 |
2 | overridevouchersalesreceivablesaccountnumber | Numerisk | 0...1 | Ett bokföringskonto som kan användas för att åsidosätta Netvisors standardfordringskonto för försäljningen. Fungerar endast för öppna fakturor. | 1703 |
2 | salesinvoiceagreementidentifier | Teckensträng, max. 35 | 0...1 | Avtalsbeteckning, hämtas inte från kundkortet | |
2 | printchannelformat | Teckensträng | 0...1 | Fakturans utskriftsform netvisor: 1 eller 2 customer: Faktura + girering eller Faktura Om inte tillhandahållet används utskriftsformatet i kundens uppgifter. | 1 |
Attr. | type | Teckensträng | 1 | netvisoreller customer | netvisor |
2 | secondname | Teckensträng | 0...1 | Bifirma | Testbifirma |
Attr. | type | Teckensträng | 1 | netvisor (bifirmans NetvisorKey eller Netvisor databas-ID) eller customer (bifirmans namn) | customer |
2 | overriderateofoverdue | Numerisk | 0...1 | Dröjsmålsränteprocent, åsidosätter Netvisors standard | 5,5 |
2 | ordernumber | Numerisk | 0...1 | Ordernummer | 258741 |
2 | proposedaccount | Numerisk | 0...1 | kundens bokföringskonto | 1011 |
Attr. | type | Teckensträng | 1 | customer | customer |
2 | accountdimensiontext | Teckensträng, max. 35 | 0...1 | Kostnadsställesuppgift, fakturaspecifik. I Netvisor i tilläggsuppgifterna för försäljningsfakturan, punkten kundens tilläggsuppgifter. Kan även importeras som fakturaradsspecifik, se dokumentationen nedan. | kostnadsställe |
2 | invoicelines | Aggregat | 1 |
Fakturaraderna kan vara antingen produkt- eller kommentarsrader. Produkten på fakturaraden ska vara skapad i Netvisor och den länkas till raduppgifterna med antingen en Netvisor-nyckel eller en kundspecifik nyckel. Produktens namn, pris och annan information kan dock ändras.
Valet av momskod på en produktrad i fakturan är obligatoriskt. För en lista över tillåtna momskoder, se anvisningen Momshantering och systemets momsregistreringsnummer eller tabellen för momsregistreringsnummer nedan. Momsregistreringsnumret används för att generera verifikatet enligt det som angetts på fakturaraden när fakturan importeras till Netvisor i läget Öppen. Om fakturan importeras i läget Oskickad, kommer ett momsregistreringsnummer i enlighet med Netvisors bokföringskonto att sparas på verifikatet.
Om fakturaraderna innehåller både produkt- och kommentarsrader blir ordningen på fakturaraderna i systemet densamma som i det importerade materialet.
Periodiseringen kan göras fakturaradsspecifikt endera enligt jämn fördelning eller enligt fördelningskurva. Vid periodisering med jämn fördelning anges endmonth och endyear-elementen. Vid periodisering med fördelningskurva anges de inte. Vid periodisering med fördelningskurva anges divisioncurvename-elementet. När du importerar en periodisering för en försäljningsfaktura med accrualrule-strukturen, är det i gränssnittet inte möjligt att importera verifikationsrader (invoicevoucherlines) till försäljningsfakturan. Observera att en periodisering av en månad endast är möjlig om periodiseringen för fakturan inte görs för samma månad som är fakturans dateringsmånad. Till exempel, om fakturans dateringsmånad är april, så kan periodiseringen göras för framtiden, dvs. för maj eller från och med då. Det går inte att göra periodisering för det förflutna.
Strukturen för InvoiceLine-aggregatet är följande, om du vill importera en produktlinje:
Nivå | Element | Form och längd | Förekomster | Beskrivning | Exempel |
3 | invoiceline | Aggregat | 1...n | ||
4 | salesinvoiceproductline | Aggregat | 1 | ||
5 | productidentifier | Teckensträng | 1 | Produktens länkningsuppgift. Produkten måste vara skapad i Netvisor. Kan vara antingen produktkoden eller netvisorkey, det vill säga produktens databas-ID. | |
Attr. | type | Teckensträng | 1 | Länkningstyp: - customer (produktkod) - netvisor (netvisorkey) - primaryeancode (produktens primära EAN-kod) - secondaryeancode (produktens sekundära EAN-kod) | netvisor |
5 | productname | Teckensträng, max.200 | 0...1 | Produktnamn. Om det inte anges hämtas det från produkten. | Testprodukt |
5 | productunitprice | Numerisk, max. 12 decimaler | 1 | Produktens enhetspris, hämtas inte från produkten | 10,05 |
Attr. | type | Teckensträng | 1 | Enhetsprisets typ, net (skattefritt) gross (inklusive skatt) | net |
5 | productunitpurchaseprice | Numerisk | 0...1 | Produktens inköpspris, avrundat till två decimaler | 1,05 |
Attr. | type | Teckensträng | 1 | Inköpsprisets typ, alltid net | net |
5 | productvatpercentage | Numerisk | 1 | Produktens momsprocent, får inte stå i konflikt med momskod. I Netvisor kan du hantera momsprocenterna i: Ekonomiförvaltning > Inställningar > Bokföringsinställningar > Inställningar för bokföring och skyldigheter > Hantera skattesatser *1 | 24 |
Attr. | vatcode | Teckensträng | 1 | MOMS-kod | KOMY |
5 | salesinvoiceproductlinequantity | Numerisk | 1 | Styckeantal. Kan vara ett heltal eller ett decimaltal. Max. åtta decimaler (till exempel 3 55555555). | 5 |
5 | salesinvoiceproductlinediscountpercentage | Numerisk | 0...1 | Rabattprocent. Om attributet netvisor anges hämtas rabattprocenten från Netvisors kundkort | 10 |
Attr. | type | Teckensträng | netvisor, om ett attribut anges lämnas värdet på elementet tomt | netvisor | |
5 | salesinvoiceproductlinefreetext | Teckensträng, max. 255 | 0...1 | Fritext på produktrad (radbeskrivning) | Fri text |
5 | salesinvoiceproductlinevatsum | Numerisk | 0...1 | Radens skattebelopp. Anges om du vill ersätta det skattbelopp som beräknats av Netvisor. | 11,00 |
5 | salesinvoiceproductlinesum | Numerisk | 0...1 | Radens slutsumma inklusive skatt. Anges om du vill ersätta radsumman som beräknats av Netvisor. | 50,00 |
Obs! salesinvoiceproductlinesum och salesinvoiceproductlinevatsum-element krävs för att de angivna beloppen ska kunna användas. | |||||
5 | salesinvoiceproductlineinventoryid | Numerisk | 0...1 | Radens produkts lagers databas-ID | 1 |
5 | accountingaccountsuggestion | Numerisk | 0...1 | Kontosättningsförslag. Kontot måste finnas i systemet. | 3000 |
5 | dimension | Aggregat | 0...n | ||
6 | dimensionname | Teckensträng, max.50 | 1 | Räkenskapsobjektets rubrik, om det inte finns en rubrik grundar systemet den | Projekt |
6 | dimensionitem | Teckensträng max.200 | 1 | NULL | Löneberäkning |
5 | provisionpercentage | Numerisk | 0...1 | Fakturaradens provisionsprocent | 12 |
5 | accrualrule | Aggregat | 0...1 | Radspecifik periodiseringsregel, alternativt kan jämn fördelning ELLER fördelningskurva användas. | |
6 | startmonth | Numerisk | 1 | Begynnelsemånad | 9 |
6 | startyear | Numerisk | 1 | Begynnelseår | 2020 |
6 | endmonth | Numerisk | 0...1 | Avslutningsmånad (använd endast jämn fördelning i periodiseringen) | 12 |
6 | endyear | Numerisk | 0...1 | Avslutningsår (använd endast jämn fördelning i periodiseringen) | 2020 |
6 | divisioncurvename | Teckensträng | 0...1 | Fördelningskurva (använd endast fördelningskurva i periodiseringen) Fördelningskurvan ska finnas i Netvisor. Hanteras i vyn 'Ekonomiförvaltning > Budgeteringsinställningar > Fördelningskurvor' | kvartal |
5 | productunitname | Teckensträng, max. 14 | 0...1 | Produktens enhetsuppgift. Om de inte uppges kommer enheten på Netvisors produktkort att användas. Gäller inte företag som använder Utvidgad produkthantering, | st. |
5 | deliverydate | Numerisk | 0...1 | Orderradens leveransdag. | 2021-06-01 |
Attr. | format | Teckensträng | 1 | Datumtyp, alltid ansi. | ansi |
5 | ordernumber | Numerisk | 0...1 | Produktradens ordernummer. | 1232 |
5 | proposedaccount | Numerisk | 0...1 | Kundens bokföringskonto | 1011 |
Attr. | type | Teckensträng | 1 | customer | customer |
2 | accountdimensiontext | Teckensträng, max. 35 | 0...1 | Kundens kostnadsställesuppgift, fakturaradsspecifik. | kostnadsställe |
Alternativt kan du hämta en kommentarsrad, varvid InvoiceLine-aggregatets struktur är följande:
Nivå | Element | Form | Förekomster | Beskrivning | Exempel |
3 | invoiceline | Aggregat | 1...n | ||
4 | salesinvoicecommentline | Aggregat | 1 | ||
5 | comment | Teckensträng | 1 | Kommentar på faktura |
Fortsätt med den valda strukturen enligt följande:
Nivå | Element | Form och längd | Förekomster | Beskrivning | Exempel |
2 | invoicevoucherlines | Aggregat | 0...1 | *3 | |
3 | voucherline | Aggregat | 1...n | ||
4 | linesum | Numerisk | 1 | Summa. Ett positivt tal bokförs på debetsidan och ett negativt på creditsidan | 100 |
Attr. | type | Teckensträng | Summans typ, net (skattefri) gross (inklusive skatt) | net | |
4 | description | Teckensträng, max. 255 | 0...1 | Förklaring | Förklaring |
4 | accountnumber | Teckensträng | 1 | Kontonummer. Måste hittas i systemet | 3000 |
4 | vatpercent | Numerisk | 1 | Skatteprocent, får inte stå i konflikt med momskod. | 24 |
Attr. | vatcode | Numerisk | 1 | MOMS-kod | KOMY |
5 | dimension | Aggregat | 0...n | ||
6 | dimensionname | Teckensträng | 1 | Räkenskapsobjektsrubrik, om ingen rubrik hittas skapar systemet en | Projekt |
6 | dimensionitem | Teckensträng | 1 | Räkenskapsobjektets namn | Löneberäkning |
2 | accrualrule | Aggregat | 0...1 | Fakturaspecifik periodiseringsregel, alternativt kan jämn fördelning ELLER fördelningskurva användas. | |
3 | startmonth | Numerisk | 1 | Begynnelsemånad | 9 |
3 | startyear | Numerisk | 1 | Begynnelseår | 2020 |
3 | endmonth | Numerisk | 0...1 | Avslutningsmånad (använd endast i jämnt fördelad periodisering) | 12 |
3 | endyear | Numerisk | 0...1 | Avslutningsår (använd endast i jämnt fördelad periodisering) | 2020 |
3 | divisioncurvename | Teckensträng | 0...1 | Fördelningskurva (använd endast i periodisering med fördelningskurva) Fördelningskurvan ska finnas i Netvisor. Hanteras i vyn 'Ekonomiförvaltning > Budgeteringsinställningar > Fördelningskurvor' | kvartal |
2 | salesinvoiceattachments | Aggregat | 0...1 | ||
3 | salesinvoiceattachment | Aggregat | 1...n | ||
4 | mimetype | Teckensträng | 1 | Bilagans MIME-typ | Application/pdf |
4 | attachmentdescription | Teckensträng, max.100 | 1 | Bilagans beskrivning | beskrivning |
4 | filename | Teckensträng, maks.255 | 1 | Bilagans filnamn | attachment.pdf |
4 | documentdata | Teckensträng | 1 | base64-kodad bilaga | |
Attr. | type | Teckensträng | 0...1 | Obs! Användningen av detta element har förändrats i och med förnyelsen av försäljningsfakturan. I fortsättningen spelar i praktiken typen av bilaga ingen roll, utan alla bilagor kommer att fungera med e-, e-post- och pappersfakturor. Kan utelämnas. De gamla instruktioner nedan inom parentes. (Skickas bilagan med e-fakturan eller till exempel via en utskriftstjänst. Som standard används pdf om attributet inte anges. Värden: finvoice Bilagor som ska skickas med e-fakturan Bilagor som ska skickas via utskriftstjänsten, lokal utskrift eller e-postfakturering) | |
4 | printbydefault | Heltal | 0...1 | Markeras bilagorna automatiskt för utskrift; 1= true, 0=false Gäller endast pappersfakturor. OBS: Får inte anges om den bifogade datatypen är finvoice. Avvisa i så fall begäran. Om type=pdf och printbydefault=1 kommer fakturan i Netvisor automatiskt att skickas som en pappersfaktura, även om kundkortet har e-fakturauppgifter | 1 |
2 | customtags | Aggregat | 0...1 | ||
3 | tag | Aggregat | 1...n | ||
4 | tagname | Teckensträng | 1 | Kundens tilläggsuppgiftsfälts namn i Netvisor | Tilläggsuppgiftsfält 1 |
4 | tagvalue | Teckensträng | 1 | Tilläggsuppgiftsfältets värde | Tilläggsuppgift |
Attr. | type | Teckensträng | 1 | Typ av fält för tilläggsuppgifter: float (urvalslista), date (datum), text (text) eller enum (decimaltal). | text |
*1) Får inte stå i konflikt med momsprocent. Tillåtna momskoder: NONE|KOOS|EUOS|EUUO|EUPO|100|KOMY|EUMY|EUUM|EUPM312|EUPM309|MUUL|EVTO|EVPO|RAMY|RAOS|EVRO
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 |
Om SalesInvoiceTaxHandlingType skiljer sig från DomesticConstructionService anges den dock som värdet domesticconstructionservice om fakturan innehåller en enda rad med skattekoden Construction_Service_Sales. Alla rader på fakturan måste ha samma skattekod.
*3) I samband med importen av en försäljningsfaktura kan även separata verifikationsrader skrivas till materialet om man önskar generera ett verifikat för fakturan manuellt genom integration. Systemet respekterar de verifikationsrader som användaren anger i materialet och genererar inte automatiskt en verifikation om dessa rader angivits. Verifikationsraderna på fakturan motsvarar verifikationsraderna i det importerade bokföringsmaterialet. OBS! Inget verifikat kan importeras för order.
*4) Periodiseringsverifikatet får automatiskt samma räkenskapsbjektsuppgift som givits på försäljningsfakturaraderna.
Ta bort försäljningsfaktura
Resurs: deletesalesinvoice.nv
Med resursen kan du ta bort en befintlig försäljningsfaktura eller försäljningsorder. Resursen sköter raderingen av fakturan eller ordern och dess bilagor, dimensionslänkar, verifikationer och dylikt.
Parameter som används i anropet:
Parameter | Förekomster | Beskrivning |
invoiceid | 1 | NetvisorKey för faktura som tas bort |
orderid | 0...1 | NetvisorKey för faktura som tas bort |
Uppdatering av försäljningsfakturans status
Resurssi: updatesalesinvoicestatus.nv
Resursen avviker från andra resurser på den här sidan genom att värdet som ska uppdateras anges direkt i URI.
Resursen kan användas för att uppdatera en eller flera försäljningsfakturor till önskat status. Om en faktura uppdateras från statusen "unsent ("oskickad") till en annan status, genereras automatiskt en verifikation för försäljningsfakturan.
Parametrar som används i anropet:
Parameter | Förekomster | Exempel | Beskrivning |
netvisorkey | 1 | 1 | Fakturans NetvisorKey |
netvisorkeylist | 0...1 | 1,2,3 | Kommaseparerad NetvisorKey-lista över fakturor |
status | 1 | open | Önskad status för faktura/fakturor - open - overdue - reminded - requested - collected - paid - creditloss - unsent |
Fakturering och leverans av försäljningsorder
salesorderinvoicing.nv
Med resursen kan du fakturera och/eller leverera en befintlig order.
Parametrar som används i anropet:
Parameter | Förekomster | Beskrivning |
method | 1 | deliveryonly (levereras bara) eller billanddelivery (levereras och faktureras) |
copysublines | 0...1 | Kopiera delsummarader till faktura; true eller false |
updatemidprice | 0...1 | Uppdatera det aktuella genomsnittspriset för produkterna på fakturaraderna; true eller false |
Uppgifter som ska hämtas skickas med anropet som xml (POST-data) enligt bifogad beskrivning.
Nivå | Element | Form och längd | Förekomster | Beskrivning | Exempel |
1 | root | Aggregat | 1 | ||
2 | salesorderinvoicing | Aggregat | 1 | ||
3 | invoicingcustomer | Aggregat | 1 | ||
4 | netvisorkey | Teckensträng | 1 | Faktureringskundens NetvisorID | 1031 |
4 | invoicedate | Datum | 1 | Orderns datum | 2021-04-16 |
Attr. | format | Teckensträng | 1 | Datumtyp, alltid ansi | ansi |
5 | invoicingproductlines | Aggregat | 1 | Rader att fakturera/leverera | |
6 | invoicingproductline | Aggregat | 1 | ||
7 | netvisorkey | Numerisk | 1 | Orderradens NetvisorID | 123 |
7 | deliverydate | Datum | 1 | Orderradens leveransdag | 2021-04-16 |
Attr. | format | Teckensträng | 1 | Leveransdagens typ, alltid ansi. | ansi |
7 | deliveryamount | Teckensträng | 1 | Levererad mängd | 1 |
Attr. | ispostdelivery | Teckensträng | 1 | Är det en restorder; true eller false | false |
7 | inventoryplace | Teckensträng | 0...1 | Lagerplatsens ID | 321 |
Attr. | type | Teckensträng | 1 | Alltid netvisor | netvisor |
Importera kommentar från försäljningsorderns eller försäljningsfakturans behandlingshistorik
salesinvoicecomment.nv
Resursen kan användas för att importera en kommentar till försäljningsordern eller fakturabehandlingshistoriken.
Nivå | Element | Form och längd | Förekomster | Beskrivning | Exempel |
1 | root | Aggregat | 1 | ||
2 | salesinvoicecomments | Aggregat | 1 | ||
3 | salesinvoicecomment | Aggregat | 1 | ||
4 | invoicetype | Teckensträng | 1 | Fakturatyp: - order - invoice (faktura) - invoicedraft (fakturautkast) | invoice |
4 | invoicenetvisorkey | Numerisk | 1 | NetvisorKey för faktur, order eller utkast | 123 |
4 | comment | Teckensträng, max. 500 | 1 | Kommentar för behandlingshistorik. | kommentar |
Hjälpte det här svaret? Ja Nej
Send feedback