Den här guiden täcker hur du ansluter och konfigurerar Fortnox i Junipeer-appen. Den förutsätter att du redan har slutfört alla förberedelsesteg i Fortnox — om inte, börja med Förbered Fortnox för integration först.
Steg 1 — Anslut Fortnox via OAuth
Junipeer ansluter till Fortnox via OAuth. Du omdirigeras till Fortnox för att auktorisera anslutningen.
I Junipeer-appen, öppna din integration och navigera till Kom igång → Anslut system
Klicka på Fortnox-anslutningskortet
Du omdirigeras till Fortnox — logga in med den dedikerade integrationsanvändaren du skapade under förberedelserna (inte ditt personliga administratörskonto)
Godkänn anslutningen
Du omdirigeras tillbaka till Junipeer med en grön Ansluten-status
Om du hanterar flera Fortnox-företag, se till att du är inloggad på rätt konto innan du godkänner OAuth-anslutningen.
Steg 2 — Konfigurera inställningar
Navigera till Konfigurera → Inställningar i Junipeer-appen. Arbeta igenom varje avsnitt:
Valutor
Verifiera att alla valutor din webshop behandlar är aktiverade i Fortnox. Om en order anländer i en valuta som inte är aktiverad kommer synkroniseringen att misslyckas.
Du aktiverade valutor i Fortnox under förberedelserna. Om du missade några, gå tillbaka och lägg till dem innan du fortsätter.
Momskonton
Bekräfta att alla momssatser som används i din e-handelsplattform har motsvarande konton i Fortnox. Standard svenska satser (25%, 12%, 6%) är vanligtvis förkonfigurerade.
OSS-försäljningskontomappning
Om du säljer till konsumenter i andra EU-länder under OSS-systemet, mappa varje land/momssats-kombination till rätt Fortnox-försäljningskonto här: Konfigurera → Inställningar → Försäljningskontomappning & OSS-moms.
Du förberedde dessa konton i Fortnox under förberedelserna. Om du skapade ett kalkylblad med kontonummer per land är det här du anger dem.
För butiker som säljer på många EU-marknader kan detta innebära 20+ mappningar. Ta dig tid här — fel i OSS-mappningen leder till felaktig momsbokföring.
Betalningsmetoder
Mappa varje betalningsleverantör till sitt Fortnox-bokföringskonto: Konfigurera → Inställningar → Betalningsmetoder.
Du behöver också ett dedikerat avgiftskonto där betalningsleverantörens behandlingsavgifter bokförs.
Du skapade dessa konton (19xx-serien) i Fortnox under förberedelserna. Ha dina kontonummer till hands.
Artikelnummer (SKU:er)
Junipeer matchar produkter mellan din e-handelsplattform och Fortnox med hjälp av artikelnummer. Två metoder:
Samma SKU i båda systemen — ingen mappning behövs om dina e-handels-SKU:er matchar Fortnox artikelnummer exakt
Olika numrering — konfigurera mappningen under Konfigurera → Inställningar → Artikel
Leveransmetoder
Mappa varje Shopify-leveransmetod till en motsvarande post i Fortnox under Konfigurera → Inställningar → Leveransmetoder.
Omappade leveransmetoder orsakar ordersynkroniseringsfel. Om en Shopify-order använder en leveransmetod som saknar mappning i Junipeer misslyckas synkroniseringen för den ordern. Se till att alla aktiva Shopify-leveransmetoder är mappade innan du går live.
En standardleveransmetod kan ställas in som reserv för omappade metoder.
Orderuteslutningsdatum
Under Konfigurera → Inställningar → Orderinställningar kan du ange ett startdatum för ordersynkronisering. Junipeer bearbetar bara order som lagts på eller efter detta datum — detta förhindrar att hela orderhistoriken synkroniseras vid den första körningen.
Detta är särskilt användbart om du går live mitt i månaden eller har en stor eftersläpning av historiska order som du inte vill importera.
Lagermodul (lagermodul)
Om Fortnox lagermodul är aktiv på ditt konto måste du konfigurera leveranstidsinställningen korrekt — annars kan ditt lagerteam inte se och bearbeta inkommande order som förväntat.
Navigera till Konfigurera → Inställningar → Fakturainställningar och ställ in "Ange leverans när order skapas" till Reservation.
Varför Reservation? Att ställa in leverans till Reservation innebär att en order som anländer från Shopify omedelbart är synlig i Fortnox lager med reserverat lager, men ännu inte markerad som packad eller plockad. Ditt lagerteam kan sedan arbeta igenom ordern — skriva ut plocklistor, packa och uppfylla — innan leveransen bekräftas. Att ställa in detta felaktigt (t.ex. till Leverans) gör att ordern behandlas som redan uppfylld vid ankomst, vilket kringgår ditt lagerarbetsflöde.
Om du inte använder Fortnox lagermodul kan du lämna denna inställning på standardvärdet.
B2B och B2C i samma integration
Om din Shopify-butik betjänar både företagskunder (B2B) och konsumenter (B2C), kan Junipeer hantera båda flödena inom samma integration — men konfigurationen skiljer sig beroende på ordertyp:
B2C-order — betalda via Shopify Payments eller en PSP (Svea, Qliro, etc.), bearbetade och uppfyllda i Shopify
B2B-order — vanligtvis fakturerade med betalningsvillkor (t.ex. 30 dagar), bearbetade och uppfyllda i Fortnox
Separationen hanteras via betalningsmetodmappning i Konfigurera → Inställningar → Betalningsmetoder. B2B-order med fakturabetalningsvillkor anländer med ett specifikt betalningsmetodnamn (t.ex. "Faktura") — mappa detta till rätt Fortnox-konto så att det dirigeras korrekt.
Tips: Om du använder Shopifys inbyggda B2B-funktion kan Junipeer använda fältet Företagets externa ID i Shopify för att mappa ett B2B-företag direkt till sin motsvarighet i Fortnox. Detta ger dig en stabil, en-till-en-företagsmappning. Om Företagets externa ID inte är inställt faller Junipeer tillbaka på momsregistreringsnummer, organisationsnummer eller e-post — vilket är mindre tillförlitligt. Vi rekommenderar att använda Shopifys inbyggda B2B framför tredjepartsappar (som BSS), eftersom tredjepartsappar kan orsaka att ofullständig orderdata når Junipeer.
Flera Shopify-butiker anslutna till en Fortnox
Om du driver flera Shopify-butiker (t.ex. olika varumärken) som delar ett enda Fortnox-konto kan Junipeer ansluta varje butik som en separat integration — alla pekar på samma Fortnox.
För att hålla order från olika butiker identifierbara i Fortnox rekommenderar vi att aktivera Fortnox Projekt och skapa ett projekt per butik (t.ex. butiksnamn-web). Junipeer kan sedan tagga varje inkommande order med motsvarande projekt, vilket gör det enkelt att filtrera per varumärke i Fortnox och spåra intäkter och kostnader per butik.
Innan du aktiverar Fortnox Projekt, bekräfta med din revisor eller redovisningsbyrå att projektredovisning är lämpligt för din konfiguration. Att aktivera projektspårning påverkar hur transaktioner rapporteras.
För att aktivera projekt i Fortnox: gå till Inställningar → Företagsinställningar och aktivera projektredovisningsmodulen. Skapa sedan ett projekt per butik och dela projektnamnen med din Junipeer-onboardingkontakt för mappning.
Steg 3 — Testa integrationen
Innan du går live, kör minst en testsynkronisering:
Skapa en testorder i din e-handelsplattform
Ange order-ID i Junipeer-testpanelen
Verifiera resultatet i Fortnox — kontrollera att fakturan skapades korrekt, att momsen tillämpas som förväntat och att betalningsmetoden bokförs på rätt konto
Om ett test misslyckas, kontrollera Loggar i Junipeer för felet. De vanligaste orsakerna är saknade artikelnummer, ett felaktigt momskonto eller en valuta som inte är aktiverad i Fortnox.
Steg 4 — Starta synkronisering
När testningen är klar, konfigurera ditt synkroniseringsschema under Kom igång → Starta synkronisering. Detta är ditt live-steg.
Kör en testsynkronisering med en enda order innan du aktiverar schemaläggning. Det är mycket lättare att fånga upp mappningsfel i förväg än efter att bulksynkronisering har startat.
Kända begränsningar
Lagermodul — se avsnittet Lagermodul ovan för den nödvändiga konfigurationen. Att hoppa över leveranstidsinställningen är den vanligaste orsaken till problem med lagerarbetsflödet.
Bokförd fakturas oföränderlighet — när en faktura är bokförd i Fortnox kan den inte redigeras eller tas bort. Korrigeringar kräver en kreditnota. Detta är standard Fortnox-beteende.
Ordernummerformat — det ursprungliga e-handelsordenumret lagras i ett referensfält i Fortnox. Du kan slå upp mappningen på sidan Referenser i Junipeer.
För felsökning, se referensen Felkoder eller kontakta support@junipeer.io.