Shopvil PackHub

Opis systemu

Shopvil PackHub składa się z dwóch komponentów: PackHub Station i PackHub Mobile.

PackHub Station jest instalowany na serwerze w magazynie. Z jednej strony odpowiada za komunikację z Apilo przez Apilo API — synchronizuje w tle zamówienia, zmienia ich statusy i tworzy przesyłki — a z drugiej wystawia API dla urządzeń PackHub Mobile. Station odpowiada również za wydruk etykiet kurierskich na drukarkach termalnych.

PackHub Mobile jest instalowane na kolektorach Zebra lub telefonach z Androidem. Komunikuje się ze Station API w celu pobrania zamówień i zmiany ich statusów. Obsługuje cały proces pakowania zamówień i odczytuje kody produktów — skanerem kolektora (DataWedge) albo aparatem urządzenia.

Obie aplikacje są dostępne w językach: polskim, angielskim, niemieckim i ukraińskim.

PackHub Station w jednym magazynie może obsługiwać wiele urządzeń PackHub Mobile.

  Apilo API                    PackHub Station (Windows)
      │                              │
      │  synchronizacja zamówień     │  API + drukarki
      └──────────────────────────────┤
                                     │
                    ┌────────────────┼────────────────┐
                    │                │                │
              PackHub Mobile   PackHub Mobile   PackHub Mobile
              (kolektor Zebra) (kolektor Zebra) (telefon)
            

Glosariusz pojęć

Krótkie wyjaśnienie terminów używanych w dalszej części dokumentacji.

Wymagania sprzętowe

PackHub Station (Windows)

PackHub Mobile (Android)

PackHub Mobile działa na kolektorach Zebra oraz na telefonach z Androidem. Do intensywnej pracy zalecamy kolektor Zebra — skaner sprzętowy (DataWedge) jest szybszy niż skanowanie aparatem. Na telefonie kody skanuje się aparatem (zobacz Skanowanie aparatem).

Wspierane kolektory Zebra:

• TC21
• TC25
• TC26
• TC52
• TC57
• TC72
• TC77

Instalacja PackHub Station

Station instaluje się na komputerze w magazynie z dostępem do drukarek i sieci lokalnej.

Krok po kroku

1. Pobierz instalator

   Aktualna wersja PackHub Station jest na stronie www.shopvil.pl/pobierz/. Pobierz plik MSI.

2. Uruchom instalację

   Kliknij dwukrotnie plik MSI. Instalacja przebiega automatycznie — nic nie trzeba akceptować ani konfigurować.

3. Zakończ instalator

   Po zakończeniu skrót Shopvil PackHub pojawi się w menu Start systemu Windows.

4. Uruchomienie

   Uruchom aplikację z menu Start. Station startuje lokalny serwer, a w zasobniku systemowym (systray) pojawia się ikona Shopvil PackHub. Kolejne wersje instalujesz z poziomu aplikacji — zobacz Aktualizacja PackHub Station.

Jak uzyskać klucz klienta

Klucz klienta dostajesz e-mailem po założeniu bezpłatnego okresu próbnego (14 dni) na stronie www.shopvil.pl/trial/:

1. Wypełnij formularz

   Podaj nazwę firmy, NIP i adres e-mail oraz wybierz plan (Starter, Standard albo Pro). Plany mają te same funkcje, różnią się tylko liczbą magazynów i kolektorów.

2. Potwierdź adres e-mail

   Na podany adres przyjdzie wiadomość z linkiem potwierdzającym. Link jest ważny 48 godzin. Jeśli wiadomości nie ma, sprawdź folder spam.

3. Odbierz klucz

   Po kliknięciu linku dostaniesz drugą wiadomość z kluczem klienta i linkami do pobrania PackHub Station i do tej dokumentacji. Okres próbny liczy się od potwierdzenia adresu.

Okres próbny można założyć raz dla danego NIP-u i adresu e-mail. Zgubiony klucz wyślesz sobie ponownie na stronie www.shopvil.pl/trial/klucz/ — trafi na adres podany przy rejestracji.

Pierwsze uruchomienie i aktywacja licencji

Przy pierwszym uruchomieniu trzeba aktywować licencję PackHub — podaj otrzymany klucz klienta (skąd go wziąć). To osobny krok od rejestracji kolektorów PackHub Mobile, opisanej dalej w sekcji Rejestracja urządzenia.

Na tym samym ekranie ustawiasz nazwę magazynu. Pole jest wstępnie wypełnione nazwą domyślną w języku aplikacji (po polsku „Magazyn główny”) — zostaw ją albo wpisz własną, np. „Hala B”. Nazwa nie może być pusta i ma najwyżej 40 znaków. Zmienisz ją później w ustawieniach PackHub (Nazwa magazynu).

Automatyczne uruchamianie ze startem Windows

PackHub Station nie uruchamia się automatycznie po restarcie komputera — trzeba to skonfigurować samodzielnie. Zalecamy dodanie skrótu do aplikacji w folderze autostartu Windows:

1. Naciśnij Win + R, wpisz shell:startup i zatwierdź.
2. Otworzy się folder Autostart bieżącego użytkownika.
3. Skopiuj do niego skrót Shopvil PackHub (np. z menu Start).

Dzięki temu Station uruchomi się automatycznie po zalogowaniu do Windows — np. po restarcie komputera lub aktualizacji systemu.

Aktualizacja PackHub Station

Przy każdym uruchomieniu Station sprawdza, czy jest nowsza wersja (komputer musi mieć dostęp do internetu). Jeśli tak, pokazuje okno z przyciskiem Pobierz. Aktualizację wykonasz bez przeglądarki i bez szukania pliku:

1. Pobierz

   Station sama pobiera instalator i pokazuje postęp pobierania.

2. Zainstaluj i uruchom ponownie

   Po pobraniu pojawi się okno Aktualizacja gotowa do instalacji. Kliknij Zainstaluj i uruchom ponownie — Station się zamknie i uruchomi się instalator Windows. Jeśli Windows poprosi o zgodę administratora, zaakceptuj ją. Anuluj zostawia pobrany plik i Station działa dalej; propozycja aktualizacji wróci przy następnym uruchomieniu.

3. Gotowe

   Po zakończeniu instalacji Station uruchamia się sama, w nowej wersji. Ustawienia i licencja zostają. Jeśli anulujesz instalator, Station uruchomi się ponownie w dotychczasowej wersji.

Gdy pobieranie się nie uda, okno zaproponuje otwarcie strony pobierania w przeglądarce. Gdy nie uda się uruchomić instalatora, pobrany plik MSI znajdziesz w folderze %LOCALAPPDATA%\ShopvilPackHub\updates\ — uruchom go ręcznie, zanim uruchomisz Station ponownie.

Station sprząta ten folder sama, żeby pobrane pliki nie zajmowały miejsca: instalator usuwa przy kolejnym uruchomieniu (po zainstalowaniu aktualizacji nie jest już potrzebny), a z plików APK dla kolektorów trzyma tylko najnowszy.

Lokalizacja plików

Deinstalacja

PackHub Station odinstalujesz standardowo, przez Windows Ustawienia → Aplikacje → Zainstalowane aplikacje (lub Panel sterowania → Programy i funkcje) — znajdź na liście Shopvil PackHub i wybierz Odinstaluj.

Instalacja PackHub Mobile

Mobile instaluje się na kolektorze Zebra lub telefonie z Androidem.

Krok po kroku

1. Pobierz instalator

   Aktualna wersja PackHub Mobile jest na stronie www.shopvil.pl/pobierz/. Pobierz plik APK na komputer lub bezpośrednio na kolektor.

2. Przenieś APK na kolektor

   Jeśli plik jest na komputerze, przenieś go na urządzenie (USB lub udostępniony dysk).

3. Uruchom instalację

   W ustawieniach Androida zezwól na instalację z nieznanych źródeł (dla użytego źródła). Otwórz plik APK i potwierdź instalację.

4. Uruchomienie

   Uruchom PackHub Mobile na kolektorze. Kolejne wersje zainstalujesz z poziomu aplikacji — zobacz Aktualizacja PackHub Mobile.

Profil DataWedge

PackHub Mobile korzysta ze skanera kolektora przez DataWedge. Profil DataWedge pobierzesz ze strony www.shopvil.pl/pobierz/ — wybierz profil dla modelu swojego kolektora.

Aby zaimportować profil:

1. Pobierz plik profilu i przenieś go na kolektor (USB lub udostępniony dysk), jeśli pobrałeś go na komputer.
2. Na kolektorze otwórz aplikację DataWedge.
3. W prawym górnym rogu otwórz menu (trzy kropki) i wybierz Settings.
4. Wybierz Import Profile.
5. Wskaż pobrany plik profilu i potwierdź.

Po udanym imporcie DataWedge pokaże komunikat, a profil pojawi się na liście. Bez zaimportowanego profilu skaner kolektora nie będzie działał poprawnie w PackHub Mobile (skanowanie aparatem działa niezależnie od DataWedge).

Pierwsze uruchomienie

Po instalacji otwórz aplikację i skonfiguruj połączenie ze Station (Skanuj sieć lub wpisz adres ręcznie) — szczegóły w sekcji Konfiguracja Mobile. Następnie zarejestruj kolektor w PackHub Station — bez rejestracji urządzenie nie pobierze zamówień. Procedura krok po kroku: Rejestracja urządzenia.

Aktualizacja PackHub Mobile

Po uruchomieniu aplikacji (po zalogowaniu i wczytaniu listy zamówień) Mobile pyta Station o nową wersję — kolektor nie potrzebuje do tego internetu. Station pobiera plik aktualizacji z internetu i udostępnia go w sieci lokalnej.

1. Pobierz

   Gdy jest nowa wersja, pojawia się okno Dostępna nowa wersja. Kliknij Pobierz — aplikacja pobiera plik i pokazuje pasek postępu (Anuluj przerywa pobieranie). Okno pojawia się raz po każdym uruchomieniu aplikacji, nie przy każdym odświeżeniu listy.

2. Zezwól na instalację (tylko za pierwszym razem)

   Na Androidzie 8 i nowszym aplikacja poprosi o zezwolenie PackHub na instalowanie nieznanych aplikacji — przejdziesz do ustawień, włączysz zgodę i wrócisz do aplikacji. Zgoda jest jednorazowa. Na Androidzie 7.1 to globalne ustawienie Nieznane źródła — system sam poprosi o jego włączenie.

3. Potwierdź instalację

   Zatwierdź instalację w oknie systemowym Androida, a po niej wybierz Otwórz. Rejestracja kolektora, adres Station i język zostają.

Jeśli Station nie ma jeszcze pobranego pliku albo jest w starszej wersji, kolektor pobiera aktualizację bezpośrednio z internetu. Gdy pobieranie się nie uda albo plik okaże się nieprawidłowy, okno zaproponuje otwarcie strony pobierania w przeglądarce.

Konfiguracja PackHub Station

Konfigurację wykonasz w panelu aplikacji PackHub Station. Dostępne są dwie sekcje ustawień: PackHub oraz Apilo.

Port API

Station wystawia API dla kolektorów PackHub Mobile. Domyślnie nasłuchuje na porcie 55777.

Aby zmienić port, ustaw w Windows zmienną środowiskową SHOPVIL_PACKHUB_STATION_PORT, a następnie uruchom ponownie Station.

Urządzenia

PackHub Station prowadzi listę urządzeń PackHub Mobile, które łączyły się z serwerem. Każde urządzenie Mobile musi zostać zarejestrowane w Station, zanim będzie mogło pobierać zamówienia i pakować.

Gdy kolektor po raz pierwszy połączy się ze Station, wysyła prośbę o rejestrację i pojawia się na liście Urządzeń ze statusem oczekującym. Aby zarejestrować urządzenie, wybierz je z listy i potwierdź rejestrację.

Szczegóły procesu rejestracji po stronie kolektora opisano w sekcji Konfiguracja PackHub Mobile / Rejestracja urządzenia.

Ustawienia PackHub

Nazwa magazynu

W sekcji Magazyn na górze okna wpisz nazwę i kliknij Zapisz. Nazwa pozwala odróżnić instalacje Station, jeśli masz więcej niż jeden magazyn (np. „Hala B”, „Poznań – Franowo”).

• Nazwa nie może być pusta i ma najwyżej 40 znaków — pole nie przyjmie więcej.
• Spacje na początku i na końcu są usuwane; tabulatory i znaki nowej linii nie są dozwolone.
• Po zapisie nowa nazwa jest od razu widoczna w dymku ikony PackHub w zasobniku systemowym oraz w oknie O programie (wiersz Magazyn). Tytuły okien się nie zmieniają.
• Nazwa trafia też do notatek, które Station zapisuje w zamówieniach Apilo (zobacz Notatki PackHub w zamówieniach). W notatkach dodanych wcześniej zostaje nazwa obowiązująca w momencie pakowania.
• Po aktualizacji ze starszej wersji Station pokazuje nazwę domyślną w bieżącym języku aplikacji, dopóki nie zapiszesz własnej — nic nie trzeba robić.

Zapisana nazwa jest zwykłym tekstem, więc nie zmienia się razem z językiem aplikacji. Nie wpływa na kolektory ani na działanie licencji. Station przesyła ją do usługi licencji Shopvil (przy aktywacji i przy okresowym sprawdzaniu licencji) — zmiana nazwy dociera tam przy najbliższym sprawdzeniu.

Język aplikacji

Wybierz język interfejsu PackHub Station: Polski, English, Deutsch lub Українська, i kliknij Zapisz. Nowy język będzie widoczny po ponownym uruchomieniu aplikacji. Domyślnym językiem jest polski.

Język Station nie wpływa na kolektory — każde urządzenie PackHub Mobile ma własne ustawienie języka (zobacz Konfiguracja PackHub Mobile / Język).

Etykiety kurierskie

Wybierz drukarkę termalną etykiet kurierskich z listy drukarek zainstalowanych w systemie Windows.

Zdjęcia pakowania

Magazynier może zrobić kolektorem zdjęcia otwartego kartonu z zawartością, zanim go zamknie. Zdjęcia są zapisywane na komputerze ze Station, w osobnym folderze dla każdego zamówienia — przy reklamacji („przyszło niekompletne”) szybko znajdziesz dowód, co było w paczce. Opis pracy na kolektorze: Workflow pakowania / Zdjęcia pakowania.

W sekcji Zdjęcia pakowania ustaw poniższe pola i kliknij Zapisz.

• Zdjęcia — tryb pracy:
  • Wyłączone (domyślnie) — kolektor nie pokazuje przycisku zdjęcia, pakowanie przebiega jak dotychczas.
  • Opcjonalne — na ekranie pakowania kolektora jest przycisk zdjęcia. Zdjęcie można zrobić w każdej chwili, ale nie jest wymagane.
  • Wymagane — po spakowaniu wszystkich pozycji kolektor sam otwiera aparat. Pakowania nie da się zakończyć bez co najmniej jednego zdjęcia.
• Folder — gdzie zapisywać zdjęcia. Puste pole oznacza folder domyślny %LOCALAPPDATA%\ShopvilPackHub\photos\. Możesz wpisać pełną ścieżkę albo wybrać folder przyciskiem Wybierz…, np. na dysku sieciowym lub w folderze objętym kopią zapasową. Przy zapisie ustawień z włączonymi zdjęciami Station sprawdza, czy da się w tym folderze zapisać plik. Otwórz folder otwiera wskazany folder w Eksploratorze.
• Przechowuj przez — liczba dni (1–730, domyślnie 90). Starsze zdjęcia Station usuwa automatycznie: przy każdym uruchomieniu i codziennie o 03:00, jeśli jest wtedy włączony. Wiek zdjęcia liczy się od jego zapisania.

W folderze zdjęć Station tworzy podfolder integracji (dla Apilo: apilo), a w nim folder o nazwie numeru zamówienia, np. photos\apilo\AL2609001234\. Pliki mają nazwy z datą i godziną zapisu, np. 20260928-143015-1.jpg. Zamówienie może mieć najwyżej 10 zdjęć. Jedno zdjęcie zajmuje zwykle 200–400 KB.

Station nie zapisuje zdjęć, gdy na dysku z folderem zostaje mniej niż 500 MB wolnego miejsca — kolektor pokazuje wtedy komunikat, a Station powiadomienie w zasobniku systemowym ze ścieżką folderu. Station usuwa tylko pliki zdjęć, które sama zapisała, więc folder może leżeć obok innych danych. Zdjęcia nie są wysyłane ani do Apilo, ani do Shopvil — zobacz Bezpieczeństwo i sieć.

Licznik kartonów

Licznik podpowiada, kiedy zamówić kartony, zanim się skończą. Station zna stan kartonów każdego rozmiaru i po każdym zakończonym pakowaniu odejmuje karton w rozmiarze wybranym na kolektorze (A, B lub C — te same oznaczenia co na kolektorze i w notatce [Shopvil] spakowano w: …). Licznik jest domyślnie wyłączony.

W sekcji Kartony zaznacz Licz zużyte kartony, ustaw progi i kliknij Zapisz. Dla każdego rozmiaru widzisz:

• Stan — ile kartonów jest według licznika.
• Próg ostrzeżenia — od jakiego stanu Station ostrzega (domyślnie 20). Wpisz 0, jeśli nie chcesz ostrzeżeń dla danego rozmiaru, np. gdy go nie używasz.
• Przyjmij dostawę… — wpisz, ile kartonów przyszło; Station doda je do stanu.
• Ustaw stan… — wpisz, ile kartonów jest naprawdę, np. po policzeniu ich w magazynie.

Dostawa i ustawienie stanu zapisują się od razu po zatwierdzeniu, bez przycisku Zapisz — działa to także przy wyłączonym liczniku, więc stan możesz wpisać przed jego włączeniem. Stan i progi mieszczą się w zakresie 0–99 999. Stan nie spada poniżej zera i jest zachowywany po ponownym uruchomieniu Station.

Gdy stan któregoś rozmiaru spadnie do progu lub niżej, na górze menu ikony PackHub w zasobniku systemowym pojawia się ostrzeżenie, np. „Kończą się kartony B: zostało 12”, a przy zerze „Brak kartonów B”. Ostrzeżenie jest widoczne, dopóki nie przyjmiesz dostawy albo nie poprawisz stanu; kliknięcie go otwiera ustawienia PackHub. Dodatkowo w chwili, gdy pakowanie obniży stan do progu, Station pokazuje jednorazowy dymek przy ikonie w zasobniku. Ostrzeżenia niczego nie blokują — pakowanie działa dalej.

Licznik działa w Station i nie wymaga aktualizacji kolektorów — rozmiar kartonu wysyła każda wersja PackHub Mobile.

Przesyłki

Ustaw limity dla tworzonych przesyłek. Domyślne wartości są zgodne ze specyfikacją firm kurierskich.

• Maksymalna waga jednej paczki (0–1000 kg)
• Maksymalna ilość paczek w przesyłce (1–8)
• Domyślna zawartość przesyłki (do 50 znaków)

Obsługiwani kurierzy:

• Paczkomat InPost
• Paczkomat InPost – Paczka weekendowa (odbiór z paczkomatów 24/7 w weekend)
• Kurier InPost
• DPD – odbiór w punkcie
• Kurier DPD
• DHL (kurier i DHL POP — rozpoznawane automatycznie po adresie)

Ustawienia Apilo

Akcje przy spakowaniu zamówień

Konfiguracja akcji podejmowanych w PackHub Mobile po spakowaniu zamówienia, dotyczących tworzenia dokumentu sprzedaży i przesyłki. Dla obu akcji dostępne są te same opcje:

• Pytaj — na Mobile otworzy się dialog z pytaniem.
• Twórz automatycznie — Station utworzy dokument lub przesyłkę automatycznie.
• Nie twórz — dokument sprzedaży lub przesyłka nie zostaną utworzone.

Konta kurierów

Każdemu kurierowi, z którego korzystasz, przypisz konto kurierskie z Apilo i metodę nadania. Station rozpoznaje po nich kuriera zamówienia i tworzy przesyłki na wskazanym koncie. Listy kont i metod Station pobiera z Twojego konta Apilo — najpierw skonfiguruj konta kurierskie w Apilo oraz połączenie (Apilo API).

• Kuriera, z którego nie korzystasz, zostaw bez konta (- nie używam -).
• To samo konto Apilo możesz przypisać kilku kurierom (np. jedno konto InPost dla paczkomatu i kuriera), ale z różnymi metodami nadania. Station wybiera wtedy kuriera zamówienia według mapowania kurierów, a gdy żadna reguła nie pasuje — według adresu dostawy (punkt odbioru albo adres).
• Paczka weekendowa InPost korzysta z konta i metody przypisanych do Paczkomat InPost.
• Po dodaniu albo zmianie konta kurierskiego w Apilo kliknij Odśwież z Apilo.
• Zmiany obowiązują po kliknięciu Zapisz konta kurierów.

Mapowanie kurierów

Apilo nie zawsze przypisuje kurierów do zamówień — dlatego mapowanie może okazać się niezbędne. Mapowania pozwalają automatycznie przypisać kuriera na podstawie nazwy pozycji zamówienia. Station korzysta z nich, gdy zamówienie nie ma konta kurierskiego albo jego konto nie jest przypisane do żadnego kuriera w sekcji Konta kurierów. Każde mapowanie składa się z:

• tekstu do dopasowania,
• typu dopasowania: zawiera, równa się, zaczyna się od,
• wybranego kuriera.

Mapowania są wykonywane od góry do dołu — kolejność ma znaczenie. Możesz dodawać nowe reguły, usuwać istniejące oraz zmieniać ich kolejność.

Apilo API

Podaj dane konta Apilo oraz klucza Apilo API:

• Nazwa konta Apilo — możesz ją odczytać z adresu pulpitu Apilo. Na przykład dla https://mojsklep123.apilo.com nazwa konta to mojsklep123.
• Dane klucza API:
  • Client ID
  • Client Secret
  • Kod autoryzacji

Pobieranie zamówień

Station synchronizuje zamówienia z Apilo zgodnie z konfiguracją:

• maksymalna ilość pobranych zamówień (domyślnie 20),
• co ile minut synchronizacja z Apilo (domyślnie 5),
• data graniczna pobieranych zamówień.

Konfiguracja PackHub Mobile

Otwórz PackHub Mobile → Ustawienia. Ekran podzielony jest na trzy sekcje: połączenie ze Station, status urządzenia i język aplikacji.

Konfiguracja połączenia ze Station

Tutaj ustawiasz połączenie z serwerem PackHub Station w magazynie.

• Skanuj sieć — kliknij przycisk, aby automatycznie wyszukać uruchomiony Station w sieci lokalnej i ustawić połączenie.
• Ręcznie — wpisz adres IP i port Station, np. 192.168.1.50 i 55777 (domyślny port Station — zobacz Konfiguracja PackHub Station / Port API).

Status urządzenia

W tej sekcji znajdziesz informacje o kolektorze i wersji aplikacji PackHub Mobile. Przy pierwszym uruchomieniu PackHub Mobile generuje identyfikator urządzenia — jest on widoczny właśnie tutaj, w danych urządzenia.

• Identyfikator urządzenia (generowany przy pierwszym uruchomieniu).
• Wersja zainstalowanej aplikacji.
• Status rejestracji w PackHub Station.
• Odśwież status rejestracji — sprawdź, czy urządzenie zostało zarejestrowane w Station.

Język

Wybierz język aplikacji: Polski, English, Deutsch lub Українська. Po zmianie aplikacja uruchamia się ponownie w wybranym języku. Domyślnym językiem jest polski.

Ustawienie dotyczy tylko tego urządzenia — na każdym kolektorze można wybrać inny język, niezależnie od języka PackHub Station. W wybranym języku wyświetlane są też komunikaty przesyłane ze Station, np. informacja, że dla zamówienia nie da się utworzyć przesyłki.

Rejestracja urządzenia

Każde urządzenie PackHub Mobile musi zostać zarejestrowane w PackHub Station, zanim będzie mogło pobierać zamówienia. Rejestracja odbywa się po obu stronach: kolektor wysyła prośbę, a administrator zatwierdza ją w panelu Station.

1. Skonfiguruj połączenie ze Station

   Upewnij się, że kolektor łączy się z uruchomionym PackHub Station (Skanuj sieć lub wpisz adres ręcznie).

2. Sprawdź identyfikator urządzenia

   Przy pierwszym uruchomieniu aplikacja generuje identyfikator urządzenia. Znajdziesz go w sekcji Status urządzenia.

3. Wyślij prośbę o rejestrację

   Po połączeniu ze Station urządzenie automatycznie wysyła prośbę o zarejestrowanie. Kolektor pojawi się na liście Urządzeń w PackHub Station (zobacz Konfiguracja PackHub Station / Urządzenia).

4. Zatwierdź rejestrację w Station

   Na komputerze z PackHub Station otwórz listę Urządzeń i zarejestruj oczekujący kolektor.

5. Odśwież listę zamówień

   Po rejestracji wróć do PackHub Mobile i odśwież listę zamówień (lub użyj Odśwież status rejestracji w Status urządzenia). Od tego momentu możesz zacząć pakować.

Integracje

Apilo to platforma do zarządzania sprzedażą wielokanałową (zamówienia, magazyn, dokumenty sprzedaży) — PackHub Station synchronizuje się z Apilo, żeby pobierać zamówienia i zgłaszać ich status.

Apilo

Dokumenty sprzedaży

Sam PackHub nie tworzy dokumentów sprzedaży, jedynie „informuje” Apilo, że dla danego zamówienia należy wystawić dokument sprzedaży (zobacz PackHub Station / Ustawienia Apilo / Akcje przy spakowaniu zamówień).

Jeśli chce się, aby Apilo generowało dokumenty sprzedaży, należy:

• dodać tag
• skonfigurować zadania automatyczne

Należy ręcznie stworzyć tag zamówień, dzięki któremu PackHub będzie informował Apilo, o tym, że dla danego zamówienia powinien zostać stworzony dokument sprzedaży. Tag dodaje się w Apilo w Administracja / Tagi zamówień / Nowy tag:

• Nazwa: Shopvil - stwórz dokument sprzedaży
• Nazwa skrócona: Shopvil - dokument sprzedaży

Teraz należy dodać zadania automatyczne. Pod Administracja / Zadania automatyczne należy dodać zadanie dla wystawienia paragonu i zadanie dla wystawienia faktury. Oba zadania mają to samo zdarzenie — różnią się warunkiem faktury i serią numeracji.

Klucz API

Aby Station mógł komunikować się z Apilo, potrzebny jest klucz API. Klucze są w Apilo w Administracja / Klucze API Apilo. Tam trzeba dodać nową aplikację REST API:

• Nazwa aplikacji: np. Shopvil PackHub

Dane klucza należy skonfigurować w Station (zobacz Ustawienia Apilo / Apilo API).

Konta kurierskie

Station tworzy przesyłki na kontach kurierskich skonfigurowanych w Apilo. Konto każdego kuriera, z którego chcesz korzystać w PackHub, musi więc najpierw istnieć w Apilo — potem przypisujesz je kurierowi w Station (zobacz Ustawienia Apilo / Konta kurierów).

Notatki PackHub w zamówieniach

PackHub Station zapisuje w zamówieniach Apilo notatki wewnętrzne o kolejnych etapach realizacji. Notatki PackHub zaczynają się od [Shopvil] i widać je w szczegółach zamówienia w Apilo. Na końcu każdej notatki jest nazwa magazynu, który wykonał tę operację (zobacz Nazwa magazynu) — dzięki temu przy kilku instalacjach Station widzisz w Apilo, gdzie zamówienie zostało spakowane i wysłane.

Drukarki fiskalne

Drukarki fiskalne są wspierane bezpośrednio przez Inspigo, we współpracy z Apilo. PackHub ich nie obsługuje — fiskalizacja odbywa się po stronie Apilo. Opis i lista wspieranych drukarek są na stronie Apilo: apilo.com/pl/integracje/drukarka-fiskalna.

Drukarki etykiet

Drukarki etykiet są wspierane przez PackHub Station. Drukarkę wystarczy skonfigurować w Station (zobacz Konfiguracja PackHub Station / Etykiety kurierskie).

Workflow pakowania

Typowy przebieg pracy magazyniera na kolektorze:

1. Pobranie zamówienia

   Mobile pobiera listę zamówień ze Station. Magazynier wybiera jedno z nich, a PackHub zmienia status zamówienia w Apilo.

2. Skanowanie produktów

   Magazynier skanuje produkty skanerem kolektora (DataWedge) lub aparatem urządzenia albo wprowadza ilość spakowanych sztuk ręcznie. Aplikacja odhacza pozycje i sygnalizuje braki lub nadmiar — poprawny skan, błąd, spakowanie pozycji i spakowanie całego zamówienia mają osobne sygnały dźwiękowe (przy błędzie dodatkowo wibracja), co ułatwia pracę bez patrzenia na ekran.

3. Zakończenie pakowania

   Po spakowaniu wszystkich produktów PackHub zmienia status zamówienia w Apilo. Jeśli dla zamówienia można utworzyć przesyłkę, przed zakończeniem wybierz rozmiar kartonu (A, B lub C) — Station zapisze go w notatce do zamówienia (zobacz Notatki PackHub w zamówieniach), a przy włączonym liczniku kartonów odejmie go ze stanu (zobacz Licznik kartonów). Jeśli w Station włączono zdjęcia pakowania, przed zamknięciem kartonu zrób zdjęcie jego zawartości (zobacz Zdjęcia pakowania). Jeśli zamówienie ma notatkę, aplikacja zapyta, czy dodać ją także do przesyłki.

4. Tworzenie przesyłki

   Station tworzy przesyłkę w Apilo.

5. Drukowanie dokumentów

   Station drukuje etykietę wysyłkową. Paragon lub faktura na drukarce fiskalnej jest obsługiwana przez Apilo / Inspigo (zobacz Integracje / Apilo / Drukarki fiskalne).

Wstrzymanie pakowania (brak towaru)

Gdy w trakcie pakowania okaże się, że produktu nie ma w magazynie albo jest uszkodzony, nie musisz oddawać zamówienia do kolejki. Dotknij WSTRZYMAJ u góry ekranu pakowania i wybierz powód: Brak towaru (domyślnie), Uszkodzony towar albo Inny powód. Możesz też wpisać krótki komentarz (do 200 znaków), np. który produkt i ile sztuk brakuje.

1. Wstrzymanie. Zamówienie zostaje w statusie „W realizacji” i nie wraca do kolejki, więc nikt inny nie zacznie go pakować od nowa. Station dodaje w Apilo notatkę z powodem i komentarzem (zobacz Notatki PackHub w zamówieniach).
2. Wyjaśnienie. Osoba odpowiedzialna za zamówienia wyjaśnia sprawę w Apilo — np. zmienia produkt w zamówieniu lub kontaktuje się z klientem.
3. Wznowienie. Na liście zamówień dotknij ikony otwartego pudełka z licznikiem — otworzy się lista „W trakcie pakowania”. Przy zamówieniu dotknij ikony wznów (zielony trójkąt) i potwierdź. Możesz to zrobić w dowolnym momencie, na dowolnym kolektorze i przez dowolnego pracownika — niekoniecznie tego, który zamówienie wstrzymał. Station dodaje w Apilo notatkę o wznowieniu.

• Skanowanie po wznowieniu zaczyna się od nowa — PackHub nie zapamiętuje, które produkty były już zeskanowane przed wstrzymaniem.
• Zmiany wprowadzone w Apilo w czasie wstrzymania (np. podmiana produktu) Station pobiera przy najbliższej synchronizacji z Apilo albo po kliknięciu Odśwież w oknie Zamówienia. Jeśli po wznowieniu widzisz starą listę pozycji, odśwież zamówienia w Station i wznów pakowanie ponownie.
• Wstrzymane zamówienie jest na liście „W trakcie pakowania” razem z zamówieniami pakowanymi w tej chwili — lista ich nie rozróżnia. Zamówienie, którego nikt nie wznowi, zostanie w realizacji, więc warto pilnować wyjaśnionych spraw. Z tej listy można też anulować pakowanie, jeśli zamówienie ma wrócić do kolejki.
• Wstrzymanie i wznowienie wymagają Station i Mobile w wersji 2026.2. Starszy kolektor przy nowej Station pakuje jak dawniej, a nowy kolektor przy starej Station wyświetli komunikat, że funkcja wymaga nowszej wersji PackHub Station.

Skanowanie aparatem

Na ekranie pakowania zamówienia, w górnym pasku, znajduje się przycisk Skanuj aparatem (ikona aparatu). Dzięki niemu można pakować na telefonie bez DataWedge, a na kolektorze Zebra — skanować, gdy skaner sprzętowy akurat nie działa.

1. Dotknij ikony aparatu — otworzy się podgląd z aparatu.
2. Przy pierwszym użyciu zezwól aplikacji na dostęp do aparatu.
3. Skieruj aparat na kod kreskowy produktu. Po odczytaniu pierwszego kodu podgląd zamyka się sam, a skan jest liczony tak samo jak skan ze skanera — z tymi samymi sygnałami dźwiękowymi.
4. Aby zeskanować kolejny produkt, ponownie dotknij ikony aparatu.

W słabym oświetleniu użyj przycisku Latarka. Przycisk Zamknij wraca do zamówienia bez skanowania. Aparat odczytuje kody EAN‑13, EAN‑8, UPC‑A, UPC‑E i Code 128.

Zdjęcia pakowania

Gdy w Station włączono zdjęcia pakowania (tryb Opcjonalne albo Wymagane — zobacz Konfiguracja PackHub Station / Zdjęcia pakowania), na ekranie pakowania, w górnym pasku obok Skanuj aparatem, pojawia się przycisk zdjęcia (ikona ramki z otwartym kartonem) z liczbą zapisanych zdjęć. Najlepiej zrobić zdjęcie po zeskanowaniu wszystkich produktów, gdy karton jest jeszcze otwarty — tak, żeby było widać jego zawartość.

1. Dotknij przycisku zdjęcia. Przy pierwszym użyciu zezwól aplikacji na dostęp do aparatu.
2. Dotknij Zrób zdjęcie. Zdjęcie od razu trafia do Station, a po zapisaniu jego miniatura pojawia się na ekranie ze znacznikiem ✓. Licznik Zdjęcia: N / 10 pokazuje, ile zdjęć ma zamówienie.
3. Nieudane zdjęcie usuń przyciskiem Usuń ostatnie. W słabym oświetleniu użyj przycisku Latarka.
4. Dotknij Gotowe (albo systemowego przycisku „wstecz”), aby wrócić do pakowania.

W trybie Wymagane, jeśli zamówienie nie ma jeszcze zdjęcia, kolektor sam otwiera aparat po spakowaniu wszystkich produktów i wyborze rozmiaru kartonu (jeśli zamówienie go wymaga). Po zrobieniu zdjęcia i dotknięciu Gotowe pakowanie kończy się jak zwykle. Jeśli wrócisz bez zdjęcia, kolektor przypomni o nim i zostanie na ekranie pakowania — aparat otworzysz przyciskiem zdjęcia.

• Zamówienie może mieć najwyżej 10 zdjęć. Station zapisuje je w folderze o nazwie numeru zamówienia.
• ANULUJ nie usuwa zdjęć — zostają w Station jako ślad przerwanego pakowania.
• Po wznowieniu wstrzymanego zamówienia kolektor liczy zdjęcia zrobione przed wstrzymaniem, więc w trybie Wymagane nie trzeba robić nowego. Usuń ostatnie usuwa tylko zdjęcia zrobione od ostatniego otwarcia aparatu.
• Zdjęcia wymagają Station i Mobile w wersji 2026.3 lub nowszej. Przy starszej Station kolektor nie pokazuje przycisku zdjęcia, a starszy kolektor pakuje bez zdjęć także w trybie Wymagane.

Gdzie znaleźć zdjęcia

• Okno Zamówienia — w widokach Dzisiaj spakowane i Wczoraj spakowane kolumna Zdjęcia pokazuje liczbę zdjęć, a przycisk Pokaż zdjęcia otwiera folder zamówienia w Eksploratorze Windows (zobacz Podgląd zamówień w Station).
• Okno Zdjęcia pakowania — otworzysz je z menu ikony PackHub w zasobniku systemowym (pozycja jest widoczna, gdy zdjęcia są włączone). Wpisz numer zamówienia albo jego część i kliknij Szukaj. Okno znajduje także zamówienia, których nie ma już w oknie Zamówienia. Bez numeru pokazuje zamówienia z najnowszymi zdjęciami (najwyżej 200). Otwórz folder (albo dwuklik) otwiera folder zamówienia, a Otwórz folder zdjęć — folder główny.
• Eksplorator Windows — zdjęcia leżą w folderze <folder zdjęć>\apilo\<numer zamówienia>\, więc możesz je też znaleźć bez Station.

Podgląd zamówień w Station

Okno Zamówienia otworzysz z menu ikony PackHub w zasobniku systemowym. Na liście rozwijanej wybierz widok:

• W kolejce do pakowania — zamówienia czekające na spakowanie,
• Obecnie pakowane — zamówienia w trakcie pakowania na kolektorach,
• Dzisiaj spakowane i Wczoraj spakowane — zamówienia spakowane danego dnia.

Tabela pokazuje m.in. datę utworzenia zamówienia, liczbę pozycji, łączną wagę i kuriera. W widokach spakowanych zamówień jest też kolumna Wysłano z datą i godziną utworzenia przesyłki — pochodzi z notatki [Shopvil] wysłano w Apilo (zobacz Notatki PackHub w zamówieniach). Kolumna jest pusta, jeśli przesyłki nie utworzył PackHub — np. gdy utworzono ją ręcznie w Apilo albo przed aktualizacją do wersji 2026.2.

Przy włączonych zdjęciach pakowania (albo gdy któreś zamówienie na liście ma zdjęcia) widoki spakowanych zamówień mają też kolumnę Zdjęcia z liczbą zdjęć i przycisk Pokaż zdjęcia, który otwiera folder zamówienia (zobacz Zdjęcia pakowania).

Rozwiązywanie problemów

Windows — PackHub Station

Błędy sieci

• Sprawdź, czy Station jest uruchomiony i nasłuchuje na porcie (domyślnie 55777).
• Dodaj regułę zapory Windows dla portu API.
• Zweryfikuj, że komputer ma stały (lub znany) adres IP w LAN.
• Sprawdź dostęp do internetu.

Brak drukarki / błąd druku

• Upewnij się, że drukarka jest widoczna w systemie Windows.
• Wydrukuj stronę testową z systemu operacyjnego.
• Sprawdź nazwę drukarki w konfiguracji Station.
• Drukarki fiskalne konfiguruje się po stronie Apilo / Inspigo — zobacz Integracje / Apilo / Drukarki fiskalne.

Przesyłka nie została utworzona — kurier bez konta

• Komunikat „Przesyłka nie została utworzona” z nazwą kuriera oznacza, że kurier zamówienia nie ma przypisanego konta kurierskiego. Przypisz je w Ustawieniach Apilo / Konta kurierów.
• Przesyłkę dla tego zamówienia utwórz bezpośrednio w Apilo.
• Ostrzeżenie „Konta kurierów nie są skonfigurowane” przy uruchomieniu Station oznacza, że żaden kurier nie ma jeszcze konta — zniknie po zapisaniu kont.

Przesyłka utworzona, ale etykieta się nie wydrukowała

• Po utworzeniu przesyłki Station czeka maksymalnie minutę na wygenerowanie etykiety przez Apilo — jeśli w tym czasie etykieta nie powstanie, nie zostanie wydrukowana automatycznie.
• Odczekaj chwilę i sprawdź przesyłkę ponownie w panelu Apilo.
• Etykietę możesz w razie potrzeby wydrukować ręcznie bezpośrednio z Apilo.

Brak zamówień

• Sprawdź, czy ustawienia Apilo są poprawne — w tym klucz API (zobacz Konfiguracja PackHub Station / Ustawienia Apilo).
• W Apilo zamówienia muszą mieć status Nowy, aby pojawiły się w PackHub.
• Wymuś synchronizację w panelu Station.
• Przejrzyj logi w %LOCALAPPDATA%\ShopvilPackHub\logs\.

Za mało miejsca na zdjęcia pakowania

• Station nie zapisuje zdjęć, gdy na dysku z folderem zdjęć zostaje mniej niż 500 MB wolnego miejsca, i pokazuje powiadomienie w zasobniku systemowym ze ścieżką folderu (najwyżej raz na 30 minut).
• Zwolnij miejsce na dysku albo wskaż inny folder w ustawieniach PackHub (zobacz Zdjęcia pakowania). Zdjęcia zapisane wcześniej zostają w starym folderze — przenieś je ręcznie, jeśli chcesz je widzieć w Station.
• Możesz też skrócić czas przechowywania — starsze zdjęcia Station usunie przy najbliższym uruchomieniu albo o 03:00.

Android — PackHub Mobile

Brak Wi‑Fi

• Połącz kolektor z siecią magazynową (nie gościnną).
• Sprawdź zasięg AP w strefie pakowania.

Skaner nie działa

• Sprawdź, czy profil DataWedge jest zaimportowany — zobacz Instalacja PackHub Mobile / Profil DataWedge.
• Otwórz DataWedge i upewnij się, że zaimportowany profil jest aktywny.
• Przetestuj skan w aplikacji DataWedge / domyślnym profilu.
• Zrestartuj DataWedge lub kolektor.
• Do czasu rozwiązania problemu możesz skanować aparatem — zobacz Skanowanie aparatem.

Skanowanie aparatem nie działa

• Jeśli aplikacja nie ma dostępu do aparatu, zezwól na niego w ustawieniach systemowych Androida: Aplikacje → Shopvil PackHub → Uprawnienia → Aparat (nazwy menu zależą od producenta telefonu).
• Włącz Latarkę w słabym oświetleniu i trzymaj kod w całości w kadrze.
• Sprawdź, czy kod jest w obsługiwanym formacie: EAN‑13, EAN‑8, UPC‑A, UPC‑E lub Code 128.

Nie da się zapisać zdjęcia albo zakończyć pakowania w trybie „Wymagane”

• W trybie Wymagane pakowania nie da się zakończyć bez co najmniej jednego zdjęcia zapisanego w Station. Dotknij przycisku zdjęcia i zrób zdjęcie kartonu. Jeśli zdjęcia nie da się zapisać, a paczka musi wyjść, przełącz tryb w Station na Opcjonalne (zobacz Zdjęcia pakowania). Kolektor odczytuje tryb przy otwieraniu zamówienia, więc przerwij pakowanie (ANULUJ) i spakuj zamówienie ponownie — skanowanie zacznie się od nowa.
• „Na komputerze z PackHub Station brakuje miejsca” — zobacz Za mało miejsca na zdjęcia pakowania w części o Station powyżej.
• „Osiągnięto limit zdjęć dla tego zamówienia” — zamówienie ma już 10 zdjęć; usuń nieudane przyciskiem Usuń ostatnie.
• „Nie udało się zapisać zdjęcia” — sprawdź połączenie ze Station (jak przy braku połączenia z serwerem) i dostępność folderu zdjęć, np. dysku sieciowego; zrób zdjęcie ponownie.
• Jeśli aplikacja nie ma dostępu do aparatu, zezwól na niego w ustawieniach systemowych Androida, jak przy skanowaniu aparatem.

Brak połączenia z serwerem

• Sprawdź adres IP i port Station w ustawieniach Mobile (sekcja połączenia).
• Pinguj adres Station z innego urządzenia w tej samej sieci.
• Upewnij się, że Station działa i zapora przepuszcza ruch.
• „Skanuj sieć” nic nie znajduje: funkcja wykrywa Station tylko w obrębie tej samej sieci lokalnej co kolektor. Jeśli Station jest w innym VLAN-ie/podsieci routowanej niż kolektor, autodetekcja nie zadziała — wpisz adres IP i port ręcznie.

Nie wyświetlają się zdjęcia produktów

• Zdjęcia pobiera Station — sprawdź dostęp do internetu na komputerze ze Station.
• Jeśli Station albo Mobile jest w wersji starszej niż 2026.2, kolektor wczytuje zdjęcia bezpośrednio z internetu — zaktualizuj obie aplikacje albo zapewnij kolektorowi dostęp do internetu.
• Zdjęcie może być niedostępne u źródła (link z Apilo, np. do sklepu lub Allegro) — sprawdź zdjęcie produktu w Apilo.
• Station nie pobiera zdjęć z adresów w sieci lokalnej (np. z serwera w firmie) — takie zdjęcia muszą być dostępne pod adresem publicznym.

Brak zamówień / urządzenie niezarejestrowane

• Sprawdź w Status urządzenia, czy kolektor jest zarejestrowany — użyj Odśwież status rejestracji.
• Na komputerze ze Station otwórz listę Urządzeń i zarejestruj oczekujący kolektor (zobacz Konfiguracja PackHub Station / Urządzenia).
• Po rejestracji odśwież listę zamówień na Mobile.

Limit kolektorów przekroczony

Rejestracja nowego kolektora kończy się błędem, gdy liczba urządzeń osiągnie limit określony przez licencję PackHub.

• Zarejestruj urządzenie na miejsce jednego, które już nie jest używane.
• Skontaktuj się z nami, aby zwiększyć limit kolektorów w ramach licencji — zobacz Wsparcie.

Bezpieczeństwo i sieć

PackHub Mobile komunikuje się ze Station przez zwykłe, nieszyfrowane połączenie HTTP w sieci lokalnej — nie przez internet i nie przez HTTPS. Każdy kolektor identyfikuje się nagłówkiem powiązanym z jego rejestracją w Station (zobacz Rejestracja urządzenia). Tą samą drogą kolektor pobiera aktualizacje aplikacji ze Station. Przed instalacją aplikacja sprawdza, czy plik jest nowszą wersją PackHub Mobile, a Android instaluje tylko aktualizację podpisaną tym samym kluczem co zainstalowana aplikacja.

Dane logowania do Apilo skonfigurowane w Station (klucz API, kod autoryzacji, tokeny dostępu) są przechowywane na dysku w postaci zaszyfrowanej — na Windows przez wbudowany mechanizm DPAPI powiązany z kontem systemowym, na którym działa Station.

Zdjęcia pakowania a dane osobowe

Zdjęcia pakowania mogą pokazywać dane odbiorcy, np. etykietę przewozową albo dokument sprzedaży w kartonie. Kolektor wysyła je tylko do Station w sieci lokalnej, a Station zapisuje je wyłącznie na dysku wskazanym w ustawieniach — nie trafiają do Apilo ani do Shopvil (w Apilo jest tylko notatka z liczbą zdjęć). Zdjęcia przechowujesz więc Ty, jako sprzedawca, na własnym komputerze: ustaw czas przechowywania zgodnie ze swoją polityką retencji i zadbaj o dostęp do folderu (zobacz Zdjęcia pakowania). Nie wybieraj folderu synchronizowanego z chmurą (np. OneDrive), jeśli zdjęcia nie mają tam trafiać.

FAQ

Historia zmian

Zmiany w kolejnych wydaniach Shopvil PackHub. Station i Mobile wydajemy razem, pod wspólnym numerem wersji. Wersję zainstalowanej aplikacji Mobile sprawdzisz w Ustawienia / Status urządzenia.

Wersja 2026.3

Wersja 2026.2

Wsparcie techniczne

Jesteśmy dostępni, gdy potrzebujesz pomocy przy instalacji, konfiguracji lub bieżącej pracy systemu Shopvil PackHub.