> ## 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.

# Integracja ERP – przegląd

> Jak Omnilinker odczytuje produkty, ceny i stany magazynowe z Twojego lokalnego systemu ERP i czego potrzebujesz, żeby to skonfigurować.

Integracja ERP utrzymuje Omnilinkera w zgodzie z systemem ERP, który działa u Ciebie na miejscu. Mały program dla
Windows, agent ERP Sync, odczytuje zmiany z bazy danych ERP i wysyła je do Omnilinkera. Omnilinker aktualizuje potem
Twój katalog i magazyn.

## Jak to działa

Agent ERP Sync to usługa Windows i aplikacja w zasobniku systemowym, instalowane razem na komputerze w Twojej sieci.
Jeden agent obsługuje jedno połączenie.

```mermaid theme={null}
flowchart LR
  subgraph site["Twoja sieć"]
    db[("Baza danych ERP<br/>(SQL Server)")]
    agent["Agent ERP Sync<br/>(usługa Windows + aplikacja w zasobniku)"]
  end
  subgraph cloud["Omnilinker"]
    erp["Integracja ERP"]
    targets["Katalog i Magazyn"]
  end
  db -- "zmiany odczytywane przez agenta" --> agent
  agent -- "zdarzenia zmian, wychodzące HTTPS" --> erp
  erp --> targets
```

* **Pracę z ERP wykonuje agent.** Łączy się z bazą danych ERP, wykrywa, co się zmieniło, i umieszcza każdą zmianę
  w lokalnej kolejce wychodzącej (outbox). Następnie wysyła zmiany z kolejki do Omnilinkera przez HTTPS. Jeśli
  połączenie z internetem zostanie przerwane, zmiany czekają w kolejce, aż wróci.
* **Dane logowania do ERP zostają w Twojej sieci.** Dane połączenia z bazą danych wpisujesz w agencie, a nie
  w aplikacji webowej. Agent przechowuje je w zaszyfrowanym pliku na swoim komputerze, chronionym mechanizmem ochrony
  danych Windows (DPAPI). Omnilinker nigdy nie prosi o hasło do bazy danych ERP, nie przechowuje go ani go nie
  otrzymuje.
* **Wszystkie połączenia wychodzą z Twojej sieci.** To agent łączy się z Omnilinkerem; Omnilinker nigdy nie łączy się
  z Twoją siecią. Agent loguje się kluczem API agenta, który generujesz dla połączenia.
* **Omnilinker nigdy nie uruchamia kodu ERP.** Logika specyficzna dla ERP (dostawca) działa wyłącznie w agencie.
  Agent przesyła opis swojego dostawcy, w tym pola ERP, które potrafi odczytać, a ekrany mapowania w Omnilinkerze są
  budowane na podstawie tego opisu.

## Co jest synchronizowane

Dane płyną w jedną stronę: z ERP do Omnilinkera. Omnilinker nie zapisuje jeszcze niczego z powrotem do ERP.

| Dane                                                 | Gdzie trafiają w Omnilinkerze           | Wymaga śledzenia zmian WFM\_INT |
| ---------------------------------------------------- | --------------------------------------- | ------------------------------- |
| Produkty                                             | Produkty w katalogu                     | Nie                             |
| Marki                                                | Marki w katalogu                        | Nie                             |
| Skład zestawu (składniki produktu będącego zestawem) | Zestawy w katalogu                      | Nie                             |
| Poziomy cen                                          | Poziomy cen w katalogu                  | Nie                             |
| Ceny produktów                                       | Ceny dla każdego produktu i poziomu cen | Tak                             |
| Magazyny                                             | Magazyny w module Magazyn               | Tak                             |
| Stany magazynowe                                     | Stany w każdym magazynie                | Tak                             |

Agent wykrywa zmiany na jeden z dwóch sposobów, ustawiany osobno dla każdego połączenia:

* **Skanowanie skrótów** (domyślnie) porównuje rekordy ERP z tym, co agent wysłał wcześniej. Nie wprowadza żadnych
  zmian w bazie danych ERP. Obejmuje produkty i marki. Poziomy cen są odczytywane raz dziennie w obu trybach.
* **Śledzenie zmian WFM\_INT** korzysta z mechanizmu śledzenia zmian wbudowanego w ERP. Wykrywa zmiany szybciej
  i obejmuje też ceny, magazyny i stany magazynowe. Włączenie go zapisuje wiersze w tabelach mechanizmu śledzenia
  zmian ERP, nigdy w Twoich danych biznesowych, i wymaga Twojej zgody w aplikacji w zasobniku. Co dokładnie jest
  zapisywane, opisuje strona [Wymagania](/pl/erp/requirements#login-sql-server).

Zanim ceny i stany magazynowe zostaną zastosowane, poziomy cen i magazyny muszą być zmapowane na ich odpowiedniki
w Omnilinkerze. Zobacz [Dane słownikowe](/pl/erp/reference-items).

<Note>
  Zamówienia nie są synchronizowane. Integracja ERP nie wysyła do ERP zamówień z marketplace'ów ani z Omnilinkera
  i nie odczytuje z niego zamówień.
</Note>

## Obsługiwane systemy ERP

| System ERP     | Status                                             |
| -------------- | -------------------------------------------------- |
| Wapro          | Dostępny. Zobacz [Wapro](/pl/erp/providers/wapro). |
| Subiekt GT     | Jeszcze niedostępny                                |
| Comarch Optima | Jeszcze niedostępny                                |
| Enova          | Jeszcze niedostępny                                |

Lista **Dostawca** w aplikacji webowej pokazuje też Subiekt GT, Comarch Optima, Enova i Niestandardowy. Obecnie
tylko Wapro ma działającego dostawcę w agencie, więc przy tworzeniu połączenia wybierz **Wapro**.

## Skonfiguruj integrację

Najpierw sprawdź [wymagania](/pl/erp/requirements), a potem wykonaj poniższe kroki. Konfigurację dzielą między siebie
administrator organizacji, który pracuje w aplikacji webowej, i osoba z działu IT, która instaluje agenta.

<Steps>
  <Step title="Utwórz połączenie">
    W aplikacji webowej utwórz połączenie i wygeneruj jego klucz API agenta.
    Zobacz [Tworzenie połączenia](/pl/erp/create-connection).
  </Step>

  <Step title="Zainstaluj agenta">
    Zainstaluj agenta ERP Sync na komputerze z Windows, który ma dostęp do bazy danych ERP.
    Zobacz [Instalacja agenta](/pl/erp/install-agent).
  </Step>

  <Step title="Uruchom kreator konfiguracji">
    Wpisz w agencie klucz API agenta i dane bazy danych ERP.
    Zobacz [Kreator konfiguracji](/pl/erp/setup-wizard).
  </Step>

  <Step title="Skonfiguruj synchronizację">
    Wybierz, co ma być synchronizowane, zmapuj pola oraz poziomy cen i magazyny.
    Zobacz [Konfiguracja synchronizacji](/pl/erp/sync-configuration), [Mapowanie pól](/pl/erp/field-mappings)
    i [Dane słownikowe](/pl/erp/reference-items).
  </Step>
</Steps>

Gdy agent już działa, sprawdź na stronie [Monitorowanie](/pl/erp/monitoring), czy zmiany docierają do Omnilinkera.