KiCreditManagement en: Difference between revisions

From services.krediidiinfo.ee
Jump to navigation Jump to search
No edit summary
Line 38: Line 38:
== ''sendProceedingInfo'' ==
== ''sendProceedingInfo'' ==


Kliendi kohta info edastamine krediidihaldusesse.
Sending information about customers to credit risk 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.
|-
|-
|  
|  
| text
| text
| xs:string
| xs:string
| teate sisu vaba tekstina.
| Content of the message.
|-
|-
|  
|  
| type
| type
| xs:int
| xs:int
| teate tüübi kood. Võimalikud väärtused:  
| Type code of the message. The possible values are:  
* 13 - kreeditori info,  
* 13 - information for creditors,  
* 20 - inkasso info (mõeldud kreeditori inkasso partneritele).  
* 20 - information for debt collections (for creditors' collection partners).  


Kui Krediidiinfoga pole teisiti kokku lepitud, siis kasutada väärtuseks 13.
Use the value 13, unless agreed otherwise.
|-
|-
| <b>Väljundparameeter:</b>
| <b>Output parameter:</b>
| resultCode
| resultCode
| xs:int
| 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):  
| The value is 0, if the request succeeds. If the value is negative, then it is an error code. Possible values of error codes:  
* -20201 - parameetrile ''clientCode'' vastavat klienti krediidihaldusest ei leitud. Kas kliendikood on vigane või siis ei ole kreeditor antud kliendi infot krediidihaldusesse saatnud.  
* -20201 - the client with parameter ''clientCode'' was not found in credit risk management. Client code is either incorrect or the creditor has not sent the information about the client to credit risk management.  
* -20202 - kasutatud parameetri ''type'' väärtust ei ole lubatud kasutada.
* -20202 - the value of the parameter ''type'' is not allowed to use.
|}
|}


= Arendamine =
= Development =


Liidese integreerimiseks vajaliku arenduse jaoks on tehtud näidiskasutaja:
Sample user is created for the development of interface integration. 


* Autentimise meetod: ''Basic Authentication''
* Authentication method: ''Basic Authentication''
* Kasutajanimi: ''30546''
* User name: ''30546''
* Parool: ''soapdemo''  
* Password: ''soapdemo''  


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




= Näide PHP-s =
= Example in PHP =





Revision as of 16:40, 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. An empty tag debtor will be given in XML, if the requested client does not exist in the credit management database. (see example)!

sendProceedingInfo

Sending information about customers to credit risk management.

Name Type Description
Input parameter: clientCode xs:string Client code in creditor's information system.
text xs:string Content of the message.
type xs:int Type code of the message. The possible values are:
  • 13 - information for creditors,
  • 20 - information for debt collections (for creditors' collection partners).

Use the value 13, unless agreed otherwise.

Output parameter: resultCode xs:int The value is 0, if the request succeeds. If the value is negative, then it is an error code. Possible values of error codes:
  • -20201 - the client with parameter clientCode was not found in credit risk management. Client code is either incorrect or the creditor has not sent the information about the client to credit risk management.
  • -20202 - the value of the parameter type is not allowed to use.

Development

Sample user is created for the development of interface integration.

  • Authentication method: Basic Authentication
  • User name: 30546
  • Password: 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.


Example in PHP

<?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);

?>