Behandlingsstatus, Signeringstjenesten
Introduksjon
Hver erklæring vil ha en status som Signeringstjenesten og sluttbrukersystemene kan bruke. Liste over statuser kan hentes fra GeoNorge: https://register.geonorge.no/kodelister/byggesoknad/status-for-erkleringer
Bruksområder for statusene vil blant annet være å
sende ansvarlig foretak til situasjonsbestemte landingssider når de trykker på lenka,
gi nødvendig informasjon til ansvarlig søker, og
brukes i gjennomføringsplanen for å gi kommunen mer informasjon
Sideinnhold:
Oversikt over statuser
Under er en oversikt og forklaring til de ulike statusene, og om det er signeringstjenesten eller søknadssystemet som har ansvaret for å oppdatere hver status:
Status | Beskrivelse | Hvor settes statusen? |
---|---|---|
Til signering | Erklæringer som er sendt til signering, men ikke signert eller avvist. Default status. | Signeringstjenesten |
I arbeid | Erklæringer som er redigert av ansvarlig foretak, men ikke signert eller avvist. | Signeringstjenesten |
Signert | Erklæringer som er signert med eller uten endringer fra ansvarlig foretak. | Signeringstjenesten |
Signert manuelt | Erklæringer som er signert utenfor Fellestjenester BYGG, for eksempel på blankett. | Søknadssystemet |
Avvist | Erklæringer som er avvist og returnert fra ansvarlig foretak. | Signeringstjenesten |
Utgått | Erklæringer som ikke er signert eller avvist innen tidsfristen. | Signeringstjenesten |
Trukket | Erklæringer som er trukket tilbake fra ansvarlig søker. | Søknadssystemet |
Avsluttet | Erklæringer hvor ansvarsområdet er avsluttet. | Søknadssystemet |
Feilet | Sendinger som har feilet grunnet tekniske problemer. | Signeringstjenesten eller søknadssystemet |
Forskjeller mellom distribuert og signert erklæring
Alle erklæringer signert i Signeringstjenesten får status “Signert”, uavhengig av om ansvarlig foretak har gjort endringer eller ikke. Vi oppfordrer søknadssystemet til å sammenligne XML for signert erklæring med erklæringen som ble sendt ut, og oppdatere nødvendig informasjon i søknadsløsningen. Oversikt over hvilke felter som kan endres av ansvarlig foretak vil fremkomme av denne siden: Flyt og utfylling, Signeringstjenesten
Forskjellen på Trukket og Feilet
Status Trukket skal brukes dersom ansvarlig søker trekker tilbake erklæringen. Ansvarlig søker bør kunne skrive årsaken til at erklæringen ble trukket i et fritekstfelt.
Status Feilet skal kun brukes ved alvorlige, tekniske feil. Statusen kan settes av søknadssystemet eller FtB dersom feilen ikke er forbigående, og må begrunnes.
Se landingssidene nederst på denne siden for å se forskjellen for det ansvarlige foretaket dersom man trykker på en lenke med status Trukket eller Feilet.
Angivelse av status fra søknadssystem
Søknadssystemet kan sette disse statusene:
Signert manuelt (initieres fra ansvarlig søker)
Trukket (initieres fra ansvarlig søker)
Avsluttet (initieres fra ansvarlig søker)
Feilet (settes av søknadssystem)
Under følger teknisk oppsett for hvordan statusene kan settes fra søknadssystemet.
NB: Statusene er endelige og kan ikke endres dersom de er satt.
URL
API | POST | /api/v1/skjemainnsending/{referenceId}/status |
URL-en fremkommer også ved oppretting av erklæring via Tjeneste-API:
Request
Send en request med følgende oppsett:
{
"Status": "Status",
"Aarsak": "Årsaken til at statusen har blitt endret"
}
Både status og aarsak er obligatorisk å angi.
Eksempel
Landingssider ved endret status
Når det ansvarlige foretaket trykker på lenka til et signeringsoppdrag, vil foretaket komme til ulike landingssider avhengig av hvilken status erklæringen har. Skjermbilder for noen av statusene er lagt inn under.
Utgått
Trukket
Feilet
Avsluttet
Signert manuelt