GET/api/stats/byrafryst kontrakt

Aggregatet en byrå får läsa

En rad, inga affärshändelser: antal obokförda poster, omatchade banktransaktioner, verifikat utan underlag, senaste verifikatdatum, låsdatum, nästa momsdeadline och räkenskapsårets status. Inga belopp, inga motparter.

Månadsavslutets fält kom till i en senare version och är därför nullbara: last_closed_month, open_month och open_month_status säger vilken månad som ligger närmast i tur, months_behind hur många som återstår, och open_month_failing vilka villkor som är röda i den — villkorens NAMN, t.ex. ["bank", "underlag"], aldrig deras innehåll. Fältet är alltid en array; frågan om det finns någon månad att tala om besvaras av open_month. Lönevillkoret kan inte förekomma där: lön och personal ligger utanför byråns läskrets.

Svaret bär två versionstal som svarar på olika frågor: schema_version säger om portalen kan läsa svaret, installation_schema_version hur gammal installationen är. Kontraktet är FRYST — det får utökas bakåtkompatibelt och ingenting annat, så en portal byggd mot version 1 fortsätter läsa svaret.

Din installations adress

Debet & Kredit kör på din egen server, så bas-URL:en är din — inte vår. Skriv in den här, så byts den ut i varje kodexempel i dokumentationen.

GET https://din-installation.se/api/stats/byra

Behörighet

Varje giltig nyckel

Takt

60 anrop per timme och avsändaradress.

Parametrar

Huvuden

Namn	Typ	Krävs	Beskrivning
`Authorization`	string	ja	Bearer följt av token från POST /api/byra/token. `Bearer eyJhbGciOi…`

Svar

Exempel på svar:

{
  "schema_version": 1,
  "installation_schema_version": 112,
  "period": "202609",
  "unbooked_count": 4,
  "attachments_missing": 3,
  "unmatched_bank": 4,
  "last_verification": "2026-09-01",
  "period_locked_to": "2026-03-31",
  "vat_due_date": "2026-05-12",
  "fiscal_year": {
    "start": "2026-01-01",
    "end": "2026-12-31",
    "status": "open"
  },
  "last_closed_month": "2026-07-01",
  "open_month": "2026-08-01",
  "open_month_status": "in_progress",
  "open_month_failing": [
    "bank",
    "underlag"
  ],
  "months_behind": 2
}

Statuskoder

Kod	error	Betydelse
200	—	Aggregatet.
401	`unauthorized`	Saknad, felformad eller avvisad token.
403	`no_access`	Token duger men öppnar ingenting — åtkomsten kan vara återkallad.
429	`rate_limited`	För många anrop från samma adress.
500	`db_error`	Aggregatet kunde inte läsas.

Felkroppens fält och råd om omförsök står på Fel och statuskoder.

Kodexempel

curl -X GET "https://din-installation.se/api/stats/byra" \
  -H "Authorization: Bearer eyJhbGciOi…"