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.

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);
    }
}