ketl cloud

Skatteetaten SBS REST API endres — hard frist 1. juni 2026. Oppdater feltkart og size-guard senest innen 31. mai.

HjemKunnskapSBS REST API-overgang
Frist: 1. juni 2026

Skatteetaten SBS REST API-overgang

Skatteetaten migrerer innrapportering (a-melding) og tilbakemelding til nytt REST API. Fra 1. juni 2026 gjelder ny feltnomenklatur, ny request-size-grense og nytt filopplasting-endepunkt for store payloads. Her er alt du trenger å vite som ERP-/lønnssystem-leverandør eller ketl-integratør.

Feltmapping — mottak-respons

Skatteetaten fjerner og omdøper felt i mottak-api-responsen. Compat-laget i ketl normaliserer automatisk til interne feltnavn ( submissionId, messageId).

Gammelt feltNytt feltTypeNotat
transmissionIdforsendelseIdstringOmdøpt — samme semantikk
oppgavegiversLeveranseReferansemeldingsIdstringOmdøpt — samme semantikk
antallSletteoppgaverFjernetnumberFjernet fra respons
antallOppgaverFjernetnumberFjernet fra respons

Request-size guard

Skatteetaten setter maksgrensen til 10 000 000 bytes (10 MB). ketl-compat-laget håndhever en konservativ grense på 9 950 000 bytes for å unngå 413-feil i grensetilfeller.

  • Payload ≤ 9 950 000 bytes: sendes direkte til mottak-API.
  • Payload 9 950 000 – 10 000 000 bytes: avvises med feilmelding — bruk filopplasting-API.
  • Payload > 10 000 000 bytes: Skatteetaten returnerer 413 Request Entity Too Large.

Migrasjons-sjekkliste

Gå gjennom hvert steg og kryss av før 1. juni 2026.

1
Oppdater feltkart i klientkoden
Kritisk
Bytt ut `transmissionId` med `forsendelseId` og `oppgavegiversLeveranseReferanse` med `meldingsId` overalt i klientkoden som leser mottak-responsen. Fjern avhengigheter til `antallSletteoppgaver` og `antallOppgaver`.
2
Legg inn request-size guard (9 950 000 bytes)
Kritisk
Skatteetaten satte maksgrensen til 10 000 000 bytes (10 MB). Anbefalt grense er 9 950 000 bytes for margin. Payloads over grensen må sendes via filopplasting-API-et (separat endpoint).
3
Implementer filopplasting-API for store payloads
Høy prioritet
Innrapporteringer over 9,95 MB må rutes til innrapportering-amelding-filopplasting-api v0.1.2. Se SwaggerHub-lenke under. Både mottak og filopplasting krever Maskinporten-token.
4
Test i Skatteetatens testmiljø
Høy prioritet
Bruk Skatteetatens testmiljø (ID-porten sandbox) for å verifisere alle endepunkter. Sjekk at ny feltnomenklatur er på plass og at size-guardrail avviser for-store payloads med forklarende feilmelding.
5
Oppdater OpenAPI-spesifikasjoner og kontraktsnote
Middels prioritet
Hold intern OpenAPI-spec i sync med Skatteetatens SwaggerHub (amelding-api v0.1.0, tilbakemelding-api v0.1.0). Legg inn en kontraktsnote-test som pinner feltmapping og sørger for at fremtidige API-endringer fanger CI.
6
Forbered cutover-plan
Middels prioritet
Definer hvilken versjon av klientkoden som håndterer gammel vs. ny API-respons, og sett en dato for full cutover til nytt API. Dokumenter rollback-prosedyre dersom cutover feiler.

Offisielle API-spesifikasjoner

amelding-api v0.1.0
Mottak og innrapportering
SwaggerHub
amelding-tilbakemelding-api v0.1.0
Tilbakemelding på innrapportert amelding
SwaggerHub
amelding-filopplasting-api v0.1.2
Filopplasting for payloads over 9,95 MB
SwaggerHub
Offisiell kilde: Skatteetaten
Status overgang til nytt API — Skatteetatens nyhetsside for sluttbrukersystem-leverandører (SBS).
skatteetaten.no — Status overgang til nytt API

Trenger du hjelp med SBS-integrasjonen?

ketl cloud tilbyr et compat-lag som normaliserer gammel og ny SBS-respons og håndhever size-guardrail automatisk. Kontakt oss for en teknisk gjennomgang.

ketl cloud
DataApperMCPPriser
AI-transparensPersonvernSikkerhet

© 2026 ketl cloud

build c372edd · 2026-05-11 14:18:12 UTC