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 7/8

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

  • Nezávislá PHP knihovna, která hledá firmy v reálném čase (neobsahuje databázi)

  • Je možné i použití externě přes CURL požadavky (více info)

  • Záruka funkčnosti 12 měsíců

PHP knihovna pro vyhledávání firem
Objednávka
(pro vlastní použití; zákaz samostatně 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 zájem a věřím, že 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 server.

<?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

// zpravidla trvá 1-2s, ale někdy mají výpadky (v případě výpadku bude vracet NULL po dobu 5 minut)
// je to proto, že výpadek může mít i půl hodiny a request trvá třeba 8 sekund a zbytečně zpomaluje váš web
// vrátí také informace o firmě
$viesInfo = IcoDicCompany\get('VIES')->byDic('SK1024402632');


//--- RYCHLEJŠÍ KONTROLA PLÁTCOVSTVÍ PŘES OFICIÁLNÍ ZDROJE
// toto používá prioritně databázi "Registr plátců DPH - Ministerstvo financí ČR"
// oproti VIES je toto rychlejší zdroj ověření a nemá výpadky

$jePlatce = $CZ->isTaxPayer('CZ25825194'); // zda je spolehlivým plátcem DPH

$jePlatceSK = $SK->isTaxPayer('SK1020000366');

JSON API

Alternativně je možné zasílat požadavky přes GET CURL (hledání přes IČO, DIČ nebo jméno firmy).
Výhodou je zajištěná funkčnost a pravidelné aktualizace.
Tímto způsobem je možné použití v .NET nebo jiném jazyku.

Cena této varianty je 1000 Kč bez DPH ročně.

Příklad volání: https://zvarik.cz/raw/firmy.php?apikey=XXX&search_ico=25825194&country=cz

Výsledek vrací v JSON.

Zdroje dat

  • Knihovna používá veřejné a oficiální zdroje firem, na které se dotazuje v reálném čase.
  • Aktuálně 10 zdrojů dat pro CZ a SK, které se vybírají dle priorit, aby se firma dohledala s aktuálními údaji.
  • Jednotlivé skripty, které se napojují na tyto data, budete mít k dispozici a jsou zcela nezávislé na mém webu.

Zodpovědnost

PHP/API knihovna je nástrojem pro vyhledávání firem v reálném čase. Neobsahuje vlastní databázi! Uživatel knihovny nese plnou odpovědnost za způsob jejího využití a dodržování právních předpisů, licencí a podmínek použití jednotlivých zdrojů dat. Autor knihovny nenese odpovědnost za správnost, úplnost nebo aktuálnost získaných dat. Účelem je pouze jako technický nástroj a není určena k nahrazení oficiálních zdrojů nebo k poskytování právně závazných informací o firmách.

Doplňující údaje o firmách

Prioritně mi šlo o to najít základní údaje firmy přes klíčová slova. Pokud byste 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.

Pro další dotazy mě kontaktujte.

Historie změn

Knihovna se používá a je průběžně aktualizována dle nutnosti.

30.01.2026 - Doplněno vyhledávání firem a podnikatelských subjektů v Polsku.
29.01.2026 - Doplněno zobrazení jednatelů českých firem.
01.06.2024 - Doplněny údaje [vatpayer_reliable] a [vatpayer_bank] pro všechny CZ firmy. Tímto lze zjistit, zda jde o spolehlivého plátce DPH a zveřejné bankovní účty.
03.01.2024 - Spousta změn, kompletní kontrola funkčnosti a doplnění dalšího oficiálního zdroje na Slovensku
15.02.2023 - Změny u VIES, plátci DPH Slovensko a jiné
21.04.2022 - Update u vyhledávání podle DIČ pro Česko
09.12.2021 - Více změn u formátování dat u českých firem, a pak u slovenských firem doplněná nová pole, např. jednatelé, založení firmy atp.
21.12.2020 - Úprava detekce ne/plátců DPH
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Č (adisreg); Díky - 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