NetBaron Instructions

nShift Delivery käyttöönotto

Pyydä tarjous nShift-integraatiosta Yhteydenotto-painikeen kautta ja valitse tyypiksi Myyntiasiat.

Alla on kerrottu kuinka käyttöönotto etenee ja mitä tulee tehdä ennen nShift-rajapinnan avausta.

Unifaunin (nShift Delivery) käyttöönotto

att_3_for_1465319538.png
  1. Sopimukset rahdinkuljettajien kanssa

    • Jos lähettäjä maksaa rahtikulut, tilaaja tekee sopimuksen valittujen rahdinkuljettajien kanssa.

    • Tilausvaiheessa tarvitaan rahtisopimusnumerot.

  2. Palvelun tilaus

  3. Laskutus

    • nShift laskuttaa integraation käytöstä.

    • NetBaron laskuttaa oman hinnaston mukaisen maksun.

    • Kaikki rahtikirjanumerot (Logy) sisältyvät aina palveluun.


Track&Trace -palvelun aktivointi

Unifaun Onlinessa / Posti SmartShipissa on mahdollista ottaa käyttöön lähetyksenseurantapalvelu (Track&Trace), joka tilataan erikseen verkkokaupasta ( Posti SmartShipissa maksullinen lisäpalvelu).

Palvelu aktivoidaan nShiftissä => Ylläpito > Oma tili > Henkilötietoasetukset > nShift Track & Trace

  • Kaikki rahtitilaukset lähetetään nShift-palveluun.

  • Rahti-sovelluksen Etsi-näkymästä Lähetysnumero-kentästä löytyy linkki, jota klikkaamalla pääsee lähetyksen seurantanäkymään.

  • Aktivoinnin jälkeen seurantalinkit toimivat lähetetyille rahtitilauksille.

    • Muokkaus ja tulostaminen tapahtuu Tulostusarkiston kautta. Asennetaan myös Unifaun Online Printer -tulostusohjelma.

      • Huom. Tulostus vaatii Java-modulia. 32-bit Java on oltava asennettuna, jotta tulostukset toimivat.

      • Unifaun Onlinessa tulostaminen PDF-tiedostoon onnistuu, kun vaihtaa Windows-järjestelmän asetuksista toimistoprintterin sijaan PDF-tulostimen oletustulostimeksi, minkä jälkeen tulostetaan suoraan PDFdokumentiksi.

    • Jos käytössä on REST-rajapinta voi tulostuksen tehdä myös suoraan NetBaronissa kun rahtikirja on lähetetty nShiftiin.


API-avaimien luonti & nShift REST-rajapinnan avaaminen

Kun palvelu on aktivoitu, voi siirtyä API-avainten luontiin.

Avaimet luodaan Ylläpito > API-avaimet -osiossa. Laitetaan seuraavat valinnat aktiiviseksi: Unifaun OnlineConnect, Web Service-kutsu (REST) ja XML-Postitus.

Toimita API-avaimen “tunnus” ja “salainen tunnus” NetBaron tuelle. Tunnuksia käytetään NetBaron organisaation yhdistämiseen nShift REST-rajapintaan. Rajapintojen avauksesta käynnistyy myös laskutus. Avaus- ja kuukausimaksut veloitetaan voimassa olevan hinnaston mukaisesti.

  • Uutta on API-avaimien luonti ja käyttö perinteisen useraccount- ja password-tunnusten rinnalla.

  • API-avaimilla ei ole sitä turvallisuusriskiä, että tunnukset liikkuvat suoraan rajapinnassa.

  • Kaikki rahtitilaukset lähetetään nShift-palveluun.

  • Rahtikirjojen muokkaus ja tulostaminen tapahtuu nShiftin Tulostusarkiston kautta. Tulostus vaatii Java-modulia.

  • Developer-Id liittää API-avaimen ja Unifaun-tilin toisiinsa (Developer-Id on yleensä nShift-tilin käyttäjätunnus).

Vinkki: Yleisimmät ongelmat käytössä liittyvät tulostimen asetuksiin, jotta rahtikirjat jne. tulostuvat oikein.

image-20260423-123706.png

Jos nShift REST-rajapintaa ei käytetä

Syötä Unifaunista saadut käyttäjätunnus- ja salasanatiedot toimipaikan alle Rahtitiedot-välilehdelle rahtisopimustietoihin (Asetukset >Toimipaikat > Rahtitiedot-välilehti).

  • API-tunnus (16 merkkiä) syötetään API-KEY:-etuliitteen kanssa toimipaikan rahtiasetuksiin Käyttäjätunnus-kenttään (kopioidaan Unifaunin Tunnus-kentästä tieto ja lisätään etuliitteen kanssa sovellusperheeseen).

  • Salainen tunnus (24 merkkiä) syötetään sovellusperheessä salasanaksi.

  • Valitsemalla oletusrahdinkuljettajaksi Unifaun, avataan oletuksena aina Unifaun-palvelu eri sovelluksista Rahdille mentäessä tai luotaessa uusi rahtitilaus.

  • Valitsemalla Rahdin asetuksista Unifaun (Asetukset > Sovellukset > Rahti > Rahdinkuljettajat-välilehti > Unifaun-välilehti), voidaan valita Oletustoimittaja ja Vastaanottaja sekä Rahdinkuljettaja ja sen Palvelut, joita halutaan oletuksena käyttää.

    • Vaikka tiedot voidaan esiasettaa täällä jo valmiiksi, voidaan niitä muuttaa myöhemmin joko Rahti-sovelluksessa tai Unifaun Onlinessa.


Sopimustunnukset

Kuljetusliikekohtaiset sopimustunnukset tulee syöttää joko NetBaroniin, toimipaikan taakse “Rahtitiedot” välilehdelle (1) tai nShift-palveluun (2).

Kuljetusliikekohtaiset sopimustunnukset voi syöttää NetBaronissa sekä lähettäjän (toimipaikka) että vastaanottajan (asiakasrekisteri) taakse.

  • Tämä voi olla hankalaa, jos on useita sopimuksia eri vastaanottajille.

  • Rahdin sovellusasetuksiin on käyttöä varten luotava samanniminen Rahdinkuljettaja kuin nShift palveluntarjoaja -listassa.

  • Toimipaikan rahtiasetuksiin on kyseiselle kuljetusliikkeelle luotava nShift käyttöä varten asiakasnumerot.

  • Vastaanottajan asetuksiin asiakasrekisterissä on syötettävä nShift-käyttöä varten kyseiselle kuljetusliikkeelle sopimusnumerot.

Kuljetusliikekohtaiset sopimustunnukset voi syöttää myös suoraan nShift-palveluun (Ylläpito > Lähettäjä ja Vastaanottaja).

  • nShiftiin saadaan tallennettua kuljetusliikekohtaisesti kaikki sopimustunnukset lähettäjien ja vastaanottajien taakse.

  • Rajapinnassa käytetään QuickID:tä, jolla viitataan tallennettuihin vastaanottaja- ja lähettäjätietoihin.

  • Sovellusperheestä siirretyt asiakkaat ja lähettäjä voidaan tallentaa rekistereihin lennosta, ja lisätä niihin sopimustietoja tarvittaessa.


Unifaun-rajapinnan käyttöönotto Posti SmartShip -palvelun kautta

  • Mikäli käytetään rahdinkuljettajana ainoastaan Postia, voi Unifaun-rajapinnan avata Posti SmartShip -palvelun integraatiorajapintaan (paketti- ja rahtikuljetukset).

  • Käyttöönotto etenee kuvan mukaisissa vaiheissa.

att_4_for_1465319538.png

Tilaaja tekee ensin palvelusopimuksen Postin kanssa kuljetuspalveluiden ja sähköisen ERP Connect -rajapinnan käyttöönottamiseksi.

  • ERP Connect on tilausvälitystoiminto, jonka avulla voi tulostaa rahtikirjoja ja osoitelappuja käyttäen ERP:ssä olevia tilaustietoja. Huom. Linkin käyttöönotto edellyttää sopimuksen tekemistä Postin kanssa (kts. jäljempänä Track&Trace).

  • Maksuttomat asiointitunnukset tilataan yrityksen pääkäyttäjälle Postin asiointiportaalissa https://www.unifaunonline.se/ext.posti.FI.opa#.

    • Tilaaja saa tilin aktivoinnin yhteydessä tilin tunnuksen, käyttäjätunnuksen ja salasanan. Tunnuksilla kirjaudutaan Posti SmartShip -palveluun, jonka verkkokaupasta tilataan ERPConnect (XML Posting) -lisenssi.

      • APIConnect on REST-rajapinta, joka on tarkoitettu verkkokauppojen integraatioihin.

    • Kaikki rahtikirjanumerot (Logy) yms. sisältyy aina Unifaun-palveluun.

    • Posti SmartShip -palveluun siirretään lähettäjä- ja vastaanottajatiedot.

      att_11_for_1465319538.png
      att_7_for_1465319538.png
      att_10_for_1465319538.png
      att_5_for_1465319538.png


    • Kun palvelu on aktivoitu, voidaan aktivoida lähetyksenseuranta Track&Trace (tilataan erikseen verkkokaupasta, Posti SmartShipissa maksullinen lisäpalvelu): Ylläpito > Oma tili > Unifaun Track&Trace.

      • Aktivoinnin jälkeen seurantalinkit toimivat lähetetyille rahtitilauksille.

      • Rahti-sovelluksen Etsi-näkymästä Lähetysnumero-kentästä löytyy linkki, jota klikkaamalla pääsee lähetyksen seurantanäkymään.

      • Kaikki rahtitilaukset lähetetään Posti SmartShip -palveluun.

      • SmartShipin tuotevertailutaulukko Prinetiin nähden löytyy osoitteesta https://www.posti.fi/liitteet-yrityksille/muut/smartship-tuotevertailutaulukko-fi.pdf

    • Muokkaus ja tulostaminen tapahtuu Tulostusarkiston kautta. Posti SmartShip -palvelussa on Unifaun Online Printer -tulostusohjelma käytössä.

      • Posti SmartShip -palvelun Tulostusarkistossa on Tulosta-valinta ja ns. suoratulostuspainike Tulosta PDF, jolla saa tulostettua suoraan selaimeen PDF-muodossa.

    • Kun palvelu on aktivoitu, voi siirtyä API-avainten luontiin.

      • Avaimet luodaan Ylläpito > API-avaimet -osiossa. Laitetaan seuraavat valinnat aktiiviseksi: Unifaun OnlineConnect ja XML-Postitus.

      • Developer-Id liittää API-avaimen ja Unifaun-tilin toisiinsa (Developer-Id on yleensä tilin tunnus).

    • API-avaimet syötetään sovellusperheessä toimipaikan rahtitietojen taakse (Asetukset > Ylläpito > Toimipaikat > Rahtitiedot-välilehti), kts. jäljempänä Unifaun-rajapinnan avausprosessin kohta 5.

      att_9_for_1465319538.png

Rajapintojen avauksesta käynnistyy myös laskutus. Avaus- ja kuukausimaksut veloitetaan voimassa olevan hinnaston mukaisesti.

Toimittaja ilmoittaa Tilaajalle, kun organisaation taakse on annettu tarvittavat oikeudet. Tilaaja syöttää Posti SmartShip -palvelusta saadut käyttäjätunnus- ja salasanatiedot toimipaikan alle Rahtitiedot-välilehdelle rahtisopimustietoihin (Asetukset > Toimipaikat > Rahtitiedot-välilehti).

  • API-tunnus (16 merkkiä) syötetään API-KEY:-etuliitteen kanssa toimipaikan rahtiasetuksiin Käyttäjätunnus-kenttään (kopioidaan Posti SmartShip-palvelun Tunnus-kentästä tieto ja lisätään etuliitteen kanssa sovellusperheeseen).

  • Salainen tunnus (24 merkkiä) syötetään sovellusperheessä salasanaksi.

  • Valitsemalla oletusrahdinkuljettajaksi Unifaun, avataan oletuksena aina Unifaun-palvelu eri sovelluksista Rahdille mentäessä tai luotaessa uusi rahtitilaus.

  • Valitsemalla Rahdin asetuksista Unifaun (Asetukset > Sovellukset > Rahti > Rahdinkuljettajat-välilehti > Unifaun-välilehti), voidaan valita Oletustoimittaja ja Vastaanottaja sekä Rahdinkuljettaja ja sen Palvelut, joita halutaan oletuksena käyttää.