Steg for å sette opp samtykke

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, Prosjektnavn",
  "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, Prosjektnavn",
        "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.

FtB validerer ikke at søknaden er komplett før tiltakshavers samtykke kan brukes. Søknadssystemene må derfor sørge for at funksjonaliteten for tiltakshavers samtykke ikke er tilgjengelig før hovedsøknaden har gått gjennom valideringen. Søknad med vedlegg skal være identiske med det som senere sendes til kommunen.

2. Start et en ny signering

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

“Ny” 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"
		}
	]
}

TiltakshaverPartstypeKode skal ha verdi i henhold til kodenlisten https://register.geonorge.no/kodelister/byggesoknad/partstype
TiltakshaverOrgnr fylles ut dersom tiltakshaver er noe annet enn privatperson

Last opp hovedskjema/underskjema og vedlegg. Hovedskjema har vedleggstype “Soknad“ ellers bruker vedleggstypen fra metadata (“Situasjonsplan”, “Kart”, “TegningNyFasade“, etc)
POST /api/signatur/samtykketiltakshaver/streamvedlegg/{id}/{vedleggstype}/{filnavn}
Kommuniser en lenke for signeringen til tiltakshaver: https://test-admbygg.dibk.no/signatur/tiltakshaver/7ae92510-0448-44fb-a033-6644c3f281b7 (se e-posteksempel)

Et e-postforslag finnes også i testmotor (der er lenken skjult under informativ tekst, noe vi ikke anbefaler). Se tips til sikring av e-post her: Sikkerhetstiltak ved bruk av e-post

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

<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.

Flyt etter signering

Det er 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.

Overordnet flyt

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

Rammesøknad
Søknad om tillatelse i ett trinn