Finansilu Datu Apmaias Vienotais Standarts (FiDAViSta) Specifikcija

Transcription

1 Finansilu Datu Apmaias Vienotais Standarts (FiDAViSta) Specifikcija Versija 1.01 Apstiprints 2004.gada 22.aprl Latvijas Komercbanku asocicijas FiDAViSta komiteja

2 Saturs SATURS...2 IEVADS...3 STANDARTA IZMAIU VSTURE...4 FIDAVISTA FORMTA APRAKSTS...6 GALVENE (HEADER)...7 KONTA IZRAKSTS/PRSKATS (STATEMENT)...8 MAKSJUMU STATUSS (PMTSTAT)...11 MAKSJUMI (PAYMENT)...12 LAUKU TIPI

3 Ievads Finansilu Datu Apmaias Vienot Standarta (FiDAViSta) specifikcija sniedz detaliztu standarta aprakstu un atspoguo standarta izmaiu vsturi. Izmantošana FiDAViSta datu apmaias standarts ir balstts uz paplašinmo datu formšanas valodu - XML un tas ir publiski pieejams, t.i. FiDAViSta standartu iespjams izmantot bez ierobežojumiem un par ko netiek iekastas nekdas komisijas maksas. Dot specifikcija defin informcijas faila sagatavošanas formtu. Dot specifikcija neietver specifisku produktu vai pakalpojumu ieviešanas aprakstu vai šo produktu lietošanas krtbu. Ziojumu veidi Plašs finansilo aktivitšu/iespju spektrs FiDAViSta 1.01 ietver sekojošus ziojumus: Bankas konta izraksts; Bankas maksjums; Ieguvumi lietotjiem Bankas maksjuma statusa atskaite; Tieš Debeta lgumu, maksjumu un maksjuma atbilžu faili. (konceptuli) Lietojot vienoto datu apmaias standartu FiDAViSta, var tikt gti sekojoši labumi: Msdiengs formts (XML), kas nodrošina viennozmgu informcijas interpretciju un informcijas veselumu; Viennozmga nacionlo simbolu (valodai specifisko burtu) kodšana; Izmaksu ekonomija lietojot un uzturot tikai vienu formtu; Izmaiu gadjum, izmaias jizdara tikai vienu reizi, nevis katram partnerim atseviši; Iespja individualizt formtu savm vajadzbm; Citi. 3

4 Standarta izmaiu vsture Autors Datums Izmaia LKA 01/01/03 Satndarts tika izstrdts un pc sekmgas implementcijas vartu tikt apstiprints. Ingus Putns 09/09/03 <CpartySet> nomaints no Mandatory uz Optional jo virknei transakciju tipu (piemram komisijas maksa, procentu pieskaitjums etc) pretjs puses klients un konts neeksist. Ingus Putns 11/09/03 <PmtInfo> lauka garums nomaints no 140 uz 200 jo linebrake tiek aizvietoti ar tuksumu un lauka gal tiek pievienots bankas sistmas Transakcijas ID. Mrtiš Štmers 23/09/2003 FiDAViSta pielgots Parex (DIGI::FIRMA) specifikcijai: Mrtiš Štmers 14/10/2003 Sekcija <Header>: <Header> nomaints no M uz O <Timestamp> nomaints no 17 M uz 17 O <From> nomaints 70 M uz 70 O <Prod>, <Vers>, <To>, <UserId> izmesti. Sekcija <Payment>: <DocNo> nomaints no 25 O uz 16 M <RegDate> nomaints no 10 M uz 10 O <TaxPmtFlg> nomaints no 1 O uz 1 M; pielikts default=n <PayLegalId> nomainti atautie simboli uz [0-9]; garums uz 11 <BenCountry> nomaints no 2 O uz 2 M <BBName> nomaints 140 O uz 35 O <BBCode> nomaints no 34 O uz 66 O <CBName> nomaints 140 O uz 35 O <CBCode> nomaints no 34 O uz 66 O Sekcij <Payment>: pievienots lauks <BenAccIbanFlg> <Amt> nomaints no 15 M uz 12 M 4

5 Sekcij <Statement>: <AccNo> nomaints no 34 M uz 34 O pievienots lauks <IBAN> Mrtiš Štmers 29/10/2003 Sekcij <Statement> nomainti lauku tipi no <EksString> un <SwiftString> uz xs:string Mrtiš Štmers 31/10/2003 LKA sanksm 30/10/2003 standarts tika apstiprints ar sekojošiem nosacjumiem: - sekcij <Payment> laukam <DocNo> garums maints no 16 uz 10 - sekcij <Payment> laukam <PayLegalId> garums maints no 11 uz 13, maints pattern no ([0-9])* uz SwiftString - sekcij <Payment> pievienots lauks <BBAddress> Ingus Putns 03/11/2003 Maksjuma tags <BenLegID> prsaukts par <BenLegalID>. Shm t jau ir. Ingus Putns 21/11/2003 Maksjuma tags <PaySubaccNo> prsaukts par < PaySubAccNo >. Shm t jau ir. Ivars Ruis 12/03/2004 Saska ar FiDAViSta komitejas sanksmes lmumu, aprakst tiek veiktas sekojošas izmaias: - sekcij <Payment>, apakšsekcij <BenSet> lauks <Comm> tiek prdvts par <COMM>; - pievienots kopas lauka <FIDAVISTA> apraksts; - precizts apraksts lauka tipam <EksString>. FiDAViSta komiteja; Ivars Ruis; Ingus Putns 22/04/2004 Saska ar FiDAViSta komitejas sanksmes lmumu, tiek ieviesta jauna XML shma ar versijas numuru 0101 un veiktas attiecgs izmaias aprakst. Izmaias shm ir sekojošas: Visiem elementu tipu nosaukumiem ir pievienots vrds "Type". Saska ar aprakstu pievienota <PmtStat> elementu grupa. Nodefints <Extension> lauka tips. Elementi tiek aprakstti uzreiz pie elementa definšanas un vairs netiek izmantoti vairki elementu tipi: <Statement>, <Payment>, <HeaderType>, <CcyStmt>, <Transaction>, <Priority>, <PmtBenType>, <Timestamp>, <Comm>, <Country>. Daži elementu tipi ir mainti no <Datums> un xs:date; no <Account> uz <AccountOType>, <AccountMType>; no <AccountHolderSet> uz <AccountHolderType>. Elements <COMM> nomaints uz <Comm>. Elementa <BenExiID> garums maints no 3 uz 5 ciparu garu lauku. Pievienots "Root" elements <FIDAVISTA> ar "NameSpace", kur ir iekauta ar shmas versija. 5

6 FiDAViSta formta apraksts Lietoto lauku grupas FiDAViSta formt sagatavots fails var sastvt no vairkm dam, kuras ir apvienotas zem vienas kopas (Root) elementa ar lauka nosaukumu <FIDAVISTA>. Šaj Root element tiek dota ar norde uz XML shmas atrašans vietu, kur nordtais fails beidzas ar 4 ciparu versijas krtas numuru. Lauku kop iespjams grupas ir: Header - galvenes lauku grupa, kura satur informciju par faila sagatavotju un faila izveidošanas laiku. Statement - konta izraksta lauku grupa, kura tiek izmantota banku konta izrakstu vai konta prskatu informcijas datu saglabšanai. PmtStat - maksjumu statusa kopa, kura glab informciju par maksjumu statusiem, balstoties uz iepriekš nordtiem identifikatoriem. Payment - maksjuma lauku grupa, kur glabjas informcija par maksjumiem (vietjie, budžeta, starptautiskie, algu maksjumi, u.c.). Piemrs: <?xml version="1.0" encoding="utf-8"?> <FIDAVISTA xmlns= > <Header> </Header> <Payment> <Timestamp> </Timestamp> <From>SIA MIA</From> <ExtId> </ExtId> <DocNo>231</DocNo> <RegDate> </RegDate> <TaxPmtFlg>N</TaxPmtFlg> <Ccy>LVL</Ccy> <PmtInfo>Par preci, saska ar rinu.</pmtinfo> <PayLegalId> </PayLegalId> <PayAccNo> </PayAccNo> <DebitCcy>LVL</DebitCcy> <BenSet> </BenSet> </Payment> </FIDAVISTA> <BenExtId>321</BenExtId> <Priority>N</Priority> <Comm>OUR</Comm> <Amt>1.45</Amt> <BenAccNo> </BenAccNo> <BenName>EGLE SIA</BenName> <BenLegalId> </BenLegalId> <BenAddress>Ziepniekkalns, Gudr iela 33</BenAddress> <BenCountry>LV</BenCountry> <BBName>Hansabanka</BBName> <BBSwift>HABALV22</BBSwift> <AmkSet> </AmkSet> <Opc>010</Opc>

7 Galvene Tag Garums Tips O/M Apraksts <Header> Min Max <Timestamp> xs:string O Faila sagatavošanas laiks, formt YYYYMMDDHHMMSSsss <From> 0 70 xs:string O Sagatavotja identifikators </Header> 7

8 Konta izraksts/prskats Tag <Statement> Min Garums Max Tips O / M Apraksts <Period> M Izraksta perioda dati <StartDate> xs:date M Izraksta perioda skuma datums. Formts YYYY- MM-DD <EndDate> xs:date M Izraksta perioda beigu datums. Formts YYYY- MM-DD <PrepDate> xs:date M Datums, kur izraksts ir sagatavots. Formts YYYY-MM-DD </Period> <BankSet> AccHolderType O Dati par banku, kas sagatavoja izrakstu <Name> xs:string O Izraksta sagatavotjbankas nosaukums <LegalId> 0 20 LegalIDType O Bankas reistrcijas numurs <Address> 0 70 xs:string O Bankas adrese </BankSet> <ClientSet> AccHolderType O Dati par klientu (kontu pašnieku) <Name> xs:string O Klienta vrds un uzvrds vai nosaukums. <LegalId> 0 20 LegalIDType O Klienta reistrcijas Nr vai personas kods <Address> 0 70 xs:string O Klienta adrese </ClientSet> <AccountSet> <IBAN> 0 34 AccountOType O Konta IBAN numurs, par kuru tiek dots izraksts (Šis lauks tiks likvidts 2005.gada laik). <AccNo> 1 34 AccountMType M Konta numurs, par kuru tiek dots izraksts (Ldz 2005.gada beigm tiek dots vecais (pirms IBAN) konta numurs, ja tda nav, tad IBAN. Pc 2005.gada.1.janvra dodam tikai un viengi IBAN). <SubAccNo> 0 34 AccountOType O Subkonta numurs, par kuru tiek dots izraksts. Ja kontam piemt subkonti, šis lauks ir obligts (tiek veidots izraksts tikai par subkontiem, bet ne par visu kontu kop) <AccType> 0 70 xs:string O Konta veida nosaukums <AccHolder> AccHolderType O Dati par konta pašnieku. Normliem klientiem š kopuma saturs sakrt ar <ClientSet>. M Bet ir daži klienti, kur nosaukums un reistrcijas numurs tiek defints katram kontam vai subkontam (katrs konts vai subkonts var darboties k atseviša juridiska vienba). <Name> xs:string O Klienta vrds un uzvrds vai nosaukums. <LegalId> 0 20 LegalIDType O Klienta reistrcijas Nr vai personas kods <Address> 0 70 xs:string O Klienta adrese </AccHolder> <CcyStmt> M Izraksta dati izvlt konta noteiktai valtai <Ccy> 3 3 CurrencyType M Valta par kuru tiek dots konta izraksts <OpenBal> 1 12 AmountType M Skuma atlikums <CloseBal> 1 12 AmountType O Beigu atlikums 8

9 Ja aizpildts, tas nozm ka perioda beigu diena ir noslgta. Ja neaizpildts beigu diena vl nav slgta. Obligts, ja perioda beigu diena ir slgta. Diena slgta nozm: sistmai, kas eksport failu ir pieejami dati par dienas slgšanas faktu <TrxSet> O Transakcijas konta vai subkonta valt. Obligts, ja dotaj period ir transakcijas. Ja nav transakcijas, š sekcija nepards. <TypeCode> 0 4 xs:string O Opercijas tipa/ darjuma veida kods: OUTP- izejošais klienta maksjums INP ienkošais klienta maksjums INTR maksjums viena klienta kontu ietvaros (tikai iekšbankas) MEMD memorilais orderis, bankas maksjums debitjot kontu MEMC memorilais orderis, bankas maksjums kreditjot kontu CHIN skaidras naudas iemaksa CHOU skaidras naudas izmaksa OTHR prjie darjumi <TypeName> 0 70 xs:string O Opercijas tipa/darjuma veida nosaukums <RegDate> xs:date O Maksjuma uzdevuma reistršanas datums - tas pats kas uzdots fail Payment. Formts YYYY-MM-DD <BookDate> xs:date M Transakcijas grmatojuma datums bankas uzskaites sistm. Formts YYYY-MM-DD <ValueDate> xs:date O Valutcijas datums bankas uzskaites sistm. Vlams aizpildt, ja tas atširas no <BookDate>. Formts YYYY-MM-DD <ExtId> 0 10 xs:string O Ja maksjuma uzdevums ticis importts bankas sistm no uzmuma grmatvedbas sistmas, šis lauks satur grmatvedbas sistmas pieširto identifikatoru <BenExtId> 0 5 xs:string O Grmatvedbas sistmas pieširtais identifikators Mass payment gadjumam <BankRef> 1 25 xs:string M Bankas reference/ opercijas numurs <DocNo> 0 25 xs:string O Dokumenta (maksjuma) numurs. To ierakstjis lietotjs vai nu grmatvedbas sistm (ja tas eksportts/importts) vai bankas attlintaj konta vadbas sistm. <CorD> 1 1 xs:string C / D M C vai D kredta vai debeta opercija kont <AccAmt> 1 12 AmountType M Darjuma summa konta valt summa kuras apmr, transakcijas rezultt, ir maints konta atlikums. Ja komisija iekauta šaj paš grmatojum, š summa ietver ar komisiju. Decimldaa atdalta ar punktu. <FeeAmt> 1 12 AmountType O Ja opercijai piemt komisija, kas tiek grmatota k viena transakcija, šeit ierakstts ir komisijas apjoms konta valt. <PmtInfo> xs:string M Maksjuma detaas/darjuma mris <CPartySet> <AccNo> 0 34 AccountOType O Maksjum iesaistts pretjs puses konta numurs <SubAccNo> 0 34 AccountOType O Maksjum iesaistts pretjs puses subkonta numurs <AccHolder> AccHolderType O Pretjs darjuma puses konta pašnieka dati <Name> xs:string O Maksjum iesaistts pretjs puses nosaukums <LegalId> 0 20 LegalIDType O Maksjum iesaistts pretjs puses reistrcijas O 9

10 numurs <Address> 0 70 xs:string O Maksjum iesaistts pretjs puses adrese </AccHolder> <BankCode> 0 20 xs:string O Maksjum iesaistts pretjs puses bankas kods <BankName> xs:string O Maksjum iesaistts pretjs puses bankas nosaukums <Ccy> 3 3 CurrencyType O Darjuma pretjs puses valta <Amt> 1 12 AmountType O Darjuma pretjs puses summa. Decimldaa atdalta ar punktu. <CurRate> 1 9 xs:decimal O Valtas kurss pc kura maksjuma summa ir konvertta. <Giro> 0 5 xs:string O Samja vai makstja žiro numurs </CPartySet> </TrxSet> </CcyStmt> </AccountSet> </Statement> 10

11 Maksjumu statuss Tag <PmtStat> Min Garums Max Tips O / M Apraksts <ExtId> 0 10 SwiftStringType O Atsauce uz maksjuma identifikatoru (maksjum nordto maksjuma identifikatoru). <BenExtId> 0 5 SwiftStringType O Atsauce uz maksjuma identifikatoru (maksjum nordto maksjuma identifikatoru). <BankRef> 0 25 xs:string O Bankas reference <DocNo> 1 10 xs:string M Maksjuma/dokumenta numurs <StatCode> 1 1 xs:string M Maksjuma statusa kods: E Izpildts jeb iegrmatots; R Atcelts; P - Apstrd; O Cits statuss. <InfoToCustomer> 0 70 xs:string O Maksjuma statusa skaidrojums/kdas paziojums <BookDate> xs:date O Maksjuma izpildšanas datums (tikai izpildtajiem maksjumiem). Formts YYYY-MM-DD <RegDate> xs:date O Maksjuma uzdevuma reistršanas datums - tas pats kas uzdots fail Payment. Formts YYYY-MM-DD </PmtStat> 11

12 Maksjumi Tag <Payment> Min Garums Max Tips O / M Apraksts <ExtId> 0 10 SwiftStringType O Maksjuma unikls identifikators rj (grmatvedbas) sistm. Pc š identifikatora tiek veikti PmtStat pieprasjumi. Un pc š identifikatora Statement fail vars atrast grmatojuma sasaisti ar eksportto maksjuma uzdevumu <DocNo> 1 10 SwiftStringType M Maksjuma/dokumenta numurs. To piešir lietotjs grmatvedbas sistm. <RegDate> xs:date O Maksjuma uzdevuma reistrcijas datums grmatvedbas sistm. Formts YYYY-MM-DD. Eksportjot PmtStat par periodu no bankas sistmas, atlase tiek veikta pc š lauka. <TaxPmtFlg> 1 1 xs:string Default: N M Pazme par to vai maksjums ir vai nav nodoku maksjums. Iespjams vrtbas: Y - Nodoku maksjums N - parastais maksjums <Ccy> 3 3 CurrencyType M Maksjuma valta <PmtInfo> EksStringType O Maksjuma detaas. (Informcija samjam) <BankInfo> xs:string O Informcija bankai <PayLegalId> 0 20 LegalIDType O Makstja reistrcijas numurs vai personas kods vai nodoku makstja kods. Nodoku maksjuma gadjum š lauka saturs, ja aizpildts, tiks stts k nodoku makstja kods. <PayAccNo> 1 34 AccountMType M Makstja konta numurs <PaySubAccNo> 0 34 AccountOType O Makstja subkonta numurs <DebitCcy> 3 3 CurrencyType O Debitjam valta. <BenSet> Ja šis lauks nav aizpildts, banka uzskata ka š lauka saturs pc noklusšanas ir: Vienvaltas konta gadjum konta valta. Multivaltas konta gadjum maksjuma valta. Ja multivaltas konta gadjum nav atvrta pozcija maksjuma valt, <DebitCcy> tiek interpretts pc bankas ieskatiem Lai izvairtos no prpratumiem, vlams šo lauku aizpildt. M Maksjuma samja dati <BenExtId> 0 5 SwiftStringType O Samja unikls identifikators maksjuma uzdevuma robežs. Ieteicams aizpildt Mass payment gadjum. <Priority> 1 1 xs:string N / U / X Default = N <Comm> 3 3 xs:string OUR / BEN / SHA Default = OUR Pc š lauka grmatvedbas sistma vars identifict maksjumu citos failos ( Payment status, Statement ). M Maksjuma prioritte: N Normal, U Urgent, X Expres Vrtba pc noklusšanas: N Vietjiem maksjumiem Latvijas latos tiek izmantotas N un U izvles M Komisijas tips: OUR makstjs, BEN - Samjs, SHA - dalt. 12

13 Tag Min Garums Max Tips O / M Apraksts Vrtba pc noklusšanas: OUR <Amt> 1 12 AmountType M Maksjuma summa. Decimldaa atdalta ar punktu. <BenAccNo> 0 34 AccountOType O Samja konta numurs <BenSubAccNo> 0 34 AccountOType O Samja subkonts <BenAccIbanFlg> 0 1 xs:string Y / N Default = N O Samja konta IBAN pazme <BenName> EksStringType M Samja nosaukums Y bankas programmai jveic konta numura kontrolsummas prbaude atbilstoši starptautiskajam IBAN standartam Ja š lauka vrtba ir Y, lauka <BenSubAccNo> saturs tiek ignorts <BenLegalId> 0 20 LegalIDType O Samja reistrcijas numurs vai nodoku makstja kods vai personas kods <BenAddress> 0 70 EksStringType O Samja adrese <BenCountry> 2 2 CountryType M Valsts kods, kur reistrts samjs. Piemram: LV, EE, US, u.tml. ISO-3166 <BBName> 0 35 EksStringType O Samja bankas nosaukums <BBAddress> 0 70 EksStringType O Samja bankas adrese <BBSwift> 8 11 SWIFTType O Samja bankas SWIFT kods vai Latvijas Bankas BIC kods <BBCode> 0 66 BankCodeType O Samja bankas kods. Šim laukam piemt obligti aizpildms atribts CodeType koda tips. <CBAcc> 0 34 AccountOType O Samjbankas korkonts starpniekbank <CBName> 0 35 EksStringType O Starpniekbankas nosaukums <CBSwift> 8 11 SWIFTType O Starpniekbankas SWIFT kods <CBCode> 0 66 BankCodeType O Starpniekbankas kods. Šim laukam piemt obligti aizpildms atribts CodeType koda tips <BudgCode> 0 10 SwiftStringType O Budžeta iemumu kods <AmkSet> O rjais maksjuma kods <Opc> 1 3 xs:string M AMK (bilances) kods; tikai cipari [0-9] <Amt> 1 12 AmountType O AMK (bilances) koda summa. Decimldaa atdalta ar punktu. </AmkSet> </BenSet> </Payment> 13

14 Lauku tipi Tips Garums Atautie simboli Apraksts Min Max xs:string 0 XML standarta tips unicode tekstam xs:date XML standarta tips datumam Formts: YYYY-MM-DD BankCodeType 0-9 A-Z a-z \s/\-\?:().,'\+\n\r Atvasints no SwiftString. Pievienots atribts CodeType, kura tips ir SwiftString. Atribts ir obligts ExtensionType 0 Paredzts jebkuru, standart neiekautu, elementu izvietošanai AccountMType A-Z a-z \s/\-\?:().,'\+\n\r Atvasints no SwiftString. Uzlikts ierobežojums garumam AccountOType A-Z a-z \s/\-\?:().,'\+\n\r Atvasints no SwiftString. Uzlikts ierobežojums garumam AmountType Atvasints no xs:decimal. Uzlikts ierobežojums 12 zmes kop, no kurm 2 aiz deciml atdaltja punkta. CurrencyType 3 3 A-Z Atvasints no xs:string EksStringType 0-9 A-Z a-z -ž -Ž \s/\-\?:().,'\+\n\r Atvasints no xs:string. Ierobežoti atautie simboli atbilstoši Latvijas Bankas Elektronisk Klringa Sistmas ierobežojumiem (xl simbolu kopai) un latviešu un latu alfabta mazie burti. LegalIDType A-Z a-z \s/\-\?:().,'\+\n\r Atvasints no SwiftString. Uzlikts ierobežojums garumam SWIFTType 8 11 A-Z 0-9 Paredzts SWIFT kodam, atbilstoši SWIFT standartam SwiftStringType 0-9 A-Z a-z \s/\-\?:().,'\+\n\r Atvasints no xs:string. Ierobežoti atautie simboli atauti simboli, kas atbilst SWIFT X simbolu kopai, izemot { un } un latu alfabta mazie burti. 14