KiCompanyBasic: Difference between revisions
(→Näidisprogramm PHP-s: Muudetud näites kodeeringut. ISO-8859-1 -> ISO-8859-13) |
No edit summary |
||
(7 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
{| align="right" | |||
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[KiCompanyBasic__en|In English]] | |||
|} | |||
= Tutvustus = | = Tutvustus = | ||
KiCompanyBasic on | <span style="color:#CC0000"> <b>Tähelepanu! Veebiteenuse KiCompanyBasic osutamine lõppeb 1.10.2013. Alternatiivina soovitame kasutada [[KiCompany]] veebiteenust. </b> </span> | ||
KiCompanyBasic on Creditinfo SOAP protokollil põhinev veebiteenus ettevõtete registrikoodide pärimiseks ja kontrollimiseks. KiCompanyBasic päringud on tasuta kuni 500 päringut kuus. | |||
= WSDL = | = WSDL = | ||
KiCompanyBasic WSDL asub aadressil [http://services.krediidiinfo.ee/KiCompanyBasic.wsdl http://services.krediidiinfo.ee/KiCompanyBasic.wsdl]. | KiCompanyBasic WSDL asub aadressil [http://services.krediidiinfo.ee/KiCompanyBasic.wsdl http://services.krediidiinfo.ee/KiCompanyBasic.wsdl]. | ||
Microsofti arendusvahendite kasutajate jaoks on tehtud teine WSDL: [http://services.krediidiinfo.ee/KiCompanyBasicLit.wsdl http://services.krediidiinfo.ee/KiCompanyBasicLit.wsdl]. See erineb varasemast WSDL-ist selle poolest, et ''RPC/encode'' asemel kasutatakse ''RPC/litteral''-i. | |||
= Meetodid = | = Meetodid = | ||
Line 101: | Line 111: | ||
<?php | <?php | ||
/** | /** | ||
* | * Creditinfo KiCompanyBasic veebiteenuse kasutamise näidis. | ||
*/ | */ | ||
$param = array('encoding'=>'ISO-8859-13'); | $param = array('encoding'=>'ISO-8859-13'); | ||
Line 144: | Line 154: | ||
( | ( | ||
[regCode] => 10256137 | [regCode] => 10256137 | ||
[name] => | [name] => CREDITINFO EESTI AS | ||
) | ) | ||
) | ) | ||
Äriregistri kood 10256137 kuulub ettevõttele | Äriregistri kood 10256137 kuulub ettevõttele CREDITINFO EESTI AS | ||
Äriregistri kood on vigane. | Äriregistri kood on vigane. | ||
</pre> | </pre> |
Latest revision as of 13:45, 6 December 2016
In English |
Tutvustus
Tähelepanu! Veebiteenuse KiCompanyBasic osutamine lõppeb 1.10.2013. Alternatiivina soovitame kasutada KiCompany veebiteenust.
KiCompanyBasic on Creditinfo SOAP protokollil põhinev veebiteenus ettevõtete registrikoodide pärimiseks ja kontrollimiseks. KiCompanyBasic päringud on tasuta kuni 500 päringut kuus.
WSDL
KiCompanyBasic WSDL asub aadressil http://services.krediidiinfo.ee/KiCompanyBasic.wsdl.
Microsofti arendusvahendite kasutajate jaoks on tehtud teine WSDL: http://services.krediidiinfo.ee/KiCompanyBasicLit.wsdl. See erineb varasemast WSDL-ist selle poolest, et RPC/encode asemel kasutatakse RPC/litteral-i.
Meetodid
getName
Ettevõtte nime pärimine.
Nimi | Tüüp | Kirjeldus | |
---|---|---|---|
Sisendparameetrid: | regCode | xs:string | Ettevõtte äriregistri kood. |
Väljundparameeter: | name | xs:string | Ettevõtte nimi. Kui ettevõtte nime ei leita (sellise nimega ettevõtet ei eksisteeri, ettevõtte äriregistrikood vigane vms), siis on väljundparameetri väärtuseks tühistring. |
findCompanies
Ettevõtete otsimine nime järgi. Tulemuseks on massiiv, mis sisaldab otsingustringile sobivate ettevõtete nimesid ja äriregistrikoode.
Nimi | Tüüp | Kirjeldus | |
---|---|---|---|
Sisendparameetrid: | regCode | xs:string | Ettevõtte äriregistri kood |
count | xs:int | Leitud ettevõtete maksimaalne arv, mis meetodi tulemuses võib olla. (Meetod ei tagasta korraga rohkem kui 100 ettevõtet) | |
Väljundparameeter: | companies | ResultCompanyIDDataArray | Indekseeritud massiiv, mille elementideks on ResultCompanyIDData tüüpi elemendid. |
ResultCompanyIDData on kirje järgmise struktuuriga:
Nimi | Tüüp | Kirjeldus | |
---|---|---|---|
regCode | xs:string | Ettevõtte äriregistri kood | |
name | xs:string | Ettevõtte nimi. |
isRegCodeValid
Ettevõtte äriregistri korrektsuse kontrollimine.
Nimi | Tüüp | Kirjeldus | |
---|---|---|---|
Sisendparameetrid: | regCode | xs:string | Ettevõtte äriregistri kood |
Väljundparameeter: | isValid | xs:boolean | Tõene, kui parameetriga ette antud äriregistri kood on kaheksakohaline arv ja viimane kontrollnumber on õige. |
Näidisprogramm PHP-s
Järgnevalt on toodud PHP-s kirjutatud KiCompanyBasic veebiteenuse kasutamise näide.
<?php /** * Creditinfo KiCompanyBasic veebiteenuse kasutamise näidis. */ $param = array('encoding'=>'ISO-8859-13'); $client = new SoapClient('http://services.krediidiinfo.ee/KiCompanyBasic.wsdl', $param); $name = 'KREDIIDI'; $companies = $client->findCompanies($name, 3); print_r($companies); $regCode = '10256137'; $name = $client->getName($regCode); echo "Äriregistri kood {$regCode} kuulub ettevõttele {$name}\n"; $regCode = '10256136'; // kontrollnumber on vale! if (!$client->isRegCodeValid($regCode)) { echo "Äriregistri kood on vigane.\n"; } else { echo "Äriregistri kood on korrektne\n"; } ?>
Programmi väljund:
Array ( [0] => Array ( [regCode] => 90006012 [name] => KREDIIDI JA EKSPORDI GARANTEERIMISE SITHASUTUS KREDEX ) [1] => Array ( [regCode] => 10704587 [name] => KREDIIDI JÄRELVALVE OÜ ) [2] => Array ( [regCode] => 10256137 [name] => CREDITINFO EESTI AS ) ) Äriregistri kood 10256137 kuulub ettevõttele CREDITINFO EESTI AS Äriregistri kood on vigane.