KiCreditManagement en

From services.krediidiinfo.ee
Jump to navigation Jump to search
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

Method getOverview parameter clientCode gives three values:

  • full - sample-XML will be returned, where all tags are included
  • minimal - sample-XML will be returned, where minimal tags are included.
  • none - empty XML will be returned, if the requested client does not exist in the credit management database.

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

?>