# Integracja UPS

> Rezerwuj przesyłki UPS ze swoich przesyłek z etykietami, numerami śledzenia i fakturami handlowymi — i śledź dowolny numer UPS, a doręczenia zamykają przystanki.

**Category:** Przewoźnicy paczkowi i kurierscy

## Czym jest UPS?

UPS (United Parcel Service) to jedna z największych firm kurierskich na świecie, oferująca usługi naziemne, ekspresowe lotnicze i międzynarodowe. Oprogramowanie łączy się przez API UPS na developer.ups.com: Transportial używa Shipping API do rezerwowania i anulowania (void) przesyłek oraz Tracking API do ich śledzenia.

## Co jest synchronizowane między UPS a Transportial

- **Przesyłki → przesyłki UPS** (Do UPS): Gdy zostanie potwierdzony trip przekazany w ramach kontraktu na zdolność przewozową korzystającego z integracji UPS, każda przesyłka jest rezerwowana jako przesyłka UPS na Twój numer nadawcy (shipper number). Każda paczka z towarów staje się paczką UPS z wagą i wymiarami, a numer przesyłki jest referencją.
- **Etykiety i numery śledzenia** (Do Transportial): Przy przesyłce zapisywana jest jedna etykieta na paczkę — jako PDF 4×6 cala lub ZPL dla drukarek termicznych — wraz z numerami śledzenia przesyłki.
- **Faktura handlowa dla przesyłek międzynarodowych** (Do UPS): Przesyłki międzynarodowe zawierają dane celne z towarów: opis, ilość, wartość, wagę, kod HS i pochodzenie. Faktura handlowa UPS jest zapisywana przy przesyłce, a przy incoterm DDP cła i podatki są fakturowane na Twoje własne konto UPS.
- **Anulowanie przed odbiorem** (Do UPS): Anulowanie tripu anuluje jego przesyłki UPS, które nie zostały jeszcze odebrane; planiści mogą też anulować pojedynczą przesyłkę z poziomu przesyłki.
- **Śledzenie, ETA i zakończenie postojów** (Do Transportial): Status, aktywność, planowane doręczenie i osoba, która podpisała odbiór paczki, wracają do przesyłki. Pierwszy skan odbioru kończy postój załadunku, a doręczenie kończy postój rozładunku.
- **Numery UPS zarezerwowane gdzie indziej** (Do Transportial): Dodaj dowolny numer śledzenia UPS do przesyłki — na przykład przesyłki utworzonej we własnym portalu UPS — a Transportial będzie go śledzić w ten sam sposób.

## Jak połączyć UPS

1. Przewoźników paczkowych włącza się dla każdej platformy: poproś nas o ich aktywację dla Twojego konta Transportial.
2. Utwórz aplikację na UPS Developer Portal (developer.ups.com) z Shipping API i Tracking API, powiązaną z Twoim kontem UPS, i zanotuj jej client ID i client secret.
3. Dodaj integrację UPS w Transportial: client ID i secret, numer nadawcy UPS, domyślną usługę i format etykiety (PDF lub ZPL). Możesz zacząć w środowisku testowym UPS.
4. Ustaw tę integrację jako metodę komunikacji kontraktu na zdolność przewozową. Tripy przekazane w ramach tego kontraktu są rezerwowane w UPS, gdy tylko je potwierdzisz.

## Częstotliwość synchronizacji i limity

- Przesyłki są rezerwowane po potwierdzeniu tripu; przesyłki dodane później są rezerwowane przy następnej aktualizacji tripu, nigdy dwa razy w tej samej integracji.
- Otwarte numery śledzenia są domyślnie sprawdzane co 60 minut — do skonfigurowania dla każdej integracji — do momentu doręczenia, zwrotu lub anulowania przesyłki.
- UPS Tracking API przyjmuje jeden numer na wywołanie.
- UPS zwraca etykiety jako obrazy; Transportial zamienia każdą na stronę PDF 4×6 cala albo zapisuje ZPL bez zmian.
- Przesyłkę można anulować tylko przed jej odebraniem przez UPS.

## Typowy przypadek użycia

Hurtownik z Venlo wysyła części zamienne do warsztatów w całej Europie i do kilku klientów w USA. Zamówienia paletowe jadą jego własnymi ciężarówkami; paczki są planowane na tripie w ramach kontraktu na zdolność przewozową UPS, z UPS Standard jako domyślną usługą i Express Saver dla pilnych zamówień. Potwierdzenie tripu rezerwuje każdą przesyłkę, a magazyn drukuje etykiety i faktury handlowe z przesyłki. Skan odbioru zamyka postój załadunku, dział obsługi klienta widzi planowane doręczenie, a postój dostawy zamyka się, gdy UPS zgłosi doręczenie paczki.


## Najczęściej zadawane pytania

### Jakie usługi UPS mogę rezerwować?

UPS Standard, Express Saver, Express, Express Plus, Express 12:00, Expedited, Worldwide Economy, Worldwide Express Freight i Access Point Economy, a także krajowe usługi w USA, takie jak UPS Ground, 3 Day Select, 2nd Day Air i Next Day Air. Ustaw domyślną usługę w integracji albo wybierz ją dla każdej przesyłki.

### Czy mogę anulować przesyłkę UPS z Transportial?

Tak, dopóki UPS jej nie odebrał. Anulowanie tripu anuluje jego otwarte przesyłki UPS, a planista może anulować pojedynczą przesyłkę z poziomu przesyłki.

### Czy Transportial planuje odbiory UPS?

Nie. Przekaż paczki podczas regularnego odbioru UPS lub w UPS Access Point. Integracja rezerwuje, tworzy etykiety, anuluje i śledzi przesyłki; nie rezerwuje odbiorów, nie porównuje stawek i nie tworzy etykiet zwrotnych.

### Czy mogę śledzić paczki UPS, których nie zarezerwowałem przez Transportial?

Tak. Dodaj numer śledzenia w zakładce „Przesyłki kurierskie” przesyłki, a Transportial będzie go śledzić jak własne rezerwacje, łącznie z kończeniem postojów.


---
Canonical page: https://transportial.com/pl/integration/ups