OrderFlowby Lolisoft
Wróć do strony

Dokumentacja online

Instrukcje i materiały referencyjne dla sklepu

Praktyczne instrukcje dla Twojego sklepu WooCommerce i Allegro.

OrderFlow — instalacja i pierwszy import

Zacznij od jednej oferty Allegro, sprawdź wynik w WooCommerce, a następnie rozszerz zakres na katalog i automatyzację zamówień. Angielskie nazwy w nawiasach ułatwiają odnalezienie opcji w panelu.

1. Przygotuj sklep i paczkę

Potrzebujesz WordPressa 6.0+, aktywnego WooCommerce 8.0+, PHP 7.4+, konta sprzedawcy Allegro i dostępu administratora. Przed instalacją w działającym sklepie wykonaj kopię bazy danych i plików. Do sprawdzenia zmian bez wpływu na rzeczywistą sprzedaż użyj sklepu testowego i Allegro Sandbox.

Pobierz instalacyjną paczkę ZIP z potwierdzenia zakupu lub konta klienta. Przy pobieraniu z konta użyj adresu e-mail podanego przy zakupie i potwierdź go. Jeśli brakuje zakupu lub pliku, zobacz wsparcie i aktualizacje.

  1. W WordPressie otwórz Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer.
  2. Wgraj ZIP, wybierz Zainstaluj teraz, a następnie Włącz.
  3. Jeśli masz klucz licencji OrderFlow, otwórz Allegro Sync → License, wpisz go i wybierz Save and activate this site. Ta opcja zarządza dostępem do aktualizacji; stan licencji nie wyłącza importu i synchronizacji zainstalowanej wtyczki.

2. Połącz właściwy profil Allegro

  1. Otwórz Allegro Sync → Kreator konfiguracji (Setup Wizard) lub zarządzaj profilami bezpośrednio w Kontach (Accounts).
  2. Nazwij profil i wybierz środowisko oraz rynek. Production dotyczy rzeczywistych danych Allegro; Sandbox to osobne środowisko testowe.
  3. Jeżeli dostępna jest opcja Recommended quick setup, otwórz generator kodu wskazany w kreatorze, wklej świeży kod jednorazowy i kontynuuj przez Browser sign-in.
  4. Jeśli szybka konfiguracja nie jest dostępna albo korzystasz z własnej aplikacji, wybierz ścieżkę ręczną. Wpisz jej Client ID i Client Secret. Przy logowaniu w przeglądarce zarejestruj dokładnie ten adres powrotu, który pokazuje wtyczka. Opcja Code on another device jest dostępna w tej ręcznej ścieżce.
  5. Zapisz profil i zatwierdź dostęp w Allegro. Po powrocie do WordPressa sprawdź w Kontach, czy profil jest połączony i aktywny. W razie potrzeby użyj Verify Connection lub Health.

Hasło do Allegro wpisuj wyłącznie na stronie logowania Allegro. Chroń kody jednorazowe, dane aplikacji, tokeny i klucz licencji.

3. Ustaw zakres przed importem

Otwórz Allegro Sync → Ustawienia (Settings) i zapisz świadomie wybrane opcje. Ustawienia domyślne nie są konfiguracją testową: nowe produkty mogą być publikowane, a import zamówień może obejmować całą dostępną historię.

  • Filtry (Filters): wybierz status ofert i importowane pola. Na czas pierwszej kontroli ustaw WooCommerce Product Status na Draft — szkic.
  • Stock Sync Direction, Price Sync Direction, Product Content Sync Direction: określ źródło każdego pola. Wybierz Allegro → WooCommerce, gdy dane mają pochodzić z Allegro. WooCommerce → Allegro włączaj dla zmian, które zamierzasz wysyłać na Allegro. Wyłączenie i oba kierunki to osobne opcje.
  • Overwrite Existing Products: pozostaw wyłączone, gdy chcesz chronić ręcznie przygotowaną treść WooCommerce. Przed odświeżaniem powiązanych produktów sprawdź tę opcję razem z kierunkiem treści.
  • Narzut (Markup): wybierz brak narzutu, kwotę lub procent. Narzut zmienia ceny w jednokierunkowym Allegro → WooCommerce, również przy kolejnych odświeżeniach. Aktualizacje powiązanych produktów w obu kierunkach pomijają narzut. Nie jest osobną regułą narzutu ceny sprzedaży na Allegro.
  • Zamówienia (Orders): pozostaw Enable Orders Sync wyłączone do czasu ustalenia zakresu historii i wpływu importu na realizację zamówień.

Pierwszy import może tworzyć treść produktu nawet przy wyłączonej dalszej synchronizacji treści. Powiązane produkty mogą mieć własne wyjątki dla kierunku cen i stanów; sprawdź je, jeżeli ustawienie globalne nie daje oczekiwanego efektu.

4. Zaimportuj jedną ofertę

  1. Otwórz Allegro Sync → Pulpit (Dashboard) i znajdź Ponowna synchronizacja pojedynczej oferty (Re-sync Single Offer).
  2. Wpisz wyłącznie cyfrowy identyfikator oferty Allegro i wybierz Sync Offer. Ta akcja może zaimportować nową ofertę lub odświeżyć już powiązany produkt.
  3. Otwórz produkt w WooCommerce. Sprawdź status szkicu/publikacji, tytuł, opis, zdjęcia, atrybuty, kategorię, cenę regularną i stan.
  4. Sprawdź powiązanie z ofertą, zwłaszcza jeśli sklep zawiera już odpowiadający jej produkt. Przed importem tego samego katalogu przez dwie integracje ustal sposób mapowania produktów.
  5. Sprawdź Historię i Logi. Wynik „pominięto” może wynikać z reguł istniejących produktów, wykluczeń lub importu; ustal przyczynę przed powtórzeniem.

Gdy wynik jest poprawny, użyj akcji katalogowych na Pulpicie do większego importu. Sprawdź reprezentatywną próbkę, w tym warianty, zanim opublikujesz produkty lub włączysz aktualizacje w kierunku Allegro.

5. Wybierz historię zamówień

W Ustawienia → Zamówienia ustaw Order Import Window:

  • Import all available orders pobiera historię dostępną przez Allegro.
  • Import orders from a specific date przyjmuje wskazaną datę zakupu jako dolną granicę.
  • Start from today and skip older orders zapisuje punkt początkowy widoczny w ustawieniach; sprawdź tę datę, gdy wracasz do konfiguracji.

Ustaw Orders Sync Interval, a następnie włącz synchronizację, gdy jesteś gotowy. Akcja Order Import na Pulpicie używa tych ustawień. Włączony import zamówień uruchamia się także na końcu pełnej synchronizacji.

Nie ma przełącznika „tylko opłacone”. Przed uznaniem zamówienia za gotowe do wysyłki sprawdź płatność, pobranie, anulowanie i status realizacji. W pierwszym zaimportowanym zamówieniu zweryfikuj adresy, pozycje, walutę i kwoty.

6. Włącz i sprawdź automatyzację

Uruchom Hosting benchmark w ustawieniach synchronizacji, gdy żadne zadanie nie pracuje. Poczekaj na zadanie testowe harmonogramu i przejrzyj wynik przed Apply recommendation. Ta akcja zmienia tylko sposób wykonania oraz rozmiary partii produktów i stanów. Wcześniej zapisz albo odrzuć niezapisane zmiany tych pól.

Podczas Foreground sync i Optimized for Slow Hosting pozostaw przeglądarkę otwartą. Pracę w tle wybierz po potwierdzeniu działania harmonogramu na tym hostingu. Benchmark jest krótką próbką warunków serwera; nie przewiduje czasu całego importu ani nie mierzy odpowiedzi Allegro i pobierania zdjęć.

Sprawdź częstotliwość, następne uruchomienie i zakończone zadanie w Pulpicie, Health i Historii. Jeśli brakuje zadań cyklicznych, użyj Restore recurring schedule w Health i sprawdź ich rzeczywiste wykonanie. Sama zaplanowana godzina nie potwierdza działania importu.

Przejdź do codziennej obsługi i rozwiązywania problemów.