KiCreditManagement en: Difference between revisions

From services.krediidiinfo.ee
Jump to navigation Jump to search
No edit summary
No edit summary
Line 3: Line 3:
|}
|}


= Tutvustus =  
= Introduction =  


KiCreditManagement on Krediidiinfo SOAP protokollil põhinev krediidihalduse veebiteenus.
KiCreditManagement is the name of a Web Service based on SOAP protocol.


= WSDL =
= WSDL =


KiCreditManagement WSDL asub aadresslil [http://services.krediidiinfo.ee/KiCreditManagement.wsdl http://services.krediidiinfo.ee/KiCreditManagement.wsdl].
KiCreditManagement WDSL is located at  [http://services.krediidiinfo.ee/KiCreditManagement.wsdl http://services.krediidiinfo.ee/KiCreditManagement.wsdl].




= Meetodid =
= Methods =




== ''getOverview'' ==
== ''getOverview'' ==


Kliendi kohta krediidihalduri krediidihinnangu ja krediidijärelvalve ajaloo pärimine.
Requesting events of client's credit risk management and reminder management.


{| style="border-style: solid; border-width: 1px;"
{| style="border-style: solid; border-width: 1px;"
!  
!  
! Nimi
! Name
! Tüüp
! Type
! Kirjeldus
! Description
|-
|-
| <b>Sisendparameetrid:</b>  
| <b>Input parameter:</b>  
| clientCode
| clientCode
| xs:string
| xs:string
| Kliendi kood kreeditori infosüsteemis.
| Client code in creditor's information system.
|-
|-
| <b>Väljundparameeter:</b>
| <b>Output parameter:</b>
| xml
| xml
| xs:string
| xs:string
| vastus XML formaadis. XML skeem asub aadressil [http://www.krediidiinfo.ee/schemas/kh/debtor_cmdata.xsd 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 [[debtor_cmdata__example1.xml|näidist]])!
| Response in XML format. XML layout is located at [http://www.krediidiinfo.ee/schemas/kh/debtor_cmdata.xsd http://www.krediidiinfo.ee/schemas/kh/debtor_cmdata.xsd]. See an example: [[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 [[debtor_cmdata__example1.xml|näidist]])!
|}
|}



Revision as of 15:30, 6 June 2012

Flag of Estonia.svg eesti keeles

Introduction

KiCreditManagement is the name of a Web Service based on SOAP protocol.

WSDL

KiCreditManagement WDSL is located at http://services.krediidiinfo.ee/KiCreditManagement.wsdl.


Methods

getOverview

Requesting events of client's credit risk management and reminder management.

Name Type Description
Input parameter: clientCode xs:string Client code in creditor's information system.
Output parameter: xml xs:string Response in XML format. XML layout is located at http://www.krediidiinfo.ee/schemas/kh/debtor_cmdata.xsd. See an example: 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);

?>