Versio 1.2 1.10.2016 XML-TILIOTE Soveltamisohje
2 (16) Sisällysluettelo VERSIOLUETTELO... 3 1 YLEISTÄ... 4 2 XML-TILIOTE... 4 3 TILIOTEAINEISTON RAKENNE... 6
3 (16) VERSIOLUETTELO Versionro Päiväys Muutokset 1.2. 1.10.2016 Päivitetty BankTransactionCode Domain, FamilyCode sekä SubFamilyCode. 1.1 10.3.2015 Päivitetty pankkiryhmien BIC-koodit 1.0 Lokakuu 2011 Alkuperäinen
4 (16) 1 YLEISTÄ Tämä on palvelukuvaus XML-muotoisesta tilioteaineistosta. Aineisto luodaan asiakkaan noudettavaksi asiakkaan kanssa sovittuun kanavaan. Samlinkin tuottama xml-tiliote vastaa FK:n ISO 200022 Tilioteoppaassa kuvattua sisältöä ja rakennetta muutamin poikkeuksin. Tämä palvelukuvaus koskee Aktiaa, Handelsbankenia, POP Pankkeja ja Säästöpankkeja. 2 XML-TILIOTE Xml-tiliote voidaan noutaa Web Services kanavan tai Yritysverkkopalvelun kautta (eräsiirtopalvelu). Xml-tiliotteesta käytettävä sanomatyyppi on Bank-to-Customer Statement sanoma (camt.053.001.02 BankToCustomerStatementV02). Bank-to-Customer Statement sanomalla pankki raportoi kirjatut tilitapahtumat, mahdolliset erittelytapahtumat sekä saldotiedot. Se on pankin toimittama virallinen tiliote, joka on Kirjanpitolautakunnan hyväksymä. Aineiston rakenne on kuvattu alla: 1..1 GrpHrd BkToCstmrStmt 1..1 1..1 Stmt Acct 0..1 3..3 1..1 RltdAcct Bal TxsSummary 0..n 1..1 Ntry BkTxCd 0..n 0..1 NtryDtls Btch 0..n 0..1 TxDtls 0..1 Refs AmtDtls 0..1 0..1 Chrgs RltdPties 0..1 RmtInf
5 (16) Kappaleessa tilioteaineiston rakenne on kerrottu Samlinkin toimittaman xml-tiliotteen sisältö. Taulukon sarakkeen toistuvuus selitykset ovat seuraavat: 1..1 tieto käytössä aina 0..1 tieto voi olla käytössä tai puuttua 0..n tietoja voi olla nollasta n:ään kertaa 1..n tieto on vähintään yhden kerran, mutta voi olla useamminkin Samlinkin eräsiirrosta noudettavan xml-tiliotteen aineiston sovellustunnus on XT kaikkien pankkien osalta. Yhdessä aineistossa on yksi tiliote (yksi group header ja yksi statement). Ohje xml-tiliotteen noutamiseksi Web Services -yhteyden kautta Nouto tapahtuu DownloadFileList-operaatiolla samalla tavalla kuin muidenkin noudettavien aineistojen kohdalla nyt menetellään. ApplicationRequest-sanoman FileType-elementtiin asetetaan aineistolajiksi XT. XML-tiliotteet ovat UTF8-enkoodattuja kuten muutkin XML-aineistot. Aineiston koko voi olla Web Services-kanavassa enintään 30 MB.
6 (16) 3 TILIOTEAINEISTON RAKENNE XML-muotoisen sanoman tiedot: 1.1 GROUP HEADER GroupHeader <GrpHdr> 1..1 MessageIdentificatio n <GrpHdr> <MsgId> 1..1 20111213FI18405 51010234569 CreationDateTime <GrpHdr> 1..1 2011-12- <CreDtTm> 12T23:05:15+02. 00 Pankin antama sanoman yksilöivä tunniste Tiliotesanoman muodostusaika 1.2 STATEMENT Statement <Stmt> 1..n Statement Id <Stmt><Id> 1..1 Tiliotteen tunniste Muoto: vvvvkkpp + tilinumero + juokseva nro/pv ElectronicSequence <Stmt> 0..1 Ei käytössä Number LegalSequenceNum ber CreationDateTime FromDateTime ToDateTime <ElctrnSeqNb> <Stmt> <LglSeqNb> <Stmt> <CreDtTm> <Stmt> <FrToDt><FrDtT m> <Stmt> <FrToDt> <ToDtT> 1..1 123 Tiliotteen numero. Päivä- ja kausitiliotteilla on erillinen numerointi. 1..1 2011-12- Tiliotteen luontiajankohta 12T23:05:15+02. 00 1..1 Tiliotekauden ensimmäinen päivä 1..1 Tiliotekauden viimeinen päivä Account <Stmt><Acct> 1..1 Identification <Stmt><Acct> 1..1 FI1831311010234 Tilinumero <Id><IBAN> 569 Type <Stmt><Acct> 1..1 Vakio CACC = Current <Tp><Cd> Currency <Stmt><Acct> 1..1 Tilin valuuttakoodi <Ccy> Owner Name <Stmt><Acct> <Own><Nm> 0..1 Tilin omistajan nimi
7 (16) Servicer/FinancialIns titutionidentification Related Account Additional Statement Information <Stmt><Acct> <Svcr> <FinInstnId> <BIC> <Stmt> <RltdAcct><Id> <IBAN> <Stmt> <AddtlStmtInf> 1..1 HELSFIHH (Aktia) ITELFIHH (Säästöpankit) POPFFI22 (POP Pankit) HANDFIHH (Handelsbanken) Raportoivan pankin BIC 0..1 Jos tiliotetili (Account) on konsernitilin alatili, kerrotaan tässä konsernin päätilin tilinumero. 0..1 Pankin antama viesti 1.3 SALDOT Balance <Stmt><Bal> 1..n Type /Code <Stmt><Bal> <Tp> <CdOrPrty> <Cd> 1..1 Saldotyypit OPBD = Alkusaldo CLBD = Loppusaldo CLAV = Käytettävissä oleva Included Amount Amount CreditDebitIndicator Date <Stmt><Bal> <CdtLine> <Incl> <Stmt><Bal> <CdtLine> <Amt> <Stmt><Bal> <Amt> <Stmt><Bal> <CdtDbtInd> <Stmt><Bal> <Dt><Dt> saldo 1..1 Kertoo onko saldossa huomioitu tilin mahdollinen limiitti (FALSE / TRUE) 0..1 Tilin limiitin määrä 1..1 EUR2000.00 Tilin valuutta ja saldo 1..1 CRDT = saldo on plusmerkkinen DBIT = saldo on miinusmerkkinen 1..1 2011-06-13 Saldon päivämäärä 1.4 TRANSACTION SUMMARY TransactionSummary <TxsSummry> 1..1 TotalEntries <TtlNtries> <NbOfNtries> 1..1 Kaikkien tiliotteen tapahtumien lukumäärä TotalCreditEntries <TtlCdtNtries> <NbOfNtries> 1..1 Kaikkien tiliotteen panotapahtumien lukumäärä kpl
8 (16) TotalCreditEntries TotalDebitEntries TotalDebitEntries <TtlCdtNtries> <Sum> <TtlDbtNtries> <NbOfNtries> <TtlDbtNtries><S um> 1..1 Kaikkien tiliotteen panotapahtumien rahamäärä yhteensä 1..1 Kaikkien tiliotteen ottotapahtumien lukumäärä kpl 1..1 Kaikkien tiliotteen ottotapahtumien rahamäärä yhteensä 1.5 STATEMENT ENTRY Statement Entry <Stmt> 0-n Amount <Amt> 1..1 EUR200.00 Tapahtuman valuutta ja rahamäärä. CreditDebitIndicator <CdtDbtInd> 1..1 DBIT = otto CRDT = pano Status <Sts> 1..1 BOOK = tapahtuma kirjattu Booking Date ValueDate AccountServicer Reference BankTransactionCod e/ Domain <BookgDt> <Dt> <ValDt> <Dt> <AcctSvcrRef> <BkTxCd> <Domn> <Cd> tilille 1..1 2011-06-13 Kirjauspäivä 1..1 2011-06-13 Arvopäivä 0..1 Tapahtuman arkistointitunnus 1..1 PMNT = Payments (maksut) LDAS = Loans and deposits (lainanlyhennykset tai nosto) CAMT= Cash Management (Sweeping, topping etc.) ACMT = Account management XTND = Entended Domain SECU = Securities FORX = Foreign Exchange NTAV = not available
9 (16) FamilyCode SubFamilyCode Proprietary Code <BkTxCd> <Domn> <Family> <Cd> <BkTxCd> <Domn> <Family> <SubFmlyCd> <BkTxCd> <Prtry><Cd> 1..1 RCDT =Received Credit Transfers ICDT =Issued Credit Transfers MCRD = Merchant Card Transaction Kauppiaan hyvitys IDDT = Issued Direct Debits RDDT = Received Direct Debits CCRD = Customer Card Transactions ICHQ = Issued Cheques RCHQ = Received Cheques MDOP = Miscellaneous Debit Operations MCOP = Miscellaneous Credit Operations ACCB = Account Balancing CASH = Miscellaneous Securities Operations CNTR = Counter transaction NTAV = Not available 1..1 ESCT = Sepa Credit Transfer SALA = Sepa Credit Transfer /Sala INTR = Interest OTHR = Other RIMB =Reimbursement ESDD = SEPA direct debit service for consumers BBDD = SEPA B2B direct debit service UPDD = Unpaid Direct Debit STDO = Standing Order CHRG = Charges XBCT = Cross Border Credit Transfer ZABA = Zero Balancing SWEP = Sweeping TOPG = Topping DVCA = Cash Dividends 0..1 701Toistuvaissuori tus NTAV = Not available Kirjausselitekoodi + kirjausselitekoodin selväkielinen nimi
10 (16) Issuer Message Identification Payment Information Identification NumberOf Transcactions Transaction Details AccountServicer Reference InstructionIdentificatio n EndToEndIdentificati on ProprietaryType Proprietary Reference Instructed amount Transaction Amount <BkTxCd> <Prtry> <Issr> <Btch> <MsgId> <Btch> <PmtInfId> <Btch> <NbOfTxs> <TxDtls ><Refs> <AcctSvcrRef> <Refs><InstrId> <Refs> <EndToEndId> <Refs> <Prtry><Tp> <Refs> <Prtry><Ref> <AmtDtls> <lnstrdamt> <Amt> <AmtDtls> <TxAmt> <Amt> 0..1 Vakio FFFS 0..1 Maksajan antama maksusanoman yksilöintitieto, jos annettu. Muuten tyhjää. 0..1 Maksajan antama erän yksilöintitieto, jos annettu. Muuten tyhjää. 0..1 Koontitapahtumaan liittyvien tapahtumien määrä. 1..n 0..1 Tapahtuman arkistointitunnus. 0..1 Maksajan antama tieto itselleen 0..1 Maksajan antama tieto saajalle 0..1 Korttitapahtuman kortinnumero. Korjaustapahtumalla ORIG 0..1 Korttitapahtuman kaupan arkistoviite tai vakio CARD. Korjaustapahtuman alkuperäinen arkistointitunnus 0..1 SEK1000.00 Valuuttamääräisen maksun valuuttakoodi(iso) ja määrä 0..1 EUR100.00 Maksun rahamäärän valuuttakoodi ja määrä (tilin valuutassa)
11 (16) SourceCurrency TargetCurrency UnitCurrency ExchangeRate Contract Identification Proprietary Amount Debtor Name <AmtDtls> <TxAmt> <CcyXchg> <SrcCcy> <AmtDtls> <TxAmt> <CcyXchg> <TrgCcy> <AmtDtls> <TxAmt> <CcyXchg> <UnitCcy> <AmtDtls> <TxAmt> <CcyXchg> <XchgRate> <AmtDtls> <TxAmt> <CcyXchg> <CtrctId> <AmtDtls> <PrtryAmt> <Dbtr><Nm> 0..1 Maksun alkuperäinen valuutta 0..1 Tilin valuutta 0..1 Valuutan vaihdossa käytetty valuutta. 0..1 Valuuttakurssi 0..1 Kurssiviite Kun valuuttamaksu on esim. USD dollareita SEKtilille, käytetään tätä rakennetta. Rakenne toistuu 2 kertaa (USD-EUR ja EUR-SEK kurssaustiedot erikseen). 0..1 Maksajan nimi. Käytetään hyvitystapahtumalla
12 (16) Address Organization Identification TAI Private Identification Ultimate Debtor UltimateDebtor Organization Identification TAI Private Identification Creditor Name <Dbtr> <PstlAdr> <AdrLine> <RltPties> <Dbtr><Id> <OrgId> <Othr><Id> <RltPties> <Dbtr><Id> <PrvId> <Othr><Id> <UltmtDbtr> <Nm> <RltPties> <UltmDbtr> <Id> <OrgId> <Othr><Id> <RltPties> <UltmDbtr> <Id><PrvId> <Othr><Id> <Cdtr><Nm> 0..1 Maksajan osoite. Käytetään hyvitystapahtumalla 0..1 Maksajan tunniste. Maksajan tunniste. 0..1 Alkuperäisen maksajan nimi 0..1 Alkuperäisen maksajan tunniste Alkuperäisen maksajan tunniste. 0..1 Saajan nimi
13 (16) Address Organization Identification TAI Private Identification Creditor Account /IBAN TAI Creditor Account /other Scheme Name Type/proprietary Ultimate Creditor <Cdtr> <PstlAdr> <Adrline> <RltPties> <Cdtr><Id> <OrgId> <Othr><Id> <RltPties> <Cdtr><Id> <PrvId><Othr><Id > <CdtrAcct> <Id><IBAN> <CdtrAcct> <Id><Othr> <Id> <CdrtAcct> <Id><Othr> <SchmeNm> <Cd> <CdtrAcct> <Tp><Prtry> 0..1 Saajan osoite 0..1 Saajan tunniste Saajan tunniste 0..1 Saajan tili IBAN Saajan tili, jos muu kuin IBAN 0..1 Jos saajan tilinnumero muu kuin IBAN, on tässä BBAN 0..1 Jos pankki on muuttanut tilinumeroa, on tässä arvo ACWC
14 (16) Name Organization Identification TAI Private Identification Related Agent CreditorAgent Purpose/Code TAI Purpose/Proprietary AcceptanceDate <UltmtCdtr> <Nm> <RltPties> <UltmCdrt> <Id> <OrgId> <Othr><Id> <RltPties> <UltmCdtr> <Id> <PrvId> <Othr><Id> <RltdAgts> <CdtrAgt> <FinInstnId> <BIC> <Purp><Cd> <Purp><Prtry> <RltdDts> <AccptncDtTm> 0..1 Lopullisen saajan nimi. 0..1 Lopullisen saajan tunniste Lopullisen saajan tunniste. 0..1 Saajan pankin BIC 0..1 Maksun aihe Jos tapahtuma on toistuvaissuoritus ja hyvitys, eikä edelliseen kenttään löytynyt koodia, on tässä kentässä maksunaihe selväkielisenä. 0..1 Maksupäivä Muoto: vvvv-kk-pp + vakio T + hh:mm:ss + vakio +02:00 Lisäksi maksuun voi liittyä seuraavanlaisia tietoja:
15 (16) Remittance Information Maksulla vapaamuotoinen viesti: 0..1 Remittance Information/ Unstructured <Ustrd> Maksulla viite: 0..1 Reference Type Code <CdtrRefInf> <Tp> <CdOrPrtry> <Cd> Issuer <CdtrRefInf> <Tp><Issr> Reference <CdtrRefInf> <Ref> Vapaa viesti SCOR = on viite Kun viite on kansainvälinen viite, on tässä vakio ISO. Viite Maksuun liittyy erittelyjä Type/Code <RfrdDocInf> <Tp> <CdOrPrtry> <Cd> Number <RfrdDocInf> <Nb> RelatedDate <RfrdDocInf> <RltdDt> 0..n Laskulaji CREN = hyvityslasku CINV = lasku 123 Laskun numero 2011-05-31 Laskun päiväys
16 (16) Amount Reference Type Code Issuer Reference Organization Id Additional Information <RfrdDocAmt> <RmtdAmt> <CdtrRefInf> <Tp> <CdOrPrtry> <Cd> <CdtrRefInf> <Tp><Issr> <CdtrRefInf> <Ref> <Invcr> <Id><OrgId> <Othr><Id> <AddtlRmtInf> EUR200.00 Rahamäärä ja valuutta Kun tapahtumalla on viite, on tässä vakio SCOR. Kun viite on kansainvälinen viite, on tässä vakio ISO. Viite Asiakasnumero Laskuerittelyn viesti