Passeli Merit -ohjelmasta luotava Finvoice 3.0 -muotoinen verkkolaskuaineisto muodostuu automaattisesti ohjelman käyttöliittymään syötettyjen tietojen perusteella. Tämä ohje esittelee, miten ohjelman eri kentät, kuten asiakaskortin tiedot, laskun perustiedot ja laskurivit, kohdistuvat Finvoice XML-aineiston kenttiin. Tämän kuvauksen avulla sekä ohjelmiston käyttäjä että RAG-pohjainen AI-assistentti löytävät helposti oikean paikan kunkin tiedon syöttämiselle.
Yrityksen omat tiedot (Myyjä / SellerPartyDetails)
Seuraavat tiedot haetaan ohjelmassa yrityksen omista perustiedoista, asetuksista sekä määritellyiltä pankkitileiltä:
Finvoice-kenttä (XML-tagi) | Käyttöliittymän kenttä Passeli Meritissä | Esimerkki aineistosta |
FromIdentifier (SchemeID="0037") | Lähettäjän verkkolaskuosoite / OVT-tunnus | 003780853627 |
FromIntermediator | Lähettäjän välittäjätunnus | E204503 |
SellerPartyIdentifier (SchemeID="0037") | Myyjän Y-tunnus | 8085362-7 |
SellerOrganisationName | Yrityksen nimi (Myyjä) | Pay & Tax Office |
SellerOrganisationTaxCode | Yrityksen ALV-tunniste | FI80853627 |
SellerStreetName | Omat osoitetiedot: Katuosoite | Osoite 23 |
SellerTownName | Omat osoitetiedot: Postitoimipaikka | Pori |
SellerPostCodeIdentifier | Omat osoitetiedot: Postinumero | 28100 |
CountryCode | Omat osoitetiedot: Maakoodi | FI |
SellerAccountID (IdentificationSchemeName="IBAN") | Pankkitili (IBAN) | FI92 2562 2380 0031 39 |
SellerBic (IdentificationSchemeName="BIC") | Pankin BIC-koodi | NDEAFIHH |
Asiakkaan ja vastaanottajan tiedot (InvoiceRecipientPartyDetails & BuyerPartyDetails)
Laskun vastaanottajan ja ostajan tiedot ohjelma hakee laskutettavan asiakkaan tiedoista ja asiakaskortilta:
Finvoice-kenttä (XML-tagi) | Käyttöliittymän kenttä Passeli Meritissä | Esimerkki aineistosta |
InvoiceRecipientPartyIdentifier / BuyerPartyIdentifier | Asiakkaan Y-tunnus | 7252711-9 |
InvoiceRecipientOrganisationName / BuyerOrganisationName | Asiakkaan nimi / Organisaation nimi | Testiasiakas Oy |
InvoiceRecipientOrganisationTaxCode / BuyerOrganisationTaxCode | Asiakkaan ALV-tunniste | FI72527119 |
InvoiceRecipientStreetName / BuyerStreetName | Asiakkaan osoite (Katuosoite) | Osoite1, Osoite2 |
InvoiceRecipientTownName / BuyerTownName | Asiakkaan postitoimipaikka | Postitoimipaikka |
InvoiceRecipientPostCodeIdentifier / BuyerPostCodeIdentifier | Asiakkaan postinumero | 28100 |
CountryCode / CountryName | Asiakkaan maa / Maakoodi | FI / Suomi |
InvoiceRecipientEmailaddressIdentifier / BuyerEmailaddressIdentifier | Asiakkaan sähköpostiosoite | |
BuyerOrganisationUnitNumber | Ostajan organisaation osastonumero / OVT-tunnus | 003772527119 |
BuyerContactPersonName | Asiakaskortti: Yhteyshenkilö -kenttä | Asiakkaan Yhteyshenkilö |
SellersBuyerIdentifier | Myyjän antama ostajan tunnus (Asiakasnumero) | 1122334 |
Laskun otsikkotiedot, viitteet ja kommentit (InvoiceDetails)
Laskunäkymässä syötettävät viitteet, päivät, kommentit ja maksuehdot siirtyvät aineistoon seuraavasti:
Finvoice-kenttä (XML-tagi) | Käyttöliittymän kenttä Passeli Meritissä | Esimerkki aineistosta |
InvoiceNumber / OriginalInvoiceNumber | Laskunumero | 1243 |
InvoiceDate | Laskun päiväys | 20251105 |
SellerReferenceIdentifier | Viitteemme | Viitteemme |
BuyerReferenceIdentifier | Viitteenne | Viitteenne |
OrderIdentifier | Tilausnumero | Tilausnumero |
AgreementIdentifier | Sopimusnumero | Sopimusnumero |
TenderReference | Tarjouksen viite | Tarjouksen viite |
AccountDimensionText | Tiliöintiviite | Tiliöintiviite |
InvoiceFreeText | Laskun kommentti ennen rivejä / Laskun kommentti rivien jälkeen | Laskun kommentti ennen riveja / Laskun kommentti rivien jalkeen |
PaymentTermsFreeText | Maksuehto (vapaa teksti) | 7 pv netto |
InvoiceDueDate | Eräpäivä | 20251112 |
PaymentOverDueFinePercent | Viivästyskorko | 8,50 |
Toimitustiedot (DeliveryPartyDetails)
Laskun toimitustietoihin liittyvät erilliset kentät:
Finvoice-kenttä (XML-tagi) | Käyttöliittymän kenttä Passeli Meritissä | Esimerkki aineistosta |
DeliveryOrganisationName | Toimitusosoitteen nimi / Vastaanottava organisaatio | Testiasiakas Oy |
DeliveryStreetName, DeliveryTownName, DeliveryPostCodeIdentifier | Asiakaskortiston osoitetiedot (Katuosoite, postitoimipaikka, postinumero) | Osoite1, Postitoimipaikka, 28100 |
DeliverySiteCode | Työmaatunnus | Työmaatunnus |
DeliveryDetails > DeliveryDate | Toimituspäivä | 20251227 |
Laskurivit ja tuoterakenteet (InvoiceRow)
Laskuriveille syötettävät tuote- ja palvelurivien tiedot mäppääntyvät seuraaviin XML-elementteihin:
Finvoice-kenttä (XML-tagi) | Käyttöliittymän kenttä Passeli Meritissä | Esimerkki aineistosta |
ArticleIdentifier | Tuotekoodi / Artikkelitunnus | Myynti 25,5 % tavara |
ArticleName | Tuotteen nimi / Nimike | Tavara 25,5% |
InvoicedQuantity / DeliveredQuantity | Määrä (Laskutettu / Toimitettu) | 1,000 |
UnitPriceAmount / UnitPriceNetAmount | Yksikköhinta (netto) | 100,000 |
RowDiscountPercent | Alennus-% | 30,000 |
RowDiscountAmount | Alennus (EUR) | 30,00 |
RowVatRatePercent | Rivin ALV-% | 25,500 |
RowVatAmount | Rivin ALV-määrä | 17,850 |
RowVatExcludedAmount | Rivin veroton summa | 70,00 |
RowAmount | Rivin verollinen loppusumma | 87,85 |
Pankki- ja maksutiedot (EpiDetails)
Laskun virtuaaliviivakoodia ja pankkisiirtoa varten muodostettavat tiedot:
Finvoice-kenttä (XML-tagi) | Käyttöliittymän kenttä Passeli Meritissä | Esimerkki aineistosta |
EpiAccountID | Saajan tilinumero (IBAN) | FI83 4796 6975 0007 27 |
EpiBfiIdentifier | Pankin BIC-koodi | ITELFIHH |
EpiRemittanceInfoIdentifier | Laskun viitenumero | 12438 |
EpiInstructedAmount | Maksettava summa (Laskun loppusumma) | 920,35 |
EpiDate / EpiDateOptionDate | Eräpäivä | 20251112 |