Konfiguracja integracji z kurierem Geodis
-
Konfiguracja integracji z kurierem Geodis
Geodis to przewoźnik znany z szerokiej oferty w zakresie optymalizacji łańcucha dostaw, spedycji, logistyki kontraktowej, dystrybucji oraz ekspresowych przesyłek. Działa globalnie w kilkudziesięciu krajach i oferuje trzy rodzaje transportu:
- drogowego
- lotniczego
- morskiego
Integracja Sellasist z firmą kurierską Geodis umożliwia automatyczne nadawanie przesyłek, generowanie etykiet przewozowych i śledzenie statusu dostaw bezpośrednio z panelu. Dzięki tej integracji proces wysyłki dużych i ciężkich towarów stanie się prosty i efektywny, a wraz z automatyzacją tych działań w Sellasist zaoszczędzisz czas i zminimalizujesz ryzyko błędów. Integrację z Geodis wprowadziliśmy na nowym module integracji kurierskich, który niesie za sobą szereg korzyści.
By uruchomić integrację, musisz posiadać konto w serwisie Geodis i wprowadzić do Sellasist dane logowania.
Co należy zrobić?- Przejdź do zakładki: Integracje ⇨ [Nowe] Integracje kurierskie.
- Wybierz Dodaj konto integracyjne Geodis i postępuj zgodnie z poniższymi instrukcjami.
- Wypełnij formularz [Nowe] Adresy nadawcze w zakładce Administracja ⇨ Metody dostawy.
- Dodaj nowe szablony nadania. Przejdź do zakładki Administracja ⇨ Metody dostawy i wybierz [Nowe] Szablony nadania.
- Ustaw akcje automatyczne. Dla nowego modułu integracji kurierskich. zostały dodane nowe warunki oraz efekty w Administracja ⇨ Automatyzacja.
Jakie korzyści daje integracja Geodis na nowym module kurierskim?- Łatwa konfiguracja – Nowy sposób ustawień reguł doboru i zarządzania szablonami umożliwia lepsze dopasowanie rodzaju przesyłek do indywidualnych potrzeb sprzedawcy.
- Szybsza obsługa przesyłek – nowy serwis shipments zapewnia większą wydajność oraz stabilność działania.
- Szybsze generowanie listów przewozowych – dzięki asynchroniczności nowy system pozwala przetwarzać wiele zamówień jednocześnie, co skraca czas obsługi.
- Automatyczne naprawianie problemów (resilency) – gdy pojawią się błędy, system automatycznie je wykryje i naprawi, co minimalizuje ryzyko przerw w działaniu.
- Większa wydajność dzięki vertical sharding – dane są lepiej rozdzielane w systemie, co sprawia, że operacje są szybsze i bardziej efektywne.
- Sprawdzanie danych po stronie Sellasist (internal validation) – system będzie sprawdzał poprawność danych jeszcze przed ich wysłaniem, co zmniejszy ryzyko błędów i reklamacji.
- Obsługa wielopaczek – pozwala na automatyczne dzielenie zamówień na kilka paczek oraz generowanie etykiet przewozowych zgodnie z zapotrzebowaniem sprzedawcy. W ramach jednego zlecenia dla kilku paczek w karcie zamówienia pojawi się jeden list przewozowy.
KROK 1: Aktywacja konta
1. Do nowych integracji kurierskich ma wgląd główny administrator, aby nadać uprawnienia pozostałym administratorom przejdź do zakładki Administracja ⇨ Administratorzy i nadaj dostęp do następujących funkcji:
- [Nowe] Integracje kurierskie- [Nowe] Adresy nadawcze- [Nowe] Szablony nadania- [Nowe] Reguły doboru szablonów nadania
2. Przejdź do Integracje ⇨ [Nowe] Integracje kurierskie i wybierz Geodis i zaloguj się na swoje konto.
3. Dodaj dane dostępowe.
Nazwa użytkownika i Hasło – parametry API, czyli identyfikator i klucz dostępu. Dane te uzyskasz od swoich opiekunów.
Pamiętaj!- Jeżeli masz więcej niż jedno konto Geodis, musisz dodać Integrację kurierską - dla każdego konta osobno.
KROK 2: Dodawanie adresów nadawczych
Czym są adresy nadania?
Adres nadania to fizyczna lokalizacja, z której paczki są wysyłane przez nadawcę. Może to być:- Adres Twojej firmy (np. magazynu, biura lub sklepu),
- Adres prywatny (w przypadku sprzedaży indywidualnej),
- Dowolna lokalizacja, w której regularnie przygotowujesz paczki do wysyłki.
Ważne: Adres nadania to miejsce odbioru przesyłek przez kuriera. Upewnij się, że jest poprawny, jeśli korzystasz z odbioru paczek przez przewoźnika.
Kod punktu odbioru/nadania to unikalny identyfikator wskazujący na konkretny punkt partnerski przewoźnika, w którym można nadać paczki – Ty jako nadawca dostarczasz paczki osobiście do wybranego punktu.
Kod punktu nadania jest potrzebny przy osobistym dostarczeniu paczek, aby system przewoźnika przypisał je do właściwego punktu.
--------------------------------------------
Kiedy wybrać adres nadania, a kiedy kod punktu nadania?
Adres nadania:- Gdy chcesz, aby kurier odbierał przesyłki bezpośrednio od Ciebie.
- Gdy wysyłasz duże ilości paczek lub masz zautomatyzowane procesy nadawania.
Kod punktu nadania:- Gdy chcesz osobiście dostarczyć przesyłki do punktu przewoźnika.
- Gdy Twój adres nadania jest poza obszarem obsługiwanym przez kuriera.
1.Przejdź do Administracja ⇨ Metody dostawy ⇨ [Nowe] Adresy nadawcze. Następnie kliknij Dodaj adres nadawczy.
2. Typ adresu – z rozwijanej listy wybierz typ adresu.
3. Uzupełnij dane i kliknij Zapisz.
Skonfigurowane adresy nadawcze możesz w dowolnym momencie edytować, klikając ikonę ołówka lub usunąć, klikając czerwony krzyżyk:
KROK 3: Tworzenie szablonów nadania
Czym są szablony nadania i jak je skonfigurować?
Szablony nadania w Sellasist to elastyczne narzędzie umożliwiające szybkie i intuicyjnie zarządzanie procesem wysyłki. Szablon nadania pozwala zdefiniować szczegóły związane z wysyłką dla wybranego przewoźnika, uwzględniając różne opcje dostawy, parametry przesyłki oraz preferencje dotyczące usług dodatkowych. Dzięki temu możesz zautomatyzować i uprościć proces przygotowywania przesyłek.
Korzyści nowych szablonów nadania:- Szybkość i automatyzacja – umożliwiają łatwe przypisanie odpowiednich ustawień do każdego zamówienia.
- Elastyczność – możliwość konfiguracji dostosowanej do specyficznych potrzeb (Np. różne opcje dostawy dla różnych przewoźników).
- Wielopaczkowość – automatyczna obsługa zamówień z wieloma paczkami.
- Zintegrowane procesy – możliwość aktywacji szablonu poprzez skanowanie kodu kreskowego podczas pakowania.
1. Przejdź do zakładki Administracja ⇨ Metody dostawy ⇨ [Nowe] Szablony nadania i kliknij Dodaj szablon nadania.
2. Wybierz integrację:
UWAGA: Możesz utworzyć osobne szablony nadania dla każdego konta Geodis lub stworzyć je tylko na jednym koncie. Szablony utworzone dla danego konta będą dostępne także dla pozostałych kont w ramach tej samej integracji.
3. Tworzymy szablon nadania dla konkretnego przewoźnika i przypisujemy mu parametry:
Nazwa szablonu – nadaj szablonowi unikalną nazwę, aby łatwo go było rozpoznać (np. Geodis - BASIC).Typ usługi – standardowa.Domyślny – zaznaczenie tej opcji automatycznie podstawi ten szablon. Szablon domyślny pozwala nadawać przesyłki za pomocą tych samych parametrów dla danego konta Geodis. System będzie automatycznie dobierał prawidłowe dla zamówienia reguły, a następnie szablon domyślny dla danej usługi. Jeśli nie znajdzie szablonu, Sellasist będzie szukał ww. szablonów wśród pozostałych kont Geodis. W przypadku nieznalezienia pasującego szablonu domyślnego przesyłka nie zostanie nadana, o czym system poinformuje w odpowiednim komunikacie.
Poniżej przedstawiamy proces doboru szablonu nadania jeśli dodano szablon domyślny1. Reguły / Konto Geodis, z którego pochodzi zamówienie / Typ usługi wybrany w zamówieniu2. Reguły / Konto Geodis, z którego pochodzi zamówienie / Dowolny typ usługi3. Domyślny szablon nadania / Konto Geodis, z którego pochodzi zamówienie / Typ usługi wybrany w zamówieniu4. Domyślny szablon nadania / Konto Geodis, z którego pochodzi zamówienie5. Domyślny szablon nadania / Dowolne konto Geodis / Typ usługi wybrany w zamówieniu6. Domyślny szablon nadania / Dowolne konto Geodis / Dowolny typ usługi
Sekcja "Dane podstawowe”
Format etykiety – z rozwijanej listy wybierz właściwe rozszerzenie pliku: PDF lub ZPL.
Adres nadania – wybierz adres, z którego będą wysyłane przesyłki.
Pobranie – z rozwijanej listy wybierz właściwą opcję:- "Jak w zamówieniu” – opcja zgodna z zamówieniem klienta- "Zawsze włączona” – aktywacja pobrania dla każdej przesyłki- "Zawsze wyłączone” – brak pobrania niezależnie od zamówienia
4. Sekcja "Wymiary paczki”
Liczba paczek w zleceniu
Szablon nadania obsługuje wielopaczki, a kurier Geodis umożliwia wystawienie jednego listu przewozowego dla kilku paczek w ramach jednego zamówienia.- Mamy możliwość modyfikacji liczby paczek ręcznie w formularzu nadania.
- Pobranie i ubezpieczenie przypisywane są do numeru listu przewozowego. System nie dzieli kwoty na każdą paczkę osobno.
- Pojawi się komunikat "Ten kurier wspiera wielopaczkowość”.
- Na karcie zamówienia widoczna będzie tylko jedna pozycja z numerem listu przewozowego.
- Wygenerowane listy przewozowe zostaną połączone w jeden plik.
- Ewentualne pobranie za paczki będzie wspólne dla zlecenia.
Wystarczy ręcznie zmienić wartość w polu Liczba paczek w zleceniu i uzupełnić wymiary paczek:
Gdy w szablonie nie ma podanej wagi, system automatycznie ją uzupełnia, przekazując do kuriera wagę wyliczoną na podstawie produktów z zamówienia.
Szablon - Kurier Geodis obsługuje przesyłki ze wszystkich łańcuchów dostaw. Możesz z rozwijanej listy wybrać odpowiedni szablon dla swoich zamówień np. paczka, europaleta lub paleta.
Tekst na etykiecie - Wprowadź dodatkowy tekst na etykietę (np. numer zamówienia). Możesz wykorzystać zmienne dostępne na niebieskim polu w panelu Sellasist. Pamiętaj, że limit znaków zależy od przewoźnika.
Skonfigurowane szablony możesz w dowolnym momencie edytować, klikając ikonę ołówka lub usunąć, klikając czerwony krzyżyk:
Aby skopiować szablon kliknij "Zapisz jako nowy". Edytuj wybrany szablon nadania, klikając ikonę ołówka, zjedź na dół i kliknij przycisk:
Kod kreskowy szablonu nadania:- Generowanie kodu: Każdy szablon nadania ma przypisany unikalny kod kreskowy, który umożliwia bezpośrednie nadawanie przesyłki. Kod kreskowy pojawi się po zapisaniu szablonu.
- Pobieranie i drukowanie: Możesz pobrać i wydrukować kod kreskowy danego szablonu, co ułatwia jego aktywację.
- Aktywacja przez skanowanie: Podczas pakowania wystarczy zeskanować kod kreskowy szablonu, aby go aktywować, co znacznie przyspieszy proces wysyłki.
Więcej o aktywatorach znajdziesz w drugim punkcie instrukcji.
KROK 4: Reguły doboru szablonu nadania- Można przypisać reguły do konkretnego konta Geodis.
- Możesz utworzyć tylko jedną Regułę doboru szablonu nadania dla kombinacji konto Geodis i dany typ usługi.
- Reguły dobierane są na podstawie wagi lub ceny zamówienia.
- Możliwość definiowania wartości granicznych (np. do 15 kg, do 30 kg itp.).
- Tworzenie reguł doboru szablonu nadania nie jest konieczne jeśli oznaczymy wybrany szablon nadania jako Domyślny.
1. By stworzyć szablony przejdź do Administracja ⇨ Metody dostawy ⇨ [Nowe] Reguły doboru szablonów nadania.
2. Uzupełnij formularz:
Rodzaj integracji – z rozwijanej listy wybierz typ integracji, w tym przypadku Geodis.Konto – wybierz konto Geodis, do którego konfigurujesz regułę szablonu nadania.Typ usługi – wybierz typ usługi standardowa.Reguła doboru – decyduj, czy dobór szablonu ma odbywać się na podstawie: Wagi (np. do 15 kg, do 30 kg) lub Ceny zamówienia (np. do 200 zł, powyżej 200 zł).
W sekcji Reguły podaj wartość graniczną i przypisz wcześniej stworzony szablon nadania. Dodawaj kolejne zakresy według własnych potrzeb.
Wartości graniczne – ustal zakresy wagowe lub cenowe i przypisz do nich odpowiednie szablony nadania. Możesz dodać tyle zakresów, ile potrzebujesz.Szablon nadania – wskaż wcześniej przygotowany szablon nadania, który zostanie przypisany do danej reguły.Spróbuj dobrać domyślny – system spróbuje dobrać domyślny szablon.Nie dobieraj szablonu – jeśli nie chcesz nadawać przesyłek przekraczających określoną wagę lub wartość zamówienia, zaznacz opcję „Nie dobieraj szablonu”, gdy zamówienie przekroczy wskazane parametry, system uniemożliwi wygenerowanie listu przewozowego.
Kliknij Zapisz.
Skonfigurowane reguły doboru szablonów nadania możesz w dowolnym momencie edytować, klikając ikonę ołówka lub usunąć, klikając czerwony krzyżyk:
Aby skopiować formularz kliknij "Zapisz jako nowy". Edytuj wybraną regułę, klikając ikonę ołówka, zjedź na dół i kliknij przycisk:
KROK 5: Generowanie listu przewozowego
Integracja z kurierem Geodis, oparta na nowym module integracji kurierskich umożliwia elastyczne zarządzanie nadawaniem paczek, które możesz dostosować do swoich potrzeb operacyjnych i logistycznych. Nowy moduł integracji kurierskich zapewnia stabilne generowanie listów przewozowych. W przypadku problemów z API lub napotkania innych błędów list przewozowy zostanie wygenerowany po ich naprawie lub usunięciu, bez potrzeby ponawiania akcji.
Sprawdzanie, czy list przewozowy wygenerował się po pojawieniu się błędów:- Zwykły błąd – po usunięciu błędu próba wygenerowania listu zostanie od razu ponowiona.
- Błąd API 500 – w przypadku awarii po stronie przewoźnika lub Geodis system ponowi próbę po 3 sekundach, jeżeli błąd pojawi się ponownie, próba zostanie wznowiona po 6 sekundach i będzie wznawiana z wielokrotnością co 3 sekundy aż do wykonania próby.
- Błąd walidacji – błąd ten oznacza, że podane dane nie spełniają określonych wymogów. W logach zamówienia zostanie wyświetlony komunikat o nieudanej próbie wygenerowania przesyłki. Należy zweryfikować poprawność wprowadzonych danych adresowych i nadawczych, a następnie samodzielnie ponownie nadać przesyłkę.
- Wygasły uprawnienia dostępowe do API przewoźnika – w przypadku pojawienia się takiego komunikatu, po ponownym skonfigurowaniu dostępu dla aplikacji w zakładce [Nowe] Integracje kurierskie, list przewozowy zostanie wygenerowany od razu po udanej autoryzacji konta.
Na karcie zamówienia zobaczysz wybrany automatycznie do zamówienia szablon nadania.
Widok formularza listu przewozowego:
Możliwość generowania przesyłek w integracji Geodis:
1. Ręczne generowanie przesyłek.- Możesz generować listy przewozowe bezpośrednio z poziomu karty zamówienia lub zakładki [Nowe] Menadżer wysyłek.
- Na karcie zamówienia widoczny jest przypisany szablon nadania, który został automatycznie dobrany na podstawie ustawionych reguł lub wybrany ręcznie.
- Wystarczy kliknąć, aby wygenerować, a następnie wydrukować etykietę.
- List przewozowy możesz wygenerować z poziomu zakładki Zamówienia ⇨ [Nowe] Menadżer wysyłek, klikając Wygeneruj list przewozowy.
Wpisz ID zamówienia i kliknij Przejdź.
Zostaniesz przekierowany do nowego formularza listu przewozowego.
- List przewozowy możesz wygenerować również z poziomu Zamówienia ⇨ Zamówienia, edytuj wybrane zamówienie i kliknij ikonę ołówka.
Kliknij ikonę ciężarówki, by wygenerować list przewozowy z nowych szablonów nadania.
Wypełnij dane i wygeneruj etykietę lub przejdź do pełnego formularza listu przewozowego:
2. Masowe generowanie z poziomu listy zamówień.
- Możesz zbiorowo generować listy przewozowe z poziomu listy zamówień.
- Wybierasz wiele zamówień jednocześnie i uruchamiasz proces generowania przesyłek, co oszczędza czas przy obsłudze dużej liczby zamówień.
Przejdź do zakładki Zamówienia ⇨ Zamówienia, zaznacz dane zamówienia lub kilka zamówień i kliknij ikonę samochodu dostawczego.
Zaznacz odpowiednie pola i kliknij Zapisz, by zlecić generowanie listu przewozowego:
Wygenerowane listy możesz sprawdzić, klikając Wygenerowane dokumenty:
3. Automatyczne generowanie poprzez akcję automatyczną.
- Możesz skonfigurować akcje automatyczne w Sellasist, które pozwalają na automatyczne generowanie listów przewozowych w określonych warunkach.
- Dla integracji z [Nowe] Integracje kurierskie stworzyliśmy nowe warunki i efekty w Administracja ⇨ Automatyzacja.
- Wprowadzono nowe zdarzenie: List przewozowy (działa tylko, gdy dokument jest gotowy do wydruku)/ nie został pobrany.
- Proces generowania i pobierania listu przewozowego został rozbity. Dlatego należy utworzyć dwie oddzielne akcje:
- Utwórz akcje z efektem "Wygeneruj list przewozowy”.- Utwórz akcję z warunkiem "Zdarzenie: list przewozowy”, co umożliwi np. wydrukowanie listu.
Warunki wpływające na moduł Geodis:
List przewozowy
- Zdarzenie: List przewozowy – Warunek napisany specjalnie pod nowy moduł integracji kurierskich.
- Dowolny list został pobrany – Zadziała on dopiero gdy list przewozowy będzie gotowy do wydruku.
- Żaden list nie został pobrany – Zadziała, gdy żaden list przewozowy nie zostanie pobrany dla danego zamówienia.
Status wysyłki
- Zdarzenie: Przesyłka zmieniła status dostawy – Warunek napisany specjalnie pod nowy moduł integracji kurierskich. Możesz wybrać, czy automatyzacja ma sprawdzać status we wszystkich paczkach przypisanych do zamówienia czy też nie. Automatyzacja pomija sprawdzanie paczek, w których wystąpiły błędy.
Zmapowaliśmy wszystkie 9 statusów, obok podaliśmy częstotliwość synchronizacji:
Oczekuje na nadanie — przesyłka została przygotowana przez nadawcę, oczekuje na nadanie. Sprawdzamy status co 15 minut.W transporcie — status obejmuje zdarzenia takie jak: nadanie przesyłki w punkcie, odebranie jej przez kuriera, przyjęcie na sortownie, przekierowanie do innego punktu. Aktualizujemy status co 3 godziny.Wydano do doręczenia — w trakcie doręczenia przez kuriera (na adres odbiorcy lub do punktu odbioru). Sprawdzamy status co 30 minut.Oczekuje na odbiór w punkcie — przesyłka oczekuje na odbiór w punkcie przez klienta końcowego. Sprawdzamy status co 30 minut.Wystawiono awizo — kurier wystawił awizo, przesyłka będzie do odbioru pod adresem podanym na awizo. Sprawdzamy status co 30 minut.Wystąpił problem z przesyłką — status obejmuje zdarzenia takie jak: odmowa przyjęcia przesyłki, zagubienie przesyłki. Aktualizujemy status co 3 godziny.Dostarczono — przesyłka została doręczona do odbiorcy lub odebrana z punktu odbioru.Zwrócono — przesyłka została zwrócona do nadawcy.Anulowano
Efekty wpływające na moduł Geodis:
Wygeneruj list przewozowy dla [Nowe] Integracje kurierskieWarunek napisany specjalnie pod nowy moduł integracji kurierskich. Próba generowania będzie ponawiała się samoistnie do momentu wygenerowania listu, po spełnieniu określonych warunków i naprawianie ewentualnych błędów.
Drukuj przez Sellasist Cloud PrintNależy wybrać z listy efekt "Drukuj list przewozowy z [Nowe] Integracje kurierskie”, zamiast "Drukuj list przewozowy”, aby zadziałała ona z integracją Geodis.
Pamiętaj: Aby procesy automatyzacji przebiegały pomyślnie utwórz najpierw akcję automatyczną z efektem "Wygeneruj list przewozowy dla [Nowe] integracje kurierskie”, a następnie utwórz nową akcje automatyczną z warunkiem "Zdarzenie: list przewozowy został pobrany”, co umożliwi np. wydrukowanie listu.
Zmień sposób wysyłkiW nowym module integracji kurierskich obecnie nie tworzymy metod dostawy, a więc nie będą one widoczne w tym efekcie. Jeśli chcemy użyć innego kuriera Geodis, niż ten którego wybrał klient w zamówieniu Geodis, to należy odpowiednio skonfigurować "Reguły doboru szablonów nadania” w nowym module Geodis.
Aktywatory szablonu nadania (kod kreskowy).
Każdy szablon nadania generuje unikalny kod kreskowy, który można
- pobrać i wydrukować,- skanować podczas pakowania w celu aktywacji szablonu nadania.
Funkcja aktywatora kodu kreskowego przyspiesza proces obsługi zamówień w magazynie, eliminując konieczność ręcznego wyszukiwania i przypisywania szablonów.
Aby aktywatory pokazywały się w WMS przejdź do Magazyn ⇨ Ustawienia WMS ⇨ Tryb pakowania i zaznacz "Wymuś zeskanowanie aktywatora”.
Zaznacz nową metodę, które zostanie wyświetlona w konfiguracji "Wymuś zeskanowanie aktywatora szablonów nadania tylko dla wybranych metod dostaw”, aby nowa metoda Geodis pojawiła się w Trybie pakowania.
Mapowanie metod dostaw
System automatycznie mapuje przesyłki nadane za pomocą integracji Geodis, dzięki czemu ręczne mapowanie nie jest już konieczne. Nie musisz więc tworzyć metod dostaw w sekcji Integracje → Metody dostawy ani ich mapować w zakładce Integracje → Geodis. Jeśli jednak chcesz wprowadzić dodatkową automatyzację, możesz wykorzystać tę funkcję, np. aby zmienić przewoźnika i wysyłać zamówienia pierwotnie przypisane do kuriera DPD za pomocą InPostu na własnej umowie.
Dla większej wygody i efektywności rekomendujemy jednak dokonywanie takich zmian w nowych formularzach Reguły doboru szablonu nadania. Dzięki temu proces konfiguracji będzie bardziej przejrzysty i spójny.
Jak włączyć używanie mapowania?
1. Przejdź do zakładki Integracje ⇨ [Nowe] Integracje kurierskie i kliknij ikonę klucza.
2. Zaznacz checkbox Używaj mapowania.
UWAGA!Funkcja ta zostanie włączona dla wszystkich kont 1 czerwca 2025 domyślnie.
