Den här guiden riktar sig till butiks- och ekonomipersonal som kopplar Klarna till Fortnox med Junipeer. Den beskriver vad integrationen gör, var Klarnas inloggningsuppgifter ska anges, hur utbetalningar bokförs och matchas mot fakturor samt vad du ska kontrollera innan du går live.
Börja med den allmänna guiden för betalleverantörer: Connecting payment services to Junipeer. Den här guiden tar bara upp det som är specifikt för Klarna och Fortnox.
Vad integrationen gör
Integrationen Klarna ↔ Fortnox har ett flöde: Export Payouts to Fortnox. Det hämtar dina avräkningar från Klarna, hittar matchande fakturor i Fortnox, registrerar betalningarna och bokför Klarnas avgifter.
Den skapar inte ordrar, fakturor eller kreditfakturor. Dessa måste redan finnas i Fortnox – vanligtvis skapade av din integration mellan webbutiken och Fortnox. Därför är referensinställningarna nedan så viktiga: den här integrationen måste hitta fakturor som en annan integration har skapat.
Inloggningsuppgifter
Gå till Get Started → Connect Systems. Anslut Fortnox först (du godkänner anslutningen i Fortnox) och ange sedan uppgifterna för Klarnas settlements-API:
Inställning | Vad du anger |
|---|---|
Klarna settlements API Url | Adressen till Klarnas settlements-API. Vanligtvis |
Klarna API user/id | Användarnamnet eller ID:t för Klarnas settlements-API. |
Klarna API password or secret | Lösenordet eller hemligheten som hör till användaren/ID:t. Det döljs när du har sparat. |
Alla tre uppgifter är obligatoriska. När båda systemen visar en grön bock kan du börja konfigurera.
Bokföring av utbetalningar: Booking Accounting Settings for Settlements
Gå till Configure → Settings och öppna Booking Accounting Settings for Settlements. Lägg till Klarna som betalleverantör och fyll i:
Inställning | Vad du anger |
|---|---|
Payment Method | Det betalsätt i Fortnox som Klarnas utbetalningar bokförs mot. Listan hämtas från Fortnox – om Klarna saknas skapar du det först i Fortnox och klickar sedan på Clear Cache på inställningssidan. Obligatoriskt. |
Map Currency with Mode of Payment (if different than (default) Payment Method above) | Valfritt. Använd endast om utbetalningar i en viss valuta ska använda ett annat betalsätt. Valutor som du inte mappar använder Payment Method ovan. |
Account Number Bank Costs | Kontot för Klarnas avgift exklusive moms. Ofta 6570. Obligatoriskt. |
VAT account for provider fees | Där momsen på Klarnas avgifter bokförs. Detta är ingående moms som du kan dra av. Används endast när Klarna redovisar moms på en avgift. Obligatoriskt. |
Account Number for Incoming Tax | Används endast när utbetalningen inte kommer från Sverige. Lämna tomt för svenska betalningar. |
Account Number for Penny rounding | Små differenser mellan fakturabeloppet och det betalda beloppet. Ofta 3740. Obligatoriskt. |
Account Number for Currency Profit / Account Number for Currency Loss | Små differenser som uppstår vid valutaomräkning. Ofta 3960 och 7960. Lämna tomma för att i stället bokföra dessa på kontot för öresavrundning. |
Kontonumren ovan är vanliga svenska värden, inte regler. Stäm av varje konto med den som sköter din bokföring innan du sparar. Klicka på ? bredvid varje inställning för mer information.
Utan det här avsnittet kan utbetalningar inte bokföras i Fortnox.
Så matchas utbetalningar mot fakturor
Så stäms en utbetalning av
Från kundens betalning till rätt konto i ditt affärssystem.
Matchningen bygger på referensen som sparades på ordern eller fakturan när ordern synkades. Saknas referensen kan utbetalningen inte matchas.
Varje avräkning från Klarna listar de betalningar den innehåller. För varje betalning jämför Junipeer en referens från avräkningen med ett fält på fakturan eller ordern i Fortnox. Båda sidor måste innehålla samma värde.
Dessa inställningar finns under General Settings:
Inställning | Vad den gör |
|---|---|
Payout Reference Field | Vilket fält i Fortnox som innehåller referensen – vanligtvis där butikens order-ID eller betalorder-ID lagras. Obligatoriskt. |
Fallback Payout Reference Field | Ett andra fält att söka i om referensen inte hittas i det första. Valfritt. |
Use Payment ID as Payout Reference | Om sökningen ska göras med handlarreferensen eller med Payment ID (vanligtvis Klarnas Order ID). |
Search for the Payout Reference on the Order | Yes söker på ordern i Fortnox och hittar sedan dess faktura. No söker direkt på fakturan. |
Book keep invoice payment | Bokför betalningen i Fortnox. Aktiverat som standard och krävs om fakturor ska markeras som betalda automatiskt. |
Fortnox erbjuder följande fält:
DocumentNumber (ID-nummer)
ExternalInvoiceReference1 (extern fakturareferens 1)
ExternalInvoiceReference2 (extern fakturareferens 2)
OurReference (används sällan)
YourOrderNumber (endast på fakturor – kan inte användas för att söka efter ordrar)
Use Payment ID as Payout Reference styr vilken referens från utbetalningen som Junipeer söker efter:
No, use payment (merchant) reference (standard)
Ja, använd betalnings-ID (order-ID)
Use Payment (order) ID, then (merchant) Reference om den inte hittas
Use (merchant) Reference, then Payment (order) ID om den inte hittas
Anpassa efter din orderintegration
Eftersom ordrarna kommer från en annan integration måste båda integrationerna använda samma fält i Fortnox för orderreferensen. Exempel: om din webbutiksintegration skriver ordernumret till ExternalInvoiceReference1 ställer du in Payout Reference Field på ExternalInvoiceReference1 och behåller Use Payment ID as Payout Reference på handlarreferensen.
Så här kontrollerar du:
Öppna en nyligen skapad faktura i Fortnox som har betalats med Klarna.
Leta upp referensfältet som innehåller ordernumret (eller Klarnas order-ID).
Ställ in Payout Reference Field – och Use Payment ID as Payout Reference – så att de stämmer överens.
Om fakturorna i Fortnox inte har skapats via Junipeer kan det hända att matchningen inte fungerar tillförlitligt, eftersom fakturorna kanske saknar en referens som finns i Klarnas avräkning. Läs mer i Matcha utbetalningsreferenser i Fortnox.
Checklista inför driftstart
Både Fortnox och Klarna visar en grön bock under Connect Systems.
Din integration mellan webbutiken och Fortnox skapar fakturor för Klarna-ordrar.
Klarna finns som betalningssätt i Fortnox.
Booking Accounting Settings for Settlements är ifyllt för Klarna och din redovisningskonsult har godkänt kontona.
Payout Reference Field motsvarar det fält som dina fakturor faktiskt använder. Kontrollera det på en riktig faktura.
Schemalägg Export Payouts to Fortnox att köras en gång per dag, vanligtvis kl. 23:00. Utbetalningar kan oftast inte testas i förväg – bevaka de första körningarna i produktion.
Kontakta din onboardingkontakt på Junipeer för att gå igenom inställningarna innan du går live.
Vanliga fallgropar
"No invoice found" på utbetalningar. Junipeer letar i fel fält, avräkningen innehåller en annan referens än fakturan (Klarnas order-ID i stället för ditt ordernummer, eller tvärtom) eller så har fakturan inte skapats ännu. Kontrollera Payout Reference Field och Use Payment ID as Payout Reference och kör sedan om den misslyckade utbetalningsuppgiften.
Du förväntar dig ordrar eller returer från den här integrationen. Den hanterar endast utbetalningar. Ordrar, fakturor och kreditfakturor kommer från din orderintegration.
"The payment date cannot precede the invoice date". Fakturan skapades efter att Klarna registrerade betalningen. Se till att fakturor skapas tillräckligt ofta.
Valutorna stämmer inte överens. En utbetalning i en annan valuta än fakturan kan inte matchas. Kontakta Junipeers support om du säljer i flera valutor.
Betalningssättet saknas i listan. Skapa det i Fortnox och klicka sedan på Clear Cache.
Klarna aktiverades i webbutiken innan Junipeer var konfigurerat. Tidiga ordrar kan få fel utbetalningsreferenser. Konfigurera alltid Junipeer först.
För fler fel, se Referens för felkoder eller kontakta support@junipeer.io.