Magento 2 Shipit – Ohje

1. Yleistä lisäosasta

Magento 2 Shipit lisää tuen Shipitin tarjoamille toimitustavoille Magento 2 -verkkokauppaan. Moduulin avulla onnistuu myös pakettikorttien tulostus suoraan hallintapaneelista, mikä säästää työaikaa ja vähentää virheitä.

Ennen moduulin käyttöönottoa on rekisteröidyttävä Shipitille. Tunnukset voi ottaa käyttöön sen jälkeen, kun Shipit on hyväksynyt laskutusasiakkaaksi. Rekisteröidy Shipitiin »

2. Asentaminen

Moduuli asennetaan kuten muutkin Magento 2 -moduulit. Asennukseen käytetään Composeria, jonka kautta moduuli on helppo asentaa ja päivittää.

Markupin Composer-pakettivarasto (repository) on osoitteessa https://repo.markup.fi. Pakettivarasto on julkinen, mutta moduulien lataus vaatii lisenssiavaimen, joka löytyy Markupin tilausvahvistuksesta.

1) Mene Magenton juurikansioon komentorivillä

2) Lisää Markupin Composer-pakettivarasto Magenton composer.json tiedostoon kohtaan repositories:

{
    "type": "composer",
    "url": "https://repo.markup.fi"
}

Katso tästä kuva, miltä composer.json tiedoston pitäisi näyttää lisäyksen jälkeen. Huomaa pilkku Magenton oman repositoryn jälkeen, mutta ei Markupin repositoryn jälkeen (jos viimeinen repository). Tiedoston on oltava oikein muotoiltua jsonia.

3) Lataa Markup_Shipping, Markup_Shipit ja StringCalc moduulit pakettivarastosta. Markup_Shipping sisältää Markupin moduuleille jaettua yhteistä toiminnallisuutta ja se on pakollinen. StringCalc moduulia käytetään toimituskulujen laskentakaavoihin.

composer require markup/module-shipping
composer require markup/module-shipit
composer require chriskonnertz/string-calc

Moduuleja ladattaessa pyydetään kirjautumaan sisään Markupin pakettivarastoon. Käyttäjätunnus on tilausvahvistuksen sähköpostiosoite ja salasana tilausvahvistuksessa toimitettu lisenssiavain. Mikäli et ole saanut lisenssiavainta, voit tilata sen täältä.

4) Kytke moduulit päälle ja aja Magenton asennuskomennot.

php bin/magento module:enable Markup_Shipping
php bin/magento module:enable --clear-static-content Markup_Shipit
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

5) Moduulit 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 > Shipit.

3.1 Yleiset asetukset

Alla olevassa taulukossa on kuvattu yleiset asetukset.

License KeyModuulin lisenssiavain, löytyy Markupin tilausvahvistuksesta
Enabled for CheckoutNäytetäänkö toimitustapoja kassalla.
API KeyAPI-avain. Saadaan Shipitiltä.
API SecretAPI-varmenne. Saadaan Shipitiltä.
ModeTila, tuotanto tai testaus.
Package ContentsPakettien sisältö, esim. ”Consumer electronics”
Tariff CodeTariffikoodi, pakollinen ainoastaan silloin, jos toimitetaan EU:n ulkopuolelle.
Pricing MethodHinnoittelumenetelmä, kts. alta kuvaukset
Displayed Error MessageVirheilmoitus, joka näytetään, jos toimitustapaa ei voida käyttää.
Show Method if Not ApplicableNäytetäänkö toimitustapa, jos sitä ei voida valita.
Sort OrderJärjestys kassalla.

3.1.1 Testitunnukset

Testaukseen voi käyttää seuraavia Markupin testitunnuksia.

Tila: Testaus
API-avain: CyL4/bhFJTWXJkti
API-varmenne: ozW1uIVxD+!N!+.)NWfQ?i<$8>f6h5+Z

3.1.2 Hinnoittelumenetelmät / Pricing Method

Moduulissa on mahdollista määritellä toimitustapojen hinnoittelu kahdella eri tavalla.

Kiinteä / matemaattinen kaava

Toimitustapojen hinta on kiinteä tai määräytyy laskukaavalla painoon perustuen. Hintakenttään syötetään kiinteä hinta tai laskukaava. Painolle käytetään [weight] muuttujaa. Esim. 5 € + 0,50 € / kg hinnalle syötetään seuraava hintakenttään: 5+0,5*[weight]

Painoluokat

Hinta nousee painoluokittain, esim. 0 – 2 kg 5 € ja 2 – 5 kg 6 €. Taulukkoon syötetään maksimipaino ja sen hinta.

3.2 Toimitustapojen asetukset

Jokaiselle toimitustavalle on lisäksi erilliset asetukset, jotka on kuvattu alla olevassa taulukossa.

[Toimitustapa] Enabled for CheckoutNäytetäänkö toimitustapa kassalla.
[Toimitustapa] TitleToimitustavan nimi kassalla.
[Toimitustapa] PricingToimitustavan hinnoittelu, kts. kohta 3.1.1 hinnoittelumenetelmät.
[Toimitustapa] Free Shipping Amount ThresholdIlmaisen toimituksen raja.

4. Pakettikorttien tekeminen

Moduuli mahdollistaa pakettikorttien luonnin kahdella eri tyylillä:

  1. Quick Ship -pikatoiminto, jolla pakettikortit saadaan parhaimmillaan kahdella klikkauksella
  2. Magenton oma pakettikorttien luonti

4.1 Quick Ship -pikatoiminto

Pakettikortti luodaan Quick Ship -pikatoiminnolla avaamalla haluttu tilaus ylläpidosta ja klikkaamalla Quick Ship:

Quick Ship -ikkunaan syötetään tarvittavat tiedot ja klikataan Create shipment, jonka jälkeen lähetys luodaan kuljetusliikkeelle ja pakettikortti ladataan.

4.2 Magenton oma käyttöliittymä

Mikäli pakettikortti halutaan luoda Magenton omalla käyttöliittymällä, onnistuu se seuraavasti.

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 ja mitat kohtiin Length, Width ja Height. Oletuksena haetaan tuotteiden yhteenlaskettu paino, mutta huomioon tulee ottaa myös pakkausmateriaalien paino. HUOM! Painoyksikkö on oletuksena useissa Magento-asennuksissa ”lb” eikä ”kg”. Yksikkö tulee vaihtaa kilogrammoiksi tai muuten paunat muutetaan automaattisesti kilogrammoiksi.

Osalle toimitustavoista (mm. Postipaketti) moduuli antaa automaattisesti dummy-mitat, koska niille ei tarvitse syöttää oikeita mittoja, kunhan maksimimitat eivät ylity. Varmista maksimimitat Shipitiltä.

6. Klikkaa Save. Lähetys luodaan Shipitille 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.

5. Tullaustiedot EU:n ulkopuolelle

EU:n ulkopuolelle lähettäessä on toimitettava lähetyksen tullaustiedot. Shipit-moduuli toimittaa tiedot automaattisesti, kunhan ne on syötetty tuotteille.

Tuotteille on annettava englanninkielinen kuvaus tullille, tariffikoodi ja alkuperämaa. Tiedot syötetään tuotteen muokkaussivulta kohdasta Customs:

Päivitys 2.2.0 versioon

Versiosta 2.2.0 eteenpäin Shipit-moduuli hyödyntää Markup Shipping -moduulia. Se sisältää kaikille Markupin toimitusmoduuleille yhteistä toiminnallisuutta, kuten esimerkiksi tuotteiden tullaustiedot.

Markup Shipping -moduuli on asennettava ennen Shipit-moduulin päivittämistä. Asennus onnistuu seuraavasti:

1) Mene Magenton juurikansioon komentorivillä

2) Lisää Markupin Composer-pakettivarasto Magenton composer.json tiedostoon kohtaan repositories:

{
    "type": "composer",
    "url": "https://repo.markup.fi"
}

Katso tästä kuva, miltä composer.json tiedoston pitäisi näyttää lisäyksen jälkeen. Huomaa pilkku Magenton oman repositoryn jälkeen, mutta ei Markupin repositoryn jälkeen (jos viimeinen repository). Tiedoston on oltava oikein muotoiltua jsonia.

3) Lataa Markup_Shipping moduuli pakettivarastosta seuraavalla komennolla:

composer require markup/module-shipping

Moduuleja ladattaessa pyydetään kirjautumaan sisään Markupin pakettivarastoon. Käyttäjätunnus on tilausvahvistuksen sähköpostiosoite ja salasana tilausvahvistuksessa toimitettu lisenssiavain. Jos et ole saanut lisenssiavainta, voit tilata sen täältä.

4) Kytke moduuli päälle ja aja Magenton asennuskomennot.

php bin/magento module:enable Markup_Shipping
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

5) Moduuli on asennettu onnistuneesti, jos edelliset käskyt eivät aiheuttaneet virheilmoituksia. Shipit-moduulin voi päivittää seuraavaksi 2.2.0 versioon.