Denne artikkelen forklarer hvor konfigurasjonen av Delivery Checkout ved bruk med Transsmart avviker fra standardkonfigurasjonen.

Seksjoner i denne artikkelen:

• Opprett en Delivery Checkout til bruk med Transsmart
• Book og skriv ut med Transsmart
• DeliveryCheckout API

Opprett en Delivery Checkout til bruk med Transsmart

Hvis du er ny i Delivery Checkout, anbefaler vi at du starter med å lese disse artiklene:

• Kom i gang med Checkout
• Konfigurer Delivery Checkout
   

1. Før du begynner oppsettet, må du sørge for at du har minst én avsender i adresseboken din. Se Legg til en ny avsender, Adressebok via API eller Importer adressebok.
    
2. Du må også angi ditt Transsmart-kontonummer, bruker-ID og passord i seksjonen Transsmart details på siden Sender i nShift Delivery.
    
3. Følg deretter trinnene beskrevet i: Opprett en Delivery Checkout

Se våre andre artikler om

• Checkout-oppsett
• Leveringsbetingelser

Delivery Checkout-flyt med Transsmart:

Book og skriv ut med Transsmart

Du kan booke og skrive ut forsendelser med Transsmart via API, MyTranssmart eller en direktelenke.

 

Via API

For å booke og skrive ut forsendelser via Transsmart API bruker du prepare ID som referanse for å utføre handlingen BOOK eller PRINT. Ved bruk av PRINT-alternativet vil forsendelsen også bli booket. Når du booker forsendelsen, må du legge til manglende obligatorisk forsendelseinformasjon, for eksempel pakkeinformasjon.

I MyTranssmart-dashbordet kan du også konfigurere standardinnstillinger som deretter brukes automatisk.

Les Transsmart Developer Documentation for å utføre booking og utskrift fra ditt e-handels-, ERP- eller WMS-system her.

 

Administrer standardinnstillingene i Transsmart her.

 

Via MyTranssmart

Du kan også booke og skrive ut forsendelsen i MyTranssmart-brukergrensesnittet.

Gå til Book og skriv ut i MyTranssmart.


 

Via direktelenke

Hvis du vil gå direkte til forsendelsen for å booke og skrive ut, bruker du en URL.

https://api.transsmart.com/v2/direct/details?key=<transsmart key>&reference=<prepareId>

• Erstatt <transsmart key> med nøkkelen din fra Transsmart.
• Erstatt <prepareId> med prepare ID fra Delivery Checkout.

Hent Transsmart-nøkkelen din her.

DeliveryCheckoutAPI

DeliveryCheckout API er en integrasjonstjeneste for kommunikasjon mellom Delivery Checkout og nettbutikken din. DeliveryCheckout API bruker et REST API-rammeverk for kommunikasjon med JSON som databærer og tilbyr en rekke funksjoner.

All generell dokumentasjon for DeliveryCheckoutAPI finner du her.

Ved bruk sammen med Transsmart finnes det noen spesielle scenarier, som vi vil gå gjennom nedenfor.

Opprett en delforsendelse

POST /delivery-checkouts/{deliveryCheckoutId}/shipments

Oppretter en delforsendelse basert på det leveringsalternativet forbrukeren har valgt i nettbutikken.

Dette endepunktet er obligatorisk.
Bruk alltid den fullstendige Delivery Checkout-ID-en, siden Delivery Checkout-versjonen er inkludert i ID-en.

URI-parametere

Eksempel på body

{
  "selectedOptionId": "3e01c458-b4fb-4a15-9468-f9179a516a0c",
  "language": "en",
  "orderNo": "order number 123",
  "prepareId": "test34",
  "receiver": {
    "name": "Testname",
    "address1": "Testaddress 1",
    "zipCode": "1080",
    "city": "Ixelles",
    "country": "BE",
    "mobile": "0733000000",
    "email": "email2@example.com"
  },
  "agent": {
    "quickId": "19172",
    "name": "DISTRIBUTEUR TRIBES BXL CN",
    "address1": "Avenue Louise 279",
    "address2": null,
    "zipCode": "1050",
    "city": "Bruxelles",
    "state": null,
    "country": "BE",
    "mapLongitude": 4.36706,
    "mapLatitude": 50.82386,
    "phone": null,
    "email": null
  }
}

Eksempel på svar

{
  "sourceSystem": "TS",
  "serviceId": "TS:BPO:TAXIPOST24H",
  "optionTitle": "BPost taxipost 24h pickup point delivery",
  "serviceCaption": "BPost taxipost 24h pickup point delivery"
}

For en beskrivelse av egenskaper, se Egenskapsreferanseguiden.

For skjema og testing, se https://api.unifaun.com/rs-docs/ og naviger til /delivery-checkouts/{deliveryCheckoutId}/shipments POST.

Hent en delforsendelse

GET /delivery-checkout-shipments/{prepareId}

Henter en delforsendelse som tidligere er opprettet.

 

URI-parametere

Eksempel på svar

{
  "serviceId": "DCTEST",
  "serviceTitle": "Delivery Checkout Test Service",
  "sourceSystem": "UO",
  "orderNo": "order number 123",
  "prepareId": "123",
  "sender": {
    "quickId": "1",
    "name": "nShift AB",
    "address1": "Skeppsbron 5-6",
    "postalCode": "41121",
    "city": "GÖTEBORG",
    "country": "SE",
    "phone": "+46 31 725 35 00",
    "email": "email1@example.com"
  },
  "receiver": {
    "name": "nShift AB",
    "address1": "Tegnérgatan 34",
    "postalCode": "11359",
    "city": "STOCKHOLM",
    "country": "SE",
    "phone": "+46 8 34 35 15",
    "email": "email2@example.com"
  }
}

For en beskrivelse av egenskaper, se Egenskapsreferanseguiden.

For skjema og testing, se https://api.unifaun.com/rs-docs/ og naviger til /delivery-checkout-shipments/{prepareId} GET.

Slett en delforsendelse

DELETE /delivery-checkout-shipments/{prepareId}

Sletter en delforsendelse.

Når delforsendelsen er slettet, kan prepare ID gjenbrukes for nye delforsendelser.

URI-parametere

Ingen svartekst returneres når en delforsendelse er vellykket slettet.

For en beskrivelse av egenskaper, se Egenskapsreferanseguiden.

For skjema og testing, se https://api.unifaun.com/rs-docs/ og naviger til /delivery-checkout-shipments/{prepareId} DELETE.

Hent tjenestens kildesystem

GET /delivery-checkout-shipments/{prepareId}/source-system

Henter kildesystemet som delforsendelsestjenesten stammer fra.

Nyttig hvis bare prepare ID er kjent og Delivery Checkout-konfigurasjonen inneholder alternativer med tjenester fra flere kildesystemer.

URI-parametere

For en beskrivelse av egenskaper, se Egenskapsreferanseguiden.

For skjema og testing, se https://api.unifaun.com/rs-docs/ og naviger til /delivery-checkout-shipments/{prepareId}/source-system GET.