nShift Returns-widgetten giver dine kunder mulighed for at starte deres returneringer direkte på dit website uden at forlade din butik.
Forudsætninger
- Adgang til konfigurationsgrænsefladen i nShift Returns
- Mulighed for at redigere dit websites HTML (eller adgang til en udvikler, der kan gøre det)
- En markedsidentifikator (se trin 1)
Trin 1. Find din identifikator
- Log ind på nShift Returns configuration interface
- Gå til Widget Settings > Market Setup
- Følgende identifikatorer er tilgængelige. Brug en af de understøttede kombinationer:
| Kombination | Anvendte parametre |
|---|---|
| Kun Market ID | marketId |
| Kun Company Name | customerName |
| Company Name + Market Name | customerName + marketName |
| Identifikator | Hvor finder du den? |
|---|---|
| Market ID | Klik på Open widget på dit marked – UUID'et vises i browserens adresselinje |
| Market Name | Vises direkte på listen under Market Setup |
| Company Name | Dit virksomhedsnavn, som det er konfigureret i nShift |
Hvilken skal jeg bruge?
marketIdanbefales, når det er muligt – hvis en kunde omdirigeres til login-siden, sikrer det, at det korrekte branding og sprog vises med det samme.customerNamealene fungerer, når du har ét marked. BrugcustomerName+marketName, når du har flere markeder under samme virksomhed.Bemærk: Hvis du kun bruger Company Name, omdirigerer nShift Returns automatisk kunden til det korrekte marked baseret på kundens input.
Trin 2. Konfigurer tilladelser til integration
Før widgetten kan indlæses på dit website, skal du fortælle nShift Returns, hvilken URL den må vises på.
- Gå til Widget Settings > Market Setup > Embed permissions i konfigurationsgrænsefladen
- Indtast den fulde URL til den side, hvor widgetten skal vises – for eksempel:
https://www.yourstore.com/returns - Gem dine ændringer
Dette fungerer som en tilladelsesliste – widgetten gengives kun, når den indlæses fra præcis denne URL.
Trin 3. Føj widgetten til dit website
Indsæt følgende kodestykke på den side, hvor widgetten skal vises, og erstat src-værdien med den relevante URL til din opsætning (se kombinationerne nedenfor).
<!-- nShift Returns Widget --> <iframe src="INSERT_URL_HERE" frameborder="0" marginheight="0" marginwidth="0" width="100%" height="700px" style="border: none;" title="Returns portal"> </iframe>
Understøttede URL-kombinationer for src:
| Kombination | URL |
|---|---|
| Market ID | …/redirect?marketId=YOUR_MARKET_ID |
| Kun Company Name | …/redirect?customerName=YOUR_COMPANY_NAME |
| Company Name + Market Name | …/redirect?customerName=YOUR_COMPANY_NAME&marketName=YOUR_MARKET_NAME |
Language — hvis der ikke er angivet en lang-parameter, bruger widgetten det standardsprog, der er konfigureret for markedet. Understøttede sprogkoder:
Base URLs by environment:
| Miljø | Base-URL |
|---|---|
| Produktion | https://www.nshiftreturns.com/ui/widget |
| QA | https://www.qa.nshiftreturns.com/ui/widget |
Forudfyldning af kundedata
Hvis dit website har ordreoplysninger tilgængelige – for eksempel når en kunde kommer fra en ordrebekræftelsesside – kan du sende oplysningerne direkte i widgettens URL. Når gyldige loginoplysninger er til stede, springer widgetten login-skærmen over og fører kunden direkte til ordresiden. Uden disse oplysninger lander kunden på login-siden og indtaster sine oplysninger manuelt.
Disse værdier indsættes typisk på serversiden af din platform, når siden indlæses. På den måde forbliver integrationskoden statisk, mens værdierne tilføjes dynamisk for hver session.
Understøttede kombinationer af loginoplysninger
Widgetten accepterer følgende kombinationer. Hvis flere er angivet i URL'en, anvendes det første match i denne prioritetsrækkefølge:
| Prioritet | Parametre | Kodning |
|---|---|---|
| 1 | order + customerId | Almindelig tekst |
| 2 | order + email | Almindelig tekst |
| 3 | orderBase + customerId | Ordren er Base64-kodet |
| 4 | emailBase + orderBase | Begge er Base64-kodet |
Eksempler
Almindelig tekst – e-mail og ordre:
https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&email=customer@example.com&order=1234
Almindelig tekst – kunde-ID og ordre:
https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&customerId=0b6d015d-8f6d-412b-b976-6a1caebef839&order=1234
Base64-kodet – e-mail og ordre (anbefalet — skjuler værdierne i URL'en):
https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&emailBase=Y3VzdG9tZXJAZXhhbXBsZS5jb20=&orderBase=MTIzNA==
Base64-kodet ordre med kunde-ID i almindelig tekst:
https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&customerId=0b6d015d-8f6d-412b-b976-6a1caebef839&orderBase=MTIzNA==