XML-TILIOTE. Palvelukuvaus Aktia Pankki Oyj PL Helsinki Puh Faksi Y-tunnus

Transkriptio

1 XML-TILIOTE Palvelukuvau Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

2 2 Siällyluettelo 1 Yleitä XML-tiliote Tilioteaineiton rakenne... 5 Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

3 3 1 Yleitä 2 XML-tiliote Tämä on palvelukuvau XML-muotoieta tilioteaineitota. Aineito luodaan aiakkaan noudettavaki aiakkaan kana ovittuun kanavaan. Aktian tuottama xml-tiliote vataa FK:n ISO Tilioteoppaaa kuvattua iältöä ja rakennetta muutamin poikkeukin. Xml-tiliote voidaan noutaa Web Service kanavan tai Yrityverkkopalvelun kautta (eräiirtopalvelu). Xml-tiliotteeta käytettävä anomatyyppi on Bank-to-Cutomer Statement -anoma (camt BankToCutomerStatementV02). Bank-to-Cutomer Statement -anomalla pankki raportoi kirjatut tilitapahtumat, mahdolliet erittelytapahtumat ekä aldotiedot. Se on pankin toimittama virallinen tiliote, joka on Kirjanpitolautakunnan hyväkymä. Aineiton rakenne on kuvattu alla: Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

4 4 Kappaleea tilioteaineiton rakenne on kerrottu Aktian toimittaman xml-tiliotteen iältö. Taulukon arakkeen toi elityket ovat euraavat: 1..1 tieto käytöä aina 0..1 tieto voi olla käytöä tai puuttua 0..n tietoja voi olla nollata n:ään kertaa 1..n tieto on vähintään yhden kerran, mutta voi olla ueamminkin Aktian noudettavan xml-tiliotteen aineiton ovellutunnu on XT. Yhdeä aineitoa on yki tiliote (yki group header ja yki tatement). Ohje xml-tiliotteen noutamieki Web Servicen kautta Nouto tapahtuu DownloadFileLit-operaatiolla amalla tavalla kuin muidenkin noudettavien aineitojen kohdalla nyt menetellään. ApplicationRequet-anoman FileType- elementtiin aetetaan aineitolajiki XT. XML-tiliotteet ovat UTF8-enkoodattuja kuten muutkin XML-aineitot. Aineiton koko voi olla Web ervice-kanavaa enintään 30 MB. Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

5 5 3 Tilioteaineiton rakenne XML-muotoien anoman tiedot: Group header Sanoman tieto XML Tag Toi Siältöeimerkki GroupHeader <GrpHdr> 1..1 MeageIdentifica- <GrpHdr> FI tion CreationDateTime <MgId> <GrpHdr> <CreDtTm> T23:05: Arvo, Selite, Käittely Pankin antama anoman ykilöivä tunnite Tilioteanoman muodotuaika Statement Sanoman tieto XML Tag Toi Siältöeimerkki Arvo, Selite, Käittely Statement <Stmt> 1..n Statement Id <Stmt><Id> 1..1 Tiliotteen tunnite Muoto: vvvvkkpp + tilinumero + juokeva nro/pv ElectronicSe- <Stmt> 0..1 Ei käytöä quencenumber LegalSequenceNumber <ElctrnSeqNb> <Stmt> <LglSeqNb> Tiliotteen numero. Päivä- ja kauitiliotteilla on erillinen numerointi Tiliotteen luontiajankoh- CreationDateTime <Stmt> <CreDtTm> 12T23:05: ta FromDateTime <Stmt> 1..1 Tiliotekauden enim- <FrToDt><FrDt mäinen päivä Tm> ToDateTime <Stmt> 1..1 Tiliotekauden viimeinen <FrToDt> päivä <ToDtT> Account <Stmt><Acct> 1..1 Identification <Stmt><Acct> 1..1 FI Tilinumero <Id><IBAN> Type <Stmt><Acct> 1..1 Vakio CACC = Cur- <Tp><Cd> rent Currency <Stmt><Acct> 1..1 Tilin valuuttakoodi Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

6 6 Sanoman tieto XML Tag Toi Siältöeimerkki Arvo, Selite, Käittely <Ccy> Owner Name <Stmt><Acct> 0..1 Tilin omitajan nimi Servicer/FinancialInti tutionidentification <Own><Nm> <Stmt><Acct> <Svcr> <FinIntnId> <BIC> 1..1 HELSFIHH Raportoivan pankin BIC Related Account Additional Statement Information <Stmt> <RltdAcct><Id> <IBAN> <Stmt> <AddtlStmtInf> Pankin antama vieti Saldot Sanoman tieto XML Tag Toi Balance <Stmt><Bal> 1..n Type /Code <Stmt><Bal> <Tp> <CdOrPrty> <Cd> Included Amount Amount CreditDebitIndicator <Stmt><Bal> <CdtLine> <Incl> <Stmt><Bal> <CdtLine> <Amt> <Stmt><Bal> <Amt> <Stmt><Bal> <CdtDbtInd> Siältöeimerkki Arvo, Selite, Käittely 1..1 Saldotyypit OPBD = Alkualdo CLBD = Loppualdo CLAV = Käytettäviä oleva aldo 1..1 Kertoo onko aldoa huomioitu tilin mahdollinen limiitti (FALSE / TRUE) 0..1 Tilin limiitin määrä 1..1 EUR Tilin valuutta ja aldo 1..1 CRDT = aldo on plumerkkinen DBIT = aldo on mii- Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

7 7 Sanoman tieto XML Tag Toi Date <Stmt><Bal> <Dt><Dt> Siältöeimerkki Arvo, Selite, Käittely numerkkinen Saldon päivämäärä Tranaction Summary Sanoman tieto XML Tag Toi Siältöeimerkki Arvo, Selite, Käittely TranactionSum- <TxSummry> 1..1 mary TotalEntrie <TtlNtrie> 1..1 Kaikkien tiliotteen tapah- TotalCreditEntrie TotalCreditEntrie TotalDebitEntrie TotalDebitEntrie Statement Entry <NbOfNtrie> <TtlCdtNtrie> <NbOfNtrie> <TtlCdtNtrie> <Sum> <TtlDbtNtrie> <NbOfNtrie> <TtlDbtNtrie> <Sum> tumien lukumäärä 1..1 Kaikkien tiliotteen panotapahtumien lukumäärä kpl 1..1 Kaikkien tiliotteen panotapahtumien rahamäärä yhteenä 1..1 Kaikkien tiliotteen ottotapahtumien lukumäärä kpl 1..1 Kaikkien tiliotteen ottotapahtumien rahamäärä yhteenä Sanoman tieto XML Tag Toi Siältöeimerkki Arvo, Selite, Käittely Statement Entry <Stmt> 0-n Amount <Amt> 1..1 EUR Tapahtuman valuutta ja rahamäärä. CreditDebitIndicator <CdtDbtInd> 1..1 DBIT = otto CRDT = pano Statu <St> 1..1 BOOK = tapahtuma kirjattu tilille Booking Date <BookgDt> Kirjaupäivä Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

8 8 Sanoman tieto XML Tag Toi Siältöeimerkki Arvo, Selite, Käittely <Dt> ValueDate Arvopäivä <ValDt> <Dt> AccountServicer 0..1 Tapahtuman arkitointi- Reference BankTranaction- Code/ Domain FamilyCode <AcctSvcrRef> <BkTxCd> <Domn> <Cd> <BkTxCd> <Domn> <Family> <Cd> tunnu 1..1 PMNT = Payment (makut) LDAS= Loan and depoit (lainanlyhennyket tai noto) CAMT= Cah Management (Sweeping, topping etc.) NTAV = not available 1..1 RCDT =Received Credit Tranfer ICDT =Iued Credit Tranfer MCRD = Merchant Card Tranaction Kauppiaan hyvity IDDT = Iued Direct Debit RDDT = Received Direct Debit CCRD = Cutomer Card Tranaction ICHQ = Iued Cheque MDOP = Micellaneou Debit Operation MCOP = Micellaneou Credit Operation ACCB = Account Balancing NTAV = Not available SubFamilyCode <BkTxCd> <Domn> <Family> <SubFmlyCd> 1..1 ESCT = Sepa Credit Tranfer SALA = Sepa Credit Tranfer /Sala DMCT = Dometic Cre- Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

9 9 Sanoman tieto XML Tag Toi Siältöeimerkki Arvo, Selite, Käittely dit Tranfer NTAV = Not available INTR = Interet OTHR = Other RIMB =Reimburement PMDD = Direct Debit STDO = Standing Order CHRG = Charge XBCT = Cro Border Credit Tranfer ZABA = Zero Balancing SWEP = Sweeping TOPG = Topping Proprietary Code Iuer Meage Identification Payment Information Identification NumberOf Trancaction Tranaction Detail AccountServicer Reference IntructionIdentification <BkTxCd> <Prtry><Cd> <BkTxCd> <Prtry> <Ir> <Btch> <MgId> <Btch> <PmtInfId> <Btch> <NbOfTx> <Tx Dtl><Ref> <AcctSvcrRef> <Ref><IntrId> Toituvaiuoritu Kirjauelitekoodi + kirjauelitekoodin elväkielinen nimi 0..1 Vakio FFFS 0..1 Makajan antama makuanoman ykilöintitieto, jo annettu. Muuten tyhjää Makajan antama erän ykilöintitieto, jo annettu. Muuten tyhjää Koontitapahtumaan liittyvien tapahtumien määrä. 1..n 0..1 Tapahtuman arkitointitunnu Makajan antama tieto itelleen Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

10 10 Sanoman tieto XML Tag Toi EndToEndIdentification ProprietaryType Proprietary Reference <Ref> <EndToEndId> <Ref> <Prtry><Tp> <Ref> <Prtry><Ref> Siältöeimerkki Arvo, Selite, Käittely 0..1 Makajan antama tieto aajalle XXXX XXXX 1234 Korttitapahtuman kortinnumero. Korjautapahtumalla ORIG 0..1 Korttitapahtuman kaupan arkitoviite tai vakio CARD. Korjautapahtuman alkuperäinen arkitointitunnu Intructed amount Tranaction Amount SourceCurrency TargetCurrency <AmtDtl> <lntrdamt> <Amt> <AmtDtl> <TxAmt> <Amt> <AmtDtl> <TxAmt> <CcyXchg> <SrcCcy> <AmtDtl> <TxAmt> 0..1 SEK Valuuttamääräien makun valuuttakoodi(iso) ja määrä 0..1 EUR Makun rahamäärän valuuttakoodi ja määrä (tilin valuutaa) 0..1 Makun alkuperäinen valuutta 0..1 Tilin valuutta Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

11 11 Sanoman tieto XML Tag Toi <CcyXchg> UnitCurrency ExchangeRate Contract Identification <TrgCcy> <AmtDtl> <TxAmt> <CcyXchg> <UnitCcy> <AmtDtl> <TxAmt> <CcyXchg> <XchgRate> <AmtDtl> <TxAmt> <CcyXchg> <CtrctId> Proprietary Amount <AmtDtl> <PrtryAmt> Debtor Name Addre <RltdPtie> <Dbtr><Nm> <RltdPtie> <Dbtr> <PtlAdr> Siältöeimerkki Arvo, Selite, Käittely 0..1 Pankin valuutan vaihdoa käyttämä valuutta Valuuttakuri 0..1 Kuriviite Kun valuuttamaku on eim. USD dollareita SEK-tilille, käytetään tätä rakennetta. Rakenne toituu 2 kertaa (USD- EUR ja EUR-SEK kurautiedot erikeen) Makajan nimi. Käytetään hyvitytapahtumalla 0..1 Makajan ooite. Käytetään hyvitytapahtumalla Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

12 12 Sanoman tieto XML Tag Toi Siältöeimerkki Arvo, Selite, Käittely <AdrLine> Organization Iden Makajan tunnite. tification <RltPtie> <Dbtr><Id> <OrgId> TAI <Othr><Id> Private Identification Ultimate Debtor UltimateDebtor <RltPtie> <Dbtr><Id> <PrvId> <Othr><Id> <RltdPtie> <UltmtDbtr> <Nm> Makajan tunnite Alkuperäien makajan nimi Organization Iden Alkuperäien makajan tification tunnite <RltPtie> <UltmDbtr> <Id> TAI Private Identification Creditor <OrgId> <Othr><Id> <RltPtie> <UltmDbtr> <Id><PrvId> <Othr><Id> Alkuperäien makajan tunnite. Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

13 13 Sanoman tieto XML Tag Toi Siältöeimerkki Arvo, Selite, Käittely Name 0..1 Saajan nimi <RltdPtie> <Cdtr><Nm> Addre 0..1 Saajan ooite <RltdPtie> <Cdtr> <PtlAdr> <Adrline> Organization Iden Saajan tunnite tification <RltPtie> <Cdtr><Id> <OrgId> <Othr><Id> TAI Private Identification <RltPtie> <Cdtr><Id> <PrvId><Othr> <Id> Saajan tunnite Creditor Account 0..1 Saajan tili /IBAN IBAN <RltdPtie> <CdtrAcct> <Id><IBAN> TAI Creditor Account Saajan tili, jo muu kuin /other IBAN <RltdPtie> <CdtrAcct> Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

14 14 Sanoman tieto XML Tag Toi <Id><Othr> Scheme Name Type/proprietary Ultimate Creditor Name <Id> <RltdPtie> <CdrtAcct> <Id><Othr> <SchmeNm> <Cd> <RltdPtie> <CdtrAcct> <Tp><Prtry> <RltdPtie> <UltmtCdtr> <Nm> Siältöeimerkki Arvo, Selite, Käittely 0..1 Jo aajan tilinnumero muu kuin IBAN, on tää BBAN 0..1 Jo pankki on muuttanut tilinumeroa, on tää arvo ACWC 0..1 Lopullien aajan nimi. Organization Iden Lopullien aajan tunnitification te <RltPtie> <UltmCdrt> <Id> TAI Private Identification Related Agent <OrgId> <Othr><Id> <RltPtie> <UltmCdtr> <Id> <PrvId> <Othr><Id> Lopullien aajan tunnite. Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

15 15 Sanoman tieto XML Tag Toi Siältöeimerkki Arvo, Selite, Käittely CreditorAgent <RltdAgt> <CdtrAgt> <FinIntnId> <BIC> 0..1 Saajan pankin BIC Purpoe/Code 0..1 Makun aihe TAI <Purp><Cd> Jo tapahtuma on toitu- Purpoe/Proprietary vaiuoritu ja hyvity, eikä edellieen kenttään löytynyt koodia, on tää kentää makunaihe <Purp><Prtry> elväkielienä. AcceptanceDate 0..1 Makupäivä Muoto: vvvv-kk-pp + vakio T + <RltdDt> hh:mm: + <AccptncDtTm vakio +02:00 > Liäki makuun voi liittyä euraavanlaiia tietoja: Remittance Information Sanoman tieto XML Tag Toi Siältöeimerkki Arvo, Selite, Käittely Makulla vapaamuotoinen vieti: 0..1 Remittance Infor- Vapaa vieti mation/ Untructured <Utrd> Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

16 16 Sanoman tieto XML Tag Toi Makulla viite: 0..1 Reference Type Code <CdtrRefInf> <Tp> <CdOrPrtry> <Cd> Iuer <CdtrRefInf> <Tp><Ir> Reference <CdtrRefInf> <Ref> Siältöeimerkki Arvo, Selite, Käittely SCOR = on viite Kun viite on kanainvälinen viite, on tää vakio ISO. Viite Makuun liittyy erittelyjä Type/Code <RfrdDocInf> <Tp> <CdOrPrtry> <Cd> Number <RfrdDocInf> <Nb> RelatedDate 0..n Lakulaji CREN = hyvitylaku CINV = laku 123 Lakun numero Lakun päiväy Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu

17 17 Sanoman tieto XML Tag Toi <RfrdDocInf> <RltdDt> Amount <RfrdDocAmt> <RmtdAmt> Reference Type Code Iuer Reference Organization Id Additional Information <CdtrRefInf> <Tp> <CdOrPrtry> <Cd> <CdtrRefInf> <Tp><Ir> <CdtrRefInf> <Ref> <Invcr> <Id><OrgId> <Othr><Id> <AddtlRmtInf> Siältöeimerkki EUR Arvo, Selite, Käittely Rahamäärä ja valuutta Kun tapahtumalla on viite, on tää vakio SCOR. Kun viite on kanainvälinen viite, on tää vakio ISO. Viite Aiakanumero Lakuerittelyn vieti Aktia Pankki Oyj PL Helinki Puh Faki Y-tunnu