Vi har invitert alle søknads- og eByggesaksleverandører til innspillsmøter om saksbehandlingsdata 13. og 14. september. Nå har vi også lagt ut et første utkast til innhold i de reviderte API-ene, som vi vil bruke som underlag på innspillsmøtene.

Vi vil også oppfordre så mange som mulig til å svare på undersøkelsen i forkant av møtet: https://response.questback.com/dibk/dataflyt

Fristen for å svare er tirsdag 6. september.

Nye og endrede API-er

Disse API-ene er tenkt brukt for utveksling av saksbehandlingsdata mellom saksbehandler og ansvarlig søker/tiltakshaver:

• API for kvittering (versjon 2)

• API for oppdatering (nytt)

• API for status (ny versjon)

API for kvittering (versjon 2)

Den nye versjonen av API for kvittering er et enkelt API-kall som brukes til å gi automatisk kvittering om at en sending er mottatt i kommunen. API-et inneholder informasjon søker trenger for å vite at innsendingen er mottatt i kommunen og registrert, som mottaksdato, hvilke filer som er mottatt, saksnummer i kommunen, og saksbehandler dersom det er tildelt.

API for kvittering er kun tenkt som en bekreftelse på mottatt søknad, og skal ikke oppdateres underveis i saksbehandlingsprosessen. Hvis saken får tildelt en saksbehandler på et senere tidspunkt, blir den informasjonen levert via Oppdaterings-API-et. Det samme gjelder om saksnummeret endres, for eksempel fra en fordelingssak til å bli en egen sak.

Se datamodellen for kvitterings-API-et her: API for kvittering (v2)

API for oppdatering (nytt)

Det nye API-et skal håndtere all form for oppdatering i saken. API for oppdatering erstatter dagens API-er for vedtak og mangel, og inkluderer også andre typer utfall og oppdateringer som ikke er fanget opp av dagens API-er.

Bortsett fra metadata ønsker vi at kommunene kun sender data i feltene dersom noe er nytt eller endret i saken, slik at eksisterende informasjon ikke sendes flere ganger.

Kommunen kan bruke API-et til å oppdatere nøkkelinformasjon eller utfall i saken:

• Oppdatering av nøkkelinfo brukes dersom saken har endret eller oppdatert saken med saksnummer, saksbehandler, søknadstype, tiltakstype eller saksbehandlingsfrist.

• Oppdatering av utfall brukes når søker skal varsles om et utfall på et eller flere sjekkpunkt. Se oversikt over relevante utfall her: Kobling til utfall

Se datamodellen for oppdaterings-API-et: API for oppdatering (nytt)

API for status

I tillegg vil API for status oppdateres for å reflektere endringer i API-ene for kvittering og oppdatering. Vi kommer tilbake med mer informasjon om dette.

Innspill

Vi ønsker primært innspill på om:

• det er hensiktsmessig med et felles API for alle oppdateringer, eller bør det splittes opp egne API-er for vedtak, mangel og eventuelt andre utfall?

• alle nødvendige datafelter er tatt med?

• noen felt er overflødige?

• det finnes scenarier i saksbehandlingen vi ikke dekker?

Vi har lagt inn et eget kapittel kalt “Spørsmål til diskusjon” under beskrivelsen av hver datamodell.