nShiftin Unifaun REST, yhteys ilman tiedostoja

Suurin osa nShiftin Unifauniin liittyvistä ohjeista pätee REST-yhteydessäkin. Alla kuvaus muutoksista ja ohjeet miten voit siirtyä tiedostopohjaisesta (vanhasta) tavasta uuteen.

Jos Toimintokeskuksesta löytyy asetus: UNIFAUN_REST_USER, niin käytössäsi olevalla Lemonsoft-versiolla pystyt ottamaan käyttöön nShiftin Unifaun REST yhteyden.

nShiftin Unifaun REST yhteys verrattuna XML-tiedostopohjaiseen yhteyteen:

Lemonsoft Onlinen myötä XML-tiedostopohjaista Unifaun OnlineConnectia ei voida enää käyttää, joten sen seuraajaksi on tehty nShiftin Unifaun REST apiin pohjautuva yhteys. Uudessa yhteydessä ei käytetä enää lainkaan tiedostoja, vaan tiedot välitetään Lemonsoftista suoraan nShiftin Webserviceen. Tämä tarkoittaa sitä, että erillistä ohjelmaa ei tarvita yhteyteen.

•      Tiedostopohjainen nShiftin Unifaun yhteys ei poistu, eli sen käyttöä voi jatkaa siihen asti kunnes uuden tavan haluaa ottaa käyttöön (Onlinen käyttöönotossa viimeistään pakko ottaa käyttöön)

•      Vanhaa ja uutta tapaa et voi käyttää rinnakkain Lemonsofin työasemaversiossa ja selainkäyttöisessä LemonOnlinessa. Työasema- ja LemonOnline -versiot käyttävät Toimintokeskuksen UNIFAUN_REST_USER-asetuksen määräämää tapaa.

•      Kun siirryt nShiftin Unifaun online, eli REST-käyttötapaan, samalla poistuu Unifaun OnlineConnect hallinta ohjelmasa ollut toimintamalli tulostuksessa, jossa liittymä tulostaa automaattisesti tulosteet. Sen sijaan toimituksen päätteeksi näytetään ruutu, jossa näytetään tulostettava pdf ja sen voi tulostaa samalla. Tämäkin on toteutettu Lemonsoftiin ja tulostukseen ei tarvita enää erillistä ohjelmaa.

•      Alla olevassa kuvassa Lemonsoftin tulostusnäyttö. Eri tulosteet (esim. rahtikirja ja lavalappu) tulevat eri välilehdille.

Kuva: Tuloste#1-välilehdellä on rahtikirja, Tuloste#2-välilehdellä on lavalappu.

Käyttöönotto (nShiftin REST -pohjautuva yhteys):

1.   Varmista että sopimuksesi nShiftin kanssa kattaa REST Apin käytön

2.   nShiftin sivuilla luodaan Apiin tarvittavat avaimet. Kirjaudu sisään nShiftin web sivuille (http://www.unifaunonline.com/), valitse ylläpito -> API-avaimet -> Uusi API-avain -> valitse ”Web Service-kutsu (REST)” ja paina valmis. Näet tämän jälkeen tunnuksen ja salaisen tunnuksen. Lisää API-avaimeesi DeveloperID-kentään nShift asiakasnumerosi.

3.   Aseta Lemonsoftissa toimintokeskukseen asetukset UNIFAUN_REST_USER (nShiftin tunnus) ja UNIFAUN_REST_SKEY (nShiftin salainen tunnus) joiden arvot sait edellisessä kohdassa, kun loit API-avaimet.

4.   Kun UNIFAUN_REST_USER on asetettu, käyttää Lemonsoft nShiftin REST rajapintaa aina. Jos et halua käyttää nShiftin REST rajapintaa, tulee UNIFAUN_REST_USER asetus olla tyhjä.

5.   Tulostuvan PDF:n kokoon voi vaikuttaa UNIFAUN_REST_PRINTER -asetuksella. Lisää asetukseen tulostuvien paperien/tarrojen koot, joita järjestelmästä voit/haluat tulostaa. Mahdolliset arvot ovat tällä hetkellä:

§ laser-a5 (Single A5 label on A5 paper)

§ laser-2a5 (Two A5 labels on A4 paper)

§ laser-ste (Two STE labels (107x251 mm) on A4 paper)

§ laser-a4 (Normal A4 used for waybills, customs declaration documents etc.)

§ thermo-se (107 x 251 mm thermo STE label)

§ thermo-190 (107 x 190 mm thermo label)

§ thermo-brev3 (107 x 72 mm thermo label)

Ohjeen kirjoitushetkellä voit lisätä nShiftiin maksimissaan neljä eri tulostus kokovaihtoehtoa. Lisää ne Toimintokeskus UNIFAUN_REST_PRINTER asetukseen peräkkäin puolipiste (;) välimerkillä eroteltuna.
Esim. laser-a4;laser-a5;laser-se;thermo-190. nShiftin rajapinta päättelee näiden tulostuskokovaihtoehtojen mukaan, minkä kokoisen PDF:n se generoi. Voit antaa lisäksi myös kohdistustietoa (mikäli tuloste ei osu tarralle). Lisää kohdistustieto pilkuilla eroteltuna tuloste,kohdistus pystysuunnassa,kohdistus sivusuunnassa.
Eli esimerkiksi laser-a4,1,0;laser-a5,0,0;laser-se,2,0;thermo-190,5,2

Huomaa! nShift hakee järjestyksen mukaisesti ensimmäisen toimitustapaan täsmäävän tulosteen ja lähettää/avaa sen perusteella pdf-tiedoston.
Eli jos haluat esimerkiksi tarrakoossa, niin järjestys ei voi olla:
laser-a4;laser-a5;thermo-190
Vaan järjestys pitää olla:
thermo-190;laser-a4 jolloin nShiftin pdf tulee tarrakoossa.

Jos tuloste jää jostain syystä tulostumatta, voit käydä tulostamassa asiakirjat myöhemmin uudelleen myyntitilauksen toimituserien kautta.
Huomaa, että tulosteet tulostuvat edelleen nShiftin palvelimelta, eikä Lemonsoftista. nShift ilmoittaa, että PDF:t ovat saatavilla rajapinnan kautta tunnin ajan ensimmäisestä tulostuksesta.

Sen jälkeen ne täytyy tulostaa nShiftin sivujen (http://www.unifaunonline.com) kautta kohdasta Historia Lähetykset, hae ja avaa lähetys. Valitse Tulosta PDF Kopio.

Jos palvelusta tulee virhe, ohjelma näyttää toimituksen yhteydessä virheilmoituksen. Virheilmoitus tulee palvelusta englanniksi, kysy virheilmoitusten merkitykset nShiftin asiakaspalvelusta.

Toimituksen peruminen Lemonsoftissa peruu myös nShiftin Unifaun-lähetyksen. Tämä koskee vain nShiftin REST rajapinnan kautta tehtyjä kuljetuksia. nShiftin nettisivuilla peruutetut tilaukset näkyvät peruutettuina. Niitä ei poisteta. Jos kuljetusta ei voi perua, ohjelma näyttää virheilmoituksen.

Jos myyntitilauksen toimituksen yhteydessä nShiftistä tulee virhe, kuljetustilausta ei todennäköisesti muodostu nShiftille, vaikka tilaus menee toimitetuksi. Selvitä virheilmoituksen syy nShiftin asiakaspalvelun kanssa.

Muuten toiminta on yhtenevä nShiftin vanhan Unifaun OnlineConnectin kanssa, eli palvelukoodit, lisäpalvelut, asiakasnumerot yms. toimivat samalla tavalla.

Ohjelma kirjoittaa nShiftiin lähetetyistä kuljetustilaussanomista ja epäonnistuneista sanomalähetyksistä myyntitilauksen tapahtumiin lokia.

nShiftin REST noutopistetoiminnallisuus (esim. postipaketti tai Matkahuolto lähellä paketti)

Ominaisuus on tarkoitettu lähinnä Web kaupoille, koska webkaupassa valitaan jo noutopiste ja tieto tulee valmiina rajapinnan kautta Lemonsoftin myyntitilaukseen. Tästä syystä Lemonsoftissa ei ole toiminnallisuutta, jolla voi etsiä noutopisteen koodeja. Web kaupasta tieto täytyy tallentaa myyntitilauksen Muut tiedot –välilehden Vastaanottaja tietojen Lisänimi (Nimi2) -kenttään. Myyntitilausten rajapinnassa kenttä Sales_order_consignee_customer_name2.

Kaukokiito Paketti (KKPARCEL) -palvelu

Kollilajille (Asetukset Valintalistat) on lisätty pituus-, korkeus- ja leveystiedot, joita Kaukokiito Paketti (KKPARCEL) -palvelu vaatii. Mitat välittyvät nShiftille sekä REST että XML -pohjaisessa toteutuksessa ja nämä asetetaan nShiftin Unifaun-aineistoon vain, jos mitat ovat > 0.

Lavoituksessa mitat haetaan lavan nimikkeen takaa, esitäytetyissä toimitustiedoissa mitat haetaan oletuksena kollilajilta ja käyttäjällä on mahdollisuus kirjoittaa neliöt ja kuutiot myös käsin. Ilman esitäytettyjä toimitustietoja tai lavoitusta mitat haetaan kollilajilta.

nShiftin REST:illä oma SSCC-seurantakoodi

nShiftin REST sanomanlähetystä varten toimintokeskuksessa on UNIFAUN_OWN_SSCC-asetus joka määrittää, lähetetäänkö oma SSCC-seurantakoodi, jos yrityksen toimipaikalle on Muut tiedot -välilehdelle asetettu EAN-yritysnumero (SSCC).

Sinun täytyy tehdä erillinen sopimus nShiftin kanssa oman SSCC:n käytöstä.

CRR -noutopyyntö lisäpalvelu

CRR lisäpalvelu tarkoittaa sitä, että Lemonsoft lähettää samalla noutopyynnön kun toimitat tilauksen.

Lisää Valintalistat Toimitustavat-listaan selitteeksi vaikkapa CRR, Lähetysehto-arvoksi Z14, Sanoma-arvoksi Unifaun Online, Lisäpalvelut-arvoksi CRR, Kuljettajan koodi -arvoksi PLSMC, Kuljettajanpalvelu koodi -arvoksi P18FI. Määritä lisäksi nShiftin Ylläpito-sivulla Postnord-tiedot (asiakasnumeronne ja valitsemanne julkaisija jne), kysy lisätietoja nShift-asiakaspalvelusta.

Käytännössä ohjelma lisää misctype (REST API -rajapinnassa "miscType") arvona EM = S-posti ja SMS = SMS. sähköposti on prio1 ja kännykkänumero prio2, ohjelma lukee tiedot yritystiedoista.

nShiftin REST:illä oleva ENOT–ennakkoilmoitus lisäpalvelu

ENOT on nShiftin oma lisäpalvelu, Ennakkoilmoitus (S-posti). nShift lähettää asiakkaalle sähköpostin kuljetuksesta tilauksen vastaanottajalle. Sähköposti lähtee nShiftiltä, kun sähköinen sanoma välittyy nShiftiltä kuljettajalle. Myyntitilauksen Toimitusasiakkaalla täytyy olla Yhteyshenkilö-tiedossa kelvollinen sähköpostiosoite. Lisää Lemonsoftiin sähköposti-ilmoituksen viestin vakioteksti Viestit Sähköposti |Saapumisen ennakkoilmoitus. Sähköpostissa näkyy vastausosoitteena tilauksen toimipaikan sähköpostiosoite.

Vinkki:

ENOT, eli ennakkoilmoitus sähköpostilla toiminto vaatii, että sähköposti on olemassa, muuten toimitus päätyy virheeseen. Jos kaikilla tilauksilla ei ole sähköpostia ja haluat kuitenkin käyttää ENOT-palvelua tilauksille joilla sähköposti on kirjoitettu, voit kiertää virheilmoituksen lisäämällä tulostussuosikin.

Näin ohjelma lähettää ennakkoilmoituksen, jos sähköposti löytyy, mutta ei päädy virheeseen, mikäli sähköposti puuttuu, tai on virheellinen.

Kuva: Lisää www.unifaunonline.com -sivuilla Ennakkoilmoitus-lisäpalvelulle oma tulostussuosikki (Ylläpito -> Tulostussuosikit), jota käytetään valintalistoilla toimitustapojen riveillä varsinaisen ENOT-lisäpalvelun sijaan. Merkkaa tulostussuosikkiin lisäpalveluksi tuo sama ennakkoilmoitus sähköpostilla, ja valitse sille lisäksi Valitse jos mahdollista -valinta.

Kuva: Lisää tulostussuosikin nimi toimitustavan Unifaun suosikki -soluun, ja poista ENOT kokonaan Lisäpalvelut-kentästä.

Nyt kun toimitat tilauksen, sähköpostin puuttuminen yhteyshenkilön tiedoista ei estä toimituksen tekemistä, vaan ennakkoilmoitus sähköpostitse lähtee matkaan, mikäli osoite löytyy ja jos ei löydy niin toimitus tehdään ilman lisäpalvelua.