Andmevahetussüsteemi X-tee liides: Difference between revisions

From services.krediidiinfo.ee
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
= Tutvustus =  
= Tutvustus =  


KRI6 on Creditinfo 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. POSR teenuste kasutamine eeldab, et osaleja on liitunud X-teega.  


= WSDL =
= WSDL =


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


= X-tee sõnum =
= X-tee sõnum =
Line 24: Line 26:
<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="http://posr.x-road.eu">
<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>00000000</id:memberCode>
             <id:memberCode>00000000</id:memberCode>
             <id:subsystemCode>XX</id:subsystemCode>
             <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:subsystemCode>POSR</id:subsystemCode>
             <id:subsystemCode>POSR</id:subsystemCode>
             <id:serviceCode>getSubjectData</id:serviceCode>
             <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:getSubjectData>
        <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:getSubjectData>
         </posr:getCreditReport>
     </SOAP-ENV:Body>
     </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</SOAP-ENV:Envelope>
Line 61: Line 66:
<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="http://posr.x-road.eu">
<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">
Line 67: Line 74:
             <id:memberClass>COM</id:memberClass>
             <id:memberClass>COM</id:memberClass>
             <id:memberCode>00000000</id:memberCode>
             <id:memberCode>00000000</id:memberCode>
             <id:subsystemCode>XX</id:subsystemCode>
             <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 74: Line 81:
             <id:memberCode>10256137</id:memberCode>
             <id:memberCode>10256137</id:memberCode>
             <id:subsystemCode>POSR</id:subsystemCode>
             <id:subsystemCode>POSR</id:subsystemCode>
             <id:serviceCode>getSubjectData</id:serviceCode>
             <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:getSubjectDataResponse>
         <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_identifiers.xsd">
                          xmlns:cid="http://www.krediidiinfo.ee/schemas/positive_register/credit/v1/identifiers.xsd">
    <consumer_credit>
<rep:consumer_credits>
<cid:type code="O">Other</cid:type>
                    <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:begin_date>2016-07-14</cid:begin_date>
<cid:end_date>2017-07-14</cid:end_date>
<cid:end_date>2017-07-14</cid:end_date>
Line 99: Line 108:
<cid:schedule_payments>
<cid:schedule_payments>
    <cid:schedule_payment>
    <cid:schedule_payment>
<cid:due_date>2016-10-22</cid:due_date>
        <cid:due_date>2016-10-22</cid:due_date>
<cid:sum>100.0</cid:sum>
<cid:sum>100.0</cid:sum>
    </cid:schedule_payment>
    </cid:schedule_payment>
    <cid:schedule_payment>
          </cid:schedule_payments>
<cid:due_date>2017-01-30</cid:due_date>
                        <cid:subjects>
<cid:sum>100.0</cid:sum>
    <cid:subject>
    </cid:schedule_payment>
        <cid:ident_code>00000000000</cid:ident_code>
</cid:schedule_payments>
        <cid:role>
<cid:subject>
                                    <cid:code>BRW</cid:code>
    <cid:ident_code>48508060269</cid:ident_code>
                                    <cid:name>Krediidivõtja</cid:name>
    <cid:role code="GRT">Guarantor</cid:role>
                                </cid:role>
</cid:subject>
    </cid:subject>
<cid:update_datetime>1970-01-01T03:00:00</cid:update_datetime>
                        </cid:subjects>
    </consumer_credit>
<cid:update_datetime>2017-01-01T03:00:00</cid:update_datetime>
</consumer_credits>
    </rep:consumer_credit>
<requests xmlns:cid="http://www.krediidiinfo.ee/schemas/positive_register/credit_identifiers.xsd">
                </rep:consumer_credits>
    <request>
<rep:inquiries>
<cid:datetime>2016-08-10T09:01:38</cid:datetime>
                    <rep:inquiry>
    </request>
                        <cid:datetime>2017-01-02T08:17:30</cid:datetime>
    <request>
                    </rep:inquiry>
<cid:datetime>2016-08-15T09:55:56</cid:datetime>
</rep:inquiries>
    </request>
            </credit_report>
</requests>
            <posr:fault xsi:nil="true"/>
          </subject_positive_data>
         </posr:getCreditReportResponse>
          <fault xsi:nil="true"/>
         </kri:getSubjectDataResponse>
     </SOAP-ENV:Body>
     </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</SOAP-ENV:Envelope>
Line 131: Line 138:
= Teenused =
= Teenused =


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


Krediiditaotleja andmete pärimine Osalejate andmekogudest.
== '''generateConsent.v1''' ==
Nõusoleku dokumendi koostamine krediiditaotleja krediidikohustuste kohta andmete pärimiseks ja edastamine päringut teinud Osalejale. Nõusoleku dokument on pdf formaadis.


=== 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]]
 
== '''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]]


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


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


=== Päringu soap ümbriku keha parameetrid ===
=== Päringu soap ümbriku keha parameetrid ===
Line 161: Line 179:


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


=== Päringu soap ümbriku keha parameetrid ===
=== Päringu soap ümbriku keha parameetrid ===
Line 174: Line 193:


== '''deleteCredit.v1''' ==
== '''deleteCredit.v1''' ==
Ühe tarbijakrediidi andmete kustutamine.
 
Ühe tarbijakrediidi andmete kustutamine andmevahetussüsteemi andmebaasist.


=== Päringu soap ümbriku keha parameetrid ===
=== Päringu soap ümbriku keha parameetrid ===
Line 187: Line 207:


== '''uploadCreditsMtom.v1''' ==
== '''uploadCreditsMtom.v1''' ==
Kõigi kehtivate tarbijakrediitide andmete sisseimportimine.
 
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 215: Line 236:


<?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="http://posr.x-road.eu"
                  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>COM</id:memberClass>
            <id:subsystenCode>TEST</id:subsystenCode>
        <id:memberCode>00000000</id:memberCode>
        </xrd:client>
        <id:subsystemCode>XX</id:subsystemCode>
        <xrd:service id:objectType="SERVICE">
    </xrd:client>
            <id:xRoadInstance>ee</id:xRoadInstance>
    <xrd:service id:objectType="SERVICE">
            <id:memberClass>COM</id:memberClass>
        <id:xRoadInstance>ee</id:xRoadInstance>
            <id:memberCode>10256137</id:memberCode>
        <id:memberClass>COM</id:memberClass>
            <id:subsystemCode>POSR</id:subsystemCode>
        <id:memberCode>10256137</id:memberCode>
            <id:serviceCode>uploadCreditsMtom</id:serviceCode>
        <id:subsystemCode>POSR</id:subsystemCode>
            <id:serviceVersion>v1</id:serviceVersion>
        <id:serviceCode>uploadCreditsMtom</id:serviceCode>
        </xrd:service>
        <id:serviceVersion>v1</id:serviceVersion>
        <xrd:id>test</xrd:id>
    </xrd:service>
        <xrd:userId>EE00000000000</xrd:userId>
    <xrd:id>4894e35d-bf0f-44a6-867a-8e51f1daa7e0</xrd:id>
        <xrd:protocolVersion>4.0</xrd:protocolVersion>
    <xrd:userId>EE00000000000</xrd:userId>
    </SOAP-ENV:Header>
    <xrd:protocolVersion>4.0</xrd:protocolVersion>
    <SOAP-ENV:Body>
</SOAP-ENV:Header>
        <posr:uploadCreditsMtom>
<SOAP-ENV:Body>
            <positive_data>
    <ns1:uploadCreditsMtom>
                <inc:Include href="cid:xxx"/>
        <positive_data>
            </positive_data>
            <inc:Include href="cid:xxx"/>
        </posr:uploadCreditsMtom>
        </positive_data>
    </SOAP-ENV:Body>
    </ns1:uploadCreditsMtom>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</SOAP-ENV:Envelope>


Line 266: Line 285:


== '''getUploadStatus.v1''' ==
== '''getUploadStatus.v1''' ==
Üleslaetud kõigi kehtivate tarbijakrediitide andmete alusel tekitatud faili töötlemise staatuse pärimine.
 
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 282: Line 302:
<?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/">
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
    <SOAP-ENV:Body>
<SOAP-ENV:Fault>
        <SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Server</faultcode>
            <faultcode>SOAP-ENV:Server</faultcode>
<faultstring>Veateade</faultstring>
            <faultstring>Internal service error</faultstring>
<faultactor/>
            <faultactor/>
<detail>
            <detail>
<faultCode>0</faultCode>
                <faultCode>-50200</faultCode>
<faultString>Veateade</faultString>
                <faultString>Internal service error</faultString>
</detail>
            </detail>
</SOAP-ENV:Fault>
        </SOAP-ENV:Fault>
</SOAP-ENV:Body>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</SOAP-ENV:Envelope>
</pre>
</pre>


= Veakoodid =
= Veakoodid =
Line 321: Line 340:
   <tr>
   <tr>
     <td></td>
     <td></td>
     <td>Vigane päring</td>
     <td>Vigane päringu formaat või sisu</td>
   </tr>
   </tr>
   <tr>
   <tr>
Line 329: Line 348:
   <tr>
   <tr>
     <td></td>
     <td></td>
     <td>Puudub liigipääs süsteemile</td>
     <td>Kasutajal puudub liigipääs süsteemile</td>
   </tr>
   </tr>
   <tr>
   <tr>
Line 338: Line 357:
     <td></td>
     <td></td>
     <td>Päringu vastus sisaldab osalisi andmeid.</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 ebaõnnestus</td>
   </tr>
   </tr>
</table>
</table>


= Lingid =  
= Lingid =  
[[Positiivne_register: funktsionaalne_spetsifikatsioon | Funktsionaalne spetsifikatsioon]]
[[Positiivne_register: funktsionaalne_spetsifikatsioon | Funktsionaalne spetsifikatsioon]]

Revision as of 14:24, 19 January 2017

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. POSR teenuste kasutamine eeldab, et osaleja on liitunud X-teega.

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

Nõusoleku dokumendi koostamine krediiditaotleja krediidikohustuste kohta andmete pärimiseks ja edastamine päringut teinud Osalejale. Nõusoleku dokument on pdf formaadis.

Päringu soap ümbriku keha parameetrid

GenerateConsentReq.png

Vastuse soap ümbriku keha parameetrid

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

insertCredit.v1

Ühe tarbijakrediidi andmete registreerimine andmevahetussüsteemi andmebaasis.

Päringu soap ümbriku keha parameetrid

AddSubjectPositiveData


Vastuse soap ümbriku keha parameetrid

AddSubjectPositiveDataResponse


updateCredit.v1

Ühe tarbijakrediidi andmete uuendamine andmevahetussüsteemi andmebaasis.

Päringu soap ümbriku keha parameetrid

UpdateSubjectPositiveData


Vastuse soap ümbriku keha parameetrid

UpdateSubjectPositiveDataResponse


deleteCredit.v1

Ühe tarbijakrediidi andmete kustutamine andmevahetussüsteemi andmebaasist.

Päringu soap ümbriku keha parameetrid

DeleteSubjectPositiveData


Vastuse soap ümbriku keha parameetrid

DeleteSubjectPositiveDataResponse


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

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

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 Unknown error
Tundmatu viga
-50201 Internal error
Serverisse tekkis sisemine viga
-50202 Invalid request
Vigane päringu formaat või sisu
-50203 Access denied
Kasutajal puudub liigipääs süsteemile
-50204 Partial data
Päringu vastus sisaldab osalisi andmeid.
-50250 Credit data sync failed
Tarbijakrediidi andmete sünkroniseerimine ebaõnnestus

Lingid

Funktsionaalne spetsifikatsioon