WooCommerce Noutopistehaku / Ohjeet

1. Yleistä lisäosasta

WooCommerce Noutopistehaku lisää tuen Postin, Matkahuollon ja DB Schenkerin noutopistehauille verkkokauppaan. Lisäosan avulla asiakkaalle voidaan näyttää kassalla noutopistehaku, jolloin asiakas voi valita haluamansa noutopisteen tilaukseen.

Lisäosa on yhteensopiva myös Klarna Checkoutin kanssa.

2. Asennus

Lisäosa asennetaan kuten normaali WordPressin lisäosa.

  1. Kirjaudu WordPressin ylläpitoon
  2. Mene Lisäosat > Lisää uusi > Lataa lisäosa
  3. Valitse lisäosan zip-paketti (woo-carrier-agents.zip) ja klikkaa Asenna nyt
  4. Klikkaa Ota lisäosa käyttöön

3. Asetukset

Lisäosan asetukset löytyvät WooCommerce > Asetukset > Noutopistehaku. Asetukset on kuvattu alla olevassa taulukossa.

Näyttötyyli Millaisessa muodossa noutopisteet näytetään kassalla, joko vapaa noutopistehaku, valintalista tai -napit.
Lisää valittu noutopiste "Uusi tilaus" sähköpostiin Näytetäänkö valittu noutopiste sähköpostissa.
Näytä valittu noutopiste "Kiitos tilauksesta" sivulla Näytetäänkö valittu noutopiste tilauksen vahvistamisen jälkeen kiitos-sivulla.

4. Toimitustapojen määrittely

Toimitustavat määritellään toimitusvyöhykkeiden avulla. Toimitusvyöhyke tarkoittaa tiettyä aluetta, millä on omat toimitustapansa. Esimerkiksi Suomi, Eurooppa ja Yhdysvallat voisivat olla toimitusvyöhykkeitä. Mikäli toimitusvyöhykkeitä ei ole vielä tehty, tulee ne tehdä kohdassa WooCommerce > Toimitus.

Kun toimitusvyöhykkeet on määritelty, niin sen jälkeen luodaan toimitustavat.

  1. Mene WooCommerce > Asetukset > Toimitus > [toimitusvyöhyke]
  2. Klikkaa Lisää toimitustapa
  3. Valitse avautuvasta valikosta joko Postin, Matkahuollon tai DB Schenkerin toimitustapa noutopisterekisterillä
    1. Jos käytät Shipitiä, valitse Shipit noutopistehaulla
  4. Syötä asetukset, jotka on kuvattu alla olevassa taulukossa. Sen jälkeen tallenna asetukset.
  5. Varmista, että toimitustavat ja noutopisteet näkyvät oikein kassalla.
Otsikko Toimitustavan nimi kassalla
Verotus Veloitetaanko toimitustavasta verot, yleensä kyllä.
Hinnoittelutapa Hinnoitellaanko toimitustapa kiinteästi vai painoluokittain.
Hinta Toimitustavan hinta
Noutopisteen tyyppi Millaisia noutopisteitä näytetään (esim. pelkästään pakettiautomaatit tai toimipisteet). Vain Postille ja Matkahuollolle.
Matkahuollon käyttäjätunnus (vain Matkahuolto) Matkahuollolta saatu käyttäjätunnus noutopistehakuun.
Rajapinnan versio (vain Matkahuolto) Matkahuollon rajapinnan versio, yleensä 2.

5. Noutopisteen tarkastelu ylläpidosta

Kun asiakas valitsee noutopisteen kassalla, niin se näkyy tilauksessa ylläpidossa sivupalkissa:

6. Klarna Checkout integraatio

Noutopistehaun käyttäminen Klarna Checkoutin kanssa riippuu Klarna Checkoutin lisäosan versiosta.

Versio 3

Noutopistehaun käyttäminen Klarna Checkout V3 kanssa vaatii seuraavat asiat:

  • Noutopistehaun asetuksista (WooCommerce > Asetukset > Noutopistehaku) valitaan valintalistan tyypiksi Vapaa noutopistehaku postinumerolla
  • Klarnan asetuksista (WooCommerce > Asetukset > Maksut > Klarna Checkout > Shipping settings) otetaan ruksi pois kohdasta Display shipping methods in Klarna iframe

Klarna välimuistittaa kassan, joten muutosten näkyminen saattaa vaatia selaimen evästeiden / välimuistin tyhjennyksen ja/tai ulos- ja sisäänkirjautumisen WP:stä.

Esimerkki Klarna Checkout V3 kassasta, missä on Noutopistehaku:

Versio 2

Lisäosa ei enää tue Klarna Checkoutin vanhaa versiota.

7. Noutopisteen tietojen hakeminen koneellisesti (kehittäjille)

Lisäosa tarjoaa mahdollisuuden hakea noutopisteen tiedot koneellisesti. Tätä tarvitaan esimerkiksi silloin, kun halutaan välittää valittu noutopiste 3. osapuolen järjestelmään integraatiolla.

Noutopisteen ID:n hakeminen

woo_carrier_agents_get_agent_id( $order_id );

Funktio ottaa parametrina tilauksen ID:n ja palauttaa logistiikkayrityksen sisäisen ID:n noutopisteelle. ID:tä käytetään esimerkiksi silloin, kun pakettikorttia tehdään.

Noutopisteen kaikkien tietojen hakeminen

woo_carrier_agents_get_agent( $order_id );

Funktio ottaa parametrina tilauksen ID:n ja palauttaa noutopisteen Agent-luokan objektina. Esimerkki tietojen käyttämisestä:

$agent = woo_carrier_agents_get_agent( $order_id );

if ( $agent ) {
  $agent->id; // ID
  $agent->title; // Nimi, esim. "Pakettiautomaatti, K-Market"
  $agent->street_address; // Katuosoite
  $agent->street_address2; // 2. katuosoite
  $agent->postcode; // Postinumero
  $agent->city; // Kaupunki
  $agent->country; // Maa
  $agent->distance; // Etäisyys asiakkaan osoitteesta noutopisteeseen
  $agent->carrier; // Logistiikkafirman ID, esim. "posti" tai "schenker"
$agent->data; // Kuljetusliikekohtaista lisätietoa arrayssa,
// esim Postille routing service code
}