Komme i gang med Delivery Cloud API – nShift Help Center

Leter du etter en måte å samle alle forsendelsesdataene dine på ett sentralt sted, selv om du arbeider med flere ulike book- og print-produkter? Med Delivery Cloud API fra nShift kan du integrere alle forsendelsene dine i nShift Portal. Dette gjør det enkelt å administrere og spore forsendelsene dine, samtidig som du får tilgang til omfattende rapportering og avanserte sporingsverktøy, noe som gir bedre synlighet gjennom hele forsendelsesprosessen.

Innhold i denne artikkelen:

Viktigste bruksområder
Opprett en Delivery Cloud-organisasjon
Opprett Client ID og hemmelig nøkkel
Be om et token
Bruk av Delivery Cloud API

Viktigste bruksområder

Kundene våre har mange ulike oppsett og løsninger, noe som skaper forskjellige bruksområder for Delivery Cloud API. Her er noen eksempler på de viktigste bruksområdene:

Bruksområde 1: Flere forsendelsesflyter

Kunden kan bruke en nShift book- og print-løsning sammen med nShift Track, men har også en dropshipping-flyt som bruker en annen book- og print-løsning. Med Delivery Cloud API kan kunden sende forsendelser fra dropshipping-flyten inn i nShift Portal og bruke Track for alle forsendelser.

Bruksområde 2: Emissions Tracker

Kunden ønsker å bruke nShift Emissions Tracker, men ikke alle forsendelser opprettes ved hjelp av et nShift book- og print-produkt. Ved hjelp av Delivery Cloud API kan de sende inn alle forsendelser og få utslippsberegninger.

Bruksområde 3: Bruk av en ikke-nShift book- og print-løsning

Kunden bruker en ikke-nShift book- og print-løsning, men ønsker å kjøpe nShift Track. Ved hjelp av Delivery Cloud API kan de sende alle forsendelser som er booket i et annet system og få fordelene med nShift Track.

Opprett en Delivery Cloud-organisasjon

Start med å opprette en Organization og et Member Account Name i nShift Portal. Dette er stedet der forsendelsene vil bli opprettet. Merk at du må opprette en Organization Unit og en Member account spesielt for Delivery Cloud, selv om du allerede har en eksisterende medlemskonto i nShift Portal.

Logg inn på nShift Portal og klikk på Settings øverst til venstre.
Velg Company Management > Delivery Cloud Configuration. (Hvis du ikke ser dette alternativet, må du kontakte nShift Customer Service for å få det aktivert).
Klikk på Create og deretter på Add Organization Unit.
Angi et Organization Unit Name og et Member Account Name.
Klikk på Save.
Husk å kopiere og lagre Organization ID og Member Account ID, siden disse verdiene er nødvendige for API-forespørsler. Hvis du velger Copy ID, kopieres verdien til utklippstavlen.

Opprett Client ID og hemmelig nøkkel

Delivery Cloud API krever bruk av tokens (Client IDs og Client Secrets).

Start med å opprette Client ID og den hemmelige nøkkelen som er nødvendig for autentisering.

Logg inn på nShift Portal. (Hvis du ikke bruker en Owner account, må du kanskje be om tilgang fra Owner/Admin).
Klikk på Settings øverst til høyre.
Velg API Configuration > Clients i menyen til venstre.
Klikk på knappen Add på siden Clients.
Fyll inn Display name og Description. Velg et navn og en beskrivelse som gjør det enklere å identifisere tokenet senere. Kryss av for Enable for å aktivere tokenet umiddelbart. (Du kan når som helst aktivere eller deaktivere tokenet etter at det er opprettet).
Velg Portal Shipment Data API under Allowed Scopes, som er API-ene du trenger tilgang til.
Klikk på Save. Din Client ID og Client Secret blir nå generert og vist på skjermen. Viktig: Client Secret vil ikke være tilgjengelig etter at popup-vinduet lukkes, så sørg for å kopiere den.
Klikk på Close. Client ID vil nå bli vist på siden Clients. Du kan når som helst klikke på en Client ID for å redigere, slette eller aktivere/deaktivere den.

Be om et token

Delivery Cloud API bruker OAuth 2.0. Bruk din Client ID og Client Secret til å generere et tilgangstoken. Dette gjøres ved å sende en POST-forespørsel til følgende endepunkt:

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

Sett Content-Type-headeren til application/x-www-form-urlencoded, og send følgende verdier i forespørselens body:

grant_type: client_credentials
client_id: din klient-ID
client_secret: din klienthemmelighet

Hvis forespørselen er gyldig og klienten er riktig konfigurert, vil du motta et JSON-svar:

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

Bruke tilgangstokenet

Alle forespørsler må inneholde tokenet i Authorization-headeren. Send det returnerte access_token i Authorization-headeren for hver forespørsel: Authorization: Bearer {access_token}.

Bearer-tokenet er gyldig i én time. Be om et nytt token når det gjeldende tokenet utløper.

Bruk av Delivery Cloud API

Når du er autentisert, er du klar til å begynne å bruke Delivery Cloud API. Start med å hente listen over alle transportører. Identifiser transportøren du vil bruke, og hent tjenester og tillegg for den aktuelle transportøren. Når du har riktige ID-er for transportør, tjeneste og tillegg, er du klar til å opprette forsendelsen.

Oversikt over metodene og trinnene som er nødvendige for å legge til forsendelsene dine i nShift Portal:

Hent en liste over alle transportører og identifiser ID-en til transportøren du trenger.
```
GET /metadata/carriers
```
Merk: organizationId som brukes i denne forespørselen er ID-en du kopierte og lagret etter opprettelsen av Organization Unit.
Hent en oversikt over tjenestene for en transportør. Bruk transportør-ID-en du fikk fra listen over transportører.
```
GET /metadata/carriers/{carrierId}/services
```
Hent en oversikt over tillegg som er tilgjengelige for en transportør. Bruk transportør-ID-en du fikk fra listen over transportører. Tillegg brukes ikke alltid, så dette trinnet er valgfritt hvis forsendelsene dine ikke har tillegg.
```
GET /metadata/carriers/{carrierId}/addons
```
Opprett forsendelser ved hjelp av transportør-ID, tjeneste-ID og addon-ID.
```
PUT /shipments
```
Merk: accountId som brukes i denne forespørselen er Member Account UUID-en som du kopierte og lagret etter opprettelsen av Organization Unit og Member Account. Husk å bruke Member Account ID og ikke Organization ID.

Gå til den tekniske API-dokumentasjonen