Posti SmartShip -liitäntä

Posti SmartShip -liitäntä yhdistää verkkokaupan Postin paketti- ja rahtipalveluihin. Liitännän ansiosta verkkokauppiaan ei tarvitse kirjautua Posti SmartShip -verkkopalveluun lähetysasiakirjoja tulostettaessa. Liitäntä sisältää poikkeuksellisen paljon ominaisuuksia.

• Posti-, noutopiste- ja pakettiautomaattihaku verkkokaupan kassalla.
  
• Posti-, noutopiste- ja pakettiautomaattihaku verkkokaupan hallintaliittymässä.
  
• Lähettäminen kotimaahan ja ulkomaille.
• Kaikki REST-rajapinnan tukemat palvelut.
  - Esim. Express-paketti, Postipaketti, Kotipaketti, Pikkupaketti, Express-rahti, Rahti, Kotijakelu, Priority Parcel, EMS, SmartPOST Viro jne.
• Kaikki REST-rajapinnan tukemat lisäpalvelut.
  - Esim. postiennakko, särkyvä, kirjaaminen.
• Kaikki REST-rajapinnan tukemat osapuolet.
  - Lähettäjä, vastaanottaja, luovutuspaikka
• Noudon tilaaminen lähetykselle.
• Laiteasennukset.
  - Esim. pesukoneelle ja pakastimelle
• Kollitiedot (1-10 kollia).
  
• Vaaralliset aineet (1-10 kollia).
  
• Tullaustiedot.
  - CN22, CN23, pro forma
  
• Lähetysasiakirjojen luominen ja tulostaminen.
  - Kuljetusasiakirja
  - Rahtikirja
  - Vaaralliset aineet
  - Tullausasiakirjat
• Tukee useita dokumentteja ja sivuja.
  - Esim. rahtikirja 4 sivua ja tullausasiakirja 2 sivua.
• Lähetysasiakirjojen tallentaminen tilauskorttiin.
  - Saatavilla aina esim. tulostusongelmien varalle
  
• Tarra-/ paperikoon valitseminen eri dokumenteille.
  - Esim. PDF-kuljetusasiakirja A5-paperille/tarralle ja tullausasiakirja A4-paperille.

Toimintaperiaate

Posti SmartShip -liitäntä sisältää itse asiassa kolme hieman erilaista liitäntää.

• Noutopistehaku ja SmartShip-liitäntä.
• Pakettiautomaattihaku ja SmartShip-liitäntä.
• Pelkkä SmartShip-liitäntä.

Verkkokauppias voi päättää toimitustapojen määrän ja niiden nimet itse. Toisin sanoen toimitustapojen niminä ei ole pakko käyttää Postin vakiomallisia nimiä. SmartShip-liitäntä voidaan kytkeä useaan eri toimitustapaan. Liitännän ominaisuuksia voidaan optimoida toimitustapakortin tyyppi ja esivalintakoodi -kohtien kautta.

Sanotaan vaikka, että verkkokauppias on lisännyt verkkokaupan hallintaliittymän toimitustapakorttiin Nouto omasta postista -nimisen toimitustavan ja valinnut liitäntä-kohdassa olevasta valikosta SmartShip-liitännän. Sen jälkeen verkkokaupan asiakas lähettää tilauksen, jonka jälkeen verkkokauppias klikkaa tilauskortissa olevaa sinistä kuvaketta, tarkistaa esitäytetyt tiedot, täydentää tietoja ja tulostaa lähetysasiakirjat. Tämä on helppoa ja yksinkertaista.

Toisin sanoen verkkokauppiaan ei tarvitse määrittää verkkokaupan hallintaliittymän toimitustapakorttiin, mihin Postin palveluun toimitustapa on kytketty ja mitä Postin lisäpalveluja siihen on valittu.

Jatketaan esimerkeillä. Sanotaan vaikka, että verkkokauppias on lisännyt verkkokaupan hallintaliittymän toimitustapakorttiin Nouto pakettiautomaatista -nimisen toimitustavan ja valinnut liitäntä-kohdassa olevasta valikosta pakettiautomaattihaun SmartShip-liitännällä. Jos verkkokaupan asiakas valitsee toimitustavaksi noudon pakettiautomaatista, hän etsii haluamansa automaatin verkkokaupan ostoskorisivulla. Sen jälkeen hän lähettää tilauksen, jonka jälkeen verkkokauppias klikkaa tilauskortissa olevaa sinistä kuvaketta, tarkistaa esitäytetyt tiedot, täydentää tietoja ja tulostaa lähetysasiakirjat. Tämä on jälleen helppoa ja yksinkertaista.

Vaihto mahdollista

Sanotaan vaikka, että verkkokaupan asiakas on valinnut pakettiautomaatin ja lähettänyt tilauksen, mutta haluaakin noutaa tilauksen lähikaupan palvelupisteestä. Jos vaihto sopii verkkokauppiaalle, hän voi vaihtaa toimitustavan verkkokaupan hallintaliittymän tilauskortin Toimitustapa-kohdassa olevasta valikosta ja päivittää tilauskortin. Tämän jälkeen hän voi etsiä lähikaupan tiedot toimitustapakortissa olevalla hakukoneella ja päivittää tilauskortin.

Toimitustapaa ei aina tarvitse vaihtaa. Sanotaan vaikka, että verkkokaupan asiakas luulee saavansa postipaketin, mutta verkkokauppias haluaa jostain syystä lähettää hänelle pikkupaketin. Tämä ei ole ongelma. Verkkokauppias valitsee juuri ennen PDF-osoitekortin tulostamista Postin palveluksi pikkupaketin ja asia on sillä selvä.

Tallennetaan muistiin

Lähetysasiakirjat tallentuvat tilauskorttiin ja ovat aina saatavilla esimerkiksi tulostusongelmien varalle. Verkkokauppiaan ei tarvitse kirjautua SmartShippiin.

Käyttöönotto

Tilaa Postin asiointitunnukset

• Tilaa yrityksellesi Postin asiointitunnukset ↗, ellei niitä ole vielä käytössä.
  - Tämä tarkoittaa sitä, että yrityksestäsi tulee Postin sopimusasiakas.

Tarkista tulostin

• Jos haluat tulostaa tarrallisia PDF-kuljetusasiakirjoja, niin käytössäsi on oltava lasertulostin, jolla voidaan tulostaa A5-tarra-arkille.
• Tilaa Postista A5-lasertarraosoitekortteja ↗.
  - Valitse "kotimaan pakettipalvelujen osoitekortit ja tarralipukkeet".
  - Valitse "kaksiosainen suojapaperi, yleisin Posti Smartshippiin tai Prinettiin sopiva".
• Muiden kuljetusasiakirjojen tulostamiseen riittää tavallinen lasertulostin.

Aktivoi SmartShip-integraatio

• Kirjaudu Posti SmartShip ↗ -verkkopalveluun.
  - Klikkaa Verkkokauppa.
  
  - Klikkaa Näytä-painiketta Päivitä yrityksesi uudelle tasolle -kohdassa.
  
  - Klikkaa Näytä-painiketta nShift ERPConnect (APIConnect, REST API, JSON) -kohdassa.
  - Klikkaa Tilaussivulle-painiketta.
  - Täytä lomake.
  - Valitse järjestelmä-kohdasta Clover Shop.
  - Klikkaa Tilaa-painiketta.
• Odota, kunnes saat tilausvahvistuksen sähköpostitse.
• Kirjaudu Posti SmartShip ↗ -verkkopalveluun.
  - Klikkaa Ylläpito.
  
  - Klikkaa API-avaimet.
  
  - Klikkaa Uusi API-avain.
  
  - Valitse Tila-kohdasta Käytössä.
  - Rastita Tyyppi-kohdasta Web Service -kutsu (REST).
  - Kirjoita Developer-Id-kohtaan meiltä saamasi Developer-Id-numero. Saat sen meiltä sähköpostitse kysymällä.
  - Jätä muut kohdat tyhjäksi.
  - Klikkaa Valmis-painiketta.

Nyt sinulla on Developer-Id-numero, API-avaimen tunnus ja API-avaimen salainen tunnus.

Lisää toimitustavat

• Kirjaudu verkkokaupan hallintaliittymään (demo).
• Klikkaa ylhäältä asetukset / toimitustavat.
• Toista seuraavia toimenpiteitä, kunnes olet lisännyt kaikki haluamasi Postia koskevat toimitustavat:
  - Klikkaa Lisää uusi -painiketta.
  - Valitse Liitäntä-kohdasta Posti SmartShip -liitäntä (jokin neljästä).
  - Syötä toimitustavan nimeksi mitä tahansa.
  - Syötä Postilta saamasi logistiikan tai rahdin sopimusnumero Sopimustunnus -kohtaan riippuen siitä, käyttääkö juuri tämä toimitustapa logistiikan vai rahdin palveluita.
  - Syötä Postilta saamasi API-avaimen tunnus Kauppiastunnus-kohtaan.
  - Syötä Postilta saamasi API-avaimen salainen tunnus Salainen avain -kohtaan.
  - Lataa Logo-kohtaan toimitustavan logo ↗ (vapaaehtoinen).
  - Klikkaa Tallenna-painiketta.
  

Tulosta lähetysasiakirjoja

• Kirjaudu verkkokaupan hallintaliittymään (demo).
• Klikkaa ylhäältä tilaukset.
• Valitse luettelosta jokin tilaus.
• Klikkaa Toimitustapa-kohdassa näkyvää sinistä painiketta.
• Tarkista ja täydennä lomake.
• Klikkaa Luo lähetys -painiketta.

Ongelmatilanteet

Jos nShift vastaa lähetysasiakirjaa tulostettaessa "unauthorized", olet todennäköisesti tilannut vahingossa jonkin muun lisäominaisuuden kuin "nShift ERPConnect (APIConnect, REST API, JSON)".

Jos näet lähetysasiakirjaa tulostettaessa ilmoituksen "nShift ei vastannut", olet todennäköisesti kirjoittanut API-avaimen tunnuksen tai API-avaimen salainen tunnuksen väärin asetukset / toimitustavat -kohdassa olevaan toimitustapakorttiin.

Hyvä tietää

Posti SmartShip -liitäntä ja nShift ERPConnect (APIConnect, REST API, JSON) ovat edellytys sille, että verkkokauppias voi tulostaa lähetysasiakirjoja verkkokaupan hallintaliittymästä omilla API-tunnuksillaan. Vaihtoehtoisesti verkkokauppias voi tulostaa lähetysasiakirjoja suoraan SmartShip-verkkopalvelusta. Posti ei peri SmartShipin käytöstä maksua.

Tämä liitäntä on ohjelmoitu vuonna 2017 ja sitä on ylläpidetty sen jälkeen. Liitäntään on lisätty muun muassa tuki taloyhtiöiden pakettilokerikoille (2017), hakutekniikkaa on parennettu (2018) ja noutopisterekisterihaku on korvattu paikkapalveluhaulla (2019).