Nieaktualne stany z ERP: obniżki idą na kanały, podwyżki czekają

Problem: ERP milczy, a sprzedaż trwa

Agent ERP działa na komputerze w Twojej firmie i co kilka minut wysyła do NavyFlame stany z Subiektu GT, Subiekta nexo, Comarch ERP Optima albo Symplex Small Business. Wystarczy wyłączony komputer, zamknięty program albo zerwane połączenie, a stany w NavyFlame przestają się odświeżać. Sprzedaż na Allegro i w sklepie tymczasem trwa.

NavyFlame uznaje stany za nieaktualne po progu świeżości. Wcześniej taki stan zatrzymywał całą wysyłkę stanów na kanały. Kanały nie dostawały wtedy nawet obniżek i zer, więc sprzedaż ostatniej sztuki na jednym koncie nie zdejmowała jej z pozostałych. Dziś domyślnie działa to inaczej:

• obniżki i zera nadal idą na kanały, na przykład po sprzedaży na innym kanale albo po ręcznym zmniejszeniu stanu;
• podwyżki czekają, aż ERP przyśle świeże dane.

Tak samo NavyFlame traktuje Shopera ustawionego jako jedyne źródło stanów, gdy jego ostatnie pobranie się nie udało, jest wstrzymane do sprawdzenia albo jeszcze się nie odbyło.

Dlaczego obniżka jest bezpieczna, a podwyżka nie. Dopóki ERP milczy, stan pozycji w NavyFlame się nie zmienia, a dostępna ilość spada tylko przez rezerwacje ze sprzedaży albo ręczną zmianę w panelu. Obniżka liczona z tych danych nigdy nie wystawi towaru, którego może nie być. Podwyżka mogłaby: ERP mógł już obniżyć stan, na przykład po sprzedaży w sklepie stacjonarnym, której NavyFlame nie widzi.

Przykład demonstracyjny, nie dane klienta: agent wysyła stany co 15 minut, próg świeżości to 60 minut. O 10:00 agent przestaje działać. O 11:30 na Allegro sprzedaje się 1 z 3 sztuk kubka, a klient sklepu anuluje zamówienie na 2 talerze, więc ich rezerwacja się zwalnia. Sklep i drugie konto dostają nową ilość kubka, 2 sztuki. Wyższa ilość talerzy czeka do najbliższej udanej synchronizacji z ERP.

Opis odpowiada panelowi NavyFlame z 11 listopada 2026 r. Część połączeń z programami ERP panel oznacza jako Beta, co znaczy, że nie przeszły jeszcze pełnego testu na koncie produkcyjnym. Zakres samej integracji opisuje artykuł o Subiekcie GT z Allegro i sklepem.

Gdzie zobaczysz, że stany są nieaktualne

Wszystkie miejsca są w Magazyn → Automatyzacja, w zakładce „Przepływ stanów”:

• Karta „Świeżość stanów z ERP” pokazuje źródło, czas ostatniej synchronizacji i stan, na przykład „Stany nieaktualne (próg 60 min): podwyżki na kanałach czekają.”
• Karta „Synchronizacja stanów z kanałami” przy każdym koncie sprzedaży pokazuje wynik ostatniego przebiegu. Przy nieaktualnym ERP zobaczysz „Wysłano tylko obniżenia, N podwyżek czeka” z powodem „Wstrzymana: stany z Subiekta są nieaktualne, więc czekamy na świeże dane, żeby nie sprzedać towaru, którego nie ma.”
• Powiadomienie o nieaktualnym ERP mówi, czy wstrzymane są tylko podwyżki, czy cała wysyłka.

W tej samej karcie synchronizacji blok agenta ERP może pisać, że wysyłka do kanałów jest wstrzymana. Przy ustawieniu domyślnym chodzi o podwyżki: obniżki i zera nadal wychodzą, co widać w wierszu „Wysłano tylko obniżenia” przy kontach.

Gdy agent znowu przyśle stany, podwyżki wychodzą w najbliższym przebiegu każdego konta. Nie musisz niczego klikać.

Krok 1. Ustaw próg świeżości

Domyślnie próg wysyła sam agent razem z każdą paczką stanów. Możesz go przejąć w panelu:

1. Otwórz kartę „Świeżość stanów z ERP”.
2. W sekcji „Po jakim czasie stany z ERP są nieaktualne” wybierz jedną z opcji:
   • „Jak w agencie ERP”, z liczbą minut z agenta;
   • „Własny próg ustawiony tutaj” i wpisz minuty, od 1 do 10 080;
   • „Wyłącz strażnika świeżości”.
3. Kliknij „Zapisz”.

Jak dobrać wartość. Agent wysyła stany co tyle minut, ile ma w zmiennej POLL_INTERVAL_MINUTES w swoim pliku .env, domyślnie co 15. Próg równy jednemu cyklowi zatrzyma podwyżki przy każdym drobnym opóźnieniu. Próg kilku cykli, na przykład 60 minut przy 15 minutach agenta, pozwala przeczekać pojedynczy nieudany cykl. Zbyt długi próg sprawi, że podwyżki będą wychodzić z danych, które już się zestarzały.

Własny próg i wyłączenie ustawisz dopiero wtedy, gdy agent przyśle pierwszy stan. Panel pokazuje wtedy „Własny próg i wyłączenie ustawisz, gdy agent ERP przyśle pierwszy stan.” To celowe: zegar bez żadnej synchronizacji liczy się jako nieaktualny i wstrzymałby podwyżki na wszystkich kanałach.

Wyłączenie strażnika oznacza, że podwyżki wychodzą niezależnie od wieku stanów. Panel ostrzega: „Bez strażnika podwyżki wychodzą także wtedy, gdy agent ERP nie działa. Towar, którego już nie ma, może zostać wystawiony.” Używaj tego tylko wtedy, gdy świadomie godzisz się na to ryzyko.

Konto Subiekta połączone własnym tokenem ma osobny próg w ustawieniach tego konta, w polu „Próg nieaktualności (minuty)”. Puste pole oznacza próg z ustawień agenta.

Krok 2. Rozstrzygnij SKU spoza katalogu

Agent czasem przysyła stan towaru, którego nie ma w katalogu NavyFlame, na przykład po zmianie symbolu w ERP. Kiedyś taka pozycja zatrzymywała całą paczkę. Teraz trafia na listę „SKU spoza katalogu” w karcie „Świeżość stanów z ERP”, a pozostałe stany zapisują się normalnie i zegar świeżości idzie dalej.

Lista ma jedno ważne zabezpieczenie. Dopóki są na niej nierozstrzygnięte SKU, NavyFlame nie zeruje pozycji, których ERP już nie wysyła. Nowe SKU może być zmienionym symbolem takiej pozycji, a wyzerowanie go zdjęłoby z kanałów towar, który leży na półce.

Co zrobić z każdą pozycją:

• Towar powinien być w katalogu. Dodaj go albo popraw SKU w karcie produktu. Wpis zniknie z listy sam.
• Pozycja nigdy nie będzie w katalogu, na przykład usługa albo opakowanie w ERP. Kliknij „Nie będzie w katalogu”. Pozycja zostanie pominięta i przestanie blokować zerowanie. Decyzję cofniesz przyciskiem „Cofnij”.

Krok 3. Zdecyduj o opcji dla nieaktualnego źródła

Zachowanie z tego artykułu włącza pole „Przy nieaktualnym źródle stanów wysyłaj obniżenia” w module „Stany i rezerwacje”. Moduł otworzysz linkiem „Wersje i historia zmian ustawień stanów” w zakładce „Przepływ stanów”. Domyślnie pole jest włączone.

Po zmianie pola kliknij „Sprawdź skutek”. Gdy źródło jest akurat nieaktualne, podgląd pokaże, ile obniżek i podwyżek czeka: „Źródło stanów jest teraz nieaktualne. Do wysłania czeka obniżeń: X, podwyżek: Y”. Gdy źródło jest aktualne, zobaczysz „Źródło stanów jest teraz aktualne, opcja nic dziś nie zmienia.” Zapis wymaga świeżego podglądu.

Wyłączenie pola przywraca dawne zachowanie: przy nieaktualnym źródle cała wysyłka czeka, także obniżki i zera. Sprzedaż na jednym kanale nie zdejmie wtedy towaru z pozostałych do czasu odświeżenia ERP. W typowym sklepie zostaw ustawienie domyślne.

Jedno zastrzeżenie. Jeśli masz wyłączoną opcję „Wysyłaj stan 0 do kanałów przy braku towaru”, zera nadal są wstrzymane, także przy nieaktualnym źródle. Ta opcja niczego tu nie zmienia.

Krok 4. Ustal kolejność źródeł stanu w magazynie

Ten krok jest potrzebny tylko wtedy, gdy stan jednego magazynu zapisuje więcej niż jeden system: na przykład ERP i hurtownia XML albo program księgowy i ponowny import z kanału. Bez ustawień każde źródło zapisuje jak dotąd, a wygrywa ostatni zapis. Wtedy stan potrafi skakać między dwiema wartościami.

1. Otwórz Magazyn → Lokalizacje.
2. Przy magazynie kliknij ikonę „Źródła stanu”.
3. Wybierz „Źródło nadrzędne”. Możliwe źródła to „ERP”, „Program księgowy”, „Hurtownia”, „Źródło stanów Shoper” i „Ponowny import z kanału”.
4. Opcjonalnie dodaj do czterech źródeł pomocniczych przyciskiem „Dodaj źródło pomocnicze” i ustaw ich kolejność.
5. Kliknij „Zapisz”.

Jak NavyFlame rozstrzyga zapis do tego magazynu:

Sekcja „Produkty przejęte przez źródła” pokazuje, które źródło trzyma które produkty. Gdy usuniesz źródło z kolejności, jego przejęcia znikają. Jeśli ktoś zmienił ustawienia w tym samym czasie, panel wczyta aktualne i poprosi o ponowny zapis.

Produkt bez rozpisania na lokalizacje trzyma cały stan w magazynie domyślnym, więc obowiązują go ustawienia magazynu domyślnego. Więcej o pracy z kilkoma magazynami przeczytasz w poradniku o wielomagazynowości.

Krok 5. Ręczne zmiany: dozwolone, korekta z przyczyną albo blokada

W tym samym oknie „Źródła stanu” ustawiasz pole „Ręczne zmiany stanu”:

• „Dozwolone” to ustawienie domyślne. Panel, API i import pliku zmieniają stan jak dotąd.
• „Tylko korekta z przyczyną”. Bezpośrednia zmiana jest zablokowana. Stan zmienia korekta, a jej przyczyna i autor trafiają do historii stanów.
• „Zablokowane”. Stan zmieniają tylko źródła i dokumenty.

Jak wykonać korektę:

1. W Magazynie przy produkcie wybierz z menu „Lokalizacje”.
2. Przy magazynie kliknij ikonę „Korekta z przyczyną”.
3. Wpisz „Nowy stan” i „Przyczyna”, od 3 do 500 znaków, na przykład „Inwentaryzacja półki A3, 2 sztuki uszkodzone”.
4. Kliknij „Zapisz korektę”. Panel potwierdzi: „Zapisano korektę. Stan produktu: N.”

Jeśli w trybie korekty wpiszesz nową liczbę bezpośrednio w oknie „Lokalizacje” i zapiszesz, panel sam otworzy okno korekty z tą liczbą. W trybie „Zablokowane” korekty nie ma, a panel odpowie: „Ten magazyn przyjmuje stan tylko ze źródeł i dokumentów, więc korekta nie jest możliwa.” Wtedy rozbieżność wyjaśniasz dokumentem, na przykład inwentaryzacją.

Edycja nazwy czy opisu produktu nie jest blokowana, jeśli zapis powtarza obecny stan. Korekta wymaga uprawnienia „Zmiana stanów” (stock:adjust) albo zapisu magazynu, a ustawienia źródeł uprawnienia „Konfiguracja stanów” (stock:configure).

Najczęstsze sytuacje

Zakres połączeń z programami ERP opisują strony integracji Subiekt GT, Subiekt nexo i Comarch ERP Optima, a karty stanów obejrzysz bez logowania w demo.