Forslagsstiller må sende inn et høringsbrev med tilhørende vedlegg som så blir distribuert ut til høringsmyndigheter.
Swagger: Her skal dere finne informasjon som er spesifikk for Altinn3 applikasjonen for varsel om høring og offentlig ettersyn
Den er et tillegg til den generiske veilederen rundt Altinn3 applikasjoner, se her https://dibk.apps.tt02.altinn.no/dibk/varsel-hoffe/swagger/index.html
org - dibk
app - varsel-hoffe
Opprett Høring og offentlig ettersyn
API
Send inn høringsbrev og vedlegg som skal være med i høring og offentlig ettersyn.
Innsendelsen utføres med Post-kall med Multipart Form.
TT02: atlassian.net/wiki/spaces/FP/embed/3268149249
Altinn3 Applikasjon
App navn | |
---|---|
varsel-hoffe | |
Url til tjeneste | |
Test |
...
Pålagte deler av Multipart Form:
Instance
...
Format: Text/JSON
...
Extension: .json
...
...
Det er en JSON som beskriver hvem som oppretter høring og offentlig ettersyn.
...
I eksempelet over er det organisasjonen 987654321 som oppretter dette.
Hoeringsbrev
Format: application/xml
Extension: .xml
Minst en av følgende vedlegg må være med:
PlankartPdf
Format: application/pdf
Extension: .pdf
PlankartGml
Format: application/gml+xml eller application/octet-stream
Extension: .pdf
PlankartSosi
Format: application/octet-stream
Extension: .sos, .sosi
Minst en av følgende vedlegg må være med:
PlanbestemmelserPdf
Format: application/pdf
Extension: .pdf
PlanbestemmelserXml
Format: application/xml
Extension: .sos, .sosi
Dersom det er krav om konsekvensutredning:
Konsekvensutredning
Format: application/pdf, image/png, image/tiff, image/jpeg
Extension: .pdf, .png, .tiff, .tif, .jpg, .jpeg
Valgfri vedlegg:
Planbeskrivelse
Format: application/pdf, image/png, image/tiff, image/jpeg
Extension: .pdf, .png, .tiff, .tif, .jpg, .jpeg
Illustrasjoner
Format: application/pdf, image/png, image/tiff, image/jpeg
Extension: .pdf, .png, .tiff, .tif, .jpg, .jpeg
ROSAnalyse
Format: application/pdf, image/png, image/tiff, image/jpeg
Extension: .pdf, .png, .tiff, .tif, .jpg, .jpeg
Annet
Format: application/pdf, image/png, image/tiff, image/jpeg
Extension: .pdf, .png, .tiff, .tif, .jpg, .jpeg
Autentisering og autorisering
Autentisering og autorisering skjer med Access Token fra Altinn Exchange. For å få et Access Token må man utføre Exchange av et ID-porten-token mot Altinn Exchange. Se dokumentasjon: https://docs.altinn.studio/authentication/
Innsender må være den samme som oppgis i dataelementet “instance”, eller ha Plan- og byggrollen i Altinn for organisasjonen. Se dokumentasjon fra Altinn: https://www.altinn.no/hjelp/profil/roller-og-rettigheter/
Response:
...
Start distribusjon
Når instancen er opprettet skal man starte validering og distribusjon ved å bruke API-endepunktet:
TT02: PUT https://dibk.apps.tt02.altinn.no/dibk/varsel-hoffe/instances/{partyID}/{archiveReference}/process/next
Altinn dokumentasjon: https://docs.altinn.studio/api/apps/process/#get-the-next-tasks-in-a-process
Varselbrevet(xml) og en evt. GML-fil av planområde blir validert
Valideringsfeil => stopper innsending og returnerer en feilkode.
For å sjekke valideringsfeil må valideringsendepunktet benyttes:
Genererer en PDF av varselbrevet(xml).
Legges i en kø for distribusjon til berørte parter og høringsmyndigheter.
Høringsmyndigheter mottar varselet i svar inn.
berørte parter mottar varselet i Altinn.
Berørte parter mottar enten en epost eller et SMS-varsel om at de har mottatt et planvarsel i sin Altinn-innboks.
Forslagsstiller mottar en kvittering i sin Altinn innboks hvor det står hvem som har blitt varselet og om det evt. har feilet.
...
Konfigurasjon av datatyper
https://dibk.atlassian.net/wiki/spaces/FB/pages/3018620929/Altinn+App+API#Data-elementer
Hovedskjema og underskjema
Oversikt over datatyper som blir brukt som “hovedskjema” og “underskjema”. Resten blir ansett som vedlegg eller systemfiler. Begrepene “hovedskjema” og “underskjema” henger igjen fra Altinn2 og har ingen teknisk betydning, men det omhandler datatyper som kan inneholde strukturerte data som gjerne blir validert og sjekket ved innsending.
Datatype | ||
---|---|---|
Hovedskjema | Datamodell | Valideringsregler |
Hoeringsbrev | https://dibk.atlassian.net/wiki/spaces/FP/pages/2675998721/Dataflyt+og+datamodeller#Datamodeller | |
Underskjema | ||
Plankart | https://dibk.atlassian.net/wiki/spaces/FP/pages/2675998721/Dataflyt+og+datamodeller#Plankart |
Signert PDF
Datatyper for signert PDF.
Datatype | Datatype som er grunnlag for PDF |
---|---|
Hovedskjema | |
OffentligEttersyn | Hoeringsbrev |