KiCreditManagement

From services.krediidiinfo.ee
Revision as of 10:34, 22 September 2010 by Rait (talk | contribs) (sendProceedingInfo)
Jump to: navigation, search

Tutvustus

KiCreditManagement on Krediidiinfo SOAP protokollil põhinev krediidihalduse veebiteenus.

WSDL

KiCreditManagement WSDL asub aadresslil http://services.krediidiinfo.ee/KiCreditManagement.wsdl.


Meetodid

getOverview

Kliendi kohta krediidihalduri krediidihinnangu ja krediidijärelvalve ajaloo pärimine.

Nimi Tüüp Kirjeldus
Sisendparameetrid: clientCode xs:string Kliendi kood kreeditori infosüsteemis.
Väljundparameeter: xml xs:string vastus XML formaadis. XML skeem asub aadressil http://www.krediidiinfo.ee/schemas/kh/debtor_cmdata.xsd. Vaata näidisfaili: debtor_cmdata_example.xml. Kui päritavat klienti ei ole krediidihalduse andmebaasis, siis on päringu tulemuseks saadav XML-is märgendi debtor sisu tühi (vt näidist)!


sendProceedingInfo

Kliendi kohta info edastamine krediidihaldusesse.

Nimi Tüüp Kirjeldus
Sisendparameetrid: clientCode xs:string Kliendi kood kreeditori infosüsteemis.
text xs:string teate sisu vaba tekstina.
type xs:int teate tüübi kood. Võimalikud väärtused:
  • 13 - kreeditori info,
  • 20 - inkasso info (mõeldud kreeditori inkasso partneritele).

Kui Krediidiinfoga pole teisiti kokku lepitud, siis kasutada väärtuseks 13.

Väljundparameeter: resultCode xs:int kui päring õnnestub, siis on väärtuseks 0. Kui väärtus on negatiivne, siis on tegemist vea koodiga. Veakoodi võimalikud väärtused (võib tulevikus juurde tulla):
  • -20201 - parameetrile clientCode vastavat klienti krediidihaldusest ei leitud. Kas kliendikood on vigane või siis ei ole kreeditor antud kliendi infot krediidihaldusesse saatnud.
  • -20202 - kasutatud parameetri type väärtust ei ole lubatud kasutada.

Arendamine

Liidese integreerimiseks vajaliku arenduse jaoks on tehtud näidiskasutaja:

  • Autentimise meetod: Basic Authentication
  • Kasutajanimi: 30546
  • Parool: soapdemo

Näidiskasutaja korral saab meetodi getOverview parameetril clientCode olla vaid kolm järgmist väärtust:

  • full - tagastatakse näidis-XML, kus on täidetud kõik märgendid
  • minimal - tagastatakse näidis-XML, kus on täidetud minimaalsed väljad.
  • none - tagastatakse tühi XML, mis tagastatakse juhul, kui päritav klient ei ole Krediidiinfo krediidihalduse andmebaasis.


Näide PHP-s

<?php
/**
 * Example of using Krediidiinfo AS SOAP interface KiCreditManagement. 
 * 
 * In this example the demo username and password is used so there is no need
 * to contact with Krediidiinfo AS in order to run this program.
 * 
 * @link http://services.krediidiinfo.ee/wiki/index.php/KiCreditManagement
 * @author Rait Kapp <rait.kapp@experian.com>
 * @created 16.09.2010
 */
$wsdl_url = 'http://services.krediidiinfo.ee/KiCreditManagement.wsdl';
$params = array('location'      => 'https://services.krediidiinfo.ee/soap.php?name=KiCreditManagement'
              , 'login'       => '30546' // <-- username. Make sure username is string type (PHP bug?).
              , 'password'    => 'soapdemo'   // <-- password
            );
        
$client = new SoapClient($wsdl_url, $params);

$clientCode = 'full'; // 'full' is demo client code
$xml = $client->getOverview($clientCode);

print_r($xml);

?>