Versand · UPS
UPS meldet ins CRM statt in einen separaten Tab
BetaBeta: Die Verbindung ist bereits heute möglich; die Funktionen des Kanals werden noch ausgebaut.
Der Manager sieht, wo sich das Paket befindet, an derselben Stelle wie die Bestellung, das Produkt und die Unterhaltung mit dem Käufer. Zum Verbinden genügt eine App im UPS-Portal – kein Vertrag, keine Freigabe.
- Was verbunden wird
- Track API (TrackService v1)
- Authentifizierung
- OAuth Client Credentials
- Aktualisierungsintervall
- stündlich
Was sie leistet und was nicht
Aktualisiert den Sendungsstatus
Jede Stunde fragt der Cron bei UPS jeden Versandschein Ihrer Bestellungen ab, der noch unterwegs ist, und setzt die Sendung auf „ausstehend“, „unterwegs“ oder „zugestellt“.
Hält das Lieferdatum aktuell
Wenn UPS umplant, speichert das CRM das neue Datum – das veraltete Versprechen verschwindet, statt auf der Karte stehen zu bleiben.
Erstellt keine Versandetiketten
Das Drucken von Versandetiketten gehört zur Shipping API von UPS: ein anderes Produkt, das eine UPS-Kontonummer und einen Versandvertrag voraussetzt. Wir versprechen es nicht.
Ändert bei einer Ausnahme nichts am Paketstatus
UPS kennzeichnet sowohl eine Zollverzögerung als auch eine Adresskorrektur als Ausnahme – Fälle, in denen das Paket meist trotzdem ankommt. Das CRM lässt den Status unverändert, statt das Paket für gescheitert zu erklären und aufzugeben.
UPS-Status → Sendungsstatus im CRM
| UPS | CRM |
|---|---|
| Manifest – Versandetikett erstellt, von UPS noch nicht abgeholt | Ausstehend |
| On the Way – unterwegs | Unterwegs |
| Delivery – zugestellt | Zugestellt |
| Manifest Void – der Absender hat das Versandetikett storniert | Storniert |
| Updated Delivery Date – nur die Schätzung hat sich verschoben | Status unverändert, Datum aktualisiert |
| Package Exception – Zoll, Adresse und Ähnliches | Status unverändert |
So verbinden Sie UPS
- 01
App erstellen
developer.ups.com → Apps → App erstellen und das Produkt „Tracking“ hinzufügen. Tracking erfordert keinen Vertrag.
- 02
In die Produktion überführen
Die Testumgebung von UPS antwortet nur auf ihre eigenen erfundenen Nummern, daher existieren Ihre echten Versandscheine dort nicht.
- 03
Client-ID und Secret ins CRM einfügen
Einstellungen → Integrationen → Plattformadapter → UPS. Das Paar wird verschlüsselt gespeichert und gelangt nie in den Browser.
- 04
Verbindung testen
Das CRM tauscht das Paar gegen ein Token aus und fragt nach einem bewusst unmöglichen Versandschein: „Keine solche Sendung“ beweist, dass der Zugriff funktioniert, ohne eine echte Sendung abzufragen.
Häufige Fragen
- Kann das CRM UPS-Versandetiketten drucken?
- Nein. Das ist die Shipping API – ein anderes UPS-Produkt, das eine Kontonummer und einen Versandvertrag voraussetzt. Wir verfolgen, was Sie bei UPS erstellt haben.
- Was kostet der API-Zugang?
- UPS-Sendungsverfolgung ist kostenlos: Dafür genügt eine App im Entwicklerportal.
- Gibt es ein Anfragelimit?
- UPS veröffentlicht keines – weder im Portal noch in den Spezifikationen, und die Antworten enthalten keine Kontingent-Header. Deshalb halten wir uns selbst zurück: eine Pause zwischen den Anfragen und höchstens 120 Versandscheine pro Lauf. Antwortet UPS mit „zu oft“, beendet das CRM den Lauf dieses Kontos, statt den Rest abzuarbeiten.
- Warum wird eine Ausnahme nicht als gescheiterte Zustellung markiert?
- Weil UPS als Ausnahme bezeichnet, was oft am nächsten Tag ankommt: eine Adresskorrektur, eine Zollverzögerung. Eine gescheiterte Zustellung ist ein Endzustand, nach dem das CRM nicht mehr nach dem Paket fragen würde, und es könnte nie als zugestellt erscheinen.
Eine Bestellliste, alle Versanddienstleister darin
Verbinden Sie UPS und sehen Sie internationale Sendungen dort, wo bereits die nationalen stehen.