KiCreditManagement en - Revision history

Paavo at 12:09, 6 December 2016

2016-12-06T12:09:00Z

← Older revision		Revision as of 15:09, 6 December 2016
Line 93:		Line 93:
	<?php		<?php
	/**		/**
	* Example of using ~~Krediidiinfo~~ AS SOAP interface KiCreditManagement.		* Example of using CREDITINFO EESTI AS SOAP interface KiCreditManagement.
	*		*
	* In this example the demo username and password is used so there is no need		* 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.		* to contact with Creditinfo Eesti AS in order to run this program.
	*		*
	* @link http://services.krediidiinfo.ee/wiki/index.php/KiCreditManagement		* @link http://services.krediidiinfo.ee/wiki/index.php/KiCreditManagement
	* @author Rait Kapp <rait.kapp@~~experian~~.~~com~~>		* @author Rait Kapp <rait.kapp@creditinfo.ee>
	* @created 16.09.2010		* @created 16.09.2010
	*/		*/

Kart at 11:33, 12 June 2013

2013-06-12T11:33:16Z

← Older revision		Revision as of 14:33, 12 June 2013
Line 1:		Line 1:
	{\| align="right"		{\| align="right"
	\| [[Image:Flag of Estonia.svg\|border\|30px]] [[~~KiCreditManagement~~\|eesti keeles]]		\| [[Image:Flag of Estonia.svg\|border\|30px]] [[KiCreditRiskManagement\|eesti keeles]]
	\|}		\|}

Kart: /* Development */

2012-06-06T13:55:24Z

Development

← Older revision		Revision as of 16:55, 6 June 2012
Line 81:		Line 81:
	* Password: ''soapdemo''		* Password: ''soapdemo''

	~~Näidiskasutaja korral saab meetodi~~ ''getOverview'' ~~parameetril~~ ''clientCode'' ~~olla vaid kolm järgmist väärtust~~:		Method ''getOverview'' parameter ''clientCode'' gives three values:

	* ''full'' - tagastatakse [[debtor_cmdata_example_full.xml\|näidis-XML]], kus on täidetud kõik märgendid
	* ''minimal'' - tagastatakse [[debtor_cmdata_example_minimal.xml\|näidis-XML]], kus on täidetud minimaalsed väljad.
	* ''none'' - tagastatakse [[debtor_cmdata_example_none.xml\|tühi XML]], mis tagastatakse juhul, kui päritav klient ei ole Krediidiinfo krediidihalduse andmebaasis.

			* ''full'' - [[debtor_cmdata_example_full.xml\|sample-XML]] will be returned, where all tags are included
			* ''minimal'' - [[debtor_cmdata_example_minimal.xml\|sample-XML]] will be returned, where minimal tags are included.
			* ''none'' - [[debtor_cmdata_example_none.xml\|empty XML]] will be returned, if the requested client does not exist in the credit management database.

	= Example in PHP =		= Example in PHP =

Kart at 13:40, 6 June 2012

2012-06-06T13:40:27Z

← Older revision		Revision as of 16:40, 6 June 2012
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 =

Kart: /* getOverview */

2012-06-06T12:57:33Z

getOverview

← Older revision		Revision as of 15:57, 6 June 2012
Line 33:		Line 33:
	\| xml		\| xml
	\| xs:string		\| xs:string
	\| 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~~ (see [[debtor_cmdata__example1.xml\|example]])!		\| 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]]. An empty tag ''debtor'' will be given in XML, if the requested client does not exist in the credit management database. (see [[debtor_cmdata__example1.xml\|example]])!
	\|}		\|}


	== ''sendProceedingInfo'' ==		== ''sendProceedingInfo'' ==

Kart at 12:35, 6 June 2012

2012-06-06T12:35:10Z

← Older revision		Revision as of 15:35, 6 June 2012
Line 33:		Line 33:
	\| xml		\| xml
	\| xs:string		\| xs:string
	\| 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~~]])!		\| 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 (see [[debtor_cmdata__example1.xml\|example]])!
	\|}		\|}

Kart at 12:30, 6 June 2012

2012-06-06T12:30:37Z

← Older revision		Revision as of 15:30, 6 June 2012
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]])!
	\|}		\|}

Kart at 12:03, 6 June 2012

2012-06-06T12:03:14Z

← Older revision		Revision as of 15:03, 6 June 2012
Line 1:		Line 1:
			{\| align="right"
			\| [[Image:Flag of Estonia.svg\|border\|30px]] [[KiCreditManagement\|eesti keeles]]
			\|}

	= Tutvustus =		= Tutvustus =

Kart: Created page with "= Tutvustus = KiCreditManagement on Krediidiinfo SOAP protokollil põhinev krediidihalduse veebiteenus. = WSDL = KiCreditManagement WSDL asub aadresslil [http://services.k..."

2012-06-06T12:02:12Z

Created page with "= Tutvustus = KiCreditManagement on Krediidiinfo SOAP protokollil põhinev krediidihalduse veebiteenus. = WSDL = KiCreditManagement WSDL asub aadresslil [http://services.k..."

New page

= Tutvustus =

KiCreditManagement on Krediidiinfo SOAP protokollil põhinev krediidihalduse veebiteenus.

= WSDL =

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

= Meetodid =

== ''getOverview'' ==

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

{| style="border-style: solid; border-width: 1px;"
!
! 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 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]])!
|}

== ''sendProceedingInfo'' ==

Kliendi kohta info edastamine krediidihaldusesse.

{| style="border-style: solid; border-width: 1px;"
!
! 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 [[debtor_cmdata_example_full.xml|näidis-XML]], kus on täidetud kõik märgendid
* ''minimal'' - tagastatakse [[debtor_cmdata_example_minimal.xml|näidis-XML]], kus on täidetud minimaalsed väljad.
* ''none'' - tagastatakse [[debtor_cmdata_example_none.xml|tühi XML]], mis tagastatakse juhul, kui päritav klient ei ole Krediidiinfo krediidihalduse andmebaasis.

= Näide PHP-s =

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

?>

</pre>