Dokumentasjon

Installasjon og oppsett

Denne veiledningen er ment for partnere og teknisk personell som installerer pluginen. Kontakt oss for å få tilgang til pluginen før du starter.

1. Installer pluginen

Last opp og installer Quick3 for WooCommerce-pluginen i WordPress.

1. Logg inn på WordPress og gå til admin-panelet.
2. Plugins → Legg til ny og last opp plugin-filen.
3. Aktiver pluginen etter installasjon.

2. Aktiver lisens

Legg inn lisensnøkkelen du har mottatt fra oss eller din partner.

1. Gå til Quick3 for WooCommerce → Innstillinger i WordPress-menyen.
2. Legg inn lisensnøkkelen i feltet for lisensaktivering.
3. Aktiver lisensen for å låse opp alle funksjoner.

3. Skaff Quick3 API-token

For å koble til Quick3 ERP trenger du en API-token. Denne genereres direkte fra din Quick3-konto og gir pluginen sikker tilgang til produktdata.

1. Logg inn på Quick3 med din bedriftskonto.
2. Gå til Hjem → Klientinnstillinger → Sikkerhet for å administrere API-tilgang.
3. Generer ny token og velg ApiV2 som api type. Husk å marker denne som aktiv.
4. Kopier API nøkkelen og ha den klar til neste steg.

4. Konfigurer Quick3-tilkobling

API nøkkelen skal legges inn i wp-config.php filen da denne er sikrere enn å legge den inn via admin-panelet.

Steg 1: wp-config.php

Rediger wp-config.php og legg til følgende linjer over /* That's all, stop editing! */:

// Quick3 API Configuration
define('QUICK3_TOKEN', 'din-api-token-her');

Steg 2: Via admin-panel

1. Gå til Quick3 for WooCommerce → Innstillinger i WordPress-menyen.
2. Fyll inn Base URL: Denne finner du i Quick3 ved å se på URLen. Du legger inn det som ligner på denne: https://q3.quick.no/ProdShared021
3. Lagre og test tilkoblingen for å verifisere at alt fungerer.

5. Konfigurer ordreinnstillinger

Koble WooCommerce betalingsmetoder til Quick3 betalingsbetingelser for automatisk ordresynkronisering.

1. Gå til Quick3 for WooCommerce → Innstillinger → Order Settings i WordPress-menyen.
2. Aktiver Auto-sync orders to Quick3 for automatisk ordresynkronisering.
3. Match betalingsmetoder: Match betalingsmetoden i WooCommerce med riktig konto i Quick3.
4. Velg standard konto for nye produkter: Dersom det er et produkt i WooCommerce som ikke finnes i Quick3, så må du velge en standard konto som dette skal føres mot i Quick3.
5. Lagre innstillingene når du er ferdig med konfigurasjonen.

6. Verifiser synkroniseringsjobber

Nå som alt er konfigurert, sjekk at automatiske synkroniseringsjobber kjører som forventet.

1. Gå til Quick3 for WooCommerce → Jobber for å se jobbstatus.
2. Se etter jobbkjøringer som starter automatisk basert på konfigurert intervall.
3. Klikk på en jobb for å se detaljert status og logger i sanntid.
4. Vent på "Completed" status – første synk kan ta noen minutter avhengig av produktantall.

7. Bekreft ordresynkronisering

Test at ordre synkroniseres korrekt tilbake til Quick3.

1. Gå til WooCommerce-nettbutikken og legg en testordre.
2. Fullfør betalingen og pass på at ordren har kommet til "processing".
3. Logg inn på Quick3 og verifiser at ordren vises der.
4. Sjekk detaljer – kunde-, produkt- og betalingsinformasjon skal være korrekt.

Oversikt

Quick3 for WooCommerce er en WordPress-plugin som automatisk synkroniserer produktdata mellom Quick3 ERP-systemet og WooCommerce-butikken din. Pluginen håndterer:

• ✓Automatisk produktimport fra Quick3
• ✓Automatisk oppdatering av lagerbeholdning
• ✓Prissynkronisering inkludert kampanjepriser
• ✓Produktbilder og varianter
• ✓Ordresynkronisering tilbake til Quick3
• ✓Bakgrunnsprosessering for store kataloger

Tekniske krav

For å bruke Quick3 for WooCommerce trenger du:

• •WordPress versjon 6.0 eller nyere
• •WooCommerce versjon 7.0 eller nyere
• •PHP versjon 8.1 eller nyere
• •WP-CLI installert på serveren
• •Quick3 API-tilgang med gyldig API-token

Hvordan synkronisering fungerer

Synkroniseringsflyt

Synkroniseringsprosessen følger disse stegene:

1. Henting: Produktdata hentes fra Quick3 API
2. Transformasjon: Data konverteres til WooCommerce-format
3. Matching: Eksisterende produkter matches via SKU
4. Oppdatering: Produkter opprettes eller oppdateres i WooCommerce
5. Bilder: Produktbilder lastes ned og legges til i WordPress mediebibliotek
6. Verifisering: Endringer verifiseres og logges

Hva synkroniseres?

Produktinformasjon

• •Produktnavn og beskrivelse
• •SKU (Stock Keeping Unit)
• •Strekkode (synkroniseres til GTIN-felt i WooCommerce)
• •Produktkategorier
• •Produktattributter
• •Dimensjoner og vekt

Priser

• •Vanlig pris
• •Kampanjepris (salg)
• •Prisperioder (fra/til dato)
• •MVA-håndtering

Lagerbeholdning

• •Antall på lager
• •Lagerstatus (på lager / utsolgt)

Bilder

• •Hovedproduktbilde
• •Produktgalleri
• •Variantbilder

Varianter

• •Produktvarianter (størrelser, farger, etc.)
• •Variantpriser
• •Variantlager
• •Variantattributter

Produktrelasjoner

Quick3 for WooCommerce synkroniserer automatisk produktrelasjoner fra Quick3 til WooCommerce. Disse relasjonene hjelper kundene med å oppdage relaterte produkter og øker gjennomsnittlig ordrestørrelse.

Mersalg-produkter (Alternative produkter)

Alternative produkter fra Quick3 blir mersalgsforslag i WooCommerce. Dette er toveis-relasjoner mellom hovedprodukter.

• •Quick3 'Alternative' koblingstype mappes til WooCommerce mersalg
• •Vises på produktsider som "Du kan også like..."
• •Toveis: Hvis Produkt A foreslår Produkt B, da foreslår Produkt B også Produkt A
• •Kobler alltid mellom hovedprodukter (ikke varianter)

Krysssalg-produkter (Tilbehørsprodukter)

Tilbehørsprodukter fra Quick3 blir krysssalgsforslag i WooCommerce. Dette er enveis-relasjoner.

• •Quick3 'Accessory' koblingstype mappes til WooCommerce krysssalg
• •Vises i handlekurv og kassen som komplementære produkter
• •Enveis: Produkt A kan foreslå Produkt B, men ikke omvendt
• •Kan koble til spesifikke produktvarianter eller hovedprodukter

Andre koblingstyper (Metadata)

Andre Quick3 koblingstyper lagres som strukturert metadata for fremtidig bruk:

• •Contains, Set, TransferredTo, FractionOf, Batch, EntityFee, BatchWithoutHead
• •Lagres i produkt-metafelt: _q3wc_conn_[type] og _q3wc_connections_detail
• •Tilgjengelig for egendefinerte integrasjoner og fremtidige funksjoner
• •Bevares med full kildesystemdata (priceFactor, quantityFactor, etc.)

Automatisk synkronisering

Produktkoblinger synkroniseres automatisk hvert 15. minutt via en bakgrunnsjobb. Systemet løser intelligent produktvarianter til hovedprodukter for mersalg, mens spesifikke variantkoblinger bevares for krysssalg. Bare produkter med endrede koblinger oppdateres for å opprettholde ytelsen.

Visning i WooCommerce

1. Gå til Produkter i WordPress-admin
2. Rediger et produkt som har koblinger
3. Rull til Koblede produkter-seksjonen
4. Se mersalg i "Mersalg"-feltet og krysssalg i "Krysssalg"-feltet
5. Andre koblingstyper lagres i egendefinerte felt (synlige i "Egendefinerte felt"-seksjonen)

Matching av produkter

For å unngå duplikater matcher Quick3 for WooCommerce produkter basert på SKU (Stock Keeping Unit). Hvis et produkt med samme SKU allerede eksisterer i WooCommerce, oppdateres det i stedet for å opprette et nytt produkt.

Frekvens og planlegging

Du kan konfigurere hvor ofte synkronisering skal kjøre:

• •Hver 15. minutt: Anbefalt for bedrifter med høy omsetning
• •Hver 30. minutt: Standard for de fleste butikker
• •Time: For butikker med sjeldne produktendringer
• •Hver 2. time: Minimum anbefalt frekvens
• •Manuell: Kun når du starter jobben manuelt

Synkronisering av ordre

Quick3 for WooCommerce holder ordre synkronisert mellom WooCommerce og Quick3 gjennom hele ordrelivssyklusen, fra bestilling til fullføring, returer og kanselleringer.

Nye ordre

Når en kunde fullfører en betaling i WooCommerce, synkroniseres ordren automatisk til Quick3.

• •Trigger: Betalingsleverandør markerer ordren som betalt og setter ordren i "Processing" i WooCommerce
• •Handling: En ny ordre opprettes automatisk i Quick3
• •Data: Kundeinfo, produkter, priser og betalingsdetaljer overføres

Fraktoppdateringer

Sporingsinformasjon fra Quick3 synkroniseres automatisk tilbake til WooCommerce når du legger til frakt i Quick3.

• •Fra Quick3 til WooCommerce: Sporingsnummer og fraktinformasjon
• •Kunde: Kunden får automatisk beskjed om sporingsinfo

Fullførte ordre

Når du fakturerer en ordre i Quick3, markeres ordren automatisk som fullført i WooCommerce.

• •Trigger: Du trykker "Fakturer" i Quick3
• •Handling: Ordrestatus i WooCommerce oppdateres til "Fullført"
• •Kunde: Kunden får fullføringsbekreftelse fra WooCommerce

Returer

Returer må håndteres fra WooCommerce og synkroniseres deretter automatisk til Quick3.

• •Opprett retur: Returer opprettes i WooCommerce
• •Synkronisering: Returen opprettes som en ny ordre i Quick3 med negative beløp
• •Lagerstyring: Lagerbeholdning oppdateres automatisk

Kansellering av ordre

Ordre som ikke er fakturert eller har tilhørende plukklister kan kanselleres direkte fra WooCommerce.

• •Krav: Ordren må ikke være fakturert i Quick3
• •Handling: Ordren slettes fra Quick3
• •Refundering: Tilhørende refunderingsordre slettes også

Begrensninger

På grunn av begrensninger i Quick3 API er det noen operasjoner som ikke støttes:

• •Ordreoppdateringer: Eksisterende ordre kan ikke endres etter opprettelse i Quick3
• •Årsakskoder: Quick3 API støtter ikke oppdatering av ordre via API
• •Løsning: Endringer må gjøres manuelt i Quick3

Jobsystemet

Quick3 for WooCommerce bruker et robust bakgrunnsjobsystem for å håndtere synkronisering.

Jobtyper

Jobbovervåking

Du kan overvåke synkroniseringsjobber i sanntid:

1. Gå til Quick3 for WooCommerce → Jobber
2. Se status for pågående og fullførte jobber
3. Klikk på en jobb for å se detaljert logg
4. Identifiser og løs eventuelle feil

Håndtering av feil

Hvis synkroniseringen feiler:

1. Jobben markeres med feilstatus
2. Feilmelding logges med detaljer
3. Pluginen prøver automatisk på nytt ved neste planlagte kjøring
4. Du kan manuelt kjøre jobben på nytt fra admin-panelet

Ytelse og optimalisering

Quick3 for WooCommerce er optimalisert for ytelse:

• •Bakgrunnsprosessering: Jobber kjøres i bakgrunnen uten å påvirke frontend
• •Endring-deteksjon: Kun endrede produkter oppdateres (hash-basert)
• •Database-optimalisering: Effektive spørringer med indeksering
• •Bildeoptimalisering: Bilder lastes ned asynkront

Feilsøking

Løsninger på vanlige problemer og spørsmål om Quick3 for WooCommerce.

Tilkoblingsproblemer

Får feilmelding "Invalid API token"

Løsning:

1. Dobbeltsjekk at API-token er korrekt kopiert fra Quick3
2. Sørg for at det ikke er mellomrom før eller etter token
3. Verifiser at token ikke har utløpt
4. Generer en ny token hvis nødvendig

Kan ikke koble til Quick3 API

Løsning:

1. Sjekk at Quick3 Base URL er korrekt
2. Verifiser at serveren din kan nå Quick3 API (ingen brannmur-blokkeringer)
3. Test tilkoblingen fra WordPress ved å kjøre en manuell synkronisering
4. Sjekk WordPress debug-logg for detaljerte feilmeldinger

Synkroniseringsproblemer

Produkter synkroniseres ikke

Løsning:

1. Gå til Quick3 for WooCommerce → Jobber og sjekk jobbstatus
2. Se etter feilmeldinger i jobbloggen
3. Verifiser at automatisk synkronisering er aktivert
4. Sjekk at WordPress cron kjører korrekt
5. Prøv å kjøre en manuell synkronisering ved å klikke på "Ny jobb"

Kun noen produkter blir importert

Løsning:

1. Sjekk om produktet er satt som aktivt i Quick3
2. Sjekk om produktet er satt som webaktiv i Quick3
3. Sjekk jobbloggen for advarsler om spesifikke produkter
4. Verifiser at produktene har gyldig data i Quick3
5. Kontroller at produktene har unike SKU-verdier
6. Se etter minnegrenser (PHP memory_limit) som kan stoppe store importer

Ytelsesproblemer

Synkronisering tar veldig lang tid

Løsning:

1. Store kataloger (1000+ produkter) tar naturlig lengre tid
2. Øk CPU og RAM på serveren
3. Sjekk at serveren har nok minne (minst 256MB PHP memory_limit)
4. Øk PHP max_execution_time hvis jobber timeout

Nettstedet blir saktere under synkronisering

Løsning:

1. Sjekk serverressurser (CPU, minne, disk I/O). Vurder å øke kapasiteten
2. Vurder å redusere synkroniseringsfrekvens
3. Kontakt hosting-leverandør hvis problemer vedvarer

Produktproblemer

Produkter blir duplisert

Løsning:

1. Sjekk at produktene har unike SKU-verdier i både Quick3 og WooCommerce
2. Ikke endre SKU manuelt i WooCommerce etter første import
3. Slett duplikater manuelt og kjør synkronisering på nytt
4. Kontakt support hvis problemet fortsetter

Bilder lastes ikke opp

Løsning:

1. Sjekk at WordPress har skriverettigheter til uploads-mappen
2. Verifiser at bilde-URLer fra Quick3 er tilgjengelige
3. Kontroller PHP upload_max_filesize og post_max_size innstillinger
4. Se i jobbloggen for spesifikke bildefeil

Priser er feil

Løsning:

1. Sjekk at prisene er korrekte i Quick3
2. Verifiser MVA/TAX-innstillinger i både Quick3 og WooCommerce
3. Kontroller valutainnstillinger
4. Kjør en ny synkronisering for å oppdatere priser

Jobbsystemet

Jobber blir sittende fast

Løsning:

1. Sjekk om jobben faktisk kjører (se jobblogg i admin-panelet)
2. Vent minst 15 minutter før du konkluderer med at den har stoppet
3. Kontakt support hvis jobben fortsatt står fast

Kan ikke se jobblogger

Løsning:

1. Sjekk at WordPress har skriverettigheter til loggmappen
2. Verifiser at logger ikke har blitt slettet automatisk
3. Se i WordPress debug.log for systemfeil

WordPress-spesifikke problemer

Cron-jobber kjører ikke

Løsning:

1. Sjekk at WordPress cron ikke er deaktivert i wp-config.php
2. Kontakt hosting-leverandør for å verifisere at cron fungerer korrekt
3. Vurder å sette opp system cron i stedet for WP-Cron

Plugin-konflikter

Løsning:

1. Deaktiver andre plugins midlertidig for å identifisere konflikter
2. Spesielt cache-plugins kan forstyrre synkronisering
3. Rapporter konflikter til support

Debug-modus

For å få mer detaljert informasjon om feil, aktiver WordPress debug-modus:

// I wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Logger vil bli skrevet til wp-content/debug.log.

Trenger du hjelp?

Hvis du fortsatt har problemer etter å ha prøvd løsningene ovenfor, er vi her for å hjelpe. Kontakt oss direkte eller kom i gang med oppsett ved å følge vår veiledning.