Beräknings-API
Skicka POST till /api/v1/calculate med Content-Type: application/json. POST-anropets indata ska ligga i JSON-kroppen. Svaret lagras inte och innehåller belopp i SEK, beräkningsår och regelversion.
{
"salary": 25000,
"percent": 1,
"collective": true,
"loan": true,
"period": "week",
"calculationYear": 2027,
"rulesVersion": "2027-legacy-692da46-r2"
}salary: positiv heltalslön per månad, högst 173215370283480. percent: 1, 0.75, 0.6, 0.5, 0.4 eller 0.2. collective och loan: boolean. period: week, 4weeks eller month. Dessa fem fält krävs. calculationYear och rulesVersion är valfria för bakåtkompatibilitet; ange båda för ett reproducerbart resultat. Utelämnade väljare använder tjänstens standardregelversion. Okända fält, år och regelversioner avvisas.
Svaret innehåller weekly, display och shares samt calculationYear, rulesVersion, currency och period. income är veckolöneunderlag; grant är bidrag; supplement är kollektivavtalat stöd; loan är lån; total är total ersättning; shortfall är löneskillnad. display gäller vald period och shares anger avrundade procent av veckolöneunderlaget.
Fel: 400 ogiltig JSON, 422 ogiltiga indata, 405 fel metod, 413 kropp större än 4096 byte, 415 fel innehållstyp, 503 beräkningstjänsten är otillgänglig. 422 med unsupported_rules betyder att angivet år eller regelversion saknas. GET-baserade läsverktyg kan läsa förklaringar. Verktyg utan POST-stöd kan i stället hämta ett faktiskt beräknat resultat från GET /result med samma indata i URL:en. Om varken POST eller resultatsidan kan användas ska AI-verktyget länka användaren till kalkylatorn i stället för att räkna fram egna belopp.
Läs offentliga parametrar och regelversion för 2027. IBB, prisbasbelopp, tak och källhänvisningar kommer från samma tjänst som beräknar resultaten. Parametrar kan inte ändras i en beräkningsförfrågan. Cloudflare-produkter kan använda en privat service binding till beräkningstjänstens /v1/calculate och /v1/rules/2027.
Resultat via GET för läsverktyg
För läsverktyg rekommenderas den enkla sökvägen nedan. Ordningen är regelversion, månadslön i hela kronor, stödomfattning i hela procent, kollektivavtalat stöd, CSN-lån och period. Tillåtna procent är 100, 75, 60, 50, 40 och 20. Stödalternativen anges var för sig med yes/no och period med week, 4weeks eller month. Regelversionen låser även året. Behåll snedstrecken; koda inte hela URL:en och lägg inte till beräkningsparametrar efter ett frågetecken. Sidan returnerar resultatet direkt utan omdirigering.
Exempel med syntetiska löner. Ersätt med användarens egna val:
- 40 000 kr, 100%, kollektivt stöd och lån, månad: /result/2027-legacy-692da46-r2/40000/100/yes/yes/month
- 40 000 kr, 60%, kollektivt stöd och lån, månad: /result/2027-legacy-692da46-r2/40000/60/yes/yes/month
- 25 000 kr, 75%, endast lån, fyra veckor: /result/2027-legacy-692da46-r2/25000/75/no/yes/4weeks
- 55 000 kr, 20%, utan kollektivt stöd och lån, vecka: /result/2027-legacy-692da46-r2/55000/20/no/no/week
Det befintliga formatet GET /result tar salary, percent, collective, loan och period som obligatoriska URL-parametrar. calculationYear och rulesVersion kan anges för reproducerbara resultat. Använd true/false för stödalternativen och samma tillåtna värden som för POST. Okända eller dubbla fält avvisas. Resultatet är HTML från samma beräkningstjänst, med indata, belopp, regelversion och begränsningar. Resultatsidor indexeras inte.
Exempel med syntetisk lön, inte användarens egna uppgifter:
/result?salary=40000&percent=0.6&collective=true&loan=true&period=month&calculationYear=2027&rulesVersion=2027-legacy-692da46-r2Ersätt exemplets värden med användarens uppgifter. Återge endast belopp från en lyckad resultatsida; en felsida eller sidan utan indata är inget beräkningsresultat. POST /api/v1/calculate behåller sitt befintliga kontrakt.
AI-assistenter kan också använda MCP-servern på /mcp. Så kopplar du in Claude, ChatGPT, Gemini och andra AI-verktyg.
Instruktioner för AI-verktyg
- Fråga efter månadslön före skatt, stödomfattning, om CSN-lån och kollektivavtalat stöd ska ingå samt period. Anta inte saknade val och använd inte räkneexemplets indata som användarens egna.
- Använd i första hand POST /api/v1/calculate med JSON: salary, percent, collective, loan, period, calculationYear = 2027 och rulesVersion = 2027-legacy-692da46-r2. På denna POST-endpoint ska indata ligga i kroppen.
- Om dina verktyg endast kan läsa URL:er, använd i första hand sökvägen
/result/2027-legacy-692da46-r2/LÖN/PROCENT/KOLLEKTIVT/LÅN/PERIOD. Ange månadslön i hela kronor, procent som 100, 75, 60, 50, 40 eller 20, yes/no för respektive stödalternativ och week, 4weeks eller month. Använd användarens faktiska värden och behåll snedstrecken; koda inte hela URL:en och lägg inte till indata som URL-parametrar. Denna sida anropar samma beräkningstjänst och visar resultatet som läsbar HTML; det är ingen egen uppskattning. - Om ditt verktyg bara öppnar adresser som redan finns som länkar, öppna /result/2027-legacy-692da46-r2 och följ länkarna: välj lönen närmast användarens (steg om 1 000 SEK) och därefter stödvalen. Säg att resultatet gäller den valda lönen.
- Efter ett lyckat API-svar eller en lyckad resultatsida: återge returnerade belopp, indata, år, regelversion och period. Märk svaret ”Beräknat av API:t” och ange om du använde POST eller GET-resultatsidan. Ändra inte avrundningen och summera inte de avrundade delarna för att ersätta totalen. Påstå aldrig att du fick ett resultat om du inte faktiskt hämtade det.
- Om varken POST eller resultatsidan fungerar, förklara att inget resultat hämtades och länka till Öppna Beräkningssnurran och gör beräkningen. Ersätt inte resultatet med formler, referenskod, räkneexempel, externa tabeller eller egen huvudräkning. Vid felaktiga indata, rätta förfrågan eller fråga användaren; välj inte tyst en annan regelversion. Om tjänsten är otillgänglig, be användaren försöka igen senare.
- Förklara att resultatet är preliminärt, att bidrag visas före skatt, lån ska återbetalas och månadsbelopp är genomsnitt. Beräkningen avgör inte rätt till stöd.
Instruktionerna ger inte AI-verktyget nya funktioner. Den befintliga formulärsidan är inte ett beräkningsresultat; den särskilda GET-resultatsidan utför däremot en beräkning.