UPS API

Globe Pickup Points integruje się z UPS, światowym przewoźnikiem paczek, umożliwiając eksport zamówień i drukowanie etykiet wysyłkowych bezpośrednio z Shopify. Dzięki tej integracji możesz:

Eksportować zamówienia do UPS bezpośrednio z Shopify
Drukować etykiety wysyłkowe w Shopify
Wysyłać 15 usługami UPS: krajowymi, europejskimi i światowymi
Wysyłać paczki międzynarodowe z danymi celnymi generowanymi automatycznie z Twoich produktów Shopify

UPS jest włączany indywidualnie dla sklepu na życzenie. Jeśli nie widzisz UPS na liście przewoźników, skontaktuj się z pomocą techniczną Globe, a włączymy go dla Twojego sklepu.

Włączanie integracji z API UPS

W panelu administracyjnym Shopify otwórz Globe Pickup Points i przejdź do sekcji Etykiety wysyłkowe. Dodaj nowego przewoźnika i wybierz UPS.
Wprowadź swój Numer konta — numer konta nadawczego UPS, widoczny w szczegółach Twojego konta rozliczeniowego UPS.
Wypełnij dane nadawcy: Nazwa nadawcy, Ulica nadawcy, Miasto nadawcy, Kod pocztowy nadawcy, Kraj nadawcy i Telefon nadawcy. Email nadawcy jest opcjonalny.
Stan/prowincja nadawcy to kod stanu lub prowincji (na przykład NY, CA). Jest wymagany przy wysyłce ze Stanów Zjednoczonych lub Kanady, a w pozostałych przypadkach można go zostawić pusty.
Kliknij Połącz konto UPS. Otworzy się okno UPS, w którym zalogujesz się swoimi danymi UPS i autoryzujesz Globe. Po powrocie połączenie zostaje zapisane, a token dostępu jest odświeżany automatycznie — nigdzie nie musisz wprowadzać klucza API ani hasła.
Skonfiguruj opcje realizacji i tagowania według potrzeb.
Przypisz metody wysyłki Shopify do usług UPS dostępnych na Twoim koncie.

Konto UPS możesz w każdej chwili odłączyć z tego samego ekranu; eksport jest zablokowany, dopóki nie połączysz go ponownie.

Eksportowanie i drukowanie etykiet

Możesz eksportować zamówienia do UPS i drukować etykiety wysyłkowe bezpośrednio z Shopify, zarówno masowo, jak i indywidualnie. Sam przepływ pracy z etykietami opisujemy w artykule Tworzenie etykiet wysyłkowych.

Każda przesyłka otrzymuje numer śledzenia UPS, a obraz etykiety jest zapisywany razem z zamówieniem, dzięki czemu można ją później wydrukować ponownie bez kontaktu z UPS. Jeśli Globe nie ma już zapisanego obrazu, jest on pobierany ponownie z usługi odzyskiwania etykiet UPS na podstawie numeru śledzenia. Paczki są śledzone pod adresem https://www.ups.com/track?tracknum=<numer śledzenia>.

Typy usług

Podczas eksportu zamówienia wybierz usługę odpowiadającą Twojej umowie z UPS:

Kod	Usługa	Typowe zastosowanie
03	UPS Ground	Dostawa naziemna krajowa (USA)
11	UPS Standard	Dostawa drogowa na terenie Europy
01	UPS Next Day Air	Krajowa lotnicza na następny dzień
02	UPS 2nd Day Air	Krajowa lotnicza w dwa dni
12	UPS 3 Day Select	Krajowa lotnicza w trzy dni
13	UPS Next Day Air Saver	Krajowa na następny dzień, do końca dnia
14	UPS Next Day Air Early	Krajowa na następny dzień, wczesnym rankiem
59	UPS 2nd Day Air A.M.	Krajowa w dwa dni, dostawa rano
07	UPS Worldwide Express	Międzynarodowa ekspresowa
08	UPS Worldwide Expedited	Międzynarodowa z określonym dniem dostawy
54	UPS Worldwide Express Plus	Międzynarodowa, wczesnym rankiem
65	UPS Worldwide Saver	Międzynarodowa ekspresowa, do końca dnia
96	UPS Worldwide Express Freight	Międzynarodowa przesyłka paletowa
71	UPS Worldwide Economy DDU	Ekonomiczna, cło nieopłacone
72	UPS Worldwide Economy DDP	Ekonomiczna, cło opłacone

Nie każda usługa jest dostępna na każdym koncie i z każdego kraju nadania — UPS odrzuca przesyłkę nadaną usługą, na którą Twoje konto nie ma umowy.

Tylko dostawa do domu i do firmy

Etykiety UPS tworzone w Globe są zawsze adresowane na domowy lub firmowy adres klienta pobrany z zamówienia Shopify. Dostawa do punktów UPS Access Point nie jest obsługiwana — punkt odbioru wybrany podczas realizacji zamówienia nie jest przekazywany do UPS, a paczka zostanie dostarczona na adres wysyłki. Nie przypisuj metody wysyłki do punktów odbioru do usługi UPS. Etykiety zwrotne również nie są obsługiwane.

Zaawansowane opcje przesyłki

Poniższe opcje ustawia się dla poszczególnych przesyłek w oknie eksportu. Nie są to ustawienia przewoźnika — konto przewoźnika UPS nie ma miejsca na przechowywanie ich wartości domyślnych, więc ustawiaj je na tych przesyłkach, które ich wymagają.

Opcja	Opis
Typ opakowania	Własne opakowanie (domyślnie), List UPS, Tuba, PAK, UPS Express Box, UPS 25KG Box, UPS 10KG Box
Opis zawartości	Opis przesyłki drukowany na etykiecie i używany w dokumentach celnych. Domyślnie `Goods`.
Kod HS	Kod HS używany w dokumentach celnych tej przesyłki, gdy produkt nie ma kodu HS w Shopify.

Cło i przesyłki międzynarodowe

Dokumenty celne (faktura handlowa) są dodawane automatycznie, gdy kraj nadawcy różni się od kraju docelowego, a przesyłka nie jest przemieszczeniem wewnątrz UE. Globe buduje fakturę z pozycji zamówienia:

Nazwa produktu, ilość, cena jednostkowa i SKU
Kod HS z pozycji magazynowej produktu w Shopify, a w razie jego braku Kod HS wprowadzony dla tej przesyłki w oknie eksportu
Kraj pochodzenia z pozycji magazynowej produktu w Shopify, a w razie jego braku kraj nadawcy
Waga pozycji z Shopify, przeliczona na jednostkę wagi przesyłki

Numerem faktury jest numer zamówienia Shopify, powodem eksportu jest SALE, a walutą — waluta zamówienia. Wagi są wysyłane w kilogramach, z wyjątkiem nadawców ze Stanów Zjednoczonych, Portoryko i Wysp Dziewiczych Stanów Zjednoczonych, gdzie używane są funty.

Płatność za pobraniem (COD)

UPS nie obsługuje płatności za pobraniem w Globe. Do UPS nie jest wysyłana żadna kwota pobrania, więc zamówienie COD wyeksportowane do UPS jest wysyłane jako zwykła paczka opłacona z góry i przy dostawie nie są pobierane pieniądze. Do takich zamówień użyj przewoźnika obsługującego COD lub przed eksportem przestaw klienta na metodę płatności z góry.

Status dostawy

Integracja UPS nie synchronizuje statusów dostawy z powrotem do Shopify. Numer śledzenia i link do śledzenia są nadal dołączane do realizacji (gdy włączona jest automatyczna realizacja), więc postęp dostawy można śledzić na ups.com.

Drukowanie etykiet

UPS zwraca obraz etykiety w formacie 4×6 cali, który Globe konwertuje do PDF i obraca do orientacji pionowej na potrzeby druku. Dostępne są następujące formaty:

Format	Pozycji na arkuszu
A6	1
A6 na A4	4

Podczas drukowania etykiet A6 na A4 możesz wybrać pozycję startową na arkuszu (pozycje 1–4), aby ponownie użyć częściowo zużytych arkuszy.

Rozwiązywanie problemów

Problem	Rozwiązanie
Konto UPS nie jest połączone	Otwórz ustawienia przewoźnika i kliknij Połącz konto UPS, aby dokończyć logowanie do UPS.
Uwierzytelnianie UPS nie powiodło się — token mógł wygasnąć	Nie udało się odświeżyć zapisanej autoryzacji UPS. Odłącz i połącz konto UPS ponownie.
Nieprawidłowa lub wygasła sesja podczas łączenia	Logowanie do UPS trzeba dokończyć w ciągu 10 minut. Zamknij okno i rozpocznij łączenie od nowa.
Utworzenie przesyłki nie powiodło się z komunikatem UPS	Komunikat pochodzi bezpośrednio od UPS. Najczęściej usługa nie jest włączona na Twoim koncie, adres odbiorcy jest niekompletny albo numer konta nie pasuje do adresu nadawcy.
Brakujący lub nieprawidłowy stan/prowincja	Nadawcy i odbiorcy z USA i Kanady potrzebują prawidłowego kodu stanu lub prowincji. Uzupełnij Stan/prowincja nadawcy i sprawdź adres klienta.
Nie udało się pobrać żadnych etykiet z UPS	Brakuje zapisanego obrazu etykiety, a odzyskiwanie etykiety się nie powiodło. Sprawdź, czy przesyłka ma numer śledzenia i czy konto UPS jest nadal połączone.
Zamówienie COD dostarczone bez pobrania pieniędzy	Tak ma być — przesyłki UPS w Globe nigdy nie są COD. Zobacz Płatność za pobraniem (COD) powyżej.

Add UPS pickup points to your Shopify store — pricing, demo & setup →