XML- KONTOUTDRAG Servicebeskrivn 10.07.2016
2 Iinnehållsföretckn 1 Allmänt... 3 2 XML-kontoutdrag... 3 3 Kontoutdragsmaterialets struktur..... 5
3 1 Allmänt Det här är servicebeskrivnen för kontoutdrag i xml-format. Materialet skapas av Aktia för kunden att avhämtas via överenskommen kanal. Aktias Xml-kontoutdrag motsvarar till innehåll och struktur FK:s ISO 200022 kontoutdragsguide, med några undantag. 2 XML-kontoutdrag XML-kontoutdrag kan hämtas via Web Service-kanalen, eller vi Nättjänst för företag (filöverförstjänster). Meddelandetypen för xml-kontoutdrag är Bank-to-Customer Statement -meddelande (camt.053.001.02 BankToCustomerStatementV02). I Bank-to-Customer Statement -meddelandet rapporterar banken kontohändelser, möjliga specifikationer, samt saldoer. Det här är bankens officiella kontoutdrag som är godkänts av Bokförsnämnden. Materialets struktur är beskrivet nedan:
4 Kontoutdragsmaterialets struktur beskriver innehållet för det xml-kontoutdrag som Aktia levererar. Förklararna till upparna i tabellen är följande: 1..1 en alltid till förfogande 0..1 en kan finnas eller fattas 0..n en kan finnas från noll till n:gånger 1..n en finns åtminstone en gång, men kan finns flera gånger Applikationsslag för Aktias xml-kontoutdrag är XT. Materialet består av ett kontoutdrag (en group header och ett statement). Anvisn hur xml-kontoutdragen hämtas via Web Service Hämtn med DownloadFileList-funktionen sker på samma sätt som för det övriga materialet. I ApplicationRequest-meddelandets File-Type-element är materialslaget XT. XML-kontoutdragen är UTF8-enkodade, som det övriga XML-materialet. I Web service kanalen kan materialet vara högst 30 MB.
5 3 Kontoutdragsmaterialets struktur Meddelande i XML-format: Group header r epni ng GroupHeader <GrpHdr> 1..1 MessageIdentifica- <GrpHdr> tion <MsgId> CreationDateTime <GrpHdr> <CreDtTm> 1..1 20111213FI184055101 0234569 1..1 2011-12- 12T23:05:15+02.00 Bankens identifierskod för meddelande Tidpunkt då filen skapats Statement Statement <Stmt> 1..n Statement Id <Stmt><Id> 1..1 Kontoutdrag ID Form: ååååmmdd + kontonummer + löpande nr/dag ElectronicSe- <Stmt> 0..1 Ej i bruk quencenumber LegalSequenceNumber <ElctrnSeqNb> <Stmt> <LglSeqNb> 1..1 123 Kontoutdragets nummer CreationDateTime <Stmt> <CreDtTm> 1..1 2011-12- 12T23:05:15+02.00 Tidpunkt då kontoutdrag skapats. FromDateTime <Stmt> <FrToDt><FrDt 1..1 Kontoutdragsperiodens första dagen. Tm> ToDateTime <Stmt> <FrToDt> 1..1 Kontoutdragsperiodens sista dagen. <ToDtT> Account <Stmt><Acct> 1..1 Identification <Stmt><Acct> 1..1 FI1840551010234569 Kontonummer <Id><IBAN> Type <Stmt><Acct> <Tp><Cd> 1..1 Konstant CACC = Current Currency <Stmt><Acct> 1..1 Kontos valutakod
6 Owner Name Servicer/FinancialInsti tutionidentification <Ccy> <Stmt><Acct> <Own><Nm> <Stmt><Acct> <Svcr> <FinInstnId> <BIC> 0..1 Kontoinnehavarens namn 1..1 HELSFIHH Rapporterande bankens BIC Related Account Additional Statement Information <Stmt> <RltdAcct><Id> <IBAN> <Stmt> <AddtlStmtInf> 0..1 0..1 Bankens meddelande Balances Balance <Stmt><Bal> 1..n Type /Code <Stmt><Bal> <Tp> <CdOrPrty> <Cd> 1..1 Saldotyper OPBD = Ingående balans CLBD = Utgående balans CLAV = Disponibelt Included Amount Amount CreditDebitIndicator <Stmt><Bal> <CdtLine> <Incl> <Stmt><Bal> <CdtLine> <Amt> <Stmt><Bal> <Amt> <Stmt><Bal> <CdtDbtInd> 1..1 Limit (FALSE / TRUE) 0..1 Limitbeloppet 1..1 EUR2000.00 Kontovaluta och saldo 1..1 CRDT = balansen är positiv DBIT = balansen är negativ
7 Date <Stmt><Bal> <Dt><Dt> 1..1 2011-06-13 Balansdagen Transaction Summary TransactionSummary TotalEntries TotalCreditEntries <TxsSummry> 1..1 <TtlNtries> <NbOfNtries> <TtlCdtNtries> <NbOfNtries> 1..1 Antalet transaktioner 1..1 Insättnar totalt TotalCreditEntries TotalDebitEntries TotalDebitEntries <TtlCdtNtries> <Sum> <TtlDbtNtries> <NbOfNtries> <TtlDbtNtries> <Sum> 1..1 Insättnsbeloppet totalt 1..1 Uttag totalt 1..1 Uttagsbeloppet totalt Statement Entry Statement Entry <Stmt> 0-n Amount <Amt> 1..1 EUR200.00 Transaktionens valuta och belopp. CreditDebitIndicator <CdtDbtInd> 1..1 DBIT = uttag CRDT = insättn Status <Sts> 1..1 BOOK = transaktion bokad i kontot Book Date <BookgDt> 1..1 2011-06-13 Boknsdag
8 ValueDate AccountServicer Reference BankTransaction- Code/ Domain FamilyCode SubFamilyCode <Dt> <ValDt> <Dt> <AcctSvcrRef> <BkTxCd> <Domn> <Cd> <BkTxCd> <Domn> <Family> <Cd> <BkTxCd> <Domn> <Family> <SubFmlyCd> 1..1 2011-06-13 Valutersdag 0..1 Transaktionens arkiverskod 1..1 PMNT = Payments (betalnar) LDAS= Loans and deposits (lån avbetaln eller -uttag) CAMT= Cash Management (Sweep, topp etc.) NTAV = not available 1..1 RCDT =Received Credit Transfers ICDT =Issued Credit Transfers MCRD = Merchant Card Transaction Butikägarens krediter IDDT = Issued Direct Debits RDDT = Received Direct Debits CCRD = Customer Card Transactions ICHQ = Issued Cheques MDOP = Miscellaneous Debit Operations MCOP = Miscellaneous Credit Operations ACCB = Account Balanc NTAV = Not available 1..1 ESCT = Sepa Credit Transfer SALA = Sepa Credit Transfer /Sala DMCT = Domestic Cre-
9 dit Transfer NTAV = Not available INTR = Interest OTHR = Other RIMB =Reimbursement PMDD = Direct Debit STDO = Stand Order CHRG = Charges XBCT = Cross Border Credit Transfer ZABA = Zero Balanc SWEP = Sweep TOPG = Topp Proprietary Code Issuer Message Identification Payment Information Identification NumberOf Transcactions Transaction Details AccountServicer Reference InstructionIdentification <BkTxCd> <Prtry><Cd> <BkTxCd> <Prtry> <Issr> <Btch> <MsgId> <Btch> <PmtInfId> <Btch> <NbOfTxs> <Tx Dtls><Refs> <AcctSvcrRef> <Refs><InstrId> 0..1 701Toistuvaissuoritus Förklarskod+ förklarskod i klartext. 0..1 Konstant FFFS 0..1 Betalarens ID för betalnsmeddelandet, om det finns. Annars tom. 0..1 Betalarens ID för posten, om det finns. Annars tom. 0..1 Avtalet transaktioner i gemensam transaktion. 1..n 0..1 Transaktionens arkiverskod. 0..1 Den information som ges av betalaren själv.
10 EndToEndIdentification ProprietaryType Proprietary Reference Instructed amount Transaction Amount SourceCurrency TargetCurrency <Refs> <EndToEndId> <Refs> <Prtry><Tp> <Refs> <Prtry><Ref> <AmtDtls> <lnstrdamt> <Amt> <AmtDtls> <TxAmt> <Amt> <AmtDtls> <TxAmt> <CcyXchg> <SrcCcy> <AmtDtls> <TxAmt> 0..1 Betalarens information till mottagare. 0..1 4057 XXXX XXXX 1234 Korttransaktionens kortnummer. I fallet med korrigerstransaktion ORIG 0..1 Handelns arkiversreferens för korttransaktion eller konstant CARD. Korrigerstransaktione ns ursprungliga arkiverskod. 0..1 SEK1000.00 Valutabetalns valutakod (ISO) och belopp 0..1 EUR100.00 Betalns valutakod och beloppet (i kontovaluta). 0..1 Betalns ursprungliga valuta 0..1 Kontovaluta
11 <CcyXchg> <TrgCcy> UnitCurrency <AmtDtls> <TxAmt> <CcyXchg> <UnitCcy> ExchangeRate <AmtDtls> <TxAmt> <CcyXchg> <XchgRate> Contract Identifica- tion <AmtDtls> <TxAmt> <CcyXchg> <CtrctId> Proprietary Amount <AmtDtls> <PrtryAmt> Debtor Name Address <Dbtr><Nm> <Dbtr> <PstlAdr> 0..1 Bankens valuta i valutaväxl. 0..1 Valutakurs 0..1 Kursreferens När valutabetaln är t.ex. USD till SEK, används den här strukturen. Struktur återkommer 2 gånger (USD- EUR och EUR- SEK kursinformation separat). 0..1 Betalarens namn. Används i en kredittransaktion. 0..1 Betalarens adress. Används i en kredittransaktion.
12 <AdrLine> Organization Iden- 0..1 Betalarens ID. tification <RltPties> <Dbtr><Id> <OrgId> ELLER <Othr><Id> Private Identification Ultimate Debtor UltimateDebtor <RltPties> <Dbtr><Id> <PrvId> <Othr><Id> <UltmtDbtr> <Nm> Betalarens ID. 0..1 Ursprungliga betalarens namn. Organization Iden- 0..1 Ursprungliga betalarens ID. tification <RltPties> <UltmDbtr> <Id> ELLER Private Identification Creditor <OrgId> <Othr><Id> <RltPties> <UltmDbtr> <Id><PrvId> <Othr><Id> Ursprungliga betalarens ID.
13 Name 0..1 Mottagarens namn <Cdtr><Nm> Address 0..1 Mottagarens amuudress <Cdtr> <PstlAdr> <Adrline> Organization Iden- 0..1 Mottagarens ID tification <RltPties> <Cdtr><Id> <OrgId> <Othr><Id> ELLER Private Identification <RltPties> <Cdtr><Id> <PrvId><Othr> <Id> Mottagarens ID Creditor Account 0..1 Mottagarens konto /IBAN IBAN <CdtrAcct> <Id><IBAN> ELLER Creditor Account Mottagarens konto, om /other andra än IBAN <CdtrAcct>
14 Scheme Name Type/proprietary Ultimate Creditor Name <Id><Othr> <Id> <CdrtAcct> <Id><Othr> <SchmeNm> <Cd> <CdtrAcct> <Tp><Prtry> <UltmtCdtr> <Nm> 0..1 Om mottagarens konto är andra än IBAN, här finns BBAN 0..1 Om banken har ändrats kontonummer, här finns ACWC 0..1 Slutliga mottagarens namn. Organization Iden- 0..1 Slutliga mottagarens ID. tification <RltPties> <UltmCdrt> <Id> ELLER Private Identification Related Agent <OrgId> <Othr><Id> <RltPties> <UltmCdtr> <Id> <PrvId> <Othr><Id> Slutliga mottagarens ID.
15 CreditorAgent <RltdAgts> <CdtrAgt> <FinInstnId> <BIC> 0..1 Mottagarens banks BIC. Purpose/Code 0..1 Betalns tillfällighet ELLER <Purp><Cd> Purpose/Proprietary I fallet med återkommande betaln och krediter, här finns betalns <Purp><Prtry> tillfällighet i klartext. AcceptanceDate 0..1 Betalnsdag Form: åååå-mm-dd + konstant T + <RltdDts> hh:mm:ss + <AccptncDtTm konstant +02:00 > Betaln kan också innehålla följande typer av informationer: Remittance Information Tois tuvuu s Maksulla vapaamuotoinen viesti: 0..1 Remittance Infor- Fri meddelande mation/ Unstruc- tured <Ustrd>
16 Referensbetaln: 0..1 Reference Type Code <CdtrRefInf> <Tp> <CdOrPrtry> <Cd> Issuer <CdtrRefInf> <Tp><Issr> Reference <CdtrRefInf> <Ref> SCOR = referens När referens är internationell, här finns konstant ISO. Referens Betaln innehåller differentierar Type/Code <RfrdDocInf> <Tp> <CdOrPrtry> <Cd> Number <RfrdDocInf> <Nb> RelatedDate 0..n Fakturaslag CREN = kreditfaktura CINV = faktura 123 Fakturanummer 2011-05-31 Fakturadatum
17 Amount Reference Type Code Issuer Reference Organization Id Additional Information <RfrdDocInf> <RltdDt> <RfrdDocAmt> <RmtdAmt> <CdtrRefInf> <Tp> <CdOrPrtry> <Cd> <CdtrRefInf> <Tp><Issr> <CdtrRefInf> <Ref> <Invcr> <Id><OrgId> <Othr><Id> <AddtlRmtInf> EUR200.00 Beloppet och valuta Om transaktion har referens, här finns konstant SCOR. När referens är internationell, här finns konstant ISO. Referens Kundnummer Fakturadifferentiersnu mmer