Innehåll i den här artikeln:
- Introduktion
- Information i Request
- Egna platser
-
Response-struktur
- 4.1 Referensadress
- 4.2 Transportörsinformation
- 4.3 Platser per transportör
- 4.4 Använda response i bokningen
1. Introduktion
Konsumenter vill ha mer kontroll över var och när varor levereras. En av tjänsterna som transportörer tillhandahåller är pick-up points. Vissa transportörer kallar det pick-up points, medan andra kallar det service points, PUDO (Pick-up/Drop-off) eller en motsvarighet. Alla betyder samma sak. Det är en plats där slutkunden kan hämta varorna under öppettider. Transsmart har ett alternativ för att göra location select calls för transportörer som har detta tillgängligt.
2. Information i Request
En location request call kan göras mot tjänsten /v2/locations/{account}. Det finns några parametrar som kan eller måste anges i call. Callen utgår från en adress. Adressen tillhandahålls normalt av slutkunden som också har möjlighet att välja den pick-up point som erbjuds som resultat av detta call. Vanligtvis används detta för webshop-integration i check-out-flödet.
När du stöter på termen address avser den den plats där den önskade upphämtningsplatsen ska ligga i närheten. Vanligtvis är detta en address i närheten av slutanvändarens hem eller arbetsplats.
| Parameter | Description |
| street | street för adressen |
| houseNumber | Husnummer |
| houseNumberExt | Tillägg till husnummer, till exempel a i 1a |
| zipCode | Postnummer |
| city | Stad för adressen |
| countryFrom | Landet som försändelsen skickas från |
| countryTo | Landet som försändelsen skickas till |
| ownLocationOnly | Parameter för att visa eller filtrera på egna platser från en kund. Detta förklaras mer i detalj senare. |
| Mottagarens e-postadress. (detta är ett obligatoriskt fält och behövs endast för transportör GLS) | |
| provider | Transportören vars platser du vill hämta. Om parametern inte tas med i förfrågan kommer du att få alla tillgängliga platser från alla möjliga transportörer som du har konfigurerat på ditt konto; du kan också lägga till flera transportörer i detta avsnitt. För ytterligare förklaring, se den tekniska dokumentationen |
| limit | Möjlighet att begränsa resultaten per transportör. Standardvärdet är 20 resultat per transportör |
3 Egna platser
Det finns möjlighet att lägga till egna platser med en logotyp. En egen plats kan vara en fysisk butik dit du kan skicka försändelser och där dina kunder även kan hämta upp varor. För att kunna lägga till egna platser behöver du kontakta supportavdelningen så att de kan aktivera detta åt dig. Hantering av egna platser kan göras i menyn Manage account > Locations & Cost Centers.
4 Svarsstruktur
I svaret får du de efterfrågade platserna med tillhörande detaljer som kan vara relevanta för slutanvändaren. Du får till exempel transportören med en logotyp för visning på din webbplats, öppettider, plats (geokoordinater) osv. Med denna information kan en plats väljas.
4.1 Referensadress
Först hittar du referensadressen (den ursprungliga adressen som ska ligga nära platserna). Referensadressen kommer också att ha geokoordinater och en Google Maps-URL för att visa platsen på en karta.
4.2 Transportörsinformation
Efter referensadressen får du transportörsinformation. Detta är generell information som är specifik för transportören. Efter denna allmänna information får du detaljerad information per service point. För varje transportör får du transportörskoden, en transportörs-description, en logotyp för transportören (base64-kodad) och en markör att visa i kassan.
4.3 Platser per transportör
Per transportör får du upphämtningsställen. Som standard får du 20, men en gräns kan ställas in i en parameter. Platserna har följande information: ett avstånd i kilometer till referensadressen, ett namn och adressinformationen. Beroende på transportör får du också ett locationId som, om det finns tillgängligt, måste användas i bokningen (detta kommer att förklaras senare).
Per dag får du öppettider och längst ned i platsinformationen anges geokoordinaterna och en Google Maps-URL. Detta upprepas per plats och transportör.
4.4 Använda svaret i bokningen
När en plats har valts av en slutkund baserat på visningen på kartan i front end behöver du göra en bokning. Generellt behöver du kopiera den angivna locationId-parametern till det ytterligare referensvärdet av typen SERVICEPOINT. Vidare måste de ursprungliga adressuppgifterna för mottagaradressen kopieras till fakturasegmentet. Detta är normalt adressuppgifterna för slutanvändaren. Adressuppgifterna för det valda upphämtningsstället ska sedan placeras i mottagarsegmentet. Detta är leveransadressen för paketet. Det kan finnas ett något annorlunda förfarande per transportör.