Dokumenter fra kommunene som sendes ut i I forbindelse med vedtak, mangler og lignende, ønsker vi å tilgjengeliggjøre bruken av API-ene for saksbehandlingsdata, vil det ofte være behov for kommunen å sende ut et eller flere dokumenter. Vi ønsker å tilgjengeliggjøre dette dokumentet for nedlasting til søknadssystemene. Dette vil gi en helhetlig opplevelse er for søker/tiltakshaver.
Dokumentformidler
FtPB kommer til å ha et transaksjonsbasert system for å formilde de digitale dokumentene. Systemet vil beholde dokumentet kun til det er nedlastet av søknadssystemet. Dersom dokumentet ikke er lastet ned etter 30 dager, vil det slettes fra FtPBs dokumentformidler.
Ved deling av dokumenter må eByggesaksystemet ta stilling til om brevet kan deles, eller om det skal graderes og må følge sikrere distribusjonskanaler. Vi anbefaler at FtPBs dokumentformidler ikke brukes dersom dokumentet inneholder sensitive personopplysninger eller skjermet/gradert informasjon.
Last opp dokument
at søker skal få en raskere og mer brukervennlig tilgang til dokumentene i byggesaken.
eByggesakssystemet kan bruke API-et for dokumentformidler til å laste opp dokumentet i FtBs mellomlager. API-et returnerer en dokument-URL som kan sendes med følgende API-er:
API for mangel
API for vedtak
API for oppdatert milepæl
API for saksoppdatering
Se teknisk dokumentasjon og eksempel på kall: API for dokumentformidler: API-kall
Last opp dokument
API-et er en Multipart/form-data request. For å laste opp dokument kreves informasjon om metadata og saksnummer, i tillegg til selve filafilen.
...
eByggesakssystemet får returnert en dokumentID ‘dokumentID’ og en dokumentURL‘dokumentURL’. DokumentURL-en legges deretter inn i UtgaaendeDokument ‘UtgaaendeDokument’i API-et hvor dokumentet skal formidles, f.eks. API for mangel eller vedtak.
Hent dokument
Dokumentet hentes av søknadssystemene via dokumentURL-en som sendes som en del av UtgaaendeDokument i API-et hvor dokumentet skal formidles.
...
Størrelse
128 MB er maksgrense for hele payloaden i første omgang.
Automatisk sletting
Fellestjenester BYGG tilbyr kun mellomlagring av dokumenter, og skal ikke fungere som et arkiv. Dokumenter lastet opp til dokumentformidleren har derfor en midlertidig levetid.
Dokumentene slettes automatisk etter 30 dager. Gjøres det en GET-forespørsel på det slettede dokumentet vil APIet respondere med 410 Gone.
Gradert informasjon
Ved deling av dokumenter må eByggesaksystemet ta stilling til om brevet kan deles, eller om det skal graderes og må følge sikrere distribusjonskanaler. FtPBs dokumentformidler skal ikke brukes dersom dokumentet inneholder sensitive personopplysninger eller skjermet/gradert informasjon.
Distribusjonsmetode
Dokumentene kan formidles gjennom nåværende systemer og felleskomponenter som SvarUt, e-post og andre kanaler, i tillegg til via Fellestjenester BYGG. Datamodellen for utgående dokument har et eget felt for distribusjon, der distribusjonsmetode følger kodeliste på GeoNorge og gjenspeiler dette.
Hent dokument
Dokumentet hentes av søknadssystemene via dokumentURL-en som sendes som en del av ‘UtgaaendeDokument’ i API-et hvor dokumentet skal formidles.