Instrukcja obsługi modułu

Astra ERLI dla PrestaShop

Instrukcja konfiguracji i codziennej pracy: od połączenia konta ERLI, przez producentów GPSR, mapowanie kategorii, marek, cech i produktów, po wystawianie ofert, synchronizację cen i stanów, pobieranie zamówień, statusy, wysyłki, etykiety i automatyzację.

Wersja 4.9.6 Produkty i warianty GPSR i dokumenty Ceny, stany i promocje Zamówienia i etykiety

1. Do czego służy Astra ERLI

Astra ERLI łączy sklep PrestaShop z marketplace ERLI i pozwala obsługiwać z panelu sklepu cały podstawowy proces sprzedaży: przygotowanie produktów, mapowania, wystawianie i aktualizowanie ofert, ceny i promocje, stany magazynowe, zamówienia, statusy, wysyłki oraz etykiety.

Oferty

Produkty i warianty PrestaShop mogą być wystawiane jako osobne oferty ERLI, z kategorią, cechami, zdjęciami, dokumentami, producentem i danymi GPSR.

Synchronizacja

Moduł porównuje i wysyła zmienione stany, aktywność, ceny, promocje oraz opisy. Dla istniejących ofert można także ręcznie kontrolować stan i cenę.

Zamówienia

Zamówienia ERLI są pobierane do modułu, mapowane do produktów PrestaShop i importowane do standardowych zamówień sklepu wraz z klientem, adresami i przewoźnikiem.

Najważniejsza zasada konfiguracjiNajpierw skonfiguruj połączenie, słowniki, kategorie i ustawienia ofert. Następnie przetestuj pojedynczy produkt i pojedyncze zamówienie. Automatyczne crony włącz dopiero po sprawdzeniu mapowań i ustawień.

2. Zalecana kolejność pierwszej konfiguracji

Najprościej uruchomić moduł w następującej kolejności:

  1. Połączenia: dodaj konto ERLI, token i wybierz środowisko Produkcyjne albo Sandbox.
  2. Mapowanie kategorii i cech: załaduj lokalny słownik kategorii, zmapuj używane kategorie PrestaShop, a następnie wymagane cechy i wartości.
  3. Mapowanie marek: jeżeli używasz producentów/marek PrestaShop, połącz je z odpowiednimi wartościami ERLI.
  4. Ustawienia wystawiania ofert: ustaw dispatch time, cennik dostawy, dokumenty, kod producenta, producenta GPSR, opcjonalnie podmiot odpowiedzialny, sposób budowania opisu i domyślny status oferty.
  5. Wystaw ofertę: otwórz jeden produkt, sprawdź kategorię, cechy, cenę, stan, zdjęcia, dokumenty i GPSR, a następnie wyślij ofertę testową.
  6. Mapowanie produktów: jeżeli na ERLI istnieją już oferty, zsynchronizuj katalog ERLI i połącz je z produktami lub konkretnymi wariantami PrestaShop.
  7. Ustawienia wysyłek: pobierz typy dostawy ERLI i przypisz do nich przewoźników oraz statusy startowe PrestaShop.
  8. Synchronizacja statusów: skonfiguruj reguły ERLI → PrestaShop i PrestaShop → ERLI.
  9. Cron: wykonaj pierwsze uruchomienie każdego niezależnego adresu z kontrolą bazy, a następnie dodaj crony do harmonogramu serwera.
PołączenieKategorie i cechyUstawienia ofertOferta testowaZamówienie testoweCron

3. Instalacja i aktualizacja

Instalacja

  1. W PrestaShop przejdź do Moduły i wgraj paczkę ZIP Astra ERLI.
  2. Po instalacji otwórz konfigurację modułu. W module dostępna jest własna nawigacja ERLI do poszczególnych sekcji.
  3. Jeżeli dostarczona paczka jest zakodowana ionCube, serwer musi mieć aktywny ionCube Loader zgodny z paczką.
  4. Po pierwszym wejściu moduł przygotowuje wymagane elementy bazy danych. Nie trzeba ręcznie uruchamiać skryptów SQL.

Aktualizacja

Nową wersję wgrywaj na istniejący moduł. Nie odinstalowuj wcześniejszej wersji, jeśli chcesz zachować połączenia, mapowania i ustawienia.

  • wyczyść cache PrestaShop po podmianie plików,
  • wejdź do konfiguracji Astra ERLI, aby moduł wykonał aktualizację własnego schematu,
  • sprawdź aktywne połączenie,
  • wykonaj kontrolne uruchomienie cronów,
  • przetestuj jedną ofertę albo jedno zamówienie przed masową pracą.

4. Połączenia ERLI

Każde konto ERLI jest osobnym połączeniem. Ustawienia mapowań, wysyłek i automatyzacji są wykonywane dla aktywnego połączenia, dlatego przed każdą konfiguracją zwróć uwagę, które konto jest wybrane.

Dodanie połączenia

  1. Wejdź w ERLI → Połączenia.
  2. Dodaj Nazwę połączenia, np. nazwę sklepu albo konta ERLI.
  3. Wprowadź Token API.
  4. W polu Środowisko ERLI wybierz Produkcyjne albo Sandbox. Adres API jest wybierany przez moduł z zamkniętej listy — nie wpisuje się go ręcznie.
  5. Zapisz. Przy poprawnym tokenie moduł pokaże status Połączenie aktywne.
ŚrodowiskoKiedy używać
ProdukcyjneRzeczywiste oferty, zamówienia i wysyłki na koncie sprzedawcy ERLI.
SandboxTesty integracji bez pracy na produkcyjnym koncie.
Wiele połączeńJeżeli moduł obsługuje kilka kont ERLI, zawsze kontroluj aktywne połączenie przed mapowaniem kategorii, produktów, wysyłek, ofert i cronów.

5. Kategorie ERLI, cechy i mapowanie marek

Przed wystawianiem ofert moduł musi wiedzieć, do której kategorii ERLI należy produkt i skąd pobrać wartości wymaganych cech.

5.1. Słownik kategorii

  1. Wejdź w ERLI → Mapowanie kategorii i cech.
  2. Przy pierwszej konfiguracji kliknij Załaduj kategorie z pliku modułu. Moduł zawiera jeden lokalny plik kategorii, dzięki czemu drzewo jest dostępne bez długiego pierwszego pobierania.
  3. W razie potrzeby użyj Start / Wznów z API, aby odświeżyć kategorie z ERLI. Istniejące rekordy są aktualizowane, a nowe dopisywane.
  4. Osobno można odświeżyć Cechy kategorii ERLI oraz Wartości cech ERLI.

Do codziennej pracy najlepiej pozostawić w Cronie włączone odświeżanie globalnego słownika i cech zmapowanych kategorii. Dzięki temu konfigurator oferty korzysta głównie z lokalnej bazy i otwiera się szybciej.

5.2. Mapowanie kategorii PrestaShop → ERLI

  1. Wybierz kategorię PrestaShop. Możesz ją wyszukać po nazwie lub ścieżce.
  2. Wyszukaj kategorię ERLI po nazwie/ścieżce albo kliknij Pokaż wszystkie kategorie i wybierz ją z drzewa.
  3. Kliknij Zapisz mapowanie kategorii.
  4. W tabeli zapisanych mapowań użyj Odśwież cechy, a następnie Mapuj cechy.

5.3. Mapowanie cech

Dla każdej cechy ERLI wybierasz źródło danych w PrestaShop. Dostępne są m.in.:

  • cechy PrestaShop,
  • grupy wariantów/kombinacji,
  • producent / marka produktu,
  • EAN produktu lub wariantu,
  • SKU / reference produktu lub wariantu,
  • nazwa produktu, ID produktu i stan produktu,
  • kod producenta obliczany według ustawień modułu.

Możesz również ustawić wartość domyślną, używaną gdy źródło jest puste, albo stałą wartość, która zawsze ma zostać wysłana. Dla cech słownikowych ERLI mapuj wartości PrestaShop na wartości dostępne w słowniku ERLI — dowolny tekst nie zastępuje wartości słownikowej.

5.4. Mapowanie marek / producentów

W tej samej zakładce znajduje się osobne Mapowanie marek PrestaShop → ERLI. Wybierz producenta z PrestaShop, odpowiednią markę/producenta zwróconą przez ERLI i zapisz aktywne mapowanie.

Marka a producent GPSR to nie to samo ustawienieMapowanie marki służy do wartości katalogowej/cechy produktu. Producent GPSR w ustawieniach wystawiania oferty jest informacją o podmiocie odpowiedzialnym za produkt i jest obsługiwany osobno.

6. Mapowanie produktów i wariantów ERLI ↔ PrestaShop

Mapowanie produktu jest potrzebne przede wszystkim wtedy, gdy oferta już istnieje na ERLI albo gdy zamówienie ERLI ma zostać poprawnie przypisane do konkretnego produktu lub wariantu w PrestaShop.

Automatyczne dopasowanie

W ustawieniach mapowania można włączyć dopasowanie po:

  • EAN13,
  • reference / SKU,
  • nazwie produktu.
  1. Wejdź w ERLI → Mapowanie produktów.
  2. Ustaw metody dopasowania i zapisz.
  3. Kliknij Start synchronizacji produktów ERLI. Moduł pobierze katalog ofert i będzie próbował przypisywać produkty.
  4. Użyj filtrów, aby znaleźć pozycje niezmapowane lub wymagające kontroli.
  5. W razie potrzeby kliknij Mapuj / Edytuj i wyszukaj właściwy produkt PrestaShop po ID, nazwie, EAN albo SKU.

Filtry mapowania

Lista pozwala filtrować po wyszukiwanym tekście, ID produktu PrestaShop, statusie oferty ERLI, stanie mapowania, zakresie stanów ERLI i PS oraz sortować m.in. po stanie i ID produktu.

Warianty

Mapowanie przechowuje także konkretny wariant/kombinację PrestaShop. Jest to ważne przy produktach takich jak perfumy 60 ml / 120 ml, rozmiary czy kolory — każda kombinacja może mieć własny EAN, SKU, stan i osobną ofertę ERLI.

Ręczna synchronizacja stanu z mapowania produktu

Przycisk Synchronizuj stan otwiera okno porównawcze:

  • stan w PrestaShop,
  • stan ERLI zapisany lokalnie,
  • stan ERLI odczytany na żywo z API,
  • indywidualna korekta ilości,
  • indywidualny próg wyłączenia oferty.

Możesz wysłać stan do ERLI albo — świadomie — użyć Pobierz stan z ERLI do Presty, jeżeli chcesz nadpisać stan w sklepie wartością z marketplace.

Uwaga przy „Pobierz stan z ERLI do Presty”Ta akcja zmienia stan magazynowy po stronie sklepu. Używaj jej tylko wtedy, gdy ERLI ma być źródłem stanu dla konkretnej pozycji.

7. Ustawienia wystawiania ofert

7.1. Dispatch time i cennik dostawy

Ustaw domyślny czas przygotowania wysyłki w dniach albo godzinach oraz wybierz cennik dostawy pobrany z ERLI. Ustawienia są używane przy nowych ofertach.

7.2. Dokumenty ERLI

Moduł obsługuje trzy grupy dokumentów/warunków:

Reklamacje / rękojmia

Wysyłane jako obligatoryIdentifier.

Gwarancja

Wysyłane jako voluntaryIdentifier.

Zwroty

Wysyłane jako returnIdentifier.

Listy są pobierane z ERLI. Puste pole oznacza użycie domyślnych warunków ustawionych na koncie ERLI. Jeżeli lista nie jest dostępna, moduł może pokazać ostatnio zapisane wartości. Istnieje także możliwość ręcznego zadeklarowania identyfikatorów; ERLI i tak zweryfikuje je przy wysyłce.

7.3. Kod producenta

Możesz ustalić, z których pól PrestaShop ma być automatycznie pobierany kod producenta i w jakiej kolejności. Dostępne źródła to:

  • Indeks / reference,
  • MPN,
  • UPC,
  • EAN-13 / JAN,
  • ISBN.

Moduł sprawdza zaznaczone źródła według ustawionej kolejności i używa pierwszego niepustego. Automatyczne ustalanie można wyłączyć — wtedy kod uzupełnia się ręcznie w konfiguratorze oferty.

7.4. Producent GPSR

Producent jest wymagany do wystawienia oferty. Możesz wybrać sposób jego ustalania:

  • producent przypisany do konkretnego produktu PrestaShop,
  • jeden stały producent z listy PrestaShop,
  • producent wpisany ręcznie.

Dla producenta można użyć przycisków Szukaj w ERLI, Pokaż listę ERLI albo Dodaj nowego producenta. Po wybraniu istniejącego podmiotu moduł zapamiętuje jego identyfikator ERLI.

Jeżeli tworzysz nowy wpis GPSR, kreator pozwala uzupełnić m.in. pełną nazwę, adres, kraj, kod pocztowy, miasto, e-mail i telefon. W konfiguratorze pojedynczego produktu można też skorygować producenta tylko dla tej wysyłki.

7.5. Osoba / podmiot odpowiedzialny

Podmiot odpowiedzialny jest w module opcjonalny. Możesz pozostawić pole puste, wyszukać istniejący podmiot w ERLI albo utworzyć nowy w kreatorze GPSR. Jeżeli pole zostanie puste, moduł nie dodaje odpowiedzialnego podmiotu do payloadu.

7.6. Opis z cech produktu

Ustaw, czy cechy PrestaShop mają być dopisywane do opisu:

  • zawsze,
  • tylko gdy produkt nie ma opisu,
  • nigdy.

Blok cech może znajdować się nad albo pod opisem. Ta sama reguła jest używana w pojedynczym konfiguratorze, wystawianiu masowym i automatycznej aktualizacji opisów.

7.7. Domyślny status i usunięta oferta

Nowa oferta może domyślnie otrzymać status active albo inactive. Jeżeli wcześniej zapisana oferta została usunięta lub zarchiwizowana w ERLI, moduł domyślnie może utworzyć ją ponownie jako nową. Opcja blokady pozwala zabronić takiego automatycznego odtworzenia.

8. Wystawianie i aktualizowanie ofert

Zakładka Wystaw ofertę pokazuje produkty oraz warianty PrestaShop jako osobne pozycje. Dzięki temu kombinacje z różnymi EAN, SKU, pojemnościami, kolorami czy stanami można wystawiać oddzielnie.

8.1. Filtry listy produktów

Możesz filtrować po:

  • wyszukiwanym tekście,
  • aktywności produktu PrestaShop,
  • statusie oferty ERLI: niewystawione, aktywne, nieaktywne, usunięte/archiwalne,
  • stanie magazynowym,
  • zdjęciach: Wszystkie / Tylko ze zdjęciami / Tylko bez zdjęć.

Filtry są zapisywane dla zalogowanego pracownika i aktywnego połączenia ERLI, dzięki czemu pozostają ustawione po zmianie strony lub ponownym logowaniu.

8.2. Pojedynczy konfigurator

  1. Znajdź produkt lub wariant i otwórz konfigurator.
  2. Sprawdź kategorię ERLI. Możesz wyszukać inną kategorię i zapisać ją jako mapowanie na przyszłość.
  3. Sprawdź cenę brutto i stan wyliczony do ERLI.
  4. Sprawdź producenta GPSR i — jeżeli używasz — osobę/podmiot odpowiedzialny. Możesz wyszukiwać i tworzyć podmioty bez wychodzenia z konfiguratora.
  5. Sprawdź dokumenty: reklamacje/rękojmia, gwarancja i zwroty. Przycisk Odśwież dokumenty pobiera aktualną listę z ERLI.
  6. Sprawdź externalId. Opcja Utwórz od nowa z nowym externalId służy do celowego utworzenia nowej oferty zamiast aktualizacji istniejącej.
  7. Sprawdź zdjęcia, SKU/EAN, cechy produktu i podgląd opisu.
  8. Uzupełnij wszystkie wymagane cechy ERLI. Dla cech słownikowych wybierz wartość istniejącą w ERLI.
  9. Opcjonalnie użyj Podgląd payloadu, a następnie Wyślij ofertę do ERLI.
ZdjęciaProdukt bez zdjęcia jest wyraźnie oznaczony i nie powinien być kierowany do masowego wystawiania. Filtr „Tylko bez zdjęć” pozwala szybko znaleźć produkty wymagające uzupełnienia.

8.3. Masowe wystawianie / aktualizacja

Na liście można zaznaczyć produkty z poprawnym mapowaniem kategorii, uruchomić kontrolę gotowości, a następnie użyć Wystaw / aktualizuj zaznaczone masowo. Produkty z wariantami są liczone i obsługiwane jako osobne pozycje.

Przed wysyłką moduł sprawdza zapisaną ofertę ERLI. Jeżeli oferta istnieje — aktualizuje ją; jeżeli została usunięta, zachowanie zależy od ustawienia dotyczącego ponownego wystawiania.

9. Lista ofert na ERLI

Zakładka Lista ofert na ERLI służy do kontroli już powiązanych ofert i porównywania danych PrestaShop z ostatnim odczytem ERLI.

Dostępne filtry

  • wyszukiwanie jednocześnie po externalId, nazwie, EAN i SKU,
  • osobne pole SKU i EAN,
  • status: aktywne / nieaktywne / archiwalne,
  • stan PrestaShop > 0 lub ≤ 0,
  • kategoria PrestaShop,
  • minimalna różnica ceny ERLI względem ceny docelowej PrestaShop.

Ręczna kontrola stanu

Okno stanu pokazuje stan PS, stan ERLI zapisany lokalnie i stan pobrany live z API. Możesz ustawić indywidualną korektę oraz próg wyłączenia oferty i wysłać wyliczony stan do ERLI.

Ręczna zmiana ceny

Okno ceny pokazuje cenę aktualną z promocją, cenę bazową, ostatnią cenę odczytaną z ERLI oraz cenę wyliczoną według bieżących reguł modułu. Przed wysłaniem możesz wpisać inną cenę ręcznie. Taka zmiana jest jednorazowa — kolejny cron może ponownie policzyć cenę według ustawień automatycznych.

Kolejka eksportu

Na dole znajduje się kolejka operacji z akcją, statusem, liczbą prób i ostatnim błędem. Jest to podstawowe miejsce do kontroli operacji oczekujących albo odrzuconych przez ERLI.

10. Stany magazynowe i aktywność ofert

Synchronizacja stanów działa na zmapowanych produktach i wariantach. Moduł może stosować ustawienia globalne oraz indywidualne ustawienia konkretnej oferty.

Reguła wyliczania stanu

Podstawą jest stan PrestaShop, do którego można dodać globalną korektę stanu. Dla konkretnej oferty można ustawić własną korektę — ma ona pierwszeństwo przed globalną.

UstawienieZnaczenie
Korekta +10Do ERLI moduł pokazuje o 10 sztuk więcej niż stan PrestaShop.
Korekta -5Do ERLI moduł pokazuje o 5 sztuk mniej, ale wynik nie jest wysyłany jako liczba ujemna.
Próg 0Standardowo oferta jest wyłączana, gdy stan PS osiągnie 0.
Próg dodatniOferta może zostać wyłączona wcześniej, np. przy stanie ≤ 2.
Próg -1Wyłącza próg dezaktywacji i pozwala na nadsprzedaż. W połączeniu z dodatnią korektą można utrzymać dodatni stan ERLI mimo stanu 0 w PS.

Automatyczna synchronizacja

W Cronie włącz Automatycznie wysyłaj stany magazynowe do ERLI. Ustaw limit zmian na przebieg. Wspólny cron produktów scala dla tego samego externalId zmienione pola stock, status i price w jednym batch-update, zamiast wykonywać osobne żądania dla każdego pola.

Moduł nie powinien wysyłać aktualizacji, jeżeli wyliczona wartość nie różni się od ostatnio zapisanego stanu docelowego.

11. Ceny, promocje i harmonogram promocji kategorii

11.1. Cena źródłowa

W Cronie można wybrać:

  • cenę aktualną — uwzględnia aktywne promocje PrestaShop,
  • cenę bazową — ignoruje bieżącą promocję i korzysta z ceny regularnej.

11.2. Narzut, marża i zaokrąglenie

Cena jest liczona według kolejności:

Cena źródłowaNarzut / obniżka %Stała kwotaZaokrąglenie

Korektę można stosować do wszystkich produktów, tylko zwykłych albo tylko promocyjnych. Dostępne są m.in. brak zaokrąglenia, pełne złote i końcówka 0,99.

11.3. Promocje PrestaShop

Przy trybie ceny aktualnej moduł wykrywa aktywną cenę specjalną. Jeżeli produkt jest przeceniony, synchronizuje bazową cenę i tworzy odpowiednią promocję ERLI z zakresem czasowym wynikającym z promocji PrestaShop. Po zakończeniu promocji przywracana jest zwykła cena lub kolejna aktywna promocja.

11.4. Promocja kategorii sterowana modułem

Można włączyć harmonogram promocji dla jednej lub wielu aktywnie zmapowanych kategorii PrestaShop → ERLI. Ustaw:

  • kategorie,
  • ujemny procent obniżki, np. -5%,
  • datę i godzinę początku,
  • datę i godzinę końca.

Wspólny cron stanów i cen uruchamia promocję po rozpoczęciu zakresu i kończy ją po jego upływie.

11.5. Batch-update

Rozmiar paczki ERLI można ustawić w zakresie 50–200 ofert na request. Ma to ograniczyć liczbę wywołań API przy dużych katalogach. Osobno ustawiasz limit liczby zmian cen obsługiwanych w jednym cyklu.

12. Pobieranie i import zamówień

Zakładka Zamówienia rozdziela dwie operacje: pobieranie/odświeżanie danych z API oraz filtrowanie zamówień już zapisanych lokalnie.

12.1. Pobierz / odśwież zamówienia z ERLI API

  1. Ustaw Datę od i Datę do.
  2. Wybierz liczbę rekordów na request: 50, 100 albo 200.
  3. Kliknij Pobierz / odśwież z API.

Ponowne pobranie nie służy wyłącznie do szukania nowych zamówień. Moduł aktualizuje również zamówienia zapisane wcześniej, dlatego pokaże późniejszą zmianę statusu, anulowanie lub inne dane zmienione w ERLI.

12.2. Filtry lokalne

Niższy formularz nie odpytuje ERLI. Filtruje to, co już jest zapisane w module:

  • data od / do,
  • status ERLI,
  • już pobrane do PrestaShop / jeszcze niepobrane,
  • kompletne mapowanie / braki mapowania,
  • wyszukiwanie po ID ERLI, ID PS, kliencie, e-mailu, produkcie, EAN, SKU i dostawie.

12.3. Brak mapowania produktu w zamówieniu

Pozycja bez mapowania jest oznaczona. Kliknij ją, aby otworzyć Szybkie mapowanie produktu ERLI. Wyszukiwarka PrestaShop przyjmuje ID, nazwę, EAN lub SKU. Po zapisaniu mapowania zamówienie może zostać zaimportowane.

W niektórych przypadkach dostępna jest akcja Importuj i utwórz produkt z ERLI. Moduł może wtedy utworzyć brakujący produkt na podstawie danych ERLI wraz z opisem, zdjęciami i cechami, a następnie zaimportować zamówienie. Po takim imporcie warto zweryfikować utworzony produkt w PrestaShop.

12.4. Co powstaje w PrestaShop

Podczas importu moduł buduje standardowe dane zamówienia PrestaShop: wyszukuje istniejącego klienta po e-mailu albo tworzy nowego, tworzy adres dostawy i — gdy występuje — dane fakturowe, koszyk, zamówienie, pozycje zamówienia i przewoźnika zgodnie z mapowaniem wysyłki.

Karta zamówienia ERLIDla zamówienia pochodzącego z ERLI zakładka ERLI na stronie zamówienia jest wyróżniona jasnym zielonym tłem i automatycznie otwierana, aby dane integracji były od razu widoczne.

13. Wysyłki, przewoźnicy i etykiety

13.1. Mapowanie typów wysyłki

  1. Wejdź w ERLI → Ustawienia wysyłek.
  2. Kliknij Pobierz dostępne typy z API. Nowe typy mogą być też dopisywane automatycznie, gdy pojawią się w zamówieniach.
  3. Ustaw domyślne wymiary i wagę paczki.
  4. Ustaw opcjonalny Fallback przewoźnika PS i Fallback status startowy PS.
  5. Dla każdego typu ERLI wybierz przewoźnika PrestaShop i opcjonalny status startowy.

Typy, których identyfikator zaczyna się od erli, są automatycznie traktowane jako wysyłki obsługiwane przez generator etykiet ERLI. Nie ma osobnego checkboxa „Generuj etykietę”. Pozostałe typy są traktowane jako zewnętrzne metody / bez generatora ERLI.

13.2. Etykiety

Masowe etykiety generuje się z listy zamówień PrestaShop: zaznacz zamówienia i wybierz akcję zbiorczą Generuj Etykiety ERLI.

  • zamówienia spoza ERLI są pomijane,
  • dla zamówienia bez etykiety moduł zleca jej utworzenie,
  • dla istniejącej etykiety pobiera aktualny plik,
  • przy wielu etykietach może przygotować paczkę ZIP.

W Synchronizacji statusów można dodatkowo ustawić status PrestaShop, który ma zostać nadany bezpośrednio po poprawnym utworzeniu paczki/etykiety.

13.3. Additional information na etykiecie

Zakładka Etykiety pozwala zbudować pole shipping.additionalInformation dla pojedynczego i masowego generowania. Możesz wybrać składniki pozycji zamówienia, ich kolejność, separatory, limit długości, sposób skracania nazwy oraz czyszczenie danych (np. usuwanie polskich znaków, wielkie litery, pomijanie pustych wartości).

14. Synchronizacja statusów i akcji

Moduł obsługuje dwa kierunki: zdarzenia/statusy ERLI mogą zmieniać status zamówienia w PrestaShop, a zmiana statusu PrestaShop może wykonywać akcje po stronie ERLI.

14.1. ERLI → PrestaShop

Dodaj regułę przychodzącą, wybierając status/zdarzenie ERLI i odpowiadający mu status PrestaShop. Przykładowo anulowanie ERLI można skierować na status anulowany w sklepie, a zwroty na przygotowany przez sklep status zwrotu.

Ochrona przed cofaniem ręcznie ustawionego statusuTen sam niezmieniony status ERLI jest stosowany tylko raz. Jeżeli po jego zastosowaniu pracownik ręcznie przesunie zamówienie PrestaShop dalej, kolejne odczyty tego samego statusu ERLI nie cofną zamówienia. Dopiero nowa zmiana statusu po stronie ERLI może uruchomić kolejną regułę.

14.2. PrestaShop → ERLI

Dla wybranego statusu PrestaShop możesz ustawić regułę wyjściową obejmującą:

  • status ERLI,
  • status paczki,
  • wysłanie listu przewozowego / trackingu,
  • opcjonalny e-mail do klienta.

Anulowanie po stronie ERLI wybiera się jako status canceled. Jeżeli status paczki ma pozostać bez zmian, wybierz odpowiednią opcję „nie zmieniaj”.

14.3. Status po utworzeniu listu przewozowego

Możesz wskazać status PrestaShop ustawiany natychmiast po poprawnym utworzeniu paczki w ERLI. Działa zarówno przy pojedynczym, jak i masowym generowaniu etykiet.

15. Cron i automatyzacja

Aktualna wersja używa czterech niezależnych adresów cron. Każdy ma osobną blokadę bazodanową i ograniczony czas pracy. Ceny nie mają już osobnego crona — działają razem ze stanami i aktywnością ofert.

1. Zamówienia

Pobiera i importuje nowe zamówienia ERLI zgodnie z wybranymi statusami, zakresem wstecz, limitem importu i liczbą stron API na cykl.

2. Statusy i kroki

Synchronizacja ERLI → PrestaShop oraz reguły PrestaShop → ERLI: statusy, tracking/list przewozowy, anulowania i wiadomości.

3. Słowniki

Rotacyjnie odświeża typy wysyłki, kategorie, cechy, wartości, dokumenty i dane katalogowe potrzebne modułowi.

4. Stany i ceny

Obsługuje stany, aktywność ofert, ceny i promocje. Dla tego samego externalId scala zmienione pola w jednym batch-update.

Pierwsze uruchomienie

  1. Wejdź w ERLI → Cron.
  2. Dla każdego niezależnego adresu kliknij Pierwsze uruchomienie / kontrola bazy albo użyj adresu z install=1.
  3. Po poprawnym teście dodaj adres do harmonogramu serwera.
  4. Zalecany harmonogram dla każdego adresu to uruchamianie co minutę.
* * * * *

Każdy cron może mieć limit czasu do około 30 sekund. Jeżeli poprzednie wywołanie tego samego crona nadal pracuje, kolejne zostanie zablokowane, natomiast pozostałe typy cronów mogą działać niezależnie.

Adres zgodnościModuł może pokazywać także starszy wspólny adres zgodności dla instalacji, które miały wcześniej zapisany jeden cron. Do nowej konfiguracji używaj czterech niezależnych adresów — dają lepszą kontrolę nad obciążeniem i logami.

Najważniejsze ustawienia crona

  • Zamówienia: automatyczny import, zakres pobierania, limit zamówień na minutę, maksymalna liczba stron API i statusy kwalifikujące do pobierania.
  • Statusy: pobieranie zmian ERLI → PS oraz wykonywanie reguł statusów, trackingów, anulowań i wiadomości.
  • Stany: włączenie synchronizacji, limit zmian, globalna korekta i próg wyłączenia.
  • Ceny: cena źródłowa, narzut procentowy, korekta kwotowa, zakres korekty, zaokrąglenie, limity i promocje kategorii.
  • Opisy: automatyczna aktualizacja istniejących ofert; moduł nie wysyła opisu, jeśli jego zapisany hash się nie zmienił.
  • Słowniki: globalne odświeżanie kategorii/atrybutów/wartości i odświeżanie cech zmapowanych kategorii.

16. Codzienna praca — gotowe scenariusze

Nowy produkt, którego nie ma na ERLI

  1. Uzupełnij produkt lub wariant w PrestaShop: nazwę, SKU/reference, EAN jeżeli jest używany, cenę, stan i zdjęcia.
  2. Upewnij się, że jego kategoria PrestaShop jest zmapowana do ERLI.
  3. Sprawdź mapowanie wymaganych cech.
  4. Wejdź w Wystaw ofertę, otwórz konfigurator i sprawdź GPSR, dokumenty, cenę, stan i cechy.
  5. Wyślij jedną ofertę. Jeżeli wszystko jest poprawne, kolejne produkty z tej samej kategorii możesz wystawiać masowo.

Oferta już istnieje na ERLI

  1. Uruchom synchronizację katalogu w Mapowaniu produktów.
  2. Przefiltruj pozycje niezmapowane.
  3. Połącz ofertę ERLI z właściwym produktem lub wariantem PS.
  4. Sprawdź stan w oknie synchronizacji oraz cenę na Liście ofert.
  5. Dopiero potem włącz automatyczną synchronizację stanów i cen.

Nowe zamówienie ERLI

  1. Automatyczny cron zamówień pobierze pozycję albo pobierz ją ręcznie z zakresem dat.
  2. Jeżeli produkt jest zmapowany, użyj Importuj lub pozostaw import automatyczny.
  3. Jeżeli brakuje mapowania, kliknij pozycję produktu i wykonaj szybkie mapowanie.
  4. Po imporcie pracuj na standardowym zamówieniu PrestaShop; zakładka ERLI jest wyróżniona i otwiera się automatycznie.
  5. Po przygotowaniu wysyłki generuj etykietę ERLI, a dalsze statusy obsłużą skonfigurowane reguły.

Kontrola większego katalogu

  • używaj filtrów „niewystawione”, „bez zdjęć”, „niezmapowane” i zakresów stanów,
  • najpierw testuj limit synchronizacji 1 dla stanów lub cen,
  • po weryfikacji zwiększaj limity cyklu,
  • kontroluj kolejkę eksportu i logi tylko wtedy, gdy rzeczywiście diagnozujesz problem,
  • przy masowych działaniach pracuj kategoriami, a nie całym katalogiem naraz.

17. Najczęstsze sytuacje i co sprawdzić

SytuacjaCo sprawdzić
Brak połączenia z ERLIToken, wybrane środowisko Produkcyjne/Sandbox i aktywne połączenie.
Nie można wystawić ofertyMapowanie kategorii, wymagane cechy, wartości słownikowe, producent GPSR, kod producenta, dokumenty, cenę i zdjęcia.
Marka z PrestaShop nie pasuje do ERLIMapowanie marek PrestaShop → ERLI oraz wartość cechy Marka w danej kategorii.
Wariant ma zły EAN/SKU lub stanCzy mapowanie wskazuje konkretny wariant/kombinację, a nie tylko produkt główny.
Stan ERLI różni się od PSMapowanie produktu, indywidualny/globalny offset, próg wyłączenia i stan live z API w oknie synchronizacji.
Cena ERLI różni się od oczekiwanejTryb cena aktualna/bazowa, narzut, kwotę stałą, zakres korekty, zaokrąglenie i aktywne promocje PrestaShop.
Zamówienie nie może być zaimportowaneStatus kwalifikujący do importu, mapowanie wszystkich pozycji, przewoźnika i dane adresowe.
Zamówienie po anulowaniu nadal wygląda na stareUżyj „Pobierz / odśwież z API” dla zakresu obejmującego zamówienie albo sprawdź automat statusów.
Brak etykietyCzy typ wysyłki ma identyfikator zaczynający się od erli, dane paczki i poprawne mapowanie przewoźnika.
Status PS został ręcznie przesunięty dalejModuł nie powinien cofać go ponownie na podstawie niezmienionego statusu ERLI. Sprawdź regułę dopiero, gdy ERLI faktycznie zmieni status.
Cron nie wykonuje zadaniaCzy dany cron nie jest zablokowany w module, czy URL/token są aktualne, czy pierwsza kontrola z install=1 przeszła poprawnie i czy harmonogram serwera uruchamia właściwy niezależny adres.
Przed zgłoszeniem problemuZapisz nazwę aktywnego połączenia, ID produktu/oferty albo ID zamówienia, wykonaj problematyczną operację na jednej pozycji i sprawdź komunikat w panelu lub kolejce eksportu. To zwykle pozwala od razu wskazać brakujące mapowanie albo ustawienie.

Instrukcja użytkowa Astra ERLI 4.9.6

Dokument opisuje bieżącą konfigurację i sposób pracy z modułem, bez historii zmian technicznych.

Wróć na początek