Positiivne register: funktsionaalne spetsifikatsioon: Difference between revisions

From services.krediidiinfo.ee
Jump to navigation Jump to search
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
{| align="right"
{| align="right"
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Data_exchange_system_X-road_interface|In English]]
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Positive register: functional specification|In English]]
|}
|}


= Tutvustus =  
= Sissejuhatus =
'''Positiivne Register''' on andmevahetussüsteem, mille kaudu registri liikmeks olevad krediteerijad saavad eraisiku nõusolekul vahetada infot tema laenukohustuste kohta. Positiivne Register võimaldab laenuandjal täita seadusest tulenevat vastutustundliku laenamise nõuet ning veenduda inimese võimes täita oma laenukohustust. Laenuklient ei pea enam tooma paberkandjal väljavõtteid teiste laenuandjate juurest ning on paremini kaitstud emotsionaalsete laenuotsuste ja ülelaenamisest tekkivate probleemide eest.


'''POSR''' on andmevahetussüsteem, mille kaudu registri liikmeks olevad krediteerijad saavad eraisiku nõusolekul vahetada infot tema laenukohustuste kohta.


Käesolev dokument kirjeldab süsteemi poolt pakutavaid teenusi X-tee vahendusel.
= Mõisted =


= Teenuste kasutamine toodangukeskkonnas =
* '''Andmed''' – andmed tarbija olemasolevate kohustuste kohta, mis võimaldavad Osalejal hinnata tarbija krediidivõimelisust;
POSR süsteemi teenuste kasutamine eeldab, et osaleja on liitunud X-teega, paigaldanud ja seadistanud x-tee tervaserverit ning saanud liigipääsuõigused teenustele Creditinfolt.
* '''Andmevahetussüsteem''' (''Data exchange system '') – infotehniline rakendus, mille vahendusel Osalejad vahetavad Andmeid;
* '''Andmevahetussüteemi haldaja''' (''Data exchange system manager'') – Creditinfo Eesti AS;
* '''Krediiditaotleja''' (''consumer'') - eraisik, kes on pöördunud Osaleja poole tarbijakrediidilepingu sõlmimise sooviga.
* '''Krediidisaaja''' (''consumer'') – eraisik, kellele Osaleja on väljastanud tarbijakrediidilepingu alusel krediidi.
* '''Tarbijakrediit''' (''consumer credit'') – Osaleja poolt Krediidisaajale väljastatud krediit;
* '''Krediidiotsus''' (''credit decision'') – Osaleja poolt langetatav otsus tarbijakrediidilepingu sõlmimiseks Kreediiditaotlejaga;
* '''Tarbijakrediidileping''' (''consumer credit contract'') – leping, mille alusel on Osaleja väljastanud Krediidisaajale krediidi;
* '''Kaastaotleja''' (''codebtor'') - isik, kellega Krediiditaotleja koos krediiti taotleb ja kelle sissetulekud ning varad võetakse Krediidiotsuse tegemisel arvesse;
* '''Käendaja''' (''guarantor'') - isik, kes võtab Osaleja ees kohustuse vastutada Krediidisaaja Tarbijakrediidi kohustuse täitmise eest;
* '''Tarbijakrediidilepingu subjekt''' (''subject'')- lepingu osapool;
* '''Osaleja''' (''member'') – Andmevahetussüsteemiga liitunud Eesti, kes jagab temale teadaolevaid Andmeid Krediiditaotleja kohta samaväärses koosseisus teiste Osalejatega;
* '''Krediiditaotleja nõusolek''' (''consent'') - Krediiditaotleja nõusolek päringu adressaatideks olevatele Osalejatele Krediiditaotleja Andmete edastamiseks päringu teinud Osalejale.


Päringu edastamiseks toodangukkonda tuleb koostamisel kasutada päringu päises parameetri xRoadInstance väärtust "EE" ning saata päringu toodang x-tee turvaserverisse.


= Teenuste kasutamine testkeskkonnas =
= Ärireeglid =
Andmevahetussüsteemi testimine toimub x-tee testkeskonna vahendusel. Eelnevalt tuleb test-x-tee testkeskkonnaga liituda, paigaldada ja seadistada test-x-tee turvaserverit ning küsida ligipääsuõigused teenustele Creditinfolt.
* ''Andmevahetussüsteemi'' kasutajad on ''Osalejad''.
* ''Osaleja'' peab olema liitunud X-teega.
* ''Osaleja'' sisestab ''Andmed'' ''Andmevahetussüsteemi haldaja ''andmebaasi või tekitab ''Andmevahetussüsteemi haldajale ''tehnoloogiline võimalus ''Andmeid'' pärida oma ''Andmekogust.''
* ''Osaleja'' uuendab ''Andmed'' edastades ''Andmevahetussüsteemi haldajale ''kas kõik kehtivad ''Andmed'' või ''Tarbijakrediidilepingu'' kaupa.
* ''Osaleja'' uuendab ''Andmed'' iga 24 tunni järel. Äärmisel juhul kuni 7 päeva järel.
* ''Osaleja'' pärib ''Krediiditaotleja'' kohta ''Andmeid'' tema ''Nõusoleku'' olemaolul. Kui ''Nõusolek'' ei ole digitaalselt allkirjastatud, siis pärijal ei ole õigust saada ''Andmeid'' teistelt ''Osalejatelt'', kes on seadnud päringule vastamise ja ''Andmete'' edastamise tingimuseks digitaalselt allkirjastatud ''Nõusoleku'' olemasolu.
* ''Nõusoleku'' dokument säilib ''Andmevahetussüsteemis'' 3 aastat.
* ''Admete'' päringu vastus ei kajasta andmeid ''Osaleja'' kohta.
* ''Andmete'' päringu vastus ei sisalda päringut teinud ''Osaleja Andmekogust'' ''Andmeid''.
* ''Andmete'' päringu vastuse koosseis kirjeldatud peatükis "Andmete koosseis".
* ''Osalejad'' jagavad ''Andmeid'' samaväärses koosseisus teiste ''Osalejatega.''


Päringu edastamiseks testkeskkonda tuleb koostamisel kasutada päringu päises parameetri xRoadInstance väärtust "ee-test" ning saata päringu test-x-tee turvaserverisse.


Testida võimalik wsdl-s kirjeldatud teenused milledele ligipääs antud ning [http://x-road.eu/docs/x-road_service_metadata_protocol.pdf x-tee metateenused] nagu "listMethods" ja "allowedMethods". Metateenustele ligipääsuõigusi ei anta.
== Andmete kooseis ==
#Uuendamise kuupäev ''(update date and time)''
#Isikukood ''(identity code)''
#Isiku roll ''(role)'' antud lepingu raames
#Lepingu number (''contract number'') - Osaleja ja Krediidisaaja vahel sõlmitud Tarbijakrediidilepingu number;
#Krediidi liik (''type of credit'')
#Krediidi algus (''effective date of credit agreement'') – Tarbijakrediidilepingu kehtivuse alguskuupäev
#Krediidi lõpp (end date of credit) – Kuupäev, millal Tarbijakrediit tuleb tagastada
#Krediidi summa (''credit sum'') - Krediidisaajale väljamakstud või väljamaksmisele kuuluv maksimaalne Tarbijakrediidi summa;
#Krediidi valuuta (''credit currency'') - Tarbijakrediidi valuuta;
#Maksegraafik (''schedule payments'') – Järgmise või lähima kolme väljamakse summa ja tähtaeg;
#Hetkesaldo (''balance'') - Tarbija kohustuse suurus Osaleja ees;
#Üle tähtaja saldo (''days over net balance'') – 7 päeva üle maksetähtaja hilinenud maksete summa.  
#Päringud ''(inquiries)'' – Krediidisaaja kohta Andmete saamiseks viimase kolme aasta jooksul tehtud päringute kuupäevad.


= WSDL =
'''Isiku rollid'''


POSR süsteemi WSDL asub aadressil http://services.krediidiinfo.ee/posr.wsdl.
# Krediidisaaja (''borrower'')
# Kaastaotleja (''codebtor'')
# Käendaja (''guarantor'')


= X-tee sõnum =
'''Krediidi liigid'''
X-tee päring on vastavalt teenuse kirjeldusele kas
* SOAP ümbrik 
* või on MIME multipart/related stiilis, mille esimeses osas on SOAP ümbrik.
Vastus on SOAP ümbrik.


SOAP ümbrik koosneb päisest ja kehast.
# Tagatisega laen (''secured loan'')
# Järelmaks (''hire-purchase'')
# Tagatiseta laen (''unsecured loan)''
# Liising (''lease'')
# Krediitkaart (''credit card'')
# Muu (''other'')


== SOAP ümbriku päis ==
SOAP ümbriku päises oleva info koosseis on määratud [http://x-road.eu/docs/x-road_message_protocol_v4.0.pdf X-tee spetsifikatsiooni] poolt.


== SOAP ümbriku keha ==
= Kasutuslood =
SOAP ümbriku kehas oleva info koosseis on määratud käesoleva dokumendi poolt.
[[File:Positive register use cases.jpg]]


== Päringu soap ümbriku näide ==
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:xrd="http://x-road.eu/xsd/xroad.xsd"
                  xmlns:id="http://x-road.eu/xsd/identifiers"
                  xmlns:posr="http://www.krediidiinfo.ee/services/posr"
                  xmlns:rep="http://www.krediidiinfo.ee/schemas/positive_register/credit/v1/report.xsd">
    <SOAP-ENV:Header>
        <xrd:client id:objectType="SUBSYSTEM">
            <id:xRoadInstance>EE</id:xRoadInstance>
            <id:memberClass>COM</id:memberClass>
            <id:memberCode>00000000</id:memberCode>
            <id:subsystemCode>TEST</id:subsystemCode>
        </xrd:client>
        <xrd:service id:objectType="SERVICE">
            <id:xRoadInstance>EE</id:xRoadInstance>
            <id:memberClass>COM</id:memberClass>
            <id:memberCode>10256137</id:memberCode>
            <id:subsystemCode>POSR</id:subsystemCode>
            <id:serviceCode>getCreditReport</id:serviceCode>
            <id:serviceVersion>v1</id:serviceVersion>
        </xrd:service>
        <xrd:id>test</xrd:id>
        <xrd:userId>EE00000000000</xrd:userId>
        <xrd:protocolVersion>4.0</xrd:protocolVersion>
    </SOAP-ENV:Header>
    <SOAP-ENV:Body>
        <posr:getCreditReport>
            <rep:subject>
                <rep:ident_code>00000000000</rep:ident_code>
            </rep:subject>
            <rep:signed_consent>TEST</rep:signed_consent>
            <rep:lang>et</rep:lang>
        </posr:getCreditReport>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</pre>


== Vastuse soap ümbriku näide ==


<pre>
== Members list request ==
<?xml version="1.0" encoding="UTF-8"?>
'''Eeldus''': Osalejal on õigused antud teenuse kasutamiseks Andmevahetussüsteemi haldaja poolt.
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                  xmlns:posr="http://www.krediidiinfo.ee/services/posr">
    <SOAP-ENV:Header>
        <xrd:client id:objectType="MEMBER" xmlns:xrd="http://x-road.eu/xsd/xroad.xsd" xmlns:id="http://x-road.eu/xsd/identifiers">
            <id:xRoadInstance>EE</id:xRoadInstance>
            <id:memberClass>COM</id:memberClass>
            <id:memberCode>00000000</id:memberCode>
            <id:subsystemCode>Test</id:subsystemCode>
        </xrd:client>
        <xrd:service id:objectType="SERVICE" xmlns:xrd="http://x-road.eu/xsd/xroad.xsd" xmlns:id="http://x-road.eu/xsd/identifiers">
            <id:xRoadInstance>EE</id:xRoadInstance>
            <id:memberClass>COM</id:memberClass>
            <id:memberCode>10256137</id:memberCode>
            <id:subsystemCode>POSR</id:subsystemCode>
            <id:serviceCode>getCreditReport</id:serviceCode>
            <id:serviceVersion>v1</id:serviceVersion>
        </xrd:service>
        <xrd:id xmlns:xrd="http://x-road.eu/xsd/xroad.xsd">test</xrd:id>
        <xrd:userId xmlns:xrd="http://x-road.eu/xsd/xroad.xsd">EE00000000000</xrd:userId>
        <xrd:issue xmlns:xrd="http://x-road.eu/xsd/xroad.xsd"/>
        <xrd:protocolVersion xmlns:xrd="http://x-road.eu/xsd/xroad.xsd">4.0</xrd:protocolVersion>
        <xrd:requestHash algorithmId="http://www.w3.org/2001/04/xmlenc#sha512">Test</xrd:requestHash>
    </SOAP-ENV:Header>
    <SOAP-ENV:Body>
        <posr:getCreditReportResponse>
            <credit_report xmlns:rep="http://www.krediidiinfo.ee/schemas/positive_register/credit/v1/report.xsd"
                          xmlns:cid="http://www.krediidiinfo.ee/schemas/positive_register/credit/v1/identifiers.xsd">
<rep:consumer_credits>
                    <rep:consumer_credit>
        <cid:type>
                            <cid:code>CC</cid:code>
                            <cid:name>Krediitkaart</cid:name>
                        </cid:type>
<cid:begin_date>2016-07-14</cid:begin_date>
<cid:end_date>2017-07-14</cid:end_date>
<cid:sum>200</cid:sum>
<cid:balance>200</cid:balance>
<cid:unpaid_sum>7</cid:unpaid_sum>
<cid:currency>EUR</cid:currency>
<cid:schedule_payments>
    <cid:schedule_payment>
        <cid:due_date>2016-10-22</cid:due_date>
<cid:sum>100.0</cid:sum>
    </cid:schedule_payment>
          </cid:schedule_payments>
                        <cid:subjects> 
    <cid:subject>
        <cid:ident_code>00000000000</cid:ident_code>
        <cid:role>
                                    <cid:code>BRW</cid:code>
                                    <cid:name>Krediidivõtja</cid:name>
                                </cid:role>
    </cid:subject>
                        </cid:subjects>
<cid:update_datetime>2017-01-01T03:00:00</cid:update_datetime>
    </rep:consumer_credit>
                </rep:consumer_credits>
<rep:inquiries>
                    <rep:inquiry>
                        <cid:datetime>2017-01-02T08:17:30</cid:datetime>
                    </rep:inquiry>
</rep:inquiries>
            </credit_report>
            <posr:fault xsi:nil="true"/>
        </posr:getCreditReportResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</pre>


= Teenused =
Osaleja pärib teiste Osalejate nimekirja et kasutada see nõusoleku dokumendi tekstis.


Teenuste kasutamiseks peavad Osalejal olema õigused antud Creditinfo Eesti AS poolt.
== Consent document creation / Nõusoleku dokumendi koostamine ==
'''Eeldus''': Osalejal on õigused antud teenuse kasutamiseks Andmevahetussüsteemi haldaja poolt.


== '''generateConsent.v1''' ==
Osaleja pärib Andmevahetussüsteemis koostatud Krediiditaotleja Nõusoleku dokumendi tema Andmete pärimiseks Osalejate andmekogudest.
Teenuse abil koostatakse dokument pdf formaadis, mille digiallkirjastades annab krediiditaotleja nõusoleku tema krediidikohustuste kohta andmete pärimiseks.


=== Päringu soap ümbriku keha parameetrid ===
== Credit report request / Andmete pärimine ==
'''Eeldus''': Osalejal on õigused antud teenuse kasutamiseks Andmevahetussüsteemi haldaja poolt.


[[File:GenerateConsentReq.png]]
'''Eeldus''': Kui päringu sisendiks on nõusoleku dokument, siis see peab olema eelnevalt koostatud Andmevahetussüsteemis.
# Osaleja edastab päringu Andmevahetussüsteemi Krediiditaotleja krediidikohustuste pärimiseks;
# Andmevahetussüsteem kogub Andmeid andmebaasist;
# Andmevahetussüsteem edastab kogutud Andmed päringut teinud Osalejale.
Laiendused:
* Osaleja on seadnud päringule vastamise ja Andmete edastamise tingimuseks digitaalselt allkirjastatud Nõusoleku olemasolu ja seda ei ole edastatud päringuga


=== Vastuse soap ümbriku keha parameetrid ===
::2a. Andmevahetussüsteem ei edasta päringut Andmeid Osaleja andmekogusse;


[[File:GenerateConsentResp.png]]
::3a.  Andmevahetussüsteem edastab veateadet mis sisaldab infot mitte edastatud päringu kohta.


=== Teenuse testimine ===
* Andmed säilivad Osaleja peetavas andmekogus.
Sisendparameetri ident_code väärtus on eksisteeriva isiku isikukood.
::2a. Andmevahetussüsteem kogub Andmeid Osalejate peetavatest andmekogudest.
* Andmete pärimine Osaleja peetavast andmekogust ebaõnnestub
::3a. Andmevahetussüsteem edastab päringu teinud Osalejale kogutud Andmeid ning ebaõnnestunud päringute arvu sisaldavat veateadet.


== '''getCreditReport.v1''' ==
== Credit data management / Andmete haldus ==


Krediiditaotleja krediidikohustuste kohta andmete pärimine Osalejate andmekogudest.
<b>Eeldus:</b> <u>Osaleja</u> on sõlminud käsunduslepingu Andmevahetussüsteemi haldajaga, millega ta on andnud tema peetava andmekogu volitatud töötleja õigused Andmevahetussüsteemi haldajale.


=== Päringu soap ümbriku keha parameetrid ===
'''Eeldus''': <u>Osalejal</u> on õigused antud teenuse kasutamiseks Andmevahetussüsteemi haldaja poolt.


[[File:GetSubjectPositiveData.png]]
<u>Osaleja</u> edastab tema peetava andmekogu andmed Andmevahetussüsteemi haldajale.


=== Vastuse soap ümbriku keha parameetrid ===
[[File:Credit data management use case.jpg]]


[[File:GetSubjectPositiveDataResponse.png]]
<b>Stsenaariumid</b>


=== Teenuse testimine ===
<b>A)</b> <u>Osaleja</u> edastab kõik kehtivad tarbijakrediitide andmed <u>Andmevahetussüsteemi haldajale</u>.
Sisendparameetri ident_code väärtus on eksisteeriva isiku isikukood.


Sisendparameetri signed_consent väärtus saab olla suvaline string kodeeritud base64-ga.
<b>B)</b> <u>Osaleja</u> uuendab tarbijakrediidiandmed Andmevahetussüteemis.


== '''insertCredit.v1''' ==


Ühe tarbijakrediidi andmete registreerimine andmevahetussüsteemi andmebaasis.
== Manager data management / Osaleja andmete haldus ==
<u>Andmevahetussüsteemi haldaja</u> registreerib/kustutab <u>Osaleja</u> kohta andmeid Andmevahetussüteemis.


=== Päringu soap ümbriku keha parameetrid ===


[[File:AddSubjectPositiveData.png | AddSubjectPositiveData]]
= Tegevusdiagrammid =


Allolevad tegevusdiagrammid ilustreerivad krediiditaotleja krediidivõimelisuse hindamise protsessi juhul kui


=== Vastuse soap ümbriku keha parameetrid ===
1. Krediiditaotleja allkirjastab Nõusolekut digitaalselt
[[File:Credit decision using digi consent.jpg]]


[[File:AddSubjectPositiveDataResponse.png | AddSubjectPositiveDataResponse]]
2. Krediiditaotleja Nõusolek ei ole digitaalselt allkirjastatud
[[File:Credit decision using digi consent.jpg]]


=== Teenuse testimine ===
= Lingid =
Sisendandmed peavad vastama nõuetele.
* [[Andmevahetussüsteemi X-tee liides|Andmevahetussüsteemi X-tee liides]]
 
Teenuse tulemuseks ei uuendata andmeid andmebaasis.
 
== '''updateCredit.v1''' ==
 
Ühe tarbijakrediidi andmete uuendamine andmevahetussüsteemi andmebaasis.
 
=== Päringu soap ümbriku keha parameetrid ===
 
[[File:UpdateSubjectPositiveData.png | UpdateSubjectPositiveData]]
 
 
=== Vastuse soap ümbriku keha parameetrid ===
 
[[File:UpdateSubjectPositiveDataResponse.png | UpdateSubjectPositiveDataResponse]]
 
 
 
=== Teenuse testimine ===
Sisendandmed peavad vastama nõuetele.
 
Teenuse tulemuseks ei salvestata andmeid andmebaasi.
 
== '''deleteCredit.v1''' ==
 
Ühe tarbijakrediidi andmete kustutamine andmevahetussüsteemi andmebaasist.
 
=== Päringu soap ümbriku keha parameetrid ===
 
[[File:DeleteSubjectPositiveData.png | DeleteSubjectPositiveData]]
 
 
=== Vastuse soap ümbriku keha parameetrid ===
 
[[File:DeleteSubjectPositiveDataResponse.png | DeleteSubjectPositiveDataResponse]]
 
 
===Teenuse testimine===
Sisendandmed peavad vastama nõuetele.
 
Teenuse tulemuseks ei kustutata andmeid andmebaasist.
== '''uploadCreditsMtom.v1''' ==
 
Kõigi kehtivate tarbijakrediitide andmete sisse importimine andmevahetussüsteemi andmebaasi.
 
=== Päring ===
 
Päringu sõnum on <b>MTOM/XOP</b> formaadis, mis vastab SOAP <b>multipart/related</b> standardile. Sõnumi esimeses osas on SOAP ümbrik. Sõnumi teises osas on gzip-ga kokkupakkitud ja seejärel base64-ga kodeeritud tarbijakrediitide andmetega xml, mis vastab skeemile https://services.krediidiinfo.ee/schemas/positive_register/credit/v1/insert.xsd.
 
 
SOAP ümbriku parameetrid on:
 
[[File:UploadPositiveDataMtom.png | UploadPositiveDataMtom]]
 
 
[[File:Loaninfo debtors.png]]
 
 
Näitepäring:
 
<pre>
...Teised päised
Content-Type: multipart/related; type="application/xop+xml"; start="<xxx>"; start-info="text/xml"; boundary="MIME_boundary"'
MIME-Version: 1.0
 
--MIME_boundary
Content-Type: application/xop+xml; charset=UTF-8; type="text/xml"
Content-Transfer-Encoding: 8bit
Content-ID: <xxx>
 
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:xrd="http://x-road.eu/xsd/xroad.xsd"
                  xmlns:id="http://x-road.eu/xsd/identifiers"
                  xmlns:posr="http://www.krediidiinfo.ee/services/posr">
    <SOAP-ENV:Header>
        <xrd:client id:objectType="SUBSYSTEM">
            <id:xRoadInstance>EE</id:xRoadInstance>
            <id:memberClass>COM</id:memberClass>
            <id:memberCode>00000000</id:memberCode>
            <id:subsystenCode>TEST</id:subsystenCode>
        </xrd:client>
        <xrd:service id:objectType="SERVICE">
            <id:xRoadInstance>EE</id:xRoadInstance>
            <id:memberClass>COM</id:memberClass>
            <id:memberCode>10256137</id:memberCode>
            <id:subsystemCode>POSR</id:subsystemCode>
            <id:serviceCode>uploadCreditsMtom</id:serviceCode>
            <id:serviceVersion>v1</id:serviceVersion>
        </xrd:service>
        <xrd:id>test</xrd:id>
        <xrd:userId>EE00000000000</xrd:userId>
        <xrd:protocolVersion>4.0</xrd:protocolVersion>
    </SOAP-ENV:Header>
    <SOAP-ENV:Body>
        <posr:uploadCreditsMtom>
            <positive_data>
                <inc:Include href="cid:xxx"/>
            </positive_data>
        </posr:uploadCreditsMtom>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
 
--MIME_boundary
Content-Type: application/octet-stream
Content-Transfer-Encoding: base64
Content-ID: <xxx>
Content-Disposition: attachment;
 
H4sIAAAAAAAAA12PsW7CQAyGd6S+Q+Q9dxeoRIkIbEx0KpXYoujOCRbEh84uyeM3abtQyfLi///kb7sf+1v2wCQUuYLCOMiQfQzEXQWfp0P+Bvvdy2LrI8tXj6n2CQOpZFOPpaRQwUX1Xlo7DIO5zkeahttoEK34C/aN2HsUUnpgnbAjUUz2F1NTQFZqaXrAjBLgDzsKPXGHlYmps0vnCnt+P378YHNi0YY9QtYhY2oU6zAtpR4rmLN5scyL9cltypUrX9cwi9j/Jrtv1xHpQQQBAAA=
 
 
--MIME_boundary--
</pre>
 
=== Vastuse soap ümbriku keha parameetrid ===
 
[[File:UploadPositiveDataMtomResponse.png | UploadPositiveDataMtomResponse]]
 
=== Teenuse testimine ===
Sõnumi teises osas oleva attachment saab olla suvaline string kodeeritud base64-ga. Andmete importimist ei toimu.
 
== '''getUploadStatus.v1''' ==
 
Faili töötlemise staatuse pärimine mis oli tekitatud kõigi kehtivate tarbijakrediitide andmete sisse importimise tulemusena andmevahetussüsteemi.
 
=== Päringu soap ümbriku keha parameetrid ===
 
[[File:UploadPositiveDataStatus.png | UploadPositiveDataStatus]]
 
 
=== Vastuse soap ümbriku keha parameetrid ===
 
[[File:UploadPositiveDataStatusResponse.png | UploadPositiveDataStatusResponse]]
 
=== Teenuse testimine ===
Sisendparameeter doc_id võib suvaline number olla.
 
Teenuse tulemuseks on suvaline staatus.
 
= Tehniline viga =
 
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Body>
        <SOAP-ENV:Fault>
            <faultcode>SOAP-ENV:Server</faultcode>
            <faultstring>Internal service error</faultstring>
            <faultactor/>
            <detail>
                <faultCode>-50200</faultCode>
                <faultString>Internal service error</faultString>
            </detail>
        </SOAP-ENV:Fault>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</pre>
 
= Veakoodid =
<table>
  <tr>
    <td>'''-50200'''</td>
    <td>'''Internal service error'''</td>
  </tr>
  <tr>
    <td></td>
    <td>Sisemine viga</td>
  </tr>
  <tr>
    <td>'''-50201'''
'''-50301'''
</td>
    <td>'''Invalid request'''</td>
  </tr>
  <tr>
    <td></td>
    <td>Vigane päringu formaat või sisu</td>
  </tr>
  <tr>
    <td>'''-50202'''</td>
    <td>'''Access denied'''</td>
  </tr>
  <tr>
    <td></td>
    <td>Kasutajal puudub liigipääs süsteemile</td>
  </tr>
  <tr>
    <td>'''-50203'''</td>
    <td>'''Partial data'''</td>
  </tr>
  <tr>
    <td></td>
    <td>Päringu vastus sisaldab osalisi andmeid.</td>
  </tr>
  <tr>
    <td>'''-50250'''</td>
    <td>'''Credit data sync failed'''</td>
  </tr>
  <tr>
    <td></td>
    <td>Tarbijakrediidi andmete sünkroniseerimine (sisestamine, uuendamine, kustutamine) ebaõnnestus</td>
  </tr><tr><td>'''-50252'''</td><td>'''Invalid consent document'''</td></tr><tr><td></td><td>Nõusoleku dokument ei ole pre-genereeritud või on vigane digidoc konteiner.</td></tr><tr><td>'''-50300'''</td><td>'''Invalid xml'''</td></tr><tr><td></td><td>Viga xml-s</td></tr></table>
 
= Lingid =
[[Positiivne_register: funktsionaalne_spetsifikatsioon | Funktsionaalne spetsifikatsioon]]

Latest revision as of 13:05, 10 April 2017

Flag of the United Kingdom.svg In English

Sissejuhatus

Positiivne Register on andmevahetussüsteem, mille kaudu registri liikmeks olevad krediteerijad saavad eraisiku nõusolekul vahetada infot tema laenukohustuste kohta. Positiivne Register võimaldab laenuandjal täita seadusest tulenevat vastutustundliku laenamise nõuet ning veenduda inimese võimes täita oma laenukohustust. Laenuklient ei pea enam tooma paberkandjal väljavõtteid teiste laenuandjate juurest ning on paremini kaitstud emotsionaalsete laenuotsuste ja ülelaenamisest tekkivate probleemide eest.


Mõisted

  • Andmed – andmed tarbija olemasolevate kohustuste kohta, mis võimaldavad Osalejal hinnata tarbija krediidivõimelisust;
  • Andmevahetussüsteem (Data exchange system ) – infotehniline rakendus, mille vahendusel Osalejad vahetavad Andmeid;
  • Andmevahetussüteemi haldaja (Data exchange system manager) – Creditinfo Eesti AS;
  • Krediiditaotleja (consumer) - eraisik, kes on pöördunud Osaleja poole tarbijakrediidilepingu sõlmimise sooviga.
  • Krediidisaaja (consumer) – eraisik, kellele Osaleja on väljastanud tarbijakrediidilepingu alusel krediidi.
  • Tarbijakrediit (consumer credit) – Osaleja poolt Krediidisaajale väljastatud krediit;
  • Krediidiotsus (credit decision) – Osaleja poolt langetatav otsus tarbijakrediidilepingu sõlmimiseks Kreediiditaotlejaga;
  • Tarbijakrediidileping (consumer credit contract) – leping, mille alusel on Osaleja väljastanud Krediidisaajale krediidi;
  • Kaastaotleja (codebtor) - isik, kellega Krediiditaotleja koos krediiti taotleb ja kelle sissetulekud ning varad võetakse Krediidiotsuse tegemisel arvesse;
  • Käendaja (guarantor) - isik, kes võtab Osaleja ees kohustuse vastutada Krediidisaaja Tarbijakrediidi kohustuse täitmise eest;
  • Tarbijakrediidilepingu subjekt (subject)- lepingu osapool;
  • Osaleja (member) – Andmevahetussüsteemiga liitunud Eesti, kes jagab temale teadaolevaid Andmeid Krediiditaotleja kohta samaväärses koosseisus teiste Osalejatega;
  • Krediiditaotleja nõusolek (consent) - Krediiditaotleja nõusolek päringu adressaatideks olevatele Osalejatele Krediiditaotleja Andmete edastamiseks päringu teinud Osalejale.


Ärireeglid

  • Andmevahetussüsteemi kasutajad on Osalejad.
  • Osaleja peab olema liitunud X-teega.
  • Osaleja sisestab Andmed Andmevahetussüsteemi haldaja andmebaasi või tekitab Andmevahetussüsteemi haldajale tehnoloogiline võimalus Andmeid pärida oma Andmekogust.
  • Osaleja uuendab Andmed edastades Andmevahetussüsteemi haldajale kas kõik kehtivad Andmed või Tarbijakrediidilepingu kaupa.
  • Osaleja uuendab Andmed iga 24 tunni järel. Äärmisel juhul kuni 7 päeva järel.
  • Osaleja pärib Krediiditaotleja kohta Andmeid tema Nõusoleku olemaolul. Kui Nõusolek ei ole digitaalselt allkirjastatud, siis pärijal ei ole õigust saada Andmeid teistelt Osalejatelt, kes on seadnud päringule vastamise ja Andmete edastamise tingimuseks digitaalselt allkirjastatud Nõusoleku olemasolu.
  • Nõusoleku dokument säilib Andmevahetussüsteemis 3 aastat.
  • Admete päringu vastus ei kajasta andmeid Osaleja kohta.
  • Andmete päringu vastus ei sisalda päringut teinud Osaleja Andmekogust Andmeid.
  • Andmete päringu vastuse koosseis kirjeldatud peatükis "Andmete koosseis".
  • Osalejad jagavad Andmeid samaväärses koosseisus teiste Osalejatega.


Andmete kooseis

  1. Uuendamise kuupäev (update date and time)
  2. Isikukood (identity code)
  3. Isiku roll (role) antud lepingu raames
  4. Lepingu number (contract number) - Osaleja ja Krediidisaaja vahel sõlmitud Tarbijakrediidilepingu number;
  5. Krediidi liik (type of credit)
  6. Krediidi algus (effective date of credit agreement) – Tarbijakrediidilepingu kehtivuse alguskuupäev
  7. Krediidi lõpp (end date of credit) – Kuupäev, millal Tarbijakrediit tuleb tagastada
  8. Krediidi summa (credit sum) - Krediidisaajale väljamakstud või väljamaksmisele kuuluv maksimaalne Tarbijakrediidi summa;
  9. Krediidi valuuta (credit currency) - Tarbijakrediidi valuuta;
  10. Maksegraafik (schedule payments) – Järgmise või lähima kolme väljamakse summa ja tähtaeg;
  11. Hetkesaldo (balance) - Tarbija kohustuse suurus Osaleja ees;
  12. Üle tähtaja saldo (days over net balance) – 7 päeva üle maksetähtaja hilinenud maksete summa.
  13. Päringud (inquiries) – Krediidisaaja kohta Andmete saamiseks viimase kolme aasta jooksul tehtud päringute kuupäevad.

Isiku rollid

  1. Krediidisaaja (borrower)
  2. Kaastaotleja (codebtor)
  3. Käendaja (guarantor)

Krediidi liigid

  1. Tagatisega laen (secured loan)
  2. Järelmaks (hire-purchase)
  3. Tagatiseta laen (unsecured loan)
  4. Liising (lease)
  5. Krediitkaart (credit card)
  6. Muu (other)


Kasutuslood

Positive register use cases.jpg


Members list request

Eeldus: Osalejal on õigused antud teenuse kasutamiseks Andmevahetussüsteemi haldaja poolt.

Osaleja pärib teiste Osalejate nimekirja et kasutada see nõusoleku dokumendi tekstis.

Consent document creation / Nõusoleku dokumendi koostamine

Eeldus: Osalejal on õigused antud teenuse kasutamiseks Andmevahetussüsteemi haldaja poolt.

Osaleja pärib Andmevahetussüsteemis koostatud Krediiditaotleja Nõusoleku dokumendi tema Andmete pärimiseks Osalejate andmekogudest.

Credit report request / Andmete pärimine

Eeldus: Osalejal on õigused antud teenuse kasutamiseks Andmevahetussüsteemi haldaja poolt.

Eeldus: Kui päringu sisendiks on nõusoleku dokument, siis see peab olema eelnevalt koostatud Andmevahetussüsteemis.

  1. Osaleja edastab päringu Andmevahetussüsteemi Krediiditaotleja krediidikohustuste pärimiseks;
  2. Andmevahetussüsteem kogub Andmeid andmebaasist;
  3. Andmevahetussüsteem edastab kogutud Andmed päringut teinud Osalejale.

Laiendused:

  • Osaleja on seadnud päringule vastamise ja Andmete edastamise tingimuseks digitaalselt allkirjastatud Nõusoleku olemasolu ja seda ei ole edastatud päringuga
2a. Andmevahetussüsteem ei edasta päringut Andmeid Osaleja andmekogusse;
3a. Andmevahetussüsteem edastab veateadet mis sisaldab infot mitte edastatud päringu kohta.
  • Andmed säilivad Osaleja peetavas andmekogus.
2a. Andmevahetussüsteem kogub Andmeid Osalejate peetavatest andmekogudest.
  • Andmete pärimine Osaleja peetavast andmekogust ebaõnnestub
3a. Andmevahetussüsteem edastab päringu teinud Osalejale kogutud Andmeid ning ebaõnnestunud päringute arvu sisaldavat veateadet.

Credit data management / Andmete haldus

Eeldus: Osaleja on sõlminud käsunduslepingu Andmevahetussüsteemi haldajaga, millega ta on andnud tema peetava andmekogu volitatud töötleja õigused Andmevahetussüsteemi haldajale.

Eeldus: Osalejal on õigused antud teenuse kasutamiseks Andmevahetussüsteemi haldaja poolt.

Osaleja edastab tema peetava andmekogu andmed Andmevahetussüsteemi haldajale.

Credit data management use case.jpg

Stsenaariumid

A) Osaleja edastab kõik kehtivad tarbijakrediitide andmed Andmevahetussüsteemi haldajale.

B) Osaleja uuendab tarbijakrediidiandmed Andmevahetussüteemis.


Manager data management / Osaleja andmete haldus

Andmevahetussüsteemi haldaja registreerib/kustutab Osaleja kohta andmeid Andmevahetussüteemis.


Tegevusdiagrammid

Allolevad tegevusdiagrammid ilustreerivad krediiditaotleja krediidivõimelisuse hindamise protsessi juhul kui

1. Krediiditaotleja allkirjastab Nõusolekut digitaalselt Credit decision using digi consent.jpg

2. Krediiditaotleja Nõusolek ei ole digitaalselt allkirjastatud Credit decision using digi consent.jpg

Lingid

Retrieved from "https://services.krediidiinfo.ee/wiki/index.php?title=Positiivne_register:_funktsionaalne_spetsifikatsioon&oldid=906"