Den här guiden riktar sig till butiks- och ekonomipersonal som kopplar Kustom till Fortnox via Junipeer. Den beskriver vad integrationen gör, hur kopplingen görs, hur utbetalningar bokförs och matchas samt vad du bör kontrollera innan du går live.
Gå först igenom Connecting payment services to Junipeer. Där beskrivs de steg som är gemensamma för alla betalleverantörer. Den här guiden tar upp det som är specifikt för Kustom och Fortnox.
Vad integrationen gör
Integrationen Kustom ↔ Fortnox har ett flöde:
Flöde | Vad det gör |
|---|---|
Export Payouts to Fortnox | Läser Kustoms avräkningar (utbetalningar), matchar varje transaktion mot dess faktura i Fortnox, markerar fakturan som betald och bokför avgifterna. |
Integrationen skapar inga ordrar, fakturor eller kreditfakturor. Fakturorna måste redan finnas i Fortnox – oftast skapade av din webbshopsintegration – och måste innehålla en referens som Junipeer kan matcha.
Innan du börjar
Fortnox är förberett: en integrationsanvändare, valutor och ett betalsätt för Kustom. Se Prepare Fortnox for integration.
Du har inloggningsuppgifter till Kustoms settlements-API. Kontakta din kontaktperson på Kustom om du saknar dem.
Du vet vilka konton i Fortnox som ska användas för avgifter, moms på avgifter och öresavrundning. Fråga din redovisningskonsult.
Koppla Kustom och Fortnox
Gå till Get Started → Connect Systems i Junipeer-appen. Koppla Fortnox genom att klicka på Fortnox-knappen och logga in. Fyll sedan i fälten för Kustom:
Fält | Vad du anger |
|---|---|
Kustom settlements API Url | Adressen till Kustoms settlements-API. Vanligtvis |
Kustom API user/id | Användarnamnet eller ID:t för Kustoms settlements-API. |
Kustom API password or secret | Lösenordet för Kustoms settlements-API. Det lagras som en hemlighet. |
Alla tre fälten är obligatoriska. När båda systemen visar en grön bock kan du börja konfigurera.
Bokföringsinställningar för utbetalningar
Öppna Configure → Settings och leta upp Booking Accounting Settings for Settlements. Lägg till Kustom som betalleverantör och fyll i kontona nedan. Detta styr hur varje utbetalning bokförs i Fortnox. Utan dessa inställningar bokförs utbetalningarna inte korrekt.
Kontonumren nedan är de vanliga svenska exempel som visas i appen. Stäm av varje konto med din redovisningskonsult innan du sparar – din kontoplan kan se annorlunda ut.
Inställning | Vad du anger |
|---|---|
Payment Method | Betalsättet i Fortnox för Kustom. Obligatoriskt. Listan hämtas från Fortnox – om Kustom saknas lägger du först till det i Fortnox. |
Map Currency with Mode of Payment (if different than (default) Payment Method above) | Valfritt (avancerat). Använd ett annat betalsätt i Fortnox för utbetalningar i en viss valuta, till exempel EUR-utbetalningar som går till ett separat EUR-konto. Valutor som du inte mappar använder Payment Method ovan. |
Account Number Bank Costs | Kontot för Kustoms avgift exklusive moms. Obligatoriskt. Appen föreslår 6570. |
VAT account for provider fees | Kontot där moms på Kustoms avgifter bokförs. Detta är ingående moms som du kan dra av. Obligatoriskt. Används endast när Kustom redovisar moms på en avgift. Appen föreslår 2641 i Sverige. |
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. Obligatoriskt. Appen föreslår 3740. |
Account Number for Currency Profit | Valfritt. Små differenser vid valutaomräkning som ger en kursvinst. Appen föreslår 3960. Lämna tomt för att använda kontot för öresavrundning för både vinst och förlust. |
Account Number for Currency Loss | Valfritt. Motsvarande för en kursförlust. Appen föreslår 7960. |
Klicka på ? bredvid respektive inställning i appen för mer information.
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.
När Kustom gör en utbetalning läser Junipeer utbetalningen och hittar fakturan i Fortnox för varje transaktion. Matchade fakturor markeras som betalda och avgifterna bokförs på de konton du angett ovan.
För att hitta rätt faktura hämtar Junipeer en referens från utbetalningen och söker efter den i ett fält på fakturan (eller ordern) i Fortnox. Du bestämmer var sökningen görs under General Settings:
Inställning | Vad den gör |
|---|---|
Payout Reference Field | Obligatoriskt. Fältet i Fortnox som innehåller referensen, vanligtvis butikens order-ID eller betalningens order-ID. I många uppsättningar är detta ExternalInvoiceReference1. Öppna en nyligen skapad faktura i Fortnox för att se vilket fält som innehåller orderreferensen. |
Fallback Payout Reference Field | Valfritt (avancerat). Ett andra fält att söka i om referensen inte hittas i det första, till exempel ExternalInvoiceReference2. |
Use Payment ID as Payout Reference | Valfritt (avancerat). Som standard söker Junipeer efter handlarreferensen (vanligtvis ditt ordernummer). Välj detta för att i stället söka efter betalnings-ID:t (vanligtvis Kustoms order-ID), eller för att först prova det ena och sedan det andra. Välj det som faktiskt lagras i ditt Payout Reference Field. |
Search for the Payout Reference on the Order | Valfritt (avancerat). Yes söker på ordern i Fortnox och hittar sedan dess faktura. No söker direkt på fakturan. |
Book keep invoice payment | Valfri (avancerad), standard Yes. Bokför de betalningar som Junipeer skapar från utbetalningar. Låt den stå på Yes om fakturor ska markeras som betalda automatiskt. |
Läs mer i Matcha utbetalningsreferenser i Fortnox och Avstämning av utbetalningar.
Driftsättning
Utbetalningar går oftast inte att testa i förväg. Den schemalagda körningen måste köras i produktion, och du bör kontrollera resultatet efter varje körning.
Fortnox är anslutet och förberett, inklusive ett betalningssätt för Kustom.
De tre Kustom-fälten är ifyllda och anslutningen visar en grön bock.
Export Payouts to Fortnox är aktiverad.
Booking Accounting Settings for Settlements är ifyllt för Kustom, och din redovisningskonsult har bekräftat kontona.
Payout Reference Field stämmer med det fält som din webbshopsintegration skriver orderreferensen till. Kontrollera en nyligen skapad faktura i Fortnox.
Schemalägg Export Payouts to Fortnox. Utbetalningar körs oftast en gång om dagen, till exempel kl. 23:00.
Kontakta din onboardingkontakt på Junipeer för att gå igenom inställningarna innan du driftsätter.
Efter de första utbetalningarna kontrollerar du i Fortnox att fakturorna är markerade som betalda och att avgifterna är bokförda på rätt konton.
Vanliga fallgropar
Anslutningen misslyckas. Kontrollera först Kustom settlements API Url och sedan användare och lösenord. Inloggningsuppgifterna gäller Kustoms settlements-API.
Fakturor som inte skapats av Junipeer. Om fakturor kommer in i Fortnox via ett annat verktyg kanske de saknar en referens som Junipeer kan matcha.
"No invoice found" på en utbetalning. Oftast pekar Payout Reference Field på ett fält som är tomt eller innehåller en annan referens än den som utbetalningen har. Öppna den misslyckade uppgiften i loggarna, notera referensen och kontrollera vilket fält i Fortnox som innehåller den. Det kan också vara så att fakturan inte finns ännu, om utbetalningen kom innan ordern synkroniserades.
Betalningssättet saknas i listan. Skapa det först i Fortnox och klicka sedan på Clear Cache på inställningssidan.
Betalningsdatum före fakturadatum. Fortnox kan avvisa en betalning som är daterad före fakturan. Se Felkoder.
Fakturor i en annan valuta än utbetalningen. Detta ger "Unsupported currency combination". Om du säljer i flera valutor, kontakta Junipeers support för att ställa in det.
Ny betalningsleverantör aktiverades i webbshoppen innan Junipeer var konfigurerat. Utbetalningar för de tidiga ordrarna kan få felaktiga referenser. Konfigurera Junipeer först. Om det redan har hänt, kontakta supporten.