README

Disclaimer / Prehlásenie:

Kód poskytnutý je bez záruky a môže kedykoľvek prestať fungovať. Jeho funkčnosť je striktne naviazaná na generovanú štruktúru HTML elementov. Autor nie je povinný udržiavať kód aktuálny a funkčný, ani neposkytuje ku nemu žiadnu podporu. Kód bol sprístupnený na základe mnohých žiadostí vývojárov finančno-ekonomických aplikácií a (bohužiaľ) neschopnosti úradných inštitúcií sprístupniť oficiálny prístup do verejnej databázy subjektov pomocou štandardného API rozhrania. Autor nezodpovedá za nesprávne použitie kódu.

Licencia

Kód obsiahnutý v súbore ConnectorOrsr.php je voľne distribuovateľný a modifikovateľný na súkromné ako aj komerčné účely.

Tipy na správne použitie

nepreťažujte server obchodného registra ORSR - nie je známe, akú záťaž dokáže server zvládnuť. Preťažením servera znemožníte využitie služby sebe aj iným. Buďte etickí programátori.
neoporúčame posielať požiadavky na server častejšie ako 1x za minútu. V žiadnom prípade nerobte hromadné odoslanie požiadaviek napr. 10 požiadaviek za sekundu - nerobia to ani webboty, lebo vedia, že môžu odpáliť server a dostať IP ban.
cachujte odpovede (do databázy) zo servera ORSR tak, aby sa rovnaký request neopakoval aspoň 3 - 6 mesiacov. Údaje v Obchodnom registri sa menia veľmi zriedkavo. Cachovanie nie je súčasťou implementácie (ukladanie odpovedí do lokálneho súboru v debug móde nepovažujeme za cachovanie).

Inštalácia, dependencie, demo

Kód je obsiahnutý v jedinom PHP súbore ConnectorOrsr.php.
Potrebné PHP rozšírenia: tidy, mbstring, dom, iconv, json.
Demo: http://www.synet.sk/php/sk/360-ORSR-API-rozhranie-obchodny-register
install manually or via composer:

$ composer require "lubosdz/parser-orsr" : "~1.0.0"

Použitie / API / Usage

// inicializacia API objektu
$orsr = new \lubosdz\parserOrsr\ConnectorOrsr();

Vyhľadávanie:

// vyhľadanie zoznamu subjektov podľa mena/názvu:
$list = $orsr->findByPriezviskoMeno('Novák', 'Peter');
$list = $orsr->findByObchodneMeno('Matador'); // e.g. vypis.asp?ID=1319&SID=9&P=0
$list = $orsr->findByICO('31577890'); // always max. 1 item - array(subject_name => link)

// vyhľadanie detailu subjektu podľa ID/IČO:
$detail = $orsr->getDetailById(1319, 9); // from link "vypis.asp?ID=1319&SID=9"
$detail = $orsr->getDetailByICO('31577890');

Podporné metódy:

// zapneme priamy výstup údajov do prehliadača + local file caching
$orsr->debug = true;

// nastavenie formátu výstupu
$orsr->setOutputFormat('xml'); // xml|json|empty string

// (!) NOT RECOMMENDED - bez tidy extension + vypnute zobrazenim XML chyb
$orsr->useTidy = false;
$orsr->showXmlErrors = false;

Príklad odpovede:

Príklad implementácie (MVC framework, e.g. Yii)

OrsrController:

<?php
use lubosdz\parserOrsr\ConnectorOrsr;

public function actionFindDetailByIco()
{
	$ico = empty($_GET['ico']) ? '' : htmlspecialchars(trim($_GET['ico']));
	$out = [];

	$connector = new ConnectorOrsr();
	$results = $connector->getDetailByICO($ico);

	return $this->asJson($out);
}

public function actionFindListByCompanyName()
{
	$term = empty($_GET['term']) ? '' : htmlspecialchars(trim($_GET['term']));
	$out = [];

	$connector = new ConnectorOrsr();
	$results = $connector->findByObchodneMeno($term);

	if($results && is_array($results)){
		foreach($results as $name => $link){
			$out[] = [
				'label' => $name,
				'value' => $link,
			];
		}
	}

	return $this->asJson($out);
}

public function actionCompanyDetail()
{
	$link = empty($_GET['h']) ? '' : htmlspecialchars($_GET['h']);
	$out = [];

	if($link){
		$connector = new ConnectorOrsr();
		$out = $connector->getDetailByPartialLink($link);
	}

	return $this->asJson($out);
}

View:

<input type="text" id="company_ico" maxlength="8" />

<script type="text/javascript">

$("#company_ico").on("keyup", function(){
	var me = $(this), ico = $.trim(me.val()),
	if(8 === ico.length){
		if(!/^([\d])+$/.test(ico)){
			alert("Zadajte len číslice 0-9.");
		}else{
			$.ajax({
				url: "/orsr/find-detail-by-ico",
				data: {ico: ico},
				success: function (response) {
					if(response.ico != undefined && response.ico){
						console.log(response);
					}else{
						alert("No records found.");
					}
				}
			})
		}
	}
});

</script>

Changelog

1.1.0 - 13.11.2023

Fix - vrátime platný spis pre viac platných záznamov / subjektov s rovnakým IČO (getDetailByICO - #10)
Enh - support requests delay options (msecDelayFetchUrl, delayAfterRequestCount) to prevent from rate limit ban

1.0.9 - 02.06.2023

Support "Mestský súd" along with traditional "Okresný súd"
Fix multiline company name with EOLs
tests passing 8.2.3

1.0.8 - 15.02.2022

Fix compatability with PHP 8.1+

1.0.7 - 06.01.2022

Added unit tests passing PHP 5.6 - 8.1
Updated endpoint URL to HTTP -> HTTPS
Separate method for loading remote URL with configurable timeout (default 5 secs)
Many parsing improvements
Fix invalid UTF-8 chars for some foreign companies, strip off accents from HU, PL, CZ company names
Parsing item dates - e.g. item since or eventDate
Normalized currency conversion to EUR (e.g. vyska vkladu) if denominated in SKK
minor BC break: attribute likvidacia now returns 1|0 instead of ano|nie
Added new parsed sections:
- Spoločnosť zrušená od
- Právny dôvod zrušenia
- Vyhlásenie konkurzu
- Správca konkurznej podstaty
- členský vklad
- Zlúčenie, splynutie
- Právny nástupca

1.0.6 - 25.08.2020

Make tidy extension optional (NOT recommended, but for some hostings the only way to go)
Minor improvements e.g. multiple whitespaces replaced with a single whitespace

1.0.5 - 09.11.2019

Revert support for option uplny/ciastocny vypis
Extract Miesto podnikania, Veduci org. zlozky
Fixed parsing countries for foreigners
Updated documentation

1.0.4 - 08.11.2019

Added option uplny/ciastocny vypis
Extract additional attributes (den vymazu, dovod vymazu, zastupovanie)
fix multiple company names & address without street (only city)

1.0.3 - 02.09.2019

Added method findByICO, code cleanup & formatting

1.0.2 - 14.05.2019

fixed PCRE unicode handling in different environments

1.0.1 - 11.03.2019

fixed bug PHP7+ compatability

1.0.0 - 12.09.2018

initial release

lubosdz / parser-orsr

Maintainers

Details

README

Licencia

Tipy na správne použitie

Inštalácia, dependencie, demo

Použitie / API / Usage

Vyhľadávanie:

Podporné metódy:

Príklad odpovede:

Príklad implementácie (MVC framework, e.g. Yii)

Changelog

1.1.0 - 13.11.2023

1.0.9 - 02.06.2023

1.0.8 - 15.02.2022

1.0.7 - 06.01.2022

1.0.6 - 25.08.2020

1.0.5 - 09.11.2019

1.0.4 - 08.11.2019

1.0.3 - 02.09.2019

1.0.2 - 14.05.2019

1.0.1 - 11.03.2019

1.0.0 - 12.09.2018