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.

"print": {
      "href": "https://tt02.altinn.no/api/911455307/messages/a10216976/print",
      "mime-type": "application/pdf"
    },

• Lenken vil inneholde hovedskjema og eventuelle underskjema.

2. Start et en ny signering

API-et er tilgjengelig her: https://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

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://dibk.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
	XML med tiltakshavers fødselsnummer	Vedlegget legges til hvis tiltakshaver har signert som privatperson i Altinn (ikke på vegne av et foretak)
	PDF med Altinn signert samtykke fra tiltakshaver	Vedlegget legges til med mindre vi finner vedlegget av typen “TiltakshaverSignatur” allerede vedlagt søknaden.

• 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

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": []
}