WooCommerce Utvikler i Bergen

En WooCommerce-butikk som selger til norske kunder må håndtere tre ting som ikke står i standarddokumentasjonen til Woo: Vipps i kassen, MVA på 25 prosent regnet riktig, og frakt via Posten/Bring eller PostNord med sporing kunden faktisk forventer. Vi bygger og rydder opp i WooCommerce for bedrifter i Bergen med utgangspunkt i nettopp disse kravene, ikke en generisk mal som siden lokaliseres med bynavn.

Bergen er Norges nest største by og knutepunkt for Vestland. Her møtes maritim næring, turisme og hotell, havbruksnære leverandører og et forskningsmiljø knyttet til Universitetet i Bergen. En nettbutikk som skal overleve her, må tåle sesongtopper, B2B-ordrer med organisasjonsnummer og en kasse som ikke faller fra hverandre når trafikken kommer i bølger.

#WooCommerce-utvikling i Bergen

Bergen-markedet er praktisk. Norske netthandlere er vant til kjappe kasser, Vipps-knapp øverst, fri retur innen angrefristen og tydelig pris med MVA inkludert. Arbeidet vårt handler om å få WooCommerce til å oppføre seg slik en norsk kunde forventer, og å gjøre det på en måte som overlever oppdateringer av Woo, temaet og betalingstilleggene - også når butikken drives fra Bryggen, Åsane eller et lager ute i Vestland.

#Hva vi faktisk bygger

• Vipps MobilePay i kassen: hurtigkasse-knapp på produkt- og handlekurvside, login med Vipps der det gir mening, gjentakende betaling for abonnement, og test av webhooks for autorisasjon, belastning, refusjon og delvis refusjon mot testmiljø
• Klarna og kort (via Nets/Nexi eller Stripe) ved siden av Vipps, med riktig rekkefølge i kassen for norsk trafikk og testkort-matrise per gateway
• MVA-oppsett for norsk handel: 25 prosent standardsats, redusert sats på næringsmidler, fritak der det gjelder, og priser vist inkludert MVA slik norske forbrukere forventer
• VOEC-håndtering for butikker som selger fra utlandet inn til Norge: MVA krevd inn ved salg på varer under 3 000 kroner, riktig merking mot tollbehandling, og logikk rundt terskelen på 50 000 kroner i årlig omsetning
• Frakt med Posten/Bring og PostNord: fraktsoner, prisregler basert på vekt og volum, hentested/pakkeboks som leveringsvalg, og fraktsedler/sporing koblet mot ordrebehandlingen
• Angrerett bygget inn i flyten: retur- og angreskjema, riktig informasjon i ordrebekreftelse og e-post, slik at den lovpålagte 14-dagersfristen ikke blir en manuell jobb for kundeservice
• Utvidelser av WooCommerce REST API for hodeløs storefront, mobilapp eller POS, med autentisering og idempotente betalingsstier

#Hvorfor norske betalings- og fraktvalg styrer arkitekturen

I de fleste WooCommerce-prosjekter for Bergen er det ikke produktkatalogen som er vanskelig, det er kassen. Vipps oppfører seg ikke som et vanlig kortgateway: redirect-flyten, app-switchen på mobil og webhook-bekreftelsen krever at ordrestatus ikke settes til betalt før Vipps faktisk har bekreftet. Vi har sett butikker der ordrer ble markert fullført på redirect tilbake, ikke på webhook, slik at avbrutte Vipps-betalinger ga ordrer uten penger. Den typen feil fanges bare med ende-til-ende-QA på selve betalingsstien.

Frakt er den andre fellen. En norsk kunde forventer å velge hentested hos Posten eller en Bring-pakkeboks i kassen, ikke bare «standard frakt». Når dette mangler, faller konverteringen på mobil - spesielt blant turister og tilreisende som handler fra hotellnett. Vi setter opp fraktsonene og leveringsvalgene som hører til det norske markedet, og kobler dem mot sporing kunden ser i e-posten.

#Markedet og miljøet i Bergen

Bergen er preget av maritime klynger rundt skipsfart, offshore-tjenester og leverandørindustri, av turisme og hotell rundt Bryggen, Fløibanen og cruiseanløp, og av havbruksnære B2B-aktører som selger utstyr, reservedeler og arbeidsklær langs kysten. Universitetet i Bergen og forskningsmiljøene rundt gir i tillegg et miljø for kunnskapsbedrifter, kursmateriell og nisjehandel.

For en nettbutikk betyr dette tre belastningsmønstre: sesongtopper fra turisme (ofte mobil, Vipps eller kort, henting i pakkeboks), maritime og havbruksnære B2B-ordrer med organisasjonsnummer, faktura og delvise leveranser, og driftskontinuitet når regn og bemanning presser lager og kundeservice. Butikken må ha stabile bakgrunnsjobber, tydelige feillogger og en kasse som ikke står og venter på et treigt frakt-API.

Kundene vi hjelper i Bergen spenner fra nisjebutikker som selger direkte til forbruker, til etablerte merkevarer og B2B-leverandører som flytter fra en lukket plattform over til WooCommerce for å eie egen kode. Fellesnevneren er at de trenger en butikk som tar Vipps på alvor, regner MVA riktig og lar dem styre frakten selv.

Mange av disse butikkene har vokst organisk over flere år: et tema fra en kjøpt mal, et halvt dusin tillegg som overlapper, og en kasse som er lappet sammen i takt med at nye krav dukket opp. Det fungerer helt til sesongen treffer, et betalingstillegg slutter å bli vedlikeholdt, eller MVA-reglene endrer seg. Da er det ikke en ny plugin som trengs, men en opprydding i arkitekturen: skille ut egen kode i en egen plugin, fjerne tillegg som dupliserer hverandre, og gjøre kassen forutsigbar igjen. Vi tar denne typen refaktorering uten å bygge alt på nytt, så lenge WooCommerce er riktig plattform for det butikken skal gjøre. Er det ikke det, sier vi det skriftlig.

#Slik jobber vi gjennom et prosjekt

1. Kasse- og katalogrevisjon. Vi går gjennom dagens WooCommerce-butikk: produkttaksonomi, kasseflyt, aktive betalingstillegg (Vipps, Klarna, Nets, Stripe), fraktsoner mot Posten/Bring, MVA-regler og Lighthouse-måling på de mest besøkte produkt- og kategorisidene - inkludert sider som faktisk bærer sesongtrafikk.
2. Plan for betaling, frakt og integrasjon. Vi dokumenterer gateway-valg og rekkefølge i kassen, fraktsoner og hentestedslogikk, MVA- og VOEC-håndtering, og koblinger mot regnskap, lager eller fulfilment. Grensen mellom Woo-kjerne, egen plugin og temakode settes her.
3. Bygging i feature-brancher. Vi følger kodestandardene til WordPress og WooCommerce, utvider Woo via action- og filter-hooks i stedet for å endre kjernen, og tester betalings- og ordrestier underveis.
4. QA på ordrestien. Handlekurv, kasse, betaling med testkort og test-Vipps på hver gateway, refusjon og delvis refusjon, retur etter angrerett, kunde-e-post og admin-redigering, kjørt i et testmiljø som speiler produksjon.
5. Utrulling og overlevering. Vi deployer via en dokumentert release-prosess med testet tilbakeføring, og leverer runbook for hver gateway og hver integrasjon sammen med dokumentasjon for butikkstyrere og redaktører.

#Typiske oppdrag fra Bergen-butikker

• Vipps mangler eller er feilkoblet. En butikk markerte ordrer betalt på redirect i stedet for på webhook. Vi flyttet bekreftelsen til webhooken, la inn idempotens slik at dobbel webhook ikke ga dobbel ordre, og satte opp full testmatrise for autorisasjon, belastning og refusjon.
• Treg kasse under sesongtopp. En butikk med tungt tema og mange aktive tillegg hadde flere sekunders forsinkelse før Vipps-knappen var klikkbar - merkbart når cruiseuker og sommertrafikk traff. Vi startet med Lighthouse, WP-CLI-profil og Query Monitor på kassesiden, fant cart-fragment-kallene og autoloadede options som var skyld i mesteparten, og fjernet flaskehalsene én etter én i stedet for å installere enda et caching-tillegg.
• MVA og VOEC regnet feil. En butikk som solgte både innenlands og inn til Norge fra utlandet blandet sammen vanlig norsk MVA og VOEC-reglene. Vi skilte de to flytene, satte riktig sats per produktgruppe og fikk varer under 3 000 kroner merket riktig mot tollbehandling.

#Tekniske standarder

Vi kjører WooCommerce på PHP 8.2 eller nyere, med object caching (Redis) der trafikken forsvarer det, og CDN foran statiske ressurser. Betaling går via Vipps MobilePay, Klarna og kort (Nets/Nexi eller Stripe) avhengig av hva butikken trenger, alltid med 3D Secure på kort. Tunge jobber, som synkronisering mot lager eller regnskap, kjøres via Action Scheduler i bakgrunnen slik at de ikke blokkerer kassen.

#Hva du kan forvente etter lansering

Vi lover ikke faste prosenttall, fordi resultatet avhenger av utgangspunktet. Det vi leverer er en kasse som tar Vipps på alvor og bekrefter ordrer på webhook, ikke på redirect, fraktvalg som matcher det norske kunder forventer fra Posten og Bring, MVA og angrerett håndtert i selve flyten i stedet for manuelt, og en målbar forbedring i Core Web Vitals på de sidene som faktisk konverterer. Måltallene settes mot dagens nivå i revisjonen, ikke mot oppdiktede bransjegjennomsnitt.

#Sikkerhet og personvern

Hvert prosjekt får en sikkerhetsgrunnlinje: HTTPS med HSTS, Content Security Policy mot XSS, sårbarhetsskanning av avhengigheter i CI, tofaktor for administratorkontoer og testede sikkerhetskopier. Butikker som håndterer personopplysninger får GDPR-tilpasset samtykkehåndtering, databehandleravtale og personvern bygget inn i arkitekturen. For norske nettbutikker betyr det i praksis også at kundedata fra Vipps- og kortbetalinger, samt navn og adresse for frakt, behandles og lagres slik regelverket krever.

#Ytelse, målt der det teller

Core Web Vitals påvirker både rangering og konvertering, og på en nettbutikk er det kasse-, produkt- og kategorisidene som betyr noe. Vi jobber mot lav LCP gjennom optimalisert kritisk renderingsvei og forhåndsinnlasting av hero-bilder i moderne format (WebP/AVIF), lav INP gjennom minimal JavaScript og utsatt innlasting av tredjepartsskript (inkludert betalingsskript), og stabil layout (lav CLS) gjennom faste bildedimensjoner og reservert plass for dynamisk innhold som Vipps-knappen. Vi måler kontinuerlig med Lighthouse i utrullingsløpet, slik at en regresjon blokkerer distribusjon i stedet for å nå produksjon.

#Spørsmål Bergen-butikker stiller oss

Setter dere opp Vipps MobilePay i kassen? Ja. Vi integrerer hurtigkasse-knapp, login og gjentakende betaling der det passer, og tester autorisasjon, belastning, refusjon og delvis refusjon mot testmiljø før lansering. Bekreftelse av betaling skjer på webhook, ikke på redirect tilbake til butikken.

Kan dere håndtere MVA og VOEC riktig? Ja. Vi setter 25 prosent standardsats og reduserte satser der de gjelder, viser priser inkludert MVA slik norske forbrukere forventer, og skiller VOEC-flyten for varer under 3 000 kroner solgt fra utlandet inn til Norge fra ordinær innenlands MVA.

Hvilke fraktløsninger støtter dere? Posten/Bring og PostNord, med fraktsoner, prisregler etter vekt og volum, hentested og pakkeboks som leveringsvalg, og fraktsedler og sporing koblet mot ordrebehandlingen.

Endrer dere WooCommerce-kjernen? Nei. Tilpasninger går via dokumenterte action- og filter-hooks, med en klar deling mellom egen plugin og tema, slik at butikken overlever Woo-oppdateringer.

Jobber dere med butikker utenfor Bergen? Ja. Vi har tyngdepunktet i Bergen og Vestland, men leverer til netthandlere i hele Norge og til norske butikker drevet fra utlandet.

#Integrasjoner en norsk nettbutikk faktisk trenger

En norsk nettbutikk på WooCommerce ender som regel opp med de samme fire koblingene: betaling med Vipps MobilePay og kort, frakt med Posten/Bring eller PostNord inkludert hentesteder, regnskap i Fiken eller Tripletex, og en ordrestatus som settes av serveren til leverandøren, ikke av at kunden tilfeldigvis kommer tilbake til takkesiden. Rekkefølgen er ikke tilfeldig: hver kobling nedover i listen arver feilene fra den over hvis den første ikke er riktig bygget.

#Betaling: Vipps MobilePay ved siden av kort

Vipps er en app-switch, ikke et skjema. Integrasjonen bygges mot ePayment-API-et for engangskjøp og mot avtale-API-et for gjentakende trekk. Butikken oppretter en betaling, sender kunden til appen og venter. Alt som skjer etterpå er utenfor nettleserens kontroll. Derfor implementeres gatewayen som en vanlig WC_Payment_Gateway-klasse der process_payment returnerer en redirect og ingenting mer, mens fullføringen skjer i callback-håndtereren. Ordren får payment_complete først når leverandøren har bekreftet.

Reserver nå, trekk ved forsendelse. Norsk praksis for varesalg er å reservere beløpet ved kjøp og trekke det når varen sendes. Det betyr at integrasjonen må skille tydelig mellom autorisasjon, belastning, delvis belastning, annullering og refusjon, og at hver av disse må kunne utløses både fra Woo-admin og fra en bakgrunnsjobb. Delvis belastning er en vanlig kilde til avvik når en ordre sendes i to forsendelser - typisk for B2B-ordrer med reservedeler eller blandet lagerstatus.

Kort går ved siden av, ikke i stedet for. Nets/Nexi eller Stripe dekker kunder som ikke bruker Vipps, alltid med 3D Secure. To gatewayer betyr to sett med statuskoder, to refusjonsmodeller og to webhook-formater, så ordren må lagre i metadata hvilken gateway som eide betalingen og hvilken referanse den bruker. Uten dette blir refusjon fra admin et gjettespill. Klarna brukes der butikken trenger faktura eller delbetaling for forbrukere, med egen testmatrise og tydelig plassering i kassen etter Vipps.

HPOS må deklareres. På butikker med High-Performance Order Storage må egen plugin-kode melde kompatibilitet via FeaturesUtil::declare_compatibility på before_woocommerce_init, og all lesing og skriving av ordredata må gå gjennom wc_get_order og CRUD-metodene i stedet for direkte postmeta-kall. Gammel gateway-kode som skriver med update_post_meta slutter å virke uten å gi feilmelding.

#Frakt: Bring, Posten og PostNord med hentesteder

Fraktpriser hentes, de gjettes ikke. Bring Shipping Guide gir pris og leveringstid per produkt og postnummer, autentisert med API-nøkkel og kundenummer fra Mybring. Svaret kobles inn i kassen via woocommerce_package_rates, med volumvekt regnet ut fra pakkens dimensjoner der den overstiger faktisk vekt. Svarene mellomlagres i transienter per postnummer og vektklasse, fordi kassen ikke kan vente på et eksternt kall ved hver oppdatering av handlekurven.

Hentested er et eget datafelt. Kunden velger et konkret utleveringssted eller en pakkeboks i kassen, og valget må lagres på ordren som en identifikator fra leverandøren, ikke som fritekst. Fraktsedlene genereres senere mot den identifikatoren. Skrives den som en adresse i et notatfelt, må lageret slå den opp manuelt, og fordelen ved integrasjonen forsvinner. I Bergen er hentested ofte det mest praktiske valget for både lokalbefolkning og tilreisende.

Tidsavbrudd krever en reserveløsning. Når frakt-API-et ikke svarer, skal kassen falle tilbake til en definert standardsats i stedet for å vise en kasse uten fraktvalg. Feilen logges via wc_get_logger med egen kilde, slik at hyppige tidsavbrudd blir synlige i WooCommerce-loggen før kundeservice oppdager dem. Under høysesong er dette forskjellen mellom en treg kasse og en stengt kasse.

Sporing hører hjemme i e-posten. Sporingsnummeret lagres på ordren og skrives inn i forsendelsesvarselet, typisk via woocommerce_email_before_order_table. Det fjerner en av de vanligste henvendelsene til kundeservice.

#Regnskap: Fiken eller Tripletex

Salget bokføres én gang, med riktig MVA-kode. Både Fiken og Tripletex har REST-API med token-basert autentisering. Integrasjonen oppretter kunde og salgsdokument, og mapper hver produktgruppe til riktig MVA-kode i stedet for å sende en flat sats. Nummeret på det opprettede dokumentet skrives tilbake på ordren, og eksistensen av dette nummeret er det som hindrer dobbeltbokføring ved en ny kjøring.

Avstemming er mot utbetaling, ikke mot ordre. Betalingsleverandøren utbetaler samlet og trekker gebyr. Regnskapet stemmer først når integrasjonen bokfører utbetalingen som en egen post med gebyret skilt ut, ikke når hver ordre er bokført hver for seg.

B2B og offentlig sektor betyr EHF. Selger butikken til offentlige oppdragsgivere eller til maritime og havbruksnære virksomheter som krever strukturert faktura, skal fakturaen kunne sendes som EHF over Peppol, med organisasjonsnummer på mottakeren. Det er en egen flyt i kassen: felt for organisasjonsnummer, validering, og et annet dokumentløp enn forbrukersalget.

Oppbevaringsplikt og SAF-T. Bokføringspliktig dokumentasjon skal oppbevares i fem år etter regnskapsårets slutt, og regnskapssystemet må kunne levere SAF-T Regnskap på forespørsel fra Skatteetaten. I praksis betyr det at butikken ikke er regnskapssystemet: WooCommerce er kilden, Fiken eller Tripletex er arkivet, og integrasjonen må overføre nok informasjon til at arkivet er komplett uten oppslag i databasen til nettbutikken.

Synkronisering kjøres i kø. All overføring til regnskap legges på Action Scheduler med gjentatte forsøk ved feil, aldri synkront i kasseforespørselen. En regnskapstjeneste som er nede, skal forsinke bokføringen, ikke blokkere et kjøp.

#Hvorfor ordrestatus må settes server-til-server

Takkesiden er et løfte, ikke et bevis. Kunden kan miste dekning på Bybanen, lukke appen, bytte til en annen app mens betalingen fullføres, eller ha nettleseren i bakgrunnen når batteriet sparer strøm. Redirect tilbake til butikken er dermed en hendelse som kanskje skjer. Betalingsbekreftelsen fra leverandørens server er en hendelse som skjer uansett, og det er den ordrestatusen skal henge på.

Verifiser først, kvitter raskt, jobb etterpå. Callback-endepunktet skal først verifisere signaturen på varselet mot delt hemmelighet, deretter svare med en rask kvittering, og først etterpå gjøre det tunge arbeidet i en bakgrunnsjobb. Leverandører prøver på nytt når svaret drøyer, og et tregt endepunkt utløser dermed flere kopier av det samme varselet.

Idempotens lagres, den antas ikke. Hvert varsel har en identifikator. Den lagres når hendelsen er behandlet, og et varsel med en allerede lagret identifikator forkastes. Uten dette gir gjentatte forsøk dobbel belastning, dobbel bokføring i regnskapet og dobbelt kunde-e-post. Hendelser kan også komme i feil rekkefølge, så håndtereren må tåle en belastningsmelding som kommer før autorisasjonsmeldingen.

Endepunktet må være åpent for maskiner. Callback-URL-en skal holdes utenfor sidecache, ikke stå bak passordbeskyttelse eller IP-sperre, og ikke ligge på et testmiljø som krever innlogging. Dette er en vanlig årsak til at en integrasjon virker i testmiljø og ikke i produksjon.

Avstemmingsjobben er sikkerhetsnettet. En planlagt jobb henter status fra leverandøren for ordrer som har blitt stående som ventende lenger enn et definert vindu, og retter opp der varselet aldri kom fram. Jobben kjøres via ekte systemcron mot wp cron event run --due-now med DISABLE_WP_CRON satt, fordi WordPress’ egen pseudo-cron avhenger av trafikk og dermed er upålitelig når butikken er stille om natten.

Testing gjøres på feilstiene. Testmatrisen dekker ikke bare vellykket betaling, men avbrutt betaling i appen, varsel som kommer to ganger, varsel som kommer i feil rekkefølge, forsinket varsel, frakt-API som svarer for sent, og regnskaps-API som avviser dokumentet. Hver av disse skal ende i en ordre med riktig status og en linje i loggen. Reaksjonstider ved feil i drift avtales skriftlig i vedlikeholdsavtalen.

#Andre norske byer

Trenger du WooCommerce-hjelp i en annen norsk by, gjelder de samme norske kravene til Vipps, MVA og frakt, men med lokal logistikk og kundemønster. Se også WooCommerce-utvikler i Stavanger og WooCommerce-utvikler i Trondheim for hvordan oppsettet tilpasses der.

#Start et WooCommerce-prosjekt i Bergen

Trenger butikken din i Bergen en kasse som tar Vipps på alvor, regner MVA riktig og lar deg styre frakten selv, ta kontakt for en uforpliktende gjennomgang. Vi ser på dagens oppsett, peker på den faktiske flaskehalsen og gir en ærlig vurdering av hva som bør gjøres først - også før neste turisme- eller kampanjetopp. Prisen settes individuelt etter omfang, og du får oversikten skriftlig før arbeidet starter.