Inhoud van dit artikel:
- Inleiding
- Informatie in de Request
- Eigen locaties
-
Responsestructuur
- 4.1 Referentieadres
- 4.2 Carrierinformatie
- 4.3 Locaties per carrier
- 4.4 Gebruik van de response in de booking
1. Inleiding
Consumenten willen meer controle over waar en wanneer goederen worden geleverd. Een van de diensten die carriers aanbieden, is het gebruik van afhaalpunten. Sommige carriers noemen dit pick-up points, anderen service points, PUDO (Pick-up/Drop-off) of een equivalent. Dit betekent allemaal hetzelfde. Het is een locatie waar de eindklant de goederen tijdens openingstijden kan afhalen. Transsmart heeft een optie om location select calls uit te voeren voor carriers die dit beschikbaar hebben.
2. Informatie in de Request
Een location request call kan worden gedaan op de service /v2/locations/{account}. Er zijn een aantal parameters die in de call kunnen of moeten worden meegegeven. De calls beginnen met een adres. Het adres wordt normaal gesproken aangeleverd door de eindklant, die ook de mogelijkheid heeft om het pick-up point te selecteren dat als resultaat van deze call wordt aangeboden. Meestal is dit voor webshopintegratie in de check-out.
Telkens wanneer u de term address tegenkomt, verwijst dit naar de locatie waar het gewenste afhaalpunt in de buurt moet zijn. Meestal is dit een adres dicht bij de woning of werkplek van de eindklant.
| Parameter | Description |
| street | De street van het adres |
| houseNumber | Huisnummer |
| houseNumberExt | Toevoeging bij het huisnummer, bijvoorbeeld de a in 1a |
| zipCode | De postcode |
| city | De plaats van het adres |
| countryFrom | Het land van waaruit de zending wordt verstuurd |
| countryTo | Het land waarnaar de zending wordt verstuurd. |
| ownLocationOnly | Parameter voor het tonen of weergeven van eigen locaties van een klant. Dit wordt later in detail uitgelegd. |
| Het e-mailadres van de ontvanger. (dit is een verplicht veld en alleen nodig voor carrier GLS) | |
| provider | De carrier waarvan je de locaties wilt ophalen. Als de parameter niet is opgenomen in de request, ontvang je alle beschikbare locaties van alle mogelijke carriers die op je account zijn geconfigureerd; je kunt in deze sectie ook meerdere carriers toevoegen. Zie de technische documentatie voor verdere uitleg |
| limit | Mogelijkheid om de resultaten per carrier te beperken. De standaardinstelling is 20 resultaten per carrier |
3 Eigen locaties
Er is een mogelijkheid om eigen locaties met een logo toe te voegen. Een eigen locatie kan een fysieke winkel zijn waarnaar u kunt verzenden en waar uw klanten de goederen ook kunnen afhalen. Om eigen locaties te kunnen toevoegen, moet u contact opnemen met de supportafdeling zodat zij dit voor u kunnen activeren. Het beheren van eigen locaties kan in het menu Manage account > Locations & Cost Centers.
4 Response structuur
In de response ontvangt u de opgevraagde locaties met bijbehorende details die relevant kunnen zijn voor de eindgebruiker. Zo ontvangt u bijvoorbeeld de carrier met een logo voor weergave op uw website, de openingstijden, de locatie (geo-coördinaten), enzovoort. Met deze informatie kan een locatie worden geselecteerd.
4.1 Referentieadres
Allereerst vindt u het referentieadres (het oorspronkelijke adres dat dicht bij de locaties moet liggen). Het referentieadres heeft ook geo-coördinaten en een Google Maps URL om de locatie op een kaart weer te geven.
4.2 Carrierinformatie
Na het referentieadres ontvangt u carrierinformatie. Dit is algemene informatie die specifiek is voor de carrier. Na deze algemene informatie krijgt u gedetailleerde informatie per servicepunt. Voor elke carrier ontvangt u de carrier code, een carrier description, een logo van de carrier (base64 encoded) en een marker om weer te geven bij de check-out.
4.3 Locaties per carrier
Per vervoerder ontvang je afhaallocaties. Standaard ontvang je er 20, maar er kan een limiet worden ingesteld in een parameter. De locaties bevatten de volgende informatie: een afstand in kilometers tot het referentieadres, een naam en de adresgegevens. Afhankelijk van de vervoerder ontvang je ook een locationId die, indien beschikbaar, in de boeking moet worden gebruikt (dit wordt later uitgelegd).
Per dag ontvang je openingstijden en aan het einde van de locatie worden de geo-coördinaten en een Google Maps URL weergegeven. Dit wordt herhaald per locatie en per vervoerder.
4.4 Gebruik van de response in de boeking
Nadat een locatie is geselecteerd door een eindklant op basis van de weergave op de kaart aan de front-end, moet je een boeking maken. In het algemeen moet je de opgegeven locationId parameter kopiëren naar de additional reference value van het type SERVICEPOINT. Daarnaast moeten de oorspronkelijke adresgegevens van het ontvangeradres worden gekopieerd naar het invoice segment. Dit zijn normaal gesproken de adresgegevens van de eindgebruiker. De adresgegevens van de geselecteerde afhaallocatie moeten vervolgens in het receiver segment worden geplaatst. Dit is het afleveradres voor het pakket. Er kan een iets andere procedure per vervoerder zijn.