Den här guiden beskriver hur Finvoice-format fakturadata importeras till Netvisor.
INNEHÅLL
Allmänt
Finvoice-fakturadata i XML-format kan importeras till Netvisor från andra system. Den enda tillåtna filformatet för import är XML och Finvoice-innehållet måste motsvara dokumentationen som beskrivs i denna guide. För att överföra fakturadata används funktionen "Dataimport". De importerade fakturorna måste vara försäljningsfakturor, import av inköpsfakturor är inte möjligt. Funktionen är tillgänglig för alla företag och användaren måste ha redigeringsrättigheter i Accounting-sektionens specifika funktioner för "Hantera grunddata" och "Importera grunddata". Du hittar dataimportfunktionen i Netvisor-gränssnittet under företagsmenyn: Företagsmeny > Dataimport och export > Dataimport.
För att importera fakturadata behöver du färdig fakturadata enligt Finvoice-standarden. Den äldsta stödda versionen av Finvoice är version 1.2, men nyare Finvoice dataversioner kan också användas.
För importen måste följande steg vara utförda i Netvisor:
Importen kräver att programgränssnittstjänsten aktiveras. Öppna Företagsmeny > Programgränssnitt > Gränssnittsresurser rättigheter -sidan och skriv på Gränssnittsresurser rättigheter -sidan "Färdiga integrationer" i sökfältet "Netvisor fakturadataimport (Finvoice)". Välj Netvisor fakturadataimport (Finvoice) -integration och tillåt integrationen, vilket aktiverar de resurser som behövs för fakturimport.
Dessutom kräver importen att Programgränssnittstjänsten är aktiverad. Aktiveringen sker i Netvisor under Företagsmeny > Programgränssnitt > Programgränssnittskoder > Reglaget måste vara "Aktiverat"
Personen som överför data måste skapa sina egna programgränssnittskoder genom att öppna Företagsmeny > Programgränssnitt > Programgränssnittskoder -sidan och klicka på "Skapa ny gränssnittskod" -knappen. Observera att varje användare som importerar data måste skapa sina egna programgränssnittskoder för att fakturimporten ska fungera. Koderna är inte avgiftsbelagda. Programgränssnittskoderna behöver bara skapas, och dessa koder behöver inte anges någonstans.
Användningen av Netvisors fakturadataimport -funktion ingår i alla paket.
Import av fakturadata (Finvoice) kräver följande resurser för att fungera:
Resurs | Beskrivning |
Import av kunddata till Netvisor | |
Hämta kundlista från Netvisor | |
Import av produktdata till Netvisor | |
Hämta produktlista från Netvisor | |
Import av försäljningsfaktura/försäljningsorder till Netvisor |
Data som används vid fakturainförsel
I tabellen nedan visas vilken information som hämtas från Finvoice-datan och till vilket fält i Netvisor informationen riktas. Sekundär information används om primärt värde inte har angetts i fakturadatan. Exempeldata finns i slutet av guiden och en Excel-version av motsvarighetstabellen kan laddas ner här.
Information i Finvoice-datan, primär | Information i Finvoice-datan, sekundär | Information i Netvisor | Beskrivning |
Fakturanivå | |||
SellerOrganisationTaxCode | SellerPartyIdentifier | Säljarens FO-nummer | Fakturautgivarens, dvs. säljarens FO-nummer, måste vara samma som det som är inställt som Netvisor-miljöns FO-nummer i grunddata. |
DeliveryDate | Leveransdatum | ||
InvoiceNumber | Fakturanummer |
| |
InvoiceDate | Fakturadatum | ||
EpiRemittanceInfoIdentifier | EpiReference | Referensnummer | |
InvoiceDueDate | Betalningsvillkor dagar | Betalningsvillkor skapas genom att subtrahera förfallodatumet (InvoiceDueDate) från fakturadatumet (InvoiceDate) | |
CashDiscountDate | Kassarabatt dagar i betalningsvillkor | ||
CashDiscountPercent | Kassarabatt i betalningsvillkor | ||
DeliveryMethodText | Leveranssätt | ||
DeliveryTermsText | Leveransvillkor | ||
InvoiceFreeText | Text före fakturarader | ||
SellerReferenceIdentifier | Vår referens | ||
BuyerReferenceIdentifier | Er referens | ||
OrderIdentifier | Ordernummer | Visas i Netvisor under fakturans ytterligare information | |
SellerContactPersonName | Säljarens namn | Kopplas till befintlig säljare baserat på namn | |
InvoiceTotalVatIncludedAmount | Valutakod | Valutakod läses från meddelandets attribut. Om belopp anges påverkar det inte fakturans slutbelopp. Fakturans slutbelopp beräknas baserat på fakturaraderna. | |
Attribute: AmountCurrencyIdentifier | Tar det första attributet från det aktuella elementet, så namngivningen är fri, valuta läses härifrån om det är annat än EUR | ||
Fakturakundens information på fakturan | |||
InvoiceRecipientPartyIdentifier | BuyerPartyIdentifier | Kundkod | |
InvoiceRecipientOrganisationName | BuyerOrganisationName | Kundens namn | |
InvoiceRecipientOrganisationName | Kundens namn tillägg | Elementets andra förekomst placeras som namn tillägg | |
InvoiceRecipientOrganisationTaxCode | BuyerOrganisationTaxCode | Kundens FO-nummer | När kundkortet skapas, kundens FO-nummer. OBS. FO-numret måste vara ett giltigt finskt FO-nummer i datan. Om fältet ska innehålla exempelvis ett utländskt VAT-nummer, läses det inte från datan, utan det måste läggas till manuellt på kundkortet efteråt. |
InvoiceRecipientStreetName | BuyerStreetName | Kundens adress | |
InvoiceRecipientPostCodeIdentifier | BuyerPostCodeIdentifier | Kundens postnummer | |
InvoiceRecipientTownName | BuyerTownName | Kundens postort | |
CountryCode | CountryCode | Kundens landskod i ISO3166 format | |
Leveransadressens information på fakturan | |||
DeliveryOrganisationName | Leveransplatsens namn | ||
DeliveryStreetName | Leveransplatsens adress | ||
DeliveryPostCodeIdentifier | Leveransplatsens postnummer | ||
DeliveryTownName | Leveransplatsens postort | ||
CountryCode | Leveransplatsens landskod i ISO3166 format | ||
Kundinformation som läggs till på kundkortet | |||
InvoiceRecipientPhoneNumberIdentifier | BuyerPhoneNumberIdentifier | Telefonnummer | |
InvoiceRecipientEmailaddressIdentifier | BuyerEmailaddressIdentifier | E-postadress | |
InvoiceRecipientEmailaddressIdentifier | BuyerEmailaddressIdentifier | Fakturering e-post | |
ToIdentifier | E-fakturaadress | ||
ToIntermediator | E-fakturaoperatörens operatörskod | ||
Fakturarad | |||
ArticleIdentifier | Produktkod* | När produktkortet skapas eller när det riktas mot produktkortet produktens produktkod. | |
ArticleName | Produktens namn* | När produktkortet skapas eller när det riktas mot produktkortet produktens namn. | |
RowAmount | Totalt (inkl. moms) | Fakturarad totalt, inklusive moms | |
RowDiscountPercent | Rabattprocent | ||
DeliveredQuantity | Antal | Antal fakturerade produkter | |
RowVatRatePercent | Momsprocent | Om det inte anges, kommer fakturan att ha moms% 0 | |
RowNormalProposedAccountIdentifier | Kontoförslag | ||
RowFreeText | Radbeskrivning | ||
RowIdentifier | Ordernummer | ||
Fakturaradens kalkylobjekt | |||
RowDefinitionHeaderText | Kostnadsobjektrubrik | ||
RowDefinitionValue | Kostnadsobjektets namn | ||
Produktinformation som läggs till på produkten | |||
ArticleIdentifier | Produktkod | ||
ArticleName | Produkt | ||
RowAmount | Totalt (inkl. moms) | Fakturarad totalt, inklusive moms | |
RowDiscountPercent | - | ||
DeliveredQuantity | - | ||
Attribute: QuantityUnitCode | Enhet | ||
RowVatRatePercent | Momsprocent | Tar det första attributet från det aktuella elementet, så namngivningen är fri | |
Kommentarrad | |||
RowFreeText | Kommentarrad | Elementet måste vara det enda elementet inom InvoiceRow -elementet |
För att få skandinaviska bokstäver (å,ä,ö) att visas korrekt måste datan vara i ISO/IEC 8859-15 -kodad form.
Med Finvoice-format fakturadata är det möjligt att importera kostnadsobjektrubriker och kostnadsobjekt från RowDefinitionHeaderText och RowDefinitionValue -fälten. Om import av kostnadsobjektrubriker och kostnadsobjekt ska förhindras, kontakta Netvisors kundtjänst.
Om kunden skapas vid importen, läses både e-fakturaadress och e-postfakturaadress från fakturadatan till kundkortet om de finns i datan. Om kunden redan finns i Netvisor före importen (dvs. kundkoden som anges i datan finns i Netvisor), måste e-fakturaadress/e-postfakturaadress manuellt redigeras på kundkortet eller importeras till kundregistret med Import av kunddata. Om fakturorna i framtiden ska riktas mot ett befintligt kundkort i Netvisor, måste kundkoden i Netvisor anges i datan (InvoiceRecipientPartyIdentifier eller BuyerPartyIdentifier).
*Om produkten inte hittas med produktkoden (ArticleName) eller produktens namn (ArticleName), skapas produkten i Netvisor enligt fakturadatan. Om produkten redan finns i Netvisor, uppdateras inte informationen från fakturadatan till Netvisors produkt.
Produktens enhetspris beräknas baserat på radens summa, levererat antal och eventuell rabatt.
Fakturans slutbelopp beräknas baserat på fakturaraderna.
En överföringsfil kan innehålla flera fakturor. Fakturorna behöver då inte importeras en i taget.
Steg för dataimport
Öppna Företagsmenyn och välj "Dataimport"
Välj datatypen "Faktura/betalning XML" (se bild nedan, punkt 1) och klicka på "Bläddra" (2)
Hitta Finvoice-filen som innehåller fakturadata och klicka på "Importera data" -knappen (3). Detta startar dataöverföringen till Netvisor.
Om det inte uppstår några fel vid importen, visas en specifikation av de importerade data och länkar till de skapade materialen efter importen.
Import av fakturadata skapar automatiskt kunden som används på fakturan och de använda produkterna i Netvisor om de inte redan finns. Observera att kundens e-fakturaadress inte sparas på kundkortet vid denna tidpunkt. Om kunden och produkterna som används på fakturan finns i Netvisor, riktas informationen mot den befintliga kunden och produkterna.
Om det finns fel i den importerade datan, visas ett felmeddelande som förklarar varför datan inte kan importeras till systemet. Under felmeddelandet visas ett editorfönster där användaren inte kan göra ändringar i den importerade datan, utan ändringarna måste göras på den ursprungliga Finvoice-datan. Efter korrigering kan datan importeras igen för bearbetning. Om datan innehåller flera fakturor, kommer de fakturor som är i rätt format att importeras direkt. Vänligen redigera inte de importerade fakturorna i gränssnittet efter importen.
Felmeddelandet "INVALID_DATA :: Tiedon muoto virheellinen:. XML-sanoman validointi epäonnistui: Could not validate xml: The element 'invoicelines' has incomplete content. List of possible elements expected: 'invoiceline'." hänvisar till att det finns brister i fakturaraderna eller att fälten inte motsvarar de fält som beskrivs i denna guide. Vanligtvis beror problemet på att datan har "InvoicedQuantity" när det borde vara "DeliveredQuantity".
Finvoice exempel
I exemplen nedan visas vilka minimidata som måste finnas i Finvoice-datan för att importera en försäljningsfaktura, samt maximidata som läses från datan. Finvoice-datan kan innehålla annan information enligt Finvoice-standarden, men den läses inte till Netvisor.
Finvoice med minimidata:
<?xml version="1.0" encoding="ISO-8859-15"?>
<?xml-stylesheet type="text/xsl" href="Finvoice.xsl"?>
<Finvoice>
<SellerPartyDetails>
<SellerOrganisationTaxCode>FI12345678</SellerOrganisationTaxCode>
</SellerPartyDetails>
<BuyerPartyDetails>
<BuyerOrganisationName>Esimerkkiasiakas</BuyerOrganisationName>
</BuyerPartyDetails>
<InvoiceDetails>
<InvoiceNumber>100</InvoiceNumber>
<InvoiceDate Format="CCYYMMDD">20230124</InvoiceDate>
<InvoiceDueDate Format="CCYYMMDD">20230207</InvoiceDueDate>
</InvoiceDetails>
<InvoiceRow>
<ArticleName>Esimerkkituote</ArticleName>
<DeliveredQuantity QuantityUnitCode="pcs">10,00</DeliveredQuantity>
<RowAmount AmountCurrencyIdentifier="EUR">100,00</RowAmount>
</InvoiceRow>
</Finvoice>
Finvoice med maximidata:
<?xml version="1.0" encoding="ISO-8859-15"?>
<?xml-stylesheet type="text/xsl" href="Finvoice.xsl"?>
<Finvoice>
<MessageTransmissionDetails>
<MessageReceiverDetails>
<ToIdentifier>FI109700021497</ToIdentifier>
<ToIntermediator>NDEAFIHH</ToIntermediator>
</MessageReceiverDetails>
</MessageTransmissionDetails>
<SellerPartyDetails>
<SellerPartyIdentifier>1234567-8</SellerPartyIdentifier>
<SellerOrganisationTaxCode>FI12345678</SellerOrganisationTaxCode>
</SellerPartyDetails>
<InvoiceRecipientPartyDetails>
<InvoiceRecipientPartyIdentifier>1967543-8</InvoiceRecipientPartyIdentifier>
<InvoiceRecipientOrganisationName>Esimerkkiasiakas5</InvoiceRecipientOrganisationName>
<InvoiceRecipientOrganisationName>c/o uusi revisionsbyrå</InvoiceRecipientOrganisationName>
<InvoiceRecipientOrganisationTaxCode>FI19675438</InvoiceRecipientOrganisationTaxCode>
<InvoiceRecipientPostalAddressDetails>
<InvoiceRecipientStreetName>Soratie 2</InvoiceRecipientStreetName>
<InvoiceRecipientTownName>OULU</InvoiceRecipientTownName>
<InvoiceRecipientPostCodeIdentifier>00000</InvoiceRecipientPostCodeIdentifier>
<CountryCode>FI</CountryCode>
</InvoiceRecipientPostalAddressDetails>
</InvoiceRecipientPartyDetails>
<BuyerCommunicationDetails>
<BuyerPhoneNumberIdentifier>000000</BuyerPhoneNumberIdentifier>
<BuyerEmailaddressIdentifier>[email protected]</BuyerEmailaddressIdentifier>
</BuyerCommunicationDetails>
<DeliveryPartyDetails>
<DeliveryOrganisationName>Esimerkkitoimitus5</DeliveryOrganisationName>
<DeliveryPostalAddressDetails>
<DeliveryStreetName>Katu</DeliveryStreetName>
<DeliveryTownName>Kaupunki</DeliveryTownName>
<DeliveryPostCodeIdentifier>00000</DeliveryPostCodeIdentifier>
<CountryCode>FI</CountryCode>
</DeliveryPostalAddressDetails>
</DeliveryPartyDetails>
<DeliveryDetails>
<DeliveryDate Format="CCYYMMDD">20230223</DeliveryDate>
<DeliveryMethodText>Leveranssätt</DeliveryMethodText>
<DeliveryTermsText>Leveransvillkor</DeliveryTermsText>
</DeliveryDetails>
<InvoiceDetails>
<InvoiceNumber>202</InvoiceNumber>
<InvoiceDate Format="CCYYMMDD">20230223</InvoiceDate>
<SellerReferenceIdentifier>Vår referens</SellerReferenceIdentifier>
<OrderIdentifier>Ordernummer</OrderIdentifier>
<BuyerReferenceIdentifier>Er referens</BuyerReferenceIdentifier>
<InvoiceTotalVatIncludedAmount AmountCurrencyIdentifier="USD">0</InvoiceTotalVatIncludedAmount>
<InvoiceFreeText>Vapaa teksti</InvoiceFreeText>
<PaymentTermsDetails>
<InvoiceDueDate Format="CCYYMMDD">20230309</InvoiceDueDate>
<CashDiscountDate>20230301</CashDiscountDate>
<CashDiscountPercent>10</CashDiscountPercent>
</PaymentTermsDetails>
</InvoiceDetails>
<InvoiceRow>
<RowFreeText>Kommentarrad</RowFreeText>
</InvoiceRow>
<InvoiceRow>
<ArticleIdentifier>1x1</ArticleIdentifier>
<ArticleName>Esimerkkituote5</ArticleName>
<DeliveredQuantity
QuantityUnitCode="kpl">10,00</DeliveredQuantity>
<RowIdentifier>Ordernummer</RowIdentifier>
<RowFreeText>Radbeskrivning</RowFreeText>
<RowDiscountPercent>10,00</RowDiscountPercent>
<RowVatRatePercent>24,00</RowVatRatePercent>
<RowAmount>90,00</RowAmount>
<RowNormalProposedAccountIdentifier>3000</RowNormalProposedAccountIdentifier>
<RowDefinitionDetails>
<RowDefinitionHeaderText>Projekti</RowDefinitionHeaderText>
<RowDefinitionValue>Projekti 15</RowDefinitionValue>
</RowDefinitionDetails>
</InvoiceRow>
<EpiDetails>
<EpiIdentificationDetails>
<EpiReference>123</EpiReference>
</EpiIdentificationDetails>
<EpiPaymentInstructionDetails>
<EpiRemittanceInfoIdentifier>123</EpiRemittanceInfoIdentifier>
</EpiPaymentInstructionDetails>
</EpiDetails>
</Finvoice>
Nyckelord: Fakturadata, Finvoice, Netvisor, XML, Försäljningsfaktura, Programgränssnitt, Import
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.