Integracje

Integracja to stałe połączenie Complaia z zewnętrznym systemem: marketplace’em, sklepem internetowym, integratorem wielokanałowym albo kurierem. Gdy integracja jest połączona, zamówienia przychodzą same, statusy i płatności mogą przechodzić między oboma systemami, a etykiety kurierskie powstają ze zleceń logistycznych bez ponownego wpisywania adresu.

Gdzie to znaleźć: Integracje → Integracje → Lista integracji

Kiedy z tego korzystasz

• Sprzedajesz na Allegro, we własnym sklepie albo przez integrator wielokanałowy i chcesz, żeby zamówienia same trafiały do Complaia.
• Wysyłasz przez InPost, DHL, DPD albo FedEx i chcesz tworzyć etykiety, zamawiać podjazd kuriera i śledzić paczki prosto ze zlecenia logistycznego.
• Integracja pokazuje Błąd i musisz ustalić dlaczego.
• Potrzebujesz zamówień z konkretnego dnia, które nie zostały pobrane.
• Chcesz na jakiś czas zatrzymać połączenie albo je usunąć.

Co można podłączyć

Katalog pod przyciskiem Nowa integracja oferuje dziesięć systemów:

Rodzaj	Systemy	Co robią
Marketplace’y i integratory	Allegro, Apilo, Base (BaseLinker)	Pobierają zamówienia, wymieniają statusy i płatności zamówień oraz odsyłają numery śledzenia. Apilo i Base mogą też na żądanie pobrać produkty
Sklepy internetowe	WooCommerce, Shoper, PrestaShop	Pobierają zamówienia, wymieniają statusy i płatności zamówień oraz na żądanie pobierają produkty
Kurierzy	InPost, DHL, DPD, FedEx	Tworzą przesyłki i etykiety, śledzą statusy paczek i zamawiają podjazd kuriera

Na stronie Konektory znajdziesz opis każdego systemu: czego od Ciebie potrzebuje i co potrafi.

Żadna integracja nie robi tego:

• nie wysyła stanów magazynowych do sklepu ani ich ze sklepu nie pobiera;
• nie publikuje produktów i nie zmienia ofert w sklepie ani na marketplace’ie;
• nie importuje zdjęć produktów;
• nie zmienia pozycji ani adresów zamówienia, które zostało już pobrane.

Najważniejsze pojęcia

• Integracja — jedno podłączone konto. Ten sam system możesz podłączyć kilka razy, na przykład dwa sklepy albo dwa konta kurierskie. Każde połączenie ma własną nazwę, ustawienia, mapowania i reguły. Nazwę wybierasz przy łączeniu i nie da się jej później zmienić.
• Tryb testowy — niektóre systemy mają środowisko do ćwiczeń. Zamówienia i przesyłki są w nim nieprawdziwe i nic nie jest pobierane z konta. Tryb testowy wybierasz tylko przy tworzeniu integracji. Integracja w trybie testowym ma na liście plakietkę Tryb testowy, a na górze jej karty widać ostrzeżenie.
• Wstrzymana — integracja wyłączona bez usuwania. Nic nie jest pobierane ani wysyłane, a jej reguły czekają. Ustawienia, mapowania i reguły zostają.
• Reguła systemowa — jedyna reguła, którą Complaia tworzy dla każdej integracji. Obejmuje całą pracę w tle, na przykład pobieranie zamówień co 30 minut albo codzienne sprawdzanie statusów paczek. Tę pracę ustawiasz na karcie integracji. Zobacz Reguły integracji.
• Reguła — Twoje własne polecenie dla jednej integracji: „gdy z zamówieniem stanie się to, zrób tamto”. Zobacz Reguły integracji.
• Mapowanie — tabela, która łączy nazwy z drugiego systemu z Twoimi: statusy zamówień, typy płatności, platformy sprzedażowe, sposoby dostawy i kurierów. Zobacz Mapowania.
• Kto ustala status i płatność — przy marketplace’ach, integratorach i sklepach decydujesz, która strona prowadzi. Complaia może na przykład wysyłać do sklepu każdą zmianę statusu albo sklep może przysyłać swoje zmiany do Complaia. Zobacz Mapowania → Kto ustala status i płatność zamówienia.
• Własne źródło zamówień integracji — każda integracja, która pobiera zamówienia, dostaje źródło zamówień nazwane tak jak ona. Zamówienia z Allegro zawsze trafiają do źródła o nazwie Allegro. Dopóki integracja istnieje, tego źródła nie można usunąć, wyłączyć ani przemianować.

Lista integracji

Lista pokazuje po jednym kafelku na każde połączenie. Kafelki są pogrupowane w sekcje Logistyka, Marketplace i Inne.

Na kafelku	Znaczenie
Logo, nazwa i krótki opis	Nazwa to ta, którą nadano integracji. W wierszu pod nią widać podłączone konto albo to, co robi system
Czerwona ikona ostrzeżenia obok nazwy	Zamówienia nie pobierają się automatycznie. Przychodzą tylko wtedy, gdy ktoś pobierze je ręcznie. Zobacz Reguły integracji → Wyłączanie automatycznego pobierania zamówień
Kolorowa kropka ze stanem	Połączona: działa. Oczekuje: utworzona, ale jeszcze niepołączona. Błąd: ostatnia próba połączenia się nie udała. Wstrzymana: wyłączona
Plakietka Tryb testowy	Integracja działa w środowisku testowym drugiego systemu
Synchronizacja	Kiedy integracja ostatnio cokolwiek zrobiła
Reguły	Ile reguł ma integracja. Reguła systemowa liczy się jako jedna
Czerwony wiersz zamiast Synchronizacja i Reguły	Ostatnie uruchomienie jednego z zadań się nie udało. Wiersz podaje zadanie i przyczynę

Kliknij kafelek, żeby otworzyć integrację.

Na górze ekranu są przyciski Odśwież, Reguły (otwiera Reguły integracji), Poproś o integrację i Nowa integracja. W wąskim oknie znajdziesz je w menu ⋯.

📷 Zrzut ekranu do dodania: Lista integracji z kafelkami w grupach Logistyka i Marketplace: jeden w stanie Połączona, jeden z błędem i jeden wstrzymany

Karta integracji

Karta ma szeroką lewą kolumnę z pracą integracji i wąską prawą kolumnę z samym połączeniem. To, które sekcje widzisz, zależy od systemu.

Lewa kolumna, od góry:

• Ostrzeżenie o trybie testowym — gdy integracja korzysta ze środowiska testowego.
• Pasek stanu — jedno zdanie o połączeniu, na przykład Wszystko działa, ostatnia synchronizacja 5 minut temu, Wystąpił problem z połączeniem razem z ostatnim błędem albo Integracja jest wstrzymana z przyciskiem Wznów integrację.
• Połącz konto Allegro albo Połącz sklep WooCommerce — widać tylko wtedy, gdy taką integrację trzeba jeszcze połączyć. Zobacz Konektory.
• Ostatnia synchronizacja — ostatnie uruchomienie każdego zadania, na przykład pobierania zamówień albo wysyłania numerów śledzenia. Każdy wiersz pokazuje, kiedy zadanie działało, co je uruchomiło, liczby (nowe, zaktualizowane, błędy), przyczynę niepowodzenia i termin następnego uruchomienia.
• Synchronizacja zamówień — w systemach, które pobierają zamówienia. Tu ustawiasz, jak często zamówienia są pobierane i czy pobieranie jest włączone. Zobacz Reguły integracji.
• Praca w tle — u kurierów. Godzina codziennego sprawdzania statusów paczek i codziennego podjazdu kuriera. Zobacz Reguły integracji.
• Statusy zamówień i Płatności zamówień — kto je ustala i jak dopasowane są statusy i typy płatności.
• Mapowanie źródeł zamówień — dla Apilo i Base.
• Sposób dostawy z platformy — jak sposoby dostawy z drugiego systemu odpowiadają Twoim przewoźnikom.
• Numery śledzenia — przełącznik wysyłania numerów śledzenia i mapowanie kurierów. Dla Allegro, Apilo i Base.
• Powiązane reguły — reguła systemowa i Twoje własne reguły, z przyciskiem Nowa reguła.
• Jak działa ta integracja — krótki przewodnik. Mówi, co integracja robi sama, co dzieje się dopiero po kliknięciu, i odpowiada na częste pytania.

Prawa kolumna:

• Karta połączenia — nazwa systemu i plakietka stanu (Połączona, Rozłączona albo Błąd). Pod nią: podłączone konto Allegro, Aktywna, konto zewnętrzne, Twoja notatka, data dodania i ostatni błąd. Na dole są przyciski Test połączenia, Wstrzymaj (albo Włącz) i ikona kosza do usuwania.
• Dane techniczne — sekcja zwinięta. Kliknij Pokaż, żeby zobaczyć identyfikator integracji, termin ważności dostępu do drugiego systemu i formularz Dane połączenia. O identyfikator może poprosić wsparcie.

Na górze karty są przyciski Odśwież, Synchronizacja zamówień i Synchronizacja produktów. Oba przyciski synchronizacji pojawiają się tylko w systemach, które to obsługują, i tylko wtedy, gdy masz uprawnienie Integracje: Zarządzanie.

📷 Zrzut ekranu do dodania: karta integracji sklepu z paskiem stanu, sekcjami Ostatnia synchronizacja i Synchronizacja zamówień oraz kartą połączenia

Typowe zadania

Podłączanie systemu

1. Otwórz Integracje → Integracje → Lista integracji i kliknij Nowa integracja.
2. Znajdź system przez pole wyszukiwania albo przyciski filtrów i kliknij jego kafelek.
3. Wypełnij formularz. Pole Nazwa integracji wypełniasz dowolnie. Pozostałe pola są inne w każdym systemie; strona Konektory wymienia je po kolei.
4. Jeśli system pobiera zamówienia, wybierz Jak często pobierać zamówienia?: co 15, 30 albo 60 minut.
5. Kliknij Utwórz integrację.

Dalszy ciąg zależy od systemu:

• Allegro — przeglądarka od razu przechodzi do Allegro. Zaloguj się i zatwierdź dostęp, a wrócisz na kartę integracji.
• WooCommerce, jeśli wybierzesz łączenie przez sklep — przeglądarka przechodzi do panelu administracyjnego sklepu. Zatwierdź dostęp, a wrócisz.
• Wszystkie pozostałe systemy — Complaia zapisuje integrację, od razu próbuje się połączyć i otwiera kartę integracji.

Jeśli połączenie się nie uda, integracja i tak zostaje zapisana i pokazuje Błąd. Przeczytaj przyczynę na jej karcie, popraw dane w formularzu Dane połączenia i przetestuj jeszcze raz.

Sprawdzanie połączenia

1. Otwórz integrację.
2. Na karcie połączenia po prawej kliknij Test połączenia.

Okno powie, czy połączenie działa i co dokładnie sprawdził test. Jeśli test się nie udał, okno pokaże też odpowiedź drugiego systemu. Test tylko odczytuje dane, nigdy niczego nie tworzy ani nie zmienia. Po teście przycisk odlicza 15 sekund, zanim będzie można przetestować ponownie.

W PrestaShop i WooCommerce okno może też powiedzieć, że połączenie działa, ale kluczowi brakuje uprawnienia. Zobacz Konektory.

Pobieranie zamówień albo produktów od razu

Nie musisz czekać na harmonogram. Tak samo pobierzesz zamówienia sprzed utworzenia integracji.

Zamówienia

1. Otwórz integrację i kliknij na górze przycisk Synchronizacja zamówień.
2. Zostaw zaznaczone Nowe zamówienia i wybierz okres: Dzisiaj, Wczoraj, Ostatnie 7 dni, Ostatnie 30 dni albo Od ostatniej synchronizacji. Możesz też ustawić własne daty Od i Do.
3. Zdecyduj o polu Nie uruchamiaj reguł dla tych zamówień. Po otwarciu okna jest zaznaczone. Dopóki jest zaznaczone, Twoje reguły ze zdarzeniem Utworzone nie uruchamiają się dla zamówień z tego okresu złożonych, zanim integracja zaczęła pobierać. Chroni to na przykład przed utworzeniem etykiety kurierskiej dla starego zamówienia.
4. Jeśli okno proponuje więcej opcji, zaznacz te, których potrzebujesz. Zależnie od ustawień możesz też pobrać statusy i płatności zamówień już pobranych albo wysłać zmiany statusów, które nie dotarły do drugiego systemu.
5. Kliknij Uruchom synchronizację.

Komunikat pokaże, ile zamówień utworzono i zaktualizowano, a ile się nie udało. Te same liczby pojawią się w sekcji Ostatnia synchronizacja.

Produkty

1. Kliknij na górze przycisk Synchronizacja produktów.
2. Przeczytaj okno i kliknij Uruchom synchronizację produktów.

Complaia przechodzi przez cały katalog produktów drugiego systemu i tworzy tylko te produkty, których jeszcze nie masz. Istniejący produkt rozpoznaje najpierw po jego identyfikatorze w drugim systemie, potem po SKU (kodzie produktu), a na końcu po EAN (europejskim kodzie kreskowym). Nie zmienia produktów, które już masz, nie importuje zdjęć i nie rusza stanów magazynowych. Produkt, który u Ciebie jest produktem prostym, a w drugim systemie ma warianty, zostaje pominięty razem z wariantami. Okno wymienia takie produkty na końcu.

Dwukrotne uruchomienie tej samej synchronizacji jest bezpieczne. Zamówienia, które już są w Complaia, zostają zaktualizowane, a nie zdublowane. Po ręcznej synchronizacji odczekaj 30 sekund, zanim uruchomisz kolejną.

Wstrzymywanie i wznawianie integracji

Wstrzymaj integrację, gdy musi na jakiś czas przestać działać, na przykład kiedy zmieniasz coś w sklepie.

1. Otwórz integrację.
2. Na karcie połączenia kliknij Wstrzymaj.
3. Okno wymienia, co się zatrzyma: pobieranie zamówień, zmiany w pobranych zamówieniach, wysyłanie numerów śledzenia, statusów i płatności, reguły tej integracji, a u kuriera także jego przesyłki i podjazdy. Potwierdź.

Gdy integracja jest wstrzymana:

• nic nie jest pobierane ani wysyłane, a jej reguły czekają;
• listy mapowań oraz przyciski testu i synchronizacji są wyłączone;
• u kuriera nie można nadać, odświeżyć ani anulować jego przesyłek.

Aby wznowić integrację, kliknij Włącz na karcie połączenia albo Wznów integrację w pasku stanu i potwierdź. Complaia nadrabia wtedy w tle to, co czekało w czasie przerwy:

• pobiera nowe zamówienia i zmiany w zamówieniach już pobranych;
• sprawdza status otwartych przesyłek;
• wysyła numery śledzenia przesyłek nadanych w czasie przerwy;
• wysyła statusy i płatności, które zmieniły się w Complaia w czasie przerwy, jeśli to Complaia je ustala.

Dopóki to trwa, widać notkę Nadrabianie zaległości. Podjazd kuriera nie jest wtedy zamawiany; zamówi go najbliższe zaplanowane uruchomienie.

Usuwanie integracji

1. Otwórz integrację.
2. Na karcie połączenia kliknij ikonę kosza.
3. Przeczytaj okno. Pokazuje, ile reguł i mapowań zostanie usuniętych. Potwierdź.

Usunięcie kasuje połączenie, dane połączenia, wszystkie mapowania i wszystkie reguły integracji. Nie da się go cofnąć. Żeby znowu korzystać z systemu, łączysz go od początku.

Wszystko, co integracja już pobrała, zostaje: zamówienia, produkty i podmioty (klienci i dostawcy). Utworzone zlecenia logistyczne zostają bez zmian, a kurier ich nie anuluje.

Integracji kurierskiej nie da się usunąć, dopóki którakolwiek z jej przesyłek jest w drodze. Usunięcie blokuje też przesyłka anulowana w Complaia, której etykieta nadal jest ważna u kuriera. Najpierw zamknij taką przesyłkę na jej karcie. Jeśli integracja musi przestać działać od razu, wstrzymaj ją. Wstrzymać można zawsze.

Prośba o system, którego nie ma w katalogu

1. Na liście integracji kliknij Poproś o integrację.
2. Wypełnij pola Nazwa systemu, Opis funkcjonalny (co integracja ma robić) i E-mail zwrotny. Twój adres e-mail jest wpisany za Ciebie. Pola URL strony lub dokumentacji i Dodatkowe informacje są opcjonalne.
3. Kliknij Wyślij zgłoszenie.

Prośba trafia do zespołu produktowego Complaia, który odpowie na podany adres. Jeśli prośby nie da się wysłać, Complaia otworzy Twój program pocztowy z gotową wiadomością.

Jak przepływają zamówienia

  sklep / marketplace / integrator
        │   pobierane według harmonogramu (co 15, 30 albo 60 minut)
        ▼
  zamówienie pojawia się w Complaia ──► jego pozycje są dopasowywane do Twoich produktów
        │
        ▼
  rezerwujesz towar, pakujesz i tworzysz zlecenie logistyczne
        │
        ▼
  zmiany statusu i numer śledzenia wracają do sklepu albo na marketplace
  (zależnie od ustawień)

• Nowe zamówienia przychodzą według harmonogramu, a nie w chwili złożenia. Przy najkrótszym interwale zamówienie trafia do Complaia w ciągu mniej więcej 15 minut.
• Domyślnie integracja pobiera tylko zamówienia złożone po jej utworzeniu. Starsze pobierzesz przyciskiem Synchronizacja zamówień.
• Pozycje zamówień są dopasowywane do katalogu automatycznie. Pozycja, która do niczego nie pasuje, zostaje na zamówieniu bez produktu i dopasowujesz ją ręcznie. Zobacz Import produktów i dopasowania z zamówień oraz Zamówienia.
• Status nowego zamówienia i los późniejszych zmian statusu zależą od tego, kto ustala status. Zobacz Mapowania → Kto ustala status i płatność zamówienia.
• Wysyłanie numerów śledzenia jest wyłączone, dopóki go nie włączysz. Zobacz Mapowania → Odsyłanie numerów śledzenia.

Gdy coś nie działa

Co widzisz	Dlaczego	Co zrobić
Kafelek pokazuje Błąd	Ostatnia próba połączenia się nie udała.	Otwórz integrację. Pasek stanu i karta połączenia pokazują ostatni błąd. Usuń przyczynę i kliknij Test połączenia.
Czerwony wiersz na kafelku, ale stan to Połączona	Połączenie działa, ale ostatnie uruchomienie jednego z zadań się nie udało.	Otwórz integrację i przeczytaj przyczynę w sekcji Ostatnia synchronizacja.
Nowa integracja Allegro pokazuje Oczekuje	Zatwierdzanie dostępu w Allegro nie zostało dokończone.	Otwórz integrację i kliknij Połącz z Allegro. Zobacz Konektory → Allegro.
Integracja o tej nazwie już istnieje. Użyj innej nazwy.	Dwie integracje nie mogą mieć tej samej nazwy. Formularz za każdym razem podpowiada nazwę samego systemu.	W polu Nazwa integracji wpisz inną nazwę, na przykład adres sklepu.
Pole „…” jest wymagane.	Wymagane pole formularza jest puste.	Wypełnij pole podane w komunikacie.
Integracja „…” jest wstrzymana, więc ta operacja nie zostanie wykonana.	Integracja jest wstrzymana.	Wznów ją. Zobacz Wstrzymywanie i wznawianie integracji.
Zbyt wiele wywołań w krótkim czasie. Odczekaj … s i spróbuj ponownie.	Test albo synchronizacja zostały uruchomione ponownie zbyt szybko.	Odczekaj podaną liczbę sekund.
Synchronizacja z … właśnie trwa.	Pobieranie dla tej integracji jeszcze trwa.	Spróbuj ponownie za kilka minut.
Integracji nie da się usunąć	Integracja kurierska ma jeszcze przesyłki w drodze.	Poczekaj, aż zostaną doręczone, albo zamknij je na karcie zlecenia logistycznego. Jeśli integracja musi przestać działać teraz, wstrzymaj ją.
Brakuje przycisków Synchronizacja zamówień, Test połączenia albo Nowa integracja	Twoja rola może przeglądać integracje, ale nie może nimi zarządzać.	Poproś administratora o uprawnienie Integracje: Zarządzanie.
Zamówienia przestały przychodzić, choć kafelek pokazuje Połączona	Pobieranie jest wstrzymane albo ustawione na ręczne, albo w sklepie nie ma nowych zamówień.	Otwórz integrację i zajrzyj do sekcji Synchronizacja zamówień. Zobacz Reguły integracji. Potem spróbuj przycisku Synchronizacja zamówień dla okresu Dzisiaj.
Brakuje zamówień sprzed utworzenia integracji	Automatyczne pobieranie zaczyna się w chwili utworzenia integracji.	Użyj przycisku Synchronizacja zamówień z zakresem dat.

Uprawnienia

Aby…	Potrzebujesz
Widzieć listę integracji, kartę integracji, listę reguł i regułę systemową	Integracje: Podgląd
Łączyć, testować, synchronizować, wstrzymywać i usuwać integracje, zmieniać dane połączenia i mapowania, prosić o integrację, tworzyć i edytować reguły	Integracje: Zarządzanie

Bez uprawnienia Integracje: Podgląd menu Integracje w ogóle się nie pojawia.

Zobacz też

• Konektory — czego potrzebuje każdy system i co potrafi
• Reguły integracji — reguła systemowa i Twoje własne reguły
• Mapowania — statusy, płatności, źródła zamówień, sposoby dostawy i kurierzy
• Zamówienia — tu trafiają pobrane zamówienia
• Import produktów i dopasowania z zamówień — dopasowanie pozycji zamówień do Twoich produktów
• Zlecenia logistyczne — tworzenie przesyłki kurierskiej
• Dziennik zdarzeń — kto podłączył, zmienił albo usunął integrację