Indhold i denne artikel:
- Introduktion
- Information i Request
- Egne lokationer
-
Response-struktur
- 4.1 Referenceadresse
- 4.2 Carrier-information
- 4.3 Lokationer pr. carrier
- 4.4 Brug af response i bookingen
1. Introduktion
Forbrugere ønsker mere kontrol over, hvor og hvornår varer bliver leveret. En af de services, som carriers tilbyder, er pick-up points. Nogle carriers kalder det pick-up points, andre kalder det service points, PUDO (Pick-up/Drop-off) eller noget tilsvarende. Det betyder det samme. Det er et sted, hvor slutkunden kan afhente varerne i åbningstiden. Transsmart har mulighed for at foretage location select calls for carriers, der understøtter dette.
2. Information i Request
Et location request call kan foretages på servicen /v2/locations/{account}. Der er nogle få parametre, som kan eller skal angives i call’et. Call’et starter med en adresse. Adressen angives normalt af slutkunden, som også har mulighed for at vælge det pick-up point, der vises som resultat af dette call. Normalt bruges dette til webshop-integration i checkout.
Når du ser betegnelsen address, henviser den til den placering, som det ønskede afhentningssted skal ligge i nærheden af. Det er som regel en adresse tæt på slutkundens hjem eller arbejdsplads.
| Parameter | Description |
| street | Gaden i adressen |
| houseNumber | Husnummer |
| houseNumberExt | Tillæg til husnummer, for eksempel a’et i 1a |
| zipCode | Postnummeret |
| city | Byen i adressen |
| countryFrom | Landet, som forsendelsen sendes fra |
| countryTo | Landet, som forsendelsen sendes til |
| ownLocationOnly | Parameter til at vise eller skjule egne lokationer for en kunde. Dette bliver forklaret mere detaljeret senere. |
| Modtagerens e-mail. (dette er et obligatorisk felt og kun nødvendigt for carrier GLS) | |
| provider | Den carrier, du vil hente lokationer fra. Hvis parameteren ikke er med i anmodningen, modtager du alle tilgængelige lokationer fra alle de carriers, du har konfigureret på din konto; du kan også tilføje flere carriers i dette afsnit. Se den tekniske dokumentation for en nærmere forklaring. |
| limit | Mulighed for at begrænse antallet af resultater pr. carrier. Standardværdien er 20 resultater pr. carrier. |
3 Egne lokationer
Der er mulighed for at tilføje dine egne lokationer med et logo. En egen lokation kan være en fysisk butik, som du kan sende til, og hvor dine kunder også kan afhente varerne. For at kunne tilføje egne lokationer skal du kontakte supportafdelingen, så de kan aktivere funktionen for dig. Vedligeholdelse af egne lokationer kan foretages i menuen Manage account > Locations & Cost Centers.
4 Svarstruktur
I svaret modtager du de ønskede lokationer med tilhørende oplysninger, som kan være relevante for slutbrugeren. For eksempel modtager du transportøren med et logo til visning på din hjemmeside, åbningstider, lokationen (geo-koordinater) osv. Med disse oplysninger kan en lokation vælges.
4.1 Referenceadresse
Først og fremmest finder du referenceadressen (den oprindelige adresse, som skal ligge tæt på lokationerne). Referenceadressen vil også have geo-koordinater og en Google Maps-URL til at vise lokationen på et kort.
4.2 Transportøroplysninger
Efter referenceadressen modtager du oplysninger om transportøren. Dette er generelle oplysninger, som er specifikke for den enkelte transportør. Efter disse generelle oplysninger får du detaljerede oplysninger pr. service point. For hver transportør modtager du transportørkoden, en transportør description, et logo for transportøren (base64-kodet) og en markør til visning ved check-out.
4.3 Lokationer pr. transportør
Pr. carrier modtager du afhentningssteder. Som standard modtager du 20, men en grænse kan angives i en parameter. Stederne indeholder følgende oplysninger: en afstand i kilometer til referenceadressen, et navn og adresseoplysningerne. Afhængigt af carrier modtager du også en locationId, som, hvis den er tilgængelig, skal bruges i bookingen (vil blive forklaret senere).
For hver dag modtager du åbningstider, og nederst i oplysningerne om lokationen angives geokoordinaterne og en Google Maps-URL. Dette gentages for hver lokation og carrier.
4.4 Brug af svaret i bookingen
Når en lokation er valgt af en slutkunde på baggrund af visningen på kortet i frontenden, skal du foretage en booking. Som udgangspunkt skal du kopiere den angivne locationId-parameter til den ekstra referenceværdi af typen SERVICEPOINT. Derudover skal de oprindelige adresseoplysninger for modtageradressen kopieres til fakturasegmentet. Dette er normalt slutbrugerens adresseoplysninger. Adresseoplysningerne for den valgte afhentningslokation skal derefter placeres i modtagersegmentet. Dette er forsendelsesadressen for pakken. Der kan være en lidt anden procedure for hver carrier.