Pierwsza synchronizacja kanału: co się stanie ze stanami na platformie
Kanały sprzedaży i marketplace'y. Treść zweryfikowana: 12 października 2026.
Do czego to służy
Pierwsze włączenie synchronizacji to jedyny moment, w którym Zaksio może jednorazowo zmienić bardzo wiele stanów na Twojej platformie. Ten artykuł opisuje, co dokładnie się wtedy dzieje, i co sprawdzić wcześniej. Przeczytaj go przed pierwszym kliknięciem „Start”.
Gdzie to znaleźć w aplikacji
Sprzedaż i logistyka, „Kanały sprzedaży”, wybrany kanał. Zakładka „Połączenie” (sprawdzenie), „Pule stanów” (ile towaru widzi kanał), „Oferty” (mapowanie) i „Synchronizacja” (kolejka zadań, „Uruchom synchronizację”, „Pełne uzgodnienie”). „Start” i „Stop” wyłączają i włączają całą synchronizację kanału.
Krok po kroku: przed „Start”
- Zapisz klucze i kliknij „Sprawdź połączenie”. Bez udanego sprawdzenia synchronizacji nie da się włączyć, podobnie jak przy wstrzymanym lub wyłączonym kanale.
- W zakładce „Oferty” zmapuj oferty na towary. Oferty z pasującym SKU lub EAN Zaksio przypisuje samo, konflikty musisz rozstrzygnąć ręcznie. Stany wysyłamy tylko dla ofert wskazujących towar.
- Sprawdź stany magazynowe tych towarów. Każdy towar bez stanu w magazynie zostanie na platformie ustawiony na 0.
- W zakładce „Pule stanów” ustaw, ile towaru ma widzieć kanał (tryby „Wszystko”, „Procent stanu”, „Stała liczba”) i bufor odejmowany od wyliczonej ilości. Bez żadnej puli kanał widzi cały dostępny stan.
- Wyeksportuj stany z panelu platformy, jeśli chcesz mieć do czego wrócić.
- Kliknij „Start”. Pierwszy przebieg pobierze zamówienia i oferty, a po zmapowaniu uzgodni i wyśle stany.
Co się dzieje po „Start”
- Zamówienia: pierwszy import obejmuje ostatnie 7 dni. Okno zmienia ustawienie kanału „initialImportDays” (od 0 do 90 dni). Import jest idempotentny, więc to samo zamówienie nie powstanie dwa razy.
- Ceny: domyślnie nie są wysyłane na platformę. Włącza je ustawienie kanału „syncPrices” (wartość „true”). Pola do tych dwóch ustawień nie ma jeszcze w zakładce „Ustawienia”, zmienia się je przez ustawienia kanału w API.
- Stany: oprócz pierwszego uzgodnienia powtarza się ono co 6 godzin oraz po pełnym pobraniu ofert. Rozjazd stanu po stronie platformy jest więc korygowany cyklicznie, a nie na bieżąco.
Jak wyłączyć
Kliknij „Stop” w kanale. Wstrzymuje to pobieranie i wysyłkę, ale niczego nie cofa: stany już wysłane zostają na platformie. Synchronizację można też zatrzymać, ustawiając kanał jako „Wstrzymany” albo „Wyłączony”. Administrator platformy może wyłączyć synchronizację globalnie lub dla organizacji.
Błędy i martwe zadania
- Zadanie stanu lub ceny z błędem trwałym ma status „Nieudane” i wymaga ręcznego „Ponów” w zakładce „Synchronizacja”. Błędy chwilowe są ponawiane automatycznie z rosnącą przerwą od 30 sekund do godziny, po 5 próbach zadanie też staje się „Nieudane”, a zespół dostaje alert.
- Zamówienie, którego nie udało się zaimportować, jest ponawiane do 5 razy, potem trafia do nieudanych z alertem. Synchronizacja idzie dalej, żadne zamówienie nie ginie.
- „Wymaga ponownego połączenia”: platforma odrzuciła klucze lub token (po jednej próbie odświeżenia). Synchronizacja kanału jest wstrzymana, a zespół dostaje alert. Wpisz klucze ponownie, a w Allegro autoryzuj konto od nowa.
- Obwód: po 5 kolejnych przebiegach z błędem połączenia obwód się otwiera, a kolejne próby są rozstawione w czasie (do godziny) i generują alert. Odpowiedź platformy „za dużo zapytań” (429) wstrzymuje kanał na wskazany przez nią czas bez liczenia błędów.
Czego jeszcze nie ma
- Ostrzeżenia i potwierdzenia przed „Start” oraz podglądu różnic platforma kontra Zaksio.
- Wykrywania rozjazdu stanu po stronie platformy na bieżąco: dziś tylko cykliczne nadpisanie.
- Automatycznego zwrotu z platformy: zwroty tylko powiadamiają zespół.