UPS koppeling

Wat is UPS?

UPS (United Parcel Service) is een van de grootste pakketbezorgers ter wereld, met grond-, luchtexpress- en internationale diensten. Software koppelt via de UPS API’s op developer.ups.com: Transportial gebruikt de Shipping API om zendingen te boeken en te annuleren en de Tracking API om ze te volgen.

Welke gegevens UPS en Transportial uitwisselen

• → Naar UPS

  Zendingen → UPS-zendingen

  Wordt een Trip bevestigd die is uitbesteed onder een capaciteitscontract dat de UPS-koppeling gebruikt, dan wordt elke zending geboekt op je UPS-verzendernummer. Elk pakket uit de goederen wordt een UPS-collo met gewicht en afmetingen, en het zendingnummer is de referentie.

• ← Naar Transportial

  Labels en trackingnummers

  Per collo wordt één label op de zending opgeslagen — als pdf van 4×6 inch, of als ZPL voor thermische printers — samen met de trackingnummers van de zending.

• → Naar UPS

  Commerciële factuur voor internationale zendingen

  Internationale zendingen krijgen douanegegevens uit de goederen mee: omschrijving, aantal, waarde, gewicht, HS-code en oorsprong. De commerciële factuur van UPS wordt op de zending bewaard, en met de incoterm DDP worden invoerrechten en belastingen op je eigen UPS-account gezet.

• → Naar UPS

  Annuleren vóór ophalen

  Annuleer je de Trip, dan worden de UPS-zendingen die nog niet zijn opgehaald, geannuleerd (void); planners kunnen ook één zending annuleren vanuit de zending.

• ← Naar Transportial

  Tracking, ETA en afronden van stops

  Status, activiteiten, de geplande levering en wie voor het pakket heeft getekend, komen terug op de zending. De eerste ophaalscan rondt de laadstop af en de aflevering de losstop.

• ← Naar Transportial

  Elders geboekte UPS-nummers

  Voeg een willekeurig UPS-trackingnummer aan een zending toe — bijvoorbeeld van een zending die in het eigen portaal van UPS is aangemaakt — en Transportial volgt het op dezelfde manier.

Zo koppel je UPS

1. Pakketvervoerders worden per platform aangezet: vraag ons ze voor je Transportial-account in te schakelen.

2. Maak een app aan op het UPS Developer Portal (developer.ups.com) met de Shipping- en Tracking-API’s, gekoppeld aan je UPS-account, en noteer de client-ID en het client-secret.

3. Voeg de UPS-koppeling toe in Transportial: client-ID en -secret, je UPS-verzendernummer, de standaarddienst en het labelformaat (pdf of ZPL). Je kunt eerst in de testomgeving van UPS beginnen.

4. Stel bij een capaciteitscontract deze koppeling in als communicatiemethode. Trips die onder dat contract worden uitbesteed, worden bij UPS geboekt zodra je ze bevestigt.

Synchronisatie en limieten

• Zendingen worden geboekt zodra de Trip is bevestigd; later toegevoegde zendingen worden bij de volgende wijziging van de Trip geboekt, nooit twee keer met dezelfde koppeling.
• Open trackingnummers worden standaard elke 60 minuten gecontroleerd — per koppeling instelbaar — tot de zending is afgeleverd, geretourneerd of geannuleerd.
• De UPS Tracking API neemt één nummer per aanroep.
• UPS levert labels als afbeelding; Transportial maakt van elk label een pdf-pagina van 4×6 inch, of bewaart ZPL zoals het binnenkomt.
• Een zending kan alleen worden geannuleerd zolang UPS hem nog niet heeft opgehaald.

Typisch gebruik

Een groothandel in Venlo verstuurt onderdelen naar garages in heel Europa en naar enkele klanten in de VS. Palletorders gaan met de eigen trucks; pakketten worden gepland op een Trip onder een UPS-capaciteitscontract, met UPS Standard als standaard en Express Saver voor spoedorders. Bij het bevestigen wordt elke zending geboekt, en het magazijn print de labels en commerciële facturen vanuit de zending. De ophaalscan sluit de laadstop, de klantenservice ziet de geplande levering, en de losstop sluit zodra UPS het pakket als afgeleverd meldt.

Veelgestelde vragen