Asteri lähete/laskutus Liittymäkuvaus Finvoice verkkolaskuun 11.10.2004 Atsoft Oy Mäkinen puh (09) 350 7530 0400-316 088 www.atsoft.fi Malminkaari 21 B fax (09) 351 5532 0500-703 730 atsoft@atsoft.fi 00700 HELSINKI 0400-505 596
2 Finvoice verkkolasku Asteri Lähete/laskutus
Finvoice verkkolasku Asteri lähete/laskutusohjelmassa on toiminto, jolla tallennetaan jo tehdyistä laskuista Finvoice muotoinen tiedosto. Tämä liittymäkuvaus kuvaa Asteri lähete/laskutuksessa olevan Finvoice tallennusominaisuuden. Finvoicen soveltamisohje Suomen Pankkiyhdistys on julkaissut Finvoicen soveltamisohjeen, versio 1.1./19.12.2003, johon oli tätä kirjoitettaessa linkki Pankkiyhdistyksen Finvoice verkkolaskusivulla, osoitteessa http://www.pankkiyhdistys.fi/verkkolasku/ (soveltamisohjeen suora osoite oli tuolloin www.pankkiyhdistys.fi/verkkolasku/soveltamisohje11.pdf) Finvoice verkkolasku Asteri Lähete/laskutus 3
Miten Finvoice verkkolaskutus toimii? Finvoice verkkolaskujen muodostaminen toimii seuraavasti: 1. Tee laskut normaaliin tapaan. Finvoice verkkolaskut tallennetaan laskunnumerosta laskunnumeroon. Voit tehdä Finvoice verkkolaskuja joko yksittäisestä laskusta tai useammista laskuista. Jos lähetät useita laskuja Finvoice verkkolaskuina, tee ne perättäisille laskunnumeroille, jotta ne tallentuvat yhdellä ajolla Finvoice tiedostoon. 2. Täydennä tarvittaessa Finvoice.verkkolaskun saavien asiakkaiden asiakaskorttiin koodi kenttään laskun välittämiseen tarvittavat tiedot (asiakaskortin koodi kenttään + merkillä erotettuina tiedot BuyerPartyID+BuyerIntermediatorID +BuyerOrganisationUnitNumber+BuyerEmailaddressIdentifier) 3. Tallenna Finvoice laskuaineisto laskutustilassa valinnalla tiedosto / verkkolasku / finvoice. Anna laskunnumeroväli mistä laskunnumerosta mihin laskunnumeroon tallennetaan Finvoice. Täydennä muut kentät ja tallenna aineisto levylle. 4. Lähetä tallentamasi Finvoice aineisto pankkiin välitettäväksi edelleen vastaanottajalle. 4 Finvoice verkkolasku Asteri Lähete/laskutus
Lisää asiakkaan tietoihin välitystiedot Asiakaskortistossa koodi kenttässä ilmoitetaan + merkillä erotettuina tiedot BuyerPartyID+BuyerIntermediatorID+ BuyerOrganisationUnitNumber+BuyerEmailaddressIdentifier: Esimerkiksi: FI2112345600000785+NDEAFIHH++anne.mango@annenananas.fi Finvoice verkkolasku Asteri Lähete/laskutus 5
Tee laskut normaaliin tapaan Tee laskut normaaliin tapaan. Jos et halua tulostaa verkkolaskuja paperille, kirjoita lasku ja valitse sitten tiedosto / tallenna lasku. Voit tehdä samalla kerralla sekä postitse että Finvoicena lähetettäviä laskuja. 6 Finvoice verkkolasku Asteri Lähete/laskutus
Tallenna Finvoice aineisto Tallenna Finvoice aineisto valitsemalla laskunsyöttötilassa tiedosto /verkkolasku / Finvoice. Finvoice verkkolasku Asteri Lähete/laskutus 7
8 Finvoice verkkolasku Asteri Lähete/laskutus
Finvoice verkkolasku Asteri Lähete/laskutus 9
Esimerkki tallentuneesta aineistosta Esimerkin mallilasku luettavissa myös osoitteessa http://www.atsoft.fi/finvoice/finvoice.txt <SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:eb="http://www.oasis-open.org/committees/ebxmlmsg/schema/msg-header-2_0.xsd"> <SOAP-ENV:Header> <eb:messageheader xmlns:eb="http://www.oasis-open.org/committees/ebxml-msg/schema/msg-header- 2_0.xsd" SOAP-ENV:mustUnderstand="1" eb:id="20030222133003285"> <eb:from> <eb:partyid>fi1029501800069357</eb:partyid> <eb:role>sender</eb:role> </eb:from> <eb:from> <eb:partyid>ndeafihh</eb:partyid> <eb:role>intermediator</eb:role> </eb:from> <eb:to> <eb:partyid>fi2112345600000785</eb:partyid> <eb:role>receiver</eb:role> </eb:to> <eb:to> <eb:partyid>ndeafihh</eb:partyid> <eb:role>intermediator</eb:role> </eb:to> <eb:cpaid>yoursandmycpa</eb:cpaid> <eb:conversationid>nnnnn</eb:conversationid> <eb:service>routing</eb:service> <eb:action>processinvoice</eb:action> <eb:messagedata> <eb:messageid>1</eb:messageid> <eb:timestamp>2004-10-12t16:43:50+02</eb:timestamp> <eb:reftomessageid/> </eb:messagedata> </eb:messageheader> </SOAP-ENV:Header> <SOAP-ENV:Body> <eb:manifest eb:id="manifest" eb:version="2.0"> <eb:reference eb:id="finvoice" xlink:href="20020209-133003"> <eb:schema eb:location="http://www.pankkiyhdistys.fi/verkkolasku/finvoice/finvoice.xsd" eb:version="2.0"/> </eb:reference> </eb:manifest> </SOAP-ENV:Body> </SOAP-ENV:Envelope> <?xml version="1.0" encoding="iso-8859-1"?> <!-- Created by Asteri laskutus (http://www.atsoft.fi/) --> <Finvoice Version="1.1"> <SellerPartyDetails> <SellerPartyIdentifier>0123456-7</SellerPartyIdentifier> <SellerOrganisationName>Asteri Malliyritys Oy</SellerOrganisationName> <SellerOrganisationTaxCode>Y-0705493-3</SellerOrganisationTaxCode> <SellerPostalAddressDetails> <SellerStreetName>Malminkaari 21 B</SellerStreetName> 10 Finvoice verkkolasku Asteri Lähete/laskutus
<SellerTownName>HELSINKI</SellerTownName> <SellerPostCodeIdentifier>00700</SellerPostCodeIdentifier> <SellerPostOfficeBoxIdentifier>PL 000</SellerPostOfficeBoxIdentifier> </SellerPostalAddressDetails> </SellerPartyDetails> <SellerOrganisationUnitNumber></SellerOrganisationUnitNumber> <SellerContactPersonName>Minni Myyjä</SellerContactPersonName> <SellerCommunicationDetails> <SellerPhoneNumberIdentifier>puh (09) 351 1122</SellerPhoneNumberIdentifier> <SellerEmailaddressIdentifier>minni.myyja@malliyritys.fi</SellerEmailaddressIdentifier> </SellerCommunicationDetails> <BuyerPartyDetails> <BuyerPartyIdentifier>1005</BuyerPartyIdentifier> <BuyerOrganisationName>Annen Ananas Ky</BuyerOrganisationName> <BuyerPostalAddressDetails> <BuyerStreetName>Kasarmikatu 6 A 3</BuyerStreetName> <BuyerTownName>HÄMEENLINNA</BuyerTownName> <BuyerPostCodeIdentifier>00100</BuyerPostCodeIdentifier> </BuyerPostalAddressDetails> </BuyerPartyDetails> <BuyerOrganisationUnitNumber></BuyerOrganisationUnitNumber> <BuyerCommunicationDetails> <BuyerPhoneNumberIdentifier>09-3507530</BuyerPhoneNumberIdentifier> <BuyerEmailaddressIdentifier>anne.mango@annenananas.fi</BuyerEmailaddressIdentifier> </BuyerCommunicationDetails> <DeliveryPartyDetails> <DeliveryPartyIdentifier>1004</DeliveryPartyIdentifier> <DeliveryOrganisationName>Disketti Oy</DeliveryOrganisationName> <DeliveryPostalAddressDetails> <DeliveryStreetName>PL 45</DeliveryStreetName> <DeliveryTownName>ESPOO</DeliveryTownName> <DeliveryPostCodeIdentifier>02101</DeliveryPostCodeIdentifier> </DeliveryPostalAddressDetails> </DeliveryPartyDetails> <DeliveryCommunicationDetails> <DeliveryPhoneNumberIdentifier>09-3511122</DeliveryPhoneNumberIdentifier> </DeliveryCommunicationDetails> <DeliveryDetails> <DeliveryMethodText>Posti 10.2.2004</DeliveryMethodText> </DeliveryDetails> <InvoiceDetails> <InvoiceTypeCode>INV01</InvoiceTypeCode> <InvoiceTypeText>LASKU</InvoiceTypeText> <OriginCode>Origin</OriginCode> <InvoiceNumber>10507</InvoiceNumber> <InvoiceDate Format="CCYYMMDD">20040213</InvoiceDate> <SellerReferenceIdentifier>Matti Mango</SellerReferenceIdentifier> <OrderIdentifier>Mika Mäkinen</OrderIdentifier> <InvoiceTotalVatExcludedAmount AmountCurrencyIdentifier="EUR">989,27</InvoiceTotalVatExcludedAmount> <InvoiceTotalVatAmount AmountCurrencyIdentifier="EUR">186,23</InvoiceTotalVatAmount> <InvoiceTotalVatIncludedAmount AmountCurrencyIdentifier="EUR">1175,50</InvoiceTotalVatIncludedAmount> <VatSpecificationDetails> <VatBaseAmount AmountCurrencyIdentifier="EUR">811,27</VatBaseAmount> <VatRatePercent>22</VatRatePercent> <VatRateAmount AmountCurrencyIdentifier="EUR">178,48</VatRateAmount> </VatSpecificationDetails> <VatSpecificationDetails> <VatBaseAmount AmountCurrencyIdentifier="EUR">15,00</VatBaseAmount> Finvoice verkkolasku Asteri Lähete/laskutus 11
<VatRatePercent>17</VatRatePercent> <VatRateAmount AmountCurrencyIdentifier="EUR">2,55</VatRateAmount> </VatSpecificationDetails> <VatSpecificationDetails> <VatBaseAmount AmountCurrencyIdentifier="EUR">65,00</VatBaseAmount> <VatRatePercent>8</VatRatePercent> <VatRateAmount AmountCurrencyIdentifier="EUR">5,20</VatRateAmount> </VatSpecificationDetails> <VatSpecificationDetails> <VatBaseAmount AmountCurrencyIdentifier="EUR">98,00</VatBaseAmount> <VatRatePercent>0</VatRatePercent> <VatRateAmount AmountCurrencyIdentifier="EUR">0,00</VatRateAmount> </VatSpecificationDetails> <PaymentTermsDetails> <PaymentTermsFreeText>14 vrk netto</paymenttermsfreetext> <InvoiceDueDate Format="CCYYMMDD">20040227</InvoiceDueDate> <PaymentOverDueFineDetails> <PaymentOverDueFineFreeText>Yliaikakorko 10%</PaymentOverDueFineFreeText> <PaymentOverDueFinePercent>10</PaymentOverDueFinePercent> </PaymentOverDueFineDetails> </PaymentTermsDetails> </InvoiceDetails> <PaymentStatusDetails> <PaymentStatusCode>NOTPAID</PaymentStatusCode> </PaymentStatusDetails> <VirtualBankBarcode>240555610000072001175500000000001005010507104022700003</VirtualBankBar code> <InvoiceRow> <ArticleIdentifier>2hh</ArticleIdentifier> <ArticleName>Hotellimajoitus 2HH</ArticleName> <DeliveredQuantity QuantityUnitCode="yö">1</DeliveredQuantity> <UnitPriceAmount AmountCurrencyIdentifier="EUR" UnitPriceUnitCode="e / yö">65</unitpriceamount> <RowDiscountPercent>0</RowDiscountPercent> <RowVatRatePercent>8</RowVatRatePercent> <RowVatAmount AmountCurrencyIdentifier="EUR">5,20</RowVatAmount> <RowVatExcludedAmount AmountCurrencyIdentifier="EUR">65,00</RowVatExcludedAmount> <RowAmount AmountCurrencyIdentifier="EUR">70,20</RowAmount> </InvoiceRow> <InvoiceRow> <ArticleIdentifier>ep</ArticleIdentifier> <ArticleName>Eväspaketti</ArticleName> <DeliveredQuantity QuantityUnitCode="kpl">2</DeliveredQuantity> <UnitPriceAmount AmountCurrencyIdentifier="EUR" UnitPriceUnitCode="e / kpl">7,5</unitpriceamount> <RowDiscountPercent>0</RowDiscountPercent> <RowVatRatePercent>17</RowVatRatePercent> <RowVatAmount AmountCurrencyIdentifier="EUR">2,55</RowVatAmount> <RowVatExcludedAmount AmountCurrencyIdentifier="EUR">15,00</RowVatExcludedAmount> <RowAmount AmountCurrencyIdentifier="EUR">17,55</RowAmount> </InvoiceRow> <InvoiceRow> <ArticleIdentifier>spps</ArticleIdentifier> <ArticleName>Suksipaketti, Peltonen Sport</ArticleName> <DeliveredQuantity QuantityUnitCode="pr">2</DeliveredQuantity> <UnitPriceAmount AmountCurrencyIdentifier="EUR" UnitPriceUnitCode="e / pr">159</unitpriceamount> <RowDiscountPercent>15</RowDiscountPercent> <RowVatRatePercent>22</RowVatRatePercent> <RowVatAmount AmountCurrencyIdentifier="EUR">59,47</RowVatAmount> <RowVatExcludedAmount AmountCurrencyIdentifier="EUR">270,30</RowVatExcludedAmount> 12 Finvoice verkkolasku Asteri Lähete/laskutus
<RowAmount AmountCurrencyIdentifier="EUR">329,77</RowAmount> </InvoiceRow> <InvoiceRow> <ArticleIdentifier></ArticleIdentifier> <ArticleName>Ahkio, käytetty</articlename> <DeliveredQuantity QuantityUnitCode="kpl">1</DeliveredQuantity> <UnitPriceAmount AmountCurrencyIdentifier="EUR" UnitPriceUnitCode="e / kpl">98</unitpriceamount> <RowDiscountPercent>0</RowDiscountPercent> <RowVatRatePercent>0</RowVatRatePercent> <RowVatAmount AmountCurrencyIdentifier="EUR">0,00</RowVatAmount> <RowVatExcludedAmount AmountCurrencyIdentifier="EUR">98,00</RowVatExcludedAmount> <RowAmount AmountCurrencyIdentifier="EUR">98,00</RowAmount> </InvoiceRow> <InvoiceRow> <ArticleIdentifier></ArticleIdentifier> <ArticleName>Ahkion sarjanumero 123223</ArticleName> <DeliveredQuantity QuantityUnitCode="">0</DeliveredQuantity> <UnitPriceAmount AmountCurrencyIdentifier="EUR" UnitPriceUnitCode="e / ">0</UnitPriceAmount> <RowDiscountPercent>0</RowDiscountPercent> <RowVatRatePercent>0</RowVatRatePercent> <RowVatAmount AmountCurrencyIdentifier="EUR">0,00</RowVatAmount> <RowVatExcludedAmount AmountCurrencyIdentifier="EUR">0,00</RowVatExcludedAmount> <RowAmount AmountCurrencyIdentifier="EUR">0,00</RowAmount> </InvoiceRow> <InvoiceRow> <ArticleIdentifier>wä</ArticleIdentifier> <ArticleName>Asteri lähete/laskutus</articlename> <DeliveredQuantity QuantityUnitCode="kpl ">1</DeliveredQuantity> <UnitPriceAmount AmountCurrencyIdentifier="EUR" UnitPriceUnitCode="e / kpl ">409,83</UnitPriceAmount> <RowDiscountPercent>0</RowDiscountPercent> <RowVatRatePercent>22</RowVatRatePercent> <RowVatAmount AmountCurrencyIdentifier="EUR">90,16</RowVatAmount> <RowVatExcludedAmount AmountCurrencyIdentifier="EUR">409,83</RowVatExcludedAmount> <RowAmount AmountCurrencyIdentifier="EUR">499,99</RowAmount> </InvoiceRow> <InvoiceRow> <ArticleIdentifier>ywä</ArticleIdentifier> <ArticleName>Ylläpito lähete/laskutus</articlename> <DeliveredQuantity QuantityUnitCode="kpl ">12</DeliveredQuantity> <UnitPriceAmount AmountCurrencyIdentifier="EUR" UnitPriceUnitCode="e / kpl ">10,929</UnitPriceAmount> <RowDiscountPercent>0</RowDiscountPercent> <RowVatRatePercent>22</RowVatRatePercent> <RowVatAmount AmountCurrencyIdentifier="EUR">28,85</RowVatAmount> <RowVatExcludedAmount AmountCurrencyIdentifier="EUR">131,15</RowVatExcludedAmount> <RowAmount AmountCurrencyIdentifier="EUR">160,00</RowAmount> </InvoiceRow> <EpiDetails> <EpiIdentificationDetails> <EpiDate Format="CCYYMMDD">20041012</EpiDate> <EpiReference>10050105071</EpiReference> </EpiIdentificationDetails> <EpiPartyDetails> <EpiBfiPartyDetails> <EpiBfiIdentifier IdentificationSchemeName="BIC">NDEAFIHH</EpiBfiIdentifier> </EpiBfiPartyDetails> <EpiBeneficiaryPartyDetails> <EpiNameAddressDetails>Asteri Malliyritys Oy</EpiNameAddressDetails> Finvoice verkkolasku Asteri Lähete/laskutus 13
<EpiAccountID IdentificationSchemeName="IBAN">FI1029501800069357</EpiAccountID> </EpiBeneficiaryPartyDetails> </EpiPartyDetails> <EpiPaymentInstructionDetails> <EpiRemittanceInfoIdentifier IdentificationSchemeName="SPY">10050105071</EpiRemittanceInfoIdentifier> <EpiInstructedAmount AmountCurrencyIdentifier="EUR">1175,50</EpiInstructedAmount> <EpiCharge ChargeOption="SHA">SHA</EpiCharge> <EpiDateOptionDate Format="CCYYMMDD">20040227</EpiDateOptionDate> </EpiPaymentInstructionDetails> </EpiDetails> </Finvoice> 14 Finvoice verkkolasku Asteri Lähete/laskutus
Mallilasku 10507, kaikki tiedot sisältävä lasku (Asterista tulostettuna paperilaskuna) Finvoice verkkolasku Asteri Lähete/laskutus 15
Mallilasku 10507 katsottuna nettiselaimella Tässä kuvattu toimintoa tarvitaan vain testausvaiheessa. Kun tallennetaan vain yksi Finvoice tallentamatta kehystä (SOAPenvelopea) mutta tallennetaan (*) *.xsl (laskun muotoilu) voidaan tallentunut lasku avata nettiselaimeen. Hakemistossa oltava Finvoice.xsl stylesheet (ladattavissa Pankkiyhdistyksen sivuilta) ja tallennetun laskun tarkentimena *.xml 16 Finvoice verkkolasku Asteri Lähete/laskutus
Finvoice verkkolasku Asteri Lähete/laskutus 17
Mallilaskun 10507 konekielinen kuvaus Tässä kuvattu toimintoa tarvitaan vain testausvaiheessa. Kun tallennetaan vain yksi Finvoice tallentamatta kehystä (SOAPenvelopea) mutta tallennetaan (*) *.dtd (laskun konekielinen kuvays elementit boldilla) voidaan tallentunut lasku avata nettiselaimeen. Hakemistossa oltava Finvoice.dtd stylesheet (ladattavissa Pankkiyhdistyksen sivuilta) ja tallennetun laskun tarkentimena *.xml 18 Finvoice verkkolasku Asteri Lähete/laskutus
Finvoice verkkolasku Asteri Lähete/laskutus 19
Mikä on Finvoice? Finvoice on pankkien suosittelema standardi verkkolaskulle. Finvoice verkkolaskun välittämiseksi ostajalta myyjälle käytetään siirtokehystä, jossa ovat osoitetiedot lähettäjältä myyjälle. Lähtevässä laskussa on kaksi osaa: Siirtokehys (keneltä kenelle, Soap-envelope) kirjekuori Finvoice (itse lasku) Yhdessä tiedostossa voi olla useita eri asiakkaille lähteviä laskuja (siirtokehys-finvoice -pareja) peräkkäin. Tarkempi kuvaus Finvoicesta on luettavissa Suomen Pankkiyhdistyksen julkaisemasta Finvoicen soveltamisohjeesta, johon on linkki pankkiyhdistyksen Finvoice verkkolaskusivulla, osoitteessa http://www.pankkiyhdistys.fi/verkkolasku/ (soveltamisohjeen suora osoite oli tuolloin www.pankkiyhdistys.fi/verkkolasku/soveltamisohje11.pdf) 20 Finvoice verkkolasku Asteri Lähete/laskutus