Artikkelin sisältö:
- Johdanto
- Pyynnön tiedot
- Omat sijainnit
-
Vasteen rakenne
- 4.1 Viiteosoite
- 4.2 Kuljetusyhtiön tiedot
- 4.3 Sijainnit kuljetusyhtiöittäin
- 4.4 Vasteen käyttäminen varauksessa
1. Johdanto
Verkkokuluttajat haluavat enemmän kontrollia siihen, missä ja milloin tavarat toimitetaan. Yksi kuljetusyhtiöiden tarjoamista palveluista on noutopisteet. Jotkut kuljetusyhtiöt kutsuvat niitä noutopisteiksi, toiset palvelupisteiksi, PUDO (Pick-up/Drop-off) -pisteiksi tai vastaavalla nimellä. Kaikki tarkoittavat samaa: sijaintia, josta loppuasiakas voi noutaa tavarat aukioloaikoina. Transsmart tarjoaa mahdollisuuden tehdä location select -kutsuja niille kuljetusyhtiöille, joilla tämä on käytettävissä.
2. Pyynnön tiedot
Location request -kutsu voidaan tehdä palveluun /v2/locations/{account}. Kutsussa on muutamia parametreja, joita voidaan tai täytyy antaa. Kutsu perustuu osoitteeseen. Osoitteen antaa yleensä loppuasiakas, jolla on myös mahdollisuus valita tämän kutsun tuloksena tarjottu noutopiste. Tyypillisesti tätä käytetään verkkokauppaintegraatiossa kassavaiheessa.
Aina kun kohtaat termin address, se viittaa sijaintiin, jonka lähellä pyydetyn noutopisteen tulisi olla. Yleensä tämä on osoite lähellä loppuasiakkaan kotia tai työpaikkaa.
| Parameter | Description |
| street | Osoitteen katu |
| houseNumber | Talon numero |
| houseNumberExt | Talon numeron lisäosa, esimerkiksi ”a” kohdassa 1a |
| zipCode | Postinumero |
| city | Osoitteen kaupunki |
| countryFrom | Lähetyksen lähtömaa |
| countryTo | Maa, johon lähetys lähetetään. |
| ownLocationOnly | Parametri, jolla asiakkaan omat sijainnit voidaan näyttää tai piilottaa. Tätä selitetään tarkemmin myöhemmin. |
| Vastaanottajan sähköpostiosoite. (tämä on pakollinen kenttä ja tarvitaan vain GLS-kuljetusyhtiölle) | |
| provider | Kuljetusyhtiö, jolta haluat hakea sijainnit. Jos parametria ei ole mukana pyynnössä, saat kaikki käytettävissä olevat sijainnit kaikilta niiltä kuljetusyhtiöiltä, jotka on määritetty tilillesi; voit myös lisätä useita kuljetusyhtiöitä tähän osioon. Lisätietoja on teknisessä dokumentaatiossa. |
| limit | Mahdollisuus rajoittaa tuloksia kuljetusyhtiöittäin. Oletusarvo on 20 tulosta kuljetusyhtiötä kohden. |
3 Omat sijainnit
Voit lisätä omia sijainteja logon kanssa. Oma sijainti voi olla fyysinen myymälä, johon voit lähettää lähetyksiä ja josta asiakkaasi voivat noutaa tavarat. Jotta voit lisätä omia sijainteja, sinun on otettava yhteyttä tukiosastoon, jotta he voivat aktivoida ominaisuuden puolestasi. Omien sijaintien ylläpito tehdään valikossa Manage account > Locations & Cost Centers.
4 Vasteen rakenne
Vasteessa saat pyydetyt sijainnit sekä niihin liittyvät lisätiedot, jotka voivat olla olennaisia loppukäyttäjälle. Saat esimerkiksi verkkosivullasi näytettävän kuljetusyhtiön logon, aukioloajat, sijainnin (maantieteelliset koordinaatit) jne. Näiden tietojen avulla sijainti voidaan valita.
4.1 Viiteosoite
Ensimmäisenä näet viiteosoitteen (alkuperäisen osoitteen, jonka tulee sijaita lähellä sijainteja). Viiteosoitteella on myös maantieteelliset koordinaatit ja Google Maps -URL, jonka avulla sijainti voidaan näyttää kartalla.
4.2 Kuljetusyhtiön tiedot
Viiteosoitteen jälkeen saat kuljetusyhtiön tiedot. Nämä ovat yleisiä tietoja, jotka ovat kyseiselle kuljetusyhtiölle ominaisia. Näiden yleisten tietojen jälkeen saat yksityiskohtaiset tiedot palvelupistettä kohti. Kullekin kuljetusyhtiölle saat kuljetusyhtiön koodin, kuljetusyhtiön description:n, kuljetusyhtiön logon (base64-koodattuna) sekä merkin, joka näytetään kassalla.
4.3 Sijainnit kuljetusyhtiöittäin
Kuljetusyhtiötä kohden saat noutopisteet. Oletuksena saat 20 sijaintia, mutta parametrilla voidaan asettaa rajoitus. Sijainneilla on seuraavat tiedot: etäisyys kilometreinä viiteosoitteeseen, nimi ja osoitetiedot. Kuljetusyhtiöstä riippuen saat myös locationId-tunnuksen, joka täytyy käyttää varauksessa, jos se on saatavilla (tämä selitetään myöhemmin).
Päivää kohden saat aukioloajat, ja sijaintitietojen lopussa annetaan sijainnin maantieteelliset koordinaatit sekä Google Maps -URL. Tämä toistuu jokaista sijaintia ja kuljetusyhtiötä kohden.
4.4 Vasteen käyttäminen varauksessa
Kun loppuasiakas on valinnut sijainnin etupään karttanäkymän perusteella, sinun on tehtävä varaus. Yleisesti ottaen sinun tulee kopioida annettu locationId-parametri SERVICEPOINT-tyyppiseen additional reference -arvoon. Lisäksi vastaanottajan alkuperäiset osoitetiedot on kopioitava invoice-segmenttiin. Nämä ovat normaalisti loppukäyttäjän osoitetiedot. Valitun noutopisteen osoitetiedot on sitten sijoitettava receiver-segmenttiin. Tämä on lähetyksen toimitusosoite. Menettely voi vaihdella hieman kuljetusyhtiöstä riippuen.