NONOX Connect API · v1.1.0

Bygg mot svensk bokföring som är öppen på riktigt.

NONOX Connect är NONOX API: läs kontoplanen, skapa och bokför verifikationer, lägg till underlag och håll kunder och leverantörer i synk. Gratis och utan tilläggsavgift, skyddat med OAuth 2.0 och passkeys, och dokumenterat ner till varje felkod.

Kom igång på fem minuter API-referens openapi.yaml

Basadresshttps://nonox.app/api/v1

Vad API:t gör

BokföringKontoplan, momskoder, räkenskapsår och verifikationsserier: det ett program behöver för att bokföra rätt.

VerifikationerSkapa utkast, bokför dem med nummer utan luckor, rätta bokförda verifikationer och lägg till kvitton och fakturor.

RegisterKunder och leverantörer, med synk av allt som ändrats sedan förra gången.

StandarderOpenAPI 3.1, OAuth 2.0 med PKCE, fel enligt RFC 9457, idempotenta anrop och svarshuvuden för gränser.

Företaget Företaget som nyckeln eller appen gäller. 1 anrop Bokföring Kontoplan, momskoder, räkenskapsår och verifikationsserier. 8 anrop Verifikationer Verifikationer: utkast, bokföring, rättelser och underlag. En bokförd verifikation kan aldrig ändras. 10 anrop Kunder Kundregistret. 4 anrop Leverantörer Leverantörsregistret. 4 anrop Kostnadsställen och projekt Kostnadsställen och projekt. 8 anrop Rapporter Saldobalans, huvudbok, balansrapport och resultatrapport. 4 anrop Moms Momsperioder och momsdeklaration. 2 anrop Artiklar Artikelregistret. 4 anrop Kundfakturor Kundfakturor: utkast, skapa, mejla, kreditera, betalningar och PDF. 9 anrop Leverantörsfakturor Leverantörsfakturor: utkast, fil, registrering, attest och betalning. 9 anrop Betalningar In- och utbetalningar. 2 anrop

Gratis, utan tilläggsavgift

Att nå sina egna siffror från ett annat program ska inte kosta extra. Så här fungerar det i NONOX.

Ingen tilläggsavgiftAPI:t är en modul i NONOX som alla andra. Det kostar inget per anrop, per app eller per integration.

Gratis när du driftar självNONOX har öppen källkod (AGPL-3.0). På din egen server kostar API:t ingenting, nu eller senare.

Ingår när vi driftarTjänsten där vi sköter driften har alla moduler med i priset, API:t också. Det är ingen dyrare nivå.

Din data, din väg utEtt öppet API är en del av att aldrig vara inlåst, bredvid SIE4 och arkivpaketet. Koden visar exakt vad varje anrop gör.

Säkerheten i klartext

Varje token och nyckel gäller exakt ett företag. Ett annat företags id ger 404, så API:t avslöjar aldrig vad som finns.
En app kommer bara in när en ägare eller administratör godkänner den på en svensk sida och bekräftar med sin passkey.
Access tokens gäller högst 15 minuter. Refresh tokens byts vid varje användning, och en som kommer tillbaka en andra gång återkallar hela anslutningen.
Ett anrop får göra det som behörigheterna tillåter och det som personen bakom får göra i företaget just nu. En ändrad roll gäller från nästa anrop.
API-nycklar har alltid ett slutdatum, kan begränsas till IP-adresser, visas en gång och sparas bara som ett SHA-256-avtryck.
Varje skrivning, godkännande och återkallelse hamnar i företagets behandlingshistorik. Personnummer lämnas aldrig ut.
En bokförd verifikation kan aldrig ändras. API:t kan bokföra ett utkast eller rätta en verifikation, precis som appen.

Detaljerna: Autentisering (OAuth), API-nycklar, Behörigheter och säkerhetssidan.

Kom igång på fem minuter

Slå på NONOX Connect

Som ägare eller administratör i ett företag: öppna Inställningar → Moduler och slå på NONOX Connect. Testa gärna i ett eget företag.
Skapa en API-nyckel

Under Anslutningar skapar du en nyckel med behörigheterna vouchers:view, vouchers:create och vouchers:post och ett slutdatum. Bekräfta med din passkey och kopiera nyckeln; den visas bara en gång.
```
export NONOX_TOKEN="nnx_…"
```

Se vilket företag nyckeln gäller

curl "https://nonox.app/api/v1/company" \
  -H "Authorization: Bearer $NONOX_TOKEN" \
  -H "Accept: application/json"

Skapa ett utkast till verifikation

Belopp anges i hela öre: 125000 är 1 250,00 kr. Idempotency-Key gör ett nytt försök ofarligt.

curl -X POST "https://nonox.app/api/v1/vouchers" \
  -H "Authorization: Bearer $NONOX_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "voucher_date": "2026-03-02",
  "description": "Kontantförsäljning",
  "series": "A",
  "rows": [
    {
      "account": 1930,
      "debit_ore": 125000
    },
    {
      "account": 3001,
      "credit_ore": 100000
    },
    {
      "account": 2611,
      "credit_ore": 25000
    }
  ]
}'

Bokför det

Använd id:t från svaret. Verifikationen får nästa nummer i serien, utan luckor, och kan sedan aldrig ändras, bara rättas.

curl -X POST "https://nonox.app/api/v1/vouchers/0b9f3c1e-6a2d-4f7b-9c8e-1d2a3b4c5d6e/post" \
  -H "Authorization: Bearer $NONOX_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: $(uuidgen)"

Hela guiden, också i PHP, JavaScript och Python →

Guider

Kom igångFrån noll till en bokförd verifikation via API:t på fem minuter: modul, nyckel och de första anropen. Autentisering (OAuth)OAuth 2.0 med auktoriseringskod och PKCE steg för steg, med riktiga anrop och svar, godkännande med passkey och förnyade tokens. API-nycklarNycklar för egna skript och integrationer: hur de skapas, vad de får göra och hur de återkallas. BehörigheterVarje scope, vilka anrop det öppnar och hur det samverkar med personens egen roll i företaget. IdempotensIdempotency-Key på varje POST, så att ett nytt försök efter ett nätverksfel aldrig bokför två gånger. Sidindelning och synkListor med markör, och hur en synk hämtar bara det som ändrats med updated_since. FelAlla fel som problem+json (RFC 9457): fälten, varje kod och vad programmet ska göra. Gränser för anropHur många anrop som går per minut, svarshuvudena som visar det och hur man väntar rätt. WebhooksHändelser som skickas till din server när något bokförs, och hur signaturen kontrolleras i PHP, JavaScript och Python. Egen driftAPI:t på en NONOX som du driftar själv: adresser, nycklar för signering, appar och gränser.