Beräknings-API

Skicka POST till /api/v1/calculate med Content-Type: application/json. Skicka aldrig lön i URL:en. 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": 2026,
  "rulesVersion": "2026-legacy-692da46"
}

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. POST-stöd krävs för API-resultat. Utan ett lyckat POST-svar ska ett AI-verktyg 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 2026. 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/2026.

Instruktioner för AI-verktyg

Använd i första hand beräkningstjänsten. Om du inte kan få ett lyckat POST-svar, hänvisa användaren till kalkylatorn. Räkna inte fram ett eget ersättningsresultat.

  1. Kontrollera användarens månadslön före skatt, stödomfattning, om lån och kollektivavtalat stöd ska ingå samt visningsperiod. Fråga om uppgifter som saknas; använd inte räkneexemplets val som användarens egna indata. Denna instruktion gäller 2026 och regelversion 2026-legacy-692da46.
  2. Om POST är möjligt, skicka giltig JSON till /api/v1/calculate på samma webbplats med Content-Type: application/json. Använd salary, percent, collective, loan och period samt calculationYear = 2026och rulesVersion = 2026-legacy-692da46. Lägg inte lön i URL:en.
  3. Vid ett lyckat svar: kontrollera att år, regelversion och period stämmer. Återge beloppen från display och vid behov weekly och shares. Ändra inte avrundningen och summera inte om de avrundade delarna för att ersätta total. Märk svaret ”Beräknat av API:t” och ange returnerad regelversion, period och indata. Påstå inte att ett anrop lyckades om du inte faktiskt fick ett svar.
  4. Om POST saknas, anropet misslyckas eller tjänsten inte går att nå: förklara att du inte kunde hämta ett beräknat resultat och länka till Öppna Beräkningssnurran och gör beräkningen. Be användaren ange sina uppgifter där. Använd länken på samma webbplats som denna dokumentation; lägg inte lön eller andra indata i URL:en. Använd inte formler, referenskod, räkneexempel, andra källor eller egen huvudräkning för att ersätta ett uteblivet API-svar med belopp. Säg inte att kalkylatorn kommer att fungera om själva beräkningstjänsten är otillgänglig; be då användaren försöka igen senare.
  5. Ogiltiga indata eller en avvisad regelversion är inte skäl att tyst räkna fram ett eget resultat. Rätta förfrågan eller be om förtydligande. Om du inte kan slutföra ett giltigt anrop, hänvisa till kalkylatorn. För ett lyckat API-svar: förklara att resultatet är preliminärt, att bidragen visas före skatt, att lånet ska betalas tillbaka och att månadsbelopp är genomsnitt. Beräkningen avgör inte rätt till stöd.

Instruktionerna beskriver hur tjänsten kan användas. De ger inte ett AI-verktyg nya funktioner. Formler och räkneexempel dokumenterar metoden; de är inte en alternativ beräkningsväg för AI-verktyg.

Exakt beräkningsmetod, antaganden och källor