Reguły integracji

Każda integracja część pracy wykonuje sama, w tle: pobiera zamówienia, sprawdza statusy paczek albo zamawia podjazd kuriera. Complaia zakłada tę pracę za Ciebie jako jedną regułę systemową na integrację, a ustawiasz ją na karcie integracji. Możesz też dodać własne reguły, na przykład „gdy zamówienie dostanie status Gotowe, utwórz przesyłkę DHL”. Ta strona objaśnia jedno i drugie.

Gdzie to znaleźć: Integracje → Integracje → Reguły integracji. Żeby dodać regułę: Integracje → Integracje → Nowa reguła integracji

Kiedy z tego korzystasz

• Zamówienia mają przychodzić częściej albo rzadziej niż teraz.
• Chcesz wyłączyć automatyczne pobieranie i pobierać zamówienia tylko ręcznie.
• Codzienny podjazd kuriera ma być zamawiany o innej godzinie.
• Przesyłka kurierska ma powstawać sama, gdy zamówienie osiągnie określony status.
• Status zamówienia ma trafiać do sklepu dopiero w wybranym momencie, na przykład gdy przesyłka dostanie numer śledzenia.
• Reguła pokazuje Błąd i chcesz wiedzieć, co robi i czy się uruchomiła.

Najważniejsze pojęcia

• Reguła systemowa — jedna reguła na integrację, obejmująca całą jej pracę w tle. Complaia zakłada ją przy podłączeniu integracji. Nie da się jej usunąć ani edytować jak zwykłej reguły. To, co robi, zmieniasz ustawieniami na karcie integracji.
• Własna reguła — reguła, którą tworzysz samodzielnie. Reaguje na coś, co dzieje się z zamówieniem albo pudłem, i jest zbudowana jak zdanie: Gdy coś się stanie, Zrób akcję, Tylko gdy spełnione są warunki, Potem ustaw status zamówienia.
• Reguła należy do jednej integracji. Dostępne akcje zależą od tej integracji. Zobacz Akcje według konektora.
• Zamówienia z samej integracji — reguła sklepu, marketplace’u albo integratora działa tylko dla zamówień, które przyszły z tej integracji. Reguła kuriera albo drukarki działa dla zamówień z dowolnego źródła i możesz ją ograniczyć do wybranych źródeł zamówień.
• Wstrzymana integracja nie uruchamia reguł. Ani reguła systemowa, ani własne reguły nie działają, dopóki jej nie wznowisz.
• Reguły nie wysyłają numerów śledzenia. Robi to przełącznik Automatyczne wysyłanie numerów śledzenia na karcie integracji. Zobacz Mapowania → Odsyłanie numerów śledzenia.

Reguły zakładane za Ciebie

Reguła systemowa składa się z tych zadań w tle:

Zadanie	Integracje	Kiedy działa	Gdzie to ustawiasz
Pobieranie nowych zamówień	Allegro, Apilo, Base, WooCommerce, Shoper, PrestaShop	Co 15, 30 albo 60 minut	Sekcja Synchronizacja zamówień na karcie integracji
Zmiany w pobranych zamówieniach — zmiany statusu i płatności w zamówieniach już pobranych	Te same	Z tym samym interwałem, ale tylko wtedy, gdy status albo płatność ustala drugi system	Ustawienia statusu i płatności. Zobacz Mapowania
Odświeżanie dostępu	Allegro, Apilo	Raz dziennie, w nocy	Nic do ustawienia
Sprawdzanie statusów przesyłek	InPost, DHL, DPD, FedEx	Raz dziennie, o wybranej godzinie	Sekcja Praca w tle na karcie integracji
Zamawianie podjazdu kuriera	InPost, DHL, DPD, FedEx	Raz dziennie, o 15:00, jeśli nie wybierzesz innej godziny	Sekcja Praca w tle, razem z ustawieniem podjazdu w formularzu Dane połączenia

Zadanie podjazdu zamawia kuriera tylko wtedy, gdy w integracji wybrano automatyczne zamawianie podjazdu. Przy DPD ze stałym podjazdem przygotowuje zamiast tego protokół przekazania dla kuriera.

Godziny są podawane w strefie czasowej Polski. W zadaniach codziennych wybierasz godzinę, a minutę wybiera Complaia.

Na liście reguł i na karcie integracji wszystkie te zadania widać jako jeden kafelek o nazwie Reguła systemowa. Kliknij go, żeby zobaczyć, co robi. Żeby zatrzymać to wszystko, wstrzymaj integrację.

Ekrany

Reguły integracji to lista wszystkich reguł pogrupowanych według integracji.

• Na górze cztery liczniki: Aktywne, Nieaktywne, Zdarzenia i Harmonogramy. Reguła systemowa liczy się jako harmonogram.
• Filtry: Wszystkie, Aktywne, Nieaktywne i lista, która pokazuje tylko jedną integrację.
• Każdy kafelek reguły pokazuje:
  • nazwę reguły i jej rodzaj: założona przez integrację (reguła systemowa) albo Reguła zdarzeniowa;
  • plakietkę Aktywna albo Nieaktywna;
  • jednowierszowe podsumowanie, na przykład Zamówienie → Zmiana statusu → Utwórz przesyłkę. W regule systemowej podsumowanie wymienia włączone zadania;
  • komunikat z ostatniego uruchomienia, jeśli jest;
  • wynik ostatniego uruchomienia (OK, Pominięto albo Błąd) i jego godzinę albo Brak wykonania.
• Kliknij kafelek, żeby otworzyć regułę. Ikona kosza ją usuwa. W regule systemowej kosz jest wyłączony.
• Przycisk Nowa reguła na górze otwiera formularz reguły. Jeśli nie masz jeszcze żadnej integracji, przycisk jest wyłączony, a lista mówi Najpierw dodaj integrację.

Strona reguły systemowej ma dwie części:

• Co robi ta reguła — praca w tle w obecnym ustawieniu, z plakietką przy każdym zadaniu, na przykład Co 30 min, Codziennie, Wyłączone albo Wstrzymane.
• Zadania w tle — każde zadanie z harmonogramem oraz wynikiem i godziną ostatniego uruchomienia.

Przycisk Przejdź do karty integracji na górze prowadzi tam, gdzie zmieniasz te ustawienia.

Formularz reguły (Nowa reguła integracji i ekran edycji) ma takie kroki:

1. Integracja — do której integracji należy reguła. Po zapisaniu reguły nie da się tego zmienić.
2. Gdy — zdarzenie, które uruchamia regułę.
3. Zrób — akcja.
4. Tylko gdy — opcjonalne warunki: nowy status, poprzedni status, źródło zamówienia.
5. Potem — opcjonalny status zamówienia ustawiany po akcji.

Po prawej kafelek Reguła pokazuje całą regułę jako jedno zdanie. Pod nim są pole Nazwa reguły i przełącznik Reguła aktywna.

📷 Zrzut ekranu do dodania: formularz reguły z wypełnionymi wszystkimi krokami i zdaniem reguły po prawej

Typowe zadania

Zmiana częstotliwości pobierania zamówień

1. Otwórz integrację z ekranu Lista integracji.
2. W sekcji Synchronizacja zamówień otwórz listę Interwał pobierania.
3. Wybierz Co 15 minut, Co 30 minut albo Co 60 minut i potwierdź.

Następne pobranie nastąpi po nowym interwale. Zmiany w pobranych zamówieniach dostają ten sam interwał.

Jeśli sekcja mówi Synchronizacja nie jest skonfigurowana, kliknij Włącz synchronizację i potwierdź. Complaia znowu założy pobieranie zamówień, z interwałem 30 minut.

Żeby wstrzymać tylko pobieranie nowych zamówień, wyłącz w tej samej sekcji Pobieranie nowych zamówień i potwierdź. Okno wymienia, co działa dalej, na przykład wysyłanie numerów śledzenia i pobieranie przyciskiem Synchronizacja zamówień. Po ponownym włączeniu pierwsze pobranie zbierze też zamówienia złożone w czasie przerwy, bez uruchamiania dla nich reguł.

Wyłączanie automatycznego pobierania zamówień

Przydaje się, gdy chcesz dostawać zamówienia tylko wtedy, kiedy o nie poprosisz.

1. Otwórz integrację.
2. W sekcji Synchronizacja zamówień wybierz na liście Interwał pobierania pozycję Nie pobieraj automatycznie.
3. Potwierdź przyciskiem Nie pobieraj automatycznie.

Od tej chwili nowe zamówienia i zmiany w pobranych zamówieniach przychodzą tylko po kliknięciu Synchronizacja zamówień. Kafelek integracji na liście pokazuje czerwoną ikonę ostrzeżenia.

Żeby wrócić, wybierz interwał na tej samej liście i potwierdź przyciskiem Pobieraj automatycznie. Pierwsze pobranie zbierze wtedy zamówienia złożone w międzyczasie, których nikt nie pobrał ręcznie, bez uruchamiania dla nich reguł.

Zmiana godziny codziennego zadania kuriera

1. Otwórz integrację kurierską.
2. W sekcji Praca w tle otwórz listę obok Sprawdzanie statusów przesyłek albo Zamawianie podjazdu kuriera.
3. Wybierz godzinę i potwierdź przyciskiem Zmień godzinę.

Minuty zostają takie, jakie ustawiła Complaia. Na przykład zadanie o 13:27 przesunie się na 15:27.

Podgląd reguły systemowej

1. Otwórz Reguły integracji albo kartę integracji.
2. Kliknij kafelek Reguła systemowa.

Strona wymienia każde zadanie z harmonogramem i ostatnim uruchomieniem. Jeśli zadanie pokazuje Błąd, otwórz integrację: przyczyna jest w sekcji Ostatnia synchronizacja.

Tworzenie reguły zdarzeniowej

Przykład: gdy zamówienie ze sklepu dostanie status Wysłane, wyślij ten status do sklepu.

1. Otwórz Nowa reguła integracji albo kliknij Nowa reguła w sekcji Powiązane reguły na karcie integracji.

2. W kroku Integracja wybierz integrację. Wiersz pod nią mówi, których zamówień będzie dotyczyć reguła.

3. W kroku Gdy wybierz zdarzenie:

   • Pojawi się nowe zamówienie — zamówienie zostanie utworzone ręcznie albo pobrane z integracji;
   • Zamówienie zmieni status — dowolna zmiana statusu, ręczna albo wykonana przez Complaia;
   • Przesyłka zamówienia dostanie numer;
   • Pudło zostanie zamknięte w magazynie — tylko do drukowania etykiet pudeł.

   W sklepie, marketplace’ie albo integratorze zdarzenia podają nazwę integracji, na przykład „Pojawi się nowe zamówienie z” i nazwa integracji.

4. W kroku Zrób wybierz akcję. Proponowane są tylko akcje pasujące do zdarzenia.

5. W kroku Tylko gdy zawęź regułę, jeśli trzeba. Puste pole oznacza dowolną wartość:

   • Nowy status i Poprzedni status — przy zdarzeniu zmiany statusu;
   • Źródło zamówienia — w regułach kuriera i drukarki.

6. W kroku Potem możesz wybrać Ustaw status zamówienia. Gdy akcja się uda, zamówienie przejdzie do tego statusu. Zamówienie zrealizowane albo anulowane oraz zamówienie, któremu ktoś ustawił status ręcznie, nie zostaje przestawione.

7. Sprawdź zdanie po prawej. Na jego podstawie Complaia wypełnia pole Nazwa reguły. Możesz tę nazwę zmienić. Dwie reguły jednej integracji nie mogą mieć tej samej nazwy.

8. Zostaw włączony przełącznik Reguła aktywna i kliknij Utwórz regułę.

Zmieniona reguła działa od następnego zdarzenia.

Wysyłanie statusu do drugiego systemu

Statusy zamówień można wysyłać z Complaia do sklepu, marketplace’u albo integratora na dwa sposoby.

Każda zmiana, automatycznie — w polu Status zamówienia ustala wybierz opcję z nazwą Complaia. Każda zmiana statusu zamówienia z tej integracji jest wtedy wysyłana zgodnie z mapowaniem statusów. Reguła nie jest potrzebna. Zobacz Mapowania → Kto ustala status i płatność zamówienia.

Tylko w wybranym momencie — użyj reguły. To działa, gdy status ustala każdy system osobno albo drugi system.

1. Sprawdź, czy Mapowanie statusów integracji zawiera statusy Complaia, które chcesz wysyłać.
2. Utwórz regułę zdarzeniową dla tej integracji. Wybierz zdarzenie, na przykład Przesyłka zamówienia dostanie numer.
3. W kroku Zrób wybierz Wyślij status do …. Reguła wysyła status, który zamówienie ma w tym momencie, przetłumaczony przez mapowanie statusów. Na liście reguł i w ustawieniach integracji ta akcja nazywa się Aktualizuj status zamówienia.
4. Kliknij Utwórz regułę.

Możesz też użyć Potem → Ustaw status zamówienia razem z Wyślij ten status także do …. Zamówienie dostaje wtedy nowy status w Complaia, a odpowiadający mu status trafia do drugiego systemu.

Reguły z akcją Wyślij status do … nic nie wysyłają, dopóki status ustala Complaia, bo każda zmiana i tak trafia do drugiego systemu sama. Mówią o tym formularz reguły i ostatnie uruchomienie reguły.

Automatyczne tworzenie przesyłek kurierskich

Reguła zdarzeniowa w integracji InPost, DHL, DPD albo FedEx z akcją Utwórz przesyłkę … tworzy dla zamówienia zlecenie logistyczne i nadaje je u kuriera.

1. Utwórz regułę zdarzeniową dla integracji kurierskiej. Zobacz Tworzenie reguły zdarzeniowej.
2. Wybierz zdarzenie:
   • Pojawi się nowe zamówienie — przesyłka powstaje w chwili, gdy przychodzi zamówienie. Użyj warunku Źródło zamówienia, żeby ograniczyć regułę do zamówień, które mają jechać z tym kurierem.
   • Zamówienie zmieni status z warunkiem Nowy status — przesyłka powstaje, gdy zamówienie osiągnie ten status.
3. W kroku Zrób wybierz Utwórz przesyłkę … i kliknij Utwórz regułę.

Zanim włączysz regułę, zwróć uwagę na to, co robi:

• Korzysta z ustawień integracji: Domyślna usługa i domyślny rozmiar paczki. Reguła nie ma własnych ustawień.
• Nadana przesyłka to prawdziwa, płatna etykieta. Najpierw wypróbuj regułę na integracji w trybie testowym.
• Gdy pobierasz starsze zamówienia przyciskiem Synchronizacja zamówień, zostaw zaznaczone Nie uruchamiaj reguł dla tych zamówień. Inaczej reguła utworzy etykiety także dla tych zamówień.

Jeśli kurier odmówi, reguła pokazuje Błąd, a przyczyna trafia do historii zamówienia w Dzienniku zdarzeń. Popraw problem w zleceniu logistycznym. Zobacz Zlecenia logistyczne.

W InPost, DHL i FedEx jest też akcja Anuluj przesyłkę … przy zdarzeniu zmiany statusu. Użyj jej na przykład do anulowania etykiety, gdy zamówienie dostanie status Anulowane.

Wyłączanie i usuwanie reguły

Żeby wyłączyć regułę:

1. Otwórz Reguły integracji i kliknij regułę.
2. Wyłącz przełącznik Reguła aktywna.
3. Kliknij Zapisz zmiany. Przywróć cofa do ostatnio zapisanego stanu.

Wyłączona reguła zostaje zapisana, ale się nie uruchamia.

Żeby ją usunąć:

1. Na liście Reguły integracji kliknij ikonę kosza na kafelku reguły.
2. Potwierdź przyciskiem Usuń regułę. Tego nie da się cofnąć.

Reguły systemowej nie da się ani wyłączyć, ani usunąć. Zmień jej zadania na karcie integracji albo wstrzymaj integrację.

Sprawdzanie, czy reguła się uruchomiła

1. Otwórz Reguły integracji.
2. Znajdź kafelek reguły. Pokazuje godzinę ostatniego uruchomienia i jego wynik: OK, Pominięto (uruchomienie pominięto, na przykład dlatego, że integracja była wstrzymana) albo Błąd. Na kafelku widać też komunikat z ostatniego uruchomienia.

Więcej szczegółów:

• Reguła systemowa — otwórz integrację i przeczytaj sekcję Ostatnia synchronizacja.
• Własna reguła — kafelek pokazuje tylko ostatnie uruchomienie. Gdy reguła nie zadziała dla jakiegoś zamówienia, w Dzienniku zdarzeń pojawia się wpis dla tego zamówienia z nazwą reguły i przyczyną. Szukaj tam po numerze zamówienia.

Stare reguły harmonogramu i reguły numerów śledzenia

Nie można już tworzyć reguł harmonogramu ani reguł wysyłających numery śledzenia. Pracę w tle ustawiasz na karcie integracji, a numery śledzenia wysyła przełącznik Automatyczne wysyłanie numerów śledzenia.

Jeśli otworzysz starą regułę tego rodzaju, formularz wyjaśni, dlaczego nie da się jej zmienić. Zamiast tego:

• Stara reguła harmonogramu — sprawdź, czy karta integracji ma potrzebne ustawienie, a potem usuń starą regułę na liście reguł.
• Stara reguła numerów śledzenia — włącz Automatyczne wysyłanie numerów śledzenia na karcie integracji, a potem usuń starą regułę.

Akcje według konektora

Konektor	Zdarzenia (Gdy)	Akcje (Zrób)
Apilo, Base, WooCommerce, Shoper, PrestaShop	Pojawi się nowe zamówienie · Zamówienie zmieni status · Przesyłka zamówienia dostanie numer	Wysłanie statusu do sklepu albo integratora
Allegro	—	Brak akcji w regułach. Allegro robi wszystko przez swoje ustawienia na karcie integracji
InPost, DHL, FedEx	Pojawi się nowe zamówienie · Zamówienie zmieni status	Utworzenie przesyłki (oba zdarzenia) · Anulowanie przesyłki (tylko zmiana statusu)
DPD	Pojawi się nowe zamówienie · Zamówienie zmieni status	Utworzenie przesyłki
PrintNode (tylko istniejące integracje)	Pojawi się nowe zamówienie · Zamówienie zmieni status · Pudło zostanie zamknięte w magazynie	Wydrukuj etykietę zamówienia · Wydrukuj etykietę pudła (tylko zamknięcie pudła)

W regule drukowania formularz pyta też o pola Drukarka, Liczba kopii, Prefiks tytułu wydruku i Szablon etykiety / PDF.

Gdy coś nie działa

Co widzisz	Dlaczego	Co zrobić
Formularz reguły mówi, że integracja nie ma akcji, które ustawia się w regule	Pracę tej integracji ustawia się tylko na jej karcie (na przykład Allegro).	Użyj ustawień na karcie integracji.
Reguła o tej nazwie już istnieje w tej integracji. Użyj innej nazwy.	Dwie reguły jednej integracji nie mogą mieć tej samej nazwy.	Zmień nazwę.
Ta akcja nie pasuje do wybranego zdarzenia.	Zdarzenie i akcja do siebie nie pasują.	Wybierz zdarzenie i akcję jeszcze raz z list.
Tę regułę założyła integracja, więc nie da się jej usunąć.	Wskazano kosz przy regule systemowej.	Zmień jej zadania na karcie integracji albo wstrzymaj integrację.
Reguła Wyślij status do … pokazuje Błąd z komunikatem Status zamówienia nie ma odpowiednika w mapowaniu statusów tej integracji	Status zamówienia nie ma pary w mapowaniu statusów.	Dodaj parę. Zobacz Mapowania → Mapowanie statusów zamówień.
Reguła Wyślij status do … niczego nie wysyła	W tej integracji status ustala Complaia, więc każda zmiana trafia do drugiego systemu sama.	Nie ma czego poprawiać. Jeśli chcesz wysyłać tylko w wybranych momentach, zmień ustawienie Status zamówienia ustala.
Ekran edycji mówi Reguła wstrzymana	Status użyty w warunku reguły został usunięty.	Wybierz w warunku inny status i włącz regułę.
Ekran edycji mówi, że reguły nie da się zmienić w formularzu	To stara reguła harmonogramu albo numerów śledzenia.	Zobacz Stare reguły harmonogramu i reguły numerów śledzenia.
Reguła długo pokazuje Brak wykonania	Integracja jest wstrzymana albo niepołączona, reguła jest nieaktywna albo zdarzenie nie wystąpiło przy Twoich warunkach.	Sprawdź stan integracji, plakietkę Aktywna reguły i jej warunki.
Przycisk Nowa reguła na karcie integracji jest wyszarzony	Integracja jest wstrzymana.	Najpierw ją wznów.
Pobieranie zamówień tej integracji jest ustawione na „Nie pobieraj automatycznie”	Pobierania nie da się włączyć, dopóki wybrane jest pobieranie ręczne.	Wybierz interwał w sekcji Synchronizacja zamówień.

Uprawnienia

Aby…	Potrzebujesz
Widzieć listę reguł i regułę systemową	Integracje: Podgląd
Tworzyć, edytować, wyłączać i usuwać reguły; zmieniać interwał pobierania i godziny zadań codziennych	Integracje: Zarządzanie

Bez uprawnienia Integracje: Zarządzanie pozycja menu Nowa reguła integracji, przyciski Nowa reguła i ikony kosza są ukryte, a kafelek reguły się nie otwiera, z wyjątkiem reguły systemowej.

Zobacz też

• Integracje — wstrzymywanie integracji i ręczne pobieranie
• Konektory — co potrafi każdy system
• Mapowania — kto ustala status i płatność oraz mapowanie statusów
• Statusy zamówień — statusy, na które reguły reagują i które ustawiają
• Zlecenia logistyczne — przesyłki kurierskie, etykiety i podjazdy
• Dziennik zdarzeń — tu reguła zostawia swój wynik dla zamówienia