Siirry pääsisältöön

Verkkolaskusanoman muodostuminen Netvisorissa

Tässä ohjeessa kuvataan, miten Netvisor muodostaa laskuaineiston Finvoice 3.0 -formaatissa. Ohjeessa käydään läpi verkkolaskutuksen tiedot, lähettäjän ja vastaanottajan tiedot, toimitustiedot, laskun perustiedot, laskurivit sekä laskun summa ja ALV-tiedot.

Netvisor lähettää ja vastaanottaa laskuaineistot Finvoice 3.0 -formaatissa. Tässä ohjeessa kuvataan, mikä kenttä Netvisorissa vastaa riviä laskuaineistolla. Alla esitetään kuva- ja sanomaesimerkein, miten sanoma muodostuu Netvisorin käyttöliittymään verraten.

Verkkolaskutustiedot

Voit avata asiakaskortin valitsemalla Myynti > Asiakkaat > Asiakaslistaus > valitse asiakas.

Asiakaskortille tallennettu verkkolaskuosoite- ja operaattoritieto talletetaan Finvoice-sanoman "kirjekuoreen" seuraaviin kenttiin:

<eb:To>
<eb:PartyId>FI0799201901261467</eb:PartyId>
<eb:Role>Receiver</eb:Role>
</eb:To>
<eb:To>
<eb:PartyId>NETBFI99</eb:PartyId>
<eb:Role>Intermediator</eb:Role>
</eb:To>

Lähettäjän tiedot

Voit avata Yrityksen perustiedot -sivun valitsemalla Asetukset > Yrityksen perustiedot.

Lähettäjän tiedot siirtyvät Yrityksen perustiedot -sivun tiedoista alla oleviin kenttiin. Y-tunnuksen perusteella muodostuu sanomalle myös yrityksen ALV-numero (SellerOrganisationTaxCode) sekä yrityksen OVT-tunnus (SellerOrganisationUnitNumber).


​

<SellerPartyDetails>
<SellerPartyIdentifier>1478523-8</SellerPartyIdentifier>
<SellerOrganisationName>Minna K:n testiyritys</SellerOrganisationName>
<SellerOrganisationTaxCode>FI14785238</SellerOrganisationTaxCode>
<SellerPostalAddressDetails>
<SellerStreetName>Yrityskuja 2</SellerStreetName>
<SellerTownName>Lappeenranta</SellerTownName>
<SellerPostCodeIdentifier>53100</SellerPostCodeIdentifier>
<CountryCode>FI</CountryCode>
<CountryName>Finland</CountryName>
<SellerPostOfficeBoxIdentifier></SellerPostOfficeBoxIdentifier>
</SellerPostalAddressDetails>
</SellerPartyDetails>
<SellerCommunicationDetails>
<SellerPhoneNumberIdentifier>[yrityksen puhelinnumero]</SellerPhoneNumberIdentifier>
<SellerEmailaddressIdentifier>[yhteyshenkilön sähköpostiosoite]</SellerEmailaddressIdentifier>
</SellerCommunicationDetails>
<SellerInformationDetails>
<SellerHomeTownName>Lappeenranta</SellerHomeTownName>
<SellerVatRegistrationText>Alv.Rek</SellerVatRegistrationText>
<SellerPhoneNumber>[yrityksen puhelinnumero]</SellerPhoneNumber>
<SellerFaxNumber>[yrityksen faksinumero]</SellerFaxNumber>
<SellerCommonEmailaddressIdentifier>[yhteyshenkilön sähköpostiosoite]</SellerCommonEmailaddressIdentifier>
<SellerWebaddressIdentifier>http://kotisivunosoite.fi</SellerWebaddressIdentifier>
<SellerAccountDetails>
<SellerAccountID IdentificationSchemeName="IBAN">FI1099201901260055</SellerAccountID>
<SellerBic IdentificationSchemeName="BIC">NETBFI99</SellerBic>
</SellerAccountDetails>
</SellerInformationDetails>

Lähettäjän pankkitilit menevät verkkolaskusanomalla pankin nimen mukaan aakkosjärjestykseen (SellerAccountID). Järjestyksen mukaan viimeinen pankkitili menee sanomalle lähettäjän IBAN-tilinumeroksi (EpiAccountID). Pankkitilit määritetään pankkitilien hallinnassa.

Vastaanottajan tiedot

Voit avata asiakaskortin valitsemalla Myynti > Asiakkaat > Asiakaslistaus > valitse asiakas.

Vastaanottajan tiedot tulevat asiakaskortilta seuraavasti:

  • Asiakaskortille tallennettu osoite tallentuu BuyerPartyDetails- ja BuyerPostalAddressDetails-osioihin.

  • Jos verkkolaskuaineistolla tulee välittää asiakaskohtainen tunnus (esim. tehdasnumero), syötä tunnus kenttään "Vastaanottajan OVT-tunnus, jos tieto poikkeaa yrityksen y-tunnuksesta". Tieto tallentuu laskusanomalle kenttään BuyerOrganisationUnitNumber.

  • Jos haluat välittää vastaanottajan toimipaikkatunnuksen, lisää toimipaikkatunnus toimipaikan taakse. Tieto tallentuu verkkolaskusanomalla kenttään BuyerSiteCode.


​


​

Asiakkaan oletusyhteyshenkilön tiedoista laskusanomalle tallentuu yhteyshenkilön nimi, puhelinnumero ja sähköpostiosoite, jos tiedot on tallennettu asiakaskortille. Lue lisää asiakaskortin tiedoista täältä>>

<BuyerPartyDetails>
<BuyerPartyIdentifier>3061326-2</BuyerPartyIdentifier>
<BuyerOrganisationName>Aurinkoinen puutarha</BuyerOrganisationName>
<BuyerOrganisationTaxCode>FI30613262</BuyerOrganisationTaxCode>
<BuyerPostalAddressDetails>
<BuyerStreetName>Puutarhakuja 1</BuyerStreetName>
<BuyerTownName>Lappeenranta</BuyerTownName>
<BuyerPostCodeIdentifier>53100</BuyerPostCodeIdentifier>
<CountryCode>FI</CountryCode>
<CountryName>Finland</CountryName>
</BuyerPostalAddressDetails>
</BuyerPartyDetails>
<BuyerOrganisationUnitNumber>00378562123</BuyerOrganisationUnitNumber>
<BuyerSiteCode> Toimipaikan toimipaikkatunnus</BuyerSiteCode>
<BuyerContactPersonName>Anni Aurinkoinen</BuyerContactPersonName> <!-- HUOM! oletusyhteyshenkilön tulee olla perustettuna asiakaskortille -->
<BuyerCommunicationDetails>
<BuyerPhoneNumberIdentifier>[yhteyshenkilön puhelinnumero]</BuyerPhoneNumberIdentifier> <!-- HUOM! tiedon tulee olla asiakaskortille perustetun oletusyhteyshenkilön tiedoissa -->
<BuyerEmailaddressIdentifier>[yhteyshenkilön sähköpostiosoite]</BuyerEmailaddressIdentifier> <!-- HUOM! tiedon tulee olla asiakaskortille perustetun oletusyhteyshenkilön tiedoissa -->
</BuyerCommunicationDetails>

Toimitustiedot

Voit avata asiakkaan toimipaikat valitsemalla Myynti > Asiakkaat > Asiakaslistaus > valitse asiakas > Toimipaikat.

Asiakaskortilta löytyvä oletustoimipaikka osoitteineen viedään sanoman DeliveryPartyDetails-osioon.


​

<DeliveryPartyDetails>
<DeliveryOrganisationName>Joutsenon toimipaikka</DeliveryOrganisationName>
<DeliveryPostalAddressDetails>
<DeliveryStreetName>Joutsenkuja 3</DeliveryStreetName>
<DeliveryTownName>Lappeenranta</DeliveryTownName>
<DeliveryPostCodeIdentifier>54100</DeliveryPostCodeIdentifier>
<CountryCode>FI</CountryCode>
<CountryName>Finland</CountryName>
</DeliveryPostalAddressDetails>
</DeliveryPartyDetails>
<DeliverySiteCode>toimipaikan koodi</DeliverySiteCode> Tulee toimipaikkatunnus-kentästä.

Muut toimitustiedot


​


​

<DeliveryDetails>
<DeliveryDate Format="CCYYMMDD">20211021</DeliveryDate>
<DeliveryMethodText>Viedään</DeliveryMethodText>
<DeliveryTermsText>Vapaasti toimittajalla</DeliveryTermsText>
<WaybillIdentifier>[viitteenne_kenttä]</WaybillIdentifier> <!-- Löytyy myös sanoman riviltä <BuyerReferenceIdentifier> -->
</DeliveryDetails>

OrderIdentifier on varattu tilausnumerolle. Tieto on laskunäkymän lisätiedoissa kohdassa Myyntilaskun toiminnot > Lisätiedot > "Ulkoinen tilausnumero" -kenttä. Jos syötät ulkoisen tilausnumeron rivikohtaisesti kenttään Ulkoinen tilausnumero, tieto tulee sanomalle RowIdentifier-kenttään.


​

Laskun perustiedot


​


​

<InvoiceDetails>
<InvoiceTypeCode>INV01</InvoiceTypeCode>
<InvoiceTypeText>LASKU</InvoiceTypeText>
<OriginCode>Original</OriginCode>
<InvoiceNumber>53</InvoiceNumber>
<InvoiceDate Format="CCYYMMDD">20211021</InvoiceDate>
<SellerReferenceIdentifier>[viitteemme_kenttä]</SellerReferenceIdentifier> <!-- Viitteemme-kentän maksimipituus on 70 merkkiä -->
<SellersBuyerIdentifier>2323</SellersBuyerIdentifier>Asiakaskoodi
<AgreementIdentifier>[sopimustunnus_kenttä]</AgreementIdentifier>
<BuyerReferenceIdentifier>[viitteenne_kenttä]</BuyerReferenceIdentifier> <!-- Löytyy myös sanoman riviltä: <WaybillIdentifier>. Kentän maksimipituus on 70 merkkiä -->
<AccountDimensionText>kustannuspaikkatieto</AccountDimensionText> <!-- Teksti sanomalle tulee Myyntilaskun toiminnot > Lisätiedot > Kustannuspaikkatieto -kentästä. -->
<ShortProposedAccountIdentifier>[Tiliöintiehdotus]</ShortProposedAccountIdentifier> <!-- Tieto tulee Myyntilaskun toiminnot > Lisätiedot > Tiliöintiehdotus -->
<NormalProposedAccountIdentifier>[Tiliöintiehdotus]</NormalProposedAccountIdentifier> <!-- Tieto tulee Myyntilaskun toiminnot > Lisätiedot > Tiliöintiehdotus -->
*
*
*
<PaymentTermsDetails>
<PaymentTermsFreeText>14 päivää netto</PaymentTermsFreeText>
<InvoiceDueDate Format="CCYYMMDD">20211104</InvoiceDueDate>
<PaymentOverDueFineDetails>
<PaymentOverDueFineFreeText>Viivästyskorko 10,50%</PaymentOverDueFineFreeText> <!-- Huom! Viivästyskorkotiedot löytyvät laskun lisätiedot -sivulta -->
<PaymentOverDueFinePercent>10,50</PaymentOverDueFinePercent>
</PaymentOverDueFineDetails>
</PaymentTermsDetails>
</InvoiceDetails>

Laskurivit ja laskun kommenttirivit

Alla näkyy, miten laskurivit, riviselite ja kommenttirivit siirtyvät verkkolaskusanomalle:


​


​

<InvoiceRow>
<SubInvoiceRow>
<SubRowFreeText>[teksti ennen laskurivejä]</SubRowFreeText>
</SubInvoiceRow>
</InvoiceRow>
<InvoiceRow>
<ArticleIdentifier>PU258</ArticleIdentifier>
<ArticleName>Puutarhatonttu</ArticleName>
<DeliveredQuantity QuantityUnitCode="kpl">1,00</DeliveredQuantity>
<InvoicedQuantity QuantityUnitCode="kpl">1,00</InvoicedQuantity>
<RowIdentifier>[Ulkoinen tilausnumero (rivikohtainen)]</RowIdentifier>
<UnitPriceAmount AmountCurrencyIdentifier="EUR" UnitPriceUnitCode="kpl">85,00</UnitPriceAmount>
<RowDeliveryIdentifier>Laskurivin toimitusnumero</RowDeliveryIdentifier>
<RowFreeText>[riviselite]</RowFreeText>
<RowDiscountPercent>0,00</RowDiscountPercent>
<RowVatRatePercent>25,50</RowVatRatePercent>
<RowVatAmount AmountCurrencyIdentifier="EUR">20,40</RowVatAmount>
<RowVatExcludedAmount AmountCurrencyIdentifier="EUR">85,00</RowVatExcludedAmount>
<RowAmount AmountCurrencyIdentifier="EUR">105,40</RowAmount>
<RowShortProposedAccountIdentifier>[Asiakkaan tiliöintiehdotus]</RowShortProposedAccountIdentifier>
<RowNormalProposedAccountIdentifier>[Asiakkaan tiliöintiehdotus]</RowNormalProposedAccountIdentifier>
<RowAccountDimensionText>[Asiakkaan kustannuspaikka]</RowAccountDimensionText>
<RowDeliveryIdentifier>[Toimitusnumero]</RowDeliveryIdentifier>
</InvoiceRow>
<InvoiceRow>
<SubInvoiceRow>
<SubRowFreeText>[kommenttirivi]</SubRowFreeText>
</SubInvoiceRow>
</InvoiceRow>
<InvoiceRow>
<ArticleIdentifier>T123</ArticleIdentifier>
<ArticleName>Termospullo</ArticleName>
<DeliveredQuantity QuantityUnitCode="kpl">1,00</DeliveredQuantity>
<UnitPriceAmount AmountCurrencyIdentifier="EUR" UnitPriceUnitCode="kpl">3,95</UnitPriceAmount>
<RowFreeText></RowFreeText>
<RowDiscountPercent>0,00</RowDiscountPercent>
<RowVatRatePercent>14,00</RowVatRatePercent>
<RowVatCode>S</RowVatCode> Laskurivin verokoodi. Koodit: O= Veroton palvelu, E= Yhteisömyynti, G= Veroton myynti ulkomaille (kolmannet maat), S= Normaali veroprosentti, Z= veroton tuote, AE= Käännetty ALV.
<RowVatAmount AmountCurrencyIdentifier="EUR">0,55</RowVatAmount>
<RowVatExcludedAmount AmountCurrencyIdentifier="EUR">3,95</RowVatExcludedAmount>
<RowAmount AmountCurrencyIdentifier="EUR">4,50</RowAmount>
</InvoiceRow>
<InvoiceRow>
<SubInvoiceRow>
<SubRowFreeText>[Teksti laskurivien jälkeen]</SubRowFreeText>
</SubInvoiceRow>
</InvoiceRow>
<!-- Laskun loppusumma lasketaan sanomalle laskurivien summista. -->

Voit lisätä tuotteen EAN-koodin tuotekortille valitsemalla Tuotteet > Tuotelistaus > valitse tuote > "Hallinnoi tietoja" > Perustietojen muokkaus > Ensisijainen EAN-koodi.

EAN-koodin saa välitettyä asiakkaalle verkkolaskuaineistolla lisäämällä tuotteen EAN-koodin tuotekortille. EAN-koodin tulee olla muodoltaan EAN13. Tämä tarkoittaa 13 merkkiä pitkää aineistoa.
​
Viivakoodi näkyy verkkolaskusanomalla näin. Tieto tulee laskun tuoteriveillä.

<InvoiceRow>

<ArticleIdentifier>123456789</ArticleIdentifier> Tuotekoodi

<ArticleName>Viivakoodikäsittelyn testinimike</ArticleName> Tuotteen nimi

<EanCode>6416240059601</EanCode> Tuotteelle annettu viivakoodi

Laskun loppusumma- ja ALV-tiedot (sijoittuu sanomalla InvoiceDetails-osioon)


​


​

<InvoiceTotalVatExcludedAmount AmountCurrencyIdentifier="EUR">88,95</InvoiceTotalVatExcludedAmount>
<InvoiceTotalVatAmount AmountCurrencyIdentifier="EUR">20,95</InvoiceTotalVatAmount>
<InvoiceTotalVatIncludedAmount AmountCurrencyIdentifier="EUR">109,90</InvoiceTotalVatIncludedAmount>
<AccountDimensionText></AccountDimensionText>
<VatSpecificationDetails>
<VatBaseAmount AmountCurrencyIdentifier="EUR">85,00</VatBaseAmount>
<VatRatePercent>24,00</VatRatePercent>
<VatRateAmount AmountCurrencyIdentifier="EUR">20,40</VatRateAmount>
</VatSpecificationDetails>
<VatSpecificationDetails>
<VatBaseAmount AmountCurrencyIdentifier="EUR">3,95</VatBaseAmount>
<VatRatePercent>14,00</VatRatePercent>
<VatRateAmount AmountCurrencyIdentifier="EUR">0,55</VatRateAmount>
</VatSpecificationDetails>

Usein kysyttyjä kysymyksiä

Kysymys: Miten Netvisor muodostaa Finvoice 3.0 -laskuaineiston tiedot lähettäjän osalta?

Vastaus: Lähettäjän tiedot tulevat Yrityksen perustiedot -sivulta. Y-tunnuksen perusteella muodostuvat SellerOrganisationTaxCode (ALV-numero) ja SellerOrganisationUnitNumber (OVT-tunnus), ja pankkitilitiedot viedään SellerAccountDetails- ja EpiAccountID-tietoihin.

Kysymys: Mistä vastaanottajan tiedot tulevat Finvoice-sanomalle?

Vastaus: Vastaanottajan tiedot tulevat asiakaskortilta. Osoitetiedot tallentuvat BuyerPartyDetails- ja BuyerPostalAddressDetails-osioihin, asiakaskohtainen tunnus BuyerOrganisationUnitNumber-kenttään ja toimipaikkatunnus BuyerSiteCode-kenttään.

Kysymys: Miten oletusyhteyshenkilön tiedot siirtyvät laskusanomalle?

Vastaus: Asiakkaan oletusyhteyshenkilön nimi, puhelinnumero ja sähköpostiosoite tallentuvat BuyerContactPersonName- ja BuyerCommunicationDetails-osioihin, jos oletusyhteyshenkilö on perustettu asiakaskortille ja tiedot on täytetty.

Kysymys: Miten toimitusosoite ja toimipaikkakoodi viedään Finvoice-sanomalle?

Vastaus: Asiakaskortin oletustoimipaikka osoitteineen viedään DeliveryPartyDetails-osioon, ja toimipaikkatunnus tallentuu DeliverySiteCode-kenttään toimipaikkatunnus-kentän perusteella.

Kysymys: Mistä kentistä laskun perustiedot, viitteet ja maksuehdot tulevat?

Vastaus: Laskun perustiedot tulevat InvoiceDetails-osioon. Viitteemme-kenttä tallentuu SellerReferenceIdentifier-kenttään, Viitteenne-kenttä BuyerReferenceIdentifier- ja WaybillIdentifier-kenttiin, kustannuspaikkatieto AccountDimensionText-kenttään ja tiliöintiehdotus ShortProposedAccountIdentifier- ja NormalProposedAccountIdentifier-kenttiin. Maksuehdot ja viivästyskorko tulevat PaymentTermsDetails- ja PaymentOverDueFineDetails-osioihin laskun lisätiedoista.

Kysymys: Miten laskurivit, riviselitteet ja kommenttirivit näkyvät Finvoice-sanomalla?

Vastaus: Laskurivit tallentuvat InvoiceRow-osioihin. Riviselite tallentuu RowFreeText-kenttään, kommenttirivit SubInvoiceRow/SubRowFreeText-kenttiin ja rivikohtainen ulkoinen tilausnumero RowIdentifier-kenttään. Rivien verotiedot tallentuvat RowVatRatePercent-, RowVatCode-, RowVatAmount- ja RowAmount-kenttiin.

Kysymys: Miten EAN-koodi välitetään verkkolaskulla?

Vastaus: Kun lisäät tuotteelle ensisijaisen EAN-koodin tuotekortille (muodossa EAN13, 13 merkkiä), koodi välittyy laskun tuoterivillä EanCode-kenttään Finvoice-sanomalla.

Kysymys: Miten laskun loppusumma ja ALV-erittely muodostuvat Finvoice-sanomalle?

Vastaus: Laskun loppusumma lasketaan laskurivien summista ja tallentuu InvoiceTotalVatExcludedAmount-, InvoiceTotalVatAmount- ja InvoiceTotalVatIncludedAmount-kenttiin. ALV-erittely tallentuu VatSpecificationDetails-osioihin, joissa näkyvät veropohja, veroprosentti ja veron määrä.

Avainsana: Finvoice, verkkolasku, Y-tunnus, OVT-tunnus

Vastasiko tämä kysymykseesi?