> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dostosowywanie portali klientów, kontroli dostępu i stawek podatkowych

> Branduj strony logowania i rejestracji klientów, kontroluj widoczność paska bocznego według roli i konfiguruj stawki podatkowe dla faktur i kasy w AgencyHandy.

AgencyHandy daje Ci głęboką kontrolę nad tym, co widzą i doświadczają Twoi klienci — od pierwszej strony, na którą trafiają podczas logowania, po sekcje platformy, po których mogą się poruszać po zalogowaniu. Ta strona obejmuje cztery wzajemnie powiązane obszary konfiguracji: **Portal logowania**, **Portal rejestracji**, **Pasek boczny i kontrola dostępu** oraz **Stawki podatkowe**. Łącznie te ustawienia pozwalają Ci stworzyć dopracowane, odpowiednie dla roli doświadczenie dla każdego użytkownika w Twoim obszarze roboczym.

<Note>
  Wszystkie ustawienia na tej stronie wymagają dostępu **Super Administratora** lub **Administratora**. Przejdź do **Konfiguracja obszaru roboczego** w lewym pasku bocznym, aby uzyskać dostęp do każdej sekcji.
</Note>

***

<Tabs>
  <Tab title="Sign-in Portal">
    ## Portal logowania

    Portal logowania to strona logowania, którą klienci i członkowie zespołu widzą, gdy uzyskują dostęp do Twojego obszaru roboczego AgencyHandy. Jego dostosowanie zapewnia, że pierwsze wrażenie, jakie odnoszą klienci, jest w pełni zgodne z marką — z grafiką, nagłówkiem i przekazem Twojej agencji.

    ### Co możesz dostosować

    | Element      | Opis                                                     | Limit                       |
    | ------------ | -------------------------------------------------------- | --------------------------- |
    | **Nagłówek** | Główny tytuł wyświetlany na górze strony logowania       | Maks. 120 znaków            |
    | **Obraz**    | Brandowane zdjęcie lub ilustracja wyświetlana na stronie | PNG, JPG, JPEG — maks. 5 MB |
    | **Podtytuł** | Krótka wiadomość pod polami logowania                    | Maks. 300 znaków            |

    ### Kroki dostosowywania portalu logowania

    <Steps>
      <Step title="Otwórz ustawienia portalu logowania">
        Przejdź do **Konfiguracja obszaru roboczego** w lewej nawigacji, a następnie wybierz **Portal logowania** z podmenu.
      </Step>

      <Step title="Wprowadź własny nagłówek">
        Wpisz żądany nagłówek w polu **Nagłówek**. Niech będzie zwięzły i trafny — na przykład *„Witaj ponownie w \[Nazwa agencji]”* lub *„Twój portal klienta.”* Maksymalna długość to 120 znaków.
      </Step>

      <Step title="Prześlij brandowany obraz">
        Kliknij obszar przesyłania lub przeciągnij i upuść plik obrazu (PNG, JPG lub JPEG, maksymalnie 5 MB), aby dodać element wizualny do strony logowania. Ten obraz zazwyczaj pojawia się obok formularza logowania.

        <Tip>
          Użyj wysokiej jakości obrazu reprezentującego Twoją agencję — zdjęcia swojego zespołu, czystej ilustracji marki lub profesjonalnego tła. Upewnij się, że rozmiar pliku jest poniżej 5 MB, aby uniknąć błędów przesyłania.
        </Tip>
      </Step>

      <Step title="Dodaj podtytuł">
        W polu **Podtytuł** wpisz krótką wiadomość, która pojawi się pod polami logowania — na przykład powitanie, dane kontaktowe wsparcia lub krótki slogan. Zachowaj limit poniżej 300 znaków.
      </Step>

      <Step title="Podgląd i zapisz">
        Sprawdź układ strony logowania w podglądzie. Gdy będziesz zadowolony, kliknij **Zapisz** (lub **Aktualizuj**), aby zastosować zmiany. Zmiany są natychmiastowe.
      </Step>
    </Steps>

    ### Przywracanie ustawień domyślnych

    Kliknij **Przywróć ustawienia domyślne** na stronie portalu logowania, aby usunąć wszystkie dostosowania i przywrócić oryginalną stronę logowania AgencyHandy.

    <Warning>
      Przywracanie ustawień domyślnych jest nieodwracalne. Wszystkie niestandardowe nagłówki, obrazy i podtytuły zostaną trwale usunięte. Kliknij **Anuluj**, jeśli nie jesteś pewny — niezapisane zmiany są odrzucane, a bieżące zapisane ustawienia pozostają nienaruszone.
    </Warning>

    ### Najlepsze praktyki

    * Zachowaj nagłówek krótki i przyjazny — klienci widzą go przed zalogowaniem, więc powinien być zachęcający.
    * Użyj profesjonalnego obrazu reprezentującego Twoją agencję. Unikaj ogólnych zdjęć stockowych, które wydają się oderwane od Twojej marki.
    * Podejrzyj na różnych rozmiarach ekranu przed zapisaniem, aby upewnić się, że układ obrazu i tekstu wygląda poprawnie.
    * Jeśli obraz nie prześlał się, sprawdź, czy spełnia wymagania dotyczące formatu (PNG, JPG, JPEG) i rozmiaru (poniżej 5 MB).
  </Tab>

  <Tab title="Sign-up Portal">
    ## Portal rejestracji

    Portal rejestracji to strona rejestracji, na którą trafiają nowi klienci podczas tworzenia konta w Twoim obszarze roboczym. Jego dostosowanie tworzy spójne, brandowane doświadczenie od pierwszej interakcji potencjalnego klienta z platformą Twojej agencji.

    ### Co możesz dostosować

    | Element      | Opis                                                     | Limit                       |
    | ------------ | -------------------------------------------------------- | --------------------------- |
    | **Nagłówek** | Główny tytuł wyświetlany na górze strony rejestracji     | Maks. 120 znaków            |
    | **Obraz**    | Brandowane zdjęcie lub ilustracja wyświetlana na stronie | PNG, JPG, JPEG — maks. 5 MB |
    | **Podtytuł** | Krótka wiadomość pod polami rejestracji                  | Maks. 300 znaków            |

    ### Kroki dostosowywania portalu rejestracji

    <Steps>
      <Step title="Otwórz ustawienia portalu rejestracji">
        Przejdź do **Konfiguracja obszaru roboczego** w lewej nawigacji, a następnie wybierz **Portal rejestracji** z podmenu.
      </Step>

      <Step title="Wprowadź własny nagłówek">
        Wpisz nagłówek w polu **Nagłówek**, który wita nowych klientów. Na przykład *„Zacznij z \[Nazwa agencji]”* lub *„Utwórz swoje konto klienta.”* Maksymalnie 120 znaków.
      </Step>

      <Step title="Prześlij brandowany obraz">
        Kliknij obszar przesyłania lub przeciągnij i upuść plik obrazu (PNG, JPG lub JPEG, maksymalnie 5 MB). Ten obraz jest wyświetlany na stronie rejestracji obok formularza rejestracyjnego.

        <Tip>
          Użyj tego samego stylu wizualnego i palety kolorów zarówno na obrazach portalu logowania, jak i portalu rejestracji, aby stworzyć spójne doświadczenie na obu stronach.
        </Tip>
      </Step>

      <Step title="Dodaj podtytuł">
        Napisz krótką wiadomość uzupełniającą w polu **Podtytuł** — na przykład instrukcje dotyczące tego, czego spodziewać się po rejestracji, lub krótką propozycję wartości. Maksymalnie 300 znaków.
      </Step>

      <Step title="Podgląd i zapisz">
        Sprawdź stronę rejestracji korzystając z opcji podglądu. Kliknij **Zapisz** (lub **Aktualizuj**), aby natychmiast zastosować zmiany.
      </Step>
    </Steps>

    ### Przywracanie ustawień domyślnych

    Kliknij **Przywróć ustawienia domyślne** na stronie portalu rejestracji, aby usunąć wszystkie dostosowania i przywrócić oryginalną stronę rejestracji AgencyHandy.

    <Warning>
      Tej akcji nie można cofnąć. Wszystkie niestandardowe konfiguracje nagłówka, obrazu i podtytułu zostaną trwale usunięte.
    </Warning>

    ### Najlepsze praktyki

    * Dopasuj ton nagłówka rejestracji do ogólnego stylu komunikacji z klientami — profesjonalny, przyjazny lub obu.
    * Zachowaj podtytuł skupiony: poinformuj nowych klientów, co się stanie po rejestracji (np. *„Po rejestracji nasz zespół wyśle Ci wiadomość powitalną w ciągu 24 godzin.”*).
    * Po zapisaniu zmian samodzielnie przetestuj proces rejestracji, aby potwierdzić, że strona wygląda i zachowuje się zgodnie z oczekiwaniami.
  </Tab>

  <Tab title="Sidebar & Access">
    ## Pasek boczny i kontrola dostępu

    Ustawienia paska bocznego i dostępu pozwalają Ci kontrolować dokładnie to, co każda rola użytkownika może zobaczyć w lewym menu nawigacyjnym. Możesz zmieniać nazwy elementów menu, aby pasowały do terminologii Twojej agencji, zastępować domyślne ikony własnymi oraz przełączać widoczność dowolnej sekcji menu dla każdej roli. Efektem jest czystszy, celowo zaprojektowany interfejs dla każdej osoby, która się loguje.

    ### Role, które możesz konfigurować

    * Klient
    * Super Administrator
    * Administrator
    * Menedżer
    * Wykonawca
    * Niestandardowe (dowolne role niestandardowe, które utworzyłeś w sekcji Role i uprawnienia)

    ### Kroki dostosowywania elementów menu paska bocznego

    <Steps>
      <Step title="Otwórz ustawienia paska bocznego i dostępu">
        Przejdź do **Konfiguracja obszaru roboczego**, a następnie wybierz **Pasek boczny i dostęp** z menu ustawień.
      </Step>

      <Step title="Kliknij Dostosuj">
        Kliknij przycisk **Dostosuj** na górze panelu. Pełna lista bieżących elementów menu paska bocznego pojawi się pod kategorią **Główne**.
      </Step>

      <Step title="Zmień nazwę elementu menu">
        Kliknij pole tekstowe dowolnego elementu menu i wpisz nową etykietę. Na przykład zmień „Panel” na „Przegląd” lub „CRM” na „Kontakty”. Kliknij **Zapisz**, aby zastosować nową nazwę.
      </Step>

      <Step title="Zmień ikonę menu">
        Kliknij ikonę obok nazwy elementu menu. Otworzy się wyskakujące okno z zestawem opcji ikon — wybierz jedną z biblioteki lub prześlij niestandardowy obraz 32×32 px, aby użyć własnej brandowanej ikony. Kliknij **Zapisz**, aby zastosować.
      </Step>
    </Steps>

    ### Kroki konfigurowania widoczności opartej na rolach

    <Steps>
      <Step title="Kliknij Edytuj dostęp">
        Kliknij przycisk **Edytuj dostęp** (obok przycisku **Dostosuj**). Zobaczysz karty dla każdej dostępnej roli.
      </Step>

      <Step title="Wybierz rolę">
        Kliknij kartę roli, którą chcesz skonfigurować — na przykład **Klient**.
      </Step>

      <Step title="Przełącz widoczność elementów menu">
        Dla każdego wymienionego elementu menu użyj przełącznika, aby go pokazać lub ukryć dla wybranej roli. Na przykład możesz ukryć **Faktury** i **Subskrypcje** przed klientami, zachowując ich widoczność dla administratorów i menedżerów.
      </Step>

      <Step title="Zapisz zmiany">
        Kliknij **Zapisz**. Zaktualizowane ustawienia widoczności wchodzą w życie natychmiast — użytkownicy widzą zmiany przy następnej nawigacji po stronie lub po ponownym zalogowaniu.
      </Step>

      <Step title="Przywróć ustawienia domyślne, jeśli potrzeba">
        Kliknij **Przywróć domyślne** na karcie dowolnej roli, aby przywrócić oryginalne ustawienia widoczności dla tej roli.
      </Step>
    </Steps>

    <Tip>
      Czysty, minimalistyczny pasek boczny poprawia doświadczenie klienta. Pokazywanie klientom tylko tego, czego potrzebują — takich jak **Panel**, **Zamówienia** i **Wiadomości** — zmniejsza zamieszanie i zapobiega temu, by trafiali na sekcje przeznaczone wyłącznie do użytku wewnętrznego.
    </Tip>

    ### Przykładowe konfiguracje ról

    | Rola                | Zalecane widoczne sekcje                                |
    | ------------------- | ------------------------------------------------------- |
    | Klient              | Panel, Zamówienia, Wiadomości, Faktury (jeśli potrzeba) |
    | Menedżer            | CRM, Projekty, Karta czasu pracy, Zadania               |
    | Wykonawca           | Panel, Zadania, Projekty, Wiadomości                    |
    | Super Administrator | Wszystkie sekcje (bez ograniczeń)                       |

    ### Ważne informacje

    * **Zmiany są natychmiastowe:** Aktualizacje widoczności ról odzwierciedlają się natychmiast po odświeżeniu przez użytkowników lub ponownym zalogowaniu.
    * **Wygrywa najbardziej permisywna rola:** Jeśli użytkownik posiada wiele ról, pierwszeństwo ma rola z najszerszym dostępem.
    * **Niestandardowe ikony:** Prześlij obrazy 32×32 px, aby dopasować wizualizacje marki Twojej agencji w pasku bocznym.
    * **Spójność nazewnictwa:** Używaj przejrzystych, spójnych konwencji nazewnictwa, które rozumie cały Twój zespół — unikaj skrótów lub wewnętrznego żargonu, którego nowi członkowie zespołu nie rozpoznają.
  </Tab>

  <Tab title="Tax Rates">
    ## Stawki podatkowe

    Funkcja Stawki podatkowe pozwala Ci tworzyć, zarządzać i stosować konfiguracje podatkowe w ramach Twoich usług, subskrypcji i faktur. Możesz skonfigurować wiele typów podatków — VAT, GST, podatek od sprzedaży i inne — ze stawkami specyficznymi dla krajów i stanów, obsługą zarówno modeli cenowych z podatkiem wliczonym, jak i doliczanym do ceny oraz automatycznym naliczaniem podczas kasy na podstawie lokalizacji klienta.

    <Note>
      Tylko **Super Administratorzy** i **Administratorzy** mogą tworzyć, edytować lub usuwać konfiguracje podatkowe.
    </Note>

    ### Koncepcje podatkowe w skrócie

    | Koncepcja          | Definicja                                                                                    |
    | ------------------ | -------------------------------------------------------------------------------------------- |
    | **Doliczany**      | Podatek jest dodawany do podanej ceny przy kasie (np. 100 zł + 10% podatku = 110 zł łącznie) |
    | **Wliczony**       | Podatek jest już zawarty w wyświetlonej cenie (np. 110 zł łącznie już zawiera podatek)       |
    | **NIP/ID podatku** | Numer identyfikacji podatkowej Twojej agencji, widoczny na fakturach                         |

    ### Krok 1: Utwórz stawkę podatkową

    <Steps>
      <Step title="Otwórz Stawki podatkowe">
        Przejdź do **Konfiguracja obszaru roboczego**, a następnie kliknij kartę **Stawki podatkowe**.
      </Step>

      <Step title="Kliknij + Nowy podatek">
        Kliknij przycisk **+ Nowy podatek**. Pojawi się formularz.
      </Step>

      <Step title="Wypełnij szczegóły podatkowe">
        Uzupełnij następujące pola:

        * **Tytuł / Typ podatku** *(wymagane)*: Wprowadź opisową nazwę, np. Standardowy VAT, Obniżony GST lub Podatek od sprzedaży w USA. Maksymalnie 255 znaków.
        * **ID podatku** *(opcjonalne)*: Numer identyfikacji podatkowej Twojej agencji. Maksymalnie 20 znaków.
        * **Kraj macierzysty**: Wybierz główny kraj, do którego ma zastosowanie ten podatek.
        * **Ogólna stawka podatkowa dla kraju macierzystego %** *(opcjonalne)*: Domyślna stawka dla Twojego kraju macierzystego.
        * **Stawki specyficzne dla kraju** *(opcjonalne)*: Dodaj stawki dla poszczególnych krajów z opcjonalnym stanem, kodem pocztowym i procentem. Jest to przydatne dla agencji obsługujących klientów w wielu jurysdykcjach podatkowych.
      </Step>

      <Step title="Ustaw status">
        Przełącz podatek na **Aktywny**, aby był natychmiast dostępny do użycia w usługach i fakturach. Ustaw na **Nieaktywny**, aby zapisać konfigurację bez stosowania jej do nowych zakupów.
      </Step>

      <Step title="Zapisz">
        Kliknij **Zapisz**. Podatek pojawi się na liście stawek podatkowych i jest teraz dostępny do powiązania z usługami.
      </Step>
    </Steps>

    <Tip>
      Możesz obsługiwać do 4 miejsc po przecinku w procentowych stawkach podatkowych. Stawka podatkowa 0% jest prawidłowa — używaj jej do pozycji zerowo opodatkowanych lub scenariuszy zgodności, gdzie podatek musi być wymieniony, ale wynosi zero.
    </Tip>

    ### Krok 2: Powiąż podatki z usługami

    <Steps>
      <Step title="Otwórz usługę do edycji">
        Przejdź do **Usługi** i utwórz nową usługę lub edytuj istniejącą.
      </Step>

      <Step title="Przejdź do sekcji Dodatkowe informacje">
        Przejdź do Kroku 3 (Dodatkowe informacje) kreatora konfiguracji usługi.
      </Step>

      <Step title="Dodaj podatki do usługi">
        Kliknij **Dodaj podatek** i wybierz jeden lub więcej typów podatków z Twojej skonfigurowanej listy. Wybierz, czy podatki mają być stosowane jako **wliczone** czy **doliczane** dla tej usługi. To ustawienie ma zastosowanie do wszystkich powiązanych podatków w usłudze, w tym opłat konfiguracyjnych i dodatków.
      </Step>
    </Steps>

    ### Krok 3: Jak są naliczane podatki

    Podatki mogą być naliczane **automatycznie podczas kasy** lub **ręcznie na fakturach**:

    **Automatycznie (kasa)**

    * Podatki powiązane z usługą są automatycznie obliczane na podstawie lokalizacji rozliczeniowej klienta.
    * Klient musi podać kraj, stan i kod pocztowy przy kasie, aby zastosować podatek oparty na lokalizacji.
    * W przypadku kont Stripe India wymagane są pełne informacje o lokalizacji (kraj, stan, kod pocztowy).

    **Ręcznie (faktura)**

    * Przy ręcznym tworzeniu faktury kliknij **Dodaj podatki**, aby wybrać, które podatki zastosować.
    * Pola adresu rozliczeniowego wypełniają się automatycznie.
    * **Tylko podatki doliczane** mogą być stosowane do faktur ręcznych — podatki wliczone nie są obsługiwane w tym przepływie.

    ### Wyświetlanie podatku na fakturze

    Każda faktura zawierająca podatek zawiera następujące szczegóły:

    * **Nazwa podatku** — etykieta, którą wprowadzono (np. VAT, GST)
    * **Procent podatku** — zastosowana stawka (np. 15%)
    * **Kwota podatku** — obliczona kwota naliczona

    ### Zarządzanie istniejącymi stawkami podatkowymi

    * **Edycja podatku:** Kliknij wpis podatku na liście, aby zaktualizować jego tytuł, stawkę lub reguły dotyczące krajów. Aktualizacje dotyczą tylko przyszłych faktur i zakupów.
    * **Usuwanie podatku:** Usunięte podatki nie są już stosowane do nowych zakupów lub subskrypcji, ale istniejące faktury, które je zawierały, pozostają nienaruszone.
    * **Dezaktywacja podatku:** Ustaw podatek na **Nieaktywny**, aby przestał być stosowany do nowych zakupów bez usuwania konfiguracji.

    ### Ważne informacje

    * **Rabaty kuponów są naliczane przed podatkiem:** Gdy klient używa kuponu rabatowego, podatek jest obliczany od ceny po rabacie, a nie od ceny pierwotnej.
    * **Wiele podatków dla jednej usługi:** Do jednej usługi możesz przypisać więcej niż jeden podatek (np. VAT + GST jednocześnie).
    * **Podatek stosuje się do dodatków i opłat konfiguracyjnych:** Jeśli Twoja usługa ma opłatę konfiguracyjną lub dodatki, podatek jest stosowany do tych kwot.
    * **Lokalizacja klienta jest wstępnie wypełniana:** Jeśli klient ma zapisany kraj i stan rozliczeniowy w swoim profilu, te pola są wstępnie wypełniane przy kasie. Jednak edytowanie lokalizacji podczas kasy **nie** aktualizuje profilu klienta.
    * **Wykrywanie stanu na podstawie kodu pocztowego:** Dla klientów z USA system może automatycznie wykryć stan na podstawie kodu pocztowego i zastosować poprawny podatek regionalny, jeśli jest skonfigurowany.
  </Tab>
</Tabs>
