> ## 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.
# Konfiguracja synchronizacji
> Wybierz, które rodzaje danych z ERP są synchronizowane, jak agent wykrywa zmiany i jak często działa.
Połączenie synchronizuje tylko te rodzaje danych, dla których ma konfigurację synchronizacji. Tworzysz jedną
konfigurację synchronizacji na typ encji (produkty, marki, ceny itd.) na karcie **Konfiguracja synchronizacji**
połączenia. Ustawienia dotyczące całego połączenia, takie jak tryb śledzenia zmian, znajdziesz w oknie
**Edytuj połączenie**.
Obecnie dane płyną w jedną stronę: z Twojego ERP do Omnilinkera. Agent nie zapisuje niczego w Twoim ERP, niezależnie
od tego, co wybierzesz w polach **Kierunek**, **Źródło główne** czy **Zachowanie przy usuwaniu**. Zobacz
[Co ustawienia robią obecnie](#co-ustawienia-robią-obecnie).
## Dodawanie konfiguracji synchronizacji
Potrzebujesz uprawnienia **Zarządzanie konfiguracjami synchronizacji**.
Otwórz **Integracja ERP** > **Połączenia** i wybierz **Szczegóły** przy połączeniu.
Na karcie **Konfiguracja synchronizacji** kliknij **Dodaj konfigurację**.
Wybierz **Typ encji**. Każdy typ encji może mieć jedną konfigurację na połączenie.
Kliknij **Załaduj domyślne ustawienia**, aby wypełnić pola wartościami zalecanymi przez dostawcę. Jeśli Omnilinker
zgłosi, że ustawienia domyślne nie są dostępne, ustaw samodzielnie wartości z sekcji
[Zalecane wartości dla Wapro](#zalecane-wartości-dla-wapro).
Sprawdź pola **Kierunek** i **Źródło główne**, a następnie kliknij **Utwórz**. Konfiguracja jest od razu włączona.
Zachowania przy usuwaniu ani ustawień czasowych nie ma w oknie **Dodaj konfigurację**. Aby je zmienić, edytuj
konfigurację po jej utworzeniu.
W przypadku Wapro dodaj konfigurację dla każdego z tych typów encji: **Produkt**, **Marka**, **Poziom cen**,
**Cena produktu**, **Magazyn** i **Stan magazynowy**. Agent wysyła produkty i marki tylko wtedy, gdy ich konfiguracja
istnieje i jest włączona. Ceny produktów i magazyny są wysyłane, chyba że dodasz ich konfigurację i ją wyłączysz.
## Edycja, wyłączanie i usuwanie konfiguracji
Na karcie **Konfiguracja synchronizacji** każdy wiersz pokazuje **Typ encji**, **Kierunek**, **Źródło główne** oraz stan
**Włączone** lub **Wyłączone**.
* Kliknij ikonę edycji, aby otworzyć okno **Edytuj konfigurację synchronizacji**.
* Kliknij **Wyłącz**, aby przestać synchronizować ten typ encji, i **Włącz**, aby wznowić synchronizację.
* Kliknij **Usuń**, aby usunąć konfigurację.
Zmiany docierają do agenta w ciągu kilku minut. Agent pobiera nową konfigurację przy następnym sygnale kontrolnym
(heartbeat), wysyłanym co minutę, a niezależnie od tego sprawdza, czy jest nowa konfiguracja, co 5 minut.
## Ustawienia
### Ustawienia podstawowe
| Ustawienie | Opcje | Znaczenie |
| ---------------------------- | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **Kierunek** | **Z ERP**, **Do ERP**, **Dwukierunkowa** | Kierunek, w którym mają płynąć dane tego typu encji. Wybierz **Z ERP**. |
| **Źródło główne** | **ERP**, **Katalog** | System, który jest właścicielem tych danych. Wybierz **ERP**. |
| **Zachowanie przy usuwaniu** | **Pomiń**, **Miękkie usuwanie**, **Twarde usuwanie** | Co zrobić w ERP, gdy element zostanie usunięty w Omnilinkerze. Zobacz [Zachowanie przy usuwaniu](#zachowanie-przy-usuwaniu). |
| **Rozmiar paczki** | 1–1000 | Liczba zmian, które agent odczytuje z kanału zmian ERP w jednej paczce dla tego typu encji. |
Nowa konfiguracja ma domyślnie ustawione **Dwukierunkowa** i **ERP**. Ustawienia domyślne Wapro to **Z ERP** i **ERP**.
### Wyzwalacze synchronizacji
**Przy tworzeniu**, **Przy aktualizacji** i **Przy usuwaniu** (przy dodawaniu konfiguracji widoczne jako
**Synchronizuj przy tworzeniu**, **Synchronizuj przy aktualizacji** i **Synchronizuj przy usuwaniu**) określają, jakie
rodzaje zmian mają być synchronizowane. Są przeznaczone do synchronizacji z Omnilinkera do ERP. Zmiany z ERP są
stosowane niezależnie od tego, co tu zaznaczysz.
### Zachowanie przy usuwaniu
Zachowanie przy usuwaniu dotyczy tylko usunięć przekazywanych z Omnilinkera do ERP:
| Opcja | Znaczenie |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pomiń** | Nie przekazuj usunięć do ERP. To opcja domyślna i najbezpieczniejsza. |
| **Miękkie usuwanie** | Zamiast usuwać element w ERP, oznacz go jako nieaktywny lub wycofany. |
| **Twarde usuwanie** | Usuń element w ERP. Tej operacji nie można cofnąć. Twarde usunięcie może naruszyć ślady audytowe, faktury i historię stanów magazynowych w ERP. |
Omnilinker nie zapisuje jeszcze niczego w Twoim ERP, więc obecnie żadna z tych opcji nie zmienia Twojego ERP. Zostaw
**Pomiń**.
Usunięcia w przeciwnym kierunku są przekazywane. Gdy artykuł zostanie usunięty w Wapro albo przestanie być aktywny
dla systemów zewnętrznych, agent zgłasza go jako usunięty, a Omnilinker usuwa odpowiadający mu produkt w katalogu.
Zobacz [Wapro](/pl/erp/providers/wapro#kiedy-produkt-uznaje-się-za-usunięty).
### Zaawansowane ustawienia czasowe
Aby zobaczyć te ustawienia, rozwiń **Zaawansowane ustawienia czasowe** w oknie **Edytuj konfigurację synchronizacji**.
Gdy sekcja jest zwinięta, jednowierszowe podsumowanie pokazuje bieżące wartości.
| Sekcja | Ustawienie | Zakres | Wartość domyślna |
| ------------------------------------- | ------------------------------- | ----------------------------------------------------- | --------------------------------------------------- |
| **Główne odpytywanie** | **min** i **sek** | Od 10 sekund do 1 godziny | 60 sekund |
| **Wykrywanie zmian przez hash** | **Włączone** | Włączone lub wyłączone | Włączone |
| | **Sprawdzaj co (min)** | Od 1 minuty do 24 godzin | 15 minut |
| | **Rozmiar paczki** | 100–100 000 | 10 000 w domyślnych ustawieniach produktu dla Wapro |
| **Harmonogram pełnej synchronizacji** | **Uruchamiaj co (godz.)** | Od 1 godziny do 7 dni | 24 godziny |
| **Publikowanie Outbox** | **Rozmiar partii Outbox** | 1–1000, nie więcej niż **Limit partii API w chmurze** | 100 |
| | **Limit partii API w chmurze** | 1–1000 | 100 |
| | **Interwał publikacji** | 1–60 sekund | 5 sekund |
| | **Maksymalna liczba powtórzeń** | 1–10 | 5 |
### Co ustawienia robią obecnie
Nie każde ustawienie na tym ekranie zmienia działanie agenta w bieżącej wersji. Ta tabela pokazuje, których ustawień
agent używa.
| Ustawienie | Używane obecnie? |
| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Włączona lub wyłączona | Tak, dla typów **Produkt**, **Marka**, **Cena produktu** i **Magazyn**. Poziomy cen przychodzą z codziennym przesłaniem danych słownikowych, a stany magazynowe ze zmianami produktów, niezależnie od ich własnej konfiguracji. |
| **Rozmiar paczki** (ustawienia podstawowe) | Tak, jako rozmiar paczki, gdy agent odczytuje kanał zmian WFM\_INT. |
| **Wykrywanie zmian przez hash**: **Włączone**, **Sprawdzaj co**, **Rozmiar paczki** | Tak, w trybie **Skanowanie skrótów**, na podstawie konfiguracji typu **Produkt** (lub **Marka**, jeśli nie ma konfiguracji produktu). |
| **Rozmiar partii Outbox**, **Limit partii API w chmurze** | Tak. Agent używa największej wartości spośród wszystkich konfiguracji połączenia. |
| **Kierunek**, **Źródło główne**, **Zachowanie przy usuwaniu**, wyzwalacze synchronizacji | Nie. Będą miały znaczenie, gdy Omnilinker będzie mógł zapisywać dane w ERP. |
| **Główne odpytywanie**, **Harmonogram pełnej synchronizacji**, **Interwał publikacji**, **Maksymalna liczba powtórzeń** | Nie. Agent używa własnych stałych interwałów, wymienionych w sekcji [Jak często dane są synchronizowane](#jak-często-dane-są-synchronizowane). |
## Ustawienia synchronizacji dla całego połączenia
Te ustawienia dotyczą wszystkich typów encji w połączeniu. Otwórz **Integracja ERP** > **Połączenia**, wybierz
**Edytuj** przy połączeniu i znajdź je w sekcji **Ustawienia synchronizacji**. Potrzebujesz uprawnienia
**Edycja połączeń ERP**.
| Ustawienie | Działanie |
| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Automatycznie twórz magazyny** | Tworzy magazyn w Omnilinkerze dla każdego magazynu ERP, którego nie zmapowano. Zobacz [Dane słownikowe](/pl/erp/reference-items#automatyczne-tworzenie). |
| **Automatycznie twórz poziomy cen** | Tworzy poziom cen w katalogu dla każdego poziomu cen ERP, którego nie zmapowano. Zobacz [Dane słownikowe](/pl/erp/reference-items#automatyczne-tworzenie). |
| **ID magazynu źródłowego** | W systemach ERP, które przechowują osobny wiersz produktu dla każdego magazynu: magazyn, którego wiersz dostarcza dane produktu. Zostaw **— nie ustawiono — (automatyczna wartość domyślna)**, aby agent wybrał go sam. |
| **Tryb śledzenia zmian** | Sposób wykrywania zmian w ERP przez agenta: **Skanowanie skrótów** lub **Śledzenie zmian WFM\_INT**. Zobacz niżej. |
| **Źródło ceny zestawu** | Skąd pochodzą ceny zestawów: **Stała — z ERP** lub **Kalkulowana — ze składników**. Zobacz [Ceny zestawów](#ceny-zestawów). |
### Tryb śledzenia zmian
| Tryb | Jak działa | Co obejmuje |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Skanowanie skrótów** (domyślny) | Agent odczytuje rekordy ERP według harmonogramu, oblicza skrót (hash) zmapowanych pól i wysyła rekordy, których skrót się zmienił. Nie wprowadza żadnych zmian w bazie danych ERP. | Produkty i marki. |
| **Śledzenie zmian WFM\_INT** | Agent rejestruje się we własnym mechanizmie śledzenia zmian Wapro i mniej więcej raz na minutę odczytuje zarejestrowane przez niego zmiany. Cotygodniowe uzgadnianie wychwytuje wszystko, co zostało pominięte. | Produkty, ceny produktów, magazyny i stany magazynowe. Marki są wychwytywane przez cotygodniowe uzgadnianie. |
W obu trybach agent codziennie przesyła też poziomy cen, magazyny i inne dane słownikowe, a co 6 godzin składy
zestawów.
Przejście na **Śledzenie zmian WFM\_INT** wymaga dwóch kroków, w tej kolejności:
Na komputerze z agentem otwórz ustawienia aplikacji w zasobniku. W sekcji **ERP Change Tracking** zaznacz
**I consent to Omnilinker registering change tracking in the WFM\_INT framework tables**, a następnie kliknij
**Enable Change Tracking**. Ta operacja zapisuje dane w tabelach frameworku Wapro, więc login SQL potrzebuje
dodatkowych uprawnień. Zobacz [Wymagania](/pl/erp/requirements) i
[Wapro](/pl/erp/providers/wapro#co-agent-zapisuje-w-twojej-bazie-danych).
W aplikacji webowej wybierz **Edytuj** przy połączeniu, ustaw **Tryb śledzenia zmian** na
**Śledzenie zmian WFM\_INT** i kliknij **Zapisz**.
Agent używa WFM\_INT tylko wtedy, gdy oba warunki są spełnione. Jeśli połączenie wymaga WFM\_INT, ale agent nie jest
zarejestrowany, agent nadal używa skanowania skrótów. Karta **Agent** połączenia pokazuje tryb, którego agent
faktycznie używa.
Aby wrócić, ustaw **Tryb śledzenia zmian** na **Skanowanie skrótów**. Aby dodatkowo usunąć rejestrację z bazy danych
ERP, kliknij **Disable Change Tracking** w aplikacji w zasobniku.
Ponowna rejestracja śledzenia zmian w przyszłości oznacza wszystkie rekordy jako nowe, więc agent wyśle ponownie cały
Twój katalog jako pełne uzupełnienie danych.
### Ceny zestawów
**Źródło ceny zestawu** decyduje o tym, jak zapisywana jest cena zestawu zaimportowanego z ERP:
| Opcja | Znaczenie |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Stała — z ERP** (domyślna) | Ceny zestawów są pobierane bez zmian z artykułu zestawu w ERP. |
| **Kalkulowana — ze składników** | Ceny zestawów są obliczane z cen składników: jako suma cen netto składników, opodatkowana stawką VAT samego zestawu. Są przeliczane, gdy zmieni się skład zestawu lub cena składnika. O tym, jakie poziomy cen istnieją, nadal decyduje ERP, a gdy brakuje ceny składnika, używana jest cena zestawu z ERP. |
To ustawienie dotyczy tylko zestawów. Produkty proste pozostają bez zmian.
## Jak przepływają zmiany
Z ERP do Omnilinkera każda zmiana przechodzi tę samą drogę:
1. Agent wykrywa zmianę w bazie danych ERP za pomocą skanowania skrótów lub WFM\_INT.
2. Agent zapisuje zmianę w swojej lokalnej kolejce wychodzącej (outbox), zanim oznaczy ją w ERP jako odczytaną. Gdy
połączenie z internetem zostanie przerwane, zmiany czekają w kolejce wychodzącej.
3. Co 5 sekund agent wysyła oczekujące zmiany do Omnilinkera przez HTTPS, w skompresowanych paczkach.
4. Omnilinker stosuje Twoje [mapowania pól](/pl/erp/field-mappings) do produktów i marek, a następnie tworzy lub
aktualizuje produkt, markę, poziom cen lub cenę w katalogu. Zmiany magazynów i stanów magazynowych trafiają do
modułu magazynowego.
5. Każda zmiana jest rejestrowana na karcie **Logi synchronizacji** połączenia. Zobacz [Monitorowanie](/pl/erp/monitoring).
Omnilinker pomija zmianę, zamiast oznaczać ją jako nieudaną, gdy coś, od czego ona zależy, jeszcze nie istnieje. Na
przykład cenę, której poziom cen nie jest zmapowany, albo stan magazynowy produktu, który jeszcze nie dotarł. Takie
zmiany są stosowane później, gdy zależność już istnieje. Zobacz
[Dane słownikowe](/pl/erp/reference-items#co-się-dzieje-z-niezmapowanymi-elementami).
Gdy zmiany docierają w innej kolejności, niż powstały, Omnilinker zachowuje najnowszą. Aktualizacja ze znacznikiem
czasu ERP starszym niż już zastosowany jest pomijana.
### Z Omnilinkera do ERP
Zapisywanie danych w ERP nie jest jeszcze dostępne. Edycja produktu w Omnilinkerze nie zmienia go w ERP. Następna
zmiana tego produktu w ERP nadpisze pola, które pochodzą z ERP.
## Jak często dane są synchronizowane
Oto domyślne ustawienia agenta.
| Co | Kiedy |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| Zmiany ze śledzenia zmian WFM\_INT | Co 60 sekund |
| Skanowanie skrótów (tryb **Skanowanie skrótów**) | Domyślnie co 15 minut (wartość **Sprawdzaj co** w konfiguracji produktu), po raz pierwszy 2 minuty po uruchomieniu agenta |
| Uzgadnianie (tryb **Śledzenie zmian WFM\_INT**) | Co tydzień oraz po wykryciu przez agenta aktualizacji Wapro |
| Poziomy cen, magazyny i inne dane słownikowe | Przy uruchomieniu agenta, potem codziennie |
| Składy zestawów | Przy uruchomieniu agenta, potem co 6 godzin |
| Wysyłanie zmian z kolejki do Omnilinkera | Co 5 sekund |
| Odświeżanie konfiguracji | W ciągu mniej więcej minuty od zmiany i nie rzadziej niż co 5 minut |
Własne interwały agenta ustawia się na komputerze z agentem. Zobacz
[Opis konfiguracji](/pl/erp/configuration-reference).
## Pierwsza synchronizacja
Nie ma osobnego ustawienia pełnej synchronizacji. Pierwsza synchronizacja odbywa się samoczynnie:
* **Skanowanie skrótów**: przy pierwszym skanowaniu agent nie ma jeszcze żadnych skrótów, więc wysyła wszystkie
produkty i marki.
* **Śledzenie zmian WFM\_INT**: rejestracja oznacza wszystkie istniejące rekordy jako nowe, więc agent wysyła wszystko.
Najpierw wysyła dane słownikowe i magazyny, potem produkty i stany magazynowe, a na końcu ceny, tak aby zależności
każdego elementu docierały przed nim.
Pierwsza synchronizacja dużego katalogu może trwać wiele godzin. Dodanie pola do skrótu (zobacz
[Uwzględnij w weryfikacji hash](/pl/erp/field-mappings#wykrywanie-zmian)) również sprawia, że następne skanowanie
skrótów ponownie wyśle wszystkie produkty.
Przycisk **Uruchom synchronizację** na stronie połączenia w bieżącej wersji nie uruchamia synchronizacji w agencie.
Zamiast tego rejestruje w połączeniu nieudaną próbę synchronizacji. Aby uruchomić synchronizację od razu, użyj
**Sync Now** w aplikacji w zasobniku. Zobacz [Aplikacja w zasobniku](/pl/erp/tray-app).
## Zalecane wartości dla Wapro
Oto ustawienia domyślne dostawcy Wapro, które wypełnia przycisk **Załaduj domyślne ustawienia**.
| Typ encji | Kierunek | Źródło główne | Rozmiar paczki | Weryfikacja hash | Sprawdzaj co |
| ------------------- | --------- | ------------- | -------------- | ---------------- | ------------ |
| **Produkt** | **Z ERP** | **ERP** | 100 | Włączona | 15 min |
| **Marka** | **Z ERP** | **ERP** | 50 | Włączona | 60 min |
| **Poziom cen** | **Z ERP** | **ERP** | 20 | Włączona | 60 min |
| **Cena produktu** | **Z ERP** | **ERP** | 500 | Wyłączona | — |
| **Magazyn** | **Z ERP** | **ERP** | 20 | Wyłączona | — |
| **Stan magazynowy** | **Z ERP** | **ERP** | 500 | Wyłączona | — |
Wszystkie używają opcji **Pomiń** w polu **Zachowanie przy usuwaniu**. Ceny produktów, magazyny i stany magazynowe
wymagają [śledzenia zmian WFM\_INT](#tryb-śledzenia-zmian).
## Następne kroki
Wybierz, które pola ERP wypełniają które pola w Omnilinkerze.
Zmapuj poziomy cen i magazyny z ERP.