Etykiety przesyłkowe generowane automatycznie - integracja sklepu z kurierem

Etykiety przesyłkowe generowane automatycznie to rozwiązanie, w którym integracja sklepu z kurierem sama tworzy przesyłkę, pobiera etykietę i wysyła ją na drukarkę w chwili określonego zdarzenia, np. opłacenia zamówienia albo zeskanowania go na stanowisku pakowania. Pracownik magazynu nie przepisuje adresów i nie pobiera plików z panelu przewoźnika, tylko nakleja gotową etykietę. Żeby to działało, trzeba dobrze wybrać moment generowania, format pliku i sposób drukowania.

W tym wpisie nie porównujemy przewoźników ani agregatorów, tylko pokazujemy, jak zaprojektować samą automatyzację etykiet: co ma ją uruchamiać, jak wysłać plik prosto do drukarki termicznej, jak pobierać etykiety zbiorczo i co zrobić, gdy zamówienie zmieni się po wydruku. Opieramy się na dokumentacji API InPost ShipX i Allegro, ale zasady są wspólne dla większości przewoźników.

[#wazne] W skrócie: automatyczne etykiety przesyłkowe wymagają trzech decyzji - co uruchamia utworzenie przesyłki (status, harmonogram lub skan), w jakim formacie pobierać etykietę (PDF dla zwykłych drukarek, ZPL lub EPL dla termicznych) i jak plik trafia do drukarki bez okna dialogowego przeglądarki. Do tego potrzebne są obsługa anulacji po wydruku i raport zamówień bez etykiety. Programiści Vinson budują takie automatyzacje w WooCommerce, Shoperze, PrestaShop, Shopify i Base.

Na czym polegają etykiety przesyłkowe generowane automatycznie

Etykieta przesyłkowa to dokument z danymi odbiorcy, kodem kreskowym i numerem przesyłki, który przewoźnik generuje po przyjęciu zlecenia nadania. W ręcznym procesie pracownik otwiera zamówienie, kopiuje dane do panelu kuriera, pobiera PDF i drukuje go. W procesie automatycznym te same kroki wykonuje integracja: wysyła do API przewoźnika dane zamówienia, czeka na potwierdzenie, pobiera plik i przekazuje go do druku, a numer przesyłki zapisuje w zamówieniu.

Sam mechanizm łączenia sklepu z API przewoźnika i wybór między bezpośrednią integracją a agregatorem opisaliśmy we wpisie integracja z kurierami przez API - jak wybrać agregator. Tutaj zakładamy, że takie połączenie już istnieje, i skupiamy się na tym, jak przestać klikać przy każdej paczce. Poniżej typowy przebieg automatycznego generowania etykiety.

[#chart:wpr66a]

Kluczowe jest to, że utworzenie przesyłki i pobranie etykiety to często dwa osobne kroki. W API InPost ShipX przesyłka po utworzeniu ma najpierw status created i nie ma jeszcze numeru do śledzenia. Etykietę można pobrać dopiero dla przesyłki opłaconej, w statusie confirmed lub dalszym. Integracja, która próbuje pobrać plik od razu po wysłaniu zlecenia, dostanie błąd albo pusty wynik, więc musi odczekać i zapytać ponownie.

Kiedy generować etykietę - wyzwalacze automatyzacji

Najważniejsza decyzja projektowa to moment, w którym integracja tworzy przesyłkę. Zbyt wcześnie oznacza etykiety dla zamówień, które klient zaraz zmieni lub anuluje. Zbyt późno oznacza, że pracownik czeka przy stanowisku na odpowiedź API. Są trzy podstawowe wyzwalacze, a większe sklepy łączą je w zależności od kanału sprzedaży.

Wyzwalacz	Jak działa	Zalety	Ryzyka
Zmiana statusu zamówienia	Np. po opłaceniu lub po statusie „do wysyłki” integracja tworzy przesyłkę	Etykiety gotowe przed pakowaniem	Etykiety dla zamówień później anulowanych lub zmienionych
Harmonogram (partie)	O ustalonych godzinach integracja tworzy przesyłki dla wszystkich gotowych zamówień	Jeden wydruk na partię, łatwa kontrola	Zamówienia z ostatniej chwili czekają do kolejnej partii
Skan na stanowisku pakowania	Pracownik skanuje zamówienie lub produkt, integracja tworzy przesyłkę i drukuje etykietę	Etykieta zawsze dla tego, co faktycznie pakowane	Wymaga szybkiej odpowiedzi API i stabilnej drukarki

Dla małego sklepu zwykle wystarcza wyzwalacz statusem połączony z wydrukiem zbiorczym rano i po południu. Przy większym wolumenie i wielu wariantach produktów lepiej sprawdza się skan na stanowisku, bo etykieta powstaje dla paczki, którą pracownik ma przed sobą, z rzeczywistą liczbą kartonów. Jeśli korzystasz z integratora, sprawdź, czy ma reguły uruchamiane zdarzeniem. Przykład takich reguł opisujemy w artykule Apilo automatyzacje - reguły statusów i automatyczne etykiety.

Etykiety przesyłkowe generowane automatycznie to rozwiązanie, w którym integracja sklepu z kurierem sama tworzy przesyłkę, pobiera etykietę i wysyła ją na drukarkę w chwili określonego zdarzenia, np. opłacenia zamówienia albo zeskanowania go na stanowisku pakowania. Pracownik magazynu nie przepisuje adresów i nie pobiera plików z panelu przewoźnika, tylko nakleja gotową etykietę. Żeby to działało, trzeba dobrze wybrać moment generowania, format pliku i sposób drukowania.

W tym wpisie nie porównujemy przewoźników ani agregatorów, tylko pokazujemy, jak zaprojektować samą automatyzację etykiet: co ma ją uruchamiać, jak wysłać plik prosto do drukarki termicznej, jak pobierać etykiety zbiorczo i co zrobić, gdy zamówienie zmieni się po wydruku. Opieramy się na dokumentacji API InPost ShipX i Allegro, ale zasady są wspólne dla większości przewoźników.

[#wazne] W skrócie: automatyczne etykiety przesyłkowe wymagają trzech decyzji - co uruchamia utworzenie przesyłki (status, harmonogram lub skan), w jakim formacie pobierać etykietę (PDF dla zwykłych drukarek, ZPL lub EPL dla termicznych) i jak plik trafia do drukarki bez okna dialogowego przeglądarki. Do tego potrzebne są obsługa anulacji po wydruku i raport zamówień bez etykiety. Programiści Vinson budują takie automatyzacje w WooCommerce, Shoperze, PrestaShop, Shopify i Base.

Na czym polegają etykiety przesyłkowe generowane automatycznie

Etykieta przesyłkowa to dokument z danymi odbiorcy, kodem kreskowym i numerem przesyłki, który przewoźnik generuje po przyjęciu zlecenia nadania. W ręcznym procesie pracownik otwiera zamówienie, kopiuje dane do panelu kuriera, pobiera PDF i drukuje go. W procesie automatycznym te same kroki wykonuje integracja: wysyła do API przewoźnika dane zamówienia, czeka na potwierdzenie, pobiera plik i przekazuje go do druku, a numer przesyłki zapisuje w zamówieniu.

Sam mechanizm łączenia sklepu z API przewoźnika i wybór między bezpośrednią integracją a agregatorem opisaliśmy we wpisie integracja z kurierami przez API - jak wybrać agregator. Tutaj zakładamy, że takie połączenie już istnieje, i skupiamy się na tym, jak przestać klikać przy każdej paczce. Poniżej typowy przebieg automatycznego generowania etykiety.

[#chart:wpr66a]

Kluczowe jest to, że utworzenie przesyłki i pobranie etykiety to często dwa osobne kroki. W API InPost ShipX przesyłka po utworzeniu ma najpierw status created i nie ma jeszcze numeru do śledzenia. Etykietę można pobrać dopiero dla przesyłki opłaconej, w statusie confirmed lub dalszym. Integracja, która próbuje pobrać plik od razu po wysłaniu zlecenia, dostanie błąd albo pusty wynik, więc musi odczekać i zapytać ponownie.

Kiedy generować etykietę - wyzwalacze automatyzacji

Najważniejsza decyzja projektowa to moment, w którym integracja tworzy przesyłkę. Zbyt wcześnie oznacza etykiety dla zamówień, które klient zaraz zmieni lub anuluje. Zbyt późno oznacza, że pracownik czeka przy stanowisku na odpowiedź API. Są trzy podstawowe wyzwalacze, a większe sklepy łączą je w zależności od kanału sprzedaży.

Wyzwalacz	Jak działa	Zalety	Ryzyka
Zmiana statusu zamówienia	Np. po opłaceniu lub po statusie „do wysyłki” integracja tworzy przesyłkę	Etykiety gotowe przed pakowaniem	Etykiety dla zamówień później anulowanych lub zmienionych
Harmonogram (partie)	O ustalonych godzinach integracja tworzy przesyłki dla wszystkich gotowych zamówień	Jeden wydruk na partię, łatwa kontrola	Zamówienia z ostatniej chwili czekają do kolejnej partii
Skan na stanowisku pakowania	Pracownik skanuje zamówienie lub produkt, integracja tworzy przesyłkę i drukuje etykietę	Etykieta zawsze dla tego, co faktycznie pakowane	Wymaga szybkiej odpowiedzi API i stabilnej drukarki

Dla małego sklepu zwykle wystarcza wyzwalacz statusem połączony z wydrukiem zbiorczym rano i po południu. Przy większym wolumenie i wielu wariantach produktów lepiej sprawdza się skan na stanowisku, bo etykieta powstaje dla paczki, którą pracownik ma przed sobą, z rzeczywistą liczbą kartonów. Jeśli korzystasz z integratora, sprawdź, czy ma reguły uruchamiane zdarzeniem. Przykład takich reguł opisujemy w artykule Apilo automatyzacje - reguły statusów i automatyczne etykiety.

Format etykiety i drukarka - PDF, ZPL czy EPL

Przewoźnicy zwykle udostępniają etykiety w kilku formatach. Dokumentacja InPost ShipX podaje formaty PDF, ZPL i EPL oraz typy normal i A6. Dla przesyłek kurierskich format EPL zwraca plik EPL, a dla paczkomatów i przesyłek Allegro plik EPL2. Wariant o rozdzielczości 300 dpi jest dostępny tylko dla ZPL i wybranych usług (stan na lipiec 2026 - sprawdź aktualną dokumentację przewoźnika). Inni przewoźnicy mają podobne opcje, ale inne nazwy parametrów.

Wybór formatu wynika z drukarki. PDF nadaje się do zwykłych drukarek biurowych i do podglądu na ekranie, ale przy drukarce termicznej wymaga skalowania i sterownika, który poprawnie ustawi rozmiar. ZPL i EPL to języki poleceń drukarek termicznych: plik trafia bezpośrednio do drukarki, bez renderowania, więc wydruk jest szybszy i ostrzejszy. Warunek jest jeden - drukarka musi obsługiwać dany język, co trzeba sprawdzić w jej specyfikacji.

Druga decyzja to przechowywanie plików. Integracja może pobierać etykietę z API za każdym razem, gdy jest potrzebna, albo zapisać ją przy zamówieniu po pierwszym pobraniu. Zapisany plik przyspiesza ponowny wydruk i działa nawet wtedy, gdy API przewoźnika chwilowo nie odpowiada. Trzeba jednak pamiętać, że etykieta zawiera dane osobowe odbiorcy, więc pliki powinny leżeć w miejscu z kontrolą dostępu i być usuwane po okresie, który ustalisz w polityce przechowywania danych. Szczegóły takiej polityki warto skonsultować z osobą odpowiedzialną za ochronę danych w firmie. Przy wysyłce zbiorczej dobrze też zapisywać, w której partii została wydrukowana dana etykieta - ułatwia to szukanie paczek, które nie wyjechały z magazynu.

[#chart:wpr66b]

Jak wysłać etykietę prosto na drukarkę

Najczęstszy hamulec automatyzacji to okno drukowania w przeglądarce. Integracja pobiera plik w sekundę, a pracownik i tak musi kliknąć „Drukuj” i wybrać drukarkę. Są trzy sposoby, żeby tego uniknąć:

Usługa druku zdalnego - na komputerze przy stanowisku instaluje się klienta usługi, a integracja wysyła zadania druku przez API. Przykładem jest PrintNode, który według dokumentacji producenta przyjmuje pliki PDF i dane RAW, w tym ZPL i EPL.
Drukarka sieciowa - drukarka z kartą sieciową przyjmuje zadania bezpośrednio z serwera w sieci lokalnej. Wymaga to serwera w tej samej sieci albo bezpiecznego połączenia z magazynem.
Aplikacja integratora - część integratorów ma własny program do druku instalowany na komputerze magazynowym. Zakres jego funkcji trzeba sprawdzić w pomocy danego narzędzia.

Przy kilku stanowiskach pakowania integracja musi wiedzieć, na którą drukarkę wysłać etykietę. Najprościej przypisać drukarkę do użytkownika lub stanowiska, które zeskanowało zamówienie. Przy wydruku zbiorczym warto drukować w kolejności lokalizacji w magazynie albo nazw produktów, żeby etykiety leżały w tej samej kolejności co kompletowany towar.

Etykiety zbiorcze i limity API przewoźnika

Gdy etykiety powstają w partiach, nie warto pobierać każdej osobno. ShipX ma osobny zasób do pobrania wielu etykiet jednym żądaniem: według dokumentacji maksymalnie 100 w jednym zapytaniu, tylko dla przesyłek opłaconych, a etykiety może pobrać wyłącznie nadawca. Jeśli przesyłki dotyczą jednej usługi, wynik przychodzi w jednym pliku, a przy różnych usługach w archiwum ZIP z osobnym plikiem dla każdej z nich (stan na lipiec 2026). Integracja musi więc dzielić duże partie na paczki po 100 i umieć rozpakować archiwum.

Zamówienia z Allegro obsługiwane w programie Wysyłam z Allegro wymagają osobnej ścieżki. Allegro udostępnia w REST API zasoby do zarządzania przesyłkami, w tym tworzenie etykiety (POST /shipment-management/label), a starsze zasoby parcel-management zostały wyłączone na początku 2025 roku. Integracja, która nadal korzysta ze starych adresów, przestała działać, więc przy przeglądzie automatyzacji warto sprawdzić, z jakiej wersji API korzysta.

Skan na stanowisku pakowania - jak go zaprojektować

Wyzwalacz skanem daje najwięcej kontroli, ale wymaga przemyślenia kilku szczegółów. Po pierwsze, co jest skanowane: kod zamówienia z wydrukowanej listy kompletacyjnej czy kod EAN produktu. Skan produktu pozwala przy okazji sprawdzić, czy do paczki trafia właściwy towar, ale przy zamówieniach wielopozycyjnych integracja musi wiedzieć, kiedy zamówienie jest kompletne. Po drugie, ile kartonów ma paczka i jaki mają gabaryt - pracownik powinien móc to potwierdzić jednym kliknięciem, zanim integracja wyśle zlecenie do przewoźnika. Po trzecie, co się dzieje, gdy API nie odpowiada: stanowisko powinno pokazać czytelny komunikat i pozwolić odłożyć zamówienie na bok, a nie zawiesić się na kilka minut.

Dokumenty generowane razem z etykietą

Etykieta rzadko jest jedynym dokumentem, który powstaje przy pakowaniu. Automatyzacja może w tym samym kroku przygotować pozostałe wydruki, żeby pracownik nie musiał ich zbierać z różnych systemów:

Lista pakowania - zawartość paczki z ilościami, przydatna przy reklamacjach i zamówieniach wielokartonowych.
Dokument sprzedaży - jeśli wkładasz do paczki fakturę lub paragon, ich wydruk powinien powstać przed zamknięciem kartonu, a nie po wysyłce.
Zestawienie nadań - lista przesyłek przekazywanych kurierowi albo zlecenie odbioru, jeśli przewoźnik ich wymaga. Ułatwia sprawdzenie, czy wszystkie paczki wyjechały z magazynu.

Warto pilnować kolejności. Jeśli dokument sprzedaży jest wystawiany automatycznie po zmianie statusu na „wysłane”, a status zmienia się dopiero po wygenerowaniu etykiety, faktura nie zdąży trafić do paczki. Wtedy lepiej wysyłać ją klientowi mailem albo przestawić kolejność kroków.

Najczęstsze błędy przy automatycznym generowaniu etykiet

Problemy z automatycznymi etykietami rzadko wynikają z samej drukarki. Częściej to skutek założeń, które działały przy ręcznym procesie, a w automacie przestają:

Zmiana zamówienia po wygenerowaniu etykiety - klient dopisuje produkt lub zmienia punkt odbioru, a magazyn nakleja starą etykietę. Integracja powinna oznaczać takie zamówienie i wymagać nowej przesyłki.
Anulacja bez anulowania przesyłki - zamówienie jest anulowane w sklepie, ale przesyłka u przewoźnika zostaje i może zostać rozliczona. Anulowanie zamówienia musi uruchamiać anulowanie przesyłki, jeśli przewoźnik na to pozwala.
Paczki wielokartonowe - zamówienie mieści się w dwóch kartonach, a automat tworzy jedną przesyłkę. Przy wyzwalaczu statusem warto mieć regułę dla dużych zamówień albo przejść na skan.
Brak etykiety bez alarmu - API zwróciło błąd, a zamówienie leży w statusie „do wysyłki” bez pliku. Potrzebny jest raport zamówień bez numeru przesyłki.
Zły rozmiar wydruku - plik A4 drukowany na rolce 100 x 150 mm albo odwrotnie. Typ etykiety w integracji musi odpowiadać papierowi w drukarce.

[#chart:wpr66c]

[#uwaga] Ponowne wygenerowanie etykiety nie zawsze oznacza ponowne pobranie tego samego pliku. Jeśli integracja po błędzie drukarki tworzy nową przesyłkę zamiast pobrać istniejącą etykietę, powstają dwie przesyłki dla jednego zamówienia. Funkcja „drukuj ponownie” powinna zawsze pobierać plik dla istniejącego numeru przesyłki.

Jak wdrożyć automatyczne etykiety przesyłkowe krok po kroku

Wdrożenie warto podzielić na etapy, zaczynając od jednego przewoźnika i jednego kanału sprzedaży:

spisz metody dostawy w każdym kanale i przypisz im usługę przewoźnika oraz domyślny gabaryt,
uzupełnij wagę i wymiary produktów, z których integracja ma liczyć paczkę,
wybierz wyzwalacz i format etykiety zgodny z drukarkami na stanowiskach,
przetestuj tworzenie przesyłek w środowisku testowym przewoźnika, jeśli je udostępnia,
uruchom automatyzację dla części zamówień, np. jednego kanału, i porównuj wyniki z ręcznym procesem,
dodaj raport zamówień bez etykiety i alarm o serii błędów API.

[#checklista] Przed uruchomieniem sprawdź: czy każda metoda dostawy ma przypisaną usługę przewoźnika; czy produkty mają wagę i wymiary; czy drukarki obsługują wybrany format; czy anulowanie zamówienia anuluje przesyłkę; czy „drukuj ponownie” nie tworzy nowej przesyłki; kto dostaje alarm, gdy etykiety przestaną się generować.

Jeśli sklep działa na WooCommerce i korzysta z wtyczek przewoźników, część tych funkcji może już mieć. O tym, co oferują wtyczki DPD, DHL i GLS, piszemy we wpisie DPD, DHL i GLS w WooCommerce - jak podłączyć kurierów i drukować etykiety. Własna automatyzacja ma sens dopiero wtedy, gdy gotowe narzędzia nie obsługują Twojego wyzwalacza, drukarek albo kilku kanałów naraz.

Jak Vinson pomaga z automatycznymi etykietami przesyłkowymi

Programiści Vinson projektują i wdrażają automatyczne generowanie etykiet w sklepach na WooCommerce, Shoperze, PrestaShop i Shopify, w Base i we własnych systemach klientów. Dobieramy wyzwalacz do sposobu pracy magazynu, konfigurujemy formaty etykiet i druk bez okna dialogowego, budujemy obsługę anulacji, paczek wielokartonowych i ponownego wydruku, a także raporty zamówień bez etykiety. Poprawiamy też automatyzacje, które przestały działać po zmianach w API przewoźnika. Więcej na stronie Wsparcie programistyczne dla e-commerce.

Najczęściej zadawane pytania

Jak automatycznie generować etykiety kurierskie w sklepie internetowym?

Potrzebna jest integracja sklepu lub integratora z API przewoźnika i reguła, która uruchamia utworzenie przesyłki, np. zmiana statusu zamówienia albo skan na stanowisku pakowania. Integracja tworzy przesyłkę, pobiera etykietę po potwierdzeniu i przekazuje ją do druku, a numer przesyłki zapisuje w zamówieniu.

Jaki format etykiety wybrać do drukarki termicznej?

Do drukarek termicznych najlepiej nadają się ZPL lub EPL, jeśli drukarka obsługuje dany język. Plik trafia wtedy bezpośrednio do drukarki bez skalowania. PDF też zadziała, ale wymaga poprawnych ustawień sterownika i rozmiaru papieru.

Czy można drukować etykiety bez klikania „Drukuj” w przeglądarce?

Tak. Można użyć usługi druku zdalnego z klientem zainstalowanym przy drukarce, drukarki sieciowej przyjmującej zadania z serwera albo programu do druku udostępnianego przez integrator. Wybór zależy od tego, gdzie działa integracja i ile jest stanowisk pakowania.

Ile etykiet InPost można pobrać jednym zapytaniem do API?

Według dokumentacji ShipX jednym zapytaniem można pobrać maksymalnie 100 etykiet, tylko dla przesyłek opłaconych. Przy różnych usługach wynik przychodzi jako archiwum ZIP z osobnymi plikami. Przed wdrożeniem warto sprawdzić aktualną dokumentację InPost.

Co zrobić, gdy zamówienie zmieni się po wydrukowaniu etykiety?

Starą przesyłkę trzeba anulować u przewoźnika, jeśli to możliwe, i utworzyć nową z aktualnymi danymi. Integracja powinna oznaczać zamówienia zmienione po wygenerowaniu etykiety, żeby magazyn nie nakleił nieaktualnego wydruku.

Automatyczne etykiety przesyłkowe oszczędzają czas tylko wtedy, gdy obejmują cały cykl: wyzwalacz, format, druk, anulację i kontrolę braków. Jeśli chcesz zautomatyzować wysyłki w swoim sklepie, sprawdź wsparcie programistyczne Vinson.

Format etykiety i drukarka - PDF, ZPL czy EPL

Przewoźnicy zwykle udostępniają etykiety w kilku formatach. Dokumentacja InPost ShipX podaje formaty PDF, ZPL i EPL oraz typy normal i A6. Dla przesyłek kurierskich format EPL zwraca plik EPL, a dla paczkomatów i przesyłek Allegro plik EPL2. Wariant o rozdzielczości 300 dpi jest dostępny tylko dla ZPL i wybranych usług (stan na lipiec 2026 - sprawdź aktualną dokumentację przewoźnika). Inni przewoźnicy mają podobne opcje, ale inne nazwy parametrów.

Wybór formatu wynika z drukarki. PDF nadaje się do zwykłych drukarek biurowych i do podglądu na ekranie, ale przy drukarce termicznej wymaga skalowania i sterownika, który poprawnie ustawi rozmiar. ZPL i EPL to języki poleceń drukarek termicznych: plik trafia bezpośrednio do drukarki, bez renderowania, więc wydruk jest szybszy i ostrzejszy. Warunek jest jeden - drukarka musi obsługiwać dany język, co trzeba sprawdzić w jej specyfikacji.

Druga decyzja to przechowywanie plików. Integracja może pobierać etykietę z API za każdym razem, gdy jest potrzebna, albo zapisać ją przy zamówieniu po pierwszym pobraniu. Zapisany plik przyspiesza ponowny wydruk i działa nawet wtedy, gdy API przewoźnika chwilowo nie odpowiada. Trzeba jednak pamiętać, że etykieta zawiera dane osobowe odbiorcy, więc pliki powinny leżeć w miejscu z kontrolą dostępu i być usuwane po okresie, który ustalisz w polityce przechowywania danych. Szczegóły takiej polityki warto skonsultować z osobą odpowiedzialną za ochronę danych w firmie. Przy wysyłce zbiorczej dobrze też zapisywać, w której partii została wydrukowana dana etykieta - ułatwia to szukanie paczek, które nie wyjechały z magazynu.

[#chart:wpr66b]

Jak wysłać etykietę prosto na drukarkę

Najczęstszy hamulec automatyzacji to okno drukowania w przeglądarce. Integracja pobiera plik w sekundę, a pracownik i tak musi kliknąć „Drukuj” i wybrać drukarkę. Są trzy sposoby, żeby tego uniknąć:

Usługa druku zdalnego - na komputerze przy stanowisku instaluje się klienta usługi, a integracja wysyła zadania druku przez API. Przykładem jest PrintNode, który według dokumentacji producenta przyjmuje pliki PDF i dane RAW, w tym ZPL i EPL.
Drukarka sieciowa - drukarka z kartą sieciową przyjmuje zadania bezpośrednio z serwera w sieci lokalnej. Wymaga to serwera w tej samej sieci albo bezpiecznego połączenia z magazynem.
Aplikacja integratora - część integratorów ma własny program do druku instalowany na komputerze magazynowym. Zakres jego funkcji trzeba sprawdzić w pomocy danego narzędzia.

Przy kilku stanowiskach pakowania integracja musi wiedzieć, na którą drukarkę wysłać etykietę. Najprościej przypisać drukarkę do użytkownika lub stanowiska, które zeskanowało zamówienie. Przy wydruku zbiorczym warto drukować w kolejności lokalizacji w magazynie albo nazw produktów, żeby etykiety leżały w tej samej kolejności co kompletowany towar.

Etykiety zbiorcze i limity API przewoźnika

Gdy etykiety powstają w partiach, nie warto pobierać każdej osobno. ShipX ma osobny zasób do pobrania wielu etykiet jednym żądaniem: według dokumentacji maksymalnie 100 w jednym zapytaniu, tylko dla przesyłek opłaconych, a etykiety może pobrać wyłącznie nadawca. Jeśli przesyłki dotyczą jednej usługi, wynik przychodzi w jednym pliku, a przy różnych usługach w archiwum ZIP z osobnym plikiem dla każdej z nich (stan na lipiec 2026). Integracja musi więc dzielić duże partie na paczki po 100 i umieć rozpakować archiwum.

Zamówienia z Allegro obsługiwane w programie Wysyłam z Allegro wymagają osobnej ścieżki. Allegro udostępnia w REST API zasoby do zarządzania przesyłkami, w tym tworzenie etykiety (POST /shipment-management/label), a starsze zasoby parcel-management zostały wyłączone na początku 2025 roku. Integracja, która nadal korzysta ze starych adresów, przestała działać, więc przy przeglądzie automatyzacji warto sprawdzić, z jakiej wersji API korzysta.

Skan na stanowisku pakowania - jak go zaprojektować

Wyzwalacz skanem daje najwięcej kontroli, ale wymaga przemyślenia kilku szczegółów. Po pierwsze, co jest skanowane: kod zamówienia z wydrukowanej listy kompletacyjnej czy kod EAN produktu. Skan produktu pozwala przy okazji sprawdzić, czy do paczki trafia właściwy towar, ale przy zamówieniach wielopozycyjnych integracja musi wiedzieć, kiedy zamówienie jest kompletne. Po drugie, ile kartonów ma paczka i jaki mają gabaryt - pracownik powinien móc to potwierdzić jednym kliknięciem, zanim integracja wyśle zlecenie do przewoźnika. Po trzecie, co się dzieje, gdy API nie odpowiada: stanowisko powinno pokazać czytelny komunikat i pozwolić odłożyć zamówienie na bok, a nie zawiesić się na kilka minut.

Dokumenty generowane razem z etykietą

Etykieta rzadko jest jedynym dokumentem, który powstaje przy pakowaniu. Automatyzacja może w tym samym kroku przygotować pozostałe wydruki, żeby pracownik nie musiał ich zbierać z różnych systemów:

Lista pakowania - zawartość paczki z ilościami, przydatna przy reklamacjach i zamówieniach wielokartonowych.
Dokument sprzedaży - jeśli wkładasz do paczki fakturę lub paragon, ich wydruk powinien powstać przed zamknięciem kartonu, a nie po wysyłce.
Zestawienie nadań - lista przesyłek przekazywanych kurierowi albo zlecenie odbioru, jeśli przewoźnik ich wymaga. Ułatwia sprawdzenie, czy wszystkie paczki wyjechały z magazynu.

Warto pilnować kolejności. Jeśli dokument sprzedaży jest wystawiany automatycznie po zmianie statusu na „wysłane”, a status zmienia się dopiero po wygenerowaniu etykiety, faktura nie zdąży trafić do paczki. Wtedy lepiej wysyłać ją klientowi mailem albo przestawić kolejność kroków.

Najczęstsze błędy przy automatycznym generowaniu etykiet

Problemy z automatycznymi etykietami rzadko wynikają z samej drukarki. Częściej to skutek założeń, które działały przy ręcznym procesie, a w automacie przestają:

Zmiana zamówienia po wygenerowaniu etykiety - klient dopisuje produkt lub zmienia punkt odbioru, a magazyn nakleja starą etykietę. Integracja powinna oznaczać takie zamówienie i wymagać nowej przesyłki.
Anulacja bez anulowania przesyłki - zamówienie jest anulowane w sklepie, ale przesyłka u przewoźnika zostaje i może zostać rozliczona. Anulowanie zamówienia musi uruchamiać anulowanie przesyłki, jeśli przewoźnik na to pozwala.
Paczki wielokartonowe - zamówienie mieści się w dwóch kartonach, a automat tworzy jedną przesyłkę. Przy wyzwalaczu statusem warto mieć regułę dla dużych zamówień albo przejść na skan.
Brak etykiety bez alarmu - API zwróciło błąd, a zamówienie leży w statusie „do wysyłki” bez pliku. Potrzebny jest raport zamówień bez numeru przesyłki.
Zły rozmiar wydruku - plik A4 drukowany na rolce 100 x 150 mm albo odwrotnie. Typ etykiety w integracji musi odpowiadać papierowi w drukarce.

[#chart:wpr66c]

[#uwaga] Ponowne wygenerowanie etykiety nie zawsze oznacza ponowne pobranie tego samego pliku. Jeśli integracja po błędzie drukarki tworzy nową przesyłkę zamiast pobrać istniejącą etykietę, powstają dwie przesyłki dla jednego zamówienia. Funkcja „drukuj ponownie” powinna zawsze pobierać plik dla istniejącego numeru przesyłki.

Jak wdrożyć automatyczne etykiety przesyłkowe krok po kroku

Wdrożenie warto podzielić na etapy, zaczynając od jednego przewoźnika i jednego kanału sprzedaży:

spisz metody dostawy w każdym kanale i przypisz im usługę przewoźnika oraz domyślny gabaryt,
uzupełnij wagę i wymiary produktów, z których integracja ma liczyć paczkę,
wybierz wyzwalacz i format etykiety zgodny z drukarkami na stanowiskach,
przetestuj tworzenie przesyłek w środowisku testowym przewoźnika, jeśli je udostępnia,
uruchom automatyzację dla części zamówień, np. jednego kanału, i porównuj wyniki z ręcznym procesem,
dodaj raport zamówień bez etykiety i alarm o serii błędów API.

[#checklista] Przed uruchomieniem sprawdź: czy każda metoda dostawy ma przypisaną usługę przewoźnika; czy produkty mają wagę i wymiary; czy drukarki obsługują wybrany format; czy anulowanie zamówienia anuluje przesyłkę; czy „drukuj ponownie” nie tworzy nowej przesyłki; kto dostaje alarm, gdy etykiety przestaną się generować.

Jeśli sklep działa na WooCommerce i korzysta z wtyczek przewoźników, część tych funkcji może już mieć. O tym, co oferują wtyczki DPD, DHL i GLS, piszemy we wpisie DPD, DHL i GLS w WooCommerce - jak podłączyć kurierów i drukować etykiety. Własna automatyzacja ma sens dopiero wtedy, gdy gotowe narzędzia nie obsługują Twojego wyzwalacza, drukarek albo kilku kanałów naraz.

Jak Vinson pomaga z automatycznymi etykietami przesyłkowymi

Programiści Vinson projektują i wdrażają automatyczne generowanie etykiet w sklepach na WooCommerce, Shoperze, PrestaShop i Shopify, w Base i we własnych systemach klientów. Dobieramy wyzwalacz do sposobu pracy magazynu, konfigurujemy formaty etykiet i druk bez okna dialogowego, budujemy obsługę anulacji, paczek wielokartonowych i ponownego wydruku, a także raporty zamówień bez etykiety. Poprawiamy też automatyzacje, które przestały działać po zmianach w API przewoźnika. Więcej na stronie Wsparcie programistyczne dla e-commerce.

Najczęściej zadawane pytania

Jak automatycznie generować etykiety kurierskie w sklepie internetowym?

Potrzebna jest integracja sklepu lub integratora z API przewoźnika i reguła, która uruchamia utworzenie przesyłki, np. zmiana statusu zamówienia albo skan na stanowisku pakowania. Integracja tworzy przesyłkę, pobiera etykietę po potwierdzeniu i przekazuje ją do druku, a numer przesyłki zapisuje w zamówieniu.

Jaki format etykiety wybrać do drukarki termicznej?

Do drukarek termicznych najlepiej nadają się ZPL lub EPL, jeśli drukarka obsługuje dany język. Plik trafia wtedy bezpośrednio do drukarki bez skalowania. PDF też zadziała, ale wymaga poprawnych ustawień sterownika i rozmiaru papieru.

Czy można drukować etykiety bez klikania „Drukuj” w przeglądarce?

Tak. Można użyć usługi druku zdalnego z klientem zainstalowanym przy drukarce, drukarki sieciowej przyjmującej zadania z serwera albo programu do druku udostępnianego przez integrator. Wybór zależy od tego, gdzie działa integracja i ile jest stanowisk pakowania.

Ile etykiet InPost można pobrać jednym zapytaniem do API?

Według dokumentacji ShipX jednym zapytaniem można pobrać maksymalnie 100 etykiet, tylko dla przesyłek opłaconych. Przy różnych usługach wynik przychodzi jako archiwum ZIP z osobnymi plikami. Przed wdrożeniem warto sprawdzić aktualną dokumentację InPost.

Co zrobić, gdy zamówienie zmieni się po wydrukowaniu etykiety?

Starą przesyłkę trzeba anulować u przewoźnika, jeśli to możliwe, i utworzyć nową z aktualnymi danymi. Integracja powinna oznaczać zamówienia zmienione po wygenerowaniu etykiety, żeby magazyn nie nakleił nieaktualnego wydruku.

Automatyczne etykiety przesyłkowe oszczędzają czas tylko wtedy, gdy obejmują cały cykl: wyzwalacz, format, druk, anulację i kontrolę braków. Jeśli chcesz zautomatyzować wysyłki w swoim sklepie, sprawdź wsparcie programistyczne Vinson.

Etykiety przesyłkowe generowane automatycznie - integracja sklepu z kurierem