Hyppää sisältöön

Käytön aloittaminen

Tämä ohje käsittelee ECShipin ja ECPrintNoden alkuasennuksen Business Centralissa.

Esivaatimukset

  • Microsoft Dynamics 365 Business Central online (SaaS)
  • nShift-tili (Unifaun) API-yhteydellä
  • PrintNode-tili (valinnainen, tarvitaan vain etikettien tai asiakirjojen suoratulostukseen)

1. Asenna sovellus

Asenna ECShip Microsoft AppSourcesta. Kumppanisovellus ECPrintNode asennetaan automaattisesti riippuvuutena.

Asennuksen jälkeen määritä käyttäjille sopivat oikeusjoukot:

Oikeusjoukko Määritä käyttäjille
FMD ECSHIP-ADMIN Käyttäjät, jotka luovat ja hallinnoivat lähetysasiakirjoja
FMD ECPRINTNODE-ADMIN Käyttäjät, joiden täytyy määrittää tai käyttää PrintNode-tulostusta

2. Luo nShift API -avaimet

ECShip muodostaa yhteyden nShiftiin heidän REST API -rajapintansa kautta. Tätä varten sinun täytyy luoda API-avaimet nShift Onlinessa (Unifaun Online).

  1. Kirjaudu osoitteessa unifaunonline.com asiakastunnuksillasi.
  2. Siirry kohtaan Maintenance -> API Keys.
  3. Valitse New API-key, jos avainta ei vielä ole.
  4. Valitse API-avaimen tyyppi.
  5. Viimeistele avaimen luonti valitsemalla Finish.
  6. Kopioi ID ja Secret. Tarvitset ne ECShip Setupissa.

Tärkeää: Säilytä API Secret turvallisesti. Se näytetään vain kerran luomisen yhteydessä.

3. Määritä ECShip Setup

Hae Business Centralissa ECShip Setup avataksesi päämäärityssivun.

API-yhteys

Kenttä Kuvaus
Tunnus nShiftista saatu API Key ID vaiheesta 2
Salainen tunnus nShiftista saatu API Secret vaiheesta 2
Unifaun asiakastili nShiftin asiakastilisi numero
Unifaun Lähettäjän Quick-Id nShiftiin määritetty lähettäjän tunniste

Yleiset asetukset

Kenttä Kuvaus
Toimituksen nro Lähetysasiakirjojen numerointi
Käytössä Pääkytkin, joka ottaa ECShip-integraation käyttöön tai poistaa sen käytöstä
Testilähetys Kun käytössä, lähetykset lähetetään nShiftiin mutta niitä ei välitetä rahdinkuljettajalle. Hyödyllinen testaukseen.
Debug Mode Ottaa käyttöön lisädiagnostiikan vianmääritystä varten
Luo lähetys automaattisesti kirjatusta toimituksesta Luo ECShip-asiakirjan automaattisesti, kun varastolähetys kirjataan
Luo lähetys automaattisesti sijainnista Rajaa automaattisen luonnin tiettyihin sijainteihin. Käytä pystyviivaa \| erottamaan useita sijaintikoodeja, esimerkiksi BLUE\|RED.

Oletusarvot

Kenttä Kuvaus
Oletus sisällön kuvaus Kollin sisällön oletusteksti
Default Shipm. Content Descr. Rahdinkuljettajalle lähetettävä tavarankuvauksen oletusarvo
Default Receiver Ref. Source Kenttä, jota käytetään vastaanottajan viitteelle: External Document No. tai Your Reference
Lähetyspvm kentän lähde Miten lähetyspäivä määräytyy: Source Doc. Shipment Date tai Work Date
Default Pickup Time From / To Noutoajan oletusaikaväli

Lähettäjän asetukset

Kenttä Kuvaus
Käytä sijaintia lähettäjänä Käyttää Business Centralin sijainnin osoitetta lähettäjän osoitteena yrityksen tietojen sijaan

Tulostinasetukset

Kenttä Kuvaus
Default Doc. Printer Oletus-PrintNode-tulostin lähetysasiakirjoille ja rahtikirjoille
Default Label Printer Oletus-PrintNode-tulostin lähetystarroille

Katso tarkemmat tulostinasetukset kohdasta Tulostus.

4. Lataa rahdinkuljettajien tiedot nShiftista

Kun API-yhteys on määritetty, lataa rahdinkuljettajien metatiedot nShiftista:

  1. Avaa ECShip Setup.
  2. Valitse toiminto Luo perusasetukset.
  3. Järjestelmä lataa nShift-tililtäsi kaikki saatavilla olevat rahdinkuljettajat, palvelut, lisäpalvelut ja kollilajit.

Samalla varmistetaan, että API-yhteys toimii oikein. Jos lataus epäonnistuu, tarkista API-tunnus ja salainen tunnus.

Lataus täyttää seuraavat sivut:

  • ECShip Carriers - käytettävissä olevat rahdinkuljettajat
  • ECShip Carrier Services - rahdinkuljettajakohtaiset palvelut
  • ECShip Carrier Service Addons - lisäpalvelut, kuten ilmoitukset ja postiennakko
  • ECShip Package Codes - käytettävissä olevat kollilajit

Katso kohdasta Rahdinkuljettajien määritykset, miten rahdinkuljettajat määritetään latauksen jälkeen.

5. Määritä PrintNode (valinnainen)

PrintNode mahdollistaa etikettien ja asiakirjojen suoratulostuksen paikallisille tai verkkotulostimille Business Central Onlinesta. Jos et tarvitse suoratulostusta, voit ohittaa tämän vaiheen ja käyttää manuaalisia PDF-latauksia.

Luo PrintNode-tili

  1. Rekisteröidy osoitteessa app.printnode.com. Rekisteröinti on maksuton.
  2. Luo API-avain PrintNode-tilisi asetuksissa.

Asenna PrintNode Client

  1. Lataa PrintNode Client osoitteesta printnode.com/en/download.
  2. Asenna se tietokoneelle tai tulostinpalvelimelle, jolla on yhteys käytettäviin tulostimiin.
  3. Client toimii taustapalveluna ja julkaisee paikalliset tulostimet PrintNode API:n kautta.

Määritä PrintNode Business Centralissa

  1. Hae ECPrintNode Setup Business Centralissa.
  2. Syötä PrintNode API Key.
  3. Ota PrintNode Enabled käyttöön.
  4. Valitse Test PrintNode Connection varmistaaksesi yhteyden. Samalla noudetaan tilitiedot.
  5. Valitse Show Printers tuodaksesi kaikki PrintNodessa käytettävissä olevat tulostimet.

Tulostimien tuonnin jälkeen määritä oletustulostimet ECShip Setupissa. Katso Tulostus.

6. Varmista määritykset

Kun määritykset on tehty:

  1. API-yhteys - Suorita Luo perusasetukset ECShip Setupissa. Jos rahdinkuljettajat latautuvat, nShift API -yhteys toimii.
  2. PrintNode-yhteys - Suorita Test PrintNode Connection ECPrintNode Setupissa. Jos tilitiedot näkyvät, PrintNode-yhteys toimii.
  3. Testilähetys - Ota Testilähetys käyttöön ECShip Setupissa, luo lähetys myyntitilaukselta ja lähetä se. nShift käsittelee lähetyksen, mutta ei välitä sitä rahdinkuljettajalle.

Seuraavat vaiheet