Introduktion

Når du udvikler et Webshipper fragtmodul, skal du overveje, hvor meget funktionalitet du vil understøtte. Kort sagt dækker et normalt Webshipper-modul følgende trin.

• Angivelse af forsendelsesmetoder i checkout 
• Giv kunden mulighed for at vælge et udleveringssted i checkout, når dette kræves af den valgte forsendelsesmetode 
• Gemme den valgte forsendelsesmetode og det eventuelle udleveringssted på ordren 
• Når ordren er oprettet, og den ønskede status er opnået, overføres ordren til Webshipper 
• Når ordren når status “afsendt” i Webshipper, skal ordrestatus i e-handelsplatformen opdateres tilsvarende. Det kan også være relevant at gemme trackingoplysninger i e-handelsplatformen.
   

For bedre at forstå de mulige workflows, se venligst illustrationen nedenfor:

Som du måske har bemærket, kan du enten bygge modulet med Webshipper rate quoting, eller alternativt bruge det indbyggede system til forsendelsesmetoder, som din e-handelsplatform sandsynligvis allerede har.

Forskellen mellem disse to muligheder er, at Webshipper kan lave meget avancerede fragtberegninger og i nogle tilfælde live beregninger mod transportøren. Så du kan lave langt mere avancerede forsendelsesmuligheder end hvis du ikke bruger Webshippers beregning af forsendelsesmetoder. En anden fordel er, at når du sender ordren tilbage til Webshipper sammen med Webshippers forsendelsesmetode, minimerer du risikoen for, såsom at sende med forkert transportør eller service.

Webshippers beregning af forsendelsesmetoder (rate quoting) er også påkrævet i de tilfælde, hvor du vil aktivere udleveringssteder i din checkout – som UPS Access Points eller DHL Express service points. 
 

Indstillinger i modulet

I modulet skal du have en indstillingssektion med følgende attributter

• API Token fra Webshipper 
• Tenant name 
• Overførselsstatus

Hvilke API-kald skal jeg bruge? 

Alle API-kald, hvordan man autentificerer osv. er dokumenteret på https://docs.webshipper.io
Lad os for nu antage, at du skal implementere Rate quotes, afhentningssteder, ordreoverførsel og lukning af ordre. 

Prisforespørgsel

Når kunden er ved kassen, og du skal præsentere mulige forsendelsesmuligheder for kunden – skal du bruge "Rate quotes", som findes på:
http://docs.webshipper.io/#rate_quotes

Bemærk! Hvis kunden vælger en forsendelsesmetode fra forespørgslen, som kræver et afhentningssted, skal du finde mulige afhentningssteder ved hjælp af "drop point locator"-kaldet.

Når checkout er gennemført, er det vigtigt, at du gemmer shipping rate id for den valgte forsendelsesmetode. Dette skal bruges, når du senere opretter ordren i Webshipper.

Afhentningssted

For at finde afhentningssteder i nærheden af kunden skal du bruge "Drop point locator" fra Webshipper API. Kaldet er dokumenteret på: http://docs.webshipper.io/#drop_point_locators

Det er vigtigt, at du gemmer følgende information om afhentningsstedet: 

• drop_point_id 
• name 
• address_1
• zip
• city
• country_code
• state

Denne information skal medtages i create order-kaldet, som du skal foretage senere.

Opret ordre

De fleste e-handelsejere ønsker, at deres ordre overføres til Webshipper-platformen, når den når en bestemt status. For at undgå behovet for fremtidige tilpasninger vil du derfor oprette en indstilling for denne status.
 
For at oprette ordren i Webshipper skal du bruge Order-endpointet, som findes på:
http://docs.webshipper.io/#orders

Når du opretter ordren, skal du sikre, at følgende oplysninger er til stede

• Leveringsadresse
• Udleveringssted (kun hvis prisen kræver et udleveringssted)
• Ordrelinjer 
• Oprindelig forsendelse (kun nødvendigt, når der ikke bruges rate quoting)
• Valuta
• Ekstern kommentar 
• Synlig ref 
• Ext ref
• En relation til den valgte forsendelsesmetode (hvis rate quoting bruges)

Luk ordre

For at lukke ordren i platformen skal du oprette en shipment/created webhook til et endpoint i din e-handelsplatform.
Dette kan gøres enten fra brugergrænsefladen eller fra Webshipper API.

Læs mere om webhooks her:
http://docs.webshipper.io/#webhooks