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

> Pridajte do formulára našepkávač slovenských firiem. Používateľ začne písať názov alebo IČO a údaje sa doplnia samé.

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.

## Problém

Formuláre, kde sa fakturačné údaje vypisujú ručne, produkujú preklepy v IČO, neaktuálne adresy a názvy firiem v troch rôznych podobách. Chyba sa objaví až pri fakturácii alebo pri kontrole a opravuje sa ručne.

Zároveň je to najotravnejšia časť registrácie. Každé pole navyše znižuje mieru dokončenia formulára.

## Riešenie cez FirmAPI

Endpoint na vyhľadávanie podľa názvu vracia zoznam zhôd s IČO a sídlom. Po výbere si dotiahnete detail a predvyplníte celý formulár. Používateľ zadá tri znaky namiesto šiestich polí.

Vyhľadávanie beží nad všetkými subjektmi vrátane živnostníkov, takže našepkávač funguje aj pre zákazníkov, ktorí nie sú v Obchodnom registri.

## Vyhľadanie a doplnenie údajov

```
// 1. Používateľ píše názov
const res = await fetch(
  'https://api.firmapi.sk/v1/search/name?q=' + encodeURIComponent(query),
  { headers: { 'X-API-Key': KEY } }
);
const { data } = await res.json();

// 2. Po výbere dotiahneme detail
const detail = await fetch(
  'https://api.firmapi.sk/v1/company/ico/' + data[0].ico + '?scope=tax',
  { headers: { 'X-API-Key': KEY } }
).then(r => r.json());

form.name.value    = detail.data.name;
form.street.value  = detail.data.address.street;
form.icDph.value   = detail.data.tax.ic_dph ?? '';
```

## Použité dátové zdroje
- RPO – Register právnických osôb
- Obchodný register SR (ORSR)
- Finančná správa – platitelia DPH

## Časté otázky

### Koľko kreditov stojí našepkávač?

Vyhľadávanie a detail sú samostatné volania. Pri našepkávači sa oplatí posielať dopyt až od tretieho znaku a výsledok krátko cachovať – zníži to počet volaní rádovo.

### Funguje aj vyhľadávanie podľa IČO?

Áno, existuje samostatný endpoint. Ak vstup vyzerá ako osem číslic, je rýchlejšie ísť rovno na detail podľa IČO.