Andmevahetussüsteemi X-tee liides: Difference between revisions

From services.krediidiinfo.ee
Jump to navigation Jump to search
No edit summary
No edit summary
Line 119: Line 119:
Krediiditaotleja andmete pärimine Osalejate andmekogudest.
Krediiditaotleja andmete pärimine Osalejate andmekogudest.


=== Päringu sõnum ===
=== Päring ===


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




=== Vastuse sõnum ===
=== Vastus ===


[[File:GetSubjectPositiveDataResponse.png | GetSubjectPositiveDataResponse]]
[[File:GetSubjectPositiveDataResponse.png | GetSubjectPositiveDataResponse]]
Line 133: Line 133:
Ühe tarbijakrediidi andmete registreerimine.
Ühe tarbijakrediidi andmete registreerimine.


=== Päringu sõnum ===
=== Päring ===


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




=== Vastuse sõnum ===
=== Vastus ===


[[File:AddSubjectPositiveDataResponse.png | AddSubjectPositiveDataResponse]]
[[File:AddSubjectPositiveDataResponse.png | AddSubjectPositiveDataResponse]]
Line 147: Line 147:
Ühe tarbijakrediidi andmete uuendamine.
Ühe tarbijakrediidi andmete uuendamine.


=== Päringu sõnum ===
=== Päring ===


[[File:UpdateSubjectPositiveData.png | UpdateSubjectPositiveData]]
[[File:UpdateSubjectPositiveData.png | UpdateSubjectPositiveData]]




=== Vastuse sõnum ===
=== Vastus ===


[[File:UpdateSubjectPositiveDataResponse.png | UpdateSubjectPositiveDataResponse]]
[[File:UpdateSubjectPositiveDataResponse.png | UpdateSubjectPositiveDataResponse]]
Line 160: Line 160:
Ühe tarbijakrediidi andmete kustutamine.
Ühe tarbijakrediidi andmete kustutamine.


=== Päringu sõnum ===
=== Päring ===


[[File:DeleteSubjectPositiveData.png | DeleteSubjectPositiveData]]
[[File:DeleteSubjectPositiveData.png | DeleteSubjectPositiveData]]




=== Vastuse sõnum ===
=== Vastus ===


[[File:DeleteSubjectPositiveDataResponse.png | DeleteSubjectPositiveDataResponse]]
[[File:DeleteSubjectPositiveDataResponse.png | DeleteSubjectPositiveDataResponse]]
Line 173: Line 173:
Kõigi kehtivate tarbijakrediitide andmete sisseimportimine.
Kõigi kehtivate tarbijakrediitide andmete sisseimportimine.


=== Päringu sõnum ===
=== 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 [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 [http://www.krediidiinfo.ee/schemas/positive_register/data_exchange.xsd http://www.krediidiinfo.ee/schemas/positive_register/data_exchange.xsd].  
Line 242: Line 242:
</pre>
</pre>


=== Vastuse sõnum ===  
=== Vastus ===  


[[File:UploadPositiveDataMtomResponse.png | UploadPositiveDataMtomResponse]]
[[File:UploadPositiveDataMtomResponse.png | UploadPositiveDataMtomResponse]]
Line 249: Line 249:
Üleslaetud kõigi kehtivate tarbijakrediitide andmete alusel tekitatud faili töötlemise staatuse pärimine.
Üleslaetud kõigi kehtivate tarbijakrediitide andmete alusel tekitatud faili töötlemise staatuse pärimine.


=== Päringu sõnum ===
=== Päring ===


[[File:UploadPositiveDataStatus.png | UploadPositiveDataStatus]]
[[File:UploadPositiveDataStatus.png | UploadPositiveDataStatus]]




=== Vastuse sõnum ===
=== Vastus ===


[[File:UploadPositiveDataStatusResponse.png | UploadPositiveDataStatusResponse]]
[[File:UploadPositiveDataStatusResponse.png | UploadPositiveDataStatusResponse]]

Revision as of 12:54, 10 August 2016

Tutvustus

KRI6 on Krediidiinfo liides, mille vahendusel Osalejad vahetavad krediiditaotleja krediidikohustuste andmeid omavahel X-tee versioon 6 vahendusel. See spetsifikatsioon kirjeldab andmete vahetuse tehnilisi aspekte. KRI6 teenuste kasutamine eeldab, et osaleja on liitunud X-teega.

WSDL

KRI6 WSDL asub aadresslil https://services.krediidiinfo.ee/wsdl/kri6.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:kri="urn:kri6">
    <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>10256137</id:memberCode>
        </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:serviceCode>getSubjectPositiveData</id:serviceCode>
            <id:serviceVersion>v1</id:serviceVersion>
        </xrd:service>
        <xrd:id xmlns:xrd="http://x-road.eu/xsd/xroad.xsd">5734440e50c71</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>
    </SOAP-ENV:Header>
    <SOAP-ENV:Body>
       <kri:getSubjectPositiveData>
            <subject>
                <ident_code>00000000000</ident_code>
            </subject>
            <is_digi_agreement>1</is_digi_agreement>
            <lang>en</lang>
        </kri:getSubjectPositiveData>
    </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:kri="urn:kri6">
    <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>10256137</id:memberCode>
        </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:serviceCode>getSubjectPositiveData</id:serviceCode>
            <id:serviceVersion>v1</id:serviceVersion>
        </xrd:service>
        <xrd:id xmlns:xrd="http://x-road.eu/xsd/xroad.xsd">5734440e50c71</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">
            RglGFiBmbZJ0JLwm+vzfGn4fQEIY1YfM81H3SekOw5VnwxO/jilTfHG0zgsaUH9LzLOCqb5YssDz0MbMzm3DhQ==
        </xrd:requestHash>
    </SOAP-ENV:Header>
    <SOAP-ENV:Body>
        <kri:getSubjectPositiveDataResponse>
            <subject_positive_data>
                <consumer_credits>
                    <consumer_credit>
                        <type code="O">Other</type>
                        <begin_date>2016-07-14</begin_date>
                        <end_date>2017-07-14</end_date>
                        <total_sum>200</total_sum>
                        <balance>200</balance>
                        <unpaid_sum>7</unpaid_sum>
                        <currency>EUR</currency>
                        <schedule_payments>
                            <schedule_payment>
                                <due_date>2016-10-22</due_date>
                                <sum>100.0</sum>
                            </schedule_payment>
                        </schedule_payments>
                        <subject>
                            <ident_code>48508060269</ident_code>
                            <role code="GRT">Guarantor</role>
                        </subject>
                        <update_datetime>2016-01-01 03:00:00</update_datetime>
                   </consumer_credit>
              </consumer_credits>
              <requests/>
           </subject_positive_data>
           <fault xsi:nil="true"/>
        </kri:getSubjectPositiveDataResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Teenused

getSubjectPositiveData

Krediiditaotleja andmete pärimine Osalejate andmekogudest.

Päring

GetSubjectPositiveData


Vastus

GetSubjectPositiveDataResponse


addSubjectPositiveData

Ühe tarbijakrediidi andmete registreerimine.

Päring

AddSubjectPositiveData


Vastus

AddSubjectPositiveDataResponse


updateSubjectPositiveData

Ühe tarbijakrediidi andmete uuendamine.

Päring

UpdateSubjectPositiveData


Vastus

UpdateSubjectPositiveDataResponse


deleteSubjectPositiveData

Ühe tarbijakrediidi andmete kustutamine.

Päring

DeleteSubjectPositiveData


Vastus

DeleteSubjectPositiveDataResponse


uploadPositiveDataMtom

Kõigi kehtivate tarbijakrediitide andmete sisseimportimine.

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 http://www.krediidiinfo.ee/schemas/positive_register/data_exchange.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:ns1="urn:kri6"
    xmlns:xrd="http://x-road.eu/xsd/xroad.xsd"
    xmlns:id="http://x-road.eu/xsd/identifiers"
    xmlns:inc="http://www.w3.org/2004/08/xop/include">
<SOAP-ENV:Header>
    <xrd:client id:objectType="MEMBER">
        <id:xRoadInstance>EE</id:xRoadInstance>
        <id:memberClass>XX</id:memberClass>
        <id:memberCode>00000000</id:memberCode>
    </xrd:client>
    <xrd:service id:objectType="SERVICE">
        <id:xRoadInstance>EE</id:xRoadInstance>
        <id:memberClass>XX</id:memberClass>
        <id:memberCode>10256137</id:memberCode>
        <id:serviceCode>uploadPositiveDataMtom</id:serviceCode>
        <id:serviceVersion>v1</id:serviceVersion>
    </xrd:service>
    <xrd:id>4894e35d-bf0f-44a6-867a-8e51f1daa7e0</xrd:id>
    <xrd:userId>EE00000000000</xrd:userId>
    <xrd:protocolVersion>4.0</xrd:protocolVersion>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
    <ns1:uploadPositiveDataMtom>
        <positive_data>
            <inc:Include href="cid:xxx"/>
        </positive_data>
    </ns1:uploadPositiveDataMtom>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

--MIME_boundary
Content-Type: application/octet-stream
Content-Transfer-Encoding: base64
Content-ID: <xxx>
Content-Disposition: attachment;

ZZZ

--MIME_boundary--

Vastus

UploadPositiveDataMtomResponse

uploadPositiveDataStatus

Üleslaetud kõigi kehtivate tarbijakrediitide andmete alusel tekitatud faili töötlemise staatuse pärimine.

Päring

UploadPositiveDataStatus


Vastus

UploadPositiveDataStatusResponse

Veakoodid

X Request failed
Päringu tegemine ebaõnnestus
X Access denied
Puudub liigipääs süsteemile
X Partial members
Päring sisaldab mitte kõiki Osalejate Andmekogudest Andmeid. Veakirjelduses on toodud Osalejate arv, kelle andmekogudest Andmete pärimine ebaõnnestus.
Retrieved from "https://services.krediidiinfo.ee/wiki/index.php?title=Andmevahetussüsteemi_X-tee_liides&oldid=681"