KiCompanyBasic

From services.krediidiinfo.ee
Jump to navigation Jump to search
Flag of the United Kingdom.svg 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.