xSale Connector Printer umożliwia drukowanie etykiet i dokumentów z xSale na drukarce dostępnej na Twoim komputerze lub serwerze. Aplikację instalujesz w systemie Windows, a następnie łączysz ją z xSale za pomocą kodu parowania. W panelu integracja jest dostępna pod nazwą xSale Printer.
W tym artykule znajdziesz
- Co przygotować przed instalacją
- Jak pobrać instalator z panelu xSale
- Jak zainstalować aplikację
- Jak połączyć aplikację z xSale
- Jak sprawdzić połączenie i przygotować drukowanie
- Jak wykonać test wydruku w kreatorze i edytorze
- Gdzie sprawdzić historię i logi wydruków
- Jak zarządzać połączeniem w panelu
- Jak korzystać z kilku instalacji
- Jak zaktualizować aplikację
- Jak rozwiązać najczęstsze problemy
Co przygotować przed instalacją?
- Komputer lub serwer z systemem Windows, na którym możesz uruchamiać aplikacje okienkowe i instalować oprogramowanie.
- Drukarkę zainstalowaną w Windows i dostępną dla użytkownika uruchamiającego aplikację. Przed konfiguracją sprawdź, czy możesz wykonać wydruk z tego komputera.
- Dostęp do Internetu.
- Konto z odpowiednimi uprawnieniami administratora w xSale do dodania i obsługi integracji.
Printer musi być uruchomiony na komputerze mającym dostęp do drukarki. Samo otwarcie panelu xSale w przeglądarce nie zastępuje działania aplikacji. Jeżeli nie masz pewności, czy środowisko Twojego serwera pozwala na jej uruchomienie, skontaktuj się z administratorem lub wsparciem xSale.
Jak pobrać instalator z panelu xSale?
- Przejdź do Integracje → Integracje.
- W sekcji Pozostałe integracje wybierz kafelek xSale Printer, aby otworzyć kreator.
W kreatorze kliknij Pobierz instalator xSale Printer. Na tym etapie nie musisz jeszcze uzupełniać nazwy ani kodu. Wrócisz do tych pól po zainstalowaniu i uruchomieniu aplikacji.
Jak zainstalować aplikację?
- Uruchom pobrany instalator na komputerze lub serwerze, z którego będą wykonywane wydruki.
- W polu Nazwa instancji (opcjonalnie) możesz wpisać nazwę ułatwiającą rozpoznanie instalacji, np. Magazyn A. Dla pojedynczej instalacji możesz pozostawić to pole puste.
- W polu Środowisko pozostaw Produkcja, jeśli korzystasz z produkcyjnego xSale. Opcję Devel (testy) wybieraj tylko do pracy ze środowiskiem testowym.
- Sprawdź Katalog instalacji. Możesz pozostawić proponowaną lokalizację. Dla dodatkowej, niezależnej instalacji wybierz osobny katalog.
- Wybierz potrzebne opcje: Utwórz skrót na pulpicie, Uruchamiaj automatycznie po zalogowaniu i Uruchom program po instalacji.
- Kliknij Instaluj. Po zakończeniu uruchom aplikację, jeżeli nie uruchomiła się automatycznie.
Opcja automatycznego uruchamiania dotyczy zalogowania do konta Windows, dla którego utworzono skrót. Nie oznacza uruchamiania printera jako usługi systemowej przed zalogowaniem.
Jak połączyć aplikację z xSale?
Po pierwszym uruchomieniu aplikacja wyświetli kod w obszarze Twój klucz. Do czasu zakończenia parowania może pokazywać Brak połączenia oraz komunikaty oczekiwania na zatwierdzenie.
- Kliknij klucz w aplikacji, aby otworzyć kreator w panelu xSale z uzupełnionym kodem. Możesz też wrócić do wcześniej otwartego kreatora i wpisać kod ręcznie.
- Upewnij się, że pracujesz we właściwej organizacji xSale.
- W polu Nazwa wpisz nazwę pozwalającą rozpoznać stanowisko, np. Drukarka magazyn. To nazwa integracji w xSale, a nie nazwa fizycznej drukarki w Windows.
- Sprawdź pole Kod z aplikacji printera i kliknij Sparuj.
Po sparowaniu aplikacji przejdź do kroku Test wydruku, aby sprawdzić drukowanie, lub wybierz Pomiń i zakończ. Test możesz później powtórzyć w edytorze integracji.
Nie udostępniaj kodu osobom nieuprawnionym. Do połączenia użyj kodu wyświetlanego przez swoją aplikację, a nie wartości z przykładowego zrzutu.
Jak sprawdzić połączenie i przygotować drukowanie?
Wróć do aplikacji na komputerze. Po nawiązaniu połączenia na dole okna pojawi się zielony wskaźnik i status Połączono. W Logu zdarzeń możesz sprawdzić komunikaty dotyczące pracy aplikacji.
W panelu xSale integracja będzie widoczna w sekcji Twoje integracje pod nazwą podaną podczas parowania.
Połączenie aplikacji nie kończy konfiguracji stanowiska drukującego. Sprawdź przypisanie printera i drukarki do użytkownika zgodnie z instrukcją Przypisanie drukarki do operatora WMS Packing. Nazwa drukarki musi odpowiadać jej nazwie w systemie Windows na komputerze, na którym działa printer.
Na koniec wykonaj testowy wydruk i sprawdź jego rezultat na drukarce. Zielony status połączenia nie potwierdza, że dokument został fizycznie wydrukowany.
Jak wykonać test wydruku?
Po sparowaniu aplikacji w kreatorze integracji dostępny jest krok Test wydruku. Test możesz również wykonać w dowolnej chwili: otwórz Integracje → Integracje, przejdź do edycji swojego xSale Printera i wybierz zakładkę Test wydruku.
Podczas testu komputer musi być włączony, a aplikacja xSale Connector Printer uruchomiona i połączona z xSale. Drukarka musi być włączona i dostępna z tego komputera. Samo otwarcie kreatora lub edytora w przeglądarce nie uruchamia aplikacji printera.
- W polu Nazwa drukarki wpisz dokładną nazwę widoczną w ustawieniach drukarek systemu Windows na komputerze, na którym działa printer. Zachowaj pełną nazwę, w tym spacje i znaki. Nie wpisuj nazwy integracji w xSale.
- Wybierz rodzaj testu: Wydruk testowy – A4, Wydruk testowy – etykieta (100 × 150 mm) albo Własny plik PDF. Dla własnego dokumentu dodaj plik PDF o rozmiarze do 500 kB.
- Kliknij Wykonaj wydruk testowy.
- Sprawdź, czy dokument został wydrukowany na wskazanej drukarce i czy jego format jest odpowiedni.
Jeżeli nie chcesz wykonywać testu podczas konfiguracji, wybierz Pomiń i zakończ. Możesz wrócić do testu później w edytorze integracji.
Jeśli wydruk się nie pojawi, sprawdź dokładną nazwę drukarki, status połączenia i log zdarzeń w aplikacji printera oraz możliwość drukowania z Windows. Sam status połączenia lub wysłanie testu nie potwierdza fizycznego wydrukowania dokumentu.
Historia i logi wydruków
Przebieg zlecenia wydruku możesz sprawdzić w trzech miejscach: podczas testu, w historii zamówienia oraz w zakładce Historia wydruków w edytorze integracji. Wybierz miejsce odpowiednie do tego, co chcesz zweryfikować.
Stan wydruku testowego
Po uruchomieniu testu w kreatorze lub edytorze integracji, na etapie Test wydruku, pojawia się obszar Stan wydruku. Pokazuje wybrany dokument, status zlecenia, datę i godzinę wysłania oraz odpowiedzi, a także komunikat, jeśli został zwrócony.
Podczas oczekiwania panel sprawdza odpowiedź. Jeżeli pojawi się błąd, przeczytaj komunikat i usuń jego przyczynę przed kolejnym testem. Printer musi być uruchomiony, a wpisana nazwa drukarki musi dokładnie odpowiadać nazwie w Windows.

Wydruki w historii zamówienia
Otwórz zamówienie i rozwiń sekcję Historia zamówienia. Zlecenia wydruku powiązane z tym zamówieniem są widoczne jako zdarzenia Wydruk. Przy zdarzeniu możesz sprawdzić datę i godzinę, status oraz dostępne szczegóły, np. nazwę integracji lub stanowiska, źródło zlecenia i komunikat odpowiedzi.
Ten widok pomaga wyjaśnić problem z dokumentem lub etykietą konkretnego zamówienia. Pokazuje zlecenia powiązane z zamówieniem, a nie wszystkie wydruki z danego stanowiska. Przykładowo komunikat o nieznalezieniu aktywnej drukarki wymaga sprawdzenia jej nazwy i dostępności na komputerze, na którym działa Printer.

Zakładka Historia wydruków
- Przejdź do Integracje → Integracje.
- W sekcji Twoje integracje otwórz właściwą integrację xSale Printer.
- Wybierz zakładkę Historia wydruków.
Lista pokazuje zlecenia wydruku dla wybranej integracji z ostatnich 30 dni. Znajdziesz tu kolumny Wysłano, Status, Komunikat, Odpowiedź drukarki, Czas wykonania i ID zlecenia.
Użyj filtrów Wysłano od i Wysłano do, aby zawęzić okres, lub wpisz ID zlecenia, aby odnaleźć konkretną operację. Przycisk Wyczyść filtry usuwa ograniczenia wyszukiwania, a Odśwież pobiera aktualne dane. Odświeżanie historii nie uruchamia ponownie wydruku.
ID zlecenia możesz skopiować ikoną obok numeru i przekazać wsparciu xSale razem z komunikatem błędu. Kolumna Czas wykonania dotyczy obsługi zlecenia i odpowiedzi, nie pomiaru czasu fizycznego drukowania.

Jak rozumieć statusy wydruków?
| Status | Znaczenie i zalecane działanie |
|---|---|
| Wysyłanie zlecenia… | Trwa wysyłanie zlecenia. Poczekaj na zmianę statusu. |
| Oczekiwanie na odpowiedź drukarki… | Nie ma jeszcze odpowiedzi dotyczącej zlecenia. Sprawdź, czy aplikacja Printer działa i ma połączenie z Internetem. |
| Drukarka potwierdziła zlecenie | Odebrano pozytywną odpowiedź dotyczącą obsługi zlecenia. Sprawdź również wydruk na urządzeniu. |
| Drukarka zgłosiła błąd | Odebrano odpowiedź o błędzie. Przeczytaj komunikat, sprawdź wskazaną przyczynę i popraw konfigurację lub dostępność urządzenia. |
| Brak odpowiedzi drukarki | W przewidzianym czasie nie odebrano odpowiedzi. Nie oznacza to automatycznie, że dokument nie został wydrukowany. |
| Sprzeczne odpowiedzi drukarki / Nierozpoznana odpowiedź drukarki | Nie można jednoznacznie określić wyniku na podstawie odpowiedzi. Sprawdź urządzenie i historię; jeśli problem pozostaje, przekaż wsparciu komunikat oraz ID zlecenia. |
| Stan wydruku jest niedostępny / Odpowiedź niewymagana | Nie ma potwierdzonego wyniku wydruku w tym widoku lub dla zlecenia nie oczekuje się odpowiedzi. Sam status nie potwierdza fizycznego wydrukowania dokumentu. |
Potwierdzenie zlecenia nie jest gwarancją fizycznego wydruku. Gdy dokument się nie pojawi, sprawdź kolejkę wydruku w Windows, dostępność drukarki, papier i komunikaty urządzenia. Przy braku odpowiedzi lub niepewnym wyniku sprawdź najpierw, czy wydruk już powstał, zanim ponowisz zlecenie. Pozwoli to uniknąć podwójnego drukowania.
Jak zarządzać połączeniem w panelu?
Otwórz edycję dodanej integracji xSale Printer. W sekcji Stan połączenia znajdziesz komunikat dotyczący konfiguracji oraz tabelę z kolumnami Serwer, Stan i Kod błędu.
- Odśwież pobiera aktualny stan konfiguracji. Nie uruchamia ponownie aplikacji ani nie ponawia konfiguracji.
- Ponów konfigurację teraz jest dostępne, gdy konfiguracja nie została ukończona i potwierdzona przez aplikację. Po usunięciu przyczyny błędu pozwala ponowić jej przygotowanie.
- Odłącz printer rozłącza powiązanie z xSale po potwierdzeniu operacji. Nie odinstalowuje programu z komputera. Nie używaj tej opcji do zwykłego zamknięcia okna.
Komunikat Printer jest połączony w edytorze oznacza, że konfiguracja została przygotowana i jej odbiór został potwierdzony przez aplikację. Nie jest bieżącym potwierdzeniem, że komputer i drukarka są dostępne. W razie problemów sprawdź również status w lokalnej aplikacji oraz wykonaj testowy wydruk.
Jak korzystać z kilku instalacji?
Na jednym komputerze możesz uruchomić kilka niezależnych instalacji xSale Connector Printer. Dla każdej wybierz osobny katalog, nadaj rozpoznawalną nazwę instancji i wykonaj osobne parowanie z xSale.
Nie twórz kolejnej instalacji przez kopiowanie katalogu już skonfigurowanego printera. Nie kopiuj między instalacjami pliku RabbitConfig.json, ponieważ zawiera on dane powiązania. Aplikacja zabezpiecza się przed równoczesnym użyciem tego samego powiązania przez dwie instalacje.
Konfiguracja nowej instalacji jest zabezpieczona na danym komputerze. Nie przenoś jej plików na inny komputer lub do innej instalacji Windows. Konto uruchamiające printer musi mieć dostęp do jego plików oraz do drukarki.
Jak zaktualizować aplikację?
Aktualizację wykonaj poza czasem drukowania etykiet i dokumentów. Aby zaktualizować aplikację za pomocą instalatora:
- Pobierz instalator i zamknij aktualizowaną aplikację xSale Connector Printer.
- Wskaż katalog istniejącej instalacji i zachowaj jej nazwę instancji.
- Sprawdź ustawienia. Środowisko istniejącej instalacji jest zachowywane; nie można zmienić go przy aktualizacji tego samego katalogu.
- Kliknij Instaluj, a następnie uruchom aplikację.
- Sprawdź połączenie i wykonaj testowy wydruk.
Instalator zachowuje konfigurację i dane powiązania. Jeśli korzystasz z kilku instalacji, aktualizuj każdą osobno, wskazując właściwy katalog. Nie usuwaj plików konfiguracji w ramach standardowej aktualizacji.
Jak rozwiązać najczęstsze problemy?
Kod jest nieprawidłowy, wygasł albo został już użyty
Sprawdź kod wyświetlany obecnie w aplikacji oraz wybrane środowisko. Nie używaj kodu z wcześniejszego zrzutu lub innej instalacji. Jeśli edytor informuje o wygaśnięciu niedokończonej sesji, odłącz tę niedokończoną integrację i rozpocznij parowanie z aktualnym kodem. Jeśli problem się powtarza, przekaż wsparciu xSale komunikat błędu.
Konfiguracja nie została ukończona
Otwórz edytor integracji i kliknij Odśwież. Sprawdź stan oraz kod błędu. Po usunięciu przyczyny skorzystaj z Ponów konfigurację teraz, jeśli przycisk jest dostępny. Samo odświeżanie nie ponawia konfiguracji. Jeśli nie wiesz, jak usunąć błąd, skontaktuj się ze wsparciem xSale.
Odłączanie nie zostało zakończone
Jeśli pojawia się komunikat o nieukończonym odłączaniu, obsługa printera w xSale jest zablokowana. Po przywróceniu dostępności serwerów ponów Odłącz printer. Jeżeli błąd pozostaje, zgłoś go do wsparcia.
Printer jest sparowany, ale nie drukuje
- Sprawdź, czy komputer jest włączony, a aplikacja działa i pokazuje Połączono.
- Sprawdź dostęp do Internetu oraz komunikaty w logu aplikacji.
- Sprawdź, czy drukarka jest dostępna z tego komputera i czy można na niej wykonać wydruk z Windows.
- Sprawdź przypisanie printera do użytkownika oraz dokładną nazwę drukarki w jego ustawieniach.
- Jeżeli nadal nie możesz drukować, przekaż wsparciu xSale komunikat z logu oraz nazwę integracji. Nie przesyłaj plików z danymi autoryzacyjnymi w publicznych zgłoszeniach.
Instalator informuje, że aplikacja jest uruchomiona
Zamknij aplikację z katalogu, który aktualizujesz, i ponów instalację. Jeśli działa kilka instancji, upewnij się, że zamykasz właściwą.
Nie możesz odczytać konfiguracji lub uruchomić drugiej instalacji
Sprawdź, czy każda instalacja ma osobny katalog i czy nie skopiowano do niej konfiguracji z innego stanowiska. Nie usuwaj konfiguracji działającej instalacji. W przypadku błędu odczytu lub niejasnego powiązania skontaktuj się ze wsparciem xSale.

EN







