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

Ainoa vaatimus Noutopistehaun käyttämiseksi Klarna Checkout V3:n kanssa on, että Noutopistehaun asetuksista valitaan valintalistan tyypiksi Vapaa noutopistehaku postinumerolla.

Esimerkki Klarna Checkout V3 kassasta, missä on Noutopistehaku:

Versio 2

Lisäosan käyttäminen Klarna Checkout V2:n (vanha versio) kanssa vaatii kolme asiaa:

  1. Shortcoden (lyhyt koodi) lisäämisen kassasivulle (ohjeet alla)
  2. Noutopistehaun asetuksista on valittava Vapaa noutopistehaku postinumerolla valintalistan tyypiksi
  3. Klarna Checkoutin asetuksista on ruksittava kohta Overwrite is_order_received_page to return true in Klarna thank you page

Shortcoden lisääminen

  1. Mene WordPressin ylläpito > Sivut
  2. Valitse se sivu, jota käytetään Klarna Checkoutin näyttämiseen
  3. Lisää ennen [woocommerce_klarna_checkout] shortcodea [woo_carrier_agents_search]
  4. Vapaaehtoinen: jos haluat lisäksi näyttää ostoskorin ja toimitustavan valinnan kassalla, niin lisää shortcode [woocommerce_klarna_checkout_widget]
  5. Tarkista, että kassalla näkyy noutopistehaku ennen Klarna Checkoutia

Esimerkki Klarna Checkout sivusta:

Esimerkki Klarna Checkout V2 kassasta, missä on noutopistehaku

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
}