Dokumentation

Lär dig installera, konfigurera och använda Arknox för att hämta Fortnox-data i Excel.

Installation

Arknox är ett Excel-tillägg som du installerar (sideloadar) i Microsoft Excel. Det fungerar på både desktop (macOS/Windows) och Excel Online.

macOS

Terminal

# Klona och installera
git clone https://github.com/your-org/arknox.git
cd arknox
npm install

# Installera i Excel
npm run sideload

Windows

På Windows, kopiera manifest.xml till en nätverksdelning eller använd centraliserad distribution via Microsoft 365 Admin Center.

Info: Tillägget kräver Excel build 16.0 eller senare med stöd för anpassade funktioner.

Autentisering

Arknox använder Fortnox OAuth 2.0 för autentisering. Efter installationen:

Öppna Arknox-aktivitetsfältet från Excel-menyfliksområdet
Klicka på "Anslut till Fortnox"
Logga in med dina Fortnox-uppgifter i popup-fönstret
Auktorisera Arknox att komma åt ditt företags data
Klart! Aktivitetsfältet visar ditt företagsnamn.

Tips: Din session sparas mellan omstarter av Excel. Du behöver bara autentisera på nytt om din token löper ut (efter 30 dagars inaktivitet).

Din första formel

När du är ansluten, prova att skriva detta i valfri cell:

Excel-formel

=AX.BALANCE(1510, "2025-01-01", "2025-12-31")

Detta returnerar saldot för konto 1510 (Kundfordringar) för år 2025. Resultatet uppdateras automatiskt varje gång du öppnar arbetsboken.

Funktionsreferens

Komplett referens för alla Arknox-funktioner.

AX.BALANCE

Returnerar utgående saldo för ett givet konto och datumintervall.

=AX.BALANCE(konto, frånDatum, tillDatum)

Parametrar

Parameter	Typ	Beskrivning
konto	number	Kontonummer (t.ex. 1510)
frånDatum	string	Startdatum i ISO-format (t.ex. "2025-01-01")
tillDatum	string	Slutdatum i ISO-format (t.ex. "2025-12-31")

Exempel

Excel

=AX.BALANCE(1510, "2025-01-01", "2025-12-31")
→ 245 800,00

=AX.BALANCE(3010, "2025-01-01", "2025-03-31")
→ 580 200,00

AX.GL

Returnerar huvudboksposter för ett givet konto och datumintervall. Returnerar en array som spills ut i angränsande celler.

=AX.GL(konto, frånDatum, tillDatum)

Parametrar

Parameter	Typ	Beskrivning
konto	number	Kontonumret att fråga
frånDatum	string	Startdatum i ISO-format
tillDatum	string	Slutdatum i ISO-format

Returnerar

En spillande array med kolumnerna: Datum, Verifikation, Beskrivning, Debet, Kredit, Saldo.

Exempel

Excel

=AX.GL(1510, "2025-01-01", "2025-03-31")
→ Spills ut som en tabell med alla transaktioner på konto 1510 under Q1 2025

AX.NL

Navigation Lookup-funktion — kompatibel med Jet Reports NL()-syntax. Möjliggör flexibla datahämtningar med ett välkänt gränssnitt.

=AX.NL(vad, tabell, fält1, värde1, [fält2], [värde2], ...)

Parametrar

Parameter	Typ	Beskrivning
vad	string	"Balance", "Sum", "First", "Last" eller "Count"
tabell	string	"Account", "Customer", "Invoice" etc.
fält1	string	Första filterfältets namn
värde1	string	Första filtervärdet
fält2(valfri)	string	Ytterligare filterfält
värde2(valfri)	string	Ytterligare filtervärde

Exempel

Excel

=AX.NL("Balance", "Account", "No", "1510", "DateFilter", "2025-01-01..2025-12-31")
→ 245 800,00

=AX.NL("First", "Customer", "No", "1001")
→ "Acme Corporation"

AX.ACCOUNTS

Returnerar kontoplanen från Fortnox som en spillande array.

=AX.ACCOUNTS()

Returnerar kolumnerna: Nummer, Beskrivning, SRU, Aktiv.

AX.INVOICES

Returnerar en lista med kundfakturor, valfritt filtrerade efter status.

=AX.INVOICES([status])

Parameter	Typ	Beskrivning
status(valfri)	string	"unpaid", "paid", "overdue" eller "all" (standard: "all")

Exempel

Färdiga mallar och recept för att komma igång snabbt.

Balansrapport

Skapa en balansrapport genom att lista kontonummer i kolumn A och hämta saldon i kolumn B:

Uppsättning

A1: Konto             B1: Saldo
A2: 1510              B2: =AX.BALANCE(A2, "2025-01-01", "2025-12-31")
A3: 1910              B3: =AX.BALANCE(A3, "2025-01-01", "2025-12-31")
A4: 2440              B4: =AX.BALANCE(A4, "2025-01-01", "2025-12-31")
A5: 2610              B5: =AX.BALANCE(A5, "2025-01-01", "2025-12-31")

B6: =SUMMA(B2:B5)    ← Använd vanliga Excel-funktioner tillsammans med Arknox!

Resultaträkning

Bygg en månadsvis resultaträkning genom att kombinera AX.BALANCE med datumparametrar:

Månadsvis resultaträkning

         B (Jan)                              C (Feb)
Rad 2:   =AX.BALANCE(3010,"2025-01-01",       =AX.BALANCE(3010,"2025-02-01",
           "2025-01-31")                         "2025-02-28")
Rad 3:   =AX.BALANCE(4010,"2025-01-01",       =AX.BALANCE(4010,"2025-02-01",
           "2025-01-31")                         "2025-02-28")
Rad 5:   =B2-B3  ← Bruttovinst                =C2-C3

Tips: Spara dina datum i celler och referera till dem i formlerna för att enkelt kunna byta period.

Åldersanalys kundfordringar

Kombinera AX.INVOICES med Excels filtrering för att analysera förfallna fakturor:

Excel

=AX.INVOICES("overdue")
→ Spills ut som en tabell med: Fakturanr, Kund, Belopp, Förfallodatum, Dagar förfallen

Använd sedan Excels FILTER eller pivottabeller för att gruppera efter åldersintervall.

Avancerat

Migreringsguider, begränsningar och felsökning.

Migrering från Jet Reports

Om du migrerar från Jet Reports erbjuder AX.NL()-funktionen ett kompatibelt gränssnitt. I de flesta fall kan du söka och ersätta =NL( med =AX.NL( i dina befintliga mallar.

Viktiga skillnader

Datakällan är Fortnox istället för Business Central / NAV
Tabellnamn följer Fortnox-konventioner (t.ex. "Account" istället för "G/L Account")
Vissa avancerade NL-funktioner (NP, NF) stöds inte ännu

API-begränsningar

Fortnox har API-begränsningar (rate limits). Arknox hanterar detta automatiskt genom att köa förfrågningar med 220 ms fördröjning mellan anrop.

Parameter	Typ	Beskrivning
Gratis	100/dag	100 API-anrop per dag
Pro	Obegränsat	Ingen daglig gräns, fortfarande begränsad av Fortnox rate limiting

Varning: Om du har många formler som uppdateras samtidigt kan det ta några sekunder innan alla resultat visas, eftersom förfrågningarna köas.

Felsökning

Formeln visar #VALUE!

Detta betyder vanligtvis att du inte är ansluten till Fortnox. Öppna Arknox-aktivitetsfältet och kontrollera anslutningsstatus. Om du är frånkopplad, klicka på "Anslut till Fortnox" för att autentisera på nytt.

Data verkar inaktuell

Anpassade funktioner uppdateras när arbetsboken öppnas. För att tvinga en uppdatering, stäng och öppna arbetsboken igen, eller tryck Ctrl+Shift+F9 för att räkna om alla formler.

Tillägget laddas inte

Kontrollera att du kör Excel build 16.0+ med stöd för anpassade funktioner. På macOS, kör npm run sideload igen. På Windows, verifiera att manifestfilen är tillgänglig från sin nätverksdelningsplats.

Långsam prestanda med många formler

Arknox köar API-anrop för att respektera Fortnox begränsningar (220 ms mellan förfrågningar). Om du har 50+ formler kan första laddningen ta 10–15 sekunder. Överväg att använda AX.GL()-arrayer istället för många enskilda AX.BALANCE()-anrop.

Behöver du hjälp?

Hittar du inte det du letar efter? Hör av dig så hjälper vi dig komma igång.

Kontakta support