Kanał sprzedaży — integracja, połączenie i ustawienie

W module integracji przewijają się trzy pojęcia o podobnych nazwach. Rozróżnienie ich oszczędza dużo nieporozumień.

Krok po kroku

Założyć nowe połączenie z kanałem

1. Menu Integracje → Integracje. Ekran otwiera się na zakładce Moje integracje — to lista połączeń, które już masz (przy nazwie zakładki jest ich licznik).
2. Przejdź na zakładkę Dostępne integracje. To katalog typów, czyli integracji.
3. Zawęź katalog: pole Szukaj…, filtr Typ (Marketplace, Dostawa, Zamówienia ręczne, Wsparcie / System, Magazyn, AI) i filtr Status (Aktywna / Nieaktywne).
4. Na kafelku wybranej integracji kliknij + Dodaj.
5. Wpisz Nazwa — to pole jest wymagane, bez niego przycisk zostanie nieaktywny. Nazwa jest twoja i służy do rozróżnienia połączeń tej samej integracji („Allegro PL", „Allegro CZ"). Obok jest przełącznik Aktywna.
6. Kliknij Utwórz. Anuluj wraca bez zapisu.

Skonfigurować świeże połączenie

1. Po utworzeniu otwiera się ekran połączenia z listą etapów po lewej. Etapy są takie same dla każdej integracji i w tej samej kolejności: Połączenie, Zamówienia, Stany i produkty, Ceny, Wysyłka, Zwroty, a na końcu Zaawansowane. Pomiędzy Zwroty a Zaawansowane wchodzą jeszcze Powiadomienia, AI i Płatności — ale tylko tam, gdzie dotyczą.
2. Zacznij od etapu Połączenie. Dopóki dane dostępowe nie są zapisane, pozostałe etapy są zablokowane, a ekran pisze: „Dalsze etapy są zablokowane, dopóki nie uzupełnisz wymaganych danych dostępowych. Bez działającego połączenia żadne z pozostałych ustawień nie zadziała."
3. Uzupełnij pola i kliknij Zapisz zmiany na pasku, który pojawia się u dołu z licznikiem Niezapisane zmiany. Samo wpisanie wartości nic nie odblokowuje — komunikat zmienia się wtedy na „Zapisz dane dostępowe, aby odblokować dalsze etapy." Sąsiedni przycisk Odrzuć kasuje niezapisane zmiany.
4. Zapis poprosi o kod 2FA (patrz niżej).
5. Sprawdź konfigurację przyciskiem Test w nagłówku. Wynik pojawia się jako pasek nad etapami: Połączenie OK albo Błąd połączenia, z czasem odpowiedzi w milisekundach.
6. Ukończony etap dostaje w liście znacznik z podpowiedzią Etap gotowy. Etap, którego dana integracja nie obsługuje, pokazuje Nie dotyczy tej integracji — to nie jest błąd.

Znaleźć ustawienie, którego nie widać na etapie

1. Skorzystaj z pola Szukaj ustawienia… nad listą etapów — szuka po wszystkich etapach naraz.
2. Wynik podaje Znaleziono ustawień i grupuje trafienia po etapach. Jeśli część trafień siedzi za bramką danych dostępowych, obok pojawia się Ukryte na zablokowanych etapach z liczbą.
3. Brak trafień to komunikat Brak ustawień pasujących do frazy. Jeśli szukasz parametru opisanego w dokumentacji i wyszukiwarka go nie zna — to opisany niżej przypadek ustawienia bez zapisanej wartości. Zgłoś to osobie obsługującej wdrożenie.

Wyłączyć połączenie na chwilę

1. Otwórz połączenie z zakładki Moje integracje.
2. Przełącznik w prawym górnym rogu nagłówka (bez podpisu, obok przycisku Test) włącza i wyłącza połączenie.
3. Ten sam przełącznik jest na kafelku połączenia na liście — w prawym górnym rogu kafelka, też bez podpisu. Po przełączeniu z listy system pokazuje komunikat Operacja zakończona pomyślnie.

Integracja = typ

To pozycja w katalogu dostępnych konektorów. Jest jedna dla wszystkich firm na platformie i sama w sobie nic nie robi — to szablon. Każda integracja ma typ obiektu: marketplace, kurier, magazyn/ERP, usługa wspierająca albo AI.

Połączenie = twoje konto

Dopiero połączenie ma klucze API, wybrany magazyn i całą konfigurację. Jedna firma może mieć kilka połączeń z tą samą integracją — np. dwa konta Allegro albo Kaufland w dwóch krajach. Każde ma własne ustawienia, własne oferty i własny stan synchronizacji.

Połączenie ma przełącznik aktywności — bez podpisu, w nagłówku. Wyłączenie go zatrzymuje wszystko, co przez nie idzie (Wyłączniki, które zatrzymują cały kanał).

Ustawienie = jeden parametr

Zestaw ustawień zależy od integracji. Każde pole ma nazwę i opis, a formularz jest dopasowany do wybranego kanału. Dlatego połączenia różnych marketplace’ów mają różne pola.

Ważne zachowanie: ustawienie, które nie ma zapisanej wartości dla twojego połączenia, jest dla systemu niewidoczne — nie pokaże się w formularzu i nie da się go ustawić. To nie jest ukrywanie „na wszelki wypadek"; takiego ustawienia po prostu nie ma czym włączyć.

Jeśli w dokumentacji przeczytasz o parametrze, którego nie widzisz u siebie — to jest ten przypadek. Zgłoś to osobie obsługującej wdrożenie.

Zmiana ustawień wymaga 2FA

Zapis konfiguracji połączenia to operacja podwyższonego ryzyka — poprosi o kod (Potwierdzenie 2FA przy zmianach uprawnień).