UPS Live Shipping (REST)¶
Dzięki wtyczce UPS Live Shipping (REST) obliczasz koszty wysyłki w czasie rzeczywistym za pośrednictwem oficjalnego API REST UPS (OAuth 2.0) – bezpośrednio w kasie Shopware 5. Koszty opierają się na rzeczywistych taryfach UPS dla adresu docelowego, wagi i wybranego usługi, w tym opcjonalnych cen negocjowanych.
Wtyczka przypisuje każdy sposób wysyłki Shopware do usługi UPS, automatycznie dzieli ciężkie zamówienia na wiele paczek i zapewnia wynik za pośrednictwem ustawień powrotu, nawet jeśli adres klienta lub interfejs API nie są dostępne.
Highlights
- 🚚 Koszty wysyłki w czasie rzeczywistym za pośrednictwem oficjalnego API REST UPS (OAuth 2.0)
- 🔀 Tryb Sandbox i Production
- 🧭 Przypisanie każdego sposobu wysyłki do usługi UPS
- ⚖️ Automatyczny podział paczek od 70 kg
- 💶 Ceny UPS standardowe lub negocjowane
- 🛟 Kraj powrotu, kod pocztowy i koszty wysyłki zastępcze
- 🐞 Szczegółowe rejestrowanie debugowania (
[UPS])
❓ FAQ¶
Skąd pochodzą koszty wysyłki?
Bezpośrednio z UPS: Wtyczka wysyła zapytanie do oficjalnego API REST UPS (OAuth 2.0) w czasie wykonywania i oblicza koszty na podstawie adresu docelowego, wagi i wybranej usługi UPS.
Czy potrzebuję konta UPS?
Tak. Rejestrujesz ID klienta i tajny klucz klienta z portalu deweloperów UPS. W przypadku cen negocjowanych zaleca się twój numer nadawcy (numer klienta UPS).
Jak sposoby wysyłki Shopware są połączone z usługami UPS?
Za pośrednictwem atrybutu welo_ups_service_id: Każdy sposób wysyłki jest przypisany do identyfikatora usługi UPS (np. 65 → UPS Worldwide Saver). Bez identyfikatora usługi nie można wykonać żadnych obliczeń.
Co się dzieje w przypadku zamówień powyżej 70 kg?
UPS pozwala maksymalnie 70 kg na paczkę. Wtyczka automatycznie wykrywa wyższe całkowite wagi i dzieli je na wiele paczek (np. 210 kg → 3 × 70 kg).
Co się dzieje, jeśli interfejs API UPS jest niedostępny?
Ustawienia powrotu obejmują standardowy kraj docelowy, standardowy kod pocztowy i określone koszty wysyłki zastępcze, dzięki czemu kasa nadal działa.
Czy mogę śledzić obliczenia?
Tak. Gdy debugowanie jest włączone, wtyczka rejestruje m.in. wagę, kod usługi, klucz pamięci podręcznej, ładunek, surową odpowiedź i kody błędów. Wszystkie wpisy są oznaczone [UPS].
🔧 Instalacja¶
- Instalacja poprzez menedżer wtyczek Shopware
- Zainstaluj i aktywuj wtyczkę
- Wykonaj konfigurację w panelu administracyjnym (zobacz Konfiguracja poniżej)
Następnie kliknij ikonę, aby aktywować wtyczkę:
⚙️ Ustawienia ogólne¶
| # | Ustawienie | Opis |
|---|---|---|
| 1 | Wybierz sklep | Wybierz odpowiedni sklep. |
| 2 | Aktywuj wtyczkę | Aktywuje obliczanie kosztów wysyłki UPS w czasie rzeczywistym. |
| 3 | Tryb | Wybór między Sandbox (środowisko testowe) i Production (działalność na żywo). |
| 4 | ID klienta | ID klienta z portalu deweloperów UPS. |
| 5 | Tajny klucz klienta | Tajny klucz klienta z portalu deweloperów UPS. |
| 6 | Numer nadawcy | Numer klienta UPS (zalecany w przypadku cen negocjowanych). |
| 7 | Limit czasu API | Limit czasu w sekundach dla żądania interfejsu API UPS. |
| 8 | Kraj wysyłki | Kod ISO kraju wysyłki (np. DE). |
| 9 | Kod pocztowy wysyłki | Kod pocztowy magazynu wysyłki. |
| 10 | Wybór ceny | Wymusz ceny standardowe, Wymusz ceny negocjowane lub Ceny negocjowane jeśli dostępne. |
| 11 | Zapisz ustawienia | Zapisz konfigurację. |
🧭 Przypisz sposoby wysyłki¶
Każdy sposób wysyłki Shopware musi być przypisany do usługi UPS. W tym celu używany jest atrybut welo_ups_service_id.
| Identyfikator usługi | Usługa UPS |
|---|---|
65 | UPS Worldwide Saver |
11 | UPS Standard |
07 | UPS Express |
Bez identyfikatora usługi, bez obliczeń
Jeśli sposób wysyłki nie ma przypisanego welo_ups_service_id, nie można wykonać żadnych obliczeń w czasie rzeczywistym dla tego sposobu wysyłki.
⚖️ Waga i podział¶
UPS pozwala maksymalnie 70 kg na paczkę. Wtyczka automatycznie wykrywa wyższe całkowite wagi i dzieli je na wiele paczek.
| Całkowita waga | Automatyczny podział |
|---|---|
| 100 kg | 2 × 50 kg |
| 210 kg | 3 × 70 kg |
| 350 kg | 5 × 70 kg |
| # | Ustawienie | Opis |
|---|---|---|
| 1 | Waga domyślna | Używana, jeśli artykuł nie ma wagi. |
| 2 | Waga minimalna | Dolna granica obliczenia. |
| 3 | Maksymalna waga na paczkę | Standard: 70 kg. |
| 4 | Zapisz ustawienia | Zapisz konfigurację. |
🛟 Ustawienia powrotu¶
Jeśli klient nie jest zalogowany lub nie ma dostępnego pełnego adresu, obowiązują następujące ustawienia:
| # | Ustawienie | Opis |
|---|---|---|
| 1 | Kraj powrotu | Kraj standardowy dla gości. |
| 2 | Kod pocztowy powrotu | Standardowy kod pocztowy dla gości. |
| 3 | Koszty wysyłki zastępcze | Używany, jeśli interfejs API UPS jest niedostępny. |
| 4 | Zapisz ustawienia | Zapisz konfigurację. |
Dynamiczny adres docelowy
Jeśli klient wybierze inny kraj lub kod pocztowy w koszyku, jest on dynamicznie używany do obliczenia.
🐞 Debugowanie i rejestrowanie¶
| # | Ustawienie | Opis |
|---|---|---|
| 1 | Włącz debugowanie | Włącza szczegółowe dzienniki. |
| 2 | Zapisz ustawienia | Zapisz konfigurację. |
Dzienniki zawierają m.in.:
- Waga
- Kod usługi
- Klucz pamięci podręcznej
- Ładunek do UPS
- Surowa odpowiedź API
- Kody błędów
- Wyjątki API
Wszystkie dzienniki są oznaczone [UPS].
💡 Typowe przypadki użycia¶
Dokładne międzynarodowe koszty wysyłki¶
Pokaż klientom w kasie rzeczywiste taryfy UPS dla ich adresu docelowego – zamiast ryczałtowych kosztów wysyłki.
Duże i opakowujące zamówienia¶
Duże zamówienia są automatycznie dzielone na paczki zgodne z UPS (maks. 70 kg) i prawidłowo obliczane.
Korzystaj z negocjowanych warunków UPS¶
Dzięki zarejestrowanemu numerowi nadawcy wtyczka oblicza Twoje indywidualnie negocjowane ceny UPS.
⭐ Korzyści dla operatorów sklepów¶
- Precyzyjne i dokładne koszty wysyłki bezpośrednio z UPS
- Mniej przeszacowania lub niedoszacowania kosztów wysyłki
- Automatyczny podział paczek bez wysiłku ręcznego
- Niezawodna kasa dzięki ustawieniom powrotu
- Pełna przejrzystość dzięki szczegółowemu rejestrowaniu debugowania
🧩 Zakres funkcjonalności¶
- Obliczanie kosztów wysyłki w czasie rzeczywistym za pośrednictwem API REST UPS (OAuth 2.0)
- Tryb Sandbox i Production
- Przypisanie każdego sposobu wysyłki do usługi UPS
- Ceny standardowe lub negocjowane
- Automatyczny podział paczek od 70 kg
- Kraj powrotu, kod pocztowy i koszty wysyłki zastępcze
- Szczegółowe rejestrowanie debugowania z identyfikacją
[UPS]
📬 Wsparcie¶
W razie pytań, sugestii dotyczących ulepszeń lub dostosowań niestandardowych skontaktuj się z nami pocztą elektroniczną na support@cnk-plugins.de.
📬 Support¶
W przypadku pytań, sugestii dotyczących ulepszeń lub dostosowań, prosimy o kontakt za pośrednictwem poczty elektronicznej na adres support@cnk-plugins.de.