Verkkolaskuaineisto (Lemonsoft Verkkolasku)

 

Lemonsoft Verkkolaskun voi lähettää Finvoicen 2.01- tai 3.0-muodossa. Finvoice 3.0 -muotoon on mahdollista yhdistää EN16931-standardin mukainen semanttinen malli. Toimintokeskuksen asetuksella FINVOICE_VERSION voit määrittää mitä Finvoicen versiota aineistonmuodostuksessa käytetään ja SEMANTIC_MODEL-asetuksen avulla voit puolestaan määritellä muodostaako ohjelma Lemonsoft Verkkolaskusta semanttisen mallin vai ei.

 

Semanttinen malli

 

Semanttinen malli tarkoittaa sitä, että verkkolaskuaineisto on rakennettu EN16931-standardin mukaan ja sisältää <SpecificationIdentifier>EN16931<SpecificationIdentifier>-elementin.  EN163931-standardin tuki on ainoastaan laskuille, joissa on verottomat à-hinnat. Huomioi myös, että koontilaskutus ei ole sallittu, sillä EN163931-standardissa on määritelty, että lasku saa sisältää vain yhden tilauksen/sopimuksen.

Huomaa! Emme suosittele semanttisen mallin käyttöönottoa, mikäli laskun vastaanottaja ei sitä vaadi! Semanttinen aineisto käy läpi tarkemman rakennetarkistuksen, jonka takia lasku herkemmin hylätään, mikäli jokin tieto puuttuu laskulta.

Tarvittaessa voit määritellä asiakaskohtaisesti muodostaako ohjelma asiakkaan verkkolaskusta semanttisen mallin. Tee määrittely asiakasrekisterin Laskutus ja tilaukset -välilehden Verkkolaskuoptiot-alavälilehdellä. Asiakaskohtainen asetus on voimakkaampi kuin toimintokeskukseen määritelty asetus.

 

A screenshot of a computer

Description automatically generated
Kuva: Voit määritellä asiakaskohtaisesti, muodostaako ohjelma verkkolaskuaineistosta semanttisen mallin.

 

Suosittelemme käyttämään asiakaskohtaista asetusta niille asiakkaille, jotka vaativat semanttista mallia. Esimerkiksi Valtiokonttori on ilmoittanut vastaanottavansa vain semanttisen mallin laskuja. Lue lisää julkishallinnolle lähetettävien verkkolaskujen tietosisällön vaatimuksista osoitteesta https://www.valtiokonttori.fi/.

 

Rivien ryhmittely

 

Toimintokeskuksen asetuksella ROW_GROUPING voit lähettää asiakkaalle suppeamman finvoice-aineiston, jossa tiedot ovat ryhmiteltynä verokannoittain tai verokannoittain ja tuoteryhmittäin. Asetus on tuettuna Lemonsoft Verkkolasku- ja Lemonsoft Rahoitus -laskutustavoilla.

 

ROW_GROUPING-asetuksen arvot ovat:

0 = Ei ryhmittelyä
1 = Verokannoittain
2 = Verokannoittain ja tuoteryhmittäin.

 

Voit myös määritellä rivien ryhmittelyn asiakaskohtaisesti. Lisää asiakasrekisterin Laskutus ja tilaukset -välilehdellä Verkkolaskuoptiot-alavälilehden Aineisto-valikkoon haluamasi ryhmittelytapa. Asiakkaalle määritelty ryhmittelytapa on voimakkaampi kuin toimintokeskuksen. Ryhmittely verokannoittain -valinta vie laskurivin selitteeksi ”Laskutettu + käytetty vero-%”. Ryhmittely verokannoittain ja tuoteryhmittäin -valinta vie laskurivin selitteeksi tuoteryhmän nimen ja käytetyn verokannan, esimerkiksi ”Tuotteet 24,00 %”. Lue lisää tuoteryhmistä ohjeesta Tuoteryhmä.

 


Kuva: Voit määritellä asiakaskohtaisesti, ryhmitelläänkö aineiston rivit.

 

 

Verokoodit

 

Finvoice 3.0 -muodon aineistossa pakollisena tietona ovat verokoodit. Verokoodi siirtyy aineistoon myyntitilin verokäsittelytavan perusteella. Verottomissa palveluissa on myös pakollista syöttää veron selite, joten syötä selite tilikartan Lakipykälä-kenttään. Lue lisää Rakennusalan käännetty arvonlisäverovelvollisuus.

 

Verokäsittely

Verokoodi

Englanti

Suomi

Kotimaa 24/14/10 %

S

Standard rate

Normaali veroprosentti

Ei/Kotimaa

Z

Zero rated goods

Veroton tuote

EU tavarakauppa

E

Exempt from Tax

Yhteisömyynti

EU palvelu

E

Exempt from Tax

Yhteisömyynti

EU ulkopuoli tavarat

G

Free export item, VAT not charged

Veroton myynti ulkomaille (kolmannet maat)

Ulkomaa ei pääsäännön alainen

Z

Zero rated goods

Veroton tuote

Rakentamispalvelu

AE

Vat Reverse Charge

Käännetty ALV

Omankäytön alv

S

Standard rate

Normaali veroprosentti

Ahvenanmaa

G

Free export item, VAT not charged

Veroton myynti ulkomaille (kolmannet maat)

EU Ulkopuoli palvelu

G

Free export item, VAT not charged

Veroton myynti ulkomaille (kolmannet maat)

Marginaalivero Tilityypit 152 tai 154

AB

Exempt for resale

Marginaalivero

 

QuantityUnitCodeUN-elementin oletusarvo on C62. Voit muokata yksikköarvoa Valintalistat-näytön Varastoyksikkö-listan EN16931 Yksikkö -kentässä.

 


Kuva: Oletusarvo on C26. Voit tarvittaessa muokata arvoa.

 

 

Finvoice 3.0 verkkolaskuaineiston elementit

 

 

Finvoice elementti

Kenttä

Huomio

MessageTransmissionDetails

 

 

  MessageSenderDetails

 

 

    FromIdentifier

Lähettäjän verkkolaskuosoite

 

    FromIntermediator

Lähettäjän operaattoritunnus

 

  MessageReceiverDetails

 

 

    ToIdentifier

Vastaanottajan verkkolaskuosoite

Asiakasrekisteri-näytön Laskutus ja tilaukset -välilehti Verkkolaskuosoite-kenttä.

    ToIntermediator

Vastaanottajan välittäjän tunnus (puhutaan myös operaattorin tunnus / intermediator-tunnus)

Asiakasrekisteri-näytön Laskutus ja tilaukset -välilehti Välittäjän tunnus -kenttä.

  MessageDetails

 

 

    MessageIdentifier

Laskun numero

 

    MessageTimeStamp

Aineiston luontiaika

 

    SpecificationIdentifier

EN16391

Semanttinen malli, EN 16391 -arvo siirtyy aineistoon, mikäli SEMANTIC_MODEL-asetus on arvolla 1.

SellerPartyDetails

 

 

  SellerPartyIdentifier

Lähettäjän Y-tunnus

Yritystiedot-näytön Perustiedot-välilehden Y-tunnus-kenttä.

  SellerOrganisationName

Lähettäjä yrityksen nimi

Yritystiedot-näytön Perustiedot-välilehden Nimi-kenttä.

  SellerOrganisationName

Yrityksen lisänimi

Yritystiedot-näytön Toimipaikat-osion Yhteystiedot-välilehden Lisänimi-kenttä.

  SellerOrganisationTaxCode

ALV-numero

Yritystiedot-näytön Y-tunnuksesta muodostettu ALV-numero.

  SellerPostalAddressDetails

 

 

    SellerStreetName

Yrityksen lähiosoite

Yritystiedot-näytön Toimipaikat-osion Yhteystiedot-välilehden Postiosoite-kenttä.

    SellerTownName

Yrityksen postiosoite

Yritystiedot-näytön Toimipaikat-osion Yhteystiedot-välilehden Postiosoite-kenttä.

    SellerPostCodeIdentifier

Yrityksen postinumero

Yritystiedot-näytön Toimipaikat-osion Yhteystiedot-välilehden Postiosoite-kenttä.

    CountryCode

Oletuksena FI

Yritystiedot-näytön Toimipaikat-osion Yhteystiedot-välilehden Maa-kenttä.

    CountryName

Oletuksena Suomi (FI)

Yritystiedot-näytön Toimipaikat-osion Yhteystiedot-välilehden Maa-kenttä.

SellerOrganisationUnitNumber

Yrityksen OVT-tunnus

Yritystiedot-näytön OVT-tunnus-kenttä.

SellerContactPersonName

Myyjän nimi

FINVOICECONTACT-asetukselle määritelty henkilön nimi. Ohjelma hakee tiedon henkilörekisteristä

  SellerPhoneNumberIdentifier

Myyjän puhelinnumero

FINVOICECONTACT-asetukselle määritelty henkilön puh.numero. Ohjelma hakee tiedon henkilörekisteristä.

  SellerEmailaddressIdentifier

Myyjän sähköpostiosoite

FINVOICECONTACT-asetukselle määritelty henkilön sähköposti. Ohjelma hakee tiedon henkilörekisteristä.

SellerInformationDetails

 

 

  SellerHomeTownName

Yrityksen kotipaikka

Yritystiedot-näytön Kotipaikka-kenttä.

  SellerPhoneNumber

Yrityksen puhelinnumero

Yritystiedot-näytön toimipaikan Puhelin-kenttä.

  SellerFaxNumber

Yrityksen Fax

Yritystiedot-näytön toimipaikan Fax-kenttä.

  SellerCommonEmailaddressIdentifier

Yrityksen toimipaikan sähköposti

Yritystiedot-näytön toimipaikan Sähköposti-kenttä.

  SellerWebaddressIdentifier

Yrityksen kotisivut

Yritystiedot-näytön Kotisivut-kenttä.

  SellerAccountDetails

 

 

    SellerAccountID

Yrityksen pankkitili, IBAN

Yritystiedot-näytön Pankkitilit-välilehdeltä ne pankkitilit, jolla on Verkkolaskulle-optio aktiivisena.

IBAN-kenttä

    SellerBic

Pankkitilit BIC

BIC-kenttä

    SellerAccountName

Pankkitilin nimi

Pankkitilin nimi

InvoiceRecipientPartyDetails

 

 

  InvoiceRecipientPartyIdentifier

Laskutusasiakkaan y-tunnus, mikäli ei ole annettu y-tunnusta haetaan asiakkaan numer

Asiakasrekisterin Y-tunnus tai asiakasnumero.

  InvoiceRecipientOrganisationName

Laskutusasiakkaan nimi ja lisänimi

Asiakasrekisterin Nimi ja Lisänimi.

  InvoiceRecipientOrganisationTaxCode

ALV-numero

Ohjelma muodostaa ALV-numeron laskutusasiakkaan Y-tunnuksesta ja maakoodista.

  InvoiceRecipientPostalAddressDetails

 

 

    InvoiceRecipientStreetName

Laskutusasiakkaan lähiosoite

Laskulta laskutusasiakkaan Lähisoite-kenttä.

    InvoiceRecipientTownName

Laskutusasiakkaan postitoimipaikka

Laskulta laskutusasiakkaan Osoite-kenttä.

    InvoiceRecipientPostCodeIdentifier

Laskutusasiakkaan postinumero

Laskulta laskutusasiakkaan Osoite-kenttä.

    CountryCode

Laskutusasiakkaan maakoodi

Asiakasreksiterin Maa-kenttä.

    CountryName

Laskutusasiakkaan maa

Asiakasreksiterin Maa-kenttä.

InvoiceRecipientContactPersonName

Laskutusasiakkaan yhteyshenkilö

Laskulta laskutusasiakkaan Yhteyshenkilö-kenttä

InvoiceRecipientLanguageCode

Laskun kieli

Laskun Kielikoodi-kenttä.

BuyerPartyDetails

Tilaaja-asiakas tai Laskutusasiakas.

Riippuvainen toimintokeskuksen ADDBUYERPARTY-asetuksesta, arvolla 1 siirtyy Tilaaja-asiakkaan tiedot BuyerParty-elementtiin.

  BuyerPartyIdentifier

Y-tunnus tai asiakasnumero

Riippuvainen BUYERPARTYIDENTIFIER-asetuksen arvosta. Arvo 0=y-tunnus, 1=asiakasnumero.

  BuyerOrganisationName

Asiakasnimi ja lisänimi

 

  BuyerOrganisationTaxCode

ALV-numero

Ohjelma muodostaa ALV-numeron laskutusasiakkaan Y-tunnuksesta ja maakoodista.

  BuyerPostalAddressDetails

 

 

    BuyerStreetName

Lähiosoite

Laskulta laskutus/tilaaja-asiakkaan Lähiosoite-kenttä.

    BuyerTownName

Postitoimipaikka

Laskulta laskutus/tilaaja-asiakkaan Osoite-kenttä.

    BuyerPostCodeIdentifier

Postinumero

Laskulta laskutus/tilaaja-asiakkaan Osoite-kenttä

    CountryCode

Maakoodi

Asiakasreksiterin Maa-kenttä.

    CountryName

Maa

Asiakasreksiterin Maa-kenttä.

BuyerContactPersonName

Asiakkaan yhteyshenkilö

Laskun Yhteyshenkilö-kenttä.

DeliveryPartyDetails

 

 

  DeliveryPartyIdentifier

Toimitusasiakkaan Y-tunnus

Asiakasrekisteri Y-tunnus-kenttä.

  DeliveryOrganisationName

Toimitusasiakkaan nimi

Laskulta toimitusasiakkaan Nimi-kenttä

  DeliveryOrganisationTaxCode

ALV-numero

Ohjelma muodostaa ALV-numeron toimitusasiakkaan Y-tunnuksesta ja maakoodista.

  DeliveryPostalAddressDetails

 

 

    DeliveryStreetName

Lähiosoite

Laskulta toimitusasiakkaan Lähiosoite-kenttä.

    DeliveryTownName

Postitoimipaikka

Laskulta toimitusasiakkaan Osoite-kenttä.

    DeliveryPostCodeIdentifier

Postinumero

Laskulta toimitusasiakkaan Osoite-kenttä.

DeliveryContactPersonName

Yhteyshenkilö

Laskulta toimitusasiakkaan Yhteyshenkilö-kenttä.

DeliveryDetails

 

 

  DeliveryMethodText

Toimitustapa

 

  DeliveryTermsText

Toimitusehto

 

InvoiceDetails

 

 

  InvoiceTypeCode

Vakio:

Lasku = INV01

Hyvityslasku = INV02

 

  InvoiceTypeCodeUN

Vakio:

Lasku=380

Hyvityslasku=381

 

  InvoiceTypeText

Laskun kielen mukaan: LASKU/HYVITYSLASKU

 

  OriginCode

Vakio: Original

 

  InvoiceNumber

Laskun numero

 

  InvoiceDate

Laskun päiväys

 

  SellerReferenceIdentifier

 

Laskulta Viitteemme

  SellersBuyerIdentifier

Asiakkaan numero

 

  OrderIdentifier

 

Laskulta Tilausnumeronne

  AgreementIdentifier

Sopimusnumero

Laskulta Merkki. Mikäli asiakasrekisterin Verkkolaskuoptiot-välilehdelle on syötetty Sopimusnumero, korvaa se laskulla olevan Merkki-kentän.

  BuyerReferenceIdentifier

 

Laskulta Viitteenne

  RowsTotalVatExcludedAmount

Laskurivien yhteenlaskettu veroton summa

Elementti siirtyy semanttiseen malliin.

  InvoiceTotalVatExcludedAmount

Laskun veroton loppusumma

 

  InvoiceTotalVatAmount

Laskurivien veron summat yhteensä

 

  InvoiceTotalVatIncludedAmount

Laskurivien verollinen summa yhteensä

 

  VatSpecificationDetails

Alv-erittely

 

    VatBaseAmount

Veroton summa per alv-kanta

 

    VatRatePercent

Verokanta

 

    VatCode

Verokoodi

Verokäsittely ja % määrittelee verokoodin. Verokoodi luettelo erikseen Lemonsoft verkkolasku finvoice 3.0-ohjeen alussa.

    VatRateAmount

Laskun alv-määrä

 

    VatFreeText

Alv-selite

Tilin Muut tiedot-välilehden Lakipykälä-kenttä (Sisältyy aineistoon vain, jos semanttinen malli on käytössä, eli SEMANTIC_MODEL = 1)

  PaymentTermsDetails

 

 

    PaymentTermsFreeText

Maksuehdon selite

 

    InvoiceDueDate

Laskun eräpäivä

 

    CashDiscountDate

Laskun kassa-ale päivämäärä

 

    CashDiscountBaseAmount

Laskun loppusumma

 

    CashDiscountPercent

Kassa-ale prosentti

 

    CashDiscountAmount

Laskun kassa-alennuksen määrä, verollinen

 

    PaymentOverDueFineDetails

Viivästystiedot

 

      PaymentOverDueFineFreeText

Huomautusaika

Yritystiedot-näytön Muut tiedot-välilehti

      PaymentOverDueFinePercent

Viivästyskorko

Yritystiedot-näytön Muut tiedot-välilehti

PaymentStatusDetails

 

 

  PaymentStatusCode

NOTPAID

 

FactoringAgreementDetails

 

Viedään aineistoon, kun laskutustapa on Factoring-finvoice ja laskutus LemonHub-palvelun kautta

  FactoringAgreementIdentifier

Sopimusnumero

SELLERNR- ja AGREEMENT_CODE-asetuksien arvot. Jos arvoa ei ole, jää tyhjäksi.

  TransmissionListIdentifier

Siirtoluettelo

 

  EndorsementClauseCode

Vakio: F

 

  FactoringFreeText

Siirtolauseke

Yritystiedot Rahoitusyhtiö-välilehden Siirtolauseke-kenttä

  FactoringPartyIdentifier

Rahoitusyhtiön Y-tunnus

Yritystiedot Rahoitusyhtiö-välilehden Y-tunnus-kenttä.

  FactoringPartyName

Rahoitusyhtiön nimi

Yritystiedot Rahoitusyhtiö-välilehden Rahoitusyhtiö-kenttä

  FactoringPartyPostalAddressDetails

 

 

    FactoringPartyStreetName

Lähiosoite

Yritystiedot Rahoitusyhtiö-välilehden Lähiosoite-kenttä

    FactoringPartyTownName

Postiosoite

Yritystiedot Rahoitusyhtiö-välilehden Postiosoite-kenttä

    FactoringPartyPostCodeIdentifier

Postiosoite

Yritystiedot Rahoitusyhtiö-välilehden Postiosoite-kenttä

VirtualBankBarcode

Virtuaaliviivakoodi

 

InvoiceRow

Laskun rivitiedot

 

  SubInvoiceRow

Rivit ilman kpl-määrää ja summaa, esim. Tilaus / Lähete/ Välisumma -rivit

 

    SubRowFreeText

Laskun Koodi- sekä Nimike -kentissä oleva teksti

Esim. tilauksesta tehty lasku: Lähete ja Tilaus -tieto siirtyy tähän elementtiin.

  ArticleIdentifier

Tuotetunnus

Ohjataan asetuksella ARTICLEIDENTIFIER. Arvolla 0 haetaan laskurivin Koodi-kenttä (oletus). Arvolla 1 tutkitaan tuotteen EAN-kooditaulukosta toimittajanumeroa vastaava Asiakkaan koodi.

  ArticleName

Tuotenimi

Laskurivin Nimike-kenttä

  ArticleDescription

Lisänimike

Laskurivin Lisänimike-kentän sisältö siirtyy aineistoon, mikäli toimintokeskuksen DESCRIPTION2-asetuksen arvo on 1.

  EanCode

EAN-koodi

Laskurivin tuotteen EAN-koodi (nimikerekisteri)

  RowDefinitionDetails

 

 

    RowDefinitionHeaderText

Selite Työmaa-avain tai Työmaanumero

 

    RowDefinitionValue

Työmaa-avain ja/tai Työmaanumero -kentän sisältö

Laskuriviltä Työmaa-avain ja/tai Työmaanumero -kentän

  DeliveredQuantity QuantityUnitCode="x" QuantityUnitCodeUN="C62"

Laskurivin määrä

Laskurivin yksikön EN16931 koodi varastoyksikön takaa (valintalistat). Oletus C62

  InvoicedQuantity

QuantityUnitCode="x" QuantityUnitCodeUN="C62"

Laskurivin määrä

Laskurivin yksikön EN16931 koodi varastoyksikön takaa (valintalistat). Oletus C62

  UnitPriceAmount

Yksikköhinta veroton

Laskurivin a-hinta

  UnitPriceNetAmount

Laskurivin Yhteensä-hinta.

Elementti siirtyy semanttiseen malliin.

  UnitPriceVatIncludedAmount

Yksikköhinta verollinen

 

  RowIdentifier

Ostajan tilausnumero

Myyntitilauksen Tilausnumeronne-kentän tieto

  RowOrderPositionIdentifier

 

ROW_ORDER-asetus määrittää tuleeko tähän elementtiin arvolla 0 myyntitilauksen tilausnumero vai arvolla 1 tieto tilauksen Tilausnumeronne-kentästä

  RowPositionIdentifier

 

 

  RowDeliveryIdentifier

 

 

  RowDeliveryDate

 

 

  RowProjectReferenceIdentifier

 

 

  RowDeliveryDetails

 

 

    RowDeliveryNoteIdentifier

Lähete

Mikäli ROW_GROUPING-asetus on arvolla 0, siirtyy elementtiin myyntitilauksen lähetenumero

  RowAccountDimensionText

Dimensiot puolipistein eroteltuna

Asiakasrekisteri Laskutus ja tilaukset-välilehden Verkkolaskuoptiot-välilehden Dimensiot-kenttä.

  RowProgressiveDiscountDetails

Progressiivinen alennus

 

    RowDiscountPercent

Progressiivinen ale%

 

    RowDiscountAmount

 

Elementti siirtyy semanttiseen malliin

    RowDiscountTypeCode

 

Elementti siirtyy semanttiseen malliin

  RowNormalProposedAccountIdentifier

Tiliöintiehdotus

Asiakasrekisteri Laskutus ja tilaukset-välilehden Tiliöintiehdotus -kenttä

  RowFreeText

Riviteksti

Laskun Rivin lisätiedot-välilehti Riviteksti-kenttä

  RowDiscountPercent

Laskurivin alennus

Ale%-kenttä

  RowDiscountAmount

Progressiivinen alennus, alennuksen määrä

Ale%-,Ale2%- ja Ale3%-kentät.

  RowDiscountTypeCode

 

 

  RowVatRatePercent

Alv prosentti

Laskurivin Tili-kentän tilimukainen alv-prosentti (Tilikartta).

  RowVatCode

Alv-koodi

Verokäsittely ja % määrittelee verokoodin. Verokoodi luettelo erikseen Lemonsoft verkkolasku finvoice 3.0-ohjeen alussa.

  RowVatAmount

Alv yhteensä

 

  RowVatExcludedAmount

Yhteensä veroton

 

  RowAmount

Yhteensä verollinen

 

EpiDetails

Kehystiedot

 

  EpiIdentificationDetails

 

 

    EpiDate

Laskun päivä

 

    EpiReference

Laskun viitenumero

 

  EpiPartyDetails

 

 

    EpiBfiIdentifier

Yrityksen BIC

Yritystiedot Pankkitilit-välilehti.

  EpiBeneficiaryPartyDetails

 

 

    EpiNameAddressDetails

Yrityksen nimi

Yritystiedot

    EpiAccountID

Yrityksen IBAN

Yritystiedot Pankkitilit-välilehti.

  EpiPaymentInstructionDetails

 

 

    EpiRemittanceInfoIdentifier

Laskun viitenumero

 

    EpiInstructedAmount

Lasku yhteensä

 

    EpiCharge

SHA

 

    EpiDateOptionDate

Laskun eräpäivä

 

    EpiPaymentMeansCode

Vakio: 58

 

    EpiPaymentMeansText

Maksutapa: SEPA tilisiirto

 

  InvoiceUrlText

 

 

Finvoice

 

 

 

Semanttinen malli sisältää lisäksi seuraavat elementit:

RowsTotalVatExcludedAmount = Laskurivien nettosummat
RowProgressiveDiscountDetails = Progressiivinen alennus. Mikäli laskurivillä on käytössä useampi alennus, kootaan kaikki alennukset tähän elementtiin.
UnitPriceNetAmount = Tuotteen nettohinta ilman arvonlisäveroa