Vyhľadávanie PO

GET /search

Volanie, ktoré vráti zoznam právnických osôb, podnikateľov a orgánov verejnej moci (ďalej ako „PO") vyhovujúci zadaným parametrom.

Pri volaní je nutné uviesť aspoň jeden z vyhľadávacích filtrov, inak volanie vráti odpoveď typu 400: Bad Request. Pokiaľ je uvedených viac filtrov, volanie vráti záznamy, ktoré vyhovujú všetkým (t.j. condition1 AND condition2 AND condition3). Celková dĺžka volania (context path + parametre) však nesmie presiahnuť 2000 znakov. Volanie vráti maximálne 500 nájdených záznamov.

Vstupné parametre, pri ktorých nie je uvedené fulltextové vyhľadávanie, sa porovnávajú na presnú zhodu. Všetky dátumy musia byť vo formáte YYYY-MM-DD, inak volanie vráti 400: Bad Request.

Vo vyznačených textových poliach sa vyhľadáva fulltextovo – zadaný text sa hľadá kdekoľvek v poli, bez ohľadu na veľkosť písmen alebo diakritiku (dĺžne, mäkčene). Hľadaný text pritom musí byť minimálne 3 znaky. V prípade, že parameter nemá aspoň tri znaky, nebude vyhľadávaný fulltextovo, ale iba na presnú zhodu. Fulltextové vyhľadávanie je založené na Oracle Text CONTAINS a správa sa podľa tejto implementácie. Význam rezervovaných slov a znakov operátora CONTAINS sa však neaplikuje, a spoločne so zvyškom výrazu sú posudzované ako vyhľadávaný text.

Parametre

Parameter	Typ	Popis
identifier	string (optional)	IČO (identifiers[*].value)
fullName	string (optional)	Plny názov PO (fullNames[*].value) – fulltextové hľadanie
legalForm	string (optional)	Právna forma (legalForms[*].value.value) – fulltextové hľadanie
legalStatus	string (optional)	Právny stav (legalStatuses[*].value.value) – fulltextové hľadanie
addressMunicipality	string (optional)	Adresa sídla – obec (addresses[*].municipality.value) – fulltextové hľadanie
addressStreet	string (optional)	Adresa sídla – ulica (addresses[*].street) – fulltextové hľadanie
establishmentAfter	date (optional)	Dátum vzniku od, vrátane (establishment)
establishmentBefore	date (optional)	Dátum vzniku do, vrátane (establishment)
terminationAfter	date (optional)	Dátum zániku od, vrátane (termination)
terminationBefore	date (optional)	Dátum zániku do, vrátane (termination)
onlyActive	boolean (optional) (default: false)	Hľadať iba aktívne záznamy (termination == null)
dbModificationDateAfter	date (optional)	Dátum poslednej zmeny od, vrátane (dbModificationDate)
dbModificationDateBefore	date (optional)	Dátum poslednej zmeny do, vrátane (dbModificationDate)
mainActivity	string (optional)	Hlavná ekonomická činnosť (statisticalCodes.mainActivity.value) – fulltextové hľadanie
esa2010	string (optional)	Zaradenie do európskeho systému účtov (statisticalCodes.esa2010.value) – fulltextové hľadanie
sourceRegister	string (optional)	Zdrojový register (sourceRegister.value.value) – fulltextové hľadanie
stakeholderType	string (optional)	Typ zainteresovanej osoby (stakeholders[*].stakeholderType.value) – fulltextové hľadanie
stakeholderPersonGivenName	string (optional)	Meno zainteresovanej osoby (stakeholders[*].personName.givenNames[*]) – fulltextové hľadanie
stakeholderPersonFamilyName	string (optional)	Priezvisko zainteresovanej osoby (stakeholders[*].personName.familyNames[*]) – fulltextové hľadanie
stakeholderCompanyName	string (optional)	Plný názov PO ako zainteresovanej osoby (stakeholders[*].fullName) – fulltextové hľadanie
statutoryBodyType	string (optional)	Typ štatutárneho orgánu (statutoryBodies[*].stakeholderType.value) – fulltextové hľadanie
statutoryBodyGivenName	string (optional)	Meno štatutárneho orgánu (statutoryBodies[*].personName.givenNames[*]) – fulltextové hľadanie
statutoryBodyFamilyName	string (optional)	Priezvisko štatutárneho orgánu (statutoryBodies[*].personName.familyNames[*]) – fulltextové hľadanie
statutoryBodyCompanyName	string (optional)	Plný názov PO ako štatutárneho orgánu (statutoryBodies[*].fullName) – fulltextové hľadanie
orgUnitsIdentifier	string (optional)	IČO organizačnej zložky (organizationUnits[*].identifier)
orgUnitsFullName	string (optional)	Plný názov organizačnej zložky (organizationUnits[*].fullNames[*].value) – fulltextové hľadanie
orgUnitsStakeholderPersonGivenName	string (optional)	Meno zainteresovanej osoby organizačnej zložky (organizationUnits[*].stakeholders[*].personName.givenNames[*]) – fulltextové hľadanie
orgUnitsStakeholderPersonFamilyName	string (optional)	Priezvisko zainteresovanej osoby organizačnej zložky (organizationUnits[*].stakeholders[*].personName.familyNames[*]) – fulltextové hľadanie
orgUnitsStakeholderCompanyName	string (optional)	Plný názov PO ako zainteresovanej osoby organizačnej zložky (organizationUnits[*].stakeholders[*].fullName) – fulltextové hľadanie

Odpoveď – 200 OK

Content-Type: application/json

{
  "results": [
    {
      "id": 123456,
      "identifiers": { ... TimedValue ... },
      "fullNames": { ... TimedValue ... },
      "addresses": [ { ... Address ... } ],
      "establishment": "2021-01-01",
      "termination": "2021-01-01",
      "sourceRegister": {
        "value": { ... CodeValue ... },
        "registrationOffices": { ... TimedValue ... },
        "registrationNumbers": { ... TimedValue ... }
      },
      "dbModificationDate": "2021-01-01"
    }
  ],
  "license": "Licencia pre použitie údajov RPO..."
}

Jednotlivé atribúty:

• id (number) – Jedinečný identifikátor záznamu
• identifiers – TimedValue – IČO
• fullNames – TimedValue – Plný názov PO
• addresses – pole Address – Adresa sídla PO
• establishment (string) – Dátum vzniku
• termination (string) – Dátum zániku
• sourceRegister (object) – Zdrojový register
• dbModificationDate (string) – Dátum poslednej aktualizácie údajov o PO v databáze (nemusí reflektovať dátum legislatívnej účinnosti)
• license (string) – Licenčné informácie

Odpoveď – 400 Bad Request

V prípade chybných parametrov.

Detaily PO

GET /entity/{id}

Volanie, ktoré pre zadaný jedinečný identifikátor záznamu id vráti aktuálne resp. všetky dáta PO (v závislosti od zadaných parametrov). V prípade, ak záznam so zadaným id neexistuje, volanie vráti odpoveď typu 404: Not Found.

Parametre

Parameter	Typ	Popis
id	number (required)	Jedinečný identifikátor záznamu
showHistoricalData	boolean (optional) (default: false)	Zahrnúť historické údaje
showOrganizationUnits	boolean (optional) (default: false)	Zahrnúť organizačné jednotky

Odpoveď – 200 OK

Content-Type: application/json

{
  "id": 123456,
  "dbModificationDate": "2021-01-01",
  "identifiers": { ... TimedValue ... },
  "fullNames": { ... TimedValue ... },
  "alternativeNames": { ... TimedValue ... },
  "addresses": [ { ... Address ... } ],
  "legalForms": { ... TimedCodeValue ... },
  "establishment": "2021-01-01",
  "termination": "2021-01-01",
  "activities": [ { ... Activity ... } ],
  "statutoryBodies": [ { ... StatutoryBody ... } ],
  "stakeholders": [ { ... Stakeholder ... } ],
  "legalStatuses": { ... TimedCodeValue ... },
  "otherLegalFacts": { ... TimedValue ... },
  "authorizations": { ... TimedValue ... },
  "equities": [
    {
      "validFrom": "2021-01-01",
      "validTo": "2021-12-31",
      "value": 10000,
      "valuePaid": 10000,
      "valueApproved": 10000,
      "currency": { ... CodeValue ... }
    }
  ],
  "shares": [
    {
      "validFrom": "2021-01-01",
      "validTo": "2021-12-31",
      "fullName": "The Company, s.r.o.",
      "personName": { ... PersonName ... },
      "shareType": { ... CodeValue ... },
      "shareForm": "Akcia na meno",
      "shareNominalValue": 10000,
      "shareCurrency": { ... CodeValue ... },
      "amountOfFunds": 10000,
      "transferability": "Obmedzená prevoditeľnosť"
    }
  ],
  "deposits": [
    {
      "validFrom": "2021-01-01",
      "validTo": "2021-12-31",
      "personName": { ... PersonName ... },
      "fullName": "The Company, s.r.o.",
      "type": "Peňažný vklad",
      "amount": 10000,
      "currency": { ... CodeValue ... }
    }
  ],
  "sourceRegister": {
    "value": { ... CodeValue ... },
    "registrationOffices": { ... TimedValue ... },
    "registrationNumbers": { ... TimedValue ... }
  },
  "predecessors": [
    {
      "identifier": "38123456",
      "fullName": "The Company, s.r.o.",
      "address": { ... Address ... },
      "validFrom": "2021-01-01",
      "validTo": "2021-01-01"
    }
  ],
  "successors": [
    {
      "identifier": "38123456",
      "fullName": "The Company, s.r.o.",
      "address": { ... Address ... },
      "validFrom": "2021-01-01",
      "validTo": "2021-01-01"
    }
  ],
  "statisticalCodes": {
    "statCodesActualization": "2021-01-01",
    "mainActivity": { ... CodeValue ... },
    "esa2010": { ... CodeValue ... }
  },
  "organizationUnits": [
    {
      "type": { ... CodeValue ... },
      "identifier": "38123456",
      "fullNames": { ... TimedValue ... },
      "addresses": [ { ... Address ... } ],
      "establishment": "2021-01-01",
      "termination": "2021-01-01",
      "stakeholders": [ { ... Stakeholder ... } ],
      "activities": [ { ... Activity ... } ]
    }
  ],
  "license": "Licencia pre použitie údajov RPO..."
}

Jednotlivé atribúty (výber):

• id (number) – Jedinečný identifikátor záznamu
• dbModificationDate (string) – Dátum poslednej aktualizácie v databáze
• identifiers – TimedValue – IČO
• fullNames – TimedValue – Plný názov PO
• alternativeNames – TimedValue – Alternatívne názvy
• addresses – Address[] – Adresy sídla
• legalForms – TimedCodeValue – Právna forma (číselník CL000056)
• establishment, termination – dátumy
• activities – Activity[] – Predmet činnosti
• statutoryBodies – StatutoryBody[] – Štatutárny orgán
• stakeholders – Stakeholder[] – Zainteresovaná osoba
• legalStatuses – TimedCodeValue – Právny stav (CL010108)
• otherLegalFacts – TimedValue
• authorizations – TimedValue
• equities, shares, deposits – položky majetkovej štruktúry
• sourceRegister – objekt s hodnotami
• predecessors, successors – právni predchodcovia/nástupcovia
• statisticalCodes – štatistické kódy
• organizationUnits – organizačné zložky
• license (string) – licencia

Odpoveď – 404 Not Found

Ak záznam s daným ID neexistuje.

CodeValue

{
  "value": "hodnota",
  "code": "SK0106504556",
  "codelistCode": "CL000025"
}

• value (string) – Hodnota atribútu.
• code (string) – Kód hodnoty z číselníka. Ak hodnota v číselníku nefiguruje, je prázdna.
• codelistCode (string) – Kódové označenie číselníka (napr. CL000025).

TimedValue

Pole TimedValueEntry[].

TimedValueEntry

{
  "value": "hodnota",
  "validFrom": "2021-01-01",
  "validTo": "2021-12-31"
}

• value (string) – hodnota
• validFrom (string) – platnosť od
• validTo (string) – platnosť do

TimedCodeValue

Pole TimedCodeValueEntry[].

TimedCodeValueEntry

{
  "value": { ... CodeValue ... },
  "validFrom": "2021-01-01",
  "validTo": "2021-12-31"
}

• value – CodeValue
• validFrom (string) – platnosť od
• validTo (string) – platnosť do

Address

{
  "formatedAddress": "Komárno, Pohraničná 6/A",
  "validFrom": "2021-01-01",
  "validTo": "2021-12-31",
  "street": "Pohraničná",
  "regNumber": 0,
  "buildingNumber": "6/A",
  "postalCodes": ["94501"],
  "municipality": { ... CodeValue ... },
  "country": { ... CodeValue ... },
  "district": { ... CodeValue ... },
  "buildingIndex": "identifikátor adresy"
}

• formatedAddress (string) – formátovaná adresa
• validFrom (string) – platnosť od
• validTo (string) – platnosť do
• street (string) – ulica
• regNumber (number) – súpisné číslo
• buildingNumber (string) – orientačné číslo
• postalCodes – pole PSČ (array[string])
• municipality – CodeValue (číselníky CL000025 / UCE)
• country – CodeValue (CL000086 / STA)
• district – CodeValue (CL010141 / UCE)
• buildingIndex (string) – index domu/identifikátor adresy z Registra adries

Activity

{
  "economicActivityDescription": "Kúpa tovaru za účelom jeho predaja konečnému spotrebiteľovi",
  "validFrom": "2021-01-01",
  "validTo": "2021-12-31",
  "suspendedFrom": "2021-01-01",
  "suspendedTo": "2021-12-31"
}

• economicActivityDescription (string) – predmet činnosti
• validFrom (string) – platnosť od
• validTo (string) – platnosť do
• suspendedFrom (string) – pozastavenie od (voliteľný)
• suspendedTo (string) – pozastavenie do (voliteľný)

PersonName

{
  "formatedName": "Mgr. Peter Hruška, PhD.",
  "givenNames": ["Peter"],
  "familyNames": ["Hruška"],
  "givenFamilyNames": ["Hruška"],
  "prefixes": [ { ... CodeValue ... } ],
  "postfixes": [ { ... CodeValue ... } ]
}

• formatedName (string) – formátované meno
• givenNames – pole mien (array[string])
• familyNames – pole priezvisk (array[string])
• givenFamilyNames – pole rodných priezvisk (array[string])
• prefixes – pole CodeValue titulov pred menom (CL000062/TIT)
• postfixes – pole CodeValue titulov za menom (CL000063/TIT)

Stakeholder

{
  "stakeholderType": { ... CodeValue ... },
  "validFrom": "2021-01-01",
  "validTo": "2021-12-31",
  "address": { ... Address ... },
  "personName": { ... PersonName ... },
  "identifier": "12345678",
  "fullName": "The Company, s.r.o.",
  "establishment": "2021-01-01",
  "termination": "2021-12-31"
}

• stakeholderType – CodeValue typ zainteresovanej osoby (CL010109)
• validFrom (string) – platnosť od
• validTo (string) – platnosť do
• address Address – adresa
• personName PersonName – meno osoby (vypĺňa sa v prípade, ak je zainteresovaná osoba FO)
• identifier (string) – IČO (vypĺňa sa v prípade, ak je zainteresovaná osoba PO alebo organizačná zložka)
• fullName (string) – plné meno PO (vypĺňa sa v prípade, ak je zainteresovaná osoba PO alebo organizačná zložka)
• establishment (string) – dátum vzniku PO (vypĺňa sa v prípade, ak je zainteresovaná osoba PO alebo organizačná zložka)
• termination (string) – dátum zániku PO (vypĺňa sa v prípade, ak je zainteresovaná osoba PO alebo organizačná zložka)

Statutory body

{
  "stakeholderType": { ... CodeValue ... },
  "statutoryBodyMember": { ... CodeValue ... },
  "validFrom": "2021-01-01",
  "validTo": "2021-12-31",
  "address": { ... Address ... },
  "personName": { ... PersonName ... },
  "identifier": "12345678",
  "fullName": "The Company, s.r.o.",
  "establishment": "2021-01-01",
  "termination": "2021-12-31"
}

• stakeholderType – CodeValue typ štatutárneho orgánu (CL010113)
• statutoryBodyMember – CodeValue Funkcia člena kolektívneho štatutárneho orgánu (CL010470)
• validFrom (string) – platnosť od
• validTo (string) – platnosť do
• address Address – adresa
• personName PersonName – meno osoby (vypĺňa sa v prípade, ak je štatutár FO)
• identifier (string) – IČO (vypĺňa sa v prípade, ak je štatutár PO alebo organizačná zložka)
• fullName (string) – plné meno PO (vypĺňa sa v prípade, ak je štatutár PO alebo organizačná zložka)
• establishment (string) – dátum vzniku PO (vypĺňa sa v prípade, ak je štatutár PO alebo organizačná zložka)
• termination (string) – dátum zániku PO (vypĺňa sa v prípade, ak je štatutár PO alebo organizačná zložka)