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, PHP 8

  • 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ů)

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

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

Nezávislá OOP knihovna, 21 souborů
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 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

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

Použití v .NET nebo jiném jazyku

Alternativně je možné zasílat požadavky přes CURL (hledání přes IČO, DIČ nebo jméno firmy).
Výhodou je zajištěná funkčnost a pravidelné aktualizace.

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

Výsledek 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á veřejné a oficiální zdroje.

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 nedoporučuji (je potřeba hledat 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

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

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