Tässä artikkelissa kerrotaan, miten Delivery Checkoutin määritykset poikkeavat oletusmäärityksistä, kun sitä käytetään yhdessä Kustomin kanssa.
Tämän artikkelin osiot:
- Luo Delivery Checkout käytettäväksi Kustomin kanssa
- Toimitustavat
- Mukautetut lisäpalvelut
- DeliveryCheckout API
- Lisäartikkelit
Luo Delivery Checkout käytettäväksi Kustomin kanssa
Jos olet uusi Delivery Checkoutin käyttäjä, suosittelemme aloittamaan näiden artikkeleiden lukemisella: Aloittaminen Checkoutin kanssa ja Delivery Checkoutin määrittäminen.
- Ennen aloittamista sinun tulee:
- Omistaa Kustom Checkout -integraatio (KCOv3).
- Omistaa kirjautumistiedot Kustom Merchant Portaliin.
- Olla nShiftin asiakas ja omistaa kirjautumistiedot nShift Deliveryyn.
- Luo Delivery Checkout -rakenne tarpeidesi mukaan syöttämällä tarvittavat tiedot, kuten palvelut, hinnat ja noutopisteet. Tilauksestasi riippuen sinun tulee käyttää jotakin seuraavista malleista: Kustom - Essential, Kustom - Professional, Kustom - Premium tai Kustom standard. Katso lisätietoja Tilaukset ja ominaisuudet -artikkelista.
- Noudata artikkeleiden Delivery Checkoutin määrittäminen ja Luo Delivery Checkout ohjeita. Kiinnitä erityistä huomiota alla olevaan Toimitustavat-osioon, sillä se eroaa Kustomin työnkulussa.
-
Lisää nShift Delivery API -tunnistetiedot Kustom Portaliin. Valitse TMS-järjestelmäksi "nShift/Unifaun DeliveryCheckout (v1)". Lisättävät arvot ovat Identifier ja Key. Alla on ohjeet niiden löytämiseen:
Identifier: Yhdistä API-avaimen ensimmäinen osa, nimeltään "ID", checkout-tunnukseen väliviivalla erotettuna. API-avain löytyy kohdasta Maintenance > API keys > API key details. Muoto:
[API key ID]-[checkout ID]
Tärkeää: Käytä väliviivaa ilman ylimääräisiä välilyöntejä.
Esimerkki:
GHBAVZ3EXITYS-a361edd1-93bb-471d-adbc-05337f632d86
Checkout-tunnus löytyy kohdasta Maintenance > Delivery checkout > Search sarakkeesta Delivery checkout ID.
Key: Tämä on API-avaimen toinen osa, nimeltään Secret ID, Deliveryn API-avainasetusten sivulla. Lue lisää.Lue lisää täällä: https://docs.kustom.co/contents/partners/tms-partners/nshift
Delivery Checkout -prosessi Kustomin kanssa:
Toimitustavat
Useimmille toimitustavoille, palveluille, hinnoille ja lisäpalveluille voidaan käyttää ehtoja. Voit myös käyttää edistyneitä ehtoja tiettyjen tekstikenttien muuttamiseen dynaamisesti. Ennen Delivery Checkoutin luomista suosittelemme tutustumaan artikkeliin Johdanto toimitusehtoihin.
- Toimitustavalle annettu nimi, esimerkiksi "Kotiinkuljetus", on tarkoitettu vain sisäiseen käyttöön.
- Valitse Disabled, jos et halua toimitustavan olevan heti käytössä. Voit muuttaa Disabled-tilaa milloin tahansa, esimerkiksi jos kuljetusliikkeen palvelussa on tilapäinen häiriö tai haluat tarjota vaihtoehdon vain tiettynä vuodenaikana.
- Määritä toimitustapa Category-luokkaan, jos käytössä. Jos käytät sekä alatasoja että kategorioita, alataso tulee liittää kategoriaan. Monissa tapauksissa kategoriat voivat kuitenkin korvata alatasot.
- Valitse palvelu kohdassa Service.
- Klikkaa Add service.
Jos palvelu tukee noutopisteitä, voit käyttää geopaikannusta määrittämään, mitkä ja kuinka monta noutopistettä näytetään. Etäisyys lähimpiin noutopisteisiin lasketaan jokaiselle postinumerolle. Esimerkiksi arvo "20" tarkoittaa, että noutopisteet näytetään 20 km säteellä määritellystä GPS-sijainnista.
Geopaikannusta voidaan käyttää vain seuraavissa maissa: Belgia (BE), Tanska (DK), Viro (EE), Suomi (FI), Saksa (DE), Luxemburg (LU), Alankomaat (NL), Norja (NO), Ruotsi (SE) ja Ahvenanmaa (AX).- Syötä arvo kenttään Maximum radius (km), jos haluat näyttää noutopisteitä geopaikannuksen perusteella. Muussa tapauksessa arvon tulee olla "0".
- Kentällä Maximum number of agents voit rajoittaa näytettävien noutopisteiden määrää. Enintään 15 noutopistettä.
- Syötä arvo kenttään Maximum radius (km), jos haluat näyttää noutopisteitä geopaikannuksen perusteella. Muussa tapauksessa arvon tulee olla "0".
- Klikkaa New tai Free shipping kohdassa Prices syöttääksesi palvelun hinnan.
- Jos valitset New, syötä jokaisessa valuuttaosiossa:
- näytettävä hinta jokaiselle kielelle, esimerkiksi "€7" kenttään Finnish (fi)
- hinta numeerisena arvona, esimerkiksi "7.0" kenttään Price
- käytettävä verokanta, esimerkiksi "24" kenttään Tax rate (%)
- Jos valitset Free shipping, syötä jokaisessa valuuttaosiossa:
- näytettävä teksti, esimerkiksi "Ilmainen", kenttään Finnish (fi)
- ostoskorin arvo, jonka jälkeen toimitus on ilmainen, esimerkiksi "39.0", kenttään Limit for free delivery
- Kohdassa Addons klikkaa muokkauskuvaketta
sen lisäpalvelun vasemmalla puolella, jonka haluat ottaa käyttöön tai muokata.
- Valitse Preselected, Mandatory tai molemmat, jos lisäpalvelun tulee olla oletuksena valittuna ja/tai pakollinen verkkokaupassa.
- Klikkaa New kohdassa Prices lisätäksesi lisäpalvelun hinnat.
- Syötä jokaisessa valuuttaosiossa näytettävä hinta, esimerkiksi "€1" kenttään Finnish (fi), sekä numeerinen arvo, esimerkiksi "1.0" kenttään Price.
- Kun klikkaat OK poistuessasi sivulta Edit addon, lisäpalvelu aktivoidaan, vaikka et olisi syöttänyt mitään tietoja.
- Kohdassa Badges voit valita palvelulle tunnisteen, kuten "ympäristöystävällinen" tai "suositeltu".
- Klikkaa New.
- Klikkaa New.
- Jos valitset New, syötä jokaisessa valuuttaosiossa:
- Klikkaa OK.
- Kohdassa Delivery interval voit määrittää aikaisimman ja viimeisimmän toimitusajan päivinä.
Esimerkki:
Earliest delivery (business days): 1
Latest delivery (business days): 3
Paketti toimitetaan 1–3 arkipäivän kuluessa.
- Klikkaa New kohdassa Fields for titles, jos haluat lisätä otsikon, jota käytetään tietyin ehdoin.
- Syötä kohdassa Language otsikko aiemmin määrittämillesi kielille.
Fields for titles on pakollinen, mutta Kustom Checkoutin otsikot korvaavat sen.
- Syötä kohdassa Language otsikko aiemmin määrittämillesi kielille.
- Klikkaa New kohdassa Captions for field 1 lisätäksesi tekstiä. Sopiva teksti riippuu verkkokauppasi määrityksistä.
- Syötä kohdassa Language teksti aiemmin määrittämillesi kielille, esimerkiksi "Asiaankuuluva teksti" kenttään Finnish (fi).
- Syötä kohdassa Language teksti aiemmin määrittämillesi kielille, esimerkiksi "Asiaankuuluva teksti" kenttään Finnish (fi).
- Klikkaa New kohdassa Sort order määrittääksesi toimitustavan näyttöjärjestyksen.
- Kohdassa Number of days to delivery from today's date voit lisätä päiviä nykyiseen päivämäärään.
- Klikkaa New ja syötä kokonaisluku kenttään Value.
- Klikkaa New ja syötä kokonaisluku kenttään Value.
-
Esimerkki:
Earliest delivery time: 17:00
Latest delivery time: 22:00
Value: 2
Jos tämän päivän päivämäärä on 5. kesäkuuta, paketti toimitetaan 7. kesäkuuta klo 17:00–22:00 välillä.
Lisätäksesi uusia toimitustapoja Delivery Checkoutiin klikkaa New option sivulla New delivery checkout ja noudata yllä olevia vaiheita.
Joissakin osioissa, kuten toimitustavoissa ja hinnoissa, voit muuttaa näyttöjärjestystä verkkokaupassa. Käytä ylös ja alas
-kuvakkeita rivin vieressä tai käytä yllä kuvattua Sort order -asetusta.
Mukautettuja noutopisteitä käsitellään palveluina ja ne lisätään samalla tavalla kuin muutkin palvelut.
Klikkaa Test nähdäksesi, miten toimitustavat näkyvät verkkokaupassa syötettyjen parametrien perusteella.
tocity ja tozipcode ovat aina pakollisia, mutta joillekin kuljetusliikkeille voidaan vaatia myös muita parametreja.
Käytä hakutoimintoa Delivery Checkoutin tarkastelemiseen, muokkaamiseen tai poistamiseen.
Mukautetut lisäpalvelut
Mukautetut lisäpalvelut eivät ole sidottuja tiettyyn toimitustapaan, vaan niitä voidaan näyttää useiden toimitustapojen yhteydessä kassalla.
Niiden avulla voidaan tarjota asiakkaalle lisäpalveluita tai valintoja kassaprosessin aikana.
Esimerkkejä mukautetuista lisäpalveluista:
- Lahjapaketointi
- Toimitus ilman allekirjoitusta
- Ilmasto- tai ympäristökompensaatio
- Lisävakuutus
- Muut verkkokauppakohtaiset palvelut
Mukautettujen lisäpalveluiden käyttöönotto:
- Siirry kohtaan Maintenance > Delivery checkout.
- Avaa olemassa oleva Delivery Checkout tai luo uusi.
- Siirry lisäpalveluosioon.
- Ota haluamasi lisäpalvelut käyttöön.
Jokaiselle lisäpalvelulle voidaan määrittää:
- Title
- Description
- Price
- Preselected
- Mandatory
- Sort order
Preselected tarkoittaa, että lisäpalvelu valitaan automaattisesti, kun kassa näytetään asiakkaalle.
Mandatory tarkoittaa, että asiakas ei voi poistaa lisäpalvelun valintaa.
Lisäpalveluiden hinnat näytetään erikseen ja ne lisätään kokonaistoimitushintaan.
Lisäpalveluita voidaan hallita myös toimitusehdoilla ja edistyneillä ehdoilla.
Näin lisäpalvelu voidaan näyttää vain tietyissä maissa, postinumeroissa, tuotteissa tai tilausarvoissa.
Parametrit – kuljetusliikekohtaiset parametrit
Kuljetusliikekohtaisia parametreja käytetään lisätietojen välittämiseen Delivery Checkoutista Kustomiin.
Parametrit määritetään Delivery Checkoutin toimitustapojen yhteydessä.
Niiden avulla voidaan aktivoida tai ohjata tiettyjä toimintoja kassaprosessissa.
Parametreja on kahdenlaisia:
Tekstiparametrit
Tekstiparametrit välitetään avain/arvo-pareina.
Esimerkki:
products:4
Tässä parametri products välitetään arvolla 4.
Muita esimerkkejä:
deliverytype:home category:express service:pickup
Totuusarvoparametrit
Totuusarvoparametreilla ei ole arvoa.
Esimerkki:
freefreight
Kun parametri välitetään Kustomiin, sen arvoksi tulkitaan true.
Jos parametria ei välitetä, sen arvoksi tulkitaan false.
Tämän avulla toimintoja voidaan ottaa käyttöön tai poistaa käytöstä ilman erillisen arvon lähettämistä.
Parametrien käyttö
Parametreja voidaan käyttää esimerkiksi:
- Kassalogiikan ohjaamiseen.
- Toimitustapojen luokitteluun.
- Tiettyjen kassatoimintojen aktivointiin.
- Kuljetusliikekohtaisiin toimintoihin.
- Kolmannen osapuolen integraatioihin.
Parametrit välitetään valitun toimitustavan mukana Kustomiin, jossa niitä voidaan hyödyntää kassaprosessissa.
On suositeltavaa dokumentoida käytettävät parametrit sisäisesti yhtenäisen määrityksen ja ylläpidon varmistamiseksi.
DeliveryCheckout API
DeliveryCheckout API on integraatiopalvelu Delivery Checkoutin ja verkkokauppasi väliseen tiedonsiirtoon.
API käyttää REST API -kehystä ja JSON-muotoista tietoaineistoa toimitustapojen hakemiseen ja käsittelemiseen kassaprosessin aikana.
Kun Delivery Checkoutia käytetään yhdessä Kustomin kanssa, Kustomin ja DeliveryCheckout API:n välinen tiedonsiirto tapahtuu automaattisesti integraation kautta.
Kustom lähettää asiakkaan tilausta koskevat tiedot DeliveryCheckout API:lle ja vastaanottaa vastauksena asiaankuuluvat toimitustavat.
Palautetut toimitustavat näytetään kassalla, jossa asiakas voi valita haluamansa toimitustavan.
Valittu toimitustapa palautetaan tämän jälkeen Kustomille osana tilaustietoja.
Kustom-integraatio hyödyntää Delivery Checkoutissa määritettyjä parametreja, palveluita, hintoja, noutopisteitä, lisäpalveluita ja toimitusehtoja.
Tästä syystä kaikki käyttötapaukset kannattaa testata huolellisesti ennen tuotantokäyttöön siirtymistä.
Vararatkaisu (fallback)
Suosittelemme vahvasti vararatkaisun määrittämistä Kustomiin.
Vararatkaisu varmistaa, että asiakkaat näkevät toimitustavat myös silloin, kun Kustom ei tilapäisesti saa yhteyttä nShift API:in.
Esimerkkejä tilanteista, joissa vararatkaisua voidaan tarvita:
- Suunnitellut huoltokatkot.
- Tilapäiset verkkoyhteysongelmat.
- Järjestelmien väliset aikakatkaisut.
- Kolmannen osapuolen palveluiden tilapäinen käyttökatko.
Vararatkaisun käyttöönotto vähentää keskeytyneiden kassaprosessien ja menetettyjen tilausten riskiä.
Katso Kustomin dokumentaatiosta suositukset vararatkaisun määrittämiseen.
Lisäartikkelit
Seuraavista artikkeleista voi olla hyötyä Delivery Checkoutin määrittämisessä ja hallinnassa yhdessä Kustomin kanssa:
- Aloittaminen Checkoutin kanssa
- Delivery Checkoutin määrittäminen
- Luo Delivery Checkout
- Johdanto toimitusehtoihin
- Edistyneiden ehtojen toiminnot
- Property reference guide
- Tilaukset ja ominaisuudet
Lisätietoa integraatiosta löytyy Kustomin dokumentaatiosta:
Tekniset tiedot DeliveryCheckout API:sta löytyvät API-dokumentaatiosta:
https://api.unifaun.com/rs-docs/