XML-TILIOTE Palvelukuvau Lokakuu 2011
OY SAMLINK AB PALVELUKUVAUS 2 (17) Siällyluettelo Siällyluettelo 1 Yleitä... 3 2 XML-tiliote... 3 3 Tilioteaineiton rakenne... 5
OY SAMLINK AB PALVELUKUVAUS 3 (17) 1 Yleitä Tämä on palvelukuvau XML-muotoieta tilioteaineitota. Aineito luodaan aiakkaan noudettavaki aiakkaan kana ovittuun kanavaan. Samlinkin tuottama xml-tiliote vataa FK:n ISO 200022 Tilioteoppaaa kuvattua iältöä ja rakennetta muutamin poikkeukin. Tämä palvelukuvau kokee Aktiaa, Handelbankenia, Itella Pankkia, POP Pankkeja ja Säätöpankkeja. 2 XML-tiliote Xml-tiliote voidaan noutaa Web Service kanavan tai Yrityverkkopalvelun kautta (eräiirtopalvelu), ei kuitenkaan Patu-kanavan kautta. Xml-tiliotteeta käytettävä anomatyyppi on Bank-to-Cutomer Statement anoma (camt.053.001.02 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:
OY SAMLINK AB PALVELUKUVAUS 4 (17) Kappaleea tilioteaineiton rakenne on kerrottu Samlinkin 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 Samlinkin eräiirrota noudettavan xml-tiliotteen aineiton ovellutunnu on XT kaikkien pankkien oalta. Yhdeä aineitoa on yki tiliote (yki group header ja yki tatement). Ohje xml-tiliotteen noutamieki Web ervicen kautta Nouto tapahtuu DownloadFileLit-operaatiolla amalla tavalla kuin muidenkin noudettavien aineitojen kohdalla nyt menetellään. ApplicationRequet-anoman FileTypeelementtiin aetetaan aineitolajiki XT. XML-tiliotteet ovat UTF8-enkoodattuja kuten muutkin XML-aineitot. Aineiton koko voi olla Web ervice-kanavaa enintään 30 MB. Tetitiliote ja en nouto-ohjeet päivitetään tähän palvelukuvaukeen ykyllä 2011.
OY SAMLINK AB PALVELUKUVAUS 5 (17) 3 Tilioteaineiton rakenne XML-muotoien anoman tiedot: Group header Sanoman tieto XML Tag Toi Siältöeimerkki GroupHeader <GrpHdr> 1..1 MeageIdentification <GrpHdr> 1..1 20111213FI184055101 <MgId> 0234569 CreationDateTime <GrpHdr> 1..1 2011-12- <CreDtTm> 12T23:05:15+02.00 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> 1..1 123 Tiliotteen numero. Päivä- ja kauitiliotteilla on erillinen numerointi. 1..1 2011-12- Tiliotteen luontiajankoh- CreationDateTime <Stmt> <CreDtTm> 12T23:05:15+02.00 ta FromDateTime <Stmt> 1..1 Tiliotekauden enimmäinen <FrToDt><FrDt päivä Tm> ToDateTime <Stmt> 1..1 Tiliotekauden viimeinen <FrToDt> päivä <ToDtT> Account <Stmt><Acct> 1..1 Identification <Stmt><Acct> 1..1 FI1840551010234569 Tilinumero <Id><IBAN> Type <Stmt><Acct> 1..1 Vakio CACC = Current <Tp><Cd> Currency <Stmt><Acct> 1..1 Tilin valuuttakoodi
OY SAMLINK AB PALVELUKUVAUS 6 (17) 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 Related Account Additional Statement Information <Own><Nm> <Stmt><Acct> <Svcr> <FinIntnId> <BIC> <Stmt> <RltdAcct><Id> <IBAN> <Stmt> <AddtlStmtInf> 1..1 HELSFIHH (Aktia, Säätöpankit ja POP Pankit) HANDFIHH (Handelbanken) ITELFIHH (Itella Pankki) Raportoivan pankin BIC 0..1 Jo tiliotetili (Account) on konernitilin alatili, kerrotaan tää konernin päätilin tilinumero. 0..1 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 EUR2000.00 Tilin valuutta ja aldo 1..1 CRDT = aldo on plumerkkinen DBIT = aldo on mii-
OY SAMLINK AB PALVELUKUVAUS 7 (17) Sanoman tieto XML Tag Toi Date <Stmt><Bal> <Dt><Dt> Siältöeimerkki Arvo, Selite, Käittely numerkkinen 1..1 2011-06-13 Saldon päivämäärä Tranaction Summary Sanoman tieto XML Tag Toi Siältöeimerkki Arvo, Selite, Käittely TranactionSummary <TxSummry> 1..1 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 EUR200.00 Tapahtuman valuutta ja rahamäärä. CreditDebitIndicator <CdtDbtInd> 1..1 DBIT = otto CRDT = pano Statu <St> 1..1 BOOK = tapahtuma kirjattu tilille Booking Date <BookgDt> 1..1 2011-06-13 Kirjaupäivä
OY SAMLINK AB PALVELUKUVAUS 8 (17) Sanoman tieto XML Tag Toi Siältöeimerkki Arvo, Selite, Käittely <Dt> ValueDate 1..1 2011-06-13 Arvopäivä <ValDt> <Dt> AccountServicer 0..1 Tapahtuman arkitointitunnu 1..1 PMNT = Payment (makut) LDAS= Loan and depoit (lainanlyhennyket tai noto) CAMT= Cah Management (Sweeping, topping etc.) NTAV = not available Reference BankTranaction- Code/ Domain FamilyCode <AcctSvcrRef> <BkTxCd> <Domn> <Cd> <BkTxCd> <Domn> <Family> <Cd> 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-
OY SAMLINK AB PALVELUKUVAUS 9 (17) 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 1..n 0..1 Tapahtuman arkitointitunnu. IntructionIdentification <BkTxCd> <Prtry><Cd> <BkTxCd> <Prtry> <Ir> <Btch> <MgId> <Btch> <PmtInfId> <Btch> <NbOfTx> <Tx Dtl><Ref> <AcctSvcrRef> <Ref><IntrId> 0..1 701Toituvaiuoritu Kirjauelitekoodi + kirjauelitekoodin elväkielinen nimi 0..1 Vakio FFFS 0..1 Makajan antama makuanoman ykilöintitieto, jo annettu. Muuten tyhjää. 0..1 Makajan antama erän ykilöintitieto, jo annettu. Muuten tyhjää. 0..1 Koontitapahtumaan liittyvien tapahtumien määrä. 0..1 Makajan antama tieto itelleen
OY SAMLINK AB PALVELUKUVAUS 10 (17) 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 0..1 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 SEK1000.00 Valuuttamääräien makun valuuttakoodi(iso) ja määrä 0..1 EUR100.00 Makun rahamäärän valuuttakoodi ja määrä (tilin valuutaa) 0..1 Makun alkuperäinen valuutta 0..1 Tilin valuutta
OY SAMLINK AB PALVELUKUVAUS 11 (17) 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 Valuutan vaihdoa käytetty valuutta. 0..1 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). 0..1 Makajan nimi. Käytetään hyvitytapahtumalla 0..1 Makajan ooite. Käytetään hyvitytapahtumalla
OY SAMLINK AB PALVELUKUVAUS 12 (17) Sanoman tieto XML Tag Toi Organization Identification TAI <AdrLine> <RltPtie> <Dbtr><Id> <OrgId> <Othr><Id> Siältöeimerkki Arvo, Selite, Käittely 0..1 Makajan tunnite. Private Identification Ultimate Debtor UltimateDebtor Organization Identification TAI Private Identification Creditor <RltPtie> <Dbtr><Id> <PrvId> <Othr><Id> <RltdPtie> <UltmtDbtr> <Nm> <RltPtie> <UltmDbtr> <Id> <OrgId> <Othr><Id> <RltPtie> <UltmDbtr> <Id><PrvId> <Othr><Id> Makajan tunnite. 0..1 Alkuperäien makajan nimi 0..1 Alkuperäien makajan tunnite Alkuperäien makajan tunnite.
OY SAMLINK AB PALVELUKUVAUS 13 (17) Sanoman tieto XML Tag Toi Siältöeimerkki Arvo, Selite, Käittely Name 0..1 Saajan nimi <RltdPtie> <Cdtr><Nm> Addre <RltdPtie> <Cdtr> <PtlAdr> <Adrline> 0..1 Saajan ooite Organization Identification <RltPtie> <Cdtr><Id> <OrgId> <Othr><Id> 0..1 Saajan tunnite TAI Private Identification Creditor Account /IBAN TAI Creditor Account /other <RltPtie> <Cdtr><Id> <PrvId><Othr> <Id> <RltdPtie> <CdtrAcct> <Id><IBAN> <RltdPtie> <CdtrAcct> Saajan tunnite 0..1 Saajan tili IBAN Saajan tili, jo muu kuin IBAN
OY SAMLINK AB PALVELUKUVAUS 14 (17) Sanoman tieto XML Tag Toi <Id><Othr> Scheme Name Type/proprietary Ultimate Creditor Name Organization Identification TAI Private Identification Related Agent <Id> <RltdPtie> <CdrtAcct> <Id><Othr> <SchmeNm> <Cd> <RltdPtie> <CdtrAcct> <Tp><Prtry> <RltdPtie> <UltmtCdtr> <Nm> <RltPtie> <UltmCdrt> <Id> <OrgId> <Othr><Id> <RltPtie> <UltmCdtr> <Id> <PrvId> <Othr><Id> 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. 0..1 Lopullien aajan tunnite Lopullien aajan tunnite.
OY SAMLINK AB PALVELUKUVAUS 15 (17) Sanoman tieto XML Tag Toi Siältöeimerkki Arvo, Selite, Käittely CreditorAgent <RltdAgt> <CdtrAgt> <FinIntnId> <BIC> 0..1 Saajan pankin BIC Purpoe/Code TAI Purpoe/Proprietary AcceptanceDate <Purp><Cd> <Purp><Prtry> <RltdDt> <AccptncDtTm > 0..1 Makun aihe Jo tapahtuma on toituvaiuoritu ja hyvity, eikä edellieen kenttään löytynyt koodia, on tää kentää makunaihe elväkielienä. 0..1 Makupäivä Muoto: vvvv-kk-pp + vakio T + hh:mm: + vakio +02:00 Liäki makuun voi liittyä euraavanlaiia tietoja: Remittance Information Sanoman tieto XML Tag Toi Makulla vapaamuotoinen vieti: 0..1 Remittance Information/ Untructured <Utrd> Siältöeimerkki Arvo, Selite, Käittely Vapaa vieti
OY SAMLINK AB PALVELUKUVAUS 16 (17) 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 2011-05-31 Lakun päiväy
OY SAMLINK AB PALVELUKUVAUS 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 EUR200.00 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