https://services.krediidiinfo.ee/wiki/api.php?action=feedcontributions&feedformat=atom&user=Kart
services.krediidiinfo.ee - User contributions [en]
2026-04-28T23:37:02Z
User contributions
MediaWiki 1.39.5
https://services.krediidiinfo.ee/wiki/index.php?title=KiDocExchange&diff=878
KiDocExchange
2017-03-20T13:58:34Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[KiDocExchange__en|In English]]<br />
|}<br />
<br />
= Tutvustus = <br />
<br />
KiDocExchange on Creditinfo veebiteenus failide saatmiseks ja vastuvõtmiseks.<br />
<br />
= Failide edastamine ja vastuvõtmine=<br />
<br />
<br />
Faile saab Creditinfole edastada ja ka vastu võtta [[KiDocExchange]] SOAP liidese kaudu. <br />
<br />
<br />
Creditinfosse saadetava faili nimi peab olema kujul:<br />
<br />
<pre><br />
req_<Creditinfo_toote_kood>_<kliendi_faili_id>.xml.zip<br />
</pre><br />
<br />
<br />
* <Creditinfo_toote_kood> - Creditinfoga kokkulepitud toode, mille alusel koostatakse vastus fail.<br />
* <kliendi_faili_id> - kliendi poolt määratud unikaalne id, millega eristatakse faile üksteisest. Näiteks faili genereerimise aeg.<br />
<br />
Creditinfo vastusfaili kuju:<br />
<pre><br />
resp_<Creditinfo_toote_kood>_<kliendi_faili_id>.zip<br />
</pre><br />
<br />
* <Creditinfo_toote_kood> - Creditinfoga kokkulepitud toode, mille alusel koostatakse vastus fail.<br />
* <kliendi_faili_id> - kliendi poolt määratud unikaalne id, millega eristatakse faile üksteisest. Näiteks faili genereerimise aeg.<br />
<br />
= WSDL = <br />
<br />
KiDocExchange veebiteenuse WSDL fail on aadressil [http://services.krediidiinfo.ee/KiDocExchange.wsdl http://services.krediidiinfo.ee/KiDocExchange.wsdl].<br />
<br />
<br />
= Järgnevusdiagramm =<br />
<br />
Järgnevusdiagrammil on näidatud KiDocExchange meetodite väljakutsumise järjekorrad faili üles laadimisel.<br />
<br />
[[Image:KiDocExchange_Upload_Sequence_Diagram.jpg]]<br />
<br />
ja alla laadimisel <br />
<br />
[[Image:Download_diagram.png]]<br />
<br />
<br />
Alla laetavate failide nimekirja saab pärida funkstiooniga getDownloadQueue(). Kord alla laetud fail kaob nimekirjast, aga faili ID säilitamisel saab faili alla laadida ka hiljem.<br />
<br />
== Meetodid ==<br />
<br />
<br />
=== startUpload ===<br />
<br />
Failide üleslaadimise initsialiseerimine.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameeter:</b> <br />
| fileName<br />
| xs:string<br />
| Faili nimi<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| docID<br />
| xs:integer<br />
| Unikaalne faili id Creditinfo serveris.<br />
|}<br />
<br />
<br />
=== uploadChunk ===<br />
<br />
Laetakse serverisse ning lisatakse juba serveris olevale failile lõppu osa failist. Kliendid võivad kogu faili saata ka ühe osana. Failide jupitamist on soovitav kasutada desktop lahendustes suurte failide saatmisel.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator.<br />
|-<br />
|<br />
| chunk<br />
| xs:base64Binary<br />
| Järgmine faili osa.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
|<br />
|<br />
| None<br />
|}<br />
<br />
<br />
=== finishUpload ===<br />
<br />
Faili üleslaadimise lõpetamine.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator<br />
|-<br />
|<br />
| md5<br />
| xs:string<br />
| Üles laetud faili MD5 kontrollsumma.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| errorCode<br />
| xs:integer<br />
| Kui 0, siis faili üleslaadimine õnnestus. Kui negatiivne, siis tekkis mingi viga (vt veakoodide).<br />
|}<br />
<br />
<br />
=== downloadChunk ===<br />
<br />
Faili alamosa allalaadimine Creditinfo failiserverist.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator<br />
|-<br />
|<br />
| start<br />
| xs:integer<br />
| Positsioon failis, millest alates andmeid alla laetakse (positsiooni lugemine algab nullist)<br />
|-<br />
| <br />
| count<br />
| xs:integer<br />
| Alla laetava tüki suurus baitides.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| chunk<br />
| xs:base64Binary<br />
| Faili alamosa<br />
|}<br />
<br />
<br />
=== getDownloadQueue ===<br />
<br />
Creditinfo serveris kliendi poolt allalaadimist ootavate failide loetelu.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| queue<br />
| DownloadQueueArray<br />
| Massiiv DownloadQueueType tüüpi elementidest<br />
|}<br />
<br />
<br />
DownloadQueueType on assiotsiatiivne massiiv, millel on järgmised elemendid:<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| docID<br />
| xs:integer<br />
| faili id<br />
|-<br />
| fileName<br />
| xs:string<br />
| faili nimi<br />
|}<br />
<br />
<br />
=== getStatusCode ===<br />
<br />
Tagastatakse üles laetud faili staatus serveris.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! colspan="2" style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameeter:</b><br />
| docID<br />
| xs:integer<br />
| colspan="2" |Faili identifikaator<br />
|-<br />
| <b>Output Parameters:</b><br />
| status_code<br />
| xs:integer<br />
| colspan="2" | Faili staatuse kood:<br />
|-<br />
| colspan="3" |<br />
| align="right" | 0<br />
| Fail on töödeldud<br />
|-<br />
| colspan="3" |<br />
| align="right" | 2<br />
| Toimub faili üles laadimine<br />
|-<br />
| colspan="3" |<br />
| align="right" | 3<br />
| Toimub faili töötlemine<br />
|-<br />
|-<br />
| colspan="3" |<br />
| align="right" | 4<br />
| Fail on edukalt üles laetud ning ootab töötlemist<br />
|-<br />
| colspan="3" |<br />
| align="right" | -1<br />
| Tundmatu viga. Täpsema info saamiseks võtke ühendust tehnilise teoga. Rohkem infot vea teate kohta võib saada meetodiga getStatusMsg.<br />
|-|-<br />
| colspan="3" |<br />
| align="right" | -10003<br />
| MD5 kontroll ebaõnnestus. Kliendi saadetud MD5 kontrollsumma ei langenud kokku serveri poolt arvutatud MD5 kontrollsummaga.<br />
|-<br />
| colspan="3" |<br />
| align="right" | -xxxxx<br />
| Faili töötlemine ebaõnnestus. Täpsema info saamiseks võta ühendust tehnilise toega. Rohkem infot vea teate kohta võib saada meetodiga getStatusMsg.<br />
|}<br />
<br />
<br />
=== getStatusMsg ===<br />
<br />
Tagastatakse staatust täpsustav info.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameeter:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| statusMsg<br />
| xs:string<br />
| Faili staatust täpsustav info<br />
|}<br />
<br />
= Veakoodid =<br />
<br />
<table><br />
<tr><br />
<td><b>Kood</b></td><br />
<td><b>Kirjeldus</b></td><br />
</tr><br />
<tr><br />
<td>0</td><br />
<td>Success</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Päringu töötlus õnnestus.</td><br />
</tr><br />
<tr><br />
<td>-10001</td><br />
<td>Access denied</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Üritatakse pöörduda faili poole, mis kuulub kellelegi teisele.</td><br />
</tr><br />
<tr><br />
<td>-10002</td><br />
<td>File does not exists</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Kasutati faili identifikaatorit, mida ei eksisteeri.</td><br />
</tr><br />
<tr><br />
<td>-10003</td><br />
<td>MD5 failure</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Kliendi saadetud MD5 ei lange kokku serveri poolt arvutatud MD5-ga</td><br />
</tr><br />
</table><br />
<br />
<br />
= Silumine =<br />
<br />
Faili edastamiseks testserverisse tuleb lisada parameeter ''debug'' serveri aadressile, ehk 'https://services.krediidiinfo.ee/soap.php?name=KiDocExchange&debug'<br />
<br />
= Näidis PHP-s =<br />
<br />
Programm laeb faili Creditinfo serverisse ning seejärel laeb sama faili alla. Lõpus kontrollitakse, kas üles ja alla laetud faili sisu on sama. Programmi põhimõte sobib KiDocExchange liidese testimiseks. Kui soovite maksehäire sisestamiseks mõeldud faili testida siis ärge kasutage silumismoodi.<br />
<br />
<pre><br />
<?php<br />
/**<br />
* Example of uploading and downloading files using KiDocExchange interface.<br />
* @author Rait Kapp <rait@creditinfo.ee><br />
* @created 27.04.2007<br />
*/<br />
$wsdl_url = 'http://services.krediidiinfo.ee/KiDocExchange.wsdl';<br />
$params = array('location' => 'https://services.krediidiinfo.ee/soap.php?name=KiDocExchange&debug'<br />
, 'login' => 'username' // <-- username. Make sure username is string type (PHP bug?).<br />
, 'password' => 'password' // <-- password<br />
);<br />
<br />
$client = new SoapClient($wsdl_url, $params);<br />
<br />
// Uploading file.<br />
$content = 'I am a little test file!';<br />
$docID = $client->startUpload('test.txt');<br />
$client->uploadChunk($docID, $content); <br />
<br />
$md5 = md5($content);<br />
$result = $client->finishUpload($docID, $md5);<br />
if ($result != 0) {<br />
die("upload failed.! Error code: {$result}\n");<br />
}<br />
<br />
// Downloading file<br />
$start = 0;<br />
$count = 512; // can be a big number if you do not have to display download progress.<br />
$data = '';<br />
while ($chunk = $client->downloadChunk($docID, $start, $count)) {<br />
$start += $count;<br />
$data .= $chunk;<br />
}<br />
<br />
if ($content != $data) {<br />
echo "Something is not right!\n";<br />
} else {<br />
echo "We got back: {$data}\n";<br />
}<br />
<br />
?><br />
</pre></div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=KiDocExchange&diff=877
KiDocExchange
2017-03-20T13:58:16Z
<p>Kart: /* Tutvustus */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[KiDocExchange__en|In English]]<br />
|}<br />
<br />
= Tutvustus = <br />
<br />
KiDocExchange on Creditinfo veebiteenus failide saatmiseks ja vastuvõtmiseks.<br />
<br />
= Failide edastamine =<br />
<br />
<br />
Faile saab Creditinfole edastada ja ka vastu võtta [[KiDocExchange]] SOAP liidese kaudu. <br />
<br />
<br />
Creditinfosse saadetava faili nimi peab olema kujul:<br />
<br />
<pre><br />
req_<Creditinfo_toote_kood>_<kliendi_faili_id>.xml.zip<br />
</pre><br />
<br />
<br />
* <Creditinfo_toote_kood> - Creditinfoga kokkulepitud toode, mille alusel koostatakse vastus fail.<br />
* <kliendi_faili_id> - kliendi poolt määratud unikaalne id, millega eristatakse faile üksteisest. Näiteks faili genereerimise aeg.<br />
<br />
Creditinfo vastusfaili kuju:<br />
<pre><br />
resp_<Creditinfo_toote_kood>_<kliendi_faili_id>.zip<br />
</pre><br />
<br />
* <Creditinfo_toote_kood> - Creditinfoga kokkulepitud toode, mille alusel koostatakse vastus fail.<br />
* <kliendi_faili_id> - kliendi poolt määratud unikaalne id, millega eristatakse faile üksteisest. Näiteks faili genereerimise aeg.<br />
<br />
= WSDL = <br />
<br />
KiDocExchange veebiteenuse WSDL fail on aadressil [http://services.krediidiinfo.ee/KiDocExchange.wsdl http://services.krediidiinfo.ee/KiDocExchange.wsdl].<br />
<br />
<br />
= Järgnevusdiagramm =<br />
<br />
Järgnevusdiagrammil on näidatud KiDocExchange meetodite väljakutsumise järjekorrad faili üles laadimisel.<br />
<br />
[[Image:KiDocExchange_Upload_Sequence_Diagram.jpg]]<br />
<br />
ja alla laadimisel <br />
<br />
[[Image:Download_diagram.png]]<br />
<br />
<br />
Alla laetavate failide nimekirja saab pärida funkstiooniga getDownloadQueue(). Kord alla laetud fail kaob nimekirjast, aga faili ID säilitamisel saab faili alla laadida ka hiljem.<br />
<br />
== Meetodid ==<br />
<br />
<br />
=== startUpload ===<br />
<br />
Failide üleslaadimise initsialiseerimine.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameeter:</b> <br />
| fileName<br />
| xs:string<br />
| Faili nimi<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| docID<br />
| xs:integer<br />
| Unikaalne faili id Creditinfo serveris.<br />
|}<br />
<br />
<br />
=== uploadChunk ===<br />
<br />
Laetakse serverisse ning lisatakse juba serveris olevale failile lõppu osa failist. Kliendid võivad kogu faili saata ka ühe osana. Failide jupitamist on soovitav kasutada desktop lahendustes suurte failide saatmisel.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator.<br />
|-<br />
|<br />
| chunk<br />
| xs:base64Binary<br />
| Järgmine faili osa.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
|<br />
|<br />
| None<br />
|}<br />
<br />
<br />
=== finishUpload ===<br />
<br />
Faili üleslaadimise lõpetamine.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator<br />
|-<br />
|<br />
| md5<br />
| xs:string<br />
| Üles laetud faili MD5 kontrollsumma.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| errorCode<br />
| xs:integer<br />
| Kui 0, siis faili üleslaadimine õnnestus. Kui negatiivne, siis tekkis mingi viga (vt veakoodide).<br />
|}<br />
<br />
<br />
=== downloadChunk ===<br />
<br />
Faili alamosa allalaadimine Creditinfo failiserverist.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator<br />
|-<br />
|<br />
| start<br />
| xs:integer<br />
| Positsioon failis, millest alates andmeid alla laetakse (positsiooni lugemine algab nullist)<br />
|-<br />
| <br />
| count<br />
| xs:integer<br />
| Alla laetava tüki suurus baitides.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| chunk<br />
| xs:base64Binary<br />
| Faili alamosa<br />
|}<br />
<br />
<br />
=== getDownloadQueue ===<br />
<br />
Creditinfo serveris kliendi poolt allalaadimist ootavate failide loetelu.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| queue<br />
| DownloadQueueArray<br />
| Massiiv DownloadQueueType tüüpi elementidest<br />
|}<br />
<br />
<br />
DownloadQueueType on assiotsiatiivne massiiv, millel on järgmised elemendid:<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| docID<br />
| xs:integer<br />
| faili id<br />
|-<br />
| fileName<br />
| xs:string<br />
| faili nimi<br />
|}<br />
<br />
<br />
=== getStatusCode ===<br />
<br />
Tagastatakse üles laetud faili staatus serveris.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! colspan="2" style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameeter:</b><br />
| docID<br />
| xs:integer<br />
| colspan="2" |Faili identifikaator<br />
|-<br />
| <b>Output Parameters:</b><br />
| status_code<br />
| xs:integer<br />
| colspan="2" | Faili staatuse kood:<br />
|-<br />
| colspan="3" |<br />
| align="right" | 0<br />
| Fail on töödeldud<br />
|-<br />
| colspan="3" |<br />
| align="right" | 2<br />
| Toimub faili üles laadimine<br />
|-<br />
| colspan="3" |<br />
| align="right" | 3<br />
| Toimub faili töötlemine<br />
|-<br />
|-<br />
| colspan="3" |<br />
| align="right" | 4<br />
| Fail on edukalt üles laetud ning ootab töötlemist<br />
|-<br />
| colspan="3" |<br />
| align="right" | -1<br />
| Tundmatu viga. Täpsema info saamiseks võtke ühendust tehnilise teoga. Rohkem infot vea teate kohta võib saada meetodiga getStatusMsg.<br />
|-|-<br />
| colspan="3" |<br />
| align="right" | -10003<br />
| MD5 kontroll ebaõnnestus. Kliendi saadetud MD5 kontrollsumma ei langenud kokku serveri poolt arvutatud MD5 kontrollsummaga.<br />
|-<br />
| colspan="3" |<br />
| align="right" | -xxxxx<br />
| Faili töötlemine ebaõnnestus. Täpsema info saamiseks võta ühendust tehnilise toega. Rohkem infot vea teate kohta võib saada meetodiga getStatusMsg.<br />
|}<br />
<br />
<br />
=== getStatusMsg ===<br />
<br />
Tagastatakse staatust täpsustav info.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameeter:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| statusMsg<br />
| xs:string<br />
| Faili staatust täpsustav info<br />
|}<br />
<br />
= Veakoodid =<br />
<br />
<table><br />
<tr><br />
<td><b>Kood</b></td><br />
<td><b>Kirjeldus</b></td><br />
</tr><br />
<tr><br />
<td>0</td><br />
<td>Success</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Päringu töötlus õnnestus.</td><br />
</tr><br />
<tr><br />
<td>-10001</td><br />
<td>Access denied</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Üritatakse pöörduda faili poole, mis kuulub kellelegi teisele.</td><br />
</tr><br />
<tr><br />
<td>-10002</td><br />
<td>File does not exists</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Kasutati faili identifikaatorit, mida ei eksisteeri.</td><br />
</tr><br />
<tr><br />
<td>-10003</td><br />
<td>MD5 failure</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Kliendi saadetud MD5 ei lange kokku serveri poolt arvutatud MD5-ga</td><br />
</tr><br />
</table><br />
<br />
<br />
= Silumine =<br />
<br />
Faili edastamiseks testserverisse tuleb lisada parameeter ''debug'' serveri aadressile, ehk 'https://services.krediidiinfo.ee/soap.php?name=KiDocExchange&debug'<br />
<br />
= Näidis PHP-s =<br />
<br />
Programm laeb faili Creditinfo serverisse ning seejärel laeb sama faili alla. Lõpus kontrollitakse, kas üles ja alla laetud faili sisu on sama. Programmi põhimõte sobib KiDocExchange liidese testimiseks. Kui soovite maksehäire sisestamiseks mõeldud faili testida siis ärge kasutage silumismoodi.<br />
<br />
<pre><br />
<?php<br />
/**<br />
* Example of uploading and downloading files using KiDocExchange interface.<br />
* @author Rait Kapp <rait@creditinfo.ee><br />
* @created 27.04.2007<br />
*/<br />
$wsdl_url = 'http://services.krediidiinfo.ee/KiDocExchange.wsdl';<br />
$params = array('location' => 'https://services.krediidiinfo.ee/soap.php?name=KiDocExchange&debug'<br />
, 'login' => 'username' // <-- username. Make sure username is string type (PHP bug?).<br />
, 'password' => 'password' // <-- password<br />
);<br />
<br />
$client = new SoapClient($wsdl_url, $params);<br />
<br />
// Uploading file.<br />
$content = 'I am a little test file!';<br />
$docID = $client->startUpload('test.txt');<br />
$client->uploadChunk($docID, $content); <br />
<br />
$md5 = md5($content);<br />
$result = $client->finishUpload($docID, $md5);<br />
if ($result != 0) {<br />
die("upload failed.! Error code: {$result}\n");<br />
}<br />
<br />
// Downloading file<br />
$start = 0;<br />
$count = 512; // can be a big number if you do not have to display download progress.<br />
$data = '';<br />
while ($chunk = $client->downloadChunk($docID, $start, $count)) {<br />
$start += $count;<br />
$data .= $chunk;<br />
}<br />
<br />
if ($content != $data) {<br />
echo "Something is not right!\n";<br />
} else {<br />
echo "We got back: {$data}\n";<br />
}<br />
<br />
?><br />
</pre></div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=KiDocExchange&diff=876
KiDocExchange
2017-03-20T13:57:47Z
<p>Kart: /* Failide edastamine */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[KiDocExchange__en|In English]]<br />
|}<br />
<br />
= Tutvustus = <br />
<br />
KiDocExchange on Creditinfo veebiteenus failide saatmiseks Creditinfosse. <br />
<br />
= Failide edastamine =<br />
<br />
<br />
Faile saab Creditinfole edastada ja ka vastu võtta [[KiDocExchange]] SOAP liidese kaudu. <br />
<br />
<br />
Creditinfosse saadetava faili nimi peab olema kujul:<br />
<br />
<pre><br />
req_<Creditinfo_toote_kood>_<kliendi_faili_id>.xml.zip<br />
</pre><br />
<br />
<br />
* <Creditinfo_toote_kood> - Creditinfoga kokkulepitud toode, mille alusel koostatakse vastus fail.<br />
* <kliendi_faili_id> - kliendi poolt määratud unikaalne id, millega eristatakse faile üksteisest. Näiteks faili genereerimise aeg.<br />
<br />
Creditinfo vastusfaili kuju:<br />
<pre><br />
resp_<Creditinfo_toote_kood>_<kliendi_faili_id>.zip<br />
</pre><br />
<br />
* <Creditinfo_toote_kood> - Creditinfoga kokkulepitud toode, mille alusel koostatakse vastus fail.<br />
* <kliendi_faili_id> - kliendi poolt määratud unikaalne id, millega eristatakse faile üksteisest. Näiteks faili genereerimise aeg.<br />
<br />
= WSDL = <br />
<br />
KiDocExchange veebiteenuse WSDL fail on aadressil [http://services.krediidiinfo.ee/KiDocExchange.wsdl http://services.krediidiinfo.ee/KiDocExchange.wsdl].<br />
<br />
<br />
= Järgnevusdiagramm =<br />
<br />
Järgnevusdiagrammil on näidatud KiDocExchange meetodite väljakutsumise järjekorrad faili üles laadimisel.<br />
<br />
[[Image:KiDocExchange_Upload_Sequence_Diagram.jpg]]<br />
<br />
ja alla laadimisel <br />
<br />
[[Image:Download_diagram.png]]<br />
<br />
<br />
Alla laetavate failide nimekirja saab pärida funkstiooniga getDownloadQueue(). Kord alla laetud fail kaob nimekirjast, aga faili ID säilitamisel saab faili alla laadida ka hiljem.<br />
<br />
== Meetodid ==<br />
<br />
<br />
=== startUpload ===<br />
<br />
Failide üleslaadimise initsialiseerimine.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameeter:</b> <br />
| fileName<br />
| xs:string<br />
| Faili nimi<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| docID<br />
| xs:integer<br />
| Unikaalne faili id Creditinfo serveris.<br />
|}<br />
<br />
<br />
=== uploadChunk ===<br />
<br />
Laetakse serverisse ning lisatakse juba serveris olevale failile lõppu osa failist. Kliendid võivad kogu faili saata ka ühe osana. Failide jupitamist on soovitav kasutada desktop lahendustes suurte failide saatmisel.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator.<br />
|-<br />
|<br />
| chunk<br />
| xs:base64Binary<br />
| Järgmine faili osa.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
|<br />
|<br />
| None<br />
|}<br />
<br />
<br />
=== finishUpload ===<br />
<br />
Faili üleslaadimise lõpetamine.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator<br />
|-<br />
|<br />
| md5<br />
| xs:string<br />
| Üles laetud faili MD5 kontrollsumma.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| errorCode<br />
| xs:integer<br />
| Kui 0, siis faili üleslaadimine õnnestus. Kui negatiivne, siis tekkis mingi viga (vt veakoodide).<br />
|}<br />
<br />
<br />
=== downloadChunk ===<br />
<br />
Faili alamosa allalaadimine Creditinfo failiserverist.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator<br />
|-<br />
|<br />
| start<br />
| xs:integer<br />
| Positsioon failis, millest alates andmeid alla laetakse (positsiooni lugemine algab nullist)<br />
|-<br />
| <br />
| count<br />
| xs:integer<br />
| Alla laetava tüki suurus baitides.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| chunk<br />
| xs:base64Binary<br />
| Faili alamosa<br />
|}<br />
<br />
<br />
=== getDownloadQueue ===<br />
<br />
Creditinfo serveris kliendi poolt allalaadimist ootavate failide loetelu.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| queue<br />
| DownloadQueueArray<br />
| Massiiv DownloadQueueType tüüpi elementidest<br />
|}<br />
<br />
<br />
DownloadQueueType on assiotsiatiivne massiiv, millel on järgmised elemendid:<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| docID<br />
| xs:integer<br />
| faili id<br />
|-<br />
| fileName<br />
| xs:string<br />
| faili nimi<br />
|}<br />
<br />
<br />
=== getStatusCode ===<br />
<br />
Tagastatakse üles laetud faili staatus serveris.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! colspan="2" style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameeter:</b><br />
| docID<br />
| xs:integer<br />
| colspan="2" |Faili identifikaator<br />
|-<br />
| <b>Output Parameters:</b><br />
| status_code<br />
| xs:integer<br />
| colspan="2" | Faili staatuse kood:<br />
|-<br />
| colspan="3" |<br />
| align="right" | 0<br />
| Fail on töödeldud<br />
|-<br />
| colspan="3" |<br />
| align="right" | 2<br />
| Toimub faili üles laadimine<br />
|-<br />
| colspan="3" |<br />
| align="right" | 3<br />
| Toimub faili töötlemine<br />
|-<br />
|-<br />
| colspan="3" |<br />
| align="right" | 4<br />
| Fail on edukalt üles laetud ning ootab töötlemist<br />
|-<br />
| colspan="3" |<br />
| align="right" | -1<br />
| Tundmatu viga. Täpsema info saamiseks võtke ühendust tehnilise teoga. Rohkem infot vea teate kohta võib saada meetodiga getStatusMsg.<br />
|-|-<br />
| colspan="3" |<br />
| align="right" | -10003<br />
| MD5 kontroll ebaõnnestus. Kliendi saadetud MD5 kontrollsumma ei langenud kokku serveri poolt arvutatud MD5 kontrollsummaga.<br />
|-<br />
| colspan="3" |<br />
| align="right" | -xxxxx<br />
| Faili töötlemine ebaõnnestus. Täpsema info saamiseks võta ühendust tehnilise toega. Rohkem infot vea teate kohta võib saada meetodiga getStatusMsg.<br />
|}<br />
<br />
<br />
=== getStatusMsg ===<br />
<br />
Tagastatakse staatust täpsustav info.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameeter:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| statusMsg<br />
| xs:string<br />
| Faili staatust täpsustav info<br />
|}<br />
<br />
= Veakoodid =<br />
<br />
<table><br />
<tr><br />
<td><b>Kood</b></td><br />
<td><b>Kirjeldus</b></td><br />
</tr><br />
<tr><br />
<td>0</td><br />
<td>Success</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Päringu töötlus õnnestus.</td><br />
</tr><br />
<tr><br />
<td>-10001</td><br />
<td>Access denied</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Üritatakse pöörduda faili poole, mis kuulub kellelegi teisele.</td><br />
</tr><br />
<tr><br />
<td>-10002</td><br />
<td>File does not exists</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Kasutati faili identifikaatorit, mida ei eksisteeri.</td><br />
</tr><br />
<tr><br />
<td>-10003</td><br />
<td>MD5 failure</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Kliendi saadetud MD5 ei lange kokku serveri poolt arvutatud MD5-ga</td><br />
</tr><br />
</table><br />
<br />
<br />
= Silumine =<br />
<br />
Faili edastamiseks testserverisse tuleb lisada parameeter ''debug'' serveri aadressile, ehk 'https://services.krediidiinfo.ee/soap.php?name=KiDocExchange&debug'<br />
<br />
= Näidis PHP-s =<br />
<br />
Programm laeb faili Creditinfo serverisse ning seejärel laeb sama faili alla. Lõpus kontrollitakse, kas üles ja alla laetud faili sisu on sama. Programmi põhimõte sobib KiDocExchange liidese testimiseks. Kui soovite maksehäire sisestamiseks mõeldud faili testida siis ärge kasutage silumismoodi.<br />
<br />
<pre><br />
<?php<br />
/**<br />
* Example of uploading and downloading files using KiDocExchange interface.<br />
* @author Rait Kapp <rait@creditinfo.ee><br />
* @created 27.04.2007<br />
*/<br />
$wsdl_url = 'http://services.krediidiinfo.ee/KiDocExchange.wsdl';<br />
$params = array('location' => 'https://services.krediidiinfo.ee/soap.php?name=KiDocExchange&debug'<br />
, 'login' => 'username' // <-- username. Make sure username is string type (PHP bug?).<br />
, 'password' => 'password' // <-- password<br />
);<br />
<br />
$client = new SoapClient($wsdl_url, $params);<br />
<br />
// Uploading file.<br />
$content = 'I am a little test file!';<br />
$docID = $client->startUpload('test.txt');<br />
$client->uploadChunk($docID, $content); <br />
<br />
$md5 = md5($content);<br />
$result = $client->finishUpload($docID, $md5);<br />
if ($result != 0) {<br />
die("upload failed.! Error code: {$result}\n");<br />
}<br />
<br />
// Downloading file<br />
$start = 0;<br />
$count = 512; // can be a big number if you do not have to display download progress.<br />
$data = '';<br />
while ($chunk = $client->downloadChunk($docID, $start, $count)) {<br />
$start += $count;<br />
$data .= $chunk;<br />
}<br />
<br />
if ($content != $data) {<br />
echo "Something is not right!\n";<br />
} else {<br />
echo "We got back: {$data}\n";<br />
}<br />
<br />
?><br />
</pre></div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=KiDocExchange&diff=875
KiDocExchange
2017-03-20T13:56:41Z
<p>Kart: /* Failide edastamine */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[KiDocExchange__en|In English]]<br />
|}<br />
<br />
= Tutvustus = <br />
<br />
KiDocExchange on Creditinfo veebiteenus failide saatmiseks Creditinfosse. <br />
<br />
= Failide edastamine =<br />
<br />
<br />
Faile saab Creditinfole edastada ja ka vastu võtta [[KiDocExchange]] SOAP liidese kaudu. <br />
<br />
<br />
Creditinfosse saadetava faili nimi peab olema kujul:<br />
<br />
<pre><br />
req_<Creditinfo_toote_kood>_<kliendi_faili_id>.xml.zip<br />
</pre><br />
<br />
<br />
* <Creditinfo_toote_kood> - Creditinfoga kokkulepitud toode, mille alusel koostatakse vastus fail.<br />
* <kliendi_faili_id> - kliendi poolt määratud unikaalne id, millega eristatakse faile üksteisest. Näiteks faili genereerimise aeg.<br />
<br />
= WSDL = <br />
<br />
KiDocExchange veebiteenuse WSDL fail on aadressil [http://services.krediidiinfo.ee/KiDocExchange.wsdl http://services.krediidiinfo.ee/KiDocExchange.wsdl].<br />
<br />
<br />
= Järgnevusdiagramm =<br />
<br />
Järgnevusdiagrammil on näidatud KiDocExchange meetodite väljakutsumise järjekorrad faili üles laadimisel.<br />
<br />
[[Image:KiDocExchange_Upload_Sequence_Diagram.jpg]]<br />
<br />
ja alla laadimisel <br />
<br />
[[Image:Download_diagram.png]]<br />
<br />
<br />
Alla laetavate failide nimekirja saab pärida funkstiooniga getDownloadQueue(). Kord alla laetud fail kaob nimekirjast, aga faili ID säilitamisel saab faili alla laadida ka hiljem.<br />
<br />
== Meetodid ==<br />
<br />
<br />
=== startUpload ===<br />
<br />
Failide üleslaadimise initsialiseerimine.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameeter:</b> <br />
| fileName<br />
| xs:string<br />
| Faili nimi<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| docID<br />
| xs:integer<br />
| Unikaalne faili id Creditinfo serveris.<br />
|}<br />
<br />
<br />
=== uploadChunk ===<br />
<br />
Laetakse serverisse ning lisatakse juba serveris olevale failile lõppu osa failist. Kliendid võivad kogu faili saata ka ühe osana. Failide jupitamist on soovitav kasutada desktop lahendustes suurte failide saatmisel.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator.<br />
|-<br />
|<br />
| chunk<br />
| xs:base64Binary<br />
| Järgmine faili osa.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
|<br />
|<br />
| None<br />
|}<br />
<br />
<br />
=== finishUpload ===<br />
<br />
Faili üleslaadimise lõpetamine.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator<br />
|-<br />
|<br />
| md5<br />
| xs:string<br />
| Üles laetud faili MD5 kontrollsumma.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| errorCode<br />
| xs:integer<br />
| Kui 0, siis faili üleslaadimine õnnestus. Kui negatiivne, siis tekkis mingi viga (vt veakoodide).<br />
|}<br />
<br />
<br />
=== downloadChunk ===<br />
<br />
Faili alamosa allalaadimine Creditinfo failiserverist.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator<br />
|-<br />
|<br />
| start<br />
| xs:integer<br />
| Positsioon failis, millest alates andmeid alla laetakse (positsiooni lugemine algab nullist)<br />
|-<br />
| <br />
| count<br />
| xs:integer<br />
| Alla laetava tüki suurus baitides.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| chunk<br />
| xs:base64Binary<br />
| Faili alamosa<br />
|}<br />
<br />
<br />
=== getDownloadQueue ===<br />
<br />
Creditinfo serveris kliendi poolt allalaadimist ootavate failide loetelu.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| queue<br />
| DownloadQueueArray<br />
| Massiiv DownloadQueueType tüüpi elementidest<br />
|}<br />
<br />
<br />
DownloadQueueType on assiotsiatiivne massiiv, millel on järgmised elemendid:<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| docID<br />
| xs:integer<br />
| faili id<br />
|-<br />
| fileName<br />
| xs:string<br />
| faili nimi<br />
|}<br />
<br />
<br />
=== getStatusCode ===<br />
<br />
Tagastatakse üles laetud faili staatus serveris.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! colspan="2" style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameeter:</b><br />
| docID<br />
| xs:integer<br />
| colspan="2" |Faili identifikaator<br />
|-<br />
| <b>Output Parameters:</b><br />
| status_code<br />
| xs:integer<br />
| colspan="2" | Faili staatuse kood:<br />
|-<br />
| colspan="3" |<br />
| align="right" | 0<br />
| Fail on töödeldud<br />
|-<br />
| colspan="3" |<br />
| align="right" | 2<br />
| Toimub faili üles laadimine<br />
|-<br />
| colspan="3" |<br />
| align="right" | 3<br />
| Toimub faili töötlemine<br />
|-<br />
|-<br />
| colspan="3" |<br />
| align="right" | 4<br />
| Fail on edukalt üles laetud ning ootab töötlemist<br />
|-<br />
| colspan="3" |<br />
| align="right" | -1<br />
| Tundmatu viga. Täpsema info saamiseks võtke ühendust tehnilise teoga. Rohkem infot vea teate kohta võib saada meetodiga getStatusMsg.<br />
|-|-<br />
| colspan="3" |<br />
| align="right" | -10003<br />
| MD5 kontroll ebaõnnestus. Kliendi saadetud MD5 kontrollsumma ei langenud kokku serveri poolt arvutatud MD5 kontrollsummaga.<br />
|-<br />
| colspan="3" |<br />
| align="right" | -xxxxx<br />
| Faili töötlemine ebaõnnestus. Täpsema info saamiseks võta ühendust tehnilise toega. Rohkem infot vea teate kohta võib saada meetodiga getStatusMsg.<br />
|}<br />
<br />
<br />
=== getStatusMsg ===<br />
<br />
Tagastatakse staatust täpsustav info.<br />
<br />
{| style="border-style: solid; border-width: 1px"<br />
!<br />
! style="text-align: left;" | Nimi<br />
! style="text-align: left;" | Tüüp<br />
! style="text-align: left;" | Kirjeldus<br />
|-<br />
| <b>Sisendparameeter:</b><br />
| docID<br />
| xs:integer<br />
| Faili identifikaator<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| statusMsg<br />
| xs:string<br />
| Faili staatust täpsustav info<br />
|}<br />
<br />
= Veakoodid =<br />
<br />
<table><br />
<tr><br />
<td><b>Kood</b></td><br />
<td><b>Kirjeldus</b></td><br />
</tr><br />
<tr><br />
<td>0</td><br />
<td>Success</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Päringu töötlus õnnestus.</td><br />
</tr><br />
<tr><br />
<td>-10001</td><br />
<td>Access denied</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Üritatakse pöörduda faili poole, mis kuulub kellelegi teisele.</td><br />
</tr><br />
<tr><br />
<td>-10002</td><br />
<td>File does not exists</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Kasutati faili identifikaatorit, mida ei eksisteeri.</td><br />
</tr><br />
<tr><br />
<td>-10003</td><br />
<td>MD5 failure</td><br />
</tr><br />
<tr><br />
<td></td><br />
<td>Kliendi saadetud MD5 ei lange kokku serveri poolt arvutatud MD5-ga</td><br />
</tr><br />
</table><br />
<br />
<br />
= Silumine =<br />
<br />
Faili edastamiseks testserverisse tuleb lisada parameeter ''debug'' serveri aadressile, ehk 'https://services.krediidiinfo.ee/soap.php?name=KiDocExchange&debug'<br />
<br />
= Näidis PHP-s =<br />
<br />
Programm laeb faili Creditinfo serverisse ning seejärel laeb sama faili alla. Lõpus kontrollitakse, kas üles ja alla laetud faili sisu on sama. Programmi põhimõte sobib KiDocExchange liidese testimiseks. Kui soovite maksehäire sisestamiseks mõeldud faili testida siis ärge kasutage silumismoodi.<br />
<br />
<pre><br />
<?php<br />
/**<br />
* Example of uploading and downloading files using KiDocExchange interface.<br />
* @author Rait Kapp <rait@creditinfo.ee><br />
* @created 27.04.2007<br />
*/<br />
$wsdl_url = 'http://services.krediidiinfo.ee/KiDocExchange.wsdl';<br />
$params = array('location' => 'https://services.krediidiinfo.ee/soap.php?name=KiDocExchange&debug'<br />
, 'login' => 'username' // <-- username. Make sure username is string type (PHP bug?).<br />
, 'password' => 'password' // <-- password<br />
);<br />
<br />
$client = new SoapClient($wsdl_url, $params);<br />
<br />
// Uploading file.<br />
$content = 'I am a little test file!';<br />
$docID = $client->startUpload('test.txt');<br />
$client->uploadChunk($docID, $content); <br />
<br />
$md5 = md5($content);<br />
$result = $client->finishUpload($docID, $md5);<br />
if ($result != 0) {<br />
die("upload failed.! Error code: {$result}\n");<br />
}<br />
<br />
// Downloading file<br />
$start = 0;<br />
$count = 512; // can be a big number if you do not have to display download progress.<br />
$data = '';<br />
while ($chunk = $client->downloadChunk($docID, $start, $count)) {<br />
$start += $count;<br />
$data .= $chunk;<br />
}<br />
<br />
if ($content != $data) {<br />
echo "Something is not right!\n";<br />
} else {<br />
echo "We got back: {$data}\n";<br />
}<br />
<br />
?><br />
</pre></div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=KiCompanyBasic_en&diff=521
KiCompanyBasic en
2013-10-01T06:49:08Z
<p>Kart: /* Introduction */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[KiCompanyBasic|eesti keeles]]<br />
|}<br />
<br />
<br />
= Introduction = <br />
<br />
<span style="color:#CC0000"> <b> Attention! The service KiCompanyBasic will end on 10/1/2013. We suggest to use [[KiCompany_en | KiCompany]] as an alternative. </b></span><br />
<br />
KiCompanyBasic is the name of a Web Service based on SOAP protocol for requesting companies’ register codes. KiCompanyBasic requests are free of charge up to 500 queries per month.<br />
<br />
= WSDL =<br />
<br />
KiCompanyBasic WDSL is located at [http://services.krediidiinfo.ee/KiCompanyBasic.wsdl http://services.krediidiinfo.ee/KiCompanyBasic.wsdl].<br />
<br />
WSDL for users of Microsoft Development Tools is located at: [http://services.krediidiinfo.ee/KiCompanyBasicLit.wsdl http://services.krediidiinfo.ee/KiCompanyBasicLit.wsdl]. It differs from the previous WSDL in that '''RPC/litteral''' is used instead of '''RPC/encode'''.<br />
<br />
<br />
= Methods = <br />
<br />
== getName ==<br />
<br />
Requesting company’s name.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameter:</b> <br />
| regCode<br />
| xs:string<br />
| Company’s registry code.<br />
|-<br />
| <b>Output parameter:</b><br />
| name<br />
| xs:string<br />
| Company’s name. Output value is an empty string if the name is not found (compnay does not exist, error in the registry code etc). <br />
|}<br />
<br />
<br />
== findCompanies ==<br />
<br />
Searching companies by name. The result is an array, which includes companies’ names and registry codes according to the search string.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameter:</b> <br />
| regCode<br />
| xs:string<br />
| Company’s registry code<br />
|-<br />
| <b></b> <br />
| count<br />
| xs:int<br />
| Maximum number of companies found in the result of the method (The method does not return at once more than 100 companies) <br />
|-<br />
| <b>Output parameter:</b><br />
| companies<br />
| ResultCompanyIDDataArray<br />
| Indexed array which elements are ResultCompanyIDData array elements.<br />
|}<br />
<br />
ResultCompanyIDData is a record with the following structure:<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| regCode<br />
| xs:string<br />
| Company’s registry code <br />
|-<br />
| name<br />
| xs:string<br />
| Company’s name.<br />
|}<br />
<br />
<br />
== isRegCodeValid ==<br />
<br />
Verification of company’s registry code. <br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameter:</b> <br />
| regCode<br />
| xs:string<br />
| Company’s registry code <br />
|-<br />
| <b>Output parameter:</b><br />
| isValid<br />
| xs:boolean<br />
| True if registry code given with parameter is an eight-digit number and the last check digit is correct.<br />
|}<br />
<br />
<br />
= Example in PHP =<br />
<br />
Example of using KiCompanyBasic web service in PHP. <br />
<br />
<pre><br />
<?php<br />
/**<br />
* Example of using KiCompanyBasic web service of Krediidiinfo AS.<br />
*/<br />
$param = array('encoding'=>'ISO-8859-13');<br />
$client = new SoapClient('http://services.krediidiinfo.ee/KiCompanyBasic.wsdl', $param);<br />
<br />
$name = 'KREDIIDI';<br />
$companies = $client->findCompanies($name, 3);<br />
print_r($companies);<br />
<br />
$regCode = '10256137';<br />
$name = $client->getName($regCode);<br />
echo "Registry code {$regCode} belongs to the company {$name}\n";<br />
<br />
$regCode = '10256136'; // check number is invalid!<br />
if (!$client->isRegCodeValid($regCode)) {<br />
echo "Registry code is incorrect.\n";<br />
} else {<br />
echo "Registry code is correct\n";<br />
}<br />
?><br />
</pre><br />
<br />
Program output:<br />
<br />
<pre><br />
<br />
Array<br />
(<br />
[0] => Array<br />
(<br />
[regCode] => 90006012<br />
[name] => KREDIIDI JA EKSPORDI GARANTEERIMISE SITHASUTUS KREDEX<br />
)<br />
<br />
[1] => Array<br />
(<br />
[regCode] => 10704587<br />
[name] => KREDIIDI JÄRELVALVE OÜ<br />
)<br />
<br />
[2] => Array<br />
(<br />
[regCode] => 10256137<br />
[name] => KREDIIDIINFO AS<br />
)<br />
<br />
)<br />
Registry code 10256137 belongs to the company KREDIIDIINFO AS<br />
Registry code is incorrect.<br />
</pre></div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=KiCompanyBasic_en&diff=520
KiCompanyBasic en
2013-10-01T06:48:37Z
<p>Kart: /* Introduction */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[KiCompanyBasic|eesti keeles]]<br />
|}<br />
<br />
<br />
= Introduction = <br />
<br />
<span style="color:#CC0000"> <b> Attention! The service KiCompanyBasic will end on 10/1/2013. We suggest to use [KiCompany_en | KiCompany]] as an alternative. </b></span><br />
<br />
KiCompanyBasic is the name of a Web Service based on SOAP protocol for requesting companies’ register codes. KiCompanyBasic requests are free of charge up to 500 queries per month.<br />
<br />
= WSDL =<br />
<br />
KiCompanyBasic WDSL is located at [http://services.krediidiinfo.ee/KiCompanyBasic.wsdl http://services.krediidiinfo.ee/KiCompanyBasic.wsdl].<br />
<br />
WSDL for users of Microsoft Development Tools is located at: [http://services.krediidiinfo.ee/KiCompanyBasicLit.wsdl http://services.krediidiinfo.ee/KiCompanyBasicLit.wsdl]. It differs from the previous WSDL in that '''RPC/litteral''' is used instead of '''RPC/encode'''.<br />
<br />
<br />
= Methods = <br />
<br />
== getName ==<br />
<br />
Requesting company’s name.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameter:</b> <br />
| regCode<br />
| xs:string<br />
| Company’s registry code.<br />
|-<br />
| <b>Output parameter:</b><br />
| name<br />
| xs:string<br />
| Company’s name. Output value is an empty string if the name is not found (compnay does not exist, error in the registry code etc). <br />
|}<br />
<br />
<br />
== findCompanies ==<br />
<br />
Searching companies by name. The result is an array, which includes companies’ names and registry codes according to the search string.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameter:</b> <br />
| regCode<br />
| xs:string<br />
| Company’s registry code<br />
|-<br />
| <b></b> <br />
| count<br />
| xs:int<br />
| Maximum number of companies found in the result of the method (The method does not return at once more than 100 companies) <br />
|-<br />
| <b>Output parameter:</b><br />
| companies<br />
| ResultCompanyIDDataArray<br />
| Indexed array which elements are ResultCompanyIDData array elements.<br />
|}<br />
<br />
ResultCompanyIDData is a record with the following structure:<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| regCode<br />
| xs:string<br />
| Company’s registry code <br />
|-<br />
| name<br />
| xs:string<br />
| Company’s name.<br />
|}<br />
<br />
<br />
== isRegCodeValid ==<br />
<br />
Verification of company’s registry code. <br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameter:</b> <br />
| regCode<br />
| xs:string<br />
| Company’s registry code <br />
|-<br />
| <b>Output parameter:</b><br />
| isValid<br />
| xs:boolean<br />
| True if registry code given with parameter is an eight-digit number and the last check digit is correct.<br />
|}<br />
<br />
<br />
= Example in PHP =<br />
<br />
Example of using KiCompanyBasic web service in PHP. <br />
<br />
<pre><br />
<?php<br />
/**<br />
* Example of using KiCompanyBasic web service of Krediidiinfo AS.<br />
*/<br />
$param = array('encoding'=>'ISO-8859-13');<br />
$client = new SoapClient('http://services.krediidiinfo.ee/KiCompanyBasic.wsdl', $param);<br />
<br />
$name = 'KREDIIDI';<br />
$companies = $client->findCompanies($name, 3);<br />
print_r($companies);<br />
<br />
$regCode = '10256137';<br />
$name = $client->getName($regCode);<br />
echo "Registry code {$regCode} belongs to the company {$name}\n";<br />
<br />
$regCode = '10256136'; // check number is invalid!<br />
if (!$client->isRegCodeValid($regCode)) {<br />
echo "Registry code is incorrect.\n";<br />
} else {<br />
echo "Registry code is correct\n";<br />
}<br />
?><br />
</pre><br />
<br />
Program output:<br />
<br />
<pre><br />
<br />
Array<br />
(<br />
[0] => Array<br />
(<br />
[regCode] => 90006012<br />
[name] => KREDIIDI JA EKSPORDI GARANTEERIMISE SITHASUTUS KREDEX<br />
)<br />
<br />
[1] => Array<br />
(<br />
[regCode] => 10704587<br />
[name] => KREDIIDI JÄRELVALVE OÜ<br />
)<br />
<br />
[2] => Array<br />
(<br />
[regCode] => 10256137<br />
[name] => KREDIIDIINFO AS<br />
)<br />
<br />
)<br />
Registry code 10256137 belongs to the company KREDIIDIINFO AS<br />
Registry code is incorrect.<br />
</pre></div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=KiCompanyBasic_en&diff=519
KiCompanyBasic en
2013-10-01T06:48:12Z
<p>Kart: /* Introduction */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[KiCompanyBasic|eesti keeles]]<br />
|}<br />
<br />
<br />
= Introduction = <br />
<br />
<span style="color:#CC0000"> Attention! The service KiCompanyBasic will end on 10/1/2013. We suggest to use [KiCompany_en | KiCompany]] as an alternative. </span><br />
KiCompanyBasic is the name of a Web Service based on SOAP protocol for requesting companies’ register codes. KiCompanyBasic requests are free of charge up to 500 queries per month.<br />
<br />
= WSDL =<br />
<br />
KiCompanyBasic WDSL is located at [http://services.krediidiinfo.ee/KiCompanyBasic.wsdl http://services.krediidiinfo.ee/KiCompanyBasic.wsdl].<br />
<br />
WSDL for users of Microsoft Development Tools is located at: [http://services.krediidiinfo.ee/KiCompanyBasicLit.wsdl http://services.krediidiinfo.ee/KiCompanyBasicLit.wsdl]. It differs from the previous WSDL in that '''RPC/litteral''' is used instead of '''RPC/encode'''.<br />
<br />
<br />
= Methods = <br />
<br />
== getName ==<br />
<br />
Requesting company’s name.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameter:</b> <br />
| regCode<br />
| xs:string<br />
| Company’s registry code.<br />
|-<br />
| <b>Output parameter:</b><br />
| name<br />
| xs:string<br />
| Company’s name. Output value is an empty string if the name is not found (compnay does not exist, error in the registry code etc). <br />
|}<br />
<br />
<br />
== findCompanies ==<br />
<br />
Searching companies by name. The result is an array, which includes companies’ names and registry codes according to the search string.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameter:</b> <br />
| regCode<br />
| xs:string<br />
| Company’s registry code<br />
|-<br />
| <b></b> <br />
| count<br />
| xs:int<br />
| Maximum number of companies found in the result of the method (The method does not return at once more than 100 companies) <br />
|-<br />
| <b>Output parameter:</b><br />
| companies<br />
| ResultCompanyIDDataArray<br />
| Indexed array which elements are ResultCompanyIDData array elements.<br />
|}<br />
<br />
ResultCompanyIDData is a record with the following structure:<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| regCode<br />
| xs:string<br />
| Company’s registry code <br />
|-<br />
| name<br />
| xs:string<br />
| Company’s name.<br />
|}<br />
<br />
<br />
== isRegCodeValid ==<br />
<br />
Verification of company’s registry code. <br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameter:</b> <br />
| regCode<br />
| xs:string<br />
| Company’s registry code <br />
|-<br />
| <b>Output parameter:</b><br />
| isValid<br />
| xs:boolean<br />
| True if registry code given with parameter is an eight-digit number and the last check digit is correct.<br />
|}<br />
<br />
<br />
= Example in PHP =<br />
<br />
Example of using KiCompanyBasic web service in PHP. <br />
<br />
<pre><br />
<?php<br />
/**<br />
* Example of using KiCompanyBasic web service of Krediidiinfo AS.<br />
*/<br />
$param = array('encoding'=>'ISO-8859-13');<br />
$client = new SoapClient('http://services.krediidiinfo.ee/KiCompanyBasic.wsdl', $param);<br />
<br />
$name = 'KREDIIDI';<br />
$companies = $client->findCompanies($name, 3);<br />
print_r($companies);<br />
<br />
$regCode = '10256137';<br />
$name = $client->getName($regCode);<br />
echo "Registry code {$regCode} belongs to the company {$name}\n";<br />
<br />
$regCode = '10256136'; // check number is invalid!<br />
if (!$client->isRegCodeValid($regCode)) {<br />
echo "Registry code is incorrect.\n";<br />
} else {<br />
echo "Registry code is correct\n";<br />
}<br />
?><br />
</pre><br />
<br />
Program output:<br />
<br />
<pre><br />
<br />
Array<br />
(<br />
[0] => Array<br />
(<br />
[regCode] => 90006012<br />
[name] => KREDIIDI JA EKSPORDI GARANTEERIMISE SITHASUTUS KREDEX<br />
)<br />
<br />
[1] => Array<br />
(<br />
[regCode] => 10704587<br />
[name] => KREDIIDI JÄRELVALVE OÜ<br />
)<br />
<br />
[2] => Array<br />
(<br />
[regCode] => 10256137<br />
[name] => KREDIIDIINFO AS<br />
)<br />
<br />
)<br />
Registry code 10256137 belongs to the company KREDIIDIINFO AS<br />
Registry code is incorrect.<br />
</pre></div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=KiCompanyBasic&diff=518
KiCompanyBasic
2013-10-01T06:38:05Z
<p>Kart: /* Tutvustus */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[KiCompanyBasic__en|In English]]<br />
|}<br />
<br />
<br />
<br />
= Tutvustus = <br />
<br />
<span style="color:#CC0000"> <b>Tähelepanu! Veebiteenuse KiCompanyBasic osutamine lõppeb 1.10.2013. Alternatiivina soovitame kasutada [[KiCompany]] veebiteenust. </b> </span><br />
<br />
KiCompanyBasic on Krediidiinfo SOAP protokollil põhinev veebiteenus ettevõtete registrikoodide pärimiseks ja kontrollimiseks. KiCompanyBasic päringud on tasuta kuni 500 päringut kuus.<br />
<br />
= WSDL =<br />
<br />
KiCompanyBasic WSDL asub aadressil [http://services.krediidiinfo.ee/KiCompanyBasic.wsdl http://services.krediidiinfo.ee/KiCompanyBasic.wsdl].<br />
<br />
Microsofti arendusvahendite kasutajate jaoks on tehtud teine WSDL: [http://services.krediidiinfo.ee/KiCompanyBasicLit.wsdl http://services.krediidiinfo.ee/KiCompanyBasicLit.wsdl]. See erineb varasemast WSDL-ist selle poolest, et ''RPC/encode'' asemel kasutatakse ''RPC/litteral''-i.<br />
<br />
= Meetodid = <br />
<br />
== getName ==<br />
<br />
Ettevõtte nime pärimine.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| name<br />
| xs:string<br />
| Ettevõtte nimi. Kui ettevõtte nime ei leita (sellise nimega ettevõtet ei eksisteeri, ettevõtte äriregistrikood vigane vms), siis on väljundparameetri väärtuseks tühistring.<br />
|}<br />
<br />
== findCompanies ==<br />
<br />
Ettevõtete otsimine nime järgi. Tulemuseks on massiiv, mis sisaldab otsingustringile sobivate ettevõtete nimesid ja äriregistrikoode.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood<br />
|-<br />
| <b></b> <br />
| count<br />
| xs:int<br />
| Leitud ettevõtete maksimaalne arv, mis meetodi tulemuses võib olla. (Meetod ei tagasta korraga rohkem kui 100 ettevõtet)<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| companies<br />
| ResultCompanyIDDataArray<br />
| Indekseeritud massiiv, mille elementideks on ResultCompanyIDData tüüpi elemendid.<br />
|}<br />
<br />
ResultCompanyIDData on kirje järgmise struktuuriga:<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood<br />
|-<br />
| name<br />
| xs:string<br />
| Ettevõtte nimi.<br />
|}<br />
<br />
== isRegCodeValid ==<br />
<br />
Ettevõtte äriregistri korrektsuse kontrollimine. <br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| isValid<br />
| xs:boolean<br />
| Tõene, kui parameetriga ette antud äriregistri kood on kaheksakohaline arv ja viimane kontrollnumber on õige.<br />
|}<br />
<br />
= Näidisprogramm PHP-s =<br />
<br />
Järgnevalt on toodud PHP-s kirjutatud KiCompanyBasic veebiteenuse kasutamise näide.<br />
<br />
<pre><br />
<?php<br />
/**<br />
* Krediidiinfo KiCompanyBasic veebiteenuse kasutamise näidis.<br />
*/<br />
$param = array('encoding'=>'ISO-8859-13');<br />
$client = new SoapClient('http://services.krediidiinfo.ee/KiCompanyBasic.wsdl', $param);<br />
<br />
$name = 'KREDIIDI';<br />
$companies = $client->findCompanies($name, 3);<br />
print_r($companies);<br />
<br />
$regCode = '10256137';<br />
$name = $client->getName($regCode);<br />
echo "Äriregistri kood {$regCode} kuulub ettevõttele {$name}\n";<br />
<br />
$regCode = '10256136'; // kontrollnumber on vale!<br />
if (!$client->isRegCodeValid($regCode)) {<br />
echo "Äriregistri kood on vigane.\n";<br />
} else {<br />
echo "Äriregistri kood on korrektne\n";<br />
}<br />
?><br />
</pre><br />
<br />
Programmi väljund:<br />
<br />
<pre><br />
<br />
Array<br />
(<br />
[0] => Array<br />
(<br />
[regCode] => 90006012<br />
[name] => KREDIIDI JA EKSPORDI GARANTEERIMISE SITHASUTUS KREDEX<br />
)<br />
<br />
[1] => Array<br />
(<br />
[regCode] => 10704587<br />
[name] => KREDIIDI JÄRELVALVE OÜ<br />
)<br />
<br />
[2] => Array<br />
(<br />
[regCode] => 10256137<br />
[name] => KREDIIDIINFO AS<br />
)<br />
<br />
)<br />
Äriregistri kood 10256137 kuulub ettevõttele KREDIIDIINFO AS<br />
Äriregistri kood on vigane.<br />
</pre></div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=KiCompanyBasic&diff=517
KiCompanyBasic
2013-10-01T06:37:49Z
<p>Kart: /* Tutvustus */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[KiCompanyBasic__en|In English]]<br />
|}<br />
<br />
<br />
<br />
= Tutvustus = <br />
<br />
<span style="color:#CC0000"> <b>Veebiteenuse KiCompanyBasic osutamine lõppeb 1.10.2013. Alternatiivina soovitame kasutada [[KiCompany]] veebiteenust. </b> </span><br />
<br />
KiCompanyBasic on Krediidiinfo SOAP protokollil põhinev veebiteenus ettevõtete registrikoodide pärimiseks ja kontrollimiseks. KiCompanyBasic päringud on tasuta kuni 500 päringut kuus.<br />
<br />
= WSDL =<br />
<br />
KiCompanyBasic WSDL asub aadressil [http://services.krediidiinfo.ee/KiCompanyBasic.wsdl http://services.krediidiinfo.ee/KiCompanyBasic.wsdl].<br />
<br />
Microsofti arendusvahendite kasutajate jaoks on tehtud teine WSDL: [http://services.krediidiinfo.ee/KiCompanyBasicLit.wsdl http://services.krediidiinfo.ee/KiCompanyBasicLit.wsdl]. See erineb varasemast WSDL-ist selle poolest, et ''RPC/encode'' asemel kasutatakse ''RPC/litteral''-i.<br />
<br />
= Meetodid = <br />
<br />
== getName ==<br />
<br />
Ettevõtte nime pärimine.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| name<br />
| xs:string<br />
| Ettevõtte nimi. Kui ettevõtte nime ei leita (sellise nimega ettevõtet ei eksisteeri, ettevõtte äriregistrikood vigane vms), siis on väljundparameetri väärtuseks tühistring.<br />
|}<br />
<br />
== findCompanies ==<br />
<br />
Ettevõtete otsimine nime järgi. Tulemuseks on massiiv, mis sisaldab otsingustringile sobivate ettevõtete nimesid ja äriregistrikoode.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood<br />
|-<br />
| <b></b> <br />
| count<br />
| xs:int<br />
| Leitud ettevõtete maksimaalne arv, mis meetodi tulemuses võib olla. (Meetod ei tagasta korraga rohkem kui 100 ettevõtet)<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| companies<br />
| ResultCompanyIDDataArray<br />
| Indekseeritud massiiv, mille elementideks on ResultCompanyIDData tüüpi elemendid.<br />
|}<br />
<br />
ResultCompanyIDData on kirje järgmise struktuuriga:<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood<br />
|-<br />
| name<br />
| xs:string<br />
| Ettevõtte nimi.<br />
|}<br />
<br />
== isRegCodeValid ==<br />
<br />
Ettevõtte äriregistri korrektsuse kontrollimine. <br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| isValid<br />
| xs:boolean<br />
| Tõene, kui parameetriga ette antud äriregistri kood on kaheksakohaline arv ja viimane kontrollnumber on õige.<br />
|}<br />
<br />
= Näidisprogramm PHP-s =<br />
<br />
Järgnevalt on toodud PHP-s kirjutatud KiCompanyBasic veebiteenuse kasutamise näide.<br />
<br />
<pre><br />
<?php<br />
/**<br />
* Krediidiinfo KiCompanyBasic veebiteenuse kasutamise näidis.<br />
*/<br />
$param = array('encoding'=>'ISO-8859-13');<br />
$client = new SoapClient('http://services.krediidiinfo.ee/KiCompanyBasic.wsdl', $param);<br />
<br />
$name = 'KREDIIDI';<br />
$companies = $client->findCompanies($name, 3);<br />
print_r($companies);<br />
<br />
$regCode = '10256137';<br />
$name = $client->getName($regCode);<br />
echo "Äriregistri kood {$regCode} kuulub ettevõttele {$name}\n";<br />
<br />
$regCode = '10256136'; // kontrollnumber on vale!<br />
if (!$client->isRegCodeValid($regCode)) {<br />
echo "Äriregistri kood on vigane.\n";<br />
} else {<br />
echo "Äriregistri kood on korrektne\n";<br />
}<br />
?><br />
</pre><br />
<br />
Programmi väljund:<br />
<br />
<pre><br />
<br />
Array<br />
(<br />
[0] => Array<br />
(<br />
[regCode] => 90006012<br />
[name] => KREDIIDI JA EKSPORDI GARANTEERIMISE SITHASUTUS KREDEX<br />
)<br />
<br />
[1] => Array<br />
(<br />
[regCode] => 10704587<br />
[name] => KREDIIDI JÄRELVALVE OÜ<br />
)<br />
<br />
[2] => Array<br />
(<br />
[regCode] => 10256137<br />
[name] => KREDIIDIINFO AS<br />
)<br />
<br />
)<br />
Äriregistri kood 10256137 kuulub ettevõttele KREDIIDIINFO AS<br />
Äriregistri kood on vigane.<br />
</pre></div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=KiCompanyBasic&diff=516
KiCompanyBasic
2013-10-01T06:37:10Z
<p>Kart: /* Tutvustus */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[KiCompanyBasic__en|In English]]<br />
|}<br />
<br />
<br />
<br />
= Tutvustus = <br />
<br />
<span style="color:#CC0000"> Veebiteenuse KiCompanyBasic osutamine lõppeb 1.10.2013. Alternatiivina soovitame kasutada [[KiCompany]] veebiteenust. </span><br />
<br />
KiCompanyBasic on Krediidiinfo SOAP protokollil põhinev veebiteenus ettevõtete registrikoodide pärimiseks ja kontrollimiseks. KiCompanyBasic päringud on tasuta kuni 500 päringut kuus.<br />
<br />
= WSDL =<br />
<br />
KiCompanyBasic WSDL asub aadressil [http://services.krediidiinfo.ee/KiCompanyBasic.wsdl http://services.krediidiinfo.ee/KiCompanyBasic.wsdl].<br />
<br />
Microsofti arendusvahendite kasutajate jaoks on tehtud teine WSDL: [http://services.krediidiinfo.ee/KiCompanyBasicLit.wsdl http://services.krediidiinfo.ee/KiCompanyBasicLit.wsdl]. See erineb varasemast WSDL-ist selle poolest, et ''RPC/encode'' asemel kasutatakse ''RPC/litteral''-i.<br />
<br />
= Meetodid = <br />
<br />
== getName ==<br />
<br />
Ettevõtte nime pärimine.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| name<br />
| xs:string<br />
| Ettevõtte nimi. Kui ettevõtte nime ei leita (sellise nimega ettevõtet ei eksisteeri, ettevõtte äriregistrikood vigane vms), siis on väljundparameetri väärtuseks tühistring.<br />
|}<br />
<br />
== findCompanies ==<br />
<br />
Ettevõtete otsimine nime järgi. Tulemuseks on massiiv, mis sisaldab otsingustringile sobivate ettevõtete nimesid ja äriregistrikoode.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood<br />
|-<br />
| <b></b> <br />
| count<br />
| xs:int<br />
| Leitud ettevõtete maksimaalne arv, mis meetodi tulemuses võib olla. (Meetod ei tagasta korraga rohkem kui 100 ettevõtet)<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| companies<br />
| ResultCompanyIDDataArray<br />
| Indekseeritud massiiv, mille elementideks on ResultCompanyIDData tüüpi elemendid.<br />
|}<br />
<br />
ResultCompanyIDData on kirje järgmise struktuuriga:<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood<br />
|-<br />
| name<br />
| xs:string<br />
| Ettevõtte nimi.<br />
|}<br />
<br />
== isRegCodeValid ==<br />
<br />
Ettevõtte äriregistri korrektsuse kontrollimine. <br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| isValid<br />
| xs:boolean<br />
| Tõene, kui parameetriga ette antud äriregistri kood on kaheksakohaline arv ja viimane kontrollnumber on õige.<br />
|}<br />
<br />
= Näidisprogramm PHP-s =<br />
<br />
Järgnevalt on toodud PHP-s kirjutatud KiCompanyBasic veebiteenuse kasutamise näide.<br />
<br />
<pre><br />
<?php<br />
/**<br />
* Krediidiinfo KiCompanyBasic veebiteenuse kasutamise näidis.<br />
*/<br />
$param = array('encoding'=>'ISO-8859-13');<br />
$client = new SoapClient('http://services.krediidiinfo.ee/KiCompanyBasic.wsdl', $param);<br />
<br />
$name = 'KREDIIDI';<br />
$companies = $client->findCompanies($name, 3);<br />
print_r($companies);<br />
<br />
$regCode = '10256137';<br />
$name = $client->getName($regCode);<br />
echo "Äriregistri kood {$regCode} kuulub ettevõttele {$name}\n";<br />
<br />
$regCode = '10256136'; // kontrollnumber on vale!<br />
if (!$client->isRegCodeValid($regCode)) {<br />
echo "Äriregistri kood on vigane.\n";<br />
} else {<br />
echo "Äriregistri kood on korrektne\n";<br />
}<br />
?><br />
</pre><br />
<br />
Programmi väljund:<br />
<br />
<pre><br />
<br />
Array<br />
(<br />
[0] => Array<br />
(<br />
[regCode] => 90006012<br />
[name] => KREDIIDI JA EKSPORDI GARANTEERIMISE SITHASUTUS KREDEX<br />
)<br />
<br />
[1] => Array<br />
(<br />
[regCode] => 10704587<br />
[name] => KREDIIDI JÄRELVALVE OÜ<br />
)<br />
<br />
[2] => Array<br />
(<br />
[regCode] => 10256137<br />
[name] => KREDIIDIINFO AS<br />
)<br />
<br />
)<br />
Äriregistri kood 10256137 kuulub ettevõttele KREDIIDIINFO AS<br />
Äriregistri kood on vigane.<br />
</pre></div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=KiReport&diff=515
KiReport
2013-09-09T07:50:19Z
<p>Kart: /* Tutvustus */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[KiReport__en|In English]]<br />
|}<br />
<br />
= Tutvustus = <br />
<br />
KiReport ehk XML raportite pärimine on Krediidiinfo poolt loodud SOAP protokollil põhinev veebiteenus. Päringu tulemuseks saadavad raportid on XML formaadis. Raporti pärimiseks muudes formaatides kasutage raportite pärimise otselinki [[kireport.php]].<br />
<br />
XML raporti tellimine<br />
# Leppige kliendihalduriga kokku raporti täpne struktuur ja hind <br />
# Kliendihaldur laseb IT osakonnal koostada Teie jaoks raporti<br />
# Kliendihaldur saadab Teile raporti testimiseks:<br />
## Testkasutaja kasutajatunnuse, parooli <br />
## Raportite pärimise liidese kirjelduse<br />
## Raporti skeemi (XSD schema) ja kirjelduse<br />
## Kõikide võimalike eranditega „Test“ raportite isiku-/registrikoodid<br />
# Kui olete raporti testimise lõpetanud, saadab kliendihaldur Teile liidese- ja konkreetse raporti õigustega kasutajakonto.<br />
<br />
= WSDL =<br />
<br />
KiReport WSDL asub aadresslil [http://services.krediidiinfo.ee/KiReport.wsdl http://services.krediidiinfo.ee/KiReport.wsdl].<br />
<br />
= Meetodid =<br />
== ''getReport'' ==<br />
<br />
Raporti pärimine. <br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| productCode<br />
| xs:string<br />
| Toote kood.<br />
|-<br />
| <b></b> <br />
| subjectCode<br />
| xs:string<br />
| Subjekti kood (sõltuvalt raportist võib subjekti koodiks olla kas ettevõtte äriregistrikood, eraisiku isikukood vms)<br />
|-<br />
| <b>Väljundparameeter::</b><br />
| xml<br />
| xs:string<br />
| Päritud raport XML formaadis.<br />
|}<br />
<br />
<br />
<br />
=Näide PHP-s =<br />
<br />
KiReport kasutamise näide PHP-s:<br />
<br />
<code><pre><br />
<?php<br />
/**<br />
* Example of using KiReport web service of Krediidiinfo AS<br />
* Certificate issued by Krediidiinfo is needed to use KiReport interface.<br />
* <br />
* @author Rait Kapp <rait@krediidiinfo.ee><br />
* @created 18.09.2007<br />
*/<br />
<br />
$wsdl_url = 'http://www.krediidiinfo.ee/services/KiReport.wsdl';<br />
$server_url = 'https://services.krediidiinfo.ee/soap.php?name=KiReport&enc=UTF-8'; <br />
<br />
$params = array('location' => $server_url<br />
, 'login' => 'online_code' // Online Code issued by Krediidiinfo client management. Make sure that login value is string type (PHP bug?).<br />
, 'password' => 'passwd'<br />
<br />
/* If you want to use certificate, then uncomment this block and comment params login and password!<br />
, 'local_cert' => 'path/certificate.pem' // Here goes path to certificate file.<br />
, 'passphrase' => 'passwd' // Here goes password of certificate.<br />
*/<br />
// , 'proxy_host' => 'cache.neti.ee' // If necessary use proxy and proxy port.<br />
// , 'proxy_port' => 8080<br />
, 'encoding' => 'UTF-8'<br />
);<br />
<br />
$client = new SoapClient($wsdl_url, $params);<br />
<br />
$productCode = 'RAXXXE';<br />
$subjectCode = '00000000';<br />
<br />
try {<br />
$xml = $client->getReport($productCode, $subjectCode);<br />
print_r($xml);<br />
} catch (Exception $e) {<br />
echo "Raporti pärimine ebaõnnestus vea teatega: " . $e->getMessage() . "\n";<br />
if (isset($e->detail)) {<br />
// $e->details->errorcode tähendusi vaata Veakoodide alt.<br />
echo "Krediidiinfo SOAP serveri poolt tagastatud vea kood: " . $e->detail->errorcode . "\n";<br />
}<br />
}<br />
<br />
?><br />
</pre></code><br />
<br />
= Silumine =<br />
<br />
Silumise jaoks võib alati pärida raportid koodiga ''RAXXXE''. ''RAXXXE'' päringute eest tasu ei võeta! Raporti ''RAXXXE'' XML skeem asub aadressil [http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd]. <br />
<br />
Raportis on loodud märgendid kõigis skalaarsetes tüüpides, mida Krediidiinfo XML-ides kasutatakse. <br />
Raporti ''RAXXXE'' näidis:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<report xmlns="http//www.krediidiinfo.ee/schemas/report/RAXXXE.xsd"><br />
<date_tag>2007-10-23</date_tag><br />
<date_time>2007-10-23T10:10:42</date_time><br />
<int_tag>12345</int_tag><br />
<decimal_tag>123456.789</decimal_tag><br />
<string_tag>I am a string</string_tag><br />
<codes_tag>&amp;amp; &apos; &amp;quot; &amp;lt; &amp;gt;</codes_tag><br />
<est_character_tag>õ ä ö ü Õ Ä Ö Ü</est_character_tag><br />
<subject_code>00000000</subject_code><br />
</report><br />
</pre><br />
<br />
<br />
Märgendi ''subject_code'' väärtuseks on alati meetodi sisendparameetri ''subjectCode'' väärtus.<br />
<br />
= Veakoodid =<br />
<br />
==-20101 No permission for PRODUCT_CODE! ==<br />
<br />
Krediidiinfo AS ei ole andnud kliendile õiguseid pärida vastavat raportit. Õiguste saamiseks võtta ühendust [[Klienditugi| klienditoega]].<br />
<br />
<br />
==-20102 Subject code value is missing!==<br />
<br />
KiReport meetodile getReport sisendparameetril subjectCode puudub väärtus.<br />
<br />
<br />
==-20103 Invalid subject code value!==<br />
<br />
Ette antud subjekti kood ei ole korrektne.<br />
<br />
<br />
==-10186 No Report==<br />
<br />
Antud subjekti kohta raportit ei eksisteeri. Näiteks kui päritakse ettevõtte aasta aruannet aga ettevõte ei ole seda esitanud.<br />
<br />
<br />
==-20104 No price registred for product PRODUCT_CODE! ==<br />
<br />
Kliendihalduses ei ole registreeritud toote hinda. Võtke ühendust [[Klienditugi| klienditoega]].<br />
<br />
<br />
<br />
<br />
Lisaks teenusespetsiifilistele veakoodidele on veel [[Veakoodid | süsteemsed veakoodid]].</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=KiReport&diff=514
KiReport
2013-09-09T07:47:49Z
<p>Kart: /* Tutvustus */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[KiReport__en|In English]]<br />
|}<br />
<br />
= Tutvustus = <br />
<br />
KiReport on Krediidiinfo poolt loodud SOAP protokollil põhinev veebiteenus Krediidiinfo raportite pärimiseks. Päringu tulemuseks saadavad raportid on XML formaadis. Raporti pärimiseks muudes formaatides kasutage raportite pärimise otselinki [[kireport.php]].<br />
<br />
XML raporti tellimine<br />
# Leppige kliendihalduriga kokku raporti täpne struktuur ja hind <br />
# Kliendihaldur laseb IT osakonnal koostada Teie jaoks raporti<br />
# Kliendihaldur saadab Teile raporti testimiseks:<br />
## Testkasutaja kasutajatunnuse, parooli <br />
## Raportite pärimise liidese kirjelduse<br />
## Raporti skeemi (xsd schema) ja kirjelduse<br />
## Kõikide võimalike eranditega „Test“ raportite isiku-/registrikoodid<br />
# Kui olete raporti testimise lõpetanud, saadab kliendihaldur Teile liidese- ja konkreetse raporti õigustega kasutajakonto.<br />
<br />
= WSDL =<br />
<br />
KiReport WSDL asub aadresslil [http://services.krediidiinfo.ee/KiReport.wsdl http://services.krediidiinfo.ee/KiReport.wsdl].<br />
<br />
= Meetodid =<br />
== ''getReport'' ==<br />
<br />
Raporti pärimine. <br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| productCode<br />
| xs:string<br />
| Toote kood.<br />
|-<br />
| <b></b> <br />
| subjectCode<br />
| xs:string<br />
| Subjekti kood (sõltuvalt raportist võib subjekti koodiks olla kas ettevõtte äriregistrikood, eraisiku isikukood vms)<br />
|-<br />
| <b>Väljundparameeter::</b><br />
| xml<br />
| xs:string<br />
| Päritud raport XML formaadis.<br />
|}<br />
<br />
<br />
<br />
=Näide PHP-s =<br />
<br />
KiReport kasutamise näide PHP-s:<br />
<br />
<code><pre><br />
<?php<br />
/**<br />
* Example of using KiReport web service of Krediidiinfo AS<br />
* Certificate issued by Krediidiinfo is needed to use KiReport interface.<br />
* <br />
* @author Rait Kapp <rait@krediidiinfo.ee><br />
* @created 18.09.2007<br />
*/<br />
<br />
$wsdl_url = 'http://www.krediidiinfo.ee/services/KiReport.wsdl';<br />
$server_url = 'https://services.krediidiinfo.ee/soap.php?name=KiReport&enc=UTF-8'; <br />
<br />
$params = array('location' => $server_url<br />
, 'login' => 'online_code' // Online Code issued by Krediidiinfo client management. Make sure that login value is string type (PHP bug?).<br />
, 'password' => 'passwd'<br />
<br />
/* If you want to use certificate, then uncomment this block and comment params login and password!<br />
, 'local_cert' => 'path/certificate.pem' // Here goes path to certificate file.<br />
, 'passphrase' => 'passwd' // Here goes password of certificate.<br />
*/<br />
// , 'proxy_host' => 'cache.neti.ee' // If necessary use proxy and proxy port.<br />
// , 'proxy_port' => 8080<br />
, 'encoding' => 'UTF-8'<br />
);<br />
<br />
$client = new SoapClient($wsdl_url, $params);<br />
<br />
$productCode = 'RAXXXE';<br />
$subjectCode = '00000000';<br />
<br />
try {<br />
$xml = $client->getReport($productCode, $subjectCode);<br />
print_r($xml);<br />
} catch (Exception $e) {<br />
echo "Raporti pärimine ebaõnnestus vea teatega: " . $e->getMessage() . "\n";<br />
if (isset($e->detail)) {<br />
// $e->details->errorcode tähendusi vaata Veakoodide alt.<br />
echo "Krediidiinfo SOAP serveri poolt tagastatud vea kood: " . $e->detail->errorcode . "\n";<br />
}<br />
}<br />
<br />
?><br />
</pre></code><br />
<br />
= Silumine =<br />
<br />
Silumise jaoks võib alati pärida raportid koodiga ''RAXXXE''. ''RAXXXE'' päringute eest tasu ei võeta! Raporti ''RAXXXE'' XML skeem asub aadressil [http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd]. <br />
<br />
Raportis on loodud märgendid kõigis skalaarsetes tüüpides, mida Krediidiinfo XML-ides kasutatakse. <br />
Raporti ''RAXXXE'' näidis:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<report xmlns="http//www.krediidiinfo.ee/schemas/report/RAXXXE.xsd"><br />
<date_tag>2007-10-23</date_tag><br />
<date_time>2007-10-23T10:10:42</date_time><br />
<int_tag>12345</int_tag><br />
<decimal_tag>123456.789</decimal_tag><br />
<string_tag>I am a string</string_tag><br />
<codes_tag>&amp;amp; &apos; &amp;quot; &amp;lt; &amp;gt;</codes_tag><br />
<est_character_tag>õ ä ö ü Õ Ä Ö Ü</est_character_tag><br />
<subject_code>00000000</subject_code><br />
</report><br />
</pre><br />
<br />
<br />
Märgendi ''subject_code'' väärtuseks on alati meetodi sisendparameetri ''subjectCode'' väärtus.<br />
<br />
= Veakoodid =<br />
<br />
==-20101 No permission for PRODUCT_CODE! ==<br />
<br />
Krediidiinfo AS ei ole andnud kliendile õiguseid pärida vastavat raportit. Õiguste saamiseks võtta ühendust [[Klienditugi| klienditoega]].<br />
<br />
<br />
==-20102 Subject code value is missing!==<br />
<br />
KiReport meetodile getReport sisendparameetril subjectCode puudub väärtus.<br />
<br />
<br />
==-20103 Invalid subject code value!==<br />
<br />
Ette antud subjekti kood ei ole korrektne.<br />
<br />
<br />
==-10186 No Report==<br />
<br />
Antud subjekti kohta raportit ei eksisteeri. Näiteks kui päritakse ettevõtte aasta aruannet aga ettevõte ei ole seda esitanud.<br />
<br />
<br />
==-20104 No price registred for product PRODUCT_CODE! ==<br />
<br />
Kliendihalduses ei ole registreeritud toote hinda. Võtke ühendust [[Klienditugi| klienditoega]].<br />
<br />
<br />
<br />
<br />
Lisaks teenusespetsiifilistele veakoodidele on veel [[Veakoodid | süsteemsed veakoodid]].</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=KiReport&diff=513
KiReport
2013-09-05T13:45:25Z
<p>Kart: /* Tutvustus */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[KiReport__en|In English]]<br />
|}<br />
<br />
= Tutvustus = <br />
<br />
KiReport on Krediidiinfo poolt loodud SOAP protokollil põhinev veebiteenus Krediidiinfo raportite pärimiseks. Päringu tulemuseks saadavad raportid on XML formaadis. Raporti pärimiseks muudes formaatides kasutage raportite pärimise otselinki [[kireport.php]].<br />
<br />
XML raporti tellimine<br />
# Leppige kliendihalduriga kokku raporti täpne struktuur ja hind <br />
# Kliendihaldur laseb IT osakonnal koostada Teie jaoks raporti<br />
# Kliendihaldur saadab Teile raporti testimiseks:<br />
## Testkasutaja kasutajatunnuse, parooli <br />
## Raportite pärimise liidese kirjelduse<br />
## Raporti skeemi ja kirjelduse<br />
## Kõikide võimalike eranditega „Test“ raportite isiku-/registrikoodid<br />
# Kui olete raporti testimise lõpetanud, saadab kliendihaldur Teile liidese- ja konkreetse raporti õigustega kasutajakonto.<br />
<br />
= WSDL =<br />
<br />
KiReport WSDL asub aadresslil [http://services.krediidiinfo.ee/KiReport.wsdl http://services.krediidiinfo.ee/KiReport.wsdl].<br />
<br />
= Meetodid =<br />
== ''getReport'' ==<br />
<br />
Raporti pärimine. <br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| productCode<br />
| xs:string<br />
| Toote kood.<br />
|-<br />
| <b></b> <br />
| subjectCode<br />
| xs:string<br />
| Subjekti kood (sõltuvalt raportist võib subjekti koodiks olla kas ettevõtte äriregistrikood, eraisiku isikukood vms)<br />
|-<br />
| <b>Väljundparameeter::</b><br />
| xml<br />
| xs:string<br />
| Päritud raport XML formaadis.<br />
|}<br />
<br />
<br />
<br />
=Näide PHP-s =<br />
<br />
KiReport kasutamise näide PHP-s:<br />
<br />
<code><pre><br />
<?php<br />
/**<br />
* Example of using KiReport web service of Krediidiinfo AS<br />
* Certificate issued by Krediidiinfo is needed to use KiReport interface.<br />
* <br />
* @author Rait Kapp <rait@krediidiinfo.ee><br />
* @created 18.09.2007<br />
*/<br />
<br />
$wsdl_url = 'http://www.krediidiinfo.ee/services/KiReport.wsdl';<br />
$server_url = 'https://services.krediidiinfo.ee/soap.php?name=KiReport&enc=UTF-8'; <br />
<br />
$params = array('location' => $server_url<br />
, 'login' => 'online_code' // Online Code issued by Krediidiinfo client management. Make sure that login value is string type (PHP bug?).<br />
, 'password' => 'passwd'<br />
<br />
/* If you want to use certificate, then uncomment this block and comment params login and password!<br />
, 'local_cert' => 'path/certificate.pem' // Here goes path to certificate file.<br />
, 'passphrase' => 'passwd' // Here goes password of certificate.<br />
*/<br />
// , 'proxy_host' => 'cache.neti.ee' // If necessary use proxy and proxy port.<br />
// , 'proxy_port' => 8080<br />
, 'encoding' => 'UTF-8'<br />
);<br />
<br />
$client = new SoapClient($wsdl_url, $params);<br />
<br />
$productCode = 'RAXXXE';<br />
$subjectCode = '00000000';<br />
<br />
try {<br />
$xml = $client->getReport($productCode, $subjectCode);<br />
print_r($xml);<br />
} catch (Exception $e) {<br />
echo "Raporti pärimine ebaõnnestus vea teatega: " . $e->getMessage() . "\n";<br />
if (isset($e->detail)) {<br />
// $e->details->errorcode tähendusi vaata Veakoodide alt.<br />
echo "Krediidiinfo SOAP serveri poolt tagastatud vea kood: " . $e->detail->errorcode . "\n";<br />
}<br />
}<br />
<br />
?><br />
</pre></code><br />
<br />
= Silumine =<br />
<br />
Silumise jaoks võib alati pärida raportid koodiga ''RAXXXE''. ''RAXXXE'' päringute eest tasu ei võeta! Raporti ''RAXXXE'' XML skeem asub aadressil [http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd]. <br />
<br />
Raportis on loodud märgendid kõigis skalaarsetes tüüpides, mida Krediidiinfo XML-ides kasutatakse. <br />
Raporti ''RAXXXE'' näidis:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<report xmlns="http//www.krediidiinfo.ee/schemas/report/RAXXXE.xsd"><br />
<date_tag>2007-10-23</date_tag><br />
<date_time>2007-10-23T10:10:42</date_time><br />
<int_tag>12345</int_tag><br />
<decimal_tag>123456.789</decimal_tag><br />
<string_tag>I am a string</string_tag><br />
<codes_tag>&amp;amp; &apos; &amp;quot; &amp;lt; &amp;gt;</codes_tag><br />
<est_character_tag>õ ä ö ü Õ Ä Ö Ü</est_character_tag><br />
<subject_code>00000000</subject_code><br />
</report><br />
</pre><br />
<br />
<br />
Märgendi ''subject_code'' väärtuseks on alati meetodi sisendparameetri ''subjectCode'' väärtus.<br />
<br />
= Veakoodid =<br />
<br />
==-20101 No permission for PRODUCT_CODE! ==<br />
<br />
Krediidiinfo AS ei ole andnud kliendile õiguseid pärida vastavat raportit. Õiguste saamiseks võtta ühendust [[Klienditugi| klienditoega]].<br />
<br />
<br />
==-20102 Subject code value is missing!==<br />
<br />
KiReport meetodile getReport sisendparameetril subjectCode puudub väärtus.<br />
<br />
<br />
==-20103 Invalid subject code value!==<br />
<br />
Ette antud subjekti kood ei ole korrektne.<br />
<br />
<br />
==-10186 No Report==<br />
<br />
Antud subjekti kohta raportit ei eksisteeri. Näiteks kui päritakse ettevõtte aasta aruannet aga ettevõte ei ole seda esitanud.<br />
<br />
<br />
==-20104 No price registred for product PRODUCT_CODE! ==<br />
<br />
Kliendihalduses ei ole registreeritud toote hinda. Võtke ühendust [[Klienditugi| klienditoega]].<br />
<br />
<br />
<br />
<br />
Lisaks teenusespetsiifilistele veakoodidele on veel [[Veakoodid | süsteemsed veakoodid]].</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=KiReport&diff=512
KiReport
2013-09-02T11:16:21Z
<p>Kart: /* Tutvustus */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[KiReport__en|In English]]<br />
|}<br />
<br />
= Tutvustus = <br />
<br />
KiReport on Krediidiinfo poolt loodud SOAP protokollil põhinev veebiteenus Krediidiinfo raportite pärimiseks. Päringu tulemuseks saadavad raportid on XML formaadis. Raporti pärimiseks muudes formaatides kasutage raportite pärimise otselinki [[kireport.php]].<br />
<br />
XML raporti tellimine<br />
# Leppige kliendihalduriga kokku raporti täpne struktuur ja hind <br />
# Kliendihaldur laseb IT osakonnal koostada Teie jaoks raporti<br />
# Kliendihaldur saadab Teile raporti testimiseks:<br />
## Testkasutaja kasutajatunnuse, parooli <br />
## Raportite pärimise liidese kirjelduse<br />
## Raporti skeemi ja kirjelduse<br />
## Kõikide võimalike eranditega „Test“ raportite isiku-/registrikoodid<br />
# Kui klient on raporti testimise lõpetanud, saadab kliendihaldur Teile liidese- ja konkreetse raporti õigustega kasutajakonto.<br />
<br />
= WSDL =<br />
<br />
KiReport WSDL asub aadresslil [http://services.krediidiinfo.ee/KiReport.wsdl http://services.krediidiinfo.ee/KiReport.wsdl].<br />
<br />
= Meetodid =<br />
== ''getReport'' ==<br />
<br />
Raporti pärimine. <br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| productCode<br />
| xs:string<br />
| Toote kood.<br />
|-<br />
| <b></b> <br />
| subjectCode<br />
| xs:string<br />
| Subjekti kood (sõltuvalt raportist võib subjekti koodiks olla kas ettevõtte äriregistrikood, eraisiku isikukood vms)<br />
|-<br />
| <b>Väljundparameeter::</b><br />
| xml<br />
| xs:string<br />
| Päritud raport XML formaadis.<br />
|}<br />
<br />
<br />
<br />
=Näide PHP-s =<br />
<br />
KiReport kasutamise näide PHP-s:<br />
<br />
<code><pre><br />
<?php<br />
/**<br />
* Example of using KiReport web service of Krediidiinfo AS<br />
* Certificate issued by Krediidiinfo is needed to use KiReport interface.<br />
* <br />
* @author Rait Kapp <rait@krediidiinfo.ee><br />
* @created 18.09.2007<br />
*/<br />
<br />
$wsdl_url = 'http://www.krediidiinfo.ee/services/KiReport.wsdl';<br />
$server_url = 'https://services.krediidiinfo.ee/soap.php?name=KiReport&enc=UTF-8'; <br />
<br />
$params = array('location' => $server_url<br />
, 'login' => 'online_code' // Online Code issued by Krediidiinfo client management. Make sure that login value is string type (PHP bug?).<br />
, 'password' => 'passwd'<br />
<br />
/* If you want to use certificate, then uncomment this block and comment params login and password!<br />
, 'local_cert' => 'path/certificate.pem' // Here goes path to certificate file.<br />
, 'passphrase' => 'passwd' // Here goes password of certificate.<br />
*/<br />
// , 'proxy_host' => 'cache.neti.ee' // If necessary use proxy and proxy port.<br />
// , 'proxy_port' => 8080<br />
, 'encoding' => 'UTF-8'<br />
);<br />
<br />
$client = new SoapClient($wsdl_url, $params);<br />
<br />
$productCode = 'RAXXXE';<br />
$subjectCode = '00000000';<br />
<br />
try {<br />
$xml = $client->getReport($productCode, $subjectCode);<br />
print_r($xml);<br />
} catch (Exception $e) {<br />
echo "Raporti pärimine ebaõnnestus vea teatega: " . $e->getMessage() . "\n";<br />
if (isset($e->detail)) {<br />
// $e->details->errorcode tähendusi vaata Veakoodide alt.<br />
echo "Krediidiinfo SOAP serveri poolt tagastatud vea kood: " . $e->detail->errorcode . "\n";<br />
}<br />
}<br />
<br />
?><br />
</pre></code><br />
<br />
= Silumine =<br />
<br />
Silumise jaoks võib alati pärida raportid koodiga ''RAXXXE''. ''RAXXXE'' päringute eest tasu ei võeta! Raporti ''RAXXXE'' XML skeem asub aadressil [http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd]. <br />
<br />
Raportis on loodud märgendid kõigis skalaarsetes tüüpides, mida Krediidiinfo XML-ides kasutatakse. <br />
Raporti ''RAXXXE'' näidis:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<report xmlns="http//www.krediidiinfo.ee/schemas/report/RAXXXE.xsd"><br />
<date_tag>2007-10-23</date_tag><br />
<date_time>2007-10-23T10:10:42</date_time><br />
<int_tag>12345</int_tag><br />
<decimal_tag>123456.789</decimal_tag><br />
<string_tag>I am a string</string_tag><br />
<codes_tag>&amp;amp; &apos; &amp;quot; &amp;lt; &amp;gt;</codes_tag><br />
<est_character_tag>õ ä ö ü Õ Ä Ö Ü</est_character_tag><br />
<subject_code>00000000</subject_code><br />
</report><br />
</pre><br />
<br />
<br />
Märgendi ''subject_code'' väärtuseks on alati meetodi sisendparameetri ''subjectCode'' väärtus.<br />
<br />
= Veakoodid =<br />
<br />
==-20101 No permission for PRODUCT_CODE! ==<br />
<br />
Krediidiinfo AS ei ole andnud kliendile õiguseid pärida vastavat raportit. Õiguste saamiseks võtta ühendust [[Klienditugi| klienditoega]].<br />
<br />
<br />
==-20102 Subject code value is missing!==<br />
<br />
KiReport meetodile getReport sisendparameetril subjectCode puudub väärtus.<br />
<br />
<br />
==-20103 Invalid subject code value!==<br />
<br />
Ette antud subjekti kood ei ole korrektne.<br />
<br />
<br />
==-10186 No Report==<br />
<br />
Antud subjekti kohta raportit ei eksisteeri. Näiteks kui päritakse ettevõtte aasta aruannet aga ettevõte ei ole seda esitanud.<br />
<br />
<br />
==-20104 No price registred for product PRODUCT_CODE! ==<br />
<br />
Kliendihalduses ei ole registreeritud toote hinda. Võtke ühendust [[Klienditugi| klienditoega]].<br />
<br />
<br />
<br />
<br />
Lisaks teenusespetsiifilistele veakoodidele on veel [[Veakoodid | süsteemsed veakoodid]].</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Main_page_en&diff=511
Main page en
2013-08-14T07:38:31Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Main_Page|eesti keeles]]<br />
|}<br />
<br />
<br />
Here you can find Krediidiinfo web services' documentation and samples.<br />
<br />
= Krediidiinfo web services =<br />
* [[KiReport_en|Requesting XML reports]]<br />
* [[Kireport.php_en|Requesting PDF ja HTML reports]]<br />
* [[KiDocExchange_en | KiDocExchange]]<br />
* [[KiCompany_en | KiCompany]]<br />
* [[KiCreditRiskManagement_en | KiCreditRiskManagement]]<br />
<br />
= For developers =<br />
* [[Krediidiinfo Web Services Architecture_en | Krediidiinfo Web Services Architecture]]<br />
* [[Autentimine_en|Authentication]]<br />
* [[Web_Service_Debugging | Web Service Debugging]]<br />
* [[Exeption handling]]<br />
* [[Error codes]]<br />
* [[SOAP service testing]]<br />
* [[Tehniline tugi| Technical support]]<br />
* Used standards/protocols<br />
** [http://www.w3schools.com/xml/default.asp XML]<br />
** [http://www.w3schools.com/schema/default.asp XML Schema]<br />
** [http://www.w3schools.com/soap/default.asp SOAP]<br />
** [http://www.w3schools.com/wsdl/default.asp WSDL]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Main_Page&diff=510
Main Page
2013-08-14T07:38:22Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Main page__en|In English]]<br />
|}<br />
<br />
<br />
Lehelt leiate Krediidiinfo veebiteenuste dokumentatsioonid ja näidised.<br />
<br />
= Tutvustus = <br />
* '''Mis on veebiteenus?'''<br />
Veebiteenused (Web Service) on tarkvarakomponendid, mis asuvad serveris ning mille poole kliendiprogrammid pöörduvad üle interneti. <br />
<br />
Veebiteenuse looja koostab koos veebiteenusega ka veebiteenuse dokumentatsiooni. Dokumentatsioonis on täpselt ära kirjeldatud veebiteenuse interneti aadress, mis andmevahetusprotokolle peab kasutama, millised on liidese meetodite nimed, millised on sisend- ja väljundparameetrite tüübid. Veebiteenuse kirjeldamiseks kasutatakse XML-põhist WSDL (Web Services Description Language) keelt. <br />
<br />
Veebiteenused on sõltumatud kasutatavast platvormist. Veebiteenus võib ise töötada Linux operatsioonisüsteemiga serveris, kliendiprogramm seevastu Win32 operatsioonisüsteemiga lauaarvutis. Ühte veebiteenust on võimalik integreerida ükskõik millisesse arvutisse eeldusel, et on olemas internetiühendus. <br />
<br />
Tänapäeval on kõrgtaseme tarkvaraarenduskeskkondadesse loodud tööriistad veebiteenuste lihtsaks integreerimiseks. WSDL kirjelduse põhjal suudavad arenduskeskkonnad genereerida programmeerija jaoks vajalikud teegid programmeerija poolt kasutatavas programmeerimiskeeles. Sisuliselt ei erine tarkvaraarendaja jaoks veebiteenuse väljakutsumine tavalisest funktsiooni väljakutsumisest. Kogu andmevahetuse ja tüübiteisenduste loogika on tarkvaraarendaja eest peidetud.<br />
<br />
= Krediidiinfo veebiteenused =<br />
* [[KiReport|XML raportite pärimine]]<br />
* [[Kireport.php|PDF ja HTML raportite pärimine]]<br />
* [[KiDocExchange]]<br />
* [[KiCompany]]<br />
* [[KiCreditRiskManagement]]<br />
<br />
= Arendajatele =<br />
* [[Krediidiinfo veebiteenuste arhitektuur]]<br />
* [[Autentimine]]<br />
* [[Veebiteenuste silumine]]- Serveri testimine, raportite testimine testkeskkonnas<br />
* [[Veatöötlus]]<br />
* [[Veakoodid]]<br />
* [[SOAP teenuse testimine]]<br />
* [[Tehniline tugi]]<br />
* Kasutatavad standardid/protokollid<br />
** [http://www.w3schools.com/xml/default.asp XML]<br />
** [http://www.w3schools.com/schema/default.asp XML Schema]<br />
** [http://www.w3schools.com/soap/default.asp SOAP]<br />
** [http://www.w3schools.com/wsdl/default.asp WSDL]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Main_page_en&diff=509
Main page en
2013-08-14T07:37:31Z
<p>Kart: /* Krediidiinfo web services */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Main_Page|eesti keeles]]<br />
|}<br />
<br />
<br />
Here you can find Krediidiinfo web services' documentation and samples.<br />
<br />
= Krediidiinfo web services =<br />
* [[KiReport_en|Requesting XML reports]]<br />
* [[Kireport.php_en|Requesting PDF ja HTML reports]]<br />
* [[KiDocExchange_en | KiDocExchange]]<br />
* [[KiCompany_en | KiCompany]]<br />
* [[KiCreditRiskManagement_en | KiCreditRiskManagement]]<br />
<br />
= For developers =<br />
* [[Krediidiinfo Web Services Architecture_en | Krediidiinfo Web Services Architecture]]<br />
* [[Autentimine_en|Authentication]]<br />
* [[Web_Service_Debugging | Web Service Debugging]]<br />
* [[Exeption handling]]<br />
* [[Error codes]]<br />
* [[SOAP service testing]]<br />
* [[Tehniline tugi| Technical support]]<br />
* Used standards/protocols<br />
** [http://www.w3schools.com/xml/default.asp XML]<br />
** [http://www.w3schools.com/schema/default.asp XML Schema]<br />
** [http://www.w3schools.com/soap/default.asp SOAP]<br />
** [http://www.w3schools.com/wsdl/default.asp WSDL]<br />
<br />
= Samples =<br />
* [[KiCompanyBasic | KiCompanyBasic - '''<span style="color:red;">Free interface!</span>''']]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Main_Page&diff=508
Main Page
2013-08-14T07:37:20Z
<p>Kart: /* Krediidiinfo veebiteenused */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Main page__en|In English]]<br />
|}<br />
<br />
<br />
Lehelt leiate Krediidiinfo veebiteenuste dokumentatsioonid ja näidised.<br />
<br />
= Tutvustus = <br />
* '''Mis on veebiteenus?'''<br />
Veebiteenused (Web Service) on tarkvarakomponendid, mis asuvad serveris ning mille poole kliendiprogrammid pöörduvad üle interneti. <br />
<br />
Veebiteenuse looja koostab koos veebiteenusega ka veebiteenuse dokumentatsiooni. Dokumentatsioonis on täpselt ära kirjeldatud veebiteenuse interneti aadress, mis andmevahetusprotokolle peab kasutama, millised on liidese meetodite nimed, millised on sisend- ja väljundparameetrite tüübid. Veebiteenuse kirjeldamiseks kasutatakse XML-põhist WSDL (Web Services Description Language) keelt. <br />
<br />
Veebiteenused on sõltumatud kasutatavast platvormist. Veebiteenus võib ise töötada Linux operatsioonisüsteemiga serveris, kliendiprogramm seevastu Win32 operatsioonisüsteemiga lauaarvutis. Ühte veebiteenust on võimalik integreerida ükskõik millisesse arvutisse eeldusel, et on olemas internetiühendus. <br />
<br />
Tänapäeval on kõrgtaseme tarkvaraarenduskeskkondadesse loodud tööriistad veebiteenuste lihtsaks integreerimiseks. WSDL kirjelduse põhjal suudavad arenduskeskkonnad genereerida programmeerija jaoks vajalikud teegid programmeerija poolt kasutatavas programmeerimiskeeles. Sisuliselt ei erine tarkvaraarendaja jaoks veebiteenuse väljakutsumine tavalisest funktsiooni väljakutsumisest. Kogu andmevahetuse ja tüübiteisenduste loogika on tarkvaraarendaja eest peidetud.<br />
<br />
= Krediidiinfo veebiteenused =<br />
* [[KiReport|XML raportite pärimine]]<br />
* [[Kireport.php|PDF ja HTML raportite pärimine]]<br />
* [[KiDocExchange]]<br />
* [[KiCompany]]<br />
* [[KiCreditRiskManagement]]<br />
<br />
= Arendajatele =<br />
* [[Krediidiinfo veebiteenuste arhitektuur]]<br />
* [[Autentimine]]<br />
* [[Veebiteenuste silumine]]- Serveri testimine, raportite testimine testkeskkonnas<br />
* [[Veatöötlus]]<br />
* [[Veakoodid]]<br />
* [[SOAP teenuse testimine]]<br />
* [[Tehniline tugi]]<br />
* Kasutatavad standardid/protokollid<br />
** [http://www.w3schools.com/xml/default.asp XML]<br />
** [http://www.w3schools.com/schema/default.asp XML Schema]<br />
** [http://www.w3schools.com/soap/default.asp SOAP]<br />
** [http://www.w3schools.com/wsdl/default.asp WSDL]<br />
<br />
= Näidised =<br />
* [[KiCompanyBasic | KiCompanyBasic - '''<span style="color:red;">Tasuta liides!</span>''']]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=KiCompany_en&diff=507
KiCompany en
2013-08-14T07:32:35Z
<p>Kart: /* getBasicData */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[KiCompany|eesti keeles]]<br />
|}<br />
<br />
= Introduction = <br />
<br />
KiCompany is the name of a Web Service based on SOAP protocol for requesting basic data about companies, non-profit organizations and state agencies. The interface is designed clients who want to integrate the functionality of company request into their own system.<br />
<br />
= WSDL =<br />
<br />
KiCompany WDSL is located at [http://services.krediidiinfo.ee/KiCompany.wsdl http://services.krediidiinfo.ee/KiCompany.wsdl].<br />
<br />
WSDL for users of Microsoft Development Tools is located at: [http://services.krediidiinfo.ee/KiCompanyLit.wsdl http://services.krediidiinfo.ee/KiCompanyLit.wsdl]. It differs from the previous WSDL in that '''RPC/litteral''' is used instead of '''RPC/encode'''. <br />
<br />
= Methods = <br />
<br />
<br />
== getName ==<br />
<br />
Requesting company’s name.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameter:</b> <br />
| regCode<br />
| xs:string<br />
| Company’s registry code.<br />
|-<br />
| <b>Output parameter:</b><br />
| name<br />
| xs:string<br />
| Company’s name. Output value is an empty string if the name is not found (compnay does not exist, error in the registry code etc). <br />
|}<br />
<br />
<br />
<br />
== findCompanies ==<br />
<br />
Searching companies by name. The result is an array, which includes companies’ names and registry codes according to the search string.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameter:</b> <br />
| regCode<br />
| xs:string<br />
| Company’s registry code <br />
|-<br />
| <b></b> <br />
| count<br />
| xs:int<br />
| Maximum number of companies found in the result of the method (The method does not return at once more than 100 companies) <br />
|-<br />
| <b>Output parameter:</b><br />
| companies<br />
| ResultCompanyIDDataArray<br />
| Indexed array which elements are ResultCompanyIDData array elements.<br />
|}<br />
<br />
<br />
ResultCompanyIDData is a record with the following structure:<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| regCode<br />
| xs:string<br />
| Company’s registry code <br />
|-<br />
| name<br />
| xs:string<br />
| Company’s name.<br />
|}<br />
<br />
<br />
<br />
== getBasicData ==<br />
<br />
Requesting company’s basic data. <br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameter:</b> <br />
| regCode<br />
| xs:string<br />
| Company’s registry code.<br />
|-<br />
| <b>Output parameter:</b><br />
| data<br />
| CompanyBasicDataType<br />
| A record with company’s data. <br />
|}<br />
<br />
<br />
If the company according '''regCode''' is not found, the SOAP error message code -10231 will be returned.<br />
<br />
CompanyBasicDataType record with the following structure:<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| regCode<br />
| xs:string<br />
| Company’s registry code <br />
|-<br />
| name<br />
| xs:string<br />
| Company’s name.<br />
|-<br />
| street<br />
| xs:string<br />
| Street name in postal address (for marketing activities)<br />
|-<br />
| postCode<br />
| xs:string<br />
| Postcode in postal address (for marketing activities)<br />
|-<br />
| city<br />
| xs:string<br />
| Name of the city in postal address (for marketing activities)<br />
|-<br />
| legalStreet<br />
| xs:string<br />
| Street name in legal address <br />
|-<br />
| legalPostCode<br />
| xs:string<br />
| Postcode in legal address <br />
|-<br />
| legalCity<br />
| xs:string<br />
| Name of city in legal address <br />
|-<br />
| phones<br />
| xs:string<br />
| Phone numbers<br />
|-<br />
| faxes<br />
| xs:string<br />
| Fax numbers <br />
|-<br />
| web<br />
| xs:string<br />
| Website URL <br />
|-<br />
| emails<br />
| xs:string<br />
| E-post addresses <br />
|-<br />
| legalForm<br />
| xs:string<br />
| Legal form <br />
|-<br />
| shareCapital <br />
| xs:int<br />
| Amount of share capital <br />
|-<br />
| shareCapitalCur<br />
| xs:string<br />
| Currency of share capital <br />
|-<br />
| regTime<br />
| xs:string<br />
| Company’s registration time in Commercial Register. Format: yyyy-mm-dd <br />
|-<br />
| regPlace<br />
| xs:string<br />
| Name of registration department where company was registered <br />
|-<br />
| activities <br />
| xs:string<br />
| The list of company’s activities. Before every activity there is a string '* ' (asterisk and space). From 7/29/2011 an empty string will be given as a result. <br />
|-<br />
| status<br />
| xs:string<br />
| Status in Commercial Register<br />
|-<br />
|}<br />
<br />
== getContactData ==<br />
<br />
Requesting company’s contact data.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameter:</b> <br />
| regCode<br />
| xs:string<br />
| company’s registry code.<br />
|-<br />
| <b>Output parameter:</b><br />
| data<br />
| CompanyContactDataType<br />
| A record with contact data <br />
|}<br />
<br />
If the company according '''regCode''' is not found, the SOAP error message code -10231 will be returned.<br />
<br />
CompanyContactDataType record is with the following structure:<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| street<br />
| xs:string<br />
| Street name in postal address (for marketing activities)<br />
|-<br />
| postCode<br />
| xs:string<br />
| Postcode in postal address (for marketing activities)<br />
|-<br />
| city<br />
| xs:string<br />
| Name of the city in postal address (for marketing activities)<br />
|-<br />
| phones<br />
| xs:string<br />
| Phone numbers<br />
|-<br />
| faxes<br />
| xs:string<br />
| Fax numbers <br />
|-<br />
| web<br />
| xs:string<br />
| Website URL <br />
|-<br />
| emails<br />
| xs:string<br />
| E-post addresses <br />
|}<br />
<br />
<br />
<br />
== getLegalPostAddress ==<br />
<br />
Requesting company’s legal post address.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameters:</b> <br />
| regCode<br />
| xs:string<br />
| company’s registry code.<br />
|-<br />
| <b>Output parameter:</b><br />
| data<br />
| CompanyPostAddressType<br />
| A record with legal address data <br />
|}<br />
<br />
If the company according '''regCode''' is not found, the SOAP error message code -10231 will be returned.<br />
<br />
CompanyPostAddressType record is with the following structure:<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| street<br />
| xs:string<br />
| street name <br />
|-<br />
| postCode<br />
| xs:string<br />
| postcode <br />
|-<br />
| city<br />
| xs:string<br />
| city<br />
|}<br />
<br />
<br />
<br />
== isRegCodeValid ==<br />
<br />
Verification of company’s registry code. <br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameter:</b> <br />
| regCode<br />
| xs:string<br />
| Company’s registry code <br />
|-<br />
| <b>Output parameter:</b><br />
| isValid<br />
| xs:boolean<br />
| True if registry code given with parameter is an eight-digit number and the last check digit is correct.<br />
|}<br />
<br />
<br />
<br />
<br />
== getVATNo ==<br />
<br />
Requesting company’s VAT number .<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Name<br />
! Type<br />
! Description<br />
|-<br />
| <b>Input parameter:</b> <br />
| regCode<br />
| xs:string<br />
| Company’s registry code.<br />
|-<br />
| <b>Output parameter:</b><br />
| vatNo<br />
| xs:string<br />
| VAT number. If VAT number is not valid or the company is not VAT pager, an empty string will be given.<br />
|}<br />
<br />
<br />
= Error codes =<br />
<br />
<br />
== -10231 No company found! ==<br />
<br />
No company found with the registry code given for parameter from Krediidiinfo’s database. Check the registry code.<br />
<br />
(see more [[Veakoodid_en|general error codes]])<br />
<br />
<br />
<br />
= Example in PHP =<br />
<br />
Example of using KiCompany web service in PHP.<br />
<br />
<pre><br />
<?php<br />
/**<br />
* Example of using KiCompany web service of Krediidiinfo AS<br />
* <br />
* @author Rait Kapp <rait@krediidiinfo.ee><br />
* @created 15.02.2011<br />
*/<br />
$wsdl_url = 'http://services.krediidiinfo.ee/KiCompany.wsdl';<br />
$server_url = 'https://services.krediidiinfo.ee/soap.php?name=KiCompany'; <br />
<br />
<br />
$params = array('location' => $server_url<br />
, 'login' => 'online_code' // Online Code issued by Krediidiinfo client management. Make sure that login value is string type (PHP bug?).<br />
, 'password' => 'passwd'<br />
// , 'proxy_host' => 'cache.neti.ee' // If necessary use proxy and proxy port.<br />
// , 'proxy_port' => 8080<br />
, 'encoding' => 'ISO-8859-13'<br />
);<br />
<br />
<br />
$client = new SoapClient($wsdl_url, $params);<br />
<br />
<br />
$name = 'KREDIIDI';<br />
$companies = $client->findCompanies($name, 3);<br />
print_r($companies);<br />
<br />
$regCode = '10256137';<br />
$name = $client->getName($regCode);<br />
echo "Registry code {$regCode} belongs to the company {$name}\n";<br />
<br />
$data = $client->getBasicData($regCode);<br />
echo "Address: {$data->street} {$data->postCode} {$data->city}\n";<br />
<br />
$regCode = '10256136'; // check number is invalid!<br />
if (!$client->isRegCodeValid($regCode)) {<br />
echo "Registry code {$regCode} is incorrect.\n";<br />
} else {<br />
echo "Registry code {$regCode} is correct.\n";<br />
}<br />
<br />
?><br />
<br />
</pre><br />
<br />
Program output:<br />
<br />
<pre><br />
Array<br />
(<br />
[0] => stdClass Object<br />
(<br />
[regCode] => 90006012<br />
[name] => KREDIIDI JA EKSPORDI GARANTEERIMISE SIHTASUTUS KREDEX<br />
)<br />
<br />
[1] => stdClass Object<br />
(<br />
[regCode] => 10704587<br />
[name] => KREDIIDI JÄRELVALVE OÜ<br />
)<br />
<br />
[2] => stdClass Object<br />
(<br />
[regCode] => 11626688<br />
[name] => KREDIIDIBÜROO OÜ<br />
)<br />
<br />
)<br />
Registry code 10256137 belongs to the company KREDIIDIINFO AS<br />
Address: Narva mnt 5 10117 Tallinn<br />
Registry code 10256136 is incorrect.<br />
<br />
</pre></div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=KiCompany&diff=506
KiCompany
2013-08-14T07:32:15Z
<p>Kart: /* getBasicData */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[KiCompany__en|In English]]<br />
|}<br />
<br />
<br />
= Tutvustus = <br />
<br />
KiCompany on SOAP protokollil põhinev Krediidiinfo AS veebiteenus ettevõtete, mittetulundusühingute ja riigiasutuste põhiandmete pärimiseks. Liides on mõeldud klientidele, kes soovivad integreerida oma süsteemi [http://firmaparing.krediidiinfo.ee firmapäringu] funktsionaalsust.<br />
<br />
= WSDL =<br />
<br />
KiCompany WSDL asub aadressil [http://services.krediidiinfo.ee/KiCompany.wsdl http://services.krediidiinfo.ee/KiCompany.wsdl].<br />
<br />
Microsofti arendusvahendite kasutajate jaoks on tehtud teine WSDL: [http://services.krediidiinfo.ee/KiCompanyLit.wsdl http://services.krediidiinfo.ee/KiCompanyLit.wsdl]. See erineb varasemast WSDL-ist selle poolest, et ''RPC/encode'' asemel kasutatakse ''RPC/litteral''-i.<br />
<br />
= Meetodid = <br />
<br />
<br />
<br />
== getName ==<br />
<br />
Ettevõtte nime pärimine.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| name<br />
| xs:string<br />
| Ettevõtte nimi. Kui ettevõtte nime ei leita (sellise nimega ettevõtet ei eksisteeri, ettevõtte äriregistrikood vigane vms), siis on väljundparameetri väärtuseks tühistring.<br />
|}<br />
<br />
<br />
== getRegistryName ==<br />
<br />
Ettevõtte Äriregistri pika nime pärimine.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| name<br />
| xs:string<br />
| Ettevõtte nimi. Kui ettevõtte nime ei leita (sellise nimega ettevõtet ei eksisteeri), siis on väljundparameetri väärtuseks tühistring.<br />
| Vigase registrikoodi korral tagastatakse viga -20501 (Invalid registry code value)<br />
|}<br />
<br />
<br />
<br />
== findCompanies ==<br />
<br />
Ettevõtete otsimine nime järgi. Tulemuseks on massiiv, mis sisaldab otsingustringile sobivate ettevõtete nimesid ja äriregistrikoode.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood<br />
|-<br />
| <b></b> <br />
| count<br />
| xs:int<br />
| Leitud ettevõtete maksimaalne arv, mis meetodi tulemuses võib olla. (Meetod ei tagasta korraga rohkem kui 100 ettevõtet)<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| companies<br />
| ResultCompanyIDDataArray<br />
| Indekseeritud massiiv, mille elementideks on ResultCompanyIDData tüüpi elemendid.<br />
|}<br />
<br />
ResultCompanyIDData on kirje järgmise struktuuriga:<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood<br />
|-<br />
| name<br />
| xs:string<br />
| Ettevõtte nimi.<br />
|}<br />
<br />
== getBasicData ==<br />
<br />
Ettevõtte põhiandmete pärimine. <br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| data<br />
| CompanyBasicDataType<br />
| Kirje ettevõtte andmetega.<br />
|}<br />
<br />
Kui ''regCode''-ile vastavat ettevõtet ei leita, siis tagastatakse SOAP veateade koodiga -10231.<br />
<br />
CompanyBasicDataType tüüpi kirje järgmise struktuuriga:<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| regCode<br />
| xs:string<br />
| ettevõtte äriregistri kood<br />
|-<br />
| name<br />
| xs:string<br />
| ettevõtte nimi.<br />
|-<br />
| street<br />
| xs:string<br />
| tänava nimi turunduseks kasutatavas postiaadressis<br />
|-<br />
| postCode<br />
| xs:string<br />
| posti indeksi number turunduseks kasutatavas postiaadressis<br />
|-<br />
| city<br />
| xs:string<br />
| linna nimi turunduseks kasutatavas postiaadressis<br />
|-<br />
| legalStreet<br />
| xs:string<br />
| tänava nimi juriidilises aadressis<br />
|-<br />
| legalPostCode<br />
| xs:string<br />
| posti indeksi number juriidilises aadressis<br />
|-<br />
| legalCity<br />
| xs:string<br />
| linnanimi juriidilises aadressis<br />
|-<br />
| phones<br />
| xs:string<br />
| telefonide numbrid<br />
|-<br />
| faxes<br />
| xs:string<br />
| fakside numbrid<br />
|-<br />
| web<br />
| xs:string<br />
| interneti kodulehekülje URL<br />
|-<br />
| emails<br />
| xs:string<br />
| e-posti aadressid<br />
|-<br />
| legalForm<br />
| xs:string<br />
| juriidiline vorm<br />
|-<br />
| shareCapital <br />
| xs:int<br />
| osakapitali suurus<br />
|-<br />
| shareCapitalCur<br />
| xs:string<br />
| valuuta tähis, milles on osakapitali suurus antud<br />
|-<br />
| regTime<br />
| xs:string<br />
| ettevõtte registreerimise aeg Äriregistris. Formaat: yyyy-mm-dd<br />
|-<br />
| regPlace<br />
| xs:string<br />
| registriosakonna nimetus kus ettevõte registreeriti<br />
|-<br />
| activities <br />
| xs:string<br />
| ettevõtte tegevusalade loetelu. Iga tegevusala ees on string '* ' (tärn ja tühik). Alates 29.07.2011 on väärtuseks tühistring. <br />
|-<br />
| status<br />
| xs:string<br />
| äriregistri staatuse nimetus<br />
|-<br />
|}<br />
<br />
== getContactData ==<br />
<br />
Ettevõtte kontaktandmete pärimine.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| ettevõtte äriregistri kood.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| data<br />
| CompanyContactDataType<br />
| kirje kontaktandmetega<br />
|}<br />
<br />
Kui ''regCode''-ile vastavat ettevõtet ei leita, siis tagastatakse SOAP veateade koodiga -10231.<br />
<br />
CompanyContactDataType tüüpi kirje on järgmise struktuuriga:<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| street<br />
| xs:string<br />
| tänava nimi turunduseks kasutatavas postiaadressis<br />
|-<br />
| postCode<br />
| xs:string<br />
| posti indeksi number turunduseks kasutatavas postiaadressis<br />
|-<br />
| city<br />
| xs:string<br />
| linna nimi turunduseks kasutatavas postiaadressis<br />
|-<br />
| phones<br />
| xs:string<br />
| telefonide numbrid<br />
|-<br />
| faxes<br />
| xs:string<br />
| fakside numbrid<br />
|-<br />
| web<br />
| xs:string<br />
| interneti kodulehekülje URL<br />
|-<br />
| emails<br />
| xs:string<br />
| e-posti aadressid<br />
|}<br />
<br />
<br />
<br />
== getLegalPostAddress ==<br />
<br />
Ettevõtte juriidilise aadressi pärimine.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| ettevõtte äriregistri kood.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| data<br />
| CompanyPostAddressType<br />
| kirje juriidilise aadressi andmetega<br />
|}<br />
<br />
Kui ''regCode''-ile vastavat ettevõtet ei leita, siis tagastatakse SOAP veateade koodiga -10231.<br />
<br />
CompanyPostAddressType tüüpi kirje on järgmise struktuuriga:<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| street<br />
| xs:string<br />
| tänava nimi <br />
|-<br />
| postCode<br />
| xs:string<br />
| indeks<br />
|-<br />
| city<br />
| xs:string<br />
| linn<br />
|}<br />
<br />
<br />
<br />
== isRegCodeValid ==<br />
<br />
Ettevõtte äriregistri korrektsuse kontrollimine. <br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| isValid<br />
| xs:boolean<br />
| Tõene, kui parameetriga ette antud äriregistri kood on kaheksakohaline arv ja viimane kontrollnumber on õige.<br />
|}<br />
<br />
<br />
== getVATNo ==<br />
<br />
Ettevõtte käibemaksukohustuslase numbri pärimine.<br />
<br />
{| style="border-style: solid; border-width: 1px;"<br />
! <br />
! Nimi<br />
! Tüüp<br />
! Kirjeldus<br />
|-<br />
| <b>Sisendparameetrid:</b> <br />
| regCode<br />
| xs:string<br />
| Ettevõtte äriregistri kood.<br />
|-<br />
| <b>Väljundparameeter:</b><br />
| vatNo<br />
| xs:string<br />
| KMK number. Kui KMK number ei kehti või ettevõte ei ole käibemaksukohuslane, siis tagastatakse tühistring<br />
|}<br />
<br />
= Veakoodid =<br />
<br />
<br />
== -10231 No company found! ==<br />
<br />
Krediidiinfo andmebaasist ei leitud parameetriga ette antud registrikoodile vastavat ettevõtet. Kontrollida registrikoodi.<br />
<br />
(vt lisaks [[Veakoodid|üldiseid veakoode]])<br />
<br />
= Programmi näidis PHP-s =<br />
<br />
Järgnevalt on toodud PHP-s kirjutatud KiCompany veebiteenuse kasutamise näide.<br />
<br />
<pre><br />
<?php<br />
/**<br />
* Example of using KiCompany web service of Krediidiinfo AS<br />
* <br />
* @author Rait Kapp <rait@krediidiinfo.ee><br />
* @created 15.02.2011<br />
*/<br />
$wsdl_url = 'http://services.krediidiinfo.ee/KiCompany.wsdl';<br />
$server_url = 'https://services.krediidiinfo.ee/soap.php?name=KiCompany'; <br />
<br />
<br />
$params = array('location' => $server_url<br />
, 'login' => 'online_code' // Online Code issued by Krediidiinfo client management. Make sure that login value is string type (PHP bug?).<br />
, 'password' => 'passwd'<br />
// , 'proxy_host' => 'cache.neti.ee' // If necessary use proxy and proxy port.<br />
// , 'proxy_port' => 8080<br />
, 'encoding' => 'ISO-8859-13'<br />
);<br />
<br />
<br />
$client = new SoapClient($wsdl_url, $params);<br />
<br />
<br />
$name = 'KREDIIDI';<br />
$companies = $client->findCompanies($name, 3);<br />
print_r($companies);<br />
<br />
$regCode = '10256137';<br />
$name = $client->getName($regCode);<br />
echo "Äriregistri kood {$regCode} kuulub ettevõttele {$name}\n";<br />
<br />
$data = $client->getBasicData($regCode);<br />
echo "Aadress: {$data->street} {$data->postCode} {$data->city}\n";<br />
<br />
$regCode = '10256136'; // kontrollnumber on vale!<br />
if (!$client->isRegCodeValid($regCode)) {<br />
echo "Äriregistri kood {$regCode} on vigane.\n";<br />
} else {<br />
echo "Äriregistri kood {$regCode} on korrektne\n";<br />
}<br />
<br />
?><br />
<br />
</pre><br />
<br />
Programmi väljund:<br />
<br />
<pre><br />
Array<br />
(<br />
[0] => stdClass Object<br />
(<br />
[regCode] => 90006012<br />
[name] => KREDIIDI JA EKSPORDI GARANTEERIMISE SIHTASUTUS KREDEX<br />
)<br />
<br />
[1] => stdClass Object<br />
(<br />
[regCode] => 10704587<br />
[name] => KREDIIDI JÄRELVALVE OÜ<br />
)<br />
<br />
[2] => stdClass Object<br />
(<br />
[regCode] => 11626688<br />
[name] => KREDIIDIBÜROO OÜ<br />
)<br />
<br />
)<br />
Äriregistri kood 10256137 kuulub ettevõttele KREDIIDIINFO AS<br />
Aadress: Narva mnt 5 10117 Tallinn<br />
Äriregistri kood 10256136 on vigane.<br />
<br />
</pre><br />
<br />
<br />
<br />
= HTTP päringute näidised =<br />
<br />
Failis [http://services.krediidiinfo.ee/wiki/images/e/ed/KiCompany_request_examples.zip kiCompany_request_examples.zip] on KiCompany HTTP päringute ja päringu vastuste näidised. Kui KiCompany integreeritakse süsteemi saates otse HTTP päringuid, siis HTTP vastuse parsimisel kasutada XML vahendeid. Mitte käsitleda HTTP vastuseid kui stringe ja parsida neid nö käsitsi. Kui Krediidiinfo uuendab SOAP serveri tarkvara, siis võib vastuse sõnumi kuju muutuda.</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=SOAP_teenuse_testimine&diff=505
SOAP teenuse testimine
2013-06-13T08:42:48Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[SOAP_service_testing|In English]]<br />
|}<br />
<br />
Krediidiinfo AS SOAP teenuse testimine kasutades <tt>curl</tt> programmi ning [[KiCompany]] teenust. Analoogselt saab testida ka teisi Krediidiinfo AS SOAP teenuseid.<br />
<br />
Autentimiseks saab kasutada sertifikaadi ja selle võtme paari kui ka http basic authentication kasutajat ning parooli. Peale paroolide või sertifikaadi olemasolu, peab Krediidiinfo AS kliendihaldus olema andnud õiguse kasutada [[KiCompany]] teenust.<br />
<br />
Kui järgnevad testid kliendi keskkonnas õnnestuvad, saab väita, et kliendile väljastatud sertifikaat või parool on õige ning õigused [[KiCompany]] kasutamiseks paigas.<br />
<br />
<br />
== Võrgu test ==<br />
<br />
Keskkond, millest päring tehakse, peab saama ühenduda <tt>services.krediidiinfo.ee</tt> serverisse tcp porti <tt>443</tt>. Krediidiinfo AS poolt ei ole IP põhiseid piiranguid sellele serverile.<br />
<br />
<br />
Testimaks, ega mõni tulemüür vahele ei sega võib kasutada programmi <tt>netcat</tt>:<br />
nc -z -vv services.krediidiinfo.ee 443<br />
Mõnes operatsioonisüsteemis on binaari nimi teine:<br />
netcat -z -vv services.krediidiinfo.ee 443<br />
<br />
Positiivne tulemus on:<br />
Connection to services.krediidiinfo.ee 443 port [tcp/https] succeeded!<br />
<br />
Näited negatiivsetest tulemustest on:<br />
nc: connect to services.krediidiinfo.ee port 443 (tcp) failed: Connection refused<br />
<br />
nc: connect to services.krediidiinfo.ee port 443 (tcp) failed: Connection timed out<br />
<br />
Samuti peaks olema võimalik ühenduda sama serveri tcp porti <tt>80</tt>, kust leiab [http://www.w3.org/TR/wsdl wsdl] failid ning sellesama wiki. Kui test ei õnnestu, tuleks pöörduda oma võrguadministraatori poole.<br />
<br />
== SOAP päringu näide ==<br />
<br />
Esiteks peab teadma, mis teenuse pihta päring teha. Antud näites kasutame [[KiCompany]] teenust, seega päringu URI on <tt>https://services.krediidiinfo.ee/soap.php?name=KiCompany</tt>.<br />
<br />
Teiseks on vaja SOAP päringut ennast, hoiame seda teksifailis nimega <tt>data.txt</tt>, faili sisu järgnev:<br />
<pre><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" <br />
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><br />
<SOAP-ENV:Body><br />
<m:findCompanies xmlns:m="urn:KiCompany" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"><br />
<name xsi:type="xsd:string">kredi</name><br />
<count xsi:type="xsd:int">2</count><br />
</m:findCompanies><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre><br />
<br />
Antud päring otsib firmasid, mis algavad stringiga <tt>kredi</tt> ning ei kuva rohkem kui kaks esimest vastust. (Päring on tasuline!)<br />
<br />
== curl kasutamine ==<br />
<br />
Testimiseks on mugav kasutada käsurea programmi <tt>curl</tt>. Krediidiinfo AS SOAP teenuse kasutamiseks peab <tt>curl</tt> olema kompileeritud SSL toega ning oskama https protokolli. Veenduge selles käsuga <tt>curl --version</tt>, tulemus:<br />
<br />
curl 7.19.6 (x86_64-redhat-linux-gnu) libcurl/7.19.6 NSS/3.12.4.1 Beta zlib/1.2.3 libidn/0.6.14 libssh2/0.18<br />
Protocols: tftp ftp telnet dict ldap ldaps http file '''https''' ftps scp sftp<br />
Features: GSS-Negotiate IDN IPv6 Largefile '''SSL''' libz<br />
<br />
=== curl SOAP päring kasutades autentimiseks HTTP Basic Authentication'it ===<br />
<br />
Krediidiinfo AS poolt on teile väljastatud kasutajanimi ja parool, siin näites olgu kasutajanimi "1234" ning parool "abc123".<br />
<br />
curl -d @data.txt -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki><br />
<br />
-d määrab päringu. @ märk failinime ees ütleb curl'ile, et tegemist on päringufaili, mitte päringu endaga.<br />
<br />
-u määrab kasutaja ja parooli, mis on eraldatud kooloniga.<br />
<br />
<br />
=== curl SOAP päring kasutades autentimiseks sertifikaati ja võtit ===<br />
<br />
Päringu tegemiseks on esiteks vaja Krediidiinfo AS poolt väljasatud sertifikaadi faili PEM formaadis, antud näites on failinimeks <tt>cert.pem</tt>. Välja näeb umbes selline:<br />
<pre><br />
-----BEGIN CERTIFICATE-----<br />
MIIEPpuguyIHJPOHuiGIOGilUYGOIGIYFGuyFUassafDFSDFpuASDaaGA1UEBhMC<br />
RUUxETAPiugUIOuphLBLUpuGIUIGigIPUbhpuiGIPYBuYBUKBLJYHFGuohGDVQQK<br />
Ew9LcmVkaWlkaWluZm8gQVMxCzAJBgNVBAsTAklUMSEwHwYDVQQDExhzZXJ2aWNl<br />
cy5rcmhlkjghGHGuZm8uZWUxITAfBgkqhkiG9w0BCQEWEml0QGtyZWRpaWRpaW5m<br />
by5lZTAeFw0wOTglgkGIOUGpguPIUgvIpiughphPhOPOUhpBHIUGMQswCQYDVQQG<br />
EwJFRTEQMA4GA1UECBMHRXN0b25pYTEQMA4GA1UEBxMHVGFsbGlubjEYMBYGA1UE<br />
VMtxvrdTVDhtRBDJrdYRBDRVBDTJrbDJBYYJRdYrdjbyRBUYRdBYJRdRRbUJrRYJ<br />
MTCMjfgukfgKGYGOYOUYGOygouYalsuUUGS4OCtgtrmzLw==<br />
-----END CERTIFICATE-----<br />
</pre><br />
<br />
<br />
Teiseks sertifikaadi võtme faili PEM formaadis, siin failinimeks <tt>key.pem</tt>. See fail on salajane ning kindlasti emaili teel või muul krüptimata viisil mitte vahendada!<br />
<br />
Samas võib selle faili sisu otsa liita <tt>cert.pem</tt> failile <tt>(cat key.pem >> cert.pem)</tt>, siis ei pea võtmefaili <tt>curl</tt>'le eraldi ette näitama. Paljud programmid nõuavad just kokku liidetud varianti. Näeb umbes selline välja, DSA variandi puhul on natuke rohkem erinevusi:<br />
<pre><br />
-----BEGIN RSA PRIVATE KEY-----<br />
Proc-Type: 4,ENCRYPTED<br />
DEK-Info: DES-EDE3-CBC,C1AA09832249D61D<br />
<br />
P85/RJFo2AX638mWtcOTglgkGIOUGpguPIUgvIpiughphPhOPOUhi0I+l5s+JSn5c<br />
jx69XBvi5L+Ytci9RW3zUiWrUDv89IY6DEmwluLX39/gX0TW7U+wos5b7ng/sNLQ<br />
tMyzCtIDACoGb5xHl48c3vY3JUzhrzQWNt2vuFjpGJI1lSOH8h0MdbQEA8iFKIOZ<br />
ng0po3SPW8c5wJtnLuKy8uZWUxITAfBgkqhkiG9w0BCQEWEml08uZWUxITAfBgkq<br />
oHeRz6KkZyXo7vbCbDXSFTuSHiwVwslF7hHbmmiPc4RYxB2EWfTjSUe8Fti9SWPa<br />
iJY0OisiQbePnEigZhfRboVZmQZFPWopgy8uZWUxITAfBgkqhkiG9w0BCQEWEml0<br />
8W1aXSBnNqtla1fmKKId9OkhiAZvavtKug8C9i27R2KR63h6uwq3ktwYtV1YWTHK<br />
Orx8Mf3HIGXpRSJJqjvZUu+xNrM06VcVajY9SJmt7OYXvSo5nKYguwbfGNh/FA7F<br />
Eo1KoKhQeGvWfCQzhEobc/QyegnklbaCUZhePoiL0Jk6Otgsav+2AA==<br />
-----END RSA PRIVATE KEY-----<br />
</pre><br />
<br />
Peab teadma ka sertifikaadi võtme parooli, kui võti on krüpteeritud. Antud näites olgu parool <tt>abcd1234</tt>.<br />
<br />
<br />
Päringu teostamine:<br />
<br />
curl -d @data.txt -cert $PWD/cert.pem:abcd1234 --key $PWD/key.pem <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki><br />
<br />
<br />
-d võti määrab päringu, @ failinime ees ütleb curl'ile, et tegemist on päringufaili, mitte päringu endaga.<br />
<br />
--cert võti määrab sertifikaadi faili asukoha. Tuleb kasutada "absolute path"-i. curl ei otsi faili antud kataloogist, seetõttu ka <tt>$PWD</tt> antud näites.<br />
Kui võti on krüpteeritud, saab parooli määrata serdifikaadi failinime taga, eraldades selle failinimest kooloniga.<br />
<br />
--key määrab võtmefaili asukoha. Kui sertifikaat ja võtmefail on üheks liidetud, siis seda ei ole vaja määrata.<br />
Seetõttu määrataksegi võtme parool --cert juures, mitte siin.<br />
<br />
<br />
== SOAP päringu tulemused ==<br />
<br />
=== Õnnestunud päring ===<br />
<br />
Õnnestunud tulemus (lisatud reavahetused loetavuse parandamiseks):<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:KiCompany" <br />
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" <br />
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"><br />
<SOAP-ENV:Body><br />
<ns1:findCompaniesResponse><br />
<companies SOAP-ENC:arrayType="ns1:CompanyIDData[2]" xsi:type="ns1:CompanyIDDataArray"><br />
<item xsi:type="ns1:CompanyIDData"><br />
<regCode xsi:type="ns1:regCode">11517686</regCode><br />
<name xsi:type="xsd:string">KREDICO OÜ</name><br />
</item><br />
<item xsi:type="ns1:CompanyIDData"><br />
<regCode xsi:type="ns1:regCode">90006012</regCode><br />
<name xsi:type="xsd:string">KREDIIDI JA EKSPORDI GARANTEERIMISE SITHASUTUS KREDEX</name><br />
</item><br />
</companies><br />
</ns1:findCompaniesResponse><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre><br />
<br />
=== Vigased päringud ===<br />
<br />
Viga GET parameetris (KiCompany asemel KiCompan):<br />
curl -d @data.txt -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompan</nowiki><br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"><br />
<SOAP-ENV:Body><br />
<SOAP-ENV:Fault><br />
<faultcode>SOAP-ENV:Server</faultcode><br />
<faultstring>Incorrect HTTP GET parameter 'name' value!</faultstring><br />
<faultactor></faultactor><br />
<detail><br />
<errorcode>-20002</errorcode><br />
<line_no>157</line_no><br />
</detail><br />
</SOAP-ENV:Fault><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre><br />
<br />
<br />
Vigane kasutaja või parool või sertifikaat:<br />
curl -d @data.txt -u 1234:abZZ23 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki><br />
<pre><br />
Krediidiinfo veebiteenuse kasutaja autentimine ebaõnnestus! Abi saamiseks võtke ühendust Krediidiinfoga telefonil (+372) 6659600.<br />
</pre><br />
<br />
<br />
Kasutajal ei ole õigust [[KiCompany]] kasutamiseks, pöörduge kliendihalduse poole:<br />
curl -d @data.txt -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki><br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"><br />
<SOAP-ENV:Body><br />
<SOAP-ENV:Fault><br />
<faultcode>SOAP-ENV:Server</faultcode><br />
<faultstring>Access denied for KiCompany!</faultstring><br />
<faultactor></faultactor><br />
<detail><br />
<errorcode>-20003</errorcode><br />
<line_no>106</line_no></detail><br />
</SOAP-ENV:Fault><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre><br />
<br />
<br />
SOAP päring puudub:<br />
curl -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki><br />
<pre><br />
<br />
</pre><br />
(tulemust pole)<br />
<br />
<br />
SOAP päringus endas on viga:<br />
curl -d @vigane.txt -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki><br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"><br />
<SOAP-ENV:Body><br />
<SOAP-ENV:Fault><br />
<faultcode>SOAP-ENV:Client</faultcode><br />
<faultstring>Bad Request</faultstring><br />
</SOAP-ENV:Fault><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre><br />
või<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"><br />
<SOAP-ENV:Body><br />
<SOAP-ENV:Fault><br />
<faultcode>SOAP-ENV:VersionMismatch</faultcode><br />
<faultstring>Wrong Version</faultstring><br />
</SOAP-ENV:Fault><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre></div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=SOAP_service_testing&diff=504
SOAP service testing
2013-06-13T08:42:06Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[SOAP_teenuse_testimine|eesti keeles]]<br />
|}<br />
<br />
Krediidiinfo AS SOAP service is tested using <tt>curl</tt> software and the [[KiCompany_en | KiCompany]] service. Other Krediidiinfo AS SOAP services can also be tested in the same way.<br />
<br />
Authentication is possible using the certificate/key pair as well as the HTTP Basic Authentication user name and password. In addition to the password or certificate, the user needs to have been issued a permission to use the [[KiCompany_en | KiCompany]] service by Krediidiinfo AS customer service.<br />
<br />
If the following tests in the client's environment are successful, it can be stated that the certificate or password issued to the client is valid, and the permissions to use [[KiCompany_en | KiCompany]] are correctly set.<br />
<br />
<br />
== Network test ==<br />
<br />
The request's source environment must be able to connect to the <tt>services.krediidiinfo.ee</tt> server using the tcp port number <tt>443</tt>. Krediidiinfo AS has not set any IP-based limitations to that server.<br />
<br />
The <tt>netcat</tt> utility can be used in order to test whether there is a firewall blocking the connection:<br />
nc -z -vv services.krediidiinfo.ee 443<br />
In some operating systems the binary has a different name:<br />
netcat -z -vv services.krediidiinfo.ee 443<br />
<br />
The positive result would be:<br />
Connection to services.krediidiinfo.ee 443 port [tcp/https] succeeded!<br />
<br />
Examples of negative results:<br />
nc: connect to services.krediidiinfo.ee port 443 (tcp) failed: Connection refused<br />
<br />
nc: connect to services.krediidiinfo.ee port 443 (tcp) failed: Connection timed out<br />
<br />
Also it should be possible to connect to the tcp port <tt>80</tt>, of the same server, which hosts the [http://www.w3.org/TR/wsdl wsdl] files and this wiki. If the test fails, please contact your network administrator<br />
<br />
== SOAP request example ==<br />
<br />
First of all we must know the name of the service to be requested. In this example we use the [[KiCompany_en | KiCompany]] service, so the request URI would be <tt>https://services.krediidiinfo.ee/soap.php?name=KiCompany</tt>.<br />
<br />
Next we need the SOAP request itself, which is kept in a text file named <tt>data.txt</tt>, The contents of the file are as follows:<br />
<pre><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" <br />
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><br />
<SOAP-ENV:Body><br />
<m:findCompanies xmlns:m="urn:KiCompany" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"><br />
<name xsi:type="xsd:string">kredi</name><br />
<count xsi:type="xsd:int">2</count><br />
</m:findCompanies><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre><br />
<br />
This request searches for companies with names that starts with <tt>kredi</tt> and displays only the first two results. (The request involves the payment of a fee!)<br />
<br />
== Using curl==<br />
<br />
The command-line tool <tt>curl</tt> is a convenient testing utility. To use the Krediidiinfo AS SOAP service, <tt>curl</tt> must be compiled with SSL support and must support https protocol. You can check whether this is the case by using the command <tt>curl --version</tt>; the result:<br />
<br />
curl 7.19.6 (x86_64-redhat-linux-gnu) libcurl/7.19.6 NSS/3.12.4.1 Beta zlib/1.2.3 libidn/0.6.14 libssh2/0.18<br />
Protocols: tftp ftp telnet dict ldap ldaps http file '''https''' ftps scp sftp<br />
Features: GSS-Negotiate IDN IPv6 Largefile '''SSL''' libz<br />
<br />
=== curl SOAP request, using HTTP Basic Authentication ===<br />
<br />
Krediidiinfo AS has issued you a user name and password. In this example, the user name is "1234" and password is "abc123".<br />
<br />
curl -d @data.txt -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki><br />
<br />
-d specifies the request. @ before the file name specifies that it is a request file, not a request.<br />
<br />
-u specifies user name and password, delimited with a colon.<br />
<br />
<br />
=== curl SOAP request, using a certificate and a key as the authentication method ===<br />
<br />
To make a request you need a certificate file issued by Krediidiinfo AS in the PEM format. In this example the file is named <tt>cert.pem</tt>. It looks like this:<br />
<pre><br />
-----BEGIN CERTIFICATE-----<br />
MIIEPpuguyIHJPOHuiGIOGilUYGOIGIYFGuyFUassafDFSDFpuASDaaGA1UEBhMC<br />
RUUxETAPiugUIOuphLBLUpuGIUIGigIPUbhpuiGIPYBuYBUKBLJYHFGuohGDVQQK<br />
Ew9LcmVkaWlkaWluZm8gQVMxCzAJBgNVBAsTAklUMSEwHwYDVQQDExhzZXJ2aWNl<br />
cy5rcmhlkjghGHGuZm8uZWUxITAfBgkqhkiG9w0BCQEWEml0QGtyZWRpaWRpaW5m<br />
by5lZTAeFw0wOTglgkGIOUGpguPIUgvIpiughphPhOPOUhpBHIUGMQswCQYDVQQG<br />
EwJFRTEQMA4GA1UECBMHRXN0b25pYTEQMA4GA1UEBxMHVGFsbGlubjEYMBYGA1UE<br />
VMtxvrdTVDhtRBDJrdYRBDRVBDTJrbDJBYYJRdYrdjbyRBUYRdBYJRdRRbUJrRYJ<br />
MTCMjfgukfgKGYGOYOUYGOygouYalsuUUGS4OCtgtrmzLw==<br />
-----END CERTIFICATE-----<br />
</pre><br />
<br />
<br />
Also you need a certificate key file in the PEM format, which, in this example, is named <tt>key.pem</tt>. This is a secret file and must not be transmitted via e-mail or by other unencrypted methods.<br />
<br />
However, the contents of this file may be added directly to the <tt>cert.pem</tt> file <tt>(cat key.pem >> cert.pem)</tt>, thus making it unnecessary to specify the key file for <tt>curl</tt>. Various programs specifically request such concatenated files. It looks similar to the following example; only the DSA option has some more differences:<br />
<pre><br />
-----BEGIN RSA PRIVATE KEY-----<br />
Proc-Type: 4,ENCRYPTED<br />
DEK-Info: DES-EDE3-CBC,C1AA09832249D61D<br />
<br />
P85/RJFo2AX638mWtcOTglgkGIOUGpguPIUgvIpiughphPhOPOUhi0I+l5s+JSn5c<br />
jx69XBvi5L+Ytci9RW3zUiWrUDv89IY6DEmwluLX39/gX0TW7U+wos5b7ng/sNLQ<br />
tMyzCtIDACoGb5xHl48c3vY3JUzhrzQWNt2vuFjpGJI1lSOH8h0MdbQEA8iFKIOZ<br />
ng0po3SPW8c5wJtnLuKy8uZWUxITAfBgkqhkiG9w0BCQEWEml08uZWUxITAfBgkq<br />
oHeRz6KkZyXo7vbCbDXSFTuSHiwVwslF7hHbmmiPc4RYxB2EWfTjSUe8Fti9SWPa<br />
iJY0OisiQbePnEigZhfRboVZmQZFPWopgy8uZWUxITAfBgkqhkiG9w0BCQEWEml0<br />
8W1aXSBnNqtla1fmKKId9OkhiAZvavtKug8C9i27R2KR63h6uwq3ktwYtV1YWTHK<br />
Orx8Mf3HIGXpRSJJqjvZUu+xNrM06VcVajY9SJmt7OYXvSo5nKYguwbfGNh/FA7F<br />
Eo1KoKhQeGvWfCQzhEobc/QyegnklbaCUZhePoiL0Jk6Otgsav+2AA==<br />
-----END RSA PRIVATE KEY-----<br />
</pre><br />
<br />
Also, in the case of an encrypted key, you must know the certificate key password. The password in this example is <tt>abcd1234</tt>.<br />
<br />
<br />
Making a request:<br />
<br />
curl -d @data.txt -cert $PWD/cert.pem:abcd1234 --key $PWD/key.pem <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki><br />
<br />
<br />
-d specifies the request, @ before the file name specifies that it is a request file, not a request.<br />
<br />
--cert key specifies the location of certificate file. Absolute path must be used. curl is not looking for the file in given directory, hence the $PWD in the example.<br />
If the key is encrypted, the password can be provided after the certificate file name, separating it from the file name by a colon.<br />
<br />
--key determines the location of the key file. It is not necessary, if the certificate and key files are merged into a single file.<br />
This is why the key password is specified with the --cert option, not here.<br />
<br />
<br />
== SOAP request results ==<br />
<br />
=== Successful request ===<br />
<br />
Successful request (line spacing added for easier reading):<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:KiCompany" <br />
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" <br />
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"><br />
<SOAP-ENV:Body><br />
<ns1:findCompaniesResponse><br />
<companies SOAP-ENC:arrayType="ns1:CompanyIDData[2]" xsi:type="ns1:CompanyIDDataArray"><br />
<item xsi:type="ns1:CompanyIDData"><br />
<regCode xsi:type="ns1:regCode">11517686</regCode><br />
<name xsi:type="xsd:string">KREDICO OÜ</name><br />
</item><br />
<item xsi:type="ns1:CompanyIDData"><br />
<regCode xsi:type="ns1:regCode">90006012</regCode><br />
<name xsi:type="xsd:string">KREDIIDI JA EKSPORDI GARANTEERIMISE SITHASUTUS KREDEX</name><br />
</item><br />
</companies><br />
</ns1:findCompaniesResponse><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre><br />
<br />
=== Invalid requests ===<br />
<br />
Error in GET parameter (KiCompan instead of KiCompany):<br />
curl -d @data.txt -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompan</nowiki><br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"><br />
<SOAP-ENV:Body><br />
<SOAP-ENV:Fault><br />
<faultcode>SOAP-ENV:Server</faultcode><br />
<faultstring>Incorrect HTTP GET parameter 'name' value!</faultstring><br />
<faultactor></faultactor><br />
<detail><br />
<errorcode>-20002</errorcode><br />
<line_no>157</line_no><br />
</detail><br />
</SOAP-ENV:Fault><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre><br />
<br />
<br />
Invalid user name, password or certificate:<br />
curl -d @data.txt -u 1234:abZZ23 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki><br />
<pre><br />
Authentication of Krediidiinfo web service user failed! For assistance, please contact Krediidiinfo by calling (+372) 6659600.<br />
</pre><br />
<br />
<br />
User has no permission to use [[KiCompany_en | KiCompany]] please contact our customer service:<br />
curl -d @data.txt -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki><br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"><br />
<SOAP-ENV:Body><br />
<SOAP-ENV:Fault><br />
<faultcode>SOAP-ENV:Server</faultcode><br />
<faultstring>Access denied for KiCompany!</faultstring><br />
<faultactor></faultactor><br />
<detail><br />
<errorcode>-20003</errorcode><br />
<line_no>106</line_no></detail><br />
</SOAP-ENV:Fault><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre><br />
<br />
<br />
Missing SOAP request:<br />
curl -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki><br />
<pre><br />
<br />
</pre><br />
(no results)<br />
<br />
<br />
Error in the SOAP request itself:<br />
curl -d @vigane.txt -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki><br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"><br />
<SOAP-ENV:Body><br />
<SOAP-ENV:Fault><br />
<faultcode>SOAP-ENV:Client</faultcode><br />
<faultstring>Bad Request</faultstring><br />
</SOAP-ENV:Fault><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre><br />
or<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"><br />
<SOAP-ENV:Body><br />
<SOAP-ENV:Fault><br />
<faultcode>SOAP-ENV:VersionMismatch</faultcode><br />
<faultstring>Wrong Version</faultstring><br />
</SOAP-ENV:Fault><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre></div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Error_codes&diff=503
Error codes
2013-06-13T08:41:20Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Veakoodid|eesti keeles]]<br />
|}<br />
<br />
= Error codes =<br />
<br />
== SOAP server error codes ==<br />
<br />
===-20001 Internal error ===<br />
<br />
Internal server error. Please contact Krediidiinfo [[Tehniline tugi | technical support]].<br />
<br />
===-20002 Incorrect HTTP GET parameter 'name' value!===<br />
<br />
Please check the URL for the value of GET parameter 'name'. The parameter is either missing a value or the value is not a valid web service interface name. <br />
<br />
===-20003 Access Denied ===<br />
<br />
No permission to access a particular interface. Please contact Krediidiinfo [[Klienditugi |customer support]].<br />
<br />
===-20004 Test requests denied ===<br />
<br />
No permission to make requests in the test environment in [[Web_Service_Debugging|debug mode]]. Please contact Krediidiinfo [[Klienditugi |customer support]].<br />
<br />
===-20005 Live requests denied ===<br />
<br />
Although permission to use the interface has been granted, the right to make requests to the application server has been denied. Commonly used in development. Sometimes when permission is granted to request the test server, permission to make requests to the application server is removed. Please contact Krediidiinfo [[Klienditugi |customer support]].<br />
<br />
== Authentication errors ==<br />
<br />
===-10011 Client certificate not found ===<br />
<br />
The request was made without a certificate.<br />
<br />
=== -10012 Certificate revoked===<br />
<br />
The certificate has expired. Please contact Krediidiinfo [[Klienditugi |customer support]].</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Veakoodid&diff=502
Veakoodid
2013-06-13T08:40:56Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Error_codes|In English]]<br />
|}<br />
<br />
= Veakoodid =<br />
<br />
== SOAP serveri veakoodid ==<br />
<br />
===-20001 Internal error ===<br />
<br />
Serverisisene viga. Võta ühendust Krediidiinfo [[Tehniline tugi | tehnilise toega]].<br />
<br />
===-20002 Incorrect HTTP GET parameter 'name' value!===<br />
<br />
Kontrolli URL-is GET parameetri 'name' väärtust. Parameeter on kas puudu või väärtuseks ei ole korrektne veebiteenuse liidese nime.<br />
<br />
===-20003 Access Denied ===<br />
<br />
Puuduvad õigused konkreetse liidese kasutamiseks. Võtke ühendust Krediidiinfo [[Klienditugi |klienditoega]].<br />
<br />
===-20004 Test requests denied ===<br />
<br />
Puuduvad õigused teha päringuid [[Veebiteenuste_silumine#Veebiteenuste silumine|silumise režiimis]] testkeskkonda. Võtke ühendust Krediidiinfo [[Klienditugi |klienditoega]].<br />
<br />
===-20005 Live requests denied ===<br />
<br />
Kuigi liidese kasutamiseks on õigused antud, on ära võetud õigus teha päringut rakendusserverisse. Kasutatakse tavaliselt arendamisel. Kui antakse õigused teha päringuid testserverisse, siis mõni kord võetakse samal ajal maha õigus teha päringuid rakendusserverisse. Võtke ühendust Krediidiinfo [[Klienditugi |klienditoega]].<br />
<br />
== Autentimise vead ==<br />
<br />
===-10011 Client certificate not found ===<br />
<br />
Päring tehti ilma sertifikaadita.<br />
<br />
=== -10012 Certificate revoked===<br />
<br />
Sertifikaat on aegunud. Võtke ühendust Krediidiinfo [[Klienditugi |klienditoega]].</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Veat%C3%B6%C3%B6tlus&diff=501
Veatöötlus
2013-06-13T08:40:04Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Exeption_handling|In English]]<br />
|}<br />
<br />
= SOAP veateade=<br />
Kui serveris tekib päringu töötlemisel veaolukord (Exception), siis tagastab Krediidiinfo SOAP server alati SOAP veateate ([http://www.w3schools.com/soap/soap_fault.asp|SOAP Fault Element]).<br />
<br />
<br />
SOAP veateate näidis:<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"><br />
<SOAP-ENV:Body><br />
<SOAP-ENV:Fault><br />
<faultcode>SOAP-ENV:Server</faultcode><br />
<faultstring>certificate not found</faultstring><br />
<faultactor/><br />
<detail><br />
<errorcode>-10011</errorcode><br />
<line_no>33</line_no><br />
</detail><br />
</SOAP-ENV:Fault><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre><br />
<br />
= Kasutaja teavitamine vigadest = <br />
<br />
Märgendis ''faultstring'' on veateade inimesele loetaval kujul ning märgendis ''detail/errorcode'' on veakood. <br />
<br />
Kui SOAP veateates on olemas ''detail/errorcode'' siis tekkis viga Krediidiinfo serveris. Kui ''detail/errorcode'' puudub, siis on enamasti tegemist Krediidiinfo serverist mittesõltuvates põhjustes. <br />
<br />
Kui SOAP veateade on saadetud Krediidiinfo serveri poolt, siis tuleb lõppkasutajale alati kuvada nii veakood (''errorcode'') kui ka -teade (''faultstring'')!<br />
<br />
Soovitav on kuvada teade järgmiselt:<br />
<br />
<pre><br />
Krediidiinfo AS veebiteenuse (<nimi>) päring ebaõnnestus!<br />
[errorcode] faultstring <br />
Abi saamiseks võtke ühendust Krediidiinfoga telefonil 6659600.<br />
</pre><br />
<br />
<nimi> asemele panna veebiteenuse nimetus (KiDocExchange, KiReport vms). Enamasti on need vea põhjused Krediidiinfo poolt lahendatavad (näiteks puuduvad õigused mingi päringu tegemiseks vms).</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Exeption_handling&diff=500
Exeption handling
2013-06-13T08:39:17Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Veat%C3%B6%C3%B6tlus|eesti keeles]]<br />
|}<br />
<br />
= SOAP fault element=<br />
If the server encounters an exception during request processing, the Krediidiinfo SOAP server will always return a SOAP fault element ([http://www.w3schools.com/soap/soap_fault.asp|SOAP Fault Element]).<br />
<br />
<br />
Example of a SOAP fault element:<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"><br />
<SOAP-ENV:Body><br />
<SOAP-ENV:Fault><br />
<faultcode>SOAP-ENV:Server</faultcode><br />
<faultstring>certificate not found</faultstring><br />
<faultactor/><br />
<detail><br />
<errorcode>-10011</errorcode><br />
<line_no>33</line_no><br />
</detail><br />
</SOAP-ENV:Fault><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre><br />
<br />
= Reporting exceptions to the user = <br />
<br />
The tag ''faultstring'' contains a user-friendly error message, while the tag ''detail/errorcode'' contains the error code. <br />
<br />
If the SOAP fault element contains a ''detail/errorcode'', the exception occurred in the Krediidiinfo server. If there is no ''detail/errorcode'', the exception is usually unrelated to the Krediidiinfo server. <br />
<br />
If SOAP fault element is sent by the Krediidiinfo server, the end user must always be displayed both the error code (''errorcode'') as well as the fault element (''faultstring'')!<br />
<br />
It is recommended that the message be displayed as follows:<br />
<br />
<pre><br />
Krediidiinfo AS web service (<name>) request failed!<br />
[errorcode] faultstring <br />
For assistance, please contact Krediidiinfo: (372) 6659 600.<br />
</pre><br />
<br />
<name> to be replaced with the name of web service (KiDocExchange, KiReport, etc). Generally the reasons for such errors can be resolved by Krediidiinfo (e.g. if the user does not have the authorisation to make a certain request, etc.).</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Exeption_handling&diff=499
Exeption handling
2013-06-13T08:38:53Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Main_Page|eesti keeles]]<br />
|}<br />
<br />
= SOAP fault element=<br />
If the server encounters an exception during request processing, the Krediidiinfo SOAP server will always return a SOAP fault element ([http://www.w3schools.com/soap/soap_fault.asp|SOAP Fault Element]).<br />
<br />
<br />
Example of a SOAP fault element:<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"><br />
<SOAP-ENV:Body><br />
<SOAP-ENV:Fault><br />
<faultcode>SOAP-ENV:Server</faultcode><br />
<faultstring>certificate not found</faultstring><br />
<faultactor/><br />
<detail><br />
<errorcode>-10011</errorcode><br />
<line_no>33</line_no><br />
</detail><br />
</SOAP-ENV:Fault><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre><br />
<br />
= Reporting exceptions to the user = <br />
<br />
The tag ''faultstring'' contains a user-friendly error message, while the tag ''detail/errorcode'' contains the error code. <br />
<br />
If the SOAP fault element contains a ''detail/errorcode'', the exception occurred in the Krediidiinfo server. If there is no ''detail/errorcode'', the exception is usually unrelated to the Krediidiinfo server. <br />
<br />
If SOAP fault element is sent by the Krediidiinfo server, the end user must always be displayed both the error code (''errorcode'') as well as the fault element (''faultstring'')!<br />
<br />
It is recommended that the message be displayed as follows:<br />
<br />
<pre><br />
Krediidiinfo AS web service (<name>) request failed!<br />
[errorcode] faultstring <br />
For assistance, please contact Krediidiinfo: (372) 6659 600.<br />
</pre><br />
<br />
<name> to be replaced with the name of web service (KiDocExchange, KiReport, etc). Generally the reasons for such errors can be resolved by Krediidiinfo (e.g. if the user does not have the authorisation to make a certain request, etc.).</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Web_Service_Debugging&diff=498
Web Service Debugging
2013-06-13T08:37:27Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Veebiteenuste_silumine|eesti keeles]]<br />
|}<br />
<br />
= Server Test =<br />
<br />
Krediidiinfo SOAP server has some built-in debugging features.<br />
<br />
Certificate or SOAP server can be tested at url [https://services.krediidiinfo.ee/soap.php?ping https://services.krediidiinfo.ee/soap.php?ping].<br />
<br />
The response should be: ''KI SOAP server is working!''<br />
<br />
There is a possibility to make an empty query at [https://services.krediidiinfo.ee/soap.php?dummy_response https://services.krediidiinfo.ee/soap.php?dummy_response] in order to test connection. The SOAP server response should be:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"><br />
<SOAP-ENV:Body><br />
<SOAP-ENV:Fault><br />
<faultcode>SOAP-ENV:Server</faultcode><br />
<faultstring>Bad Request. Can't find HTTP_RAW_POST_DATA [DUMMY RESPONCE]</faultstring><br />
</SOAP-ENV:Fault><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre><br />
<br />
= Web Service Debugging =<br />
<br />
Some web services can run in debug mode. In debug mode the SOAP server is connected to test environment.<br />
<br />
To make request in debug mode you have to add a GET parameter ''&debug'' at the end of url.<br />
<br />
For example, KiDocExchange interface URL is:<br />
<br />
<pre><br />
https://services.krediidiinfo.ee/soap.php?name=KiDocExchange<br />
</pre><br />
<br />
In debug mode the URL is:<br />
<pre><br />
https://services.krediidiinfo.ee/soap.php?name=KiDocExchange&debug<br />
</pre><br />
<br />
NB! Krediidiinfo must give proper permissions for user to make request in debug mode. If the permissions are not granted then the server will return error message with the code -20004.<br />
<br />
= Fault message =<br />
<br />
If the SOAP request fails, the server returns a standard SOAP error message. The Krediidiinfo SOAP error message has detailed information in ''Fault'' tag. The detailed information is:<br />
<br />
* Fault\details\errorcode - Error code<br />
* Fault\details\exception_name - Exception name<br />
* Fault\details\line_no - Line number where the error occured<br />
<br />
Error code meanings can be found in specific SOAP Web Server interface or in [[Veakoodid| general error code page]]. You can also contact with [[Tehniline tugi|support]].</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Web_Service_Debugging&diff=497
Web Service Debugging
2013-06-13T08:36:57Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Main_Page|eesti keeles]]<br />
|}<br />
<br />
= Server Test =<br />
<br />
Krediidiinfo SOAP server has some built-in debugging features.<br />
<br />
Certificate or SOAP server can be tested at url [https://services.krediidiinfo.ee/soap.php?ping https://services.krediidiinfo.ee/soap.php?ping].<br />
<br />
The response should be: ''KI SOAP server is working!''<br />
<br />
There is a possibility to make an empty query at [https://services.krediidiinfo.ee/soap.php?dummy_response https://services.krediidiinfo.ee/soap.php?dummy_response] in order to test connection. The SOAP server response should be:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"><br />
<SOAP-ENV:Body><br />
<SOAP-ENV:Fault><br />
<faultcode>SOAP-ENV:Server</faultcode><br />
<faultstring>Bad Request. Can't find HTTP_RAW_POST_DATA [DUMMY RESPONCE]</faultstring><br />
</SOAP-ENV:Fault><br />
</SOAP-ENV:Body><br />
</SOAP-ENV:Envelope><br />
</pre><br />
<br />
= Web Service Debugging =<br />
<br />
Some web services can run in debug mode. In debug mode the SOAP server is connected to test environment.<br />
<br />
To make request in debug mode you have to add a GET parameter ''&debug'' at the end of url.<br />
<br />
For example, KiDocExchange interface URL is:<br />
<br />
<pre><br />
https://services.krediidiinfo.ee/soap.php?name=KiDocExchange<br />
</pre><br />
<br />
In debug mode the URL is:<br />
<pre><br />
https://services.krediidiinfo.ee/soap.php?name=KiDocExchange&debug<br />
</pre><br />
<br />
NB! Krediidiinfo must give proper permissions for user to make request in debug mode. If the permissions are not granted then the server will return error message with the code -20004.<br />
<br />
= Fault message =<br />
<br />
If the SOAP request fails, the server returns a standard SOAP error message. The Krediidiinfo SOAP error message has detailed information in ''Fault'' tag. The detailed information is:<br />
<br />
* Fault\details\errorcode - Error code<br />
* Fault\details\exception_name - Exception name<br />
* Fault\details\line_no - Line number where the error occured<br />
<br />
Error code meanings can be found in specific SOAP Web Server interface or in [[Veakoodid| general error code page]]. You can also contact with [[Tehniline tugi|support]].</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Creditinfo_Web_Services_Architecture_en&diff=496
Creditinfo Web Services Architecture en
2013-06-13T08:35:53Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Krediidiinfo_veebiteenuste_arhitektuur|eesti keeles]]<br />
|}<br />
= Introduction =<br />
<br />
Krediidiinfo web services are based on SOAP protocol. There is a central SOAP server for the services located at [https://services.krediidiinfo.ee/soap.php https://services.krediidiinfo.ee/soap.php]. <br />
<br />
Every web service has a name (for example, KiCompanyBasic, KiReport). The name determines the WSDL-file location in the following format:<br />
<br />
<pre><br />
http://services.krediidiinfo.ee/<veebiteenuse_nimi>.wsdl<br />
</pre><br />
<br />
For example, the location for KiCompanyBasic WSDL would be: [http://services.krediidiinfo.ee/KiCompanyBasic.wsdl http://services.krediidiinfo.ee/KiCompanyBasic.wsdl].<br />
<br />
= Authentication =<br />
<br />
There are two ways of web service user authentication:<br />
<br />
# 1. via '''HTTP Basic Access'''<br />
# 2. using a certificate issued by Krediidiinfo<br />
<br />
Requests for a user name and password or a certificate should be submitted to [[Klienditugi | customer service]].<br />
<br />
= Security =<br />
<br />
All data exchange between the client and the server takes place using the HTTPS protocol.</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Creditinfo_Web_Services_Architecture_en&diff=495
Creditinfo Web Services Architecture en
2013-06-13T08:35:25Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Main_Page|eesti keeles]]<br />
|}<br />
= Introduction =<br />
<br />
Krediidiinfo web services are based on SOAP protocol. There is a central SOAP server for the services located at [https://services.krediidiinfo.ee/soap.php https://services.krediidiinfo.ee/soap.php]. <br />
<br />
Every web service has a name (for example, KiCompanyBasic, KiReport). The name determines the WSDL-file location in the following format:<br />
<br />
<pre><br />
http://services.krediidiinfo.ee/<veebiteenuse_nimi>.wsdl<br />
</pre><br />
<br />
For example, the location for KiCompanyBasic WSDL would be: [http://services.krediidiinfo.ee/KiCompanyBasic.wsdl http://services.krediidiinfo.ee/KiCompanyBasic.wsdl].<br />
<br />
= Authentication =<br />
<br />
There are two ways of web service user authentication:<br />
<br />
# 1. via '''HTTP Basic Access'''<br />
# 2. using a certificate issued by Krediidiinfo<br />
<br />
Requests for a user name and password or a certificate should be submitted to [[Klienditugi | customer service]].<br />
<br />
= Security =<br />
<br />
All data exchange between the client and the server takes place using the HTTPS protocol.</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Creditinfo_veebiteenuste_arhitektuur&diff=494
Creditinfo veebiteenuste arhitektuur
2013-06-13T08:35:00Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Krediidiinfo Web Services Architecture_en|In English]]<br />
|}<br />
= Tutvustus =<br />
<br />
Krediidiinfo veebiteenused kastutavad SOAP andmevahetusprotokolli. Teenuste jaoks on tsentraalne SOAP server aadressil [https://services.krediidiinfo.ee/soap.php https://services.krediidiinfo.ee/soap.php]. <br />
<br />
Kõik veebiteenused omavad nime (näiteks KiCompanyBasic, KiReport). Nime järgi saab alati tuletada WSDL faili asukoha, milleks on:<br />
<br />
<pre><br />
http://services.krediidiinfo.ee/<veebiteenuse_nimi>.wsdl<br />
</pre><br />
<br />
Näiteks KiCompanyBasic WSDL asub aadressil [http://services.krediidiinfo.ee/KiCompanyBasic.wsdl http://services.krediidiinfo.ee/KiCompanyBasic.wsdl].<br />
<br />
= Autentimine =<br />
<br />
Veebiteenuse kasutajate autentimiseks on kaks võimalust:<br />
<br />
# kasutades ''HTTP Basic Access'''i<br />
# kasutades Krediidiinfo väljastatud sertifikaati<br />
<br />
Kasutajanime ja parooli või sertifikaatide saamiseks tuleb pöörduda [[Klienditugi | klienditoe]] poole.<br />
<br />
= Turvalisus =<br />
<br />
Kogu andmevahetus kliendi ja serveri vahel toimub üle HTTPS-i.</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Creditinfo_veebiteenuste_arhitektuur&diff=493
Creditinfo veebiteenuste arhitektuur
2013-06-13T08:34:33Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Main page__en|In English]]<br />
|}<br />
= Tutvustus =<br />
<br />
Krediidiinfo veebiteenused kastutavad SOAP andmevahetusprotokolli. Teenuste jaoks on tsentraalne SOAP server aadressil [https://services.krediidiinfo.ee/soap.php https://services.krediidiinfo.ee/soap.php]. <br />
<br />
Kõik veebiteenused omavad nime (näiteks KiCompanyBasic, KiReport). Nime järgi saab alati tuletada WSDL faili asukoha, milleks on:<br />
<br />
<pre><br />
http://services.krediidiinfo.ee/<veebiteenuse_nimi>.wsdl<br />
</pre><br />
<br />
Näiteks KiCompanyBasic WSDL asub aadressil [http://services.krediidiinfo.ee/KiCompanyBasic.wsdl http://services.krediidiinfo.ee/KiCompanyBasic.wsdl].<br />
<br />
= Autentimine =<br />
<br />
Veebiteenuse kasutajate autentimiseks on kaks võimalust:<br />
<br />
# kasutades ''HTTP Basic Access'''i<br />
# kasutades Krediidiinfo väljastatud sertifikaati<br />
<br />
Kasutajanime ja parooli või sertifikaatide saamiseks tuleb pöörduda [[Klienditugi | klienditoe]] poole.<br />
<br />
= Turvalisus =<br />
<br />
Kogu andmevahetus kliendi ja serveri vahel toimub üle HTTPS-i.</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Autentimine&diff=492
Autentimine
2013-06-13T08:32:14Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Authentication|In English]]<br />
|}<br />
* Basic Authentication<br />
<br />
Autentimiseks kasutatakse standartset autentimise protokolli [http://en.wikipedia.org/wiki/Basic_access_authentication http://en.wikipedia.org/wiki/Basic_access_authentication]. Arendajate jaoks on tehtud näide [[Basic Authentication näide|HTTP päisest]].<br />
<br />
<br />
== Autentimine brauseris ==<br />
<br />
Kui raportit päritakse brauseris, küsitakse kasutajanime ja parooli Basic Authentication meetodil [http://en.wikipedia.org/wiki/Basic_access_authentication http://en.wikipedia.org/wiki/Basic_access_authentication]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Main_page_en&diff=491
Main page en
2013-06-13T08:31:55Z
<p>Kart: /* For developers */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Main_Page|eesti keeles]]<br />
|}<br />
<br />
<br />
Here you can find Krediidiinfo web services' documentation and samples.<br />
<br />
= Krediidiinfo web services =<br />
* [[KiReport_en|Requesting XML reports]]<br />
* [[Kireport.php_en|Requesting PDF ja HTML reports]]<br />
* [[KiDocExchange_en | KiDocExchange]]<br />
* [[KiCompanyBasic_en | KiCompanyBasic]]<br />
* [[KiCompany_en | KiCompany]]<br />
* [[KiCreditRiskManagement_en | KiCreditRiskManagement]]<br />
<br />
= For developers =<br />
* [[Krediidiinfo Web Services Architecture_en | Krediidiinfo Web Services Architecture]]<br />
* [[Autentimine_en|Authentication]]<br />
* [[Web_Service_Debugging | Web Service Debugging]]<br />
* [[Exeption handling]]<br />
* [[Error codes]]<br />
* [[SOAP service testing]]<br />
* [[Tehniline tugi| Technical support]]<br />
* Used standards/protocols<br />
** [http://www.w3schools.com/xml/default.asp XML]<br />
** [http://www.w3schools.com/schema/default.asp XML Schema]<br />
** [http://www.w3schools.com/soap/default.asp SOAP]<br />
** [http://www.w3schools.com/wsdl/default.asp WSDL]<br />
<br />
= Samples =<br />
* [[KiCompanyBasic | KiCompanyBasic - '''<span style="color:red;">Free interface!</span>''']]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Autentimine_en&diff=490
Autentimine en
2013-06-13T08:30:54Z
<p>Kart: /* Authentication in browser */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Autentimine|eesti keeles]]<br />
|}<br />
<br />
* Basic Authentication<br />
<br />
The standard authentication protocol is used for authentication [http://en.wikipedia.org/wiki/Basic_access_authentication http://en.wikipedia.org/wiki/Basic_access_authentication]. An example for developers is made: [[Basic Authentication näide|HTTP header]].<br />
<br />
<br />
== Browser-based authentication ==<br />
<br />
<br />
If the report is requested in the browser, an username and password is required according to the Basic Authentication method [http://en.wikipedia.org/wiki/Basic_access_authentication http://en.wikipedia.org/wiki/Basic_access_authentication]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Autentimine_en&diff=489
Autentimine en
2013-06-13T08:30:12Z
<p>Kart: /* Authentication in browser */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Autentimine|eesti keeles]]<br />
|}<br />
<br />
* Basic Authentication<br />
<br />
The standard authentication protocol is used for authentication [http://en.wikipedia.org/wiki/Basic_access_authentication http://en.wikipedia.org/wiki/Basic_access_authentication]. An example for developers is made: [[Basic Authentication näide|HTTP header]].<br />
<br />
<br />
== Authentication in browser ==<br />
<br />
<br />
If the report is requested in the browser, an username and password is required according to the Basic Authentication method [http://en.wikipedia.org/wiki/Basic_access_authentication http://en.wikipedia.org/wiki/Basic_access_authentication]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Autentimine&diff=488
Autentimine
2013-06-13T08:28:15Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Authentication|In English]]<br />
|}<br />
<br />
<br />
* Basic Authentication<br />
<br />
Autentimiseks kasutatakse standartset autentimise protokolli [http://en.wikipedia.org/wiki/Basic_access_authentication http://en.wikipedia.org/wiki/Basic_access_authentication]. Arendajate jaoks on tehtud näide [[Basic Authentication näide|HTTP päisest]].<br />
<br />
<br />
== Autentimine brauseris ==<br />
<br />
Kui raportit päritakse brauseris, küsitakse kasutajanime ja parooli Basic Authentication meetodil [http://en.wikipedia.org/wiki/Basic_access_authentication http://en.wikipedia.org/wiki/Basic_access_authentication]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Autentimine&diff=487
Autentimine
2013-06-13T08:28:01Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Authentication_en|In English]]<br />
|}<br />
<br />
<br />
* Basic Authentication<br />
<br />
Autentimiseks kasutatakse standartset autentimise protokolli [http://en.wikipedia.org/wiki/Basic_access_authentication http://en.wikipedia.org/wiki/Basic_access_authentication]. Arendajate jaoks on tehtud näide [[Basic Authentication näide|HTTP päisest]].<br />
<br />
<br />
== Autentimine brauseris ==<br />
<br />
Kui raportit päritakse brauseris, küsitakse kasutajanime ja parooli Basic Authentication meetodil [http://en.wikipedia.org/wiki/Basic_access_authentication http://en.wikipedia.org/wiki/Basic_access_authentication]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Main_Page&diff=486
Main Page
2013-06-13T08:25:48Z
<p>Kart: /* Krediidiinfo veebiteenused */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Main page__en|In English]]<br />
|}<br />
<br />
<br />
Lehelt leiate Krediidiinfo veebiteenuste dokumentatsioonid ja näidised.<br />
<br />
= Tutvustus = <br />
* '''Mis on veebiteenus?'''<br />
Veebiteenused (Web Service) on tarkvarakomponendid, mis asuvad serveris ning mille poole kliendiprogrammid pöörduvad üle interneti. <br />
<br />
Veebiteenuse looja koostab koos veebiteenusega ka veebiteenuse dokumentatsiooni. Dokumentatsioonis on täpselt ära kirjeldatud veebiteenuse interneti aadress, mis andmevahetusprotokolle peab kasutama, millised on liidese meetodite nimed, millised on sisend- ja väljundparameetrite tüübid. Veebiteenuse kirjeldamiseks kasutatakse XML-põhist WSDL (Web Services Description Language) keelt. <br />
<br />
Veebiteenused on sõltumatud kasutatavast platvormist. Veebiteenus võib ise töötada Linux operatsioonisüsteemiga serveris, kliendiprogramm seevastu Win32 operatsioonisüsteemiga lauaarvutis. Ühte veebiteenust on võimalik integreerida ükskõik millisesse arvutisse eeldusel, et on olemas internetiühendus. <br />
<br />
Tänapäeval on kõrgtaseme tarkvaraarenduskeskkondadesse loodud tööriistad veebiteenuste lihtsaks integreerimiseks. WSDL kirjelduse põhjal suudavad arenduskeskkonnad genereerida programmeerija jaoks vajalikud teegid programmeerija poolt kasutatavas programmeerimiskeeles. Sisuliselt ei erine tarkvaraarendaja jaoks veebiteenuse väljakutsumine tavalisest funktsiooni väljakutsumisest. Kogu andmevahetuse ja tüübiteisenduste loogika on tarkvaraarendaja eest peidetud.<br />
<br />
= Krediidiinfo veebiteenused =<br />
* [[KiReport|XML raportite pärimine]]<br />
* [[Kireport.php|PDF ja HTML raportite pärimine]]<br />
* [[KiDocExchange]]<br />
* [[KiCompanyBasic]]<br />
* [[KiCompany]]<br />
* [[KiCreditRiskManagement]]<br />
<br />
= Arendajatele =<br />
* [[Krediidiinfo veebiteenuste arhitektuur]]<br />
* [[Autentimine]]<br />
* [[Veebiteenuste silumine]]- Serveri testimine, raportite testimine testkeskkonnas<br />
* [[Veatöötlus]]<br />
* [[Veakoodid]]<br />
* [[SOAP teenuse testimine]]<br />
* [[Tehniline tugi]]<br />
* Kasutatavad standardid/protokollid<br />
** [http://www.w3schools.com/xml/default.asp XML]<br />
** [http://www.w3schools.com/schema/default.asp XML Schema]<br />
** [http://www.w3schools.com/soap/default.asp SOAP]<br />
** [http://www.w3schools.com/wsdl/default.asp WSDL]<br />
<br />
= Näidised =<br />
* [[KiCompanyBasic | KiCompanyBasic - '''<span style="color:red;">Tasuta liides!</span>''']]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Main_page_en&diff=485
Main page en
2013-06-13T08:25:18Z
<p>Kart: /* Krediidiinfo web services */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Main_Page|eesti keeles]]<br />
|}<br />
<br />
<br />
Here you can find Krediidiinfo web services' documentation and samples.<br />
<br />
= Krediidiinfo web services =<br />
* [[KiReport_en|Requesting XML reports]]<br />
* [[Kireport.php_en|Requesting PDF ja HTML reports]]<br />
* [[KiDocExchange_en | KiDocExchange]]<br />
* [[KiCompanyBasic_en | KiCompanyBasic]]<br />
* [[KiCompany_en | KiCompany]]<br />
* [[KiCreditRiskManagement_en | KiCreditRiskManagement]]<br />
<br />
= For developers =<br />
* [[Krediidiinfo Web Services Architecture_en | Krediidiinfo Web Services Architecture]]<br />
* [[Authentication]]<br />
* [[Web_Service_Debugging | Web Service Debugging]]<br />
* [[Exeption handling]]<br />
* [[Error codes]]<br />
* [[SOAP service testing]]<br />
* [[Tehniline tugi| Technical support]]<br />
* Used standards/protocols<br />
** [http://www.w3schools.com/xml/default.asp XML]<br />
** [http://www.w3schools.com/schema/default.asp XML Schema]<br />
** [http://www.w3schools.com/soap/default.asp SOAP]<br />
** [http://www.w3schools.com/wsdl/default.asp WSDL]<br />
<br />
<br />
= Samples =<br />
* [[KiCompanyBasic | KiCompanyBasic - '''<span style="color:red;">Free interface!</span>''']]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Main_page_en&diff=484
Main page en
2013-06-13T08:24:52Z
<p>Kart: /* Krediidiinfo web services */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Main_Page|eesti keeles]]<br />
|}<br />
<br />
<br />
Here you can find Krediidiinfo web services' documentation and samples.<br />
<br />
= Krediidiinfo web services =<br />
* [[KiReport_en|Requesting XML reports]]<br />
* [[Kireport.php_en|Requesting PDF ja HTML reports]]<br />
* [[KiDocExchange_en | KiDocExchange]]<br />
* [[KiCompanyBasic_en | KiCompanyBasic]]<br />
* [[KiCompany_en | KiCompany]]<br />
* [[KiCreditManagement_en | KiCreditManagement]]<br />
<br />
= For developers =<br />
* [[Krediidiinfo Web Services Architecture_en | Krediidiinfo Web Services Architecture]]<br />
* [[Authentication]]<br />
* [[Web_Service_Debugging | Web Service Debugging]]<br />
* [[Exeption handling]]<br />
* [[Error codes]]<br />
* [[SOAP service testing]]<br />
* [[Tehniline tugi| Technical support]]<br />
* Used standards/protocols<br />
** [http://www.w3schools.com/xml/default.asp XML]<br />
** [http://www.w3schools.com/schema/default.asp XML Schema]<br />
** [http://www.w3schools.com/soap/default.asp SOAP]<br />
** [http://www.w3schools.com/wsdl/default.asp WSDL]<br />
<br />
<br />
= Samples =<br />
* [[KiCompanyBasic | KiCompanyBasic - '''<span style="color:red;">Free interface!</span>''']]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Kireport.php_en&diff=483
Kireport.php en
2013-06-13T08:22:52Z
<p>Kart: /* Introduction */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Kireport.php|eesti keeles]]<br />
|}<br />
<br />
<br />
= Introduction = <br />
<br />
Kireport.php is for requesting reports, which can be displayed directly on the screen (html, pdf reports). To make a request, the following link should be created:<br />
<br />
https://services.krediidiinfo.ee/kireport.php?product_code=xxxxxxx&format=yyy&subject_code=zzzzzzzz, where<br />
<br />
* xxxxxxx is the code of the report<br />
* yyy is format (txt, pdf or html)<br />
* zzzzzzzz is the subject about whom the report is requested (personal code for private persons and registry code for companies)<br />
<br />
<br />
To make a request, the user must identify him-/herself using one of the following authentication methods ([[Autentimine_en|Authentication]]).</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Main_Page&diff=482
Main Page
2013-06-13T08:22:08Z
<p>Kart: /* Krediidiinfo veebiteenused */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Main page__en|In English]]<br />
|}<br />
<br />
<br />
Lehelt leiate Krediidiinfo veebiteenuste dokumentatsioonid ja näidised.<br />
<br />
= Tutvustus = <br />
* '''Mis on veebiteenus?'''<br />
Veebiteenused (Web Service) on tarkvarakomponendid, mis asuvad serveris ning mille poole kliendiprogrammid pöörduvad üle interneti. <br />
<br />
Veebiteenuse looja koostab koos veebiteenusega ka veebiteenuse dokumentatsiooni. Dokumentatsioonis on täpselt ära kirjeldatud veebiteenuse interneti aadress, mis andmevahetusprotokolle peab kasutama, millised on liidese meetodite nimed, millised on sisend- ja väljundparameetrite tüübid. Veebiteenuse kirjeldamiseks kasutatakse XML-põhist WSDL (Web Services Description Language) keelt. <br />
<br />
Veebiteenused on sõltumatud kasutatavast platvormist. Veebiteenus võib ise töötada Linux operatsioonisüsteemiga serveris, kliendiprogramm seevastu Win32 operatsioonisüsteemiga lauaarvutis. Ühte veebiteenust on võimalik integreerida ükskõik millisesse arvutisse eeldusel, et on olemas internetiühendus. <br />
<br />
Tänapäeval on kõrgtaseme tarkvaraarenduskeskkondadesse loodud tööriistad veebiteenuste lihtsaks integreerimiseks. WSDL kirjelduse põhjal suudavad arenduskeskkonnad genereerida programmeerija jaoks vajalikud teegid programmeerija poolt kasutatavas programmeerimiskeeles. Sisuliselt ei erine tarkvaraarendaja jaoks veebiteenuse väljakutsumine tavalisest funktsiooni väljakutsumisest. Kogu andmevahetuse ja tüübiteisenduste loogika on tarkvaraarendaja eest peidetud.<br />
<br />
= Krediidiinfo veebiteenused =<br />
* [[KiReport|XML raportite pärimine]]<br />
* [[Kireport.php|PDF ja HTML raportite pärimine]]<br />
* [[KiDocExchange]]<br />
* [[KiCompanyBasic]]<br />
* [[KiCompany]]<br />
* [[KiCreditManagement]]<br />
* [[KiCreditRiskManagement]]<br />
<br />
= Arendajatele =<br />
* [[Krediidiinfo veebiteenuste arhitektuur]]<br />
* [[Autentimine]]<br />
* [[Veebiteenuste silumine]]- Serveri testimine, raportite testimine testkeskkonnas<br />
* [[Veatöötlus]]<br />
* [[Veakoodid]]<br />
* [[SOAP teenuse testimine]]<br />
* [[Tehniline tugi]]<br />
* Kasutatavad standardid/protokollid<br />
** [http://www.w3schools.com/xml/default.asp XML]<br />
** [http://www.w3schools.com/schema/default.asp XML Schema]<br />
** [http://www.w3schools.com/soap/default.asp SOAP]<br />
** [http://www.w3schools.com/wsdl/default.asp WSDL]<br />
<br />
= Näidised =<br />
* [[KiCompanyBasic | KiCompanyBasic - '''<span style="color:red;">Tasuta liides!</span>''']]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Main_Page&diff=481
Main Page
2013-06-13T08:17:25Z
<p>Kart: /* Krediidiinfo veebiteenused */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Main page__en|In English]]<br />
|}<br />
<br />
<br />
Lehelt leiate Krediidiinfo veebiteenuste dokumentatsioonid ja näidised.<br />
<br />
= Tutvustus = <br />
* '''Mis on veebiteenus?'''<br />
Veebiteenused (Web Service) on tarkvarakomponendid, mis asuvad serveris ning mille poole kliendiprogrammid pöörduvad üle interneti. <br />
<br />
Veebiteenuse looja koostab koos veebiteenusega ka veebiteenuse dokumentatsiooni. Dokumentatsioonis on täpselt ära kirjeldatud veebiteenuse interneti aadress, mis andmevahetusprotokolle peab kasutama, millised on liidese meetodite nimed, millised on sisend- ja väljundparameetrite tüübid. Veebiteenuse kirjeldamiseks kasutatakse XML-põhist WSDL (Web Services Description Language) keelt. <br />
<br />
Veebiteenused on sõltumatud kasutatavast platvormist. Veebiteenus võib ise töötada Linux operatsioonisüsteemiga serveris, kliendiprogramm seevastu Win32 operatsioonisüsteemiga lauaarvutis. Ühte veebiteenust on võimalik integreerida ükskõik millisesse arvutisse eeldusel, et on olemas internetiühendus. <br />
<br />
Tänapäeval on kõrgtaseme tarkvaraarenduskeskkondadesse loodud tööriistad veebiteenuste lihtsaks integreerimiseks. WSDL kirjelduse põhjal suudavad arenduskeskkonnad genereerida programmeerija jaoks vajalikud teegid programmeerija poolt kasutatavas programmeerimiskeeles. Sisuliselt ei erine tarkvaraarendaja jaoks veebiteenuse väljakutsumine tavalisest funktsiooni väljakutsumisest. Kogu andmevahetuse ja tüübiteisenduste loogika on tarkvaraarendaja eest peidetud.<br />
<br />
= Krediidiinfo veebiteenused =<br />
* [http://services.krediidiinfo.ee/wiki/index.php/KiReport|XML raportite pärimine]<br />
* [http://services.krediidiinfo.ee/wiki/index.php/Kireport.php|PDF ja HTML raportite pärimine]<br />
* [[KiDocExchange]]<br />
* [[KiCompanyBasic]]<br />
* [[KiCompany]]<br />
* [[KiCreditManagement]]<br />
* [[KiCreditRiskManagement]]<br />
<br />
= Arendajatele =<br />
* [[Krediidiinfo veebiteenuste arhitektuur]]<br />
* [[Autentimine]]<br />
* [[Veebiteenuste silumine]]- Serveri testimine, raportite testimine testkeskkonnas<br />
* [[Veatöötlus]]<br />
* [[Veakoodid]]<br />
* [[SOAP teenuse testimine]]<br />
* [[Tehniline tugi]]<br />
* Kasutatavad standardid/protokollid<br />
** [http://www.w3schools.com/xml/default.asp XML]<br />
** [http://www.w3schools.com/schema/default.asp XML Schema]<br />
** [http://www.w3schools.com/soap/default.asp SOAP]<br />
** [http://www.w3schools.com/wsdl/default.asp WSDL]<br />
<br />
= Näidised =<br />
* [[KiCompanyBasic | KiCompanyBasic - '''<span style="color:red;">Tasuta liides!</span>''']]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Main_Page&diff=480
Main Page
2013-06-13T08:17:08Z
<p>Kart: /* Krediidiinfo veebiteenused */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Main page__en|In English]]<br />
|}<br />
<br />
<br />
Lehelt leiate Krediidiinfo veebiteenuste dokumentatsioonid ja näidised.<br />
<br />
= Tutvustus = <br />
* '''Mis on veebiteenus?'''<br />
Veebiteenused (Web Service) on tarkvarakomponendid, mis asuvad serveris ning mille poole kliendiprogrammid pöörduvad üle interneti. <br />
<br />
Veebiteenuse looja koostab koos veebiteenusega ka veebiteenuse dokumentatsiooni. Dokumentatsioonis on täpselt ära kirjeldatud veebiteenuse interneti aadress, mis andmevahetusprotokolle peab kasutama, millised on liidese meetodite nimed, millised on sisend- ja väljundparameetrite tüübid. Veebiteenuse kirjeldamiseks kasutatakse XML-põhist WSDL (Web Services Description Language) keelt. <br />
<br />
Veebiteenused on sõltumatud kasutatavast platvormist. Veebiteenus võib ise töötada Linux operatsioonisüsteemiga serveris, kliendiprogramm seevastu Win32 operatsioonisüsteemiga lauaarvutis. Ühte veebiteenust on võimalik integreerida ükskõik millisesse arvutisse eeldusel, et on olemas internetiühendus. <br />
<br />
Tänapäeval on kõrgtaseme tarkvaraarenduskeskkondadesse loodud tööriistad veebiteenuste lihtsaks integreerimiseks. WSDL kirjelduse põhjal suudavad arenduskeskkonnad genereerida programmeerija jaoks vajalikud teegid programmeerija poolt kasutatavas programmeerimiskeeles. Sisuliselt ei erine tarkvaraarendaja jaoks veebiteenuse väljakutsumine tavalisest funktsiooni väljakutsumisest. Kogu andmevahetuse ja tüübiteisenduste loogika on tarkvaraarendaja eest peidetud.<br />
<br />
= Krediidiinfo veebiteenused =<br />
* [[http://services.krediidiinfo.ee/wiki/index.php/KiReport|XML raportite pärimine]]<br />
* [[http://services.krediidiinfo.ee/wiki/index.php/Kireport.php|PDF ja HTML raportite pärimine]]<br />
* [[KiDocExchange]]<br />
* [[KiCompanyBasic]]<br />
* [[KiCompany]]<br />
* [[KiCreditManagement]]<br />
* [[KiCreditRiskManagement]]<br />
<br />
= Arendajatele =<br />
* [[Krediidiinfo veebiteenuste arhitektuur]]<br />
* [[Autentimine]]<br />
* [[Veebiteenuste silumine]]- Serveri testimine, raportite testimine testkeskkonnas<br />
* [[Veatöötlus]]<br />
* [[Veakoodid]]<br />
* [[SOAP teenuse testimine]]<br />
* [[Tehniline tugi]]<br />
* Kasutatavad standardid/protokollid<br />
** [http://www.w3schools.com/xml/default.asp XML]<br />
** [http://www.w3schools.com/schema/default.asp XML Schema]<br />
** [http://www.w3schools.com/soap/default.asp SOAP]<br />
** [http://www.w3schools.com/wsdl/default.asp WSDL]<br />
<br />
= Näidised =<br />
* [[KiCompanyBasic | KiCompanyBasic - '''<span style="color:red;">Tasuta liides!</span>''']]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Main_Page&diff=479
Main Page
2013-06-13T08:15:52Z
<p>Kart: /* Krediidiinfo veebiteenused */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Main page__en|In English]]<br />
|}<br />
<br />
<br />
Lehelt leiate Krediidiinfo veebiteenuste dokumentatsioonid ja näidised.<br />
<br />
= Tutvustus = <br />
* '''Mis on veebiteenus?'''<br />
Veebiteenused (Web Service) on tarkvarakomponendid, mis asuvad serveris ning mille poole kliendiprogrammid pöörduvad üle interneti. <br />
<br />
Veebiteenuse looja koostab koos veebiteenusega ka veebiteenuse dokumentatsiooni. Dokumentatsioonis on täpselt ära kirjeldatud veebiteenuse interneti aadress, mis andmevahetusprotokolle peab kasutama, millised on liidese meetodite nimed, millised on sisend- ja väljundparameetrite tüübid. Veebiteenuse kirjeldamiseks kasutatakse XML-põhist WSDL (Web Services Description Language) keelt. <br />
<br />
Veebiteenused on sõltumatud kasutatavast platvormist. Veebiteenus võib ise töötada Linux operatsioonisüsteemiga serveris, kliendiprogramm seevastu Win32 operatsioonisüsteemiga lauaarvutis. Ühte veebiteenust on võimalik integreerida ükskõik millisesse arvutisse eeldusel, et on olemas internetiühendus. <br />
<br />
Tänapäeval on kõrgtaseme tarkvaraarenduskeskkondadesse loodud tööriistad veebiteenuste lihtsaks integreerimiseks. WSDL kirjelduse põhjal suudavad arenduskeskkonnad genereerida programmeerija jaoks vajalikud teegid programmeerija poolt kasutatavas programmeerimiskeeles. Sisuliselt ei erine tarkvaraarendaja jaoks veebiteenuse väljakutsumine tavalisest funktsiooni väljakutsumisest. Kogu andmevahetuse ja tüübiteisenduste loogika on tarkvaraarendaja eest peidetud.<br />
<br />
= Krediidiinfo veebiteenused =<br />
* [[http://services.krediidiinfo.ee/wiki/index.php/KiReport: XML raportite pärimine|//services.krediidiinfo.ee/wiki/index.php/KiReport: XML raportite pärimine]]<br />
* [[http://services.krediidiinfo.ee/wiki/index.php/Kireport.php: PDF ja HTML raportite pärimine|//services.krediidiinfo.ee/wiki/index.php/Kireport.php: PDF ja HTML raportite pärimine]]<br />
* [[KiDocExchange]]<br />
* [[KiCompanyBasic]]<br />
* [[KiCompany]]<br />
* [[KiCreditManagement]]<br />
* [[KiCreditRiskManagement]]<br />
<br />
= Arendajatele =<br />
* [[Krediidiinfo veebiteenuste arhitektuur]]<br />
* [[Autentimine]]<br />
* [[Veebiteenuste silumine]]- Serveri testimine, raportite testimine testkeskkonnas<br />
* [[Veatöötlus]]<br />
* [[Veakoodid]]<br />
* [[SOAP teenuse testimine]]<br />
* [[Tehniline tugi]]<br />
* Kasutatavad standardid/protokollid<br />
** [http://www.w3schools.com/xml/default.asp XML]<br />
** [http://www.w3schools.com/schema/default.asp XML Schema]<br />
** [http://www.w3schools.com/soap/default.asp SOAP]<br />
** [http://www.w3schools.com/wsdl/default.asp WSDL]<br />
<br />
= Näidised =<br />
* [[KiCompanyBasic | KiCompanyBasic - '''<span style="color:red;">Tasuta liides!</span>''']]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Main_Page&diff=478
Main Page
2013-06-13T08:15:29Z
<p>Kart: /* Krediidiinfo veebiteenused */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Main page__en|In English]]<br />
|}<br />
<br />
<br />
Lehelt leiate Krediidiinfo veebiteenuste dokumentatsioonid ja näidised.<br />
<br />
= Tutvustus = <br />
* '''Mis on veebiteenus?'''<br />
Veebiteenused (Web Service) on tarkvarakomponendid, mis asuvad serveris ning mille poole kliendiprogrammid pöörduvad üle interneti. <br />
<br />
Veebiteenuse looja koostab koos veebiteenusega ka veebiteenuse dokumentatsiooni. Dokumentatsioonis on täpselt ära kirjeldatud veebiteenuse interneti aadress, mis andmevahetusprotokolle peab kasutama, millised on liidese meetodite nimed, millised on sisend- ja väljundparameetrite tüübid. Veebiteenuse kirjeldamiseks kasutatakse XML-põhist WSDL (Web Services Description Language) keelt. <br />
<br />
Veebiteenused on sõltumatud kasutatavast platvormist. Veebiteenus võib ise töötada Linux operatsioonisüsteemiga serveris, kliendiprogramm seevastu Win32 operatsioonisüsteemiga lauaarvutis. Ühte veebiteenust on võimalik integreerida ükskõik millisesse arvutisse eeldusel, et on olemas internetiühendus. <br />
<br />
Tänapäeval on kõrgtaseme tarkvaraarenduskeskkondadesse loodud tööriistad veebiteenuste lihtsaks integreerimiseks. WSDL kirjelduse põhjal suudavad arenduskeskkonnad genereerida programmeerija jaoks vajalikud teegid programmeerija poolt kasutatavas programmeerimiskeeles. Sisuliselt ei erine tarkvaraarendaja jaoks veebiteenuse väljakutsumine tavalisest funktsiooni väljakutsumisest. Kogu andmevahetuse ja tüübiteisenduste loogika on tarkvaraarendaja eest peidetud.<br />
<br />
= Krediidiinfo veebiteenused =<br />
* [[http://services.krediidiinfo.ee/wiki/index.php/KiReport: XML raportite pärimine]]<br />
* [[http://services.krediidiinfo.ee/wiki/index.php/Kireport.php: PDF ja HTML raportite pärimine]]<br />
* [[KiDocExchange]]<br />
* [[KiCompanyBasic]]<br />
* [[KiCompany]]<br />
* [[KiCreditManagement]]<br />
* [[KiCreditRiskManagement]]<br />
<br />
= Arendajatele =<br />
* [[Krediidiinfo veebiteenuste arhitektuur]]<br />
* [[Autentimine]]<br />
* [[Veebiteenuste silumine]]- Serveri testimine, raportite testimine testkeskkonnas<br />
* [[Veatöötlus]]<br />
* [[Veakoodid]]<br />
* [[SOAP teenuse testimine]]<br />
* [[Tehniline tugi]]<br />
* Kasutatavad standardid/protokollid<br />
** [http://www.w3schools.com/xml/default.asp XML]<br />
** [http://www.w3schools.com/schema/default.asp XML Schema]<br />
** [http://www.w3schools.com/soap/default.asp SOAP]<br />
** [http://www.w3schools.com/wsdl/default.asp WSDL]<br />
<br />
= Näidised =<br />
* [[KiCompanyBasic | KiCompanyBasic - '''<span style="color:red;">Tasuta liides!</span>''']]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Main_Page&diff=477
Main Page
2013-06-13T08:14:54Z
<p>Kart: /* Krediidiinfo veebiteenused */</p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Main page__en|In English]]<br />
|}<br />
<br />
<br />
Lehelt leiate Krediidiinfo veebiteenuste dokumentatsioonid ja näidised.<br />
<br />
= Tutvustus = <br />
* '''Mis on veebiteenus?'''<br />
Veebiteenused (Web Service) on tarkvarakomponendid, mis asuvad serveris ning mille poole kliendiprogrammid pöörduvad üle interneti. <br />
<br />
Veebiteenuse looja koostab koos veebiteenusega ka veebiteenuse dokumentatsiooni. Dokumentatsioonis on täpselt ära kirjeldatud veebiteenuse interneti aadress, mis andmevahetusprotokolle peab kasutama, millised on liidese meetodite nimed, millised on sisend- ja väljundparameetrite tüübid. Veebiteenuse kirjeldamiseks kasutatakse XML-põhist WSDL (Web Services Description Language) keelt. <br />
<br />
Veebiteenused on sõltumatud kasutatavast platvormist. Veebiteenus võib ise töötada Linux operatsioonisüsteemiga serveris, kliendiprogramm seevastu Win32 operatsioonisüsteemiga lauaarvutis. Ühte veebiteenust on võimalik integreerida ükskõik millisesse arvutisse eeldusel, et on olemas internetiühendus. <br />
<br />
Tänapäeval on kõrgtaseme tarkvaraarenduskeskkondadesse loodud tööriistad veebiteenuste lihtsaks integreerimiseks. WSDL kirjelduse põhjal suudavad arenduskeskkonnad genereerida programmeerija jaoks vajalikud teegid programmeerija poolt kasutatavas programmeerimiskeeles. Sisuliselt ei erine tarkvaraarendaja jaoks veebiteenuse väljakutsumine tavalisest funktsiooni väljakutsumisest. Kogu andmevahetuse ja tüübiteisenduste loogika on tarkvaraarendaja eest peidetud.<br />
<br />
= Krediidiinfo veebiteenused =<br />
* [[http://services.krediidiinfo.ee/wiki/index.php/KiReport (XML raportite pärimine)]]<br />
* [[http://services.krediidiinfo.ee/wiki/index.php/Kireport.php (PDF ja HTML raportite pärimine)]]<br />
* [[KiDocExchange]]<br />
* [[KiCompanyBasic]]<br />
* [[KiCompany]]<br />
* [[KiCreditManagement]]<br />
* [[KiCreditRiskManagement]]<br />
<br />
= Arendajatele =<br />
* [[Krediidiinfo veebiteenuste arhitektuur]]<br />
* [[Autentimine]]<br />
* [[Veebiteenuste silumine]]- Serveri testimine, raportite testimine testkeskkonnas<br />
* [[Veatöötlus]]<br />
* [[Veakoodid]]<br />
* [[SOAP teenuse testimine]]<br />
* [[Tehniline tugi]]<br />
* Kasutatavad standardid/protokollid<br />
** [http://www.w3schools.com/xml/default.asp XML]<br />
** [http://www.w3schools.com/schema/default.asp XML Schema]<br />
** [http://www.w3schools.com/soap/default.asp SOAP]<br />
** [http://www.w3schools.com/wsdl/default.asp WSDL]<br />
<br />
= Näidised =<br />
* [[KiCompanyBasic | KiCompanyBasic - '''<span style="color:red;">Tasuta liides!</span>''']]</div>
Kart
https://services.krediidiinfo.ee/wiki/index.php?title=Autentimine_en&diff=476
Autentimine en
2013-06-13T08:09:40Z
<p>Kart: </p>
<hr />
<div>{| align="right"<br />
| [[Image:Flag of Estonia.svg|border|30px]] [[Autentimine|eesti keeles]]<br />
|}<br />
<br />
* Basic Authentication<br />
<br />
The standard authentication protocol is used for authentication [http://en.wikipedia.org/wiki/Basic_access_authentication http://en.wikipedia.org/wiki/Basic_access_authentication]. An example for developers is made: [[Basic Authentication näide|HTTP header]].<br />
<br />
<br />
== Authentication in browser ==<br />
<br />
<br />
If the report is requested in the browser, an username and password is required in the following method [http://en.wikipedia.org/wiki/Basic_access_authentication http://en.wikipedia.org/wiki/Basic_access_authentication]</div>
Kart