Installation

Krav

• Craft CMS 5.3 eller senare
• Craft Commerce 5.0 eller senare
• PHP 8.2 eller senare
• Ett Fortnox-konto med API-licens

Det sista är inte samma sak som en Fortnox-prenumeration. Om kontot inte får använda API:et svarar Fortnox på varje anrop med fel 2001103, och Knox rapporterar det med de orden i stället för som ett allmänt fel.

Installera

composer require justinholtweb/craft-knox
php craft plugin/install knox

Eller sök upp Knox i Crafts plugin-butik och installera därifrån.

Registrera en integration

Knox pratar med Fortnox som din integration, inte som en delad. Uppgifterna är alltså dina.

1. Gå till apps.fortnox.se/developer och skapa en integration.
2. Notera dess Client ID och Client Secret.

3. Lägg dem i din .env:

   FORTNOX_CLIENT_ID="ditt-client-id"
   FORTNOX_CLIENT_SECRET="din-client-secret"
   

4. Öppna Inställningar → Plugins → Knox i Craft och sätt de två fälten till $FORTNOX_CLIENT_ID och $FORTNOX_CLIENT_SECRET. Spara.

Registrera redirect-URI:n

Knox visar en Redirect-URI i inställningarna. Kopiera in den i din Fortnox-integration exakt, tecken för tecken — Fortnox jämför den som en sträng, och ett avslutande snedstreck gör den till en annan URI.

Ligger sajten bakom en proxy, eller svarar den på ett annat publikt värdnamn än Craft tror, sätt Redirect URI override i stället för att slåss med miljön.

Välj behörigheter, sedan anslut

Det här steget är värt att sakta ner för.

Fortnox låser behörighetsuppsättningen i samma stund som du godkänner integrationen. Att lägga till en behörighet i Knox inställningar efteråt gör ingenting alls för ett konto som redan är anslutet — du måste ansluta på nytt. Knox läser tillbaka vad som faktiskt beviljades och varnar i inställningarna när de två inte stämmer, men det är enklare att göra rätt från början.

Knox begär alltid invoice, customer och companyinformation. Lägg till settings, payment och bookkeeping om du inte vet med dig att du varken vill ha betalningar eller bokförda fakturor.

Tryck sedan på Anslut till Fortnox och godkänn.

Två kontroller före första ordern

Båda är knappar i inställningarna, och båda tar en sekund.

Läs av från Fortnox, under Öresavrundning. Knox läser företagets senaste fakturor och räknar ut om öresutjämning är påslaget. Läs vad det står — det är den vanligaste enskilda orsaken till att en Fortnox-integrations fakturor tyst slutar stämma med betalningarna. Se Öresavrundning.

Kontrollera att kontona finns i Fortnox, under Konton. En fakturarad som bokförs mot ett konto som inte finns i din kontoplan avvisas av Fortnox. Att få veta det nu är bättre än att få veta det på order 200.

Sätt en kund

Fortnox kräver en befintlig kund på varje faktura — det finns ingen faktura utan kund. Så antingen:

• sätt ett samlingskundnummer (den ”Webbkund” de flesta butiker redan har), eller
• slå på Synka kunder, som ger varje köpare en egen post.

Valet handlar inte bara om ordning och reda. Fortnox lagrar momstypen på kunden, så omvänd betalningsskyldighet och export kräver riktiga kundposter. Se Moms.

Repetera

Innan du släpper lös det på skarpa ordrar:

php craft knox/sync/backfill --dry --limit=10

Det skriver ut vad varje ofakturerad order skulle faktureras till, vilken momshantering Knox valde och varför, och vilka ordrar den skulle neka och av vilken anledning. Ingenting skickas.

Vad det kostar

Knox kostar 99 USD engångs med en förnyelse på 79 USD/år. En enda utgåva — allt nedan ingår.

Fakturor från slutförda ordrar	✅
Öresavrundning modellerad, avläst och förklarad	✅
Avstämningsspärr — nekar en faktura som inte stämmer med ordern	✅
Kontroll av totalsumman Fortnox svarar med, efter varje skapande	✅
Gör aldrig om ett anrop vars utfall är okänt	✅
BAS-kontomappning, verifierad mot din kontoplan	✅
Svensk moms, omvänd betalningsskyldighet, OSS och export	✅
Fortnox-kunder skapas och återanvänds per köpare	✅
Bokföring, med förhandskontroll av räkenskapsår	✅
Registrera betalningen kassan redan tagit	✅
Läs av vilka fakturor som betalats i Fortnox	✅
Kreditfakturor vid återbetalning	✅
Artikelmatchning på artikelnummer	✅
Fakturanedladdning för kunden	✅
Orderpanel, fakturalista och PDF i kontrollpanelen	✅
Anslutningslogg med anrop och svar	✅
Backfill, förhandsgranskning och avstämning från konsolen	✅
Utlösare på orderstatus i stället för slutförande	✅

Förnyelsen betalar för uppdateringar och support; pluginet fortsätter fungera om du låter den löpa ut.