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.

Overenie a predvyplnenie pri registrácii
$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.

Rešpektujeme vaše súkromie

Nevyhnutné cookies používame na to, aby stránka fungovala. So súhlasom využívame aj analytické cookies (Google Analytics), aby sme rozumeli, ako sa stránka používa. Viac v sekcii Ochrana súkromia.