Komma igång med Delivery Cloud API – nShift Help Center

Letar du efter ett sätt att samla all din försändelsedata på ett centralt ställe, även om du arbetar med flera olika book- och print-produkter? Med Delivery Cloud API från nShift kan du integrera alla dina försändelser i nShift Portal. Detta gör det enkelt att hantera och spåra dina försändelser samtidigt som du får tillgång till omfattande rapportering och avancerade spårningsverktyg, vilket ger bättre insyn genom hela din leveransprocess.

Innehåll i denna artikel:

Viktigaste användningsområden
Skapa en Delivery Cloud-organisation
Skapa Client ID och hemlig nyckel
Begär ett token
Använda Delivery Cloud API

Viktigaste användningsområden

Våra kunder har många olika uppsättningar och lösningar, vilket skapar olika användningsområden för Delivery Cloud API. Här är några exempel på de viktigaste användningsområdena:

Användningsområde 1: Flera försändelseflöden

Kunden kan använda en nShift book- och print-lösning tillsammans med nShift Track, men har även ett dropshippingflöde som använder en annan book- och print-lösning. Med Delivery Cloud API kan kunden skicka försändelser från dropshippingflödet till nShift Portal och använda Track för alla försändelser.

Användningsområde 2: Emissions Tracker

Kunden vill använda nShift Emissions Tracker, men alla försändelser skapas inte med hjälp av en nShift book- och print-produkt. Med hjälp av Delivery Cloud API kan de skicka in alla försändelser och få utsläppsberäkningar.

Användningsområde 3: Användning av en icke-nShift book- och print-lösning

Kunden använder en icke-nShift book- och print-lösning men vill köpa nShift Track. Med hjälp av Delivery Cloud API kan de skicka alla försändelser som bokats i ett annat system och dra nytta av nShift Track.

Skapa en Delivery Cloud-organisation

Börja med att skapa en Organization och ett Member Account Name i nShift Portal. Detta är platsen där försändelserna kommer att skapas. Observera att du måste skapa en Organization Unit och ett Member account specifikt för Delivery Cloud, även om du redan har ett befintligt medlemskonto i nShift Portal.

Logga in på nShift Portal och klicka på Settings längst upp till vänster.
Välj Company Management > Delivery Cloud Configuration. (Om du inte ser detta alternativ måste du kontakta nShift Customer Service för att få det aktiverat).
Klicka på Create och därefter på Add Organization Unit.
Ange ett Organization Unit Name och ett Member Account Name.
Klicka på Save.
Kom ihåg att kopiera och spara ditt Organization ID och Member Account ID, eftersom dessa värden behövs för API-förfrågningarna. Om du väljer Copy ID kopieras värdet till urklipp.

Skapa Client ID och hemlig nyckel

Delivery Cloud API kräver användning av tokens (Client IDs och Client Secrets).

Börja med att skapa det Client ID och den hemliga nyckel som behövs för autentisering.

Logga in på nShift Portal. (Om du inte använder ett Owner account kan du behöva begära åtkomst från Owner/Admin).
Klicka på Settings längst upp till höger.
Välj API Configuration > Clients i menyn till vänster.
Klicka på knappen Add på sidan Clients.
Fyll i Display name och Description. Välj ett namn och en beskrivning som gör det enklare att identifiera tokenet senare. Markera kryssrutan Enable för att aktivera tokenet direkt. (Du kan när som helst aktivera eller inaktivera tokenet efter att det skapats).
Välj Portal Shipment Data API under Allowed Scopes , vilket är de API:er du behöver åtkomst till.
Klicka på Save. Ditt Client ID och din Client Secret kommer nu att genereras och visas på skärmen. Viktigt: Din Client Secret kommer inte att vara tillgänglig efter att popup-fönstret stängs, så se till att kopiera den.
Klicka på Close. Client ID kommer nu att visas på sidan Clients. Du kan när som helst klicka på ett Client ID för att redigera, ta bort eller aktivera/inaktivera det.

Begär en token

Delivery Cloud API använder OAuth 2.0. Använd ditt Client ID och din Client Secret för att generera en åtkomsttoken. Detta görs genom att skicka en POST-begäran till följande slutpunkt:

Produktion: https://account.nshiftportal.com/idp/connect/token
Test: https://account.qa.nshiftportal.dev/idp/connect/token

Ställ in Content-Type-headern på application/x-www-form-urlencoded och skicka följande värden i begärans body:

grant_type: client_credentials
client_id: ditt klient-ID
client_secret: din klienthemlighet

Om begäran är giltig och klienten är korrekt konfigurerad får du ett JSON-svar:

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

Använda åtkomsttoken

Alla begäranden måste innehålla token i Authorization-headern. Skicka det returnerade access_token i Authorization-headern för varje begäran: Authorization: Bearer {access_token}.

Bearer-token är giltig i en timme. Begär en ny token när den nuvarande löper ut.

Använda Delivery Cloud API

När du har autentiserats är du redo att börja använda Delivery Cloud API. Börja med att hämta listan över alla transportörer. Identifiera den transportör du vill använda och hämta tjänsterna och tilläggen för den transportören. När du har rätt ID:n för transportör, tjänst och tillägg är du redo att skapa försändelsen.

Översikt över metoder och steg som krävs för att lägga till dina försändelser i nShift Portal:

Hämta en lista över alla transportörer och identifiera ID:t för den transportör du behöver.
```
GET /metadata/carriers
```
Obs: organizationId som används i denna förfrågan är det ID som du kopierade och sparade efter att du skapade Organization Unit.
Hämta en översikt över tjänsterna för en transportör. Använd transportör-ID:t som du fick från listan över transportörer.
```
GET /metadata/carriers/{carrierId}/services
```
Hämta en översikt över tillägg som är tillgängliga för en transportör. Använd transportör-ID:t som du fick från listan över transportörer. Tillägg används inte alltid, så detta steg är valfritt om dina försändelser inte har några tillägg.
```
GET /metadata/carriers/{carrierId}/addons
```
Skapa försändelser med hjälp av transportör-ID, tjänst-ID och addon-ID.
```
PUT /shipments
```
Obs: accountId som används i denna förfrågan är Member Account UUID som du kopierade och sparade efter att du skapade Organization Unit och Member Account. Kom ihåg att använda Member Account ID och inte Organization ID.

Gå till den tekniska API-dokumentationen