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

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.

// 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 ?? '';

Časté otázky