Andmevahetussüsteemi X-tee liides: Difference between revisions

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


KRI6 on Krediidiinfo liides, mille vahendusel Osalejad vahetavad krediiditaotleja krediidikohustuste andmeid omavahel <b>X-tee versioon 6</b> vahendusel. See spetsifikatsioon kirjeldab andmete vahetuse tehnilisi aspekte. KRI6 teenuste kasutamine eeldab, et osaleja on liitunud X-teega.  
'''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.  
 
= Teenuste kasutamine toodangukeskkonnas =
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.
 
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 =
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.
 
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.


= WSDL =
= WSDL =


KRI6 WSDL asub aadresslil [https://services.krediidiinfo.ee/wsdl/kri6.wsdl https://services.krediidiinfo.ee/wsdl/kri6.wsdl].
POSR süsteemi WSDL asub aadressil http://services.krediidiinfo.ee/posr.wsdl.


= X-tee sõnum =
= X-tee sõnum =
Line 16: Line 35:


== SOAP ümbriku päis ==
== SOAP ümbriku päis ==
SOAP ümbriku päises oleva info koosseis on määratud X-tee spetsifikatsiooni poolt.  
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 ==
== SOAP ümbriku keha ==
Line 24: Line 43:
<pre>
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:kri="urn:kri6">
<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>
     <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">
         <xrd:client id:objectType="SUBSYSTEM">
             <id:xRoadInstance>EE</id:xRoadInstance>
             <id:xRoadInstance>EE</id:xRoadInstance>
             <id:memberClass>COM</id:memberClass>
             <id:memberClass>COM</id:memberClass>
             <id:memberCode>10256137</id:memberCode>
             <id:memberCode>00000000</id:memberCode>
            <id:subsystemCode>TEST</id:subsystemCode>
         </xrd:client>
         </xrd:client>
         <xrd:service id:objectType="SERVICE" xmlns:xrd="http://x-road.eu/xsd/xroad.xsd" xmlns:id="http://x-road.eu/xsd/identifiers">
         <xrd:service id:objectType="SERVICE">
             <id:xRoadInstance>EE</id:xRoadInstance>
             <id:xRoadInstance>EE</id:xRoadInstance>
             <id:memberClass>COM</id:memberClass>
             <id:memberClass>COM</id:memberClass>
             <id:memberCode>10256137</id:memberCode>
             <id:memberCode>10256137</id:memberCode>
             <id:serviceCode>getSubjectPositiveData</id:serviceCode>
            <id:subsystemCode>POSR</id:subsystemCode>
             <id:serviceCode>getCreditReport</id:serviceCode>
             <id:serviceVersion>v1</id:serviceVersion>
             <id:serviceVersion>v1</id:serviceVersion>
         </xrd:service>
         </xrd:service>
         <xrd:id xmlns:xrd="http://x-road.eu/xsd/xroad.xsd">5734440e50c71</xrd:id>
         <xrd:id>test</xrd:id>
         <xrd:userId xmlns:xrd="http://x-road.eu/xsd/xroad.xsd">EE00000000000</xrd:userId>
         <xrd:userId>EE00000000000</xrd:userId>
        <xrd:issue xmlns:xrd="http://x-road.eu/xsd/xroad.xsd"/>
         <xrd:protocolVersion>4.0</xrd:protocolVersion>
         <xrd:protocolVersion xmlns:xrd="http://x-road.eu/xsd/xroad.xsd">4.0</xrd:protocolVersion>
     </SOAP-ENV:Header>
     </SOAP-ENV:Header>
     <SOAP-ENV:Body>
     <SOAP-ENV:Body>
      <kri:getSubjectPositiveData>
        <posr:getCreditReport>
             <subject>
             <rep:subject>
                 <ident_code>00000000000</ident_code>
                 <rep:ident_code>00000000000</rep:ident_code>
             </subject>
             </rep:subject>
             <is_digi_agreement>1</is_digi_agreement>
             <rep:signed_consent>TEST</rep:signed_consent>
             <lang>en</lang>
             <rep:lang>et</rep:lang>
         </kri:getSubjectPositiveData>
         </posr:getCreditReport>
     </SOAP-ENV:Body>
     </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</SOAP-ENV:Envelope>
Line 59: Line 83:
<pre>
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:kri="urn:kri6">
<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>
     <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">
         <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:xRoadInstance>EE</id:xRoadInstance>
             <id:memberClass>COM</id:memberClass>
             <id:memberClass>COM</id:memberClass>
             <id:memberCode>10256137</id:memberCode>
             <id:memberCode>00000000</id:memberCode>
            <id:subsystemCode>Test</id:subsystemCode>
         </xrd:client>
         </xrd:client>
         <xrd:service id:objectType="SERVICE" xmlns:xrd="http://x-road.eu/xsd/xroad.xsd" xmlns:id="http://x-road.eu/xsd/identifiers">
         <xrd:service id:objectType="SERVICE" xmlns:xrd="http://x-road.eu/xsd/xroad.xsd" xmlns:id="http://x-road.eu/xsd/identifiers">
Line 70: Line 97:
             <id:memberClass>COM</id:memberClass>
             <id:memberClass>COM</id:memberClass>
             <id:memberCode>10256137</id:memberCode>
             <id:memberCode>10256137</id:memberCode>
             <id:serviceCode>getSubjectPositiveData</id:serviceCode>
            <id:subsystemCode>POSR</id:subsystemCode>
             <id:serviceCode>getCreditReport</id:serviceCode>
             <id:serviceVersion>v1</id:serviceVersion>
             <id:serviceVersion>v1</id:serviceVersion>
         </xrd:service>
         </xrd:service>
         <xrd:id xmlns:xrd="http://x-road.eu/xsd/xroad.xsd">5734440e50c71</xrd:id>
         <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: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: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: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">
         <xrd:requestHash algorithmId="http://www.w3.org/2001/04/xmlenc#sha512">Test</xrd:requestHash>
            RglGFiBmbZJ0JLwm+vzfGn4fQEIY1YfM81H3SekOw5VnwxO/jilTfHG0zgsaUH9LzLOCqb5YssDz0MbMzm3DhQ==
        </xrd:requestHash>
     </SOAP-ENV:Header>
     </SOAP-ENV:Header>
     <SOAP-ENV:Body>
     <SOAP-ENV:Body>
         <kri:getSubjectPositiveDataResponse>
         <posr:getCreditReportResponse>
             <subject_positive_data>
             <credit_report xmlns:rep="http://www.krediidiinfo.ee/schemas/positive_register/credit/v1/report.xsd"
                <consumer_credits>
                          xmlns:cid="http://www.krediidiinfo.ee/schemas/positive_register/credit/v1/identifiers.xsd">
                     <consumer_credit>
<rep:consumer_credits>
                        <type code="O">Other</type>
                     <rep:consumer_credit>
                        <begin_date>2016-07-14</begin_date>
        <cid:type>
                        <end_date>2017-07-14</end_date>
                            <cid:code>CC</cid:code>
                        <total_sum>200</total_sum>
                            <cid:name>Krediitkaart</cid:name>
                        <balance>200</balance>
                        </cid:type>
                        <unpaid_sum>7</unpaid_sum>
<cid:begin_date>2016-07-14</cid:begin_date>
                        <currency>EUR</currency>
<cid:end_date>2017-07-14</cid:end_date>
                        <schedule_payments>
<cid:sum>200</cid:sum>
                            <schedule_payment>
<cid:balance>200</cid:balance>
                                <due_date>2016-10-22</due_date>
<cid:unpaid_sum>7</cid:unpaid_sum>
                                <sum>100.0</sum>
<cid:currency>EUR</cid:currency>
                            </schedule_payment>
<cid:schedule_payments>
                        </schedule_payments>
    <cid:schedule_payment>
                         <subject>
        <cid:due_date>2016-10-22</cid:due_date>
                            <ident_code>48508060269</ident_code>
<cid:sum>100.0</cid:sum>
                            <role code="GRT">Guarantor</role>
    </cid:schedule_payment>
                        </subject>
          </cid:schedule_payments>
                         <update_datetime>2016-01-01 03:00:00</update_datetime>
                         <cid:subjects> 
                  </consumer_credit>
    <cid:subject>
              </consumer_credits>
        <cid:ident_code>00000000000</cid:ident_code>
              <requests/>
        <cid:role>
          </subject_positive_data>
                                    <cid:code>BRW</cid:code>
          <fault xsi:nil="true"/>
                                    <cid:name>Krediidivõtja</cid:name>
         </kri:getSubjectPositiveDataResponse>
                                </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:Body>
</SOAP-ENV:Envelope>
</SOAP-ENV:Envelope>
</pre>
</pre>
= Teenused =
= Teenused =


== '''getSubjectPositiveData''' ==
Teenuste kasutamiseks peavad Osalejal olema õigused antud Creditinfo Eesti AS poolt.


Krediiditaotleja andmete pärimine Osalejate andmekogudest.
== '''generateConsent.v1''' ==
Teenuse abil koostatakse dokument pdf formaadis, mille digiallkirjastades annab krediiditaotleja nõusoleku tema krediidikohustuste kohta andmete pärimiseks.


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


[[File:GetSubjectPositiveData.png | GetSubjectPositiveData]]
[[File:GenerateConsentReq.png]]


=== Vastuse soap ümbriku keha parameetrid ===
[[File:GenerateConsentResp.png]]
=== Teenuse testimine ===
Sisendparameetri ident_code väärtus on eksisteeriva isiku isikukood.
== '''getMembers.v1''' ==
Andmevahetussüsteemiga liitunud Osalejate nimekirja pärimine, et kasutada see nõusoleku dokumendi tekstis.
=== Päringu soap ümbriku keha parameetrid ===
[[File:GetMembersReq.png]]
=== Vastuse soap ümbriku keha parameetrid ===
[[File:GetMembersResp.png]]
== '''getCreditReport.v1''' ==
Krediiditaotleja krediidikohustuste kohta andmete pärimine Osalejate andmekogudest.
=== Päringu soap ümbriku keha parameetrid ===
[[File:GetSubjectPositiveData.png]]


=== Vastuse soap ümbriku keha parameetrid ===
=== Vastuse soap ümbriku keha parameetrid ===


[[File:GetSubjectPositiveDataResponse.png | GetSubjectPositiveDataResponse]]
[[File:GetSubjectPositiveDataResponse.png]]
 
=== Teenuse testimine ===
Sisendparameetri ident_code väärtus on eksisteeriva isiku isikukood.


Sisendparameetri signed_consent väärtus saab olla suvaline string kodeeritud base64-ga.


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


== '''addSubjectPositiveData''' ==
Ühe tarbijakrediidi andmete registreerimine andmevahetussüsteemi andmebaasis.
Ühe tarbijakrediidi andmete registreerimine.


=== Päringu soap ümbriku keha parameetrid ===
=== Päringu soap ümbriku keha parameetrid ===
Line 142: Line 212:
[[File:AddSubjectPositiveDataResponse.png | AddSubjectPositiveDataResponse]]
[[File:AddSubjectPositiveDataResponse.png | AddSubjectPositiveDataResponse]]


=== Teenuse testimine ===
Sisendandmed peavad vastama nõuetele.
Teenuse tulemuseks ei uuendata andmeid andmebaasis.


== '''updateCredit.v1''' ==


== '''updateSubjectPositiveData''' ==
Ühe tarbijakrediidi andmete uuendamine andmevahetussüsteemi andmebaasis.
Ühe tarbijakrediidi andmete uuendamine.


=== Päringu soap ümbriku keha parameetrid ===
=== Päringu soap ümbriku keha parameetrid ===
Line 157: Line 231:




== '''deleteSubjectPositiveData''' ==
 
Ühe tarbijakrediidi andmete kustutamine.
=== 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 ===
=== Päringu soap ümbriku keha parameetrid ===
Line 170: Line 251:




== '''uploadPositiveDataMtom''' ==
===Teenuse testimine===
Kõigi kehtivate tarbijakrediitide andmete sisseimportimine.
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äring ===


Päring 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 [http://www.krediidiinfo.ee/schemas/positive_register/data_exchange.xsd http://www.krediidiinfo.ee/schemas/positive_register/data_exchange.xsd].  
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 keha parameetrid on:
SOAP ümbriku parameetrid on:


[[File:UploadPositiveDataMtom.png | UploadPositiveDataMtom]]
[[File:UploadPositiveDataMtom.png | UploadPositiveDataMtom]]
Line 199: Line 285:


<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:xrd="http://x-road.eu/xsd/xroad.xsd"
    xmlns:ns1="urn:kri6"
                  xmlns:id="http://x-road.eu/xsd/identifiers"
    xmlns:xrd="http://x-road.eu/xsd/xroad.xsd"
                  xmlns:posr="http://www.krediidiinfo.ee/services/posr">
    xmlns:id="http://x-road.eu/xsd/identifiers"
    <SOAP-ENV:Header>
    xmlns:inc="http://www.w3.org/2004/08/xop/include">
        <xrd:client id:objectType="SUBSYSTEM">
<SOAP-ENV:Header>
            <id:xRoadInstance>EE</id:xRoadInstance>
    <xrd:client id:objectType="MEMBER">
            <id:memberClass>COM</id:memberClass>
        <id:xRoadInstance>EE</id:xRoadInstance>
            <id:memberCode>00000000</id:memberCode>
        <id:memberClass>XX</id:memberClass>
            <id:subsystenCode>TEST</id:subsystenCode>
        <id:memberCode>00000000</id:memberCode>
        </xrd:client>
    </xrd:client>
        <xrd:service id:objectType="SERVICE">
    <xrd:service id:objectType="SERVICE">
            <id:xRoadInstance>EE</id:xRoadInstance>
        <id:xRoadInstance>EE</id:xRoadInstance>
            <id:memberClass>COM</id:memberClass>
        <id:memberClass>XX</id:memberClass>
            <id:memberCode>10256137</id:memberCode>
        <id:memberCode>10256137</id:memberCode>
            <id:subsystemCode>POSR</id:subsystemCode>
        <id:serviceCode>uploadPositiveDataMtom</id:serviceCode>
            <id:serviceCode>uploadCreditsMtom</id:serviceCode>
        <id:serviceVersion>v1</id:serviceVersion>
            <id:serviceVersion>v1</id:serviceVersion>
    </xrd:service>
        </xrd:service>
    <xrd:id>4894e35d-bf0f-44a6-867a-8e51f1daa7e0</xrd:id>
        <xrd:id>test</xrd:id>
    <xrd:userId>EE00000000000</xrd:userId>
        <xrd:userId>EE00000000000</xrd:userId>
    <xrd:protocolVersion>4.0</xrd:protocolVersion>
        <xrd:protocolVersion>4.0</xrd:protocolVersion>
</SOAP-ENV:Header>
    </SOAP-ENV:Header>
<SOAP-ENV:Body>
    <SOAP-ENV:Body>
    <ns1:uploadPositiveDataMtom>
        <posr:uploadCreditsMtom>
        <positive_data>
            <positive_data>
            <inc:Include href="cid:xxx"/>
                <inc:Include href="cid:xxx"/>
        </positive_data>
            </positive_data>
    </ns1:uploadPositiveDataMtom>
        </posr:uploadCreditsMtom>
</SOAP-ENV:Body>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</SOAP-ENV:Envelope>


Line 237: Line 323:
Content-Disposition: attachment;
Content-Disposition: attachment;


ZZZ
H4sIAAAAAAAAA12PsW7CQAyGd6S+Q+Q9dxeoRIkIbEx0KpXYoujOCRbEh84uyeM3abtQyfLi///kb7sf+1v2wCQUuYLCOMiQfQzEXQWfp0P+Bvvdy2LrI8tXj6n2CQOpZFOPpaRQwUX1Xlo7DIO5zkeahttoEK34C/aN2HsUUnpgnbAjUUz2F1NTQFZqaXrAjBLgDzsKPXGHlYmps0vnCnt+P378YHNi0YY9QtYhY2oU6zAtpR4rmLN5scyL9cltypUrX9cwi9j/Jrtv1xHpQQQBAAA=
 


--MIME_boundary--
--MIME_boundary--
Line 246: Line 333:
[[File:UploadPositiveDataMtomResponse.png | UploadPositiveDataMtomResponse]]
[[File:UploadPositiveDataMtomResponse.png | UploadPositiveDataMtomResponse]]


== '''uploadPositiveDataStatus''' ==
=== Teenuse testimine ===
Üleslaetud kõigi kehtivate tarbijakrediitide andmete alusel tekitatud faili töötlemise staatuse pärimine.
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 ===
=== Päringu soap ümbriku keha parameetrid ===
Line 257: Line 348:


[[File:UploadPositiveDataStatusResponse.png | UploadPositiveDataStatusResponse]]
[[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:02, 10 April 2017

Flag of the United Kingdom.svg In English


Tutvustus

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.

Teenuste kasutamine toodangukeskkonnas

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.

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

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.

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 x-tee metateenused nagu "listMethods" ja "allowedMethods". Metateenustele ligipääsuõigusi ei anta.

WSDL

POSR süsteemi WSDL asub aadressil http://services.krediidiinfo.ee/posr.wsdl.

X-tee sõnum

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.

SOAP ümbriku päis

SOAP ümbriku päises oleva info koosseis on määratud X-tee spetsifikatsiooni poolt.

SOAP ümbriku keha

SOAP ümbriku kehas oleva info koosseis on määratud käesoleva dokumendi poolt.

Päringu soap ümbriku näide

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

Vastuse soap ümbriku näide

<?xml version="1.0" encoding="UTF-8"?>
<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>

Teenused

Teenuste kasutamiseks peavad Osalejal olema õigused antud Creditinfo Eesti AS poolt.

generateConsent.v1

Teenuse abil koostatakse dokument pdf formaadis, mille digiallkirjastades annab krediiditaotleja nõusoleku tema krediidikohustuste kohta andmete pärimiseks.

Päringu soap ümbriku keha parameetrid

GenerateConsentReq.png

Vastuse soap ümbriku keha parameetrid

GenerateConsentResp.png

Teenuse testimine

Sisendparameetri ident_code väärtus on eksisteeriva isiku isikukood.

getMembers.v1

Andmevahetussüsteemiga liitunud Osalejate nimekirja pärimine, et kasutada see nõusoleku dokumendi tekstis.

Päringu soap ümbriku keha parameetrid

GetMembersReq.png

Vastuse soap ümbriku keha parameetrid

GetMembersResp.png

getCreditReport.v1

Krediiditaotleja krediidikohustuste kohta andmete pärimine Osalejate andmekogudest.

Päringu soap ümbriku keha parameetrid

GetSubjectPositiveData.png

Vastuse soap ümbriku keha parameetrid

GetSubjectPositiveDataResponse.png

Teenuse testimine

Sisendparameetri ident_code väärtus on eksisteeriva isiku isikukood.

Sisendparameetri signed_consent väärtus saab olla suvaline string kodeeritud base64-ga.

insertCredit.v1

Ühe tarbijakrediidi andmete registreerimine andmevahetussüsteemi andmebaasis.

Päringu soap ümbriku keha parameetrid

AddSubjectPositiveData


Vastuse soap ümbriku keha parameetrid

AddSubjectPositiveDataResponse

Teenuse testimine

Sisendandmed peavad vastama nõuetele.

Teenuse tulemuseks ei uuendata andmeid andmebaasis.

updateCredit.v1

Ühe tarbijakrediidi andmete uuendamine andmevahetussüsteemi andmebaasis.

Päringu soap ümbriku keha parameetrid

UpdateSubjectPositiveData


Vastuse soap ümbriku keha parameetrid

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

DeleteSubjectPositiveData


Vastuse soap ümbriku keha parameetrid

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 MTOM/XOP formaadis, mis vastab SOAP multipart/related 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:

UploadPositiveDataMtom


Loaninfo debtors.png


Näitepäring: 

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

Vastuse soap ümbriku keha parameetrid

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

UploadPositiveDataStatus


Vastuse soap ümbriku keha parameetrid

UploadPositiveDataStatusResponse

Teenuse testimine

Sisendparameeter doc_id võib suvaline number olla.

Teenuse tulemuseks on suvaline staatus.

Tehniline viga

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

Veakoodid

-50200 Internal service error
Sisemine viga
-50201

-50301

Invalid request
Vigane päringu formaat või sisu
-50202 Access denied
Kasutajal puudub liigipääs süsteemile
-50203 Partial data
Päringu vastus sisaldab osalisi andmeid.
-50250 Credit data sync failed
Tarbijakrediidi andmete sünkroniseerimine (sisestamine, uuendamine, kustutamine) ebaõnnestus
-50252Invalid consent document
Nõusoleku dokument ei ole pre-genereeritud või on vigane digidoc konteiner.
-50300Invalid xml
Viga xml-s

Lingid

Funktsionaalne spetsifikatsioon

Retrieved from "https://services.krediidiinfo.ee/wiki/index.php?title=Andmevahetussüsteemi_X-tee_liides&oldid=904"