UPS integracja z Allegro, sklepem i Base - jak generować etykiety automatycznie?

Technical & Logistics Expert
UPS integracja z Allegro, sklepem i Base - jak generować etykiety automatycznie?
- Dobór kurierów do Twoich produktów
- Integracja z Base i sklepem, etykiety automatycznie
- Bez zobowiązań
Konsultację poprowadzi Mateusz Piotrowicz, Technical & Logistics ExpertUPS w sklepie internetowym - wtyczki i API UPS
W sklepie internetowym integracja UPS działa na podstawie Twojego konta i umowy z UPS. Popularne platformy mają gotowe rozwiązania: w Shoper dostępna jest aplikacja do integracji z UPS, IdoSell ma integrację z kurierem UPS obsługującą także punkty UPS Access Point, a dla WooCommerce i PrestaShop istnieją wtyczki i moduły firm trzecich. Zakres funkcji różni się między nimi, więc przed wyborem sprawdź listę obsługiwanych usług.
Dane dostępowe: UPS korzysta z uwierzytelniania OAuth 2.0 - w portalu dla deweloperów UPS tworzysz aplikację i otrzymujesz Client ID i Client Secret, a integracja zwykle prosi też o numer konta UPS.
Mapa punktów w koszyku: jeśli chcesz oferować odbiór w UPS Access Point, wtyczka musi zapisywać wybrany punkt w zamówieniu.
Mapowanie usług: każdej metodzie dostawy w sklepie przypisujesz usługę UPS, np. Standard lub Express Saver.
Waga i wymiary: uzupełnij je w produktach, bo integracja przekazuje je do UPS i od nich zależy waga rozliczeniowa.
Wtyczka w sklepie rozwiązuje problem tylko dla zamówień z tego sklepu. Jeśli sprzedajesz też na Allegro, Amazonie czy Empiku, każdy kanał trzeba by obsługiwać osobno. Dlatego sprzedawcy wielokanałowi przenoszą wysyłki do Base.
Jakie dane w zamówieniu są potrzebne do etykiety UPS?
Integracja jest tak dobra, jak dane, które do niej trafiają. Jeśli w zamówieniu czegoś brakuje, UPS odrzuci przesyłkę albo etykieta powstanie z błędem. Zanim włączysz automatyzację, upewnij się, że każde zamówienie zawiera komplet informacji.
Adres odbiorcy: ulica z numerem, kod pocztowy w formacie danego kraju, miasto i kraj.
Telefon i e-mail: potrzebne do powiadomień UPS i kontaktu kuriera z odbiorcą.
Waga i wymiary: z karty produktu lub z domyślnej formatki paczki w integracji.
Kod punktu: przy dostawie do UPS Access Point - zapisany w zamówieniu podczas wyboru w koszyku.
Wartość i opis: przy wysyłkach z deklaracją wartości i poza UE, gdzie potrzebne są dane do odprawy.
UPS w Base - jak skonfigurować automatyczne etykiety?
Base ma moduł UPS działający przez API przewoźnika. Pozwala tworzyć przesyłki i drukować etykiety z karty zamówienia albo masowo z listy zamówień, a numer przesyłki od razu trafia do systemu i może zostać wysłany klientowi. Konfiguracja przebiega w kilku krokach, które pokazuje grafika.
[#chart:kur44b]
Dodaj moduł UPS: w ustawieniach kurierów w Base wybierz UPS i wpisz dane dostępowe z konta UPS.
Ustaw formatkę: domyślną usługę, rozmiar paczki, adres nadania i format etykiety pod drukarkę.
Powiąż metody dostawy: przypisz metody ze sklepu i marketplace'ów do usług UPS albo do metod Allegro Delivery.
Dodaj akcje automatyczne: np. po zmianie statusu na „Do wysyłki” Base tworzy przesyłkę UPS i drukuje etykietę.
Przetestuj: utwórz kilka przesyłek testowych i sprawdź etykietę, wagę oraz numer śledzenia u klienta.
Gdy w sklepie działa kilku przewoźników, reguły w Base mogą same wybierać kuriera według wagi, kraju czy kanału sprzedaży - szczegóły opisujemy we wpisie o
Masowe nadawanie paczek UPS w Base
Przy kilkudziesięciu zamówieniach dziennie wygodniej pracować na liście zamówień niż na pojedynczych kartach. W Base zaznaczasz zamówienia w statusie gotowym do wysyłki, tworzysz dla nich przesyłki UPS jednym poleceniem i drukujesz etykiety seriami. Jeśli część zamówień ma braki, np. bez telefonu odbiorcy, Base zgłosi błąd tylko dla nich, a pozostałe przesyłki zostaną utworzone. Dobrą praktyką jest osobny status dla zamówień z błędem, żeby nikt o nich nie zapomniał.
| Ścieżka | Umowa z UPS | Kanały | Dla kogo |
|---|---|---|---|
| Allegro Delivery | Nie | Tylko Allegro | Sprzedawcy tylko na Allegro |
| Wtyczka w sklepie | Tak | Jeden sklep | Sklepy bez marketplace'ów |
| Base z modułem UPS | Tak (lub Allegro Delivery dla Allegro) | Wszystkie kanały w jednym panelu | Sprzedaż wielokanałowa |
Statusy i numery śledzenia UPS - co dzieje się po utworzeniu etykiety?
Integracja UPS nie kończy się na wydruku etykiety. Równie ważne jest to, co dzieje się dalej: czy klient dostaje numer śledzenia, czy zamówienie zmienia status i czy obsługa klienta widzi, gdzie jest paczka. Dobrze ustawiona integracja zamyka cały obieg informacji bez ręcznej pracy.
Numer śledzenia do kanału: Base przekazuje numer przesyłki do Allegro, sklepu lub innego marketplace'u, więc kupujący widzi go w swoim zamówieniu.
E-mail do klienta: szablon wiadomości z linkiem do śledzenia UPS wysyłany automatycznie po utworzeniu przesyłki.
Zmiana statusu: akcja automatyczna przenosi zamówienie np. do statusu „Wysłane” po wygenerowaniu etykiety.
Kontrola doręczeń: statusy przesyłek pomagają szybko wyłapać paczki, które utknęły lub wracają do nadawcy.
Wysyłki zagraniczne UPS w integracji
Przy paczkach do innych krajów UE integracja działa tak samo jak w kraju, ale warto sprawdzić format adresów i numerów telefonów, bo różnią się między krajami. Przy wysyłkach poza UE dochodzą dane celne: opis towaru, kod taryfy, kraj pochodzenia i wartość. Najlepiej trzymać je przy produktach w magazynie Base, żeby trafiały do przesyłki automatycznie, a nie były wpisywane ręcznie przy pakowaniu.
Zwroty UPS w integracji
Jeśli oferujesz klientom zwroty przez UPS, sprawdź, czy Twoja integracja pozwala tworzyć etykiety zwrotne. Etykieta przygotowana przez sklep i wysłana klientowi mailem przyspiesza zwrot i daje kontrolę nad kosztem. Zwroty warto obsługiwać w osobnym statusie lub w module zwrotów, żeby nie mieszały się z bieżącymi wysyłkami.
Etykiety UPS nie generują się - co sprawdzić?
Większość problemów z integracją UPS ma kilka powtarzalnych przyczyn: błędne dane dostępowe, braki w danych zamówienia albo niewłaściwie powiązane metody dostawy. Najczęstsze objawy i poprawki zebraliśmy poniżej.
[#chart:kur44c]
Gdy błąd dotyczy pojedynczych zamówień, zwykle winne są dane w zamówieniu. Gdy nie powstaje żadna etykieta, problem leży najczęściej w danych dostępowych albo w ustawieniach modułu. Zanim zgłosisz sprawę do pomocy technicznej Base lub UPS, zapisz treść komunikatu błędu, numer zamówienia i godzinę próby - to znacznie przyspiesza wyjaśnienie.
Kiedy integrację UPS warto przejrzeć ponownie?
Integracja ustawiona raz nie zawsze działa bez zmian latami. Warto ją sprawdzić po dodaniu nowego kanału sprzedaży, nowej metody dostawy w koszyku, zmianie umowy z UPS lub przejściu na inne kartony. Każda z tych zmian może sprawić, że część zamówień trafi do złej usługi albo dostanie błędną wagę.
[#tip] Przed włączeniem automatycznego tworzenia przesyłek uruchom akcję tylko dla jednego kanału sprzedaży albo jednej metody dostawy. Gdy przez kilka dni wszystko działa, rozszerz ją na pozostałe zamówienia.
Jak Vinson pomaga zintegrować UPS z Allegro, sklepem i Base?
W Vinson wdrażamy integracje przewoźników od strony sklepu i Base. Podłączamy moduł UPS, mapujemy metody dostawy ze wszystkich kanałów, ustawiamy akcje automatyczne, statusy i drukowanie etykiet, a także reguły automatycznego wyboru kuriera. Jeśli korzystasz z kilku przewoźników, porównujemy koszty i dobieramy usługi do produktów. Szczegóły znajdziesz na stronie
Vinson to agencja e-commerce z Bochni działająca od 2021 r., certyfikowany partner Base, Allegro Ads Partner+ i autoryzowany partner Shoper, z oceną 4,9/5 ze 171 opinii.
Najczęściej zadawane pytania
Czy UPS ma integrację z BaseLinkerem?
Tak. W Base (dawniej BaseLinker) dostępny jest moduł UPS działający przez API przewoźnika. Pozwala tworzyć przesyłki i drukować etykiety pojedynczo lub masowo, a numer śledzenia od razu trafia do zamówienia. Do podłączenia potrzebujesz konta UPS i danych dostępowych do API.
Jak generować etykiety UPS automatycznie?
Najprościej przez system do obsługi zamówień, np. Base, z akcją automatyczną tworzącą przesyłkę po zmianie statusu zamówienia. Reguły dobierają usługę UPS do metody dostawy, wagi i kraju, a drukarka termiczna drukuje etykietę bez dodatkowych kliknięć. W samym sklepie podobnie działają wtyczki korzystające z API UPS.
Czy do wysyłki UPS z Allegro potrzebuję umowy z UPS?
Nie, jeśli korzystasz z metod Allegro Kurier UPS i Allegro Odbiór w Punkcie UPS w programie Allegro Delivery. Przesyłki rozliczasz wtedy z Allegro według jego cennika. Własna umowa z UPS jest potrzebna do wysyłek ze sklepu i innych kanałów.
Jakie dane są potrzebne do integracji z API UPS?
UPS korzysta z uwierzytelniania OAuth 2.0, więc potrzebujesz identyfikatora klienta (Client ID) i klucza (Client Secret) z aplikacji utworzonej w portalu dla deweloperów UPS. Większość integracji prosi też o numer konta UPS. Dane wpisujesz w module integracji w sklepie lub w Base.
Czy można korzystać z UPS i innych kurierów w jednym panelu?
Tak. W Base możesz podłączyć UPS obok innych przewoźników i metod Allegro Delivery, a reguły automatyczne wybiorą kuriera według wagi, kraju, kanału sprzedaży czy metody dostawy wybranej przez klienta. Dzięki temu magazyn pracuje na jednej liście zamówień, niezależnie od przewoźnika.
Czy integracja UPS obsługuje punkty UPS Access Point?
Zależy od integracji. Punkt musi zostać wybrany przez klienta w koszyku i zapisany w zamówieniu, a moduł musi przekazać go do przesyłki. Przed wdrożeniem sprawdź w dokumentacji wtyczki lub modułu, czy obsługuje dostawę do UPS Access Point.
Automatyczne etykiety UPS to jeden z najprostszych sposobów na szybsze pakowanie i mniej pomyłek. Jeśli chcesz zobaczyć, jak działa cały układ przewoźników w jednym panelu, przeczytaj o


Mateusz Piotrowicz
Technical & Logistics Expert
Bezpłatna konsultacja z Vinson
Mateusz i nasz zespół pomogą Ci wdrożyć to na Twoim koncie - bez zobowiązań.
- Analiza Twojego konta i obecnych działań
- Konkretny plan poprawek do wdrożenia
- Bezpłatna konsultacja – bez zobowiązań

Przeczytaj także
Więcej porad z naszej bazy wiedzy - przesuń, aby zobaczyć kolejne artykuły.
Wybierz dogodny termin w kalendarzu - bez wymiany maili w tę i z powrotem.
