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

  • Po dohodě lze doplnit další funkcionalitu; šlo mi prioritně o spolehlivé vyhledání základních údajů

  • Jedná se o samostatnou nezávislou knihovnu (neobsahuje omezení na počet požadavků apod., tím myslím, že požadavky nechodí ke mě na server, využívá více externích zdrojů)

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 PHP

V této variantě je knihovna zcela nezávislá a neposílá žádné požadavky na můj web!

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

Použití v .NET a jiný jazyk

Alternativně je možné zasílat požadavky přes CURL.
Výhodou je, že je zajištěna funkčnost a pravidelné aktualizace.
Cena této varianty je 1000 Kč / rok.

curl -v -N https://api.zvarik.cz/firma/?ico=25825194&stat=cz \ -X "GET" \ -H "X-API-Key: VÁŠ_API_KLÍČ" \

Výsledek se vrací v JSON.

Zdůrazňuji, že PHP knihovna není závislá na mém webu a neposílá tyto CURL požadavky.

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 - to byla priorita knihovny. Knihovnu lze po drobné úpravě (aby použilo jen první zdroj dat) použít i pro textový našeptávač, ale spíše nedoporučuji, je potřeba zadat určitý počet znaků a není to efektivní.

Další údaje

Prioritně mi šlo o to najít základní údaje firmy přes klíčová slova. Pokud byste však chtěli údaje navíc, jako datum živnostenského opravnění, datum zániku, typy činností atp., tak to lze doplnit preferencí zdrojů, které tyto údaje mají, ale je nutno skript poupravit.

Dotazy?

Kontakujte mě.

Historie změn

25.09.2020 - Možnost externí API služby
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