WooCommerce: Sådan integrerer du din WooCommerce shop til PeakWMS

I artiklen her kan du finde links til guides, der hjælper dig med oprettelse af API-nøgle i WooCommerce, samt opsætning af integration til WooCommerce i PeakWMS. 

I guiden finder du også en gennemgang af, hvad integrationen mellem PeakWMS og WooCommerce kan, samt hvilke elementer, du skal være opmærksom på, inden du opretter din webshopintegration i PeakWMS.

INDHOLDSFORTEGNELSE

• SKU'er
• Firewall, whitelist IP-adresser
• Metafelter
  • Mapping af metafelter
  • Metafelter, der mappes automatisk
  • Produkter markeret til lagerstyring
• Opsætning af integration
• Webhooks
  • Sådan fungerer webhooks
  • Hvad er specielt ved webhooks i WooCommerce?
• Produktintegrationer
• Annullering af ordre
• Data fra PeakWMS til WooCommerce
  • Opdatering af lagertal
  • Opdatering af stregkoder
  • Opdatering af SKU
  • Besked ved afsendelse af ordre
• Plugins

SKU'er

For at du kan bruge PeakWMS er det vigtigt, at alle dine produkter har en SKU. PeakWMS bruger SKU'en til at adskille produkterne fra hinanden. Af den grund er det også rigtig vigtigt, at dine SKU'er er unikke. Du må derfor ikke have flere produkter i din webshop, der har samme SKU.

Har du produkter med varianter, og har disse samme SKU, så anbefaler vi, at du retter SKU'erne på varianterne til, så de indeholder informationer, der er unikke for den enkelte variant. Det kan f.eks. være variantens farve eller str. der tilføjes til den eksisterende SKU på varianten.

Har dine produkter SKU?

    Ja > Er de unikke?

• Er dine SKU'er unikke, bør der ikke være problemer med at hente produkterne inde i PeakWMS.
• Er dine SKU'er ikke unikke, så skal du sørge for, at de bliver det. For PeakWMS er SKU'en unik. Det er derfor ikke muligt at have flere produkter i PeakWMS med samme SKU.

    Nej, mine produkter har ikke SKU'er

• Vil du selv oprette SKU'er?
• Skal PeakWMS oprette SKU'er?

Det er vigtigt for brugen af PeakWMS, at alle dine produkter har en SKU. Det er derfor nødvendigt, at du tilføjer SKU på alle dine produkter, hvis ikke du har det allerede. 

Hvis ikke du ønsker det store arbejde med selv at opfinde SKU'er til produkterne, så kan PeakWMS tildele SKU til hvert enkelt af dine produkter.

Produkterne vil da automatisk få en SKU, når de registreres i PeakWMS. SKU'erne vil altid være fortløbende nummer.

Ønsker du at PeakWMS skal generere SKU til dine produkter, skal du kontakte Peak Systems ApS' support, for at aktiveret funktionen.

Firewall, whitelist IP-adresser

Du har mulighed for at installere en firewall på din WooCommerce webshop. Denne firewall kan du risikere skaber udfordringer for PeakWMS. For at undgå problemer skal du whiteliste PeakWMS' IP-adresser i din webshop. Hvis du har en firewall og ikke har whitelisted PeakWMS' IP-adresser, så vil PeakWMS med stor sandsynlighed ikke kunne hverken hente eller sende opdateringer til/fra din webshop.

Det er derfor vigtigt, at du gør følgende, inden opsætning af din webshopintegration i PeakWMS.

1. Tjekker om du har et firewall-plugin i din WooCommerce webshop
2. White lister PeakWMS' IP-adresser, hvis du har et firewall-plugin

Ved at white liste PeakWMS' IP-adresser, gør du dit plugin opmærksom på, at PeakWMS gerne må hente og sende informationer.

OBS! Der kan også ligge en firewall, der hvor dit domæne hostes. Her kan det ligeledes være en fordel at tjekke, om IP-adresser skal white listes.

Liste over PeakWMS' IP-adresser kan eftersendes.

Metafelter

Inden du opsætter integrationen mellem PeakWMS og WooCommerce, er det også vigtigt, at du finder ud af, om du har data i dine metafelter, som er vigtige for dine ordrer eller produkter.

Metafelterne sendes ikke automatisk med i de kald, der laves fra WooCommerce til PeakWMS, og PeakWMS vil derfor ikke modtage det data, der ligger i felterne medmindre de mappes manuelt ind i PeakWMS.

Mapping af metafelter

PeakWMS indeholder funktionalitet til mapping af metafelter til følgende entiteter i PeakWMS:

• Ordrer
• Ordrelinjer
• Produkter
• Indkøbsordre
• Indkøbsordrelinjer

Ligger metafeltet på en af ovenstående, vil det være muligt at mappe dataen til et eksisterende felt i PeakWMS. 

OBS! Det er vigtigt at dataen ligger i et metafelt. Det er ikke muligt for PeakWMS at mappe felter, der ikke er i metadataen.

For at mappe data fra metadata-felter skal du tage kontakt til Peak Systems ApS' support. Mapping af metadata-felter betragtes som betalbar support.

Metafelter, der mappes automatisk

Der findes ikke en standard for alle felter i WooCommerce. Af den grund, har PeakWMS automatisk mapping af visse metadata-felter, hvis de får et specifikt navn i din WooCommerce webshop.

Stregkoder mappes automatisk ind i PeakWMS, hvis de ligger i et metadata-felt med nøglen peakwms_ean

Pakkeshop mappes automatisk ind i PeakWMS, hvis de ligger i et metadata-felt med nøglen ...

Fragtbemærkning mappes automatisk ind i PeakWMS, hvis de ligger i et metadata-felt med nøglen ...

Produkter markeret til lagerstyring

I WooCommerce kan dupr. produkt, angive, om produktet skal lagerstyres. Hvis ikke produkterne er markeret til lagerstyring, så vil WooCommerce ikke tage imod StockAdjust-beskeder (lagerjusteringer) på produktet fra PeakWMS.

**BILLEDE AF INDSTILLING I WOO**

Opsætning af integration

For at du kan integrere din WooCommerce webshop til PeakWMS, skal du bruge en API-nøgle. API-nøglen giver PeakWMS adgang til at læse og "skrive" visse elementer på din webshop; som f.eks. ordrer og lagertal. API-nøglen skal oprettes i din WooCommerce webshop.

Du finder en guide til oprettelse af API-nøgle i WooCommerce her:

Link til opsætning af API-nøgle i WooCommerce

Udover en API-nøgle, skal PeakWMS også bruge din WebURL. WebURL'en er den URL som leder ind på din webshop.

Nedenfor finder du en guide til, hvordan du integrerer din WooCommerce webshop til PeakWMS.

Link til opsætning af WooCommerce i PeakWMS

Webhooks

Når din webshopintegration mellem PeakWMS og WooCommerce er oprettet, sendes der løbende data frem og tilbage mellem PeakWMS og WooCommerce.

Dataen sendes via webhooks. Webhooken bruges som bindeled mellem PeakWMS og din WooCommerce. Her sendes bl.a. informationer om dine ordrer og produkter.

En webhook er en metode til at få realtidsdata fra et system til et andet – uden at skulle spørge efter det hele tiden.

PeakWMS modtager webhooks fra WooCommerce når:

• En ordre oprettes
• En ordre opdateres
• En ordre annulleres
• Et produkt oprettes
• Et produkt opdateres
• Et produkt slettes

Sådan fungerer webhooks

Når du opretter din integration mellem PeakWMS og WooCommerce, oprettes webhooks automatisk. Du skal ikke manuelt oprette webhooks i din webshop.

Nedenfor finder du en kort forklaring på, hvordan webhooks fungerer:

1. Opsætning:

• Du registrerer en URL (webadresse) i et system, som skal sende data (f.eks. et API).
• Denne URL peger på din server eller applikation, som skal modtage data.

2. Trigger:

• Når en bestemt begivenhed sker (f.eks. en ny ordre oprettes, en betaling gennemføres, et produkt opdateres), aktiveres webhooken.

3. Data sendes:

• Systemet sender en HTTP-anmodning til den registrerede URL.
• Anmodningen indeholder data om den begivenhed, der lige er sket.

4. Modtagelse og behandling:

• Din server modtager anmodningen og kan behandle dataen med det samme.

5. Respons:

• Din server svarer typisk med en HTTP-statuskode (f.eks. 200 OK) for at bekræfte, at data er modtaget korrekt.

Hvad er specielt ved webhooks i WooCommerce?

I de fleste systemer, sendes webhooks med det samme, efter der er sket en ændring. Det kan f.eks. være ved oprettelse eller ændring af ordre eller produkt.

For WooCommerce fungerer dette en smule anderledes. WooCommerce webhooks er bundet op på, om der er aktivitet på webshoppen. Det betyder, at er der stille på webshoppen, så sender WooCommerce ingen webhooks til PeakWMS.

Du kan derfor risikere, at der er forsinkelse på både produktoprettelse og ordreoprettelse.

For at sikre, at PeakWMS ikke misser ordrer f.eks. pga. en usædvanligt stille dag på webshoppen, så har PeakWMS en indbygget sikkerhed, der hver 4 time, kigger 4 timer tilbage, og henter alle ordrer, der ikke er registreret i PeakWMS.

Har du en ordre eller et produkt, der ikke er hentet ind i PeakWMS, så kan det hentes manuelt. Du kan læse mere om det her: 

Produkter: Hent produkt

Ordrer: Hent ordre manuelt

Produktintegrationer

For at PeakWMS kan sende og modtage opdateringer på dine produkter, er det nødvendigt, at der er et link mellem PeakWMS og din webshop. I PeakWMS kaldes dette link en produktintegration.

PeakWMS benytter produktintegrationerne som link mellem dine produkter og dine webshops. Hver enkelt produkt har en produktintegration til hver enkelt af dine shops.

I produktintegrationen gemmes produktets id og variant id. Produkt id og variant id kommer fra din webshop og er unikt for hvert produkt og variant.

Produktintegrationen gør det muligt for PeakWMS at sende og modtage opdateringer på dine produkter.

Det er også produktintegrationen, der gør det muligt for PeakWMS at linke dine ordrelinjer til det korrekte produkt. Hvis en ordre kommer over med en ordrelinje, hvor PeakWMS ikke kender produkt id'et, så vil ordren få fejlen "Ukendt produkt. Der eksisterer intet produkt med id ...". 

Du finder en uddybende forklaring på produktintegrationer, og hvordan det benyttes i PeakWMS her:

Forklaring: Produktintegrationer

Annullering af ordre

Ovenstående princip gælder også for annulleringer. Vi anbefaler, at du foretager dine annulleringer direkte i webshoppen. Når en ordre annulleres i webshoppen inden ordren er pakket, så sendes der automatisk besked til PeakWMS, om at ordren er annulleret, via webhook fra din WooCommerce webshop. 

Annulleres en ordre først, når en ordre er pakket, sendes der ikke opdatering afsted til PeakWMS. Her skal du selv sørge for at tage fat i 3PL'en. Der er ikke systemsupport for annulleringer efter ordren er pakket færdig. Det skyldes, at PeakWMS ikke ved, om ordren er blevet hentet af fragtfirmaet, eller om den fortsat er på lageret.

Du finder yderligere forklaring på annullering af ordrer her: 

Håndtering af annullerede ordrer

Data fra PeakWMS til WooCommerce

PeakWMS kan sende forskellige beskeder med opdateringer til din WooCommerce webshop. Beskederne skal aktivt slåes til på webshopintegrationen, der oprettes i PeakWMS, for at beskederne kan sendes. 

Oplever du, at beskeder ikke sendes, skal du derfor først og fremmest sikre dig, at beskederne er slået til på webshopintegrationen i PeakWMS.

Opdatering af lagertal

Når du opretter en integration til din WooCommerce webshop i PeakWMS, så bliver PeakWMS master på dine lagertal. Det betyder, at alle lagerjusteringer, der foretages på din beholdning, skal foretages i PeakWMS. 

Du må IKKE foretage ændringer på lagerbeholdningen i WooCommerce, efter webshoppen er integreret til PeakWMS. Foretager du alligevel ændringer, skal du være opmærksom på, at disse IKKE vil blive sendt videre til PeakWMS.

Næste gang der foretages et salg på produktet, eller der foretages en justering på produktet i PeakWMS, så vil lagertallet blive overskrevet i WooCommerce.

Det er vigtigt, at dine produkter i WooCommerce er sat op til at være lagerstyret. Hvis ikke de er det, vil PeakWMS ikke kunne opdatere lagertal på beholdningerne.

Beskeden, der sendes fra PeakWMS til WooCommerce kaldes "StockAdjust".

Opdatering af stregkoder

PeakWMS kan opdatere stregkoder til din webshop. Stregkoderne opdateres til feltet peakwms_ean, der er beskrevet i denne artikel under Metafelter. Metafeltet skal være oprettet på dine produkter og varianter i WooCommerce, for at PeakWMS kan opdatere data til feltet.

Opdatering af SKU

Du kan sætte PeakWMS op til automatisk at generere SKU til dine produkter, når du opretter produkterne i WooCommerce.

Funktionen fungerer på denne måde: 

1. Du opretter et produkt i din WooCommerce webshop 
2. WooCommerce sender besked til PeakWMS om, at der er oprettet et produkt
3. Produktet oprettes i PeakWMS med en autogenereret SKU
4. PeakWMS sender SKU tilbage til WooCommerce

Når produktet er oprettet i PeakWMS, sendes SKU'en tilbage til WooCommerce, så den registreres på produktet.

OBS! SKU er nødvendig på alle produkter.

Besked ved afsendelse af ordre

Når du pakker en ordre i PeakWMS, så sende PeakWMS besked til din webshop om, at ordren er afsluttet, og at betalingen på ordren kan hæves. Denne besked kaldes "PickOrderPacked" i PeakWMS.

PickOrderPacked sendes som det sidste step i pakkeprocessen. Når du til sidst i pak scanner den shippinglabel, der skal sættes på pakken, så sender PeakWMS besked til WooCommerce om, at ordren er pakket, og at betalingen på ordre kan hæves.

OBS! WooCommerce står selv for at hæve betalingen. PeakWMS giver blot besked til WooCommerce om, at ordren er afsluttet, og kan færdigbehandles af WooCommerce.

Plugins

Da WooCommerce er en OpenSource platform, kan alle oprette plugins med forskellige funktioner til platformen. Her er det vigtigt, at du er opmærksom på, at der ikke er nogen sikring i, at et eller flere af dine plugins påvirker hinanden negativt. Det samme gælder for dine Plugins og PeakWMS. PeakWMS ændrer ikke på andet data, end de data, der er angivet under punktet ovenfor med "Data fra PeakWMS til WooCommerce". Dog er det muligt, at et eller flere plugins i din webshop påvirker, hvorvidt dataen registreres i din webshop.

Hos Peak Systems er vi ikke klar over, hvilke plugins, der har hvilken påvirkning. Oplever du problemer med f.eks. afsendelse af lagertal eller andet, skal du derfor være opmærksom på, at et plugin kan have betydning for funktionen.

Har du plugins i din webshop, der ikke er i brug, kan du med fordel fjerne dem fra din webshop. Husk at clear cache på webshoppen efter sletning, for at sikre, at evt. data fra pluginnet ikke fortsat ligger i webshoppen.