Resurser – Försäljningsfakturor, försäljningsorder och kreditnotor

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:

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:

Parametern InvoiceStatus kan ha följande värden:

Svar:

Skillnader i returvärden mellan fakturor och orderlistor:

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:

Exempel: getsalesinvoice.nv?netvisorkey=1234&pdfimage=pdf&showprocesshistory=1
Exempel: getsorder.nv?netvisorkey=1234&pdfimage=pdf&showprocesshistory=1

Svar:

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:

Uppgifter som ska hämtas skickas med anropet som xml (POST-data) enligt bifogad beskrivning. Observera att beskrivningen är uppdelad i flera tabeller:

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:

Alternativt kan du hämta en kommentarsrad, varvid InvoiceLine-aggregatets struktur är följande:

Fortsätt med den valda strukturen enligt följande:

*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

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:

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:

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:

Uppgifter som ska hämtas skickas med anropet som xml (POST-data) enligt bifogad beskrivning. 

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. 

Hjälpte det här svaret? Ja Nej