Jak połączyć sklep z GLS

Połączenie sklepu internetowego z GLS pozwala skrócić czas realizacji zamówień, ograniczyć błędy w adresach i zapewnić klientom przejrzyste informacje o statusie przesyłek. Poniższa instrukcja prowadzi krok po kroku: od wyboru metody, przez przygotowanie danych i uprawnień, po uruchomienie wysyłek w produkcji. Znajdziesz tu procedury dla gotowych modułów e‑commerce, a także wskazówki do własnego wdrożenia na bazie usług przewoźnika. Dzięki temu szybciej zautomatyzujesz wysyłkę i obsługę dostaw.

Wymagania i przygotowanie

Sprawdzenie umowy z GLS i identyfikatorów nadawcy

Zanim zaczniesz, upewnij się, że posiadasz aktywną umowę z GLS właściwą dla Twojego kraju działalności. Pod ręką przygotuj identyfikatory nadawcy (np. numer klienta, kod nadawcy), dane adresowe punktu nadania oraz zakres dostępnych usług: doręczenia krajowe i międzynarodowe, doręczenie do punktów odbioru, ubezpieczenie, pobranie, doręczenia w soboty (jeśli dostępne). To przyspieszy późniejszą konfiguracja i ograniczy liczbę zmian w ostatniej chwili.

Warto już teraz potwierdzić, czy będziesz drukować etykiety w formacie A6 (ZPL/EPL/PNG/PDF), czy A4, oraz czy planujesz nadawać paczki z jednego magazynu, czy wielu lokalizacji. Od tego zależy struktura kont i uprawnień oraz sposób mapowania magazynów w Twoim systemie sprzedażowym.

Wybór metody połączenia

Masz trzy główne ścieżki:

• Gotowa integracja modułem sklepowym – idealna, gdy działasz na WooCommerce, PrestaShop, Shopify lub innym popularnym silniku. Warto wybrać rozwiązanie, które obsługuje generowanie etykiet, automatyczne numery śledzenia i batching nadawczy (zbiorcze manifesty).
• Integrator pośredni (np. system do zarządzania wysyłkami) – pozwala łączyć wielu przewoźników, konfigurować reguły wyboru przewoźnika wg wagi, kraju i ceny, a dodatkowo udostępnia centralny panel pick & pack.
• Własne wdrożenie przez API przewoźnika – daje największą elastyczność, wymaga jednak pracy deweloperskiej i testów akceptacyjnych.

Dane dostępowe i bezpieczeństwo

Po ustaleniu metody uzyskaj dane logowania (login, klucz, ewentualnie certyfikaty) oraz adresy środowisk testowego i produkcyjnego. Ustal z opiekunem handlowym i działem technicznym GLS wymagane zakresy IP (jeśli jest konieczny whitelisting), politykę odświeżania tokenów oraz limity zapytań. Zadbaj o bezpieczne przechowywanie sekretów: menedżer haseł, zmienne środowiskowe lub sejf tajemnic w chmurze.

Integracja przez moduł sklepu

Instalacja i wstępne ustawienia

Jeśli korzystasz z popularnych platform e‑commerce, najkrótszą drogą jest wtyczka GLS lub rozwiązanie partnerskie. Zainstaluj je z oficjalnego marketplace’u Twojej platformy. Sprawdź zgodność wersji modułu z wersją sklepu oraz listę obsługiwanych funkcji: etykiety, manifest, punkty odbioru, pobranie, nadania wielopaczkowe, automatyczne tworzenie przesyłki przy zmianie statusu zamówienia.

W sekcji ustawień wprowadź dane konta GLS, wybierz środowisko “sandbox/test” i zapisz konfigurację. Zazwyczaj moduł pozwala wskazać magazyn nadawczy, domyślne wymiary paczek i domyślny rodzaj usługi, a także włączyć wysyłkę maili/SMS do klientów (jeśli wspierana).

Mapowanie metod dostawy i reguł cenowych

Skonfiguruj metody dostawy widoczne w koszyku: doręczenie kurierem do domu, doręczenie do punktu odbioru/ParcelShop oraz – jeśli dostępne – doręczenie ekspresowe. Przypisz do każdej metody odpowiedni produkt przewoźnika i reguły kosztowe: darmowa wysyłka od określonej kwoty, dopłaty za gabaryt, strefy geograficzne.

Jeśli oferujesz pobranie, sprawdź, czy moduł automatycznie oznacza przesyłkę jako COD i przekazuje kwotę do pobrania. Zweryfikuj, jak wtyczka obsługuje waluty (PLN/EUR) oraz czy umożliwia blokadę pobrania dla krajów, w których usługa nie jest dostępna.

Obsługa punktów odbioru

Włącz listę punktów odbioru na stronie koszyka lub checkoutu. Dobra praktyka to filtrowanie po kodzie pocztowym i ograniczanie liczby wyników do najbliższych lokalizacji. Pamiętaj o zapisie ID wybranego punktu w metadanych zamówienia – będzie potrzebny przy generowaniu przesyłki.

Druk i manifest

Po opłaceniu zamówienia lub zmianie statusu na “Gotowe do wysyłki” uruchamiaj tworzenie przesyłki w GLS i generowanie plików etykiet. Wydruk etykiety A6 ułatwia klejenie bezpośrednio na kartonie. Zbiorczy manifest (raport nadawczy) wygeneruj na koniec dnia – kurier potwierdzi odbiór podpisem.

Integracja bezpośrednia przez API

Modele komunikacji i autoryzacja

Wdrożenie własne daje pełną kontrolę nad przepływami, ale wymaga dobrego zaprojektowania. Zacznij od lektury dokumentacji usług GLS właściwej dla Twojego kraju (naming i zakres endpointów mogą się nieznacznie różnić). Najczęściej dostępne są interfejsy REST lub SOAP do tworzenia przesyłek, drukowania etykiet, pobierania manifestów i śledzenia.

Skonfiguruj mechanizm pozyskiwania tokenów i obsługę odświeżania. Użyj bezpiecznego przechowywania sekretów i ustanów rotację kluczy. W logach nie rejestruj pełnych tokenów, a jedynie skróty lub ostatnie znaki. Pamiętaj, że poprawna autoryzacja i wersjonowanie zapytań ułatwią przyszłe aktualizacje.

Tworzenie przesyłki i reguły walidacji

Podczas tworzenia przesyłki przekaż dane nadawcy, odbiorcy, wagę, wymiary oraz opcje usługi (np. POD, ubezpieczenie, pobranie, punkt odbioru). Zaimplementuj walidacje: brak znaków specjalnych w polach nazw, długość ulicy, dopuszczalne kody krajów i ISO, zakres wagowy. Jeśli system sklepu przechowuje różne adresy (fakturowy i dostawy), jawnie wybierz właściwy do wysyłki.

Dobra praktyka to mechanizm retry z kontrolą idempotencji. Do każdego zlecenia przypisz unikalny identyfikator referencyjny z Twojego systemu – jeśli sieć zawiedzie, ponowne wywołanie nie utworzy duplikatu. Reaguj na kody błędów specyficzne dla usług (np. niedozwolony gabaryt w doręczeniu do punktu).

Generowanie i pobieranie etykiet

Po pomyślnym utworzeniu przesyłki pobierz i zapisz plik etykiety w zadanym formacie. Wdrażając druk, wybierz format zgodny z drukarką magazynową: ZPL/EPL dla termicznych, PDF/PNG dla druków na zwykłym papierze. Zadbaj o prawidłowe DPI i marginesy – niewłaściwy scaling prowadzi do problemów ze skanowaniem kodów kreskowych.

Przy przesyłkach wielopaczkowych numeruj paczki i przechowuj komplet plików. Możesz stworzyć mechanizm łączenia wielu etykiet w jeden plik PDF, co przyspieszy druk z kolektora lub stanowiska pakowania. Dla integracji systemu WMS rozważ bezpośrednie przesyłanie etykiet do kolejki drukowania.

Obsługa śledzenia i powiadomień

Numer przesyłki zapisuj w zamówieniu i udostępniaj klientowi w panelu oraz w e‑mailu po wysyłce. System powinien okresowo odpytywać o statusy lub – jeśli dostępne – nasłuchiwać pushowych powiadomień. W jednym miejscu mapuj statusy GLS do statusów sklepu, aby zespół wsparcia i klienci mieli spójny obraz. Sprawdź SLA aktualizacji, by nie generować zbędnych zapytań.

Jeśli dokumentacja przewoźnika udostępnia mechanizm zwrotnych powiadomień, włącz i zabezpiecz webhooki podpisem lub tajnym nagłówkiem. Wprowadź kolejkowanie zdarzeń i ponawianie w razie niepowodzenia – pozwoli to uniknąć utraty informacji o doręczeniu czy zwrocie do nadawcy.

Usługi dodatkowe: pobranie, zwroty, punkt odbioru

Dla pobrania pamiętaj o poprawnym przekazaniu waluty i kwoty. Zaimplementuj weryfikację, że metoda płatności klienta i wybrane doręczenie pozwalają na COD. W przypadku punktów odbioru zapisuj identyfikator punktu otrzymany z widgetu wyszukiwarki lub listy i przekazuj go przy tworzeniu przesyłki. Procedury zwrotów możesz oprzeć na pre‑etykietach w paczce lub na portalu zwrotów – obie ścieżki wymagają uprzedniej konfiguracji z GLS.

Odporność i limity

Zaimplementuj ograniczanie wywołań (rate limiting) oraz rozkładanie ruchu w czasie przy masowych akcjach (np. cykliczne generowanie manifestów). Błędy sieciowe obsługuj przez exponential backoff. Krytyczne operacje (tworzenie przesyłki, druk etykiety) idempotentnie powiąż z identyfikatorem zamówienia i numerem przesyłki przewoźnika.

Testy, wydruki i przejście na produkcję

Scenariusze walidacyjne i dane testowe

Na środowisku testowym odtwórz pełny cykl: złożenie zamówienia, wygenerowanie przesyłki, pobranie etykiety, zmiana statusów aż do doręczenia i ewentualnego zwrotu. Przetestuj różne warianty: paczki lekkie i ciężkie, doręczenie do domu i do punktu, krajowe i zagraniczne, z pobraniem i bez. Udokumentuj rozbieżności między sandboxem a produkcją.

W raportach wdrożeniowych odnotuj wersje pluginów, konfiguracje i hash commitów – ułatwi to odtworzenie stanu w razie incydentu. Dzięki takim rejestrom Twoje testy staną się powtarzalne i przejrzyste dla zespołu oraz partnera logistycznego.

Drukarki, formaty i jakość etykiet

W magazynie sprawdź poprawność wydruku: kontrast czerni, ostrość kodów, trwałość naklejek oraz odporność na tarcie. Dla ZPL/EPL wybierz właściwy sterownik i szerokość nośnika. Unikaj skalowania w przeglądarce – drukuj z natywnych aplikacji lub przez dedykowany spooling. Przy wydruku na A4 upewnij się, że kody kreskowe mają zalecane rozmiary.

Manifesty i odbiory

Na koniec zmiany wygeneruj manifest dzienny i przygotuj raport dla kuriera. Uzgodnij porę odbioru i ewentualne okna czasowe. Jeśli masz kilka lokalizacji, wypracuj standard nazewnictwa manifestów i kolejek kurierskich, aby uniknąć pomyłek w rozdziale przesyłek.

Uruchomienie produkcyjne

Po pozytywnych testach poproś o dostęp do produkcji i przełącz klucze. W pierwszych dniach zwiększ poziom logowania i monitorowania. Ustal plan awaryjny: procedura ręcznego tworzenia przesyłek w panelu GLS, zapasowe drukarki, oraz osoby kontaktowe po stronie przewoźnika i Twojego zespołu.

Utrzymanie, skalowanie i zgodność

Monitorowanie i alerty operacyjne

Włącz metryki: czas tworzenia przesyłki, czas do pobrania etykiety, odsetek błędów, poziom retransmisji, czas propagacji statusów oraz liczbę otwartych zamówień gotowych do wysyłki. Zbuduj dashboard i alerty progowe. Automatycznie wykrywaj anomalia, np. nagły wzrost błędów adresowych w konkretnej strefie.

Optymalizacja kosztów i reguły wyboru usług

Wprowadź reguły doboru usługi względem gabarytu, kraju i SLA. Zadbaj o poprawne przeliczanie wymiarów i wag wolumetrycznych. Analizuj raporty nadawcze i noty obciążeniowe, aby wykrywać niedoszacowania wagi. Regularnie przeglądaj oferty i dopłaty (wyspy, strefy górskie, obszary trudno dostępne) i koryguj cenniki w koszyku.

RODO i ochrona danych

Przetwarzając dane odbiorców, zadbaj o minimalizację zakresu – przekazuj tylko to, co konieczne do realizacji doręczenia. Szyfruj kanał komunikacji (TLS), ogranicz dostęp do logów i anonimizuj dane w środowiskach testowych. Przechowuj dzienniki zgodnie z polityką retencji i wymogami Twojej branży.

Obsługa pików sprzedażowych

Przed dużymi kampaniami (święta, Black Friday) wykonaj testy wydajnościowe procesu pakowania i generowania dokumentów. Zaplanuj wzmocnienie personelu magazynowego, rezerwowe sloty kurierskie i bufor materiałów eksploatacyjnych (etykiety, taśmy). Monitoruj czas kompletacji i reaguj na wąskie gardła – często to druk lub przydział kurierów ogranicza przepustowość.

Współpraca z zespołami i szkolenia

Przeszkol obsługę magazynu z procesu skanowania, klejenia etykiet, zamykania manifestów i procedur wyjątkowych (błędna etykieta, podmiana paczki). Zbuduj playbook dla wsparcia klienta: jak interpretować statusy, jak eskalować niedoręczenia i jak tworzyć zlecenia zwrotne. Zadania i komunikację planuj w narzędziu ticketowym – pozwoli to kontrolować SLA.

Wskazówki praktyczne i dobre praktyki

Standaryzacja danych i automatyzacja

Wprowadź normalizację adresów (rozbijanie ulicy i numeru, walidacja kodów pocztowych) już na etapie checkoutu. Automatyzuj wybór najlepszego rodzaju doręczenia w oparciu o wagi i wymiary. Włącz walidację telefonu i e‑maila, aby poprawić skuteczność powiadomień o statusie i doręczeniu.

Łączenie z innymi systemami

Jeśli używasz ERP/WMS, zsynchronizuj statusy zamówień i przesyłek. Po wygenerowaniu paczki zapisz numer śledzenia w ERP i przekaż go do faktury/paragonu. Dla systemów marketplace’owych skonfiguruj automatyczne uzupełnianie numeru przesyłki i zmianę statusu “wysłano”.

Kontrola jakości i audyt

Co tydzień wykonuj próbki losowe: porównuj wagi zadeklarowane i ważone, analizuj odsetek paczek niedoręczonych w pierwszej próbie, sprawdzaj błędne adresy i ich źródła. Takie audyty szybko ujawnią problemy w procesie pakowania lub wpisywania danych przez klientów.

Komunikacja z klientem

W szablonach powiadomień dołącz przewidywany czas doręczenia i link do śledzenia. Jasno informuj o warunkach doręczenia do punktu: czas przechowywania, wymagane dokumenty. Dzięki temu ograniczysz liczbę zapytań do biura obsługi i poprawisz wskaźnik doręczeń w pierwszej próbie.

Lista kontrolna do uruchomienia

• Umowa i identyfikatory nadawcy – potwierdzone i aktywne.
• Wybrana metoda: moduł, integrator lub własne API.
• Dane dostępowe i IP – skonfigurowane, połączenie testowe potwierdzone.
• Mapowanie metod dostawy w koszyku – przetestowane.
• Generowanie etykiety A6/A4 – działa na drukarkach docelowych.
• Tworzenie nadania z poprawnymi walidacjami – potwierdzone.
• Śledzenie i tracking – linki trafiają do klienta.
• Powiadomienia i webhooki – zabezpieczone i kolejkowane.
• Procedury awaryjne – opisane i znane zespołowi.
• Dokumentacja i plan rozwoju – gotowe.

Na koniec pamiętaj: sukces wdrożenia to nie jednorazowy projekt, lecz stałe doskonalenie. Niezależnie od tego, czy wybrałeś szybkie rozwiązanie modułowe, czy własną, głęboką integracja, dbaj o aktualność dokumentacji przewoźnika, testy regresyjne po każdej aktualizacji i bliską współpracę z operacjami magazynowymi. To gwarant stabilnych wysyłek i zadowolenia klientów.