Om tjenesten

Tiltakshavers samtykke lar tiltakshaver lese gjennom søknaden med vedlegg, og samtykke til byggeplanene, før søknaden sendes til kommunen.

Søknadssystemene får en referanse som legges inn i søknaden slik at kommunen får samtykket, sammen med tiltakshavers fødselsnummer, på en trygg måte.

Tiltakshavers samtykke er tilgjengelig for følgende tjenester:

• Rammesøknad

• Søknad om tillatelse i ett trinn

Steg for å sette opp samtykke

...

Vi går gjennom de ulike stegene under.

1. Gjør søknaden klar for signering, og last den opp i Altinn som “utfylling”

{
  "MessageId": "a10216976",
  "Subject": "Søknad om rammetillatelse, Nygate 33, Prosjekt 

...

Nygate",
  "Status": "Utfylling",
  "LastChangedDateTime": "2021-02-15T12:31:40.34",
  "CreatedDate": "2021-02-15T12:31:40.273",
  "LastChangedBy": "FILIP MOHAMED",
  "ServiceOwner": "Direktoratet for byggkvalitet",
  "Type": "FormTask",
  "ServiceCode": "4397",
  "ServiceEdition": 3,
  "AvailableAction": 2,
  "_links": {
    "self": {
      "href": "https://tt02.altinn.no/api/911455307/messages/a10216976"
    },
    "print": {
      "href": "https://tt02.altinn.no/api/911455307/messages/a10216976/print",
      "mime-type": "application/pdf"
    },
    "portalview": {
      "href": "https://tt02.altinn.no/Pages/ServiceEngine/FormsEngine/FillInForm.aspx?ReporteeElementID=10216976&ESC=4397&ESEC=3"
    },
    "metadata": {
      "href": "https://tt02.altinn.no/api/metadata/formtask/4397/3"
    },
    "form": [
      {
        "href": "https://tt02.altinn.no/api/911455307/messages/a10216976/forms/6619062",
        "name": "Søknad om rammetillatelse, Nygate 33, Prosjekt 

...

Nygate",
        "signinglocked": false,
        "signedbydefault": true
      }
    ]
  }
}

• Bruk print-lenke til å laste ned generert PDF. Dette er grunnlaget for tiltakshavers signering.

...

• Lenken vil inneholde hovedskjema og eventuelle underskjema.

...

API-et er tilgjengelig her: https://admbygg.ft-test-admbygg.dibk.no/swagger/ui/index#/TiltakshaverSignatur

...

...

API for å opprette et nytt samtykke

API-et allokerer en GUID for signeringen: POST /api/signatur/samtykketiltakshaver/ny

...

Last opp hovedskjema/underskjema og vedlegg. Hovedskjema har vedleggstype “Soknad“ ellers bruker vedleggstypen fra metadata (“Situasjonsplan”, “Kart”, “TegningNyFasade“, etc)

Eksempel på payload:

{
	"Tiltakshaver": "Silje Sag",
	"TiltakshaverPartstypeKode": "Foretak",
	"TiltakshaverOrgnr": "910065149",
	"AnsvarligSoeker": "Bjarne Bygg",
	"AnsvarligSoekerOrganisasjonsnummer": "99887799",
	"Prosjektnavn": "Bygg og bo",
	"ServiceCode": "4397",
	"ServiceEdition": "2",
	"FraSluttbrukerSystem": "System 2000",
	"Byggested": [
		{
			"Kommunenr": "9998",
			"Gardsnr": "10",
			"Bruksnr": "2",
			"Festenr": "",
			"Seksjonsnr": "",
			"Adresselinje1": "Knaggveien 77",
			"Postnr": "7766",
			"Poststed": "Hoppestad",
			"Bygningsnummer": "",
			"Bolignummer": "",
			"Kommunenavn": "Ein stad"
		}
	],
	"Tiltaktypes": [
		{
			"kodeverdi": "boligsammenslaing",
			"kodebeskrivelse": "Endring av boligenhet - Sammenslåing bolig"
		}
	]
}

Følgende felter er obligatoriske:

• Tiltakshaver

• TiltakshaverPartstypeKode Feltet skal ha verdi i henhold til kodeverdi for Partstype

• TiltakshaverOrgnr dersom tiltakshaver er noe annet enn privatperson

• AnsvarligSoeker

• AnsvarligSoekerOrganisasjonsnummer

• FraSluttbrukerSystem

• Kommunenr

• Gardsnr

• Bruksnr

• Tiltaktypes Feltene skal ha verdier i henhold til kodelisten Tiltaktype

ServiceCode og ServiceEdition er ikke i bruk. De øvrige feltene skal sendes med kallet dersom de er angitt i søknads-XMLen.

API for å laste opp søknad og vedlegg

API-et laster opp hovedskjema, underskjema og vedlegg: POST /api/signatur/samtykketiltakshaver/streamvedlegg/{id}/{vedleggstype}/{filnavn}

• Hovedskjema har vedleggstype “Soknad”

• Underskjema og vedlegg bruker vedleggstypen fra metadata, som også er representert på GeoNorge: Vedlegg og underskjema

Kommuniser

...

lenke for

...

signering til tiltakshaver

• Søknadssystemet har ansvaret for å kommuniserer lenken til signering til tiltakshaver. Vi anbefaler å bruke e-postmalen som dokumentert her: https://test-admbyggdibk.dibk.no/signatur/tiltakshaver/7ae92510-0448-44fb-a033-6644c3f281b7 (se e-posteksempel)

...

• atlassian.net/wiki/spaces/FB/pages/2601189435/Flyt+og+utfylling+av+tiltakshavers+samtykke#E-postmal

3. Vent på at tiltakshaver signerer

...

• Status endres fra “Opprettet” (over) til “Arkivert” (under).

• “AltinnArkivreferanse” legges til.

...

4. Send inn søknad med signering

Signeringen er identifisert i metadata i hovedsøknaden:

<metadata>​
  <fraSluttbrukersystem />​
  <ftbId />​
  <prosjektnavn />​
  <sluttbrukersystemUrl />​
  <samtykkeTilByggeplaner>7ae92510-0448-44fb-a033-6644c3f281b7</samtykkeTilByggeplaner>​
  <klartForSigneringFraSluttbrukersystem />​
</metadata>

Når innsendingen er mottatt i Arbeidsflyt legger vi automatisk til vedlegg på følgende måte:

	Automatisk vedlegg	Betingelse
Image Modified	XML med tiltakshavers fødselsnummer	Vedlegget legges til hvis tiltakshaver har signert som privatperson i Altinn (ikke på vegne av et foretak)
Image Modified	PDF med Altinn signert samtykke fra tiltakshaver	Vedlegget legges til med mindre vi finner vedlegget av typen “TiltakshaverSignatur” allerede vedlagt søknaden.

Image Removed

• Det er Søknadssystemet velger selv om de vil legge ved vedlegget TiltakshaverSignatur eller bare referansen for samtykkeTilByggeplaner. Dersom kun referansen legges ved, er det verdt å nevne at siden vedleggene for tiltakshavers signatur blir lagt til søknaden etter at hovedinnsendelsen er gjort i Altinn, dukker ikke disse opp i arkivet til innsender eller på utlistingen av vedlegg og underskjema i Altinn-generert PDF.

...

• For mer informasjon om mottaket i KS/eByggesak, se Mottak av tiltakshavers samtykke til byggeplaner i kommunen

Overordnet flyt

...

Tiltakshavers samtykke til byggeplaner er tilgjengelig for følgende tjenester:

...

Rammesøknad

...

Sletting av data

Filer og persondata om samtykket slettes fra tjenesten 12 måneder etter at signeringsoppdraget ble sendt. Les mer her: Varsel: Sletting av foreldet data i Ansako og Tiltakshavers samtykke til byggeplaner

Følgende filer og data blir slettet:

• XML-data som ble sendt inn for å opprette samtykket

• Vedlegg som ble lastet opp sammen med opprettelsen av samtykket

• Signert PDF fra Altinn og tilhørende XML

• Personopplysninger i databasen, inkludert tiltakshavers fødselsnummer

Status APIet for samtykket vil etter sletting anonymiserer vekk mye data, status endrer seg til “slettet” og en dato for sletting blir satt:

// /api/signatur/samtykketiltakshaver/status/4560ed5e-5bab-4af6-b434-6412c6cf6632
{
    "Id": "4560ed5e-5bab-4af6-b434-6412c6cf6632",
    "Tiltakshaver": "(ANONYMISERT)",
    "AnsvarligSoeker": "LØS SKRUE",
    "AltinnArkivreferanse": "AR11254970",
    "Status": "Slettet",
    "Prosjektnavn": "(ANONYMISERT)",
    "TiltakshaverOrganisasjonsnummer": "(ANONYMISERT)",
    "SlettetDato": "2023-05-26T01:01:08.837",
    "Vedlegg": []
}