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 
// Initialize Select2 with FirmAPI
$('#company-search').select2({
  ajax: {
    url: 'https://api.firmapi.sk/v1/search/autocomplete',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    },
    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.

// Fetch company by IČO
async function getCompanyByIco(ico) {
  const response = await fetch(
    `https://api.firmapi.sk/v1/company/ico/${ico}`,
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Accept': 'application/json'
      }
    }
  );

  return response.json();
}

// Usage
const company = await getCompanyByIco('51636549');
console.log(company.data.name); // "Version Two s. r. o."
// Using Laravel HTTP Client
use Illuminate\Support\Facades\Http;

$response = Http::withToken('YOUR_API_KEY')
    ->get("https://api.firmapi.sk/v1/company/ico/{$ico}");

$company = $response->json('data');

echo $company['name']; // "Version Two s. r. o."
echo $company['address']; // "Bratislava"
import 'package:http/http.dart' as http;
import 'dart:convert';

Future<Company> getCompanyByIco(String ico) async {
  final response = await http.get(
    Uri.parse('https://api.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://api.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

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 
public function loadBillingData(Request $request)
{
    $response = Http::withToken(config('firmapi.key'))
        ->get("https://api.firmapi.sk/v1/company/ico/{$request->ico}");

    if ($response->failed()) {
        return response()->json([
            'error' => 'Company not found'
        ], 404);
    }

    return $response->json('data');
}

Začať používať FirmAPI

Zaregistrujte sa zadarmo a získajte API kľúč. Free plán obsahuje 20 požiadaviek mesačne.

Začať zadarmo