BaseLinker: etykiety przesyłek i integracje z kurierami

Gdy etykieta przesyłki nie tworzy się poprawnie

Jednym z częstszych problemów w BaseLinker jest brak możliwości wygenerowania etykiety przewozowej albo dokument z błędnymi danymi. Zamówienie może być widoczne w systemie, ale przy próbie utworzenia etykiety pojawia się komunikat o braku usługi, niepełnym adresie lub nieprawidłowych danych odbiorcy.

Najpierw sprawdzana jest konfiguracja przewoźnika oraz połączenie z jego systemem. Następnie analizowane są dane zamówienia, metoda dostawy i mapowanie pól. Mapowanie, czyli przypisanie informacji z jednego systemu do odpowiednich pól w drugim, decyduje między innymi o tym, skąd pobierany jest adres, numer telefonu lub wybrany rodzaj przesyłki.

Problem może wynikać również z braku aktywnej usługi po stronie przewoźnika. W BaseLinkerze może być widoczna metoda dostawy, która nie odpowiada już usłudze dostępnej na koncie przewozowym. Sama zmiana nazwy metody nie naprawia takiego połączenia, ponieważ system korzysta z identyfikatora usługi, a nie tylko z jej opisu.

Jak uporządkowana jest integracja z przewoźnikiem

Integracja z kurierem to połączenie BaseLinkera z zewnętrznym systemem przewozowym. Służy ono do przekazywania danych przesyłki, pobierania numeru listu przewozowego, generowania etykiety oraz odbierania informacji o zmianie statusu.

Podczas konfiguracji sprawdzane są dane dostępowe, identyfikatory kont, środowisko testowe lub produkcyjne oraz zakres uprawnień. Uprawnienia API, czyli zezwolenia na automatyczną komunikację między programami, muszą umożliwiać wykonanie operacji potrzebnych do obsługi zamówień. Samo zalogowanie do panelu przewoźnika nie zawsze oznacza, że integracja API działa prawidłowo.

Ważne jest także rozdzielenie kilku elementów. Metoda dostawy w sklepie, usługa przewoźnika, sposób pobrania opłaty i format etykiety mogą być osobnymi ustawieniami. Ich przypadkowe połączenie prowadzi do sytuacji, w której zamówienie trafia do BaseLinkera, ale nie może zostać przekazane dalej.

Konfiguracja metod dostawy bez pomijania szczegółów

Konfiguracja metod dostawy powinna zaczynać się od ustalenia, jakie warianty faktycznie są używane. Inaczej ustawiana jest przesyłka kurierska, inaczej paczkomat, odbiór osobisty albo przesyłka wymagająca pobrania. Każda metoda może mieć własne wymagania dotyczące wymiarów, masy, adresu lub punktu odbioru.

Sprawdzane są nazwy metod importowanych ze sklepu i ich odpowiedniki w BaseLinkerze. Import, czyli pobranie danych z jednego systemu do drugiego, nie zawsze zachowuje logiczne powiązanie z usługą kurierską. Po zmianie nazwy lub dodaniu nowej metody dostawy trzeba zweryfikować, czy zamówienia nadal są kierowane do właściwego przewoźnika.

Istotne jest też określenie domyślnego rodzaju przesyłki. Gdy w zamówieniu brakuje wymiarów lub masy, system może próbować użyć wartości pustych albo przyjąć ustawienie domyślne. Taki mechanizm bywa przydatny, ale nie powinien zastępować kontroli danych, szczególnie przy przesyłkach o ograniczeniach gabarytowych.

Dlaczego etykieta zawiera błędny adres lub odbiorcę

Błędny adres na etykiecie najczęściej wynika z nieprawidłowego mapowania pól albo z niespójnych danych zapisanych w sklepie. Ulica, numer budynku, kod pocztowy i miejscowość mogą być zapisane w jednym polu, mimo że przewoźnik oczekuje ich osobno. Czasem problem powoduje także nietypowy znak, brak numeru lokalu lub niepełna nazwa firmy.

Analizowana jest ścieżka danych od źródła zamówienia do etykiety. Sprawdzane są pola klienta, dane dostawy, adres fakturowy i adres wysyłki. Adres fakturowy służy do rozliczeń, natomiast adres wysyłki wskazuje miejsce doręczenia. Pomylenie tych wartości może skutkować wygenerowaniem dokumentu z adresem, który nie powinien być użyty przez kuriera.

Weryfikowane są również dane odbioru z punktu lub automatu. W takich przypadkach adres punktu nie jest zwykłym adresem klienta. Zwykle potrzebny jest dodatkowy identyfikator punktu, czyli jednoznaczny kod miejsca odbioru. Jego brak może uniemożliwić utworzenie etykiety mimo poprawnego imienia i nazwiska.

Statusy przesyłek nie zmieniają się automatycznie

Aktualizacja statusów pozwala sprawdzić, czy przesyłka została przygotowana, odebrana, przekazana do doręczenia lub dostarczona. Jeżeli status pozostaje bez zmian, przyczyną może być brak poprawnej komunikacji między BaseLinkerem a systemem przewoźnika.

Sprawdzany jest numer przesyłki oraz jego format. Numer listu przewozowego, czyli identyfikator służący do śledzenia paczki, musi zostać zapisany w odpowiednim polu. Jeżeli został wpisany ręcznie, zawiera spację albo pochodzi z innego przewoźnika, automatyczne pobieranie statusu może nie zadziałać.

Znaczenie ma także częstotliwość odpytywania systemu przewoźnika. Odpytywanie, czyli cykliczne sprawdzanie, czy pojawiły się nowe dane, nie musi odbywać się natychmiast po każdej zmianie. Dlatego pojedyncze opóźnienie nie zawsze oznacza awarię. Jeżeli status nie zmienia się przez dłuższy czas, analizowane są logi komunikacji, czyli zapisy operacji wykonywanych między systemami.

Automatyczne akcje po utworzeniu przesyłki

BaseLinker może wykonywać akcje automatyczne, na przykład zmieniać status zamówienia po wygenerowaniu etykiety, wysyłać wiadomość z numerem przesyłki albo przekazywać zamówienie do kolejnego etapu obsługi. Automatyzacja oznacza wykonanie określonej czynności na podstawie zdefiniowanego warunku.

Problemy pojawiają się wtedy, gdy warunek jest zbyt ogólny. Reguła może reagować na samą zmianę statusu, mimo że nie sprawdza, czy etykieta została rzeczywiście utworzona. W efekcie zamówienie otrzymuje status gotowego do wysyłki, choć dokument przewozowy nie istnieje.

Sprawdzane są kolejność reguł, ich warunki i działania. Jeżeli kilka automatyzacji reaguje na to samo zdarzenie, późniejsza akcja może nadpisać wcześniejszy status. Weryfikowane są też wyjątki, czyli sytuacje wyłączone z działania reguły, na przykład przesyłki pobraniowe albo zamówienia wymagające ręcznej kontroli.

Integracja z marketplace i systemem ERP

BaseLinker często pośredniczy między sklepem, marketplace, przewoźnikiem i systemem ERP. Marketplace to platforma sprzedażowa, na której oferty i zamówienia pochodzą od wielu sprzedawców. ERP, czyli system do zarządzania procesami firmy, może odpowiadać za magazyn, dokumenty sprzedaży i stany produktów.

W takim układzie dane o dostawie mogą pojawiać się w kilku miejscach. Zamówienie przychodzi z marketplace, metoda dostawy jest interpretowana przez BaseLinkera, a dokument lub status może być przekazany do ERP. Jeżeli każde połączenie używa innego oznaczenia metody dostawy, etykieta może nie utworzyć się albo zostać przypisana do niewłaściwego procesu.

Konfiguracja obejmuje sprawdzenie kierunku synchronizacji. Synchronizacja, czyli uzgadnianie danych między systemami, może działać w jedną albo w obie strony. Ważne jest ustalenie, który system jest źródłem prawdy dla adresu, statusu, numeru przesyłki i danych magazynowych. Bez tego automatyczne nadpisywanie informacji może usuwać poprawne dane.

Najczęstsze komunikaty o błędach i ich znaczenie

Komunikat o braku autoryzacji zwykle oznacza nieprawidłowy klucz API, wygasłe dane dostępowe albo brak odpowiednich uprawnień. Klucz API to ciąg znaków pozwalający jednemu systemowi rozpoznać i obsłużyć drugie połączenie. Nie powinien być zmieniany bez sprawdzenia, które integracje z niego korzystają.

Błąd walidacji danych oznacza, że przekazane informacje nie spełniają wymagań przewoźnika. Walidacja, czyli sprawdzenie poprawności danych przed wykonaniem operacji, może odrzucić nieprawidłowy kod pocztowy, brak numeru telefonu albo niedopuszczalny format masy.

Komunikat o niedostępnej usłudze może dotyczyć wybranego rodzaju przesyłki, a nie całej integracji. W takim przypadku inne metody dostawy mogą działać prawidłowo. Rozróżnienie błędu ogólnego od błędu pojedynczej usługi ogranicza ryzyko niepotrzebnej zmiany całej konfiguracji.

Co można sprawdzić samodzielnie przed zmianą ustawień

Przed ingerencją w konfigurację warto sprawdzić, czy problem dotyczy jednego zamówienia, jednej metody dostawy czy wszystkich przesyłek. Należy porównać poprawne i niepoprawne zamówienie, zwracając uwagę na adres, masę, numer telefonu, pobranie oraz wybrany punkt odbioru.

Można także sprawdzić, czy numer przesyłki został zapisany w zamówieniu i czy odpowiada właściwemu przewoźnikowi. Przydatne jest zachowanie dokładnego komunikatu błędu oraz momentu jego wystąpienia. Takie informacje ułatwiają odtworzenie problemu bez wielokrotnego generowania etykiet.

Nie należy wielokrotnie klikać przycisku tworzenia etykiety, jeżeli nie wiadomo, czy pierwsza próba została wykonana. W niektórych systemach może powstać kilka przesyłek albo kilka numerów przewozowych. Nie powinno się również usuwać historii zamówienia, zmieniać identyfikatorów integracji ani resetować wszystkich statusów bez kopii ustawień.

Błędy popełniane przy samodzielnej naprawie integracji

Częstym błędem jest poprawianie samej nazwy metody dostawy bez sprawdzenia jej identyfikatora. Nazwa widoczna w panelu może wyglądać prawidłowo, ale nadal wskazywać nieaktywną usługę. Innym problemem jest kopiowanie ustawień z innego konta bez weryfikacji danych dostępowych i zakresu uprawnień.

Zdarza się także wyłączanie automatyzacji w całości, gdy problem dotyczy tylko jednej reguły. Może to zatrzymać wysyłanie powiadomień albo aktualizację innych zamówień. Bezpieczniej jest najpierw ustalić, która reguła zadziałała i jakie dane otrzymała.

Ryzykowne jest ręczne zmienianie statusu na „wysłane” przed utworzeniem etykiety. Status powinien odzwierciedlać rzeczywisty etap realizacji. W przeciwnym razie system może wysłać klientowi informację o nadaniu, mimo że paczka nie została przekazana przewoźnikowi.

Kiedy problem nie dotyczy BaseLinkera

Nie każda niedziałająca etykieta oznacza błąd konfiguracji BaseLinkera. Przyczyną może być chwilowa niedostępność systemu przewoźnika, blokada konta, nieaktywna umowa albo ograniczenie usługi po stronie operatora. Jeżeli poprawnie skonfigurowane zamówienia różnych użytkowników przestają działać w tym samym czasie, warto brać pod uwagę problem zewnętrzny.

Brak statusu może wynikać z opóźnienia w systemie śledzenia, a nie z błędu integracji. Jeżeli numer przesyłki działa na stronie przewoźnika, ale status w BaseLinkerze pojawia się później, komunikacja może być poprawna, lecz dane nie zostały jeszcze przekazane.

Błędna masa lub gabaryt mogą pochodzić z danych produktu, a nie z ustawień kuriera. Z kolei nieprawidłowa wiadomość e-mail może być wynikiem konfiguracji sklepu albo systemu mailingowego. Rozdzielenie tych obszarów jest ważne, ponieważ zmiana integracji przewozowej nie naprawi problemu z katalogiem produktów lub wysyłką wiadomości.

Jak przebiega konfiguracja i diagnostyka

Prace zaczynają się od zebrania informacji o źródle zamówień, używanych metodach dostawy, przewoźnikach oraz miejscu, w którym pojawia się błąd. Następnie wykonywana jest kontrola połączeń, danych dostępowych, mapowania pól i reguł automatycznych.

W razie potrzeby analizowane są logi, czyli zapisy komunikacji i błędów, oraz testowe zamówienie z podobnymi danymi. Test powinien obejmować nie tylko utworzenie etykiety, ale też zapis numeru przesyłki, zmianę statusu i przekazanie informacji do sklepu lub ERP.

Po wprowadzeniu zmian sprawdzane są różne warianty: zwykła przesyłka, pobranie, punkt odbioru i zamówienie z nietypowymi danymi. Pozwala to wykryć sytuację, w której poprawiono jeden scenariusz, ale uszkodzono inny. W przypadku napraw sprzętowych obowiązuje z reguły termin do 3 dni, a przyspieszanie i czyszczenie może być wykonane do 24 godzin. Sama konfiguracja BaseLinkera zależy od liczby integracji, zakresu automatyzacji i dostępności danych do testów, dlatego nie jest objęta stałym czasem realizacji.

Pytania o etykiety i integracje BaseLinkera

Czy można używać kilku przewoźników w jednym BaseLinkerze? Tak, jeżeli każdy przewoźnik ma poprawnie skonfigurowane połączenie, usługi i mapowanie metod dostawy. Warto rozdzielić automatyzacje, aby zmiana statusu jednej grupy przesyłek nie uruchamiała reguł przeznaczonych dla innego operatora.

Czy zmiana nazwy kuriera naprawi błędną etykietę? Zwykle nie. Nazwa jest informacją opisową, natomiast decydujące znaczenie mają identyfikator usługi, dane konta i przypisanie metody dostawy. Zmiana nazwy może jedynie ułatwić rozpoznanie ustawienia w panelu.

Czy ręczne wpisanie numeru przesyłki wystarczy do aktualizacji statusu? Tylko wtedy, gdy numer ma właściwy format i jest zapisany w polu obsługiwanym przez daną integrację. Niektóre połączenia wymagają także określenia przewoźnika lub usługi, aby rozpocząć śledzenie.

Czy można bezpiecznie usunąć starą integrację? Przed usunięciem trzeba sprawdzić, czy nie korzystają z niej automatyzacje, stare zamówienia lub inne kanały sprzedaży. Bezpieczniejsza jest wcześniejsza dezaktywacja i test nowego połączenia, ponieważ usunięcie może utrudnić obsługę historycznych danych.

Podsumowanie konfiguracji kurierów

Sprawna obsługa etykiet w BaseLinkerze wymaga zgodności kilku elementów: danych zamówienia, metody dostawy, usługi przewoźnika, uprawnień API, mapowania pól i automatyzacji statusów. Najskuteczniejsza diagnostyka zaczyna się od ustalenia, na którym etapie przepływu danych pojawia się błąd.

Przed zmianami warto zachować komunikaty, numery zamówień i aktualne ustawienia. Ogranicza to ryzyko powstania duplikatów etykiet, utraty statusów albo przypadkowego zatrzymania innych kanałów sprzedaży.