Príklady použitia

Zistite, ako môžete integrovať FirmAPI do vašich systémov

FirmAPI poskytuje jednoduché API na získavanie údajov o slovenských firmách. Nižšie nájdete praktické príklady integrácie.

Príklady použitia podľa typu softvéru

Konkrétne scenáre s ukážkou volania a zoznamom registrov, ktoré sa v nich používajú.

Našepkávač firmy podľa IČO

Používateľ napíše tri písmená z názvu firmy a vyberie si zo zoznamu. Adresa, IČO a DIČ sa doplnia samé. Je to najjednoduchšie nasadenie FirmAPI a zároveň to, ktoré používatelia ocenia najviac.

Registračné a onboarding formuláre

Registrácia firemného zákazníka býva najdlhší formulár v aplikácii. Ak z IČO doplníte zvyšok, skrátite ho na jedno pole a zároveň získate údaje v podobe, ktorá sedí s registrom.

Fakturačný softvér

Fakturačný softvér potrebuje dve veci: správne údaje odberateľa a istotu, že mu má zmysel fakturovať. FirmAPI pokrýva oboje jedným volaním.

Účtovnícky softvér

Účtovná kancelária spravuje desiatky až stovky klientov a pri každom potrebuje aktuálne identifikačné údaje, prehľad o závierkach a istotu, že sa nič nezmenilo bez jej vedomia.

Právnický softvér

V právnej praxi je podstatné, kto je protistrana, kto za ňu smie podpísať a či voči nej neprebieha konanie. Všetky tri odpovede sú vo verejných registroch – len rozhádzané.

Overovanie údajov v zmluvách

Údaje v hlavičke zmluvy sa zvyknú kopírovať z predchádzajúcej zmluvy. Po roku sedieť nemusia – a nesprávne označená zmluvná strana je problém, ktorý sa objaví až v spore.

Hodnotenie bonity a zdravia firmy

Otázka „môžem tejto firme dať tovar na faktúru?" má konkrétnu odpoveď zloženú z verejných údajov. Nie je to skóre z čiernej skrinky – je to zoznam faktov, ktoré si viete overiť.

KYB a AML kontroly

Know Your Business znamená vedieť, kto za firmou stojí a či nie je na sankčnom zozname. Obe otázky sa dajú zodpovedať automaticky – z registra partnerov verejného sektora a zo sankčných zoznamov.

CRM a obohacovanie databázy

Databáza kontaktov starne od chvíle, keď vznikne. Obohatenie z registrov jej vráti presnosť a zároveň pridá informácie, ktoré obchodník pri zápise nemal ako zistiť.

Dávkové spracovanie a exporty

Keď potrebujete spracovať tisíce firiem naraz, volanie endpointu v cykle je nesprávna cesta. Dávkové spracovanie prijme celý zoznam a výsledok pripraví na prevzatie.

Ako dáta doručujeme

Webhooky

Webhook obráti smer komunikácie. Namiesto toho, aby ste sa pravidelne pýtali, či sa niečo zmenilo, oznámime vám to sami – v čase, keď sa to stane.

E-mailové notifikácie

Nie každá zmena musí prísť do systému. Účtovníka, právnika alebo obchodníka často zaujíma zmena konkrétnej firmy – a e-mail je na to ten správny kanál.

Exporty a formáty

Údaje z API často potrebuje aj niekto, kto JSON nečíta. Ten istý profil firmy sa dá získať v troch formátoch podľa toho, kam smeruje.

Vyhľadávanie firiem s autocomplete

Endpoint /search/autocomplete je ideálny pre Select2, typeahead a podobné komponenty. Vracia výsledky kompatibilné s populárnymi JavaScript knižnicami.

Select2 integrácia

Kompletný príklad integrácie s knižnicou Select2 pre vyhľadávanie firiem.

Select2 + FirmAPI JS SDK

import { FirmApi } from 'firmapi';

const client = new FirmApi('YOUR_API_KEY');

// Initialize Select2 with FirmAPI SDK
$('#company-search').select2({
  ajax: {
    transport: async (params, success, failure) => {
      try {
        const data = await client.search.autocomplete(params.data.q);
        success(data);
      } catch (e) { failure(e); }
    },
    data: (params) => ({ q: params.term }),
    processResults: (data) => ({ results: data.results })
  },
  minimumInputLength: 2
});

Získanie údajov o firme podľa IČO

Najčastejšie použitie - získanie kompletných údajov o firme podľa jej IČO.

import { FirmApi } from 'firmapi';

const client = new FirmApi('YOUR_API_KEY');

// Fetch company by IČO
const company = await client.companies.byIco('51636549');
console.log(company.name); // "Version Two s. r. o."

// Search by name
const results = await client.search.byName('Version Two');
console.log(results.data); // [{ ico: "51636549", name: "..." }]

use FirmApi\Client;

$client = new Client('YOUR_API_KEY');

// Fetch company by IČO
$company = $client->companies->byIco('51636549');

echo $company['name']; // "Version Two s. r. o."
echo $company['city']; // "Bratislava"

// Search by name
$results = $client->search->byName('Version Two');

foreach ($results['data'] as $item) {
    echo $item['ico'] . ' - ' . $item['name'];
}

import 'package:http/http.dart' as http;
import 'dart:convert';

Future<Company> getCompanyByIco(String ico) async {
  final response = await http.get(
    Uri.parse('https://firmapi.sk/v1/company/ico/$ico'),
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
    },
  );

  final json = jsonDecode(response.body);
  return Company.fromJson(json['data']);
}

curl -X GET "https://firmapi.sk/v1/company/ico/51636549" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Accept: application/json"

Integrácia do CRM systému

Automatické doplnenie údajov o zákazníkoch vo vašom CRM systéme. Stačí zadať IČO a všetky firemné údaje sa automaticky vyplnia.

Eliminácia manuálneho zadávania údajov
Zníženie chýb pri prepise
Aktuálne údaje priamo z Obchodného registra
Automatická validácia IČO

Ukážka CRM formulára

IČO

Názov firmy

Adresa

Automatizácia faktúr v e-shope

Pri zadávaní IČO sa automaticky vyplnia fakturačné údaje zákazníka. Ideálne pre B2B e-shopy a služby.

Rýchlejší checkout pre firemných zákazníkov
Správne fakturačné údaje bez chýb
Automatické overenie existencie firmy
Podpora pre DIČ a IČ DPH (vyššie tarify)

Laravel Controller + FirmAPI PHP SDK

use FirmApi\Client;
use FirmApi\Exceptions\ApiException;

public function loadBillingData(Request $request)
{
    $client = new Client(config('firmapi.key'));

    try {
        $company = $client->companies->byIco($request->ico);

        return response()->json([
            'name'    => $company['name'],
            'address' => $company['address'],
            'dic'     => $company['tax']['dic'] ?? null,
            'ic_dph'  => $company['tax']['ic_dph'] ?? null,
        ]);
    } catch (ApiException $e) {
        return response()->json(['error' => 'Company not found'], 404);
    }
}