> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://pomoc.inewi.pl/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Integracja aplikacji inEwi z programem Gratyfikant NEXO

Aplikacja **inEwi** umożliwia eksport zdarzeń oraz urlopów do programu Gratyfikant NEXO z **dodatkiem Sfera**. 

‼️ Nie należy aktualizować programu Gratyfikant do wyższej wersji, dopóki nie zostanie udostępniony odpowiedni integrator.
Aktualizacja przed pojawieniem się integratora może spowodować problemy z działaniem integracji i uniemożliwić poprawną wymianę danych.
Zalecenie: przed każdą aktualizacją Gratyfikanta zawsze sprawdź dostępność aktualnej wersji integratora w naszej bazie wiedzy lub skontaktuj się z działem wsparcia.

|| Uwaga: Do przeprowadzenia integracji niezbędny jest aktywny moduł RCP (Rejestracja Czasu Pracy). To w nim znajduje się zakładka Raporty oraz funkcja eksportu danych. Konta z aktywnym wyłącznie modułem Wnioski i/lub Grafiki pracy nie posiadają dostępu do tych opcji. Przed rozpoczęciem konfiguracji upewnij się, że Twój plan obejmuje moduł RCP.

##### Pobierz i zainstaluj wybraną wersję integratora niezbędnego do integracji.
Sprawdź swoją wersję Sfery i wybierz odpowiedni integrator:

💾 [Kliknij tutaj aby pobrać integrator - wersja 60.0.1.9220](https://cdn.inewi.pl/apps/gratyfikantnexo/SymfoniaInEwi-NexoIntegratorInstaller60.0.1.9220.exe)

Stare wersje:
💾 [Kliknij tutaj aby pobrać integrator - wersja 56.1.0.8513](https://cdn.inewi.pl/apps/gratyfikantnexo/NexoIntegrationInstaller_56.1.0.8513.msi)
💾 [Kliknij tutaj aby pobrać integrator - wersja 56.0.3.8494](https://cdn.inewi.pl/apps/gratyfikantnexo/NexoIntegrationInstaller_56.0.3.8494.msi)
💾 [Kliknij tutaj aby pobrać integrator - wersja 55.0.2.8261](https://cdn.inewi.pl/apps/gratyfikantnexo/NexoIntegrationInstaller_55.0.2.8261.msi)
💾 [Kliknij tutaj aby pobrać integrator - wersja 53.0.1.7979](https://cdn.inewi.pl/apps/gratyfikantnexo/NexoIntegrationInstaller.msi)

Przed eksportem/importem plików sprawdź ustawienia formatu daty i czasu na komputerze z inEwi oraz z zainstalowanym Gratyfikantem NEXO wraz ze Sferą.

Ustawienia dostępne są w `Windowsie` > `Panel sterowania`.
Poprawne ustawienie formatu to `Polski (Polska)` jak na scr niżej:

![Ustawienia daty i formatu (Windows)](https://storage.crisp.chat/users/helpdesk/website/beb7c735e057c800/gratyfikant-dataregion_xbswu3.png)

## Instrukcja integracji.

### Włączanie integracji w inEwi
Upewnij się, że w systemie masz włączoną integrację z Gratyfikant NEXO.
Przejdź do `Ustawienia organizacji` klikając w ikonę konta w prawym górnym rogu > sekcja po lewej `Integracje`:

![Włączanie integracji Gratyfikant NEXO](https://storage.crisp.chat/users/helpdesk/website/beb7c735e057c800/nexointegracjewlacz_1738r7o.png)

### Instalacja integratora
1. Uruchom pobrany wyżej integrator inEwi do Gratyfikanta NEXO.
2. Jeśli zobaczysz alert Windows o ochronie i nierozpoznanej aplikacji, kliknij `Więcej informacji`, następnie `Uruchom mimo to`.

![Uruchom mimo to](https://storage.crisp.chat/users/helpdesk/website/beb7c735e057c800/windowswarning_10edvm5.png)

4. Postępuj zgodnie z krokami instalacji.
5. Podczas instalacji możesz zobaczyć alert wówczas kliknij `Tak`.

![Kontrola Windows](https://storage.crisp.chat/users/helpdesk/website/beb7c735e057c800/kontrolakontawindows_hgtnw3.png)

### Połączenie integratora z Gratyfikantem NEXO
Uruchom zainstalowany integrator i kliknij `Ustawienia połączenia`.

![Ustawienia połączenia](https://storage.crisp.chat/users/helpdesk/website/beb7c735e057c800/logowaniekrok1_ve0w8g.png)

1. Wybierz swój serwer SQL.
2. Wybierz bazę danych NEXO.
3. Wprowadź login i hasło konta NEXO.
4. Kliknij `Zapisz`.

||| Jeśli w punkcie 1 nie widzisz swojego serwera SQL, kliknij przycisk `Odśwież`.

![Uzupełnienie danych połączenia](https://storage.crisp.chat/users/helpdesk/website/beb7c735e057c800/logowaniekrok2_125xrih.png)

Kliknij `Połącz ze Sferą` .

![Połącz ze Sferą](https://storage.crisp.chat/users/helpdesk/website/beb7c735e057c800/logowaniekrok21_cs84s2.png)

Po poprawnym połączeniu zobaczysz `Połączenie aktywne`.

![Połączenie aktywne](https://storage.crisp.chat/users/helpdesk/website/beb7c735e057c800/logowaniekrok3_hgpqw1.png)

### Obsługa integratora

##### Eksport pracowników z NEXO do .xls
Jeśli potrzebujesz wyeksportować pracowników z NEXO, aby następnie zaimportować pełną listę do inEwi (szczególnie przydatne w przypadku nowego konta inEwi), kliknij przycisk `Eksport pracowników z NEXO do .xls` wybierz w jakim miejscu zapisać plik na komputerze i kliknij `Zapisz`.

##### Import zdarzeń do NEXO z .csv

1. Otwórz aplikację inEwi w przeglądarce i przejdź do widoku `Raporty` > `Lista obecności`.

2. Zaznacz pracowników na liście kalendarza, dla których chcesz wyeksportować dane.

3. Po kliknięciu w przycisk `Eksport` system oferuje możliwość wyeksportowania danych `Do Gratyfikant NEXO`.

![Eksportowanie raportu w inEwi](https://storage.crisp.chat/users/helpdesk/website/beb7c735e057c800/exportraportuinewi_1w02zah.png)

4. Możesz wybrać, czy chcesz eksportować `Zdarzenia`, czy `Wnioski`, czy od razu obie kolumny na raz.

![Wybieranie danych do eksportu](https://storage.crisp.chat/users/helpdesk/website/beb7c735e057c800/eksportall_ekd9bc.png)

||| Jeśli eksportujesz `Zdarzenia` i `Wnioski` na raz, zapiszą się one w pliku .zip. **Pamiętaj, aby wypakować pliki na komputerze przed ich załadowaniem do integratora!**

||| Gratyfikant NEXO nie obsługuje dodatkowych zdefiniowanych zdarzeń. Możliwy jest import tylko zdarzeń Start i Stop.

5. Wyeksportowany plik zdarzeń zaimportuj w integratorze, klikając przycisk `Importuj zdarzenia z pliku .csv`. **Pamiętaj, aby import przebiegł pomyślnie, pracownicy w okresie importowanych zdarzeń muszą posiadać umowę o pracę w Gratyfikancie**.

##### Import urlopów do NEXO z .csv

Analogicznie jak import zdarzeń. Pamiętaj o wybraniu **pliku z urlopami**.

### Typy wniosków możliwe do zaimportowania przez Gratyfikant NEXO

| Typ wniosków w inEwi | Przypisanie w Gratyfikant NEXO |
| ---- |
| `Urlop wypoczynkowy` | Urlop Wypoczynkowy |
| `Urlop wypoczynkowy "na żądanie"` | Urlop Wypoczynkowy |
| `Urlop macierzyński` | Urlop Macierzynski |
| `Urlop okolicznościowy` | Zwolnienie Okoliczn Platne |
| `Zwolnienie lekarskie` | Choroba |
| `Urlop bezpłatny` | Urlop Bezplatny |
| `Świadek w sądzie` | Urlop Bezplatny |
| `Opieka nad dzieckiem` | Opieka |
| `Świadczenie rehabilitacyjne` | Zwolnienie Platne |
| `Oddanie krwi` | Zwolnienie Platne |
| `Wolne z tytułu 5-cio dniowego tygodnia pracy` | Nieobecnosc Uspraw Platna |
| `Wolne za nadgodziny` | Nieobecnosc Uspraw Platna |
| `Wolne za pracę w święto` | Nieobecnosc Uspraw Platna |
| `Wypłata nadgodzin` | Nieobsługiwane* |
| `Własny typ dodany ręcznie do inEwi` | Nieobsługiwane* |
| `Wnioski o zdarzenie` | Nieobsługiwane* |
| `Wnioski o delegacje` | Nieobsługiwane* |
| `Dowolny wniosek` | Nieobsługiwane* |
*** Wniosek nie jest importowany do Gratyfikanta.
