# Registračné a onboarding formuláre

> Skráťte registráciu firemného zákazníka na jedno pole. Zadá IČO a názov, adresa aj IČ DPH sa doplnia z registrov.

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'],
]);
```

## Použité dátové zdroje
- RPO – Register právnických osôb
- Finančná správa – platitelia DPH
- EU VIES

## Č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.