## Grupowanie kontrahentów

Zarządzanie oddziałami w ramach firmy można znaleźć w szczegółach firmy - zakładka `Grupy użytkowników` (dostępne tylko dla Super Admina - zależy od roli `Authority#ROLE_MANAGE_USER_GROUPS`):

![](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/contractors-grouping/contractors-group-panel.png>)

W tym panelu można dodać nową grupę, a także edytować lub usunąć istniejącą. Co ważne - nie można usunąć grupy domyślnej (`DEFAULT`), oznaczonej w bazie jako `UserGroup#mainGroup`.

Formularz dodawania/edycji grupy wygląda następująco:

![](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/contractors-grouping/contractors-group-edit.png>)

W szczegółach grupy można ustawić 3 zmienne:

- nazwę grupy,
- flagę dotyczącą widoczności transportów z innych grup,
- identyfikator.

Flaga dotycząca widoczności transportów z innych grup (`UserGroup#canSeeOtherGroupsTransports`) określa, jakie transporty będzie widział w tabeli użytkownik należący do tej grupy. Jeśli flaga będzie miała wartość `false`, użytkownik zobaczy jedynie transporty, które mają przypisany jego grupę. Jeśli będzie miała wartość `true`, użytkownik będzie mógł zobaczyć wszystkie transporty przypisane do swojej firmy.

Identyfikator służy do identyfikacji grup kontrahentów przychodzących z SK API.

### Przypisywanie użytkowników do grup kontrahentów

Jeżeli firma kontrahenta posiada jakąś grupę użytkowników inną niż domyślna, w formularzu edycji użytkownika można mu przypisać grupę (oddział):

![](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/contractors-grouping/contractors-group-user.png>)

W zależności od przypisania do grupy i jej ustawień (flagi dotyczącą widoczności transportów z innych grup) użytkownik zobaczy w tabeli transportów inne zlecenia.

### Ustawianie grup kontrahentów

Jeśli dany dostawca posiada tylko jedną grupę, oprócz grupy podstawowej `DEFAULT`:

![](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/contractors-grouping/contractor-groups-one.png>)

To w formularzu tworzenia awizacji podstawi się ona automatycznie po wyborze dostawcy:

![](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/contractors-grouping/contractor-groups-automatic.png>)

W przypadku gdy dostawca posiada 2 grupy (lub więcej), oprócz grupy podstawowej `DEFAULT`:

![](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/contractors-grouping/contractor-groups-more.png>)

Użytkownik sam musi wybrać grupę, rozwijając pole wyboru:

![](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/contractors-grouping/contractor-groups-manual.png>)

### Obligatoryjność wyboru grupy kontrahenta

Obligatoryjność podania grupy kontrahenta możemy ustawić w ustawieniach typu transportu (`TransportType#requiresContractorStepCompanyGroup`):

![](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/contractors-grouping/contractor-groups-transport-type-flag.png>)

Po zaznaczeniu tej opcji apollo będzie wymagać podania grupy kontrahneta przy zapisie transportu:

![](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/contractors-grouping/contractor-groups-validation.png>)

### Identyfikacja grup kontrahentów przychodzących z SK API

Żeby stworzyć zlecenie przypisane do grupy kontrahenta przez SK API, należy ją ustawić w stepie w polu `companyGroup`. W tym celu przy tworzeniu zlecenia należy w tabeli adres uzupełnić:

- pole `client_number` numerem NIP wybranej firmy,
- pole `company_group_identifier` identyfikatorem wybranej grupy.

Wówczas po utworzeniu transportu w Apollo wybrany step będzie przypisany do grupy kontrahentów. Jest to widoczne w selekcie firmy u użytkowników pryncypała, w nawiasie po nazwie firmy:

![](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/contractors-grouping/contractors-group-transport.png>)

### Widoczność zleceń w tabeli

Użytkownik należący do grupy kontrahentów X zobaczy w tabeli zleceń:

- wszystkie zlecenia swojej firmy - jeśli jego grupa ma ustawioną flagę `UserGroup#canSeeOtherGroupsTransports` na `true`,
- jedynie zlecenia przypisane do swojej grupy - jeśli jego grupa ma ustawioną flagę `UserGroup#canSeeOtherGroupsTransports` na `false`.
