Čarobnjak za kreiranje klijenta

Kratki sažetak

Čarobnjak za kreiranje klijenta je forma s tri koraka: Osnovne informacije, Bankovni računi i Kontakti. Koristi react-hook-form, CreateClientRequest iz API modela i useCreateClient za slanje zahtjeva na /clients.

Najvažnije koristi:

• Veliki unos klijenta podijeljen je u razumljive korake.
• Javni registar može popuniti naziv, OIB, PDV ID, MB/MBS i adresu.
• Bankovni računi i kontakti dodaju se prije spremanja klijenta.

Kada koristiti ovu značajku

Koristite čarobnjak kada želite:

• kreirati novog klijenta iz modala,
• dovršiti setup vlastitog klijenta na /my-client,
• dodati osnovne matične podatke u jednom toku.

Ova značajka je posebno korisna za:

• administratore koji rade onboarding klijenta,
• računovođe koje pripremaju klijenta prije knjiženja,
• vlasnike poslovanja koji prvi put povezuju svoju organizaciju.

Prije nego što počnete

Prije korištenja provjerite sljedeće:

• imate naziv, OIB i adresne podatke klijenta,
• znate tip firme i porezni status,
• imate bankovni račun i kontakt ako ih želite dodati odmah.

Brzi početak

U ovom primjeru pokazujemo najčešći tok kreiranja.

1. Otvorite čarobnjak iz Dodaj ili /my-client.
2. U prvom koraku unesite osnovne i poslovne podatke.
3. Kliknite Sljedeće.
4. Dodajte bankovne račune ili preskočite ako ih nemate.
5. Dodajte kontakte ili preskočite ako ih nemate.
6. Kliknite Spremi.

Nakon toga trebali biste vidjeti: uspješno kreiranog klijenta ili poruku greške ako API odbije zahtjev.

Detaljne upute

Korak 1: Osnovne informacije

Prvi korak prikazuje pretragu javnog registra i polja za naziv, adresu, državu, poštanski ured, općinu, porezni status, tip firme, OIB, ID broj, PDV ID, zanimanje, MB, konto kategoriju te HZZO/HZMO brojeve.

Primjer:

Naziv: Klijent d.o.o.
OIB: 12345678901
Tip firme: Poduzeće

Alt tekst: Čarobnjak za kreiranje klijenta s poljima osnovnih i poslovnih podataka.

Korak 2: Bankovni računi

Drugi korak omogućuje dodavanje bankovnih računa kroz modal. Polja uključuju model broja, broj računa, banku, naziv i oznaku Predlaže se.

Alt tekst: Drugi korak čarobnjaka s tablicom bankovnih računa.

Korak 3: Kontakti

Treći korak omogućuje dodavanje kontakata kroz modal. Polja uključuju ime, prezime, opis, email, telefon, faks, mobitel i oznaku predloženog kontakta.

Primjer iz prakse

Zamislimo da računovodstvo preuzima novog klijenta iz javnog registra.

Scenarij:

• Korisnik: administrator
• Cilj: popuniti matične podatke bez ručnog prepisivanja
• Problem: podaci iz registra i interni kontakt trebaju biti povezani
• Rješenje: pretraga javnog registra popunjava osnovna polja, a korisnik dodaje račun i kontakt

Rezultat:

Klijent se kreira s manje ručnog unosa i spreman je za rad u modulima.

Showcase: kako značajka izgleda u aplikaciji

Pregled zaslona

Što korisnik vidi:

• stepper koraka,
• formu s validacijom,
• gumbe Sljedeće, Nazad i Spremi.

Primjer konfiguracije

Preporučena konfiguracija za početnike:

Najčešće radnje

Kako primijeniti podatke iz javnog registra

1. Upišite OIB, naziv ili MB.
2. Odaberite rezultat.
3. Kliknite Primijeni podatke.

Kako dodati bankovni račun

1. U koraku Bankovni računi kliknite Dodaj.
2. Ispunite polja računa.
3. Spremite modal i provjerite tablicu.

Kako dodati kontakt

1. U koraku Kontakti kliknite Dodaj.
2. Ispunite kontakt podatke.
3. Kliknite Spremi na zadnjem koraku.

Dobre prakse

Za najbolje rezultate:

• prvo primijenite podatke iz registra pa ručno dopunite ostatak,
• obavezno provjerite OIB nakon automatskog popunjavanja,
• dodajte glavnog kontakt korisnika,
• koristite predloženi bankovni račun za glavni poslovni račun.

Izbjegavajte:

• spremanje klijenta bez provjere tipa firme,
• prepisivanje podataka iz nepouzdanog izvora,
• unos više računa bez oznake koji je predloženi ako aplikacijski proces to zahtijeva.

Napredne mogućnosti

Ako trebate više kontrole, možete koristiti:

Javni registar preko generated clienta

Pretraga koristi /clients/public-company-search/search i vraća rezultate iz FINA InfoBiz i Sudskog registra kada su izvori dostupni.

Lokalni field array

Bankovni računi i kontakti dodaju se u react-hook-form field array i šalju u istom CreateClientRequest.

Full-page način

Ako je isFullPage uključen, zahtjev šalje assignToOrganisation: true, što backend koristi za povezivanje klijenta s organizacijom.

Dozvole i pristup

Za korištenje ove značajke potrebne su sljedeće dozvole:

Ako ne vidite ovu značajku, moguće je da:

• nemate odgovarajuću dozvolu,
• značajka nije uključena u vašem paketu,
• administrator je ograničio pristup,
• integracija ili modul nije aktiviran.

Ograničenja

Trenutna ograničenja značajke:

• detaljna obaveznost svakog polja nije potpuno vidljiva iz pregledanog frontenda,
• javni registar može djelomično zakazati i prikazati upozorenje,
• useCreateClient prikazuje generičku grešku bez detalja validacije.

Rješavanje problema

Česta pitanja

Koji su koraci čarobnjaka?

Koraci su Osnovne informacije, Bankovni računi i Kontakti.

Što radi assignToOrganisation?

Kada je true, backend nakon kreiranja klijenta povezuje tog klijenta s trenutnom organizacijom. To se koristi u full-page onboarding toku.

Mora li svaki klijent imati bankovni račun i kontakt?

Kod dopušta prazne field arraye, ali poslovna pravila potpunosti podataka treba potvrditi. Koristite [POTREBNO DOPUNITI] dok pravilo nije dokumentirano.

Povezane značajke

• Dodavanje klijenta
• Full-page čarobnjak za kreiranje klijenta
• Filter tipa firme

Sljedeći korak

Ako tek počinjete, preporučujemo da prvo napravite sljedeće:

1. Isprobajte pretragu javnog registra.
2. Prođite sva tri koraka bez spremanja.
3. Kreirajte klijenta samo kada su podaci provjereni.

Nakon toga možete prijeći na: Full-page čarobnjak za kreiranje klijenta.