API pro vyhledávání českých a slovenských firem - PHP skript

PHP knihovna umí následující:

  • Vyhledat údaje české nebo slovenské firmy podle:
    • názvu obchodního jména
    • IČO (identifikačního čísla osoby)
    • DIČ (zdrojem jsou aktuální údaje z Ministerstva financí)
    • nebo jména a příjmení osoby
  • Ověřit plátce DPH přes oficiální web ec.europa.eu (VIES) nebo ADISREG (jen pro česká DIČ, je rychlejší a spolehlivější)

  • Zkontrolovat formát IČO

  • Funguje pro PHP 5.3+, PHP 7

Nezávislá OOP knihovna, 21 souborů
Objednávka
(pro vlastní použití; zákaz dále šířit nebo prodávat; aktualizace dle dohody)

Fakturu zasílám obratem a skript po uhrazení, GDPR a obchodní podmínky zde.

Děkuji za podporu a jistě budete spokojeni.

Bezpečný nákup

Recenze je možno psát na firmy.cz a v případě dotazů mě kontaktujte.


Ukázka v praxi

Zadejte IČO / DIČ / název firmy /nebo jméno a příjmení osoby:

   

Jsou k dispozici všechny dostupné zdroje, ale vrací se první nejrychlejší výsledek.

Pokud zadáte neexistující údaj, tak to bude trvat déle, protože se testují nálezy ve všech zdrojích.

Příklad použití v kódu

<?php
/**
* Ukázka použití - jak najít údaje firem v ČR/SK
*/
require 'IcoDicCompany/autoload.php'// načte nezávislou knihovnu

// IcoDicCompany\Encoder::setEncoding('CP1250'); // výchozí kódování je UTF-8
// IcoDicCompany\Cache::setCacheInDays(31); // výchozí cache je 31 dní, zadej 0 pro vypnutí

// pro české firmy
$CZ = IcoDicCompany\get('CZ');
$company = $CZ->byIco(
'25825194');

print_r($company); 
// vrací všechny údaje v JSON, viz. demo ukázka výše

// všechny firmy podle názvu osoby
$companies = $CZ->byPerson('Novotný');

// pro slovenské firmy
$SK = IcoDicCompany\get('SK');
$company = $SK->byIco(
'46022732'); // najde podle IČO
$company = $SK->byIco('xyz 460 227 32'); // funguje i tento zápis
$company = $SK->byDic('SK1020000366'); // plátce DPH
$company = $SK->byDic('102 0000366'); // plátce DPH - funguje i tento zápis

// vrátí všechny názvy odpovídajících slovenských firem
$companies = $SK->byName('Dušan');

// vrátí max. 3 firmy včetně detailů (provádí více requestů, tak proto je to omezeno
// používá se zpravidla, když chcete detaily jedné konkrétní firmy
// + ověří platné DIČ
$companies = $SK->byName('DUSANT s.r.o.', true);


//---- KONTROLA PLÁTCOVSTVÍ DIČ přes VIES

// časový limit 2 sekundy - může vrátit NULL
// zpravidla trvá 1-2s, ale někdy mají výpadky a trvá to i 10 sekund
$viesInfo = IcoDicCompany\get('VIES')->byDic('SK1024402632');

// zvýší časový limit na 20 sekund
$viesInfo = IcoDicCompany\get('VIES')->byDic('SK1024402632', true);


//--- RYCHLEJŠÍ KONTROLA PLÁTCOVSTVÍ PŘES OFICIÁLNÍ ZDROJE

// toto používá "Registr plátců DPH - Ministerstvo financí ČR"
// nebo oficiálně veřejnou slovenskou databázi plátců DPH
// oproti VIES je toto rychlejší zdroj ověření a nemá výpadky
$jePlatce = $CZ->isTaxPayer('CZ25825194');
$jePlatceSK = $SK->isTaxPayer(
'SK1020000366');

Zdroje

Používá tyto veřejné a oficiální zdroje:

  • pro ČR to je ARES, RZP, Justice, ADISREG
  • pro Slovensko ZRSR, ORSR, Finančná správa DPH
  • VIES API s ochranou proti výpadkům (jsou časté) a filecache systémem

Rychlost

Rychleji to už nejde. Kde to jde, tam jsem použil webové služby, jinak HTTP parser. API v ukázce hledá ze všech zdrojů, takže neexistující názvy firem trvají déle - protože se hledají postupně ve všech zdrojích, aby se našel nějaký nález. Knihovnu lze po drobné úpravě (aby použilo jen první zdroj dat) použít i pro textový našeptávač.

Dotazy?

Kontakujte mě.

Historie změn

22.01.2019 - U některých ČR firem nevracelo ulici, město nebo PSČ (opraveno)
03.11.2018 - Úprava při hledání podle DIČ (změna ADISREG na SOAP a oprava chybky při hledání podle jména). Díky patří motoinzerce.cz, tipmoto.com
30.10.2017 - Zveřejněno
24.08.2017 - Přidáno SK, komplet upraveno
26.07.2017 - Přidáno CZ

Poslední zpětné linky