Dodavanje klijenta

Kratki sažetak

Dodavanje klijenta je akcija Dodaj na stranici Poslovni klijenti. Klik otvara modal s čarobnjakom za unos osnovnih podataka, bankovnih računa i kontakata, a spremanje šalje POST /clients.

Najvažnije koristi:

• Novi klijent se dodaje izravno s početne liste.
• Isti čarobnjak pokriva osnovne podatke, račune i kontakte.
• Nakon uspjeha popis klijenata se invalidira i osvježava.

Kada koristiti ovu značajku

Koristite dodavanje klijenta kada želite:

• otvoriti novi poslovni subjekt u računovodstvenoj organizaciji,
• dodati klijenta prije unosa dokumenata,
• upisati bankovni račun i kontakt odmah pri kreiranju.

Ova značajka je posebno korisna za:

• administratore koji održavaju matične podatke,
• računovođe koje zaprimaju novog klijenta,
• vlasnike računovodstvenog ureda koji provjeravaju onboarding.

Prije nego što počnete

Prije korištenja provjerite sljedeće:

• pretražili ste postojeće klijente po OIB-u kako biste izbjegli duplikat,
• imate osnovne podatke klijenta,
• imate OIB s 11 znamenki jer backend validira OIB.

Brzi početak

U ovom primjeru pokazujemo kako pokrenuti dodavanje klijenta.

1. Otvorite Poslovni klijenti.
2. Kliknite Dodaj.
3. U modalu unesite osnovne podatke.
4. Kliknite Sljedeće.
5. Dodajte bankovne račune i kontakte ako ih imate.
6. Kliknite Spremi.

Nakon toga trebali biste vidjeti: toast o uspješnom kreiranju i osvježen popis klijenata.

Detaljne upute

Korak 1: Otvorite modal

Gumb Dodaj u CreateClientModalButton koristi useDisclosure i otvara CreateClientModal.

Primjer:

Akcija: Dodaj -> modal Novi klijent

Alt tekst: Gumb Dodaj za otvaranje modala za novog klijenta.

Korak 2: Ispunite čarobnjak

Modal učitava CreateClientWizard, koji ima tri koraka: osnovne informacije, bankovni računi i kontakti.

Alt tekst: Modal za dodavanje klijenta s formom osnovnih podataka.

Korak 3: Spremite klijenta

Spremanje poziva useCreateClient, šalje CreateClientRequest na /clients, prikazuje toast i invalidira listu klijenata.

Primjer iz prakse

Zamislimo da računovodstveni ured potpisuje ugovor s novim poduzećem.

Scenarij:

• Korisnik: administrator
• Cilj: dodati klijenta prije prvog knjiženja
• Problem: podaci su raspršeni između OIB-a, adrese, računa i kontakta
• Rješenje: modal vodi korisnika kroz tri logična koraka

Rezultat:

Klijent se kreira s osnovnim podacima, a korisnik ga može otvoriti iz popisa.

Showcase: kako značajka izgleda u aplikaciji

Pregled zaslona

Što korisnik vidi:

• naslov modala,
• stepper koraka,
• formu za unos podataka.

Primjer konfiguracije

Preporučena konfiguracija za početnike:

Najčešće radnje

Kako otvoriti modal

1. Otvorite /.
2. Kliknite Dodaj.
3. Pričekajte modal.

Kako spremiti klijenta

1. Prođite sva tri koraka čarobnjaka.
2. Kliknite Spremi.
3. Provjerite toast poruku.

Kako odustati

1. Kliknite zatvaranje modala.
2. Neće se poslati POST /clients.
3. Po potrebi ponovno kliknite Dodaj.

Dobre prakse

Za najbolje rezultate:

• prije dodavanja pretražite OIB,
• koristite javni registar ako je klijent dostupan,
• dodajte barem jedan kontakt ako ga imate,
• označite predloženi bankovni račun kada je poznat.

Izbjegavajte:

• dodavanje klijenta bez provjere duplikata,
• spremanje nepotpunog OIB-a,
• preskakanje kontakata ako su potrebni za dokumente.

Napredne mogućnosti

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

Javni registar

Prvi korak čarobnjaka uključuje pretragu javnog registra po OIB-u, nazivu ili MB-u i može popuniti dio podataka.

Transakcijsko kreiranje

Backend kreira klijenta, postavke, bankovne račune, kontakte i zadanu obračunsku godinu unutar transakcije.

Dodavanje bez assignToOrganisation

Modalni tok šalje assignToOrganisation kao false ili izostavljeno; dodjeljivanje organizaciji koristi se u full-page onboarding toku.

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:

• modal ne prikazuje zasebnu provjeru duplikata osim korisničke pretrage,
• backend validacija dokazana je samo za OIB u pregledanom handleru,
• nakon uspjeha modal se zatvara, a detaljan novi klijent treba otvoriti iz liste.

Rješavanje problema

Česta pitanja

Što se automatski kreira uz klijenta?

Backend kreira osnovne postavke klijenta i zadanu obračunsku godinu za tekuću godinu. Ako su uneseni, kreira i povezane bankovne račune i kontakte.

Mogu li dodati klijenta bez bankovnog računa?

Prema kodu čarobnjak dopušta prolazak kroz korak, ali poslovno pravilo potpunosti podataka treba potvrditi. Ako nemate račun, ostavite korak prazan i naknadno dopunite.

Zašto se koristi čarobnjak?

Podaci klijenta su podijeljeni u osnovne informacije, bankovne račune i kontakte, što smanjuje duljinu jednog obrasca.

Povezane značajke

• Čarobnjak za kreiranje klijenta
• Poslovni klijenti
• Pretraga klijenata

Sljedeći korak

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

1. Pretražite OIB postojećih klijenata.
2. Otvorite modal Dodaj.
3. Kreirajte testnog klijenta samo u sigurnom testnom okruženju.

Nakon toga možete prijeći na: Čarobnjak za kreiranje klijenta.