UPS automatyzacje - API i automatyczne dokumenty wysyłkowe

Jakie UPS API przydają się w sklepie internetowym?

Portal deweloperski UPS zawiera kilkadziesiąt interfejsów, ale sklep internetowy korzysta zwykle z kilku z nich. Każdy odpowiada za inny fragment procesu, więc integrację można rozbudowywać etapami. Najczęściej używane interfejsy zebraliśmy na grafice.

[#chart:kur47b]

Interfejs wysyłek zwraca etykietę w wybranym formacie, m.in. jako obraz do druku na zwykłej drukarce albo w formacie ZPL dla drukarek termicznych. Wybór formatu warto ustalić z magazynem przed wdrożeniem, bo od niego zależy, czy etykiety drukują się jednym kliknięciem, czy wymagają dodatkowej obróbki.

Automatyczne zamawianie odbioru

Sklep, który wysyła codziennie, zwykle ma z UPS ustalony stały odbiór i nie musi zamawiać kuriera za każdym razem. Przy nieregularnych wysyłkach odbiór można zamówić automatycznie przez API, np. po wygenerowaniu pierwszej etykiety danego dnia. Alternatywą jest nadawanie w punktach UPS Access Point, co przy małej liczbie paczek bywa prostsze niż zamawianie kuriera.

Automatyczne dokumenty wysyłkowe UPS przy wysyłkach poza UE

Przy wysyłce poza Unię Europejską, np. do Wielkiej Brytanii, Szwajcarii czy Norwegii, do paczki potrzebna jest faktura handlowa lub pro forma. Bez automatyzacji pracownik drukuje ją w kilku egzemplarzach i dołącza do paczki. UPS pozwala przekazać ją elektronicznie: dane do faktury przesyła się razem z przesyłką, a gotowe dokumenty, np. fakturę ze sklepu czy świadectwo pochodzenia, można wgrać przez interfejs dokumentów UPS. Do takiej wysyłki trzeba mieć włączoną odpowiednią usługę na koncie UPS.

Elektroniczne dokumenty eliminują ryzyko, że faktura zginie w drodze albo będzie nieczytelna, ale nie zwalniają nadawcy z odpowiedzialności za dane. Opis towaru, kod taryfy celnej, wartość, kraj pochodzenia i numer EORI muszą być poprawne w zamówieniu, bo integracja przeniesie je dokładnie tak, jak są zapisane. Więcej o typowych błędach piszemy we wpisie

UPS automatyzacja przez Base czy własne API?

Własna integracja z UPS API daje pełną kontrolę, ale wymaga programisty, utrzymania i reagowania na zmiany po stronie UPS. Dla większości sklepów prostszy jest moduł UPS w Base: podłączasz konto UPS, ustawiasz domyślne usługi i formaty etykiet, a Base tworzy przesyłki dla zamówień ze sklepu, Allegro i innych kanałów. Jak to wygląda krok po kroku, opisujemy we wpisie

• Moduł w Base: szybkie wdrożenie, jeden panel dla wszystkich kanałów, akcje automatyczne na statusach.

• Własne API: nietypowe procesy, własny WMS lub ERP, pełna kontrola nad danymi.

• Allegro Delivery: Allegro Kurier UPS i Allegro Odbiór w Punkcie UPS bez własnej umowy, z obsługą w Wysyłam z Allegro lub w Base.

W Base automatyzacja nie kończy się na etykiecie. Akcje automatyczne mogą przy zmianie statusu tworzyć przesyłkę, drukować etykietę, wysyłać e-mail z numerem śledzenia i przenosić zamówienie dalej, gdy UPS potwierdzi doręczenie. Do tego dochodzą reguły, które same wybierają przewoźnika i usługę UPS według wagi, kraju i kanału sprzedaży.

Jak przygotować dane do automatyzacji wysyłek UPS?

Automatyzacja jest tak dobra, jak dane, które do niej trafiają. Integracja z UPS nie zgadnie wagi paczki ani wymiarów kartonu - weźmie je z produktu lub zamówienia. Jeśli w katalogu brakuje wag, a pracownik wpisuje je ręcznie przy pakowaniu, połowa korzyści z automatyzacji znika. Dlatego przed uruchomieniem automatycznych etykiet warto zrobić przegląd danych w sklepie i w Base.

• Waga produktu: uzupełniona dla każdego produktu, razem z opakowaniem jednostkowym.

• Domyślne kartony: kilka standardowych rozmiarów przypisanych do grup produktów, żeby integracja znała wymiary paczki.

• Adres i telefon klienta: pola wymagane w koszyku, bo bez telefonu i poprawnego kodu pocztowego przesyłka może nie powstać.

• Dane do wysyłek zagranicznych: opis towaru, kod taryfy celnej i kraj pochodzenia w polach produktu.

• Mapowanie metod dostawy: każda metoda z koszyka i z Allegro przypisana do konkretnej usługi UPS.

Wymiary kartonu mają przy UPS bezpośredni wpływ na koszt. Paczka jest rozliczana według większej z dwóch wag: rzeczywistej albo wymiarowej, liczonej jako długość × szerokość × wysokość w centymetrach podzielone przez 5000. Jeśli integracja przekazuje zaniżone wymiary albo wcale ich nie przekazuje, UPS może skorygować wagę po pomiarze w sortowni, a korekta pojawi się dopiero na fakturze. Lepiej od początku przekazywać rzetelne dane niż później wyjaśniać różnice.

Warto też pamiętać o limitach. Pojedyncza paczka UPS może ważyć do 70 kg, mieć do 274 cm długości i do 400 cm długości i obwodu łącznie (stan na kwiecień 2026 - sprawdź aktualny regulamin UPS). Produkty, które przekraczają te limity, powinny mieć w systemie regułę kierującą je do innej formy wysyłki, zanim automatyczna etykieta zwróci błąd.

Powiadomienia dla klientów

Klient, który wie, gdzie jest paczka, rzadziej pisze do obsługi. Najprostsza automatyzacja to e-mail ze sklepu lub z Base z numerem i linkiem do śledzenia UPS, wysyłany w chwili utworzenia etykiety albo przekazania paczki kurierowi. Odbiorcy UPS mogą też korzystać z bezpłatnego konta UPS My Choice, w którym zmienią datę lub miejsce doręczenia, o ile nadawca na to pozwala. Przy wysyłkach zagranicznych dodaj w wiadomości informację, kto płaci ewentualne cło i podatek importowy.

Najczęstsze błędy w automatyzacji wysyłek UPS

Gdy automatyzacja działa, nikt o niej nie myśli. Gdy przestaje, magazyn zaczyna ręcznie przepisywać adresy. Większość problemów ma kilka powtarzalnych przyczyn, które da się szybko zdiagnozować.

[#chart:kur47c]

Warto też ustawić prosty nadzór: listę zamówień, które utknęły w statusie „do wysłania” dłużej niż zwykle, i alert, gdy etykieta nie powstała. Dzięki temu błąd zobaczysz rano, a nie po telefonie od klienta.

Jak Vinson pomaga zautomatyzować wysyłki UPS?

W Vinson integrujemy wysyłki ze sklepem, Allegro i Base. Przy UPS zaczynamy od mapy procesu: skąd przychodzą zamówienia, kto pakuje, jakie paczki jadą za granicę i jakie dokumenty są potrzebne. Potem konfigurujemy moduł UPS, akcje automatyczne i reguły wyboru kuriera tak, żeby magazyn nie musiał podejmować decyzji przy każdej paczce. Nie jesteśmy partnerem UPS - dobieramy przewoźników do produktów na podstawie Twoich danych.

• Konfiguracja UPS w Base: etykiety, numery śledzenia, statusy i akcje automatyczne - szczegóły na stronie wdrożenia Base.

• Dane do wysyłek poza UE: uzupełnienie pól produktów potrzebnych do dokumentów handlowych.

• Optymalizacja kosztów: przegląd usług, kartonów i reguł pod kątem kosztu dostawy na zamówienie.

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. Jeśli chcesz, żeby wysyłki UPS działały bez przepisywania danych,

Najczęściej zadawane pytania

Czy UPS ma API dla sklepów internetowych?

Tak. UPS udostępnia API na swoim portalu deweloperskim, m.in. do tworzenia przesyłek i etykiet, śledzenia, zamawiania odbioru i przesyłania dokumentów. Dostęp wymaga konta UPS i aplikacji z danymi uwierzytelniającymi OAuth 2.0. Sklepy bez programisty korzystają zwykle z gotowych modułów, np. w Base.

Co zmieniło się w UPS API w 2024 roku?

W sierpniu 2024 r. UPS przeszedł na uwierzytelnienie OAuth 2.0 i zakończył obsługę starego modelu dostępu opartego na kluczu. Integracje muszą pobierać token dostępu i odnawiać go po wygaśnięciu. Starsze, nieaktualizowane integracje mogą wymagać przebudowy.

Jak automatycznie generować etykiety UPS?

Etykiety UPS można generować automatycznie przez API albo przez moduł UPS w systemie do obsługi zamówień, np. Base. System pobiera adres, wagę i wymiary z zamówienia, tworzy przesyłkę i zwraca etykietę oraz numer śledzenia. Na Allegro można też korzystać z metod UPS w Allegro Delivery bez własnej umowy.

Czy UPS przyjmuje elektroniczne faktury handlowe?

Tak, UPS pozwala przekazywać dane i dokumenty handlowe elektronicznie przy wysyłkach międzynarodowych, zamiast drukować fakturę do paczki. Usługa musi być włączona na koncie UPS, a za poprawność danych odpowiada nadawca. Warto przed wdrożeniem uzupełnić kody taryfy celnej i kraj pochodzenia produktów.

Czy mogę automatycznie zamówić kuriera UPS?

Tak, odbiór można zamówić przez API UPS albo ustalić z przewoźnikiem stały, cykliczny odbiór. Przy codziennych wysyłkach stały odbiór jest zwykle wygodniejszy. Przy małej liczbie paczek prostsze bywa nadanie w punkcie UPS Access Point.

Automatyzacja UPS nie wymaga od razu własnego API - najczęściej wystarczy dobrze skonfigurowany moduł i reguły w systemie do obsługi zamówień. Jeśli dopiero zaczynasz z UPS, zobacz też