Easoftin nShift-integraatio hyödyntää nShift Delivery API:a kuljetustietojen välittämiseen Easoftista nShiftiin. Integraatio mahdollistaa kuljetusvarausten ja kuljetusasiakirjojen muodostamisen Easoftista sekä tehostaa logistiikkaprosessia.
Edellytykset integraation käyttöönottoon
- Integraation käyttö edellyttä sopimusta nShiftin kanssa.
- Rajapinnan avaamiseen tarvittavat API-tunnukset saa pyytämällä nShiftin yhteyshenkilöltä tai asiakaspalvelusta.
- Palveluntarjoajan sopimusnumero tarvitaan rajapinnan määrittelyä varten.
Rajapinnan määrittely
1. Tarvittavat käyttöoikeudet
Rajapinnan käyttöönotto edellyttää Unifaun-käyttöoikeuksien lisäämistä Easoftiin. Voit pyytää nämä Easoftin tuesta. Muutama tekninen huomio käyttöoikeuksiin:
- UnifaunCarriers käyttöoikeuksista tarvitaan vain fetch ja fetchServices
UnifaunVisibleParameter käyttöoikeudet tarvitaan vain, jos halutaan säätää rahtikirjan sisältöä ja kenttien vakioarvoja - Lähetyksen tekijälle riittää pääsääntöisesti seuraavat käyttöoikeudet
- UnifaunCarriers/fetch
- UnifaunCarriers/fetchServices
- UnifaunDeliveries/create
- UnifaunServiceProviders/fetch
- UnifaunServices/index
- UnifaunServices/edit
2. Rajapinnan lisääminen
Rajapinta lisätään Easoftiin Asetukset -> Rajapinnat -> Lisää rajapinta -painikkeella.
- Rajapinta-asetuksissa osoite on aina https://api.unifaun.com/rs-extapi/v1/
- Tunnus ja salainen tunnus saadaan nShiftiltä
3. Palveluntarjoajien lisääminen
Halutut palveluntarjoajat lisätään hammasratas -> Unifaun palveluntarjoajat -> lisää -painikkeella.
- Jos samalta liikennöitsijältä käytetään eri palveluita, nämä konfiguroidaan omiksi vaihtoehdoiksi palveluntarjoajat-listalle.
- Oletus kollityyppi voidaan jättää tyhjiksi. "Asiakasnumeron julkaisija"-kenttä tulee täyttää PostNordia käytettäessä.
- HUOM! Palveluntarjoaja pitää olla Easoftin lisäksi lisättynä myös asiakkaan nShift-ympäristöön.
Lähetyksen tilaaminen
- Toimitettavat rivit tulee ensin merkitä tilauksen katselunäkymässä toimitetuksi (toiminnot -> kirjaa toimitukset).
- Lähetys luodaan Toimitukset-välilehdeltä toimitusrivin "Uusi lähetys"-linkkiä klikkaamalla.
- Valitaan avautuvasta ikkunasta liikennöitsijä ja palvelu.
- Täydennetään vastaanottajan ja kollin tiedot, tarvittaessa lisätään lisäpalvelut ja kuljetusohjeet rahtikirjalle.
- Tallenna-painikkeella lähetys tallentuu luonnokseksi ja näkymäksi vaihtuu "Lähetysten seuranta"-listaus (HUOM! tiedot eivät vielä tässä vaiheessa siirry rajapintaan, lähetyksen tietoja voi vielä muokata).
- Klikkaamalla rivin lähetyssymbolia lähetyksen tiedot siirtyvät kuljetusliikkeelle.
- Lähetyksen jälkeen rivin status vaihtuu tilaan "lähetetty" ja tarra/kuormakirja muodostuu ladattavaksi.
Muuta huomioitavaa
- Palveluntarjoajaksi voidaan määritellä myös liikennöitsijä, joka ei ola nShiftin listalla. Tätä voidaan hyödyntää esimerkiksi asiakkaan omien kuljetuksien kuormakirjojen muodostamista varten.
- Noutolokero ja palvelupistetoimituksissa Integraatio ei mahdollista noutopisteen valintaa. Noutopiste määräytyy toimitusosoitteen mukaan automaattisesti.
- nShift integraatioon on mahdollista määritellä kymmeniä eri liikennöitsijöiden ja palveluiden yhdistelmiä. Näistä on kuitenkin määritelty ja testattu vain yleisimmät Postilta, Kaukokiidolta, Schenkeriltä ja Matkahuollolta. Jos haluamaasi yhdistelmää ei löydy asetuksista, ota yhteys Easoftin tukeen (tuki@easoft.fi).