Podłączenie przewoźnika — połączenie i jego konfiguracja

Przewoźnik podłącza się tak samo jak kanał sprzedaży: z zakładki Dostępne integracje wybierasz konektor i zakładasz połączenie (Lista integracji — moje połączenia i katalog dostępnych).

Krok po kroku

1. Wejdź w Integracje → Integracje i przejdź na zakładkę Dostępne integracje.
2. W filtrze Typ wybierz Dostawa, żeby zobaczyć wyłącznie przewoźników.
3. Na kaflu przewoźnika kliknij + Dodaj.
4. W formularzu Nowa integracja wpisz Nazwa. Przy dwóch kontach u jednego przewoźnika daj nazwy, które je rozróżniają — np. z oddziałem w nazwie.
5. Kliknij Utwórz. Trafisz na ekran konfiguracji.
6. Na etapie Połączenie uzupełnij dane dostępowe, dane nadawcy i domyślne parametry paczki (patrz niżej).
7. Zapisz przyciskiem Zapisz zmiany na dolnym pasku. System poprosi o kod w oknie Wymagana weryfikacja 2FA (Potwierdzenie 2FA przy zmianach uprawnień).
8. Kliknij Test w nagłówku. Nie idź dalej, dopóki nie zobaczysz Połączenie OK — dalsze kroki nie mają sensu przy złych kluczach.
9. Włącz przełącznik obok przycisku Test, żeby połączenie zaczęło pracować.
10. Wykonaj trzy kroki z sekcji „Po podłączeniu" na końcu tego artykułu.

Co trzeba uzupełnić

• Dane dostępowe — klucze, login, numer klienta u przewoźnika. Zestaw pól zależy od konektora.
• Dane nadawcy — adres, z którego jadą przesyłki. Trafiają na etykietę.
• Domyślne parametry paczki — wymiary i waga używane, gdy przesyłka ich nie ma.

Pól szukaj przez wyszukiwarkę Szukaj ustawienia… nad etapami, zamiast przewijać całą listę.

Po wpisaniu danych użyj przycisku Test. Wynik zapisuje się jako kondycja integracji, widoczna w nagłówku pod etykietą Połączenie, i jest najszybszą drogą do rozstrzygnięcia, czy problem leży w kluczach, czy gdzie indziej.

Jedna firma, kilka kont

Można mieć kilka połączeń z tym samym przewoźnikiem — np. dwa konta DHL dla dwóch oddziałów. Każde ma własne dane nadawcy i własną konfigurację.

Co dany przewoźnik potrafi

Konektory różnią się możliwościami — nie każdy obsługuje śledzenie, zwroty czy anulowanie. Pełne zestawienie: obsługa kurierów w śledzeniu przesyłek.

Warto to sprawdzić przed wdrożeniem, a nie po. Brak anulowania przy przewoźniku, u którego liczyliście na anulowanie z systemu, zmienia proces obsługi.

Czego nie da się skonfigurować

Dwie rzeczy, których nie ma w żadnym konektorze:

• zamawianie podjazdu kuriera — awizacja odbywa się w panelu przewoźnika,
• zbiorczy list przewozowy / manifest — system go nie generuje.

Nie szukaj tych ustawień; ich nie ma (obsługa kurierów w śledzeniu przesyłek).

Global24: dwa konektory

Global24 ma w katalogu dwa kafle. Global24 to starsze API (login i hasło). Global24 Partner API to nowe API (token). Przejście na nowe API wygląda tak:

1. Załóż połączenie Global24 Partner API i wklej token od Global24 w pole API token.
2. Kliknij Test. Komunikat podaje, ile usług przewozowych widzi Twoje konto.
3. Wpisz usługę dla każdego kraju w pole Delivery service per country (i Return service per country dla zwrotów), np. {"DE": {"code": "DE-DHL", "service": "DST", "size": "NP"}}. Klucz "*" obejmuje wszystkie pozostałe kraje. Pole może zostać puste dla kraju, w którym Global24 oferuje Twojemu kontu tylko jedną usługę — system ją wtedy sam wybierze. Gdy usług jest kilka, nadanie się zatrzyma, a komunikat wymieni kody do wyboru.
4. Przepnij metody dostawy na nowego kuriera Global24 Partner (Mapowanie metod dostawy i walidacja przesyłek).

Starego połączenia nie wyłączaj od razu. Paczki nadane starym API są dalej śledzone przez stare połączenie, aż dojadą.

Wysyłki do Wielkiej Brytanii i Ukrainy wymagają danych celnych. Uzupełnij Customs HS code i Customs country of origin. Taka przesyłka może mieć tylko jedną paczkę. Zwrotów z tych krajów Partner API jeszcze nie obsługuje — system odmówi z komunikatem.

API wymaga adresu e-mail klienta. Gdy zamówienie go nie ma, system wyśle Fallback email; zbyt długi adres zastąpi Replacement for too long email. Zwrot wraca na adres z profilu konta Global24, nie na adres magazynu z Noxti.

Zapis wymaga 2FA

Klucze i zmienne integracji to dane wrażliwe — zapis poprosi o kod (Potwierdzenie 2FA przy zmianach uprawnień).

Po podłączeniu

1. Sprawdź, czy przewoźnik jest w słowniku kurierów (Lista kurierów — słownik przewoźników).
2. Zmapuj metody dostawy z marketplace'ów na tego kuriera (Mapowanie metod dostawy i walidacja przesyłek).
3. Wygeneruj etykietę testową (Etykiety kurierskie — generowanie, ponowny wydruk, wygaśnięcie).