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