Integracja UPS

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

• → Do UPS

  Przesyłki → przesyłki 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ą.

• ← Do Transportial

  Etykiety i numery śledzenia

  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.

• → Do UPS

  Faktura handlowa dla przesyłek międzynarodowych

  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.

• → Do UPS

  Anulowanie przed odbiorem

  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.

• ← Do Transportial

  Śledzenie, ETA i zakończenie postojów

  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.

• ← Do Transportial

  Numery UPS zarezerwowane gdzie indziej

  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