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.
Zusatzleistungen
Gebucht wird im Dialog Versenden des Versands. Was der Dienstleister so nicht annimmt, lehnt die Anbindung vor der Buchung mit dem Grund ab — die Ware verlässt das Haus nicht ohne die gebuchte Leistung.
- Nachnahme (COD) mit Betrag; abgerechnet wird über die UPS-Kundennummer, eine Bankverbindung je
Sendung ist nicht nötig.
- Zusatzversicherung (Wertdeklaration, erweiterte Haftung) mit dem zu versichernden Warenwert.
- Beträge auch in fremder Währung: neben Euro nimmt UPS CHF, CZK, DKK, GBP, HUF, NOK, PLN, RON und SEK
unverändert an; andere Währungen rechnet der Versand zum am Auftrag eingefrorenen Kurs in Euro um.
- Keine Zustellorte über diese Anbindung; ein UPS Access Point geht über shipcloud oder Sendcloud.
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.