Logg på

nShift Help Center

Delivery Checkout og Kustom

Avatar
Malene Tidemann
Oppdatert

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

Seksjoner i denne artikkelen:

 

Opprett en Delivery Checkout til bruk med Kustom

Hvis du er ny i Delivery Checkout, anbefaler vi at du starter med å lese disse artiklene: Kom i gang med Checkout og Konfigurer Delivery Checkout.

  1. Før du begynner, må du:
    • Ha en Kustom Checkout (KCOv3)-integrasjon.
    • Ha påloggingsinformasjon til Kustom Merchant Portal.
    • Være nShift-kunde og ha påloggingsinformasjon til nShift Delivery.
       
  2. Opprett Delivery Checkout-strukturen i henhold til dine behov ved å angi relevant informasjon, for eksempel tjenester, priser og agenter. Avhengig av din abonnementsplan bør du bruke en av følgende maler: Kustom - Essential, Kustom - Professional, Kustom - Premium eller Kustom standard.
     
  3. Følg oppsettveiledningen i Konfigurer Delivery Checkout og Opprett en Delivery Checkout. Vær oppmerksom på seksjonen nedenfor om Leveringsalternativer, som er annerledes for Kustom-flyten.
     

  4. Legg til nShift Delivery API-legitimasjonen i Kustoms Portal. Velg «nShift/Unifaun DeliveryCheckout (v1)» som TMS. Verdiene du må legge til kalles Identifier og Key. Følgende forklarer hvor du finner dem:

    Identifier: Kombiner den første delen av API-nøkkelen kalt «ID» med checkout-ID-en, adskilt med en bindestrek. API-nøkkelen finnes under Maintenance > API keys > API key details. Format: [API-nøkkel-ID]-[checkout-ID].
    Viktig: Bruk en bindestrek uten ekstra mellomrom. Eksempel: GHBAVZ3EXITYS-a361edd1-93bb-471d-adbc-05337f632d86
     

    api-key-id.png

    Finn checkout-ID-en under Maintenance > Delivery checkout > Search i kolonnen Delivery checkout ID.

    delivery-checkout-id.png


    Key: Dette er den andre delen av API-nøkkelen, kalt Secret ID, på siden med API-nøkkeldetaljer i Delivery. Les mer.

    API-key.png
     

    Les mer her: https://docs.kustom.co/contents/partners/tms-partners/nshift

 

Delivery Checkout-flyt med Kustom:

klarna-flow.png

 

 

Leveringsalternativer

For de fleste leveringsalternativer, tjenester, priser og tillegg er det mulig å angi anvendelsesbetingelser. Du kan også bruke avanserte betingelser for å dynamisk endre bestemte tekstfelt. Før du oppretter din Delivery Checkout anbefales det å utforske leveringsbetingelser nærmere.

  1. Namnet du gir leveringsalternativet, for eksempel «Hjem», er kun til intern bruk.
     
  2. Kryss av i boksen Disabled hvis du ikke ønsker at leveringsalternativet skal brukes umiddelbart. Du kan endre «Disabled»-statusen når som helst, for eksempel hvis det er et midlertidig problem med en transportørs tjeneste eller hvis du bare ønsker å inkludere dette alternativet på et bestemt tidspunkt av året.
     
  3. Tilordne leveringsalternativet til en Category, hvis relevant. Hvis du bruker både undernivåer og kategorier, bør du tilordne undernivået til en kategori i stedet. Bruk av kategorier kan imidlertid ofte erstatte bruk av undernivåer.
     
  4. Velg en tjeneste i seksjonen Service.
     
  5. Klikk på Add service.
    Hvis tjenesten har agenter/hentesteder, kan du bestemme hvilke og hvor mange agenter som skal vises ved hjelp av geolokasjon. Avstanden til de nærmeste agentene beregnes for hvert postnummer. For eksempel betyr «20» at agenter innenfor en radius på 20 km fra en definert GPS-koordinat vises.

    Geolokasjon kan bare brukes i Belgia (BE), Danmark (DK), Estland (EE), Finland (FI), Tyskland (DE), Luxemburg (LU), Nederland (NL), Norge (NO), Sverige (SE) og Åland (AX).
    1. Angi en verdi i feltet Maximum radius (km) hvis du vil vise agenter basert på geolokasjon; ellers bør det settes til «0».
       
    2. Med Maximum number of agents kan du begrense antallet agenter som vises basert på geolokasjon. Maks. 15 agenter.
       
  6. Klikk på New eller Free shipping i seksjonen Prices for å angi tjenesteprisen.
    1. Ved New angir du følgende i hver valutaseksjon:
      • Prisen som skal vises for hvert språk, for eksempel «€ 7» i English (en)
      • Prisen som en numerisk verdi, for eksempel «7.0» i Price
      • Skattesatsen som skal brukes, for eksempel «12» i Tax rate (%)
         
    2. Ved Free delivery angir du følgende i hver valutaseksjon:
      • Teksten som skal vises, for eksempel «Free», i English (en)
      • Handlekurvverdien fra hvilken leveringen skal være gratis, for eksempel «39.0», i Limit for free delivery
         
    3. I seksjonen Addons klikker du på redigeringsikonet edit.png til venstre for et tillegg du vil aktivere eller redigere.
      • Kryss av for Preselected, Mandatory eller begge deler hvis tillegget skal være forhåndsvalgt og/eller obligatorisk i nettbutikken.
      • Klikk på New i seksjonen Prices for å angi priser for tillegget.
      • Angi i hver valutaseksjon prisen som skal vises for hvert språk, for eksempel «€ 1» i English (en), og prisen som en numerisk verdi, for eksempel «1.0» i Price.
         
    4. Hvis du klikker på OK når du forlater siden Edit addon, aktiveres tillegget selv om du ikke har angitt noen informasjon.
       
    5. I seksjonen Badges kan du velge en type merke som vil være synlig for tjenesten, for eksempel «eco-friendly» eller «recommended».
      • Klikk på New.
         
  7. Klikk på OK.
     
  8. I seksjonen Delivery interval kan du angi innen hvor mange dager leveringen vil finne sted tidligst og senest.

    Eksempel:
    Earliest delivery (business days): 1
    Latest delivery (business days): 3
    Pakken vil bli levert innen 1 til 3 dager. 
  9. Klikk på New i seksjonen Fields for titles hvis du vil legge til en tittel som skal brukes under bestemte betingelser.
    • I seksjonen Language angir du en tittel på de språkene du definerte tidligere.

      Fields for titles er obligatorisk, men vil bli overstyrt av titler fra din Kustom Checkout.
       
  10. Klikk på New i seksjonen Captions for field 1 for å legge til tekst. Relevant tekst/informasjon avhenger av din nettbutikk-konfigurasjon.
    • I seksjonen Language angir du teksten på de språkene du definerte tidligere, for eksempel «Relevant tekst» i feltet English (en).
       
  11. Klikk på New i seksjonen Sort order for å angi på hvilken plass leveringsalternativet skal vises.
     
  12. I seksjonen Number of days to delivery from today's date kan du angi en verdi som legger til dager fra dagens dato.
    • Klikk på New og angi et heltall i feltet Value.
       
  13. Eksempel:
    Tidligste leveringstidspunkt: 17:00
    Seneste leveringstidspunkt: 22:00
    Verdi: 2
    Hvis dagens dato er 5. juni, vil pakken bli levert mellom kl. 17:00 og 22:00 den 7. juni.

 

For å legge til flere leveringsalternativer for Delivery Checkout, klikker du på New option på siden New delivery checkout og følger trinnene ovenfor.

For noen elementer, for eksempel leveringsalternativer og priser, kan du endre rekkefølgen de vises i nettbutikken. Bruk ikonene opp up.png og ned down.png ved siden av en elementrad eller bruk Sort order som beskrevet ovenfor.

Egendefinerte agenter behandles som en tjeneste og legges til på samme måte som andre tjenester.

Klikk på Test for å se hvordan leveringsalternativene vises i nettbutikken avhengig av hvilke parametere du angir.

«tocity» og «tozipcode» er alltid obligatoriske, men for noen transportører kan også andre parametere være nødvendige.

 

Bruk søkefunksjonen for å vise, redigere eller slette en Delivery Checkout.

 

 

Egendefinerte tillegg

premium.png

Det egendefinerte tillegget «Express packaging» er ikke knyttet til bestemte leveringsalternativer.

  1. Gå til Maintenance > Delivery checkout.
     
  2. Når du oppretter en ny Delivery Checkout, aktiverer du egendefinerte tillegg på siden New delivery checkout.
     
  3. For å aktivere egendefinerte tillegg på en eksisterende Delivery Checkout, klikk på redigeringsikonet edit.png til venstre for Delivery Checkout på siden Delivery checkout.
     
  4. Klikk på redigeringsikonet edit.png til venstre for en tilleggsrad i seksjonen Custom addons.
     
  5. Kryss av i boksen Preselected hvis tillegget skal velges automatisk på forhånd. Kryss av i boksen Mandatory hvis tillegget skal være obligatorisk for tjenesten.
     

Merk: Hvis du klikker på OK når du forlater siden Edit addon, aktiveres tillegget selv om du ikke har angitt noen informasjon.

Du deaktiverer et egendefinert tillegg ved å klikke på slettikonet delete.png til venstre for tilleggsraden.

 

 

Parametere – transportørspesifikke parametere

Noen parametere finnes allerede i systemet, men du kan også legge til egne. Parametere konfigureres i GUI-en. Hvis du ikke angir en standardverdi, må parameteren settes i API-kallet. Parametere som er knyttet til avsenderen, angis automatisk.

 

Les mer om parametere her.

 

Merknader om parametere med Kustom:

  • Parametere/tagger (tekst) kan ha en verdi (streng). Skill parameteren/taggen og verdien med et kolon (:).
    Eksempel: «products:4»
    Du kan ikke bruke en numerisk verdi med relative operatorer som «>» eller «<».
    Parameter-/taggverdier kan brukes til å opprette betingelser for numeriske verdier (tekst) ved å bruke betingelseslister for gyldige/ugyldige verdier. 
  • En tagg/parameter kan også være boolsk.
    Taggen sendes til Kustom = true.
    Taggen sendes ikke til Kustom = false
    Eksempel: «freefreight»

 

 

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 Kustom finnes det noen spesielle scenarier som vi vil gå gjennom nedenfor. Se Kustoms dokumentasjon om hvordan du integrerer KSS med Delivery Checkout.

 

Merknad:

Vi anbefaler at du gir Kustom en reserveløsning for hver checkout-økt i tilfelle Kustom ikke får svar fra vår API, for eksempel på grunn av vedlikehold.

På denne måten sikrer du at kundene dine alltid presenteres med forsendelsesalternativer.

 

 

Ytterligere artikler:

Relaterte artikler