Innhold i denne artikkelen:
- Introduksjon
- Informasjon i forespørselen
- Egne lokasjoner
-
Responsstruktur
- 4.1 Referanseadresse
- 4.2 Transportørinformasjon
- 4.3 Lokasjoner per transportør
- 4.4 Bruke responsen i bookingen
1. Introduksjon
Forbrukere ønsker mer kontroll over hvor og når varer leveres. En av tjenestene som transportører tilbyr er hentepunkter. Noen transportører kaller det pick-up points, mens andre kaller det service points, PUDO (Pick-up/Drop-off) eller noe tilsvarende. Alle betyr det samme. Det er et sted hvor sluttkunden kan hente varene i åpningstiden. Transsmart har en mulighet til å gjøre location select-kall for transportører som har dette tilgjengelig.
2. Informasjon i forespørselen
Et location request-kall kan gjøres mot tjenesten /v2/locations/{account}. Det er noen få parametere som kan eller må oppgis i kallet. Kallene starter med en adresse. Adressen oppgis normalt av sluttkunden, som også har mulighet til å velge hentepunktet som tilbys som resultat av dette kallet. Vanligvis brukes dette for webshop-integrasjon i checkout.
Når du støter på begrepet adresse, refererer det til stedet som det ønskede hentestedet skal ligge i nærheten av. Vanligvis er dette en adresse i nærheten av sluttkundens hjem eller arbeidsplass.
| Parameter | Description |
| street | street til adressen |
| houseNumber | Husnummer |
| houseNumberExt | Tillegg til husnummer, for eksempel a i 1a |
| zipCode | Postnummer |
| city | Byen for adressen |
| countryFrom | Landet sendingen vil bli sendt fra |
| countryTo | Landet sendingen skal sendes til. |
| ownLocationOnly | Parameter for å vise eller vise egne lokasjoner fra en kunde. Dette vil bli forklart mer detaljert senere. |
| E-postadressen til mottakeren. (dette er et obligatorisk felt og kun nødvendig for transportør GLS) | |
| provider | Transportøren du vil hente lokasjonene fra. Hvis parameteren ikke er inkludert i forespørselen, vil du motta alle tilgjengelige lokasjoner fra alle mulige transportører du har konfigurert på kontoen din. Du kan også legge til flere transportører i denne delen. For ytterligere forklaring, se den tekniske dokumentasjonen |
| limit | Mulighet til å begrense resultatene per transportør. Standard er 20 resultater per transportør |
3 Egne lokasjoner
Det er mulig å legge til egne lokasjoner med en logo. En egen lokasjon kan være en fysisk butikk hvor du kan sende til, og hvor kundene dine også kan hente varene. For å kunne legge til egne lokasjoner, må du kontakte supportavdelingen slik at de kan aktivere det for deg. Vedlikehold av egne lokasjoner kan gjøres i menyen Manage account > Locations & Cost Centers.
4 Response structure
I responsen vil du motta de forespurte lokasjonene med påfølgende detaljer som kan være relevante for sluttbrukeren. For eksempel vil du motta transportør med logo for visning på nettstedet ditt, åpningstider, lokasjon (geo-koordinater) osv. Med denne informasjonen kan en lokasjon velges.
4.1 Reference address
Først finner du referanseadressen (den opprinnelige adressen som skal være i nærheten av lokasjonene). Referanseadressen vil også ha geo-koordinater og en Google Maps URL for å vise lokasjonen på et kart.
4.2 Carrier information
Etter referanseadressen vil du motta informasjon om transportør. Dette er generell informasjon som er spesifikk for transportøren. Etter denne generelle informasjonen får du detaljert informasjon per servicepunkt. For hver transportør vil du motta transportørkode, en transportør description, en logo for transportøren (base64-kodet) og en markør som kan vises i check-out.
4.3 Locations per carrier
Per transportør vil du motta hentesteder. Som standard vil du motta 20, men en grense kan settes i en parameter. Lokalitetene har følgende informasjon: en avstand i kilometer til referanseadressen, et navn og adresseinformasjon. Avhengig av transportøren vil du også motta en locationId som, hvis tilgjengelig, må brukes i bookingen (vil bli forklart senere).
Per dag vil du motta åpningstider, og på slutten av lokaliteten oppgis geo-koordinater og en Google Maps URL. Dette gjentas per lokalitet og transportør.
4.4 Bruke svaret i bookingen
Etter at et hentested er valgt av en sluttkunde basert på visningen på kartet i front end, må du opprette en booking. Generelt må du kopiere den gitte locationId-parameteren til additional reference-verdien av typen SERVICEPOINT. Videre må de opprinnelige adresseopplysningene til mottakeradressen kopieres til invoice-segmentet. Dette er normalt adresseopplysningene til sluttbrukeren. Adresseopplysningene til det valgte hentestedet må deretter plasseres i receiver-segmentet. Dette er leveringsadressen for pakken. Det kan være en litt annerledes prosedyre per transportør.