Inhalt dieses Artikels:
- Einführung
- Informationen in der Request
- Eigene Standorte
-
Response-Struktur
- 4.1 Referenzadresse
- 4.2 Carrier-Informationen
- 4.3 Standorte pro Carrier
- 4.4 Verwendung der Response in der Buchung
1. Einführung
Verbraucher möchten mehr Kontrolle darüber, wo und wann Waren zugestellt werden. Einer der Services, den Carrier anbieten, sind Pick-up-Points. Einige Carrier nennen sie Pick-up-Points, andere Service Points, PUDO (Pick-up/Drop-off) oder ein Äquivalent. Alle bedeuten dasselbe. Es ist ein Standort, an dem der Endkunde die Waren während der Öffnungszeiten abholen kann. Transsmart bietet die Möglichkeit, Location-Select-Calls für Carrier durchzuführen, die diese Funktion zur Verfügung stellen.
2. Informationen in der Request
Ein Location-Request-Call kann über den Service /v2/locations/{account} ausgeführt werden. Es gibt einige Parameter, die im Call optional oder verpflichtend angegeben werden müssen. Die Calls beginnen mit einer Adresse. Die Adresse wird in der Regel vom Endkunden bereitgestellt, der auch die Möglichkeit hat, den Pick-up-Point auszuwählen, der als Ergebnis dieses Calls angeboten wird. Normalerweise wird dies für eine Webshop-Integration im Checkout verwendet.
Wann immer du auf den Begriff address stößt, bezieht er sich auf den Ort, in dessen Nähe sich der gewünschte Abholpunkt befinden soll. In der Regel ist dies eine Anschrift in der Nähe des Zuhauses oder des Arbeitsplatzes des Endkunden.
| Parameter | Description |
| street | Die street der Adresse |
| houseNumber | Hausnummer |
| houseNumberExt | Hausnummernzusatz, zum Beispiel das a in 1a |
| zipCode | Die Postleitzahl |
| city | Die Stadt der Adresse |
| countryFrom | Das Land, aus dem die Sendung verschickt wird |
| countryTo | Das Land, in das die Sendung verschickt wird. |
| ownLocationOnly | Parameter zum Anzeigen oder Darstellen eigener Standorte eines Kunden. Dies wird später im Detail erläutert. |
| Die E-Mail-Adresse des Empfängers. (dies ist ein Pflichtfeld und nur für Carrier GLS erforderlich) | |
| provider | Der Carrier, von dem du die Standorte abrufen möchtest. Wenn der Parameter nicht in der Anfrage enthalten ist, erhältst du alle verfügbaren Standorte aller möglichen Carrier, die du in deinem Konto konfiguriert hast. Du kannst in diesem Abschnitt auch mehrere Carrier hinzufügen. Eine weitere Erläuterung findest du in der technischen Dokumentation. |
| limit | Möglichkeit, die Ergebnisse pro Carrier zu begrenzen. Der Standardwert liegt bei 20 Ergebnissen pro Carrier. |
3 Eigene Standorte
Es besteht die Möglichkeit, eigene Standorte mit einem Logo hinzuzufügen. Ein eigener Standort kann ein physisches Geschäft sein, zu dem du versenden kannst und an dem deine Kund:innen die Waren auch abholen können. Um eigene Standorte hinzufügen zu können, musst du den Support kontaktieren, damit diese Funktion für dich aktiviert wird. Die Pflege eigener Standorte kann im Menü Manage account > Locations & Cost Centers erfolgen.
4 Antwortstruktur
In der Response erhältst du die angeforderten Standorte mit nachgelagerten Details, die für die Endnutzer:innen relevant sein könnten. Du erhältst zum Beispiel den Carrier mit einem Logo zur Anzeige auf deiner Website, die Öffnungszeiten, den Standort (Geo-Koordinaten) usw. Mit diesen Informationen kann ein Standort ausgewählt werden.
4.1 Referenzadresse
Zuallererst findest du die Referenzadresse (die ursprüngliche Adresse, die in der Nähe der Standorte liegen muss). Die Referenzadresse verfügt ebenfalls über Geo-Koordinaten und eine Google Maps URL, um den Standort auf einer Karte anzuzeigen.
4.2 Carrier-Informationen
Nach der Referenzadresse erhältst du Carrier-Informationen. Dies sind allgemeine Informationen, die spezifisch für den Carrier sind. Nach diesen allgemeinen Informationen erhältst du detaillierte Informationen pro Service Point. Für jeden Carrier erhältst du den Carrier-Code, ein Carrier-description, ein Logo des Carriers (Base64-codiert) und einen Marker zur Anzeige beim Check-out.
4.3 Standorte pro Carrier
Pro Carrier erhältst du Abholstandorte. Standardmäßig erhältst du 20, aber eine Obergrenze kann in einem Parameter festgelegt werden. Die Standorte enthalten folgende Informationen: eine Entfernung in Kilometern zur Referenzadresse, einen Namen und die Adressinformationen. Abhängig vom Carrier erhältst du außerdem ein locationId, das, sofern vorhanden, in der Buchung verwendet werden muss (wird später erläutert).
Pro Tag erhältst du Öffnungszeiten und am Ende des Standorts werden die Geo-Koordinaten und eine Google Maps URL angegeben. Dies wird pro Standort und Carrier wiederholt.
4.4 Verwendung der Response in der Buchung
Nachdem ein Standort von einem Endkunden basierend auf der Anzeige auf der Karte im Frontend ausgewählt wurde, musst du eine Buchung vornehmen. Im Allgemeinen musst du den angegebenen locationId Parameter in den zusätzlichen Referenzwert vom Typ SERVICEPOINT kopieren. Darüber hinaus müssen die ursprünglichen Adressdaten der Empfängeradresse in das Invoice-Segment kopiert werden. Dabei handelt es sich normalerweise um die Adressdaten des Endnutzers. Die Adressdaten des ausgewählten Abholstandorts müssen dann im Receiver-Segment hinterlegt werden. Dies ist die Versandadresse für das Paket. Es kann ein leicht unterschiedliches Verfahren pro Carrier geben.