Kirjaudu sisään

nShift Help Center

DeliveryCloud API:n käytön aloittaminen

Avatar
Malene Tidemann
Päivitetty

Etsitkö tapaa keskittää kaikki lähetysdatasi yhteen paikkaan, vaikka käyttäisit useita eri book- ja print-ratkaisuja? nShiftin DeliveryCloud API:n avulla voit integroida kaikki lähetyksesi nShift Portaliin. Tämä mahdollistaa lähetysten helpon hallinnan ja seurannan sekä kattavan raportoinnin ja edistyneiden seurantatyökalujen käytön, mikä parantaa näkyvyyttä koko toimitusprosessissasi.

 

Tämän artikkelin sisältö:

 

Tärkeimmät käyttötapaukset

Asiakkaillamme on monia erilaisia kokoonpanoja ja ratkaisuja, mikä luo erilaisia käyttötapauksia DeliveryCloud API:lle. Tässä muutamia esimerkkejä tärkeimmistä käyttötapauksista:

 

Käyttötapaus 1: Useita lähetysvirtoja

Asiakas saattaa käyttää nShiftin book- ja print-ratkaisua yhdessä nShift Trackin kanssa, mutta lisäksi hänellä voi olla dropshipping-virta, joka käyttää toista book- ja print-ratkaisua. DeliveryCloud API:n avulla asiakas voi lähettää dropshipping-virran lähetykset nShift Portaliin ja käyttää Trackia kaikille lähetyksille.

 

Käyttötapaus 2: Emissions Tracker

Asiakas haluaa käyttää nShift Emissions Trackeria, mutta kaikkia lähetyksiä ei luoda nShiftin book- ja print-tuotteella. DeliveryCloud API:n avulla kaikki lähetykset voidaan lähettää järjestelmään ja niille voidaan saada päästölaskelmat.

 

Käyttötapaus 3: Ei-nShift book- ja print-ratkaisun käyttö

Asiakas käyttää muuta kuin nShiftin book- ja print-ratkaisua, mutta haluaa hankkia nShift Trackin. DeliveryCloud API:n avulla kaikki toisessa järjestelmässä varatut lähetykset voidaan lähettää järjestelmään ja hyödyntää nShift Trackin etuja.

 

 

DeliveryCloud-organisaation luominen

Aloita luomalla Organization ja Member Account Name nShift Portalissa. Tämä on sijainti, johon lähetykset luodaan. Huomaa, että sinun on luotava Organization Unit ja Member account erityisesti DeliveryCloudia varten, vaikka sinulla olisi jo olemassa oleva jäsenkäyttäjätili nShift Portalissa.

  1. Kirjaudu sisään nShift Portaliin ja napsauta vasemmasta yläkulmasta Settings.
     
  2. Valitse Company Management > Delivery Cloud Configuration. (Jos et näe tätä vaihtoehtoa, sinun tulee ottaa yhteyttä nShift Customer Serviceen saadaksesi sen käyttöön).


     
  3. Napsauta Create ja sen jälkeen Add Organization Unit.


     
  4. Syötä Organization Unit Name ja Member Account Name.


     
  5. Napsauta Save.
     
  6. Muista kopioida ja tallentaa Organization ID ja Member Account ID, sillä näitä arvoja tarvitaan API-pyyntöjä varten. Jos valitset Copy ID, arvo kopioidaan leikepöydälle.



 

Client ID:n ja salaisen avaimen luominen

DeliveryCloud API vaatii tokenien (Client ID ja Client Secret) käyttöä.

Aloita luomalla Client ID ja salainen avain, joita tarvitaan autentikointiin.

  1. Kirjaudu sisään nShift Portaliin. (Jos et käytä Owner account -tiliä, sinun on ehkä pyydettävä käyttöoikeus Owner/Admin-käyttäjältä).
     
  2. Napsauta oikeasta yläkulmasta Settings.

    nav-settings.png
     
  3. Valitse vasemmanpuoleisesta valikosta API Configuration > Clients.
     
  4. Napsauta Clients-sivulla Add-painiketta.
     
  5. Täytä kentät Display name ja Description. Valitse nimi ja kuvaus, joiden avulla token on helppo tunnistaa myöhemmin. Valitse Enable-valintaruutu aktivoidaksesi tokenin heti. (Voit aktivoida tai poistaa tokenin käytöstä milloin tahansa sen luomisen jälkeen).

    deliverycloud-client.png
     
  6. Valitse Portal Shipment Data API kohdassa Allowed Scopes , eli API:t, joihin tarvitset käyttöoikeuden. 
     
  7. Napsauta Save. Client ID ja Client Secret luodaan nyt ja näytetään ruudulla. Tärkeää: Client Secret ei ole enää saatavilla sen jälkeen, kun suljet ponnahdusikkunan, joten varmista, että kopioit sen talteen.
     
  8. Napsauta Close. Client ID näkyy nyt Clients-sivulla. Voit milloin tahansa napsauttaa Client ID:tä muokataksesi, poistaaksesi tai aktivoidaksesi/deaktivoidaksesi sen.

 

 

Tokenin pyytäminen

Käytä Client ID:tä ja Client Secret:iä luodaksesi käyttöoikeustokenin. Tämä tehdään lähettämällä POST-pyyntö seuraavaan endpointiin:
 

https://api.nshiftportal.com/delivery-cloud/idp/connect/token


Esimerkki:
POST https://api.nshiftportal.com/delivery-cloud/idp/connect/token
Cache-Control: no-cache
Host: www.nshiftportal.com 
Content-Type: application/x-www-form-urlencoded

client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials

 

Jos pyyntö on kelvollinen ja client on määritetty oikein, saat JSON-vastauksen:

{
    "access_token": "some-real-token-data-dskjfhsuijkdhfgjkasjdgfhqoeiefoiknsdfgvoiltgjvp...",
    "expires_in": 3600,
    "token_type": "Bearer"
}

Bearer-token on voimassa yhden tunnin ajan. Kaikkien pyyntöjen tulee sisältää token Authorization-headerissa.

 

 

DeliveryCloud API:n käyttö

Kun autentikointi on onnistunut, voit aloittaa DeliveryCloud API:n käytön. Aloita hakemalla listan kaikista kuljetusliikkeistä. Tunnista käytettävä kuljetusliike ja hae sen palvelut ja lisäpalvelut. Kun sinulla on oikeat kuljetusliikkeen, palvelun ja lisäpalvelujen ID:t, voit luoda lähetyksen.

 

Yhteenveto menetelmistä ja vaiheista, joita tarvitaan lähetysten lisäämiseen nShift Portaliin:

  1. Hae lista kaikista kuljetusliikkeistä ja tunnista tarvitsemasi kuljetusliikkeen ID.

    GET /metadata/carriers

    Huom: tässä pyynnössä käytetty organizationId on ID, jonka kopioit ja tallensit Organization Unitin luomisen jälkeen. 
     

  2. Hae yhteenveto kuljetusliikkeen palveluista. Käytä kuljetusliikkeen ID:tä, jonka sait kuljetusliikelistasta.

    GET /metadata/carriers/{carrierId}/services

     

  3. Hae yhteenveto kuljetusliikkeelle saatavilla olevista lisäpalveluista. Käytä kuljetusliikkeen ID:tä, jonka sait kuljetusliikelistasta. Lisäpalveluja ei aina käytetä, joten tämä vaihe on valinnainen, jos lähetyksissäsi ei ole lisäpalveluja.

    GET /metadata/carriers/{carrierId}/addons

     

  4. Luo lähetykset käyttäen kuljetusliikkeen ID:tä, palvelun ID:tä ja addon-ID:tä.

    PUT /shipments

    Huom: tässä pyynnössä käytetty accountId on Member Account UUID, jonka kopioit ja tallensit Organization Unitin ja Member Accountin luomisen jälkeen. Muista käyttää Member Account ID:tä eikä Organization ID:tä. 
     

Siirry tekniseen API-dokumentaatioon

Aiheeseen liittyvät artikkelit