Index
- Overview
- API keys and endpoints
- User authentication
- Encoding
- Date formats
- Error return values
- Invoice state values
- Invoice layouts
- API versions
- Advanced
Contents
Finvoice parsing (For Finnish users)
Finvoice laskun luku
Tässä on listattu kentät jotka Maventa lukee Finvoice laskulta. Kentät jotka on merkitty *-merkillä ovat vapaaehtoisia kenttiä Maventan puolesta. Finvoice dokumentit validoidaan aina schemaa vasten. Käytössä on filtteri joka osaa poistaa tavallisimmat pienet virheet kuten ei sallittujen tyhjien rivien poiston (esim. rivi DeliveryOrganisationTaxCode/> poistetaan jos validaatio ei onnistu koska scheman mukaan kyseinen kenttä ei saa olla tyhjä jos se esiintyy laskulla). Kirjautumalla Maventa palveluun voitte testata oman Finvoice materiaalinne sopivuuden palveluun kohdassa Laskut / Testaa XML laskudata. Palvelu antaa pienen esikatselun laskun tiedoista mikäli se validoituu ja muussa tapauksessa virheviestin jonka perusteella voi lähteä tutkimaan vikaa. Ongelmatapauksissa voitte lähettä esimerkkilaskun tukipalveluumme support@maventa.com niin voimme tutkia asiaa tarkemmin.
Listassa on Maventan kentän nimi ja suluissa Finvoicella oleva kentän nimi / kenttien nimet. Näiden lisäksi poimitaan mahdollisesta SOAP-kehyksestä vastaanottajan OVT ja operaattoritunnus niille varauista kentistä (eb:PartyId).
Yleiset tiedot:
Laskunumero (InvoiceNumber)
Laskun päiväys (InvoiceDate)
Eräpäivä (InvoiceDueDate)
Viitenumero (EpiRemittanceInfoIdentifier)
Veroton summa (InvoiceTotalVatExcludedAmount)
Verollinen summa (InvoiceTotalVatIncludedAmount)
* Lisämerkintä/Viesti (SellerFreeText)
*Viitteenne (OrderIdentifier)
* Tilausnumero (OrderIdentifier)
* Toimituspäivämäärä (DeliveryDate)
* >Viivästyskorko (PaymentOverDueFinePercent)
Lähettäjän tiedot, tärkeimmät täydennetään Maventan asetuksista jos jotain puuttuu (kuten y-tunnus):
Nimi (SellerOrganisationName)
* Y-tunnus (SellerPartyIdentifier)
* Lähiosoite (SellerStreetName)
* Postinumero (SellerPostCodeIdentifierr)
* Postitoimipaikka (SellerTownName)
* Puhelin (SellerPhoneNumber)
* Kotisivu (SellerWebaddressIdentifier)
* Sähköposti (SellerEmailaddressIdentifier)
Pankkitilitiedot
Tilinumero (IBAN tai kotimainen) (SellerAccountID / EpiAccountID)
Pankki BIC (SellerBic / EpiBfiIdentifier)
Myyjän tiedot (jos myyjätietoja ei erikseen anneta, käytetään laskun luojan tilin asetuksissa olevia tietoja):
Nimi (SellerContactPersonName)
* Sähköposti (SellerEmailaddressIdentifier / SellerCommonEmailaddressIdentifier)
* Puhelin (SellerPhoneNumberIdentifier / SellerPhoneNumber)
Toimitusosoite
Osoite (DeliveryStreetName)
* Postinumero (DeliveryPostCodeIdentifier)
* Postitoimipaikka (DeliveryTownName)
* Maa (CountryCode)
Vastaanottajan tiedot, ensisijaisesti noudetaan InvoiceRecipient tiedot ja jos ne ovat tyhjät käytetään Buyer-tietoja:
Asiakasnumero (InvoiceRecipientPartyIdentifier / BuyerPartyIdentifier)
* Y-tunnus (InvoiceRecipientOrganisationTaxCode / BuyerOrganisationTaxCode)
Nimi (InvoiceRecipientOrganisationName / BuyerOrganisationName)
Lähiosoite (InvoiceRecipientStreetName / BuyerStreetName)
* Lisäosoite (InvoiceRecipientPostOfficeBoxIdentifier / BuyerPostOfficeBoxIdentifier)
Postinumero (InvoiceRecipientPostCodeIdentifier / BuyerPostCodeIdentifier)
Postitoimipaikka (InvoiceRecipientTownName / BuyerTownName)
Maa (CountryCode)
* Yhteyshenkilö (InvoiceRecipientContactPersonName / BuyerContactPersonName)
* Sähköposti (InvoiceRecipientEmailaddressIdentifier / BuyerEmailaddressIdentifier)
* OVT-tunnus (InvoiceRecipientOrganisationUnitNumber / BuyerOrganisationUnitNumber)
Laskurivin tiedot:
Tuote/palvelu nimike (ArticleName)
* Selite (RowFreeText/RowIdentifier)
Määrä (DeliveredQuantity/ConfirmedQuantity)
á hinta (UnitPriceAmount)
* Yksikkö (QuantityUnitCode)
ALV % (RowVatRatePercent)
* Alennus % (RowDiscountPercent)
Veroton summa (RowVatExcludedAmount)
* Verollinen summa (RowAmount)
* HUOM! Laskurivillä täytyy siis olla vähintään tuotenimi, määrä, á hinta, ALV% sekä veroton summa*




