Skip to main content

Boligsameie API

Tjeneste for innrapportering av tredjepartsopplysninger for boligsameie.

For generell informasjon om tjenestene se egne sider om:

Scope

Følgende scope skal benyttes ved autentisering i Maskinporten: skatteetaten:innrapporteringboligsameie

Delegering

Tilgang til dette API-et kan delegeres i Altinn, f.eks. dersom leverandør benyttes for den tekniske oppkoblingen.

Systemtilgang

Bruk av API-et krever systemtilgang, som er ny funksjonalitet i Maskinporten levert av Digdir. Informasjon vedr. dette finnes her.

Teknisk spesifikasjon

URL-er til API-et, beskrivelsen av parameterne, endepunkter og respons ligger i Open API spesifikasjonen på SwaggerHub

Oppbygning av URL-er og åpninger i en evt. brannmur er beskrevet her URL-er

API-et for boligsameie har bare ett endepunkt:

  • POST innsending: Mottar tredjepartsopplysninger for boligsameier. Ett kall mot API-et er en rapportering for et boligsameie gitt av en oppgavegiver og som gjelder et inntektsår.

API-et validerer mottatte data mot JSON schema beskrevet på SwaggerHub. Se feilkoder for relaterte feilmeldinger.

Se også eksempler for de ulike endepunktene.

Parameter: idempotencyKey

idempotencyKey parameteren er påkrevet. Innholdet skal være en unik UUID. Hvert nye kall til API-et skal ha en tilsvarende ny idempotencyKey. Flere etterfølgende POST kall med samme request-body og samme idempotencyKey vil gi den samme responsen. Kun det første av denne rekken med like API kall vil behandles. IdempotencyKey muliggjør at man trygt kan prøve innsendinger på nytt der man av ulike årsaker ikke har fått en tilbakemelding fra API-et.

Datakatalog

Dette API-et er pt. ikke dokumentert i Felles datakatalog.