UPS
Zweck
Diese Anbindung kauft UPS-Etiketten aus dem Versandprozess heraus. Sie deckt den breitesten Dienst-Fächer aller Anbindungen ab und trägt das höchste Einzelgewicht — deshalb ist sie meist die Wahl für internationale und schwere Sendungen.
Funktionsumfang
- Fünf Dienste:
standard,express,expedited,saverundground. - Höchstgewicht 70 kg je Packstück.
- Sendungsverfolgung mit Statusabgleich.
- Retourenetiketten aus demselben Vorgang.
- Zollabwicklung über dieselbe Anfrage wie das Etikett — anders als bei DPD und Hermes, wo sie
einen anderen Weg nimmt.
- Echtes Storno, solange die Sendung nicht eingeliefert ist.
Einrichtung
Die Zugangsdaten stehen als Integration unter Integrationen — Anbieter ups. Die Namen der Zugangsschlüssel tragen den Anbieter vorne; so bleiben sie von den Einstellungen anderer Anbindungen getrennt.
| Einstellung | Pflicht | Bedeutung |
|---|---|---|
ups_client_id | ja | Anwendungs-Kennung (OAuth, Client Credentials). Wird verschlüsselt abgelegt und nie wieder angezeigt. |
ups_client_secret | ja | Anwendungs-Geheimnis dazu. Wird verschlüsselt abgelegt und nie wieder angezeigt. |
account_number | ja | Kundennummer („Shipper Number"). Ohne sie lehnt UPS jede Sendung ab. |
shipper | nein | Absenderanschrift als Feldgruppe; geht unverändert an UPS, Feldnamen wie in der UPS-Schnittstelle. |
label_format | nein | gif (Standard) oder zpl für den Etikettendrucker. |
production | nein | true schaltet in den Echtbetrieb. Ohne Angabe läuft alles gegen die Testumgebung. |
Zugangsdaten, die noch unter dem alten Namen ohne Anbieter-Präfix im Klartext stehen, übernimmt das System verschlüsselt — beim nächsten Speichern oder Lesen der Integration und mit dem Update-Schritt „Zugangsdaten verschlüsselt ablegen" (bin/console app:secrets:migrate).
Zusammenspiel
Die Anbindung hängt am Versand: dort entsteht die Sendung, dort wird das Etikett gekauft, dort läuft die Sendungsverfolgung. Die Zugangsdaten stehen als Integration unter Integrationen in der verschlüsselten Ablage — nie in einer Einstellung und nie im Klartext; dieselbe Stelle schaltet zwischen Testumgebung und Produktion um. Etiketten und Lieferscheine gehen über Druck & Arbeitsplätze an den richtigen Drucker. Wann welches Etikett entsteht und in wie vielen Exemplaren, entscheiden Automationen — der Versand bringt dafür keine eigene Regel-Mechanik mit.
Grenzen
- Der Echt-Lauf steht aus. Geprüft ist, dass wir richtig fragen und die Antwort richtig deuten —
die Prüfungen fahren die Schnittstelle mit vorbereiteten Antworten. Dass UPS die erzeugte Anfrage tatsächlich annimmt, ist damit nicht belegt; dafür fehlt ein Zugang zur echten Testumgebung.
- Preise und Vertragskonditionen kommen nicht von hier. Was eine Sendung kostet, steht im
Vertrag mit dem Dienstleister; diese Anbindung kauft das Etikett, sie rechnet es nicht.