KiCreditRiskManagement en

eesti keeles

Introduction

KiCreditRiskManagement is the name of a Credit Risk Management Web Service based on SOAP protocol. The service - http://www.krediidiinfo.ee/index.php?m=49

WSDL

KiCreditRiskManagement WSDL is located at http://services.krediidiinfo.ee/KiCreditRiskManagement.wsdl.

Methods

start

Adding company into Credit Risk Management.

	Name	Type	Description
Input parameter:	regCode	xs:string	Company’s registry code.
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.

end

Ending company's credit risk management. The end date of the service is set to the last day of the following month, if the service has been started in the current month, and in the case of a previously started service, the last day of the current month.

	Name	Type	Description
Input parameter:	regCode	xs:string	Company’s registry code.
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.

getCreditRiskData

Requesting company's basic data and events.

	Name	Type	Description
Input parameter:	regCode	xs:string	Ettevõtte registrikood.
Output parameter:	xml	xs:string	Response in XML format. XML schema is located at http://www.krediidiinfo.ee/schemas/services/KiCreditRiskManagement__getCreditRiskData.xsd. See an example: KiCreditRiskManagement__getCreditRiskData.xml. An empty tag company will be given in XML, if the requested company does not exist in the credit management database

getEvents

Requesting events in certain period of time (max 30 days).

	Name	Type	Description
Input parameter:	begin	xs:date	Start date (incl), from which the events are requested.
	end	xs:date	End date (incl), until the events are requested.
Output parameter:	xml	xs:string	Response in XML format. XML schema is located at http://www.krediidiinfo.ee/schemas/services/KiCreditRiskManagement__getEvents.xsd. See an example: KiCreditRiskManagement__getEvents.xml.

Error codes

-20400 UNKNOWN

Unknown error

-20401 INVALID_REGCODE

Invalid registry code

-20402 SERVICE_ALREADY_ACTIVE

The company is already in credit risk management.

-20403 SERVICE_INACTIVE

The company is not in credit risk management.

-20404 LONG_PERIOD

Requested period of time is too long.

Developing

Sample user is made for integrating the service:

• Method of authentication: Basic Authentication
• Username: 30546
• Password: soapdemo

Example in PHP

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

$regCode = '10256137'; 
$resultCode = $client->start($regCode);
if ($resultCode == 0) {
    echo "Company is added into credit risk management!";
}


$xml = $client->getCreditRiskData($regCode);
echo $xml;


$resultCode = $client->end($regCode);
if ($resultCode == 0) {
    echo "Company's credit risk management is ended!";
}


$xml = $client->getEvents('2013-01-01', '2013-01-07');
echo $xml;
?>