1. Yleistä lisäosasta
Matkahuolto-moduuli lisää tuen Matkahuollon toimitustavoille Magento 2 -verkkokauppaan. Lisäksi moduulin avulla pakettikortit tulostuvat suoraan hallintapaneelista, joka säästää työaikaa huomattavasti.
Tuetut toimitustavat
- Lähellä-paketti (Verkkopaketti)
- Bussipaketti
- Jakopaketti
- Kotijakelu
- Noutopaketti (Bussipaketti, jossa paketti haetaan samasta toimipisteestä kuin mihin se viedään)
2. Asentaminen
Moduuli asennetaan kuten muutkin Magento 2 -moduulit. Asennus vaatii kokemusta komentorivin ja FTP-ohjelman käytöstä. Tässä ohjeessa lisäosa asennetaan käyttäen komentoriviä. Tiedostot toimitetaan zip-tiedostossa, joka tulee purkaa ennen asennusta.
1. Lataa moduulin tiedostot FTP:llä Magenton app/code
kansioon niin, että ne löytyvät osoitteesta app/code/Markup/Matkahuolto
. Jos app
kansiosta ei löydy code
kansiota, tulee se luoda. HUOM! Moduuli tulee ladata app/code
kansioon eikä vendor
kansioon, koska asennukseen käytetään suoraa latausta eikä Composeria.
2. Mene Magenton juurikansioon käyttäen komentoriviä (SSH tai tietokoneen oma terminaali)
3. Aja komentorivillä seuraavat käskyt:
php bin/magento module:enable --clear-static-content Markup_Matkahuolto php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento setup:static-content:deploy en_US php bin/magento setup:static-content:deploy fi_FI php bin/magento cache:flush
4. Moduuli on asennettu onnistuneesti, jos edelliset käskyt eivät aiheuttaneet virheilmoituksia. Seuraavaksi tulee syöttää asetukset.
3. Asetukset
Moduulin asetukset löytyvät Magenton ylläpidosta kohdasta Stores > Configuration > Sales > Shipping Methods > Matkahuolto
. Alla olevassa taulukossa on kuvattu asetukset. Toimitustavat on kuvattu erikseen tämän ohjeen kappaleessa 4.
User ID | Käyttäjätunnus Matkahuollon rajapintaan. Testaukseen voi käyttää tunnusta 9430023, joka toimii vain testiympäristössä. |
Password | Salasana Matkahuollon rajapintaan. Testaukseen voi käyttää salasanaa 456. |
Mode | Tila, testaukseen ”Development” ja tuotantoon ”Live”. |
Office Search API | Noutopistehaun rajapintaversio. Yleensä versio 2, vanhemmilla Matkahuollon asiakkailla voi olla myös 1. |
4. Toimitustavat
Moduulissa on erikseen asetukset kaikille toimitustavoille. Jokaiselle toimitustavalle on kolme eri asetusta:
[Toimitustapa] Title | Kassalla näytettävä nimi toimitustavalle. |
[Toimitustapa] Enabled for Checkout | Näytetäänkö toimitustapa kassalla. |
[Toimitustapa] Pricing | Toimitustavan hinnoittelu |
[Toimitustapa] Free Shipping Amount Threshold | Ilmaisen toimituksen raja |
Lisäksi noutopakettia käyttäessä on syötettävä toimitus/noutopisteen tunnus (Agent ID). Tunnus löytyy Matkahuollon toimipistehausta ja on yleensä neljä numeroa.
4.1 Hinnoittelu
Toimitustavat on mahdollista hinnoitella painoluokittain. Silloin ”Maximum Weight (kg)” kenttään syötetään maksimipaino ja ”Cost” kenttään toimituskulun hinta. Jos toimituskuluille haluaa kiinteän hinnan, syötetään hinnoittelutaulukkoon ainoastaan yksi hinta ja maksimipainoksi toimitustavan suurin sallittu paino. Toimitustapaa ei näytetä kassalla, jos tuotteiden yhteenlaskettu paino ylittää hinnoittelussa määritellyn suurimman painon. Ominaisuus on hyödyllinen, jos verkkokauppa myy painavia tuotteita eikä toimita esimerkiksi Lähellä-paketilla yli 30 kg paketteja.
4.2 Noutopistehaku
Noutopistehaku näytetään kassalla Lähellä- ja bussipaketille. Lähellä-paketille näytetään kaikki noutopisteet, mutta bussipaketille ainoastaan Matkahuollon toimipisteet ja asiamiehet. Jakopaketille noutopisteitä ei näytetä, koska ne toimitetaan suoraan vastaanottajalle. Valittu noutopiste välittyy automaattisesti pakettikorttiin.
HUOM! Testitunnuksilla kaikki noutopisteet eivät ole käytettävissä. Pakettikorttia tehdessä saattaa siis tulla virheilmoitus, ettei valittua noutopistettä löydy tai paketti saatetaan ohjata toiseen noutopisteeseen. Tuotantotunnuksilla kaikki noutopisteet toimivat.
5. Pakettikortit
Pakettikortti tilaukselle luodaan Magenton hallintapaneelista. Pakettikortti voidaan luoda ainoastaan silloin, jos asiakas on valinnut kassalla toimitustavaksi Matkahuollon toimitustavan.
1. Mene hallintapaneelista Sales > Orders
ja valitse haluamasi tilaus
2. Klikkaa oikeasta yläkulmasta Ship
.
3. Kun New Shipment
sivu on avautunut, skrollaa sivun loppuun ja ruksita Create Shipping Label
. Klikkaa Submit Shipment
4. Seuraavaksi toimitukseen pitää lisätä toimitettavat tuotteet. Klikkaa Add Products to Package
ja valitse toimitettavat tuotteet. Lopuksi klikkaa Add Selected Products to Package
.
5. Syötä paketin paino kohtaan Total Weight
. Oletuksena haetaan tuotteiden yhteenlaskettu paino, mutta huomioon tulee ottaa myös pakkausmateriaalien paino.
6. Klikkaa Save
. Lähetys luodaan Matkahuollolle ja pakettikortti ladataan.
7. Seuraavaksi tulostetaan pakettikortti. Klikkaa tilausnäkymässä vasemmasta valikosta Shipments
ja klikkaa lähetystä.
8. Klikkaa Print Shipping Label
, jolloin pakettikortti ladataan PDF-muodossa tulostettavaksi.
Vaikka pakettikortin tekemisessä on useita eri vaiheita, onnistuu se lyhyen harjoittelun jälkeen hyvin nopeasti.
6. Bussiennakko
Moduulissa on sisäänrakennettuna tuki Bussiennakko-maksutavalle. Asiakkaan valitessa bussiennakon kassalla välittyy sen tiedot automaattisesti pakettikortille.
6.1 Bussiennakon asentaminen
- Mene
Stores > Configuration > Sales > Payment Methods
- Syötä
Bussiennakko Payment
kohdan alle asetukset - Klikkaa
Save Config
Instructions | Kassalla näytettävät ohjeet asiakkaalle. Esim. veloitukset, jos paketti jätetään noutamatta. Ei pakollinen. |
Fee | Tilaukseen lisättävä veloitus bussiennakosta. |
IBAN | Tilinumero IBAN-muodossa, johon Matkahuolto maksaa bussiennakon. |
BIC-code | Pankin BIC-koodi, johon Matkahuolto maksaa bussiennakon. |
Kassalla näkyy bussiennakko maksutapana aina, kun asiakas on valinnut jonkin Matkahuollon toimitustavoista. Muille toimitustavoille ei maksutapaa näytetä.
6.2 Bussiennakko usean paketin toimituksissa
Joskus tilaukselle pitää luoda kaksi tai useampia pakettikortteja, esimerkiksi jos viallinen tuote halutaan vaihtaa tai kaikki tuotteet eivät mahdu yhteen pakettiin. Kuitenkin bussiennakko peritään usein vain ensimmäisestä paketista, jolloin asiakas maksaa kaikki tuotteet kerralla. Silloin kauppiaan ei tarvitse maksaa useita bussiennakkopalkkioita ja tilauksen summaa ei tarvitse jakaa osiin.
Bussiennakko on toteutettu moduulissa niin, että oletuksena se tulee kaikkiin paketteihin, kunnes tilaukselle luodaan lasku (Invoice), jolloin tilaus merkitään valmiiksi. Jos siis bussiennakkoa ei haluta kuin ensimmäiseen pakettiin, on ensin luotava yksi pakettikortti, sen jälkeen tehtävä lasku Magenton ylläpidosta ja lopuksi tehtävä loput pakettikortit. Muussa tapauksessa kaikissa pakettikorteissa olisi bussiennakko ja asiakas joutuisi maksamaan monta kertaa tilauksesta.
6.3 Viitenumeron muodostaminen
Bussiennakon viite muodostetaan automaattisesti siten, että tilauksen ID:seen lisätään etuliite ”10” ja siitä lasketaan viitenumero. Esimerkiksi tilaukselle 55 viitenumero olisi 10553 (10 + 55 + tarkiste). 10 lisätään sen takia, koska viitenumeron minimi on 100, ja tilauksien 1-99 viitenumeroa ei voisi muuten laskea.
Viitenumeroa ei ole toistaiseksi mahdollista syöttää käsin.
7. Noutopisteen tiedot tilaussähköposteihin
Moduuli lisää alla listatut muuttujat saataville order_new
ja order_new_guest
sähköposteihin. Niiden avulla on mahdollista näyttää asiakkaalle valitun noutopisteen tiedot tilaussähköpostissa.
Muuttuja | Kuvaus |
matkahuoltoAgentId | Noutopisteen ID |
matkahuoltoAgentName | Noutopisteen nimi, esim. ”K-Market Sammonlahti” |
matkahuoltoAgentAddress | Noutopisteen katuosoite |
matkahuoltoAgentPostcode | Noutopisteen postinumero |
matkahuoltoAgentCity | Noutopisteen kaupunki |
Esimerkiksi seuraavalla koodilla saa noutopisteen tiedot sähköpostiin.
{{if matkahuoltoAgentName}} {{var matkahuoltoAgentName}}<br> {{var matkahuoltoAgentAddress}}<br> {{var matkahuoltoAgentPostcode}} {{var matkahuoltoAgentCity}} {{/if}}
Vianmääritys
Alle on koottu yleisimpiä virheilmoituksia ja niiden syyt.
Vika | Ratkaisu |
Pakettikorttia tehdessä tulee ”Authorization failed” virheilmoitus. | Matkahuollon käyttäjätunnus, salasana tai tila (tuotanto / testaus) ovat vääriä. Vaihda oikeat asetukset ylläpidosta. |
Pakettikorttiin tulee väärä noutopiste. | Testitunnuksilla kaikki noutopisteet eivät ole käytettävissä. Tuotantotunnuksilla kaikki noutopisteet toimivat. |