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.
Problém
Dlhé registračné formuláre majú vysokú mieru opustenia. Každé pole, ktoré musí používateľ vyplniť ručne, je miesto, kde môže odísť alebo urobiť chybu.
Údaje zadané ručne sa navyše nedajú porovnať s registrom. Neviete, či firma existuje, či je aktívna a či sedí adresa – zistíte to až pri prvej faktúre.
Riešenie cez FirmAPI
Nechajte v prvom kroku len pole na IČO alebo názov firmy. Po zadaní zavolajte detail a zvyšok formulára predvyplňte. Používateľ už len potvrdí.
Pri tom istom volaní si overíte, že subjekt je aktívny a či je platiteľom DPH. Ak má vyplnený terminated_date, registráciu môžete rovno odmietnuť alebo označiť na kontrolu.
$response = Http::withHeaders(['X-API-Key' => $key])
->get("https://api.firmapi.sk/v1/company/ico/{$ico}", ['scope' => 'tax']);
$company = $response->json('data');
if ($company['terminated_date'] !== null) {
return back()->withErrors(['ico' => 'Subjekt je zaniknutý.']);
}
$customer->fill([
'name' => $company['name'],
'street' => $company['address']['street'],
'city' => $company['address']['city'],
'vat_payer' => $company['tax']['is_vat_payer'],
]);
Časté otázky
Čo ak firma v registri nie je?
API vráti 404. Nechajte v takom prípade používateľa vyplniť údaje ručne – týka sa to najmä zahraničných subjektov, ktoré v slovenských registroch nie sú.
Dá sa overiť aj zahraničné IČ DPH?
Áno, cez VIES. Pri registrácii zákazníka z iného členského štátu EÚ je to jediný spôsob, ako si overiť platnosť jeho IČ DPH.
Skúste to na vlastných dátach
Bezplatný účet dostanete bez platobnej karty. V databáze máme 2 160 466 subjektov z 48 verejných registrov.