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

# Tworzenie połączenia ERP

> Utwórz połączenie w Omnilinkerze i wygeneruj klucz API agenta, którym loguje się agent ERP Sync.

Połączenie reprezentuje w Omnilinkerze jedną bazę danych ERP. Tworzysz je w aplikacji webowej, a potem generujesz dla
niego klucz API agenta. Ten klucz jest potrzebny osobie z działu IT, która instaluje agenta ERP Sync.

Zanim zaczniesz, sprawdź, czy masz uprawnienia wymienione w sekcji
[Wymagania](/pl/erp/requirements#uprawnienia-administratora-organizacji).

## Utwórz połączenie

<Steps>
  <Step title="Sprawdź, czy integracja ERP jest włączona">
    Poszukaj pozycji **Integracja ERP** w menu głównym. Jeśli jej nie ma, integracja ERP nie jest jeszcze włączona
    dla Twojej organizacji. Poproś Omnilinkera o jej włączenie; zobacz
    [Moduły i ich dostępność](/pl/administration/features).
  </Step>

  <Step title="Otwórz listę połączeń">
    Otwórz **Integracja ERP** > **Połączenia**.
  </Step>

  <Step title="Rozpocznij tworzenie połączenia">
    Kliknij **Nowe połączenie**.
  </Step>

  <Step title="Wypełnij formularz">
    * **Nazwa**: nazwa, którą łatwo rozpoznasz, na przykład firma lub magazyn, do którego należy baza danych ERP.
      Pole wymagane, do 128 znaków, inne niż nazwy Twoich pozostałych połączeń.
    * **Dostawca**: wybierz **Wapro**. Pozostali dostawcy na liście nie są jeszcze dostępni.
    * **Opis**: opcjonalne notatki, do 500 znaków.

    Formularz nie pyta o dane bazy danych ERP. Wpisujesz je później w agencie i nigdy nie opuszczają one Twojej sieci.
  </Step>

  <Step title="Zapisz">
    Kliknij **Zapisz**. Połączenie pojawi się na liście ze statusem **Aktywne**, a w kolumnie
    **Ostatnia synchronizacja** zobaczysz **Nigdy**.
  </Step>
</Steps>

Nowe połączenia wykrywają zmiany metodą **Skanowanie skrótów**. Na śledzenie zmian WFM\_INT możesz przełączyć się
później, podobnie jak zmienić inne ustawienia agenta, za pomocą akcji **Edytuj**. Zobacz
[Konfiguracja synchronizacji](/pl/erp/sync-configuration).

## Wygeneruj klucz API agenta

Agent loguje się do Omnilinkera kluczem API agenta, który należy do tego połączenia.

<Steps>
  <Step title="Znajdź połączenie">
    W **Integracja ERP** > **Połączenia** znajdź wiersz połączenia.
  </Step>

  <Step title="Wygeneruj klucz">
    Otwórz menu **Akcje** w tym wierszu i kliknij **Wygeneruj klucz agenta**. Potwierdź komunikat z pytaniem, czy
    wygenerować klucz API agenta dla tego połączenia.
  </Step>

  <Step title="Skopiuj klucz">
    Okno **Klucz API agenta ERP** pokazuje klucz w polu **Klucz API agenta**. Kliknij **Kopiuj** i przechowaj klucz
    w bezpiecznym miejscu, na przykład w menedżerze haseł, dopóki agent nie zostanie skonfigurowany.
  </Step>

  <Step title="Zamknij okno">
    Zaznacz **Skopiowałem klucz**, a potem kliknij **Zamknij**. Okno możesz zamknąć dopiero po skopiowaniu klucza
    i zaznaczeniu tego pola wyboru.
  </Step>
</Steps>

<Warning>
  Klucz jest wyświetlany tylko raz. Po zamknięciu okna Omnilinker nie może go pokazać ponownie. Jeśli go zgubisz,
  wygeneruj nowy klucz.
</Warning>

Gdy generujesz klucz, Omnilinker wykonuje za Ciebie następujące czynności:

* Tworzy dla połączenia konto serwisowe o nazwie `erp-agent-`, po której następuje ID połączenia. Okno pokazuje tę
  nazwę w polu **Konto serwisowe**. Konto nie ma hasła i nie może logować się do aplikacji webowej.
* Dodaje konto do roli **ERP Sync Agent**, która ma tylko te uprawnienia, których potrzebuje synchronizacja. Omnilinker
  tworzy tę rolę przy pierwszym wygenerowaniu klucza.
* Unieważnia wszystkie wcześniejsze klucze agenta dla tego samego połączenia.

Konto serwisowe pojawia się na Twojej liście użytkowników. Nie usuwaj go, dopóki agent jest w użyciu.

<Warning>
  Nie twórz klucza dla agenta na stronie **Klucze API**. Klucz utworzony w tym miejscu działa w imieniu administratora,
  który go utworzył, ze wszystkimi jego uprawnieniami. Zamiast tego użyj akcji **Wygeneruj klucz agenta**. Zobacz
  [Klucze API](/pl/administration/api-keys).
</Warning>

### Wygeneruj nowy klucz

Aby wymienić klucz, na przykład dlatego, że zaginął lub wyciekł, ponownie kliknij **Wygeneruj klucz agenta** przy tym
samym połączeniu. Okno poinformuje Cię, że poprzedni klucz agenta został unieważniony.

Stary klucz przestaje działać natychmiast, więc działający agent nie może już wysyłać zmian. Od razu wpisz nowy klucz
w agencie. Zobacz [Kreator konfiguracji](/pl/erp/setup-wizard) lub
[Aplikacja w zasobniku](/pl/erp/tray-app).

## Znajdź ID połączenia

Nie musisz nigdzie wpisywać ID połączenia: kreator konfiguracji agenta sam pokazuje połączenie, do którego należy Twój
klucz. ID przydaje się, gdy rozmawiasz z pomocą techniczną o konkretnym połączeniu.

Aby je znaleźć, otwórz menu **Akcje** w wierszu połączenia i kliknij **Szczegóły**. ID połączenia to ostatnia część
adresu w przeglądarce:

```text theme={null}
https://omnilinker.pl/erp-integration/connections/<connection-id>
```

## Pobierz instalator agenta

Przekaż klucz API agenta osobie z działu IT, która instaluje agenta. Wyślij go bezpiecznym kanałem, nigdy zwykłym
e-mailem ani na czacie.

<CardGroup cols={1}>
  <Card title="Zainstaluj agenta" icon="download" href="/pl/erp/install-agent">
    Zainstaluj agenta ERP Sync na komputerze w Twojej sieci.
  </Card>
</CardGroup>
