XML-TILIOTE Palvelukuvaus

Transkriptio

1 XML-TILIOTE Palvelukuvau Lokakuu 2011

2 OY SAMLINK AB PALVELUKUVAUS 2 (17) Siällyluettelo Siällyluettelo 1 Yleitä XML-tiliote Tilioteaineiton rakenne... 5

3 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 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 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:

4 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.

5 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> FI <MgId> CreationDateTime <GrpHdr> <CreDtTm> 12T23: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 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 FI Tilinumero <Id><IBAN> Type <Stmt><Acct> 1..1 Vakio CACC = Current <Tp><Cd> Currency <Stmt><Acct> 1..1 Tilin valuuttakoodi

6 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 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-

7 OY SAMLINK AB PALVELUKUVAUS 7 (17) 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 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 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ä

8 OY SAMLINK AB PALVELUKUVAUS 8 (17) Sanoman tieto XML Tag Toi Siältöeimerkki Arvo, Selite, Käittely <Dt> ValueDate 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-

9 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> 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ä Makajan antama tieto itelleen

10 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 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

11 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 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

12 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 Alkuperäien makajan nimi 0..1 Alkuperäien makajan tunnite Alkuperäien makajan tunnite.

13 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

14 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 Lopullien aajan tunnite Lopullien aajan tunnite.

15 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ä 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

16 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 Lakun päiväy

17 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 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