Metadata

fraSluttbrukersystem

Feltet fylles med navnet til søknadssystemet. Feltet er påkrevet slik at avgiversystemet kan spores i FtB.

ftbId

<metadata>
  <fraSluttbrukersystem />
  <ftbId>5c8d5254-1617-43a4-a15a-9422399f561e</ftbId>
  <prosjektnavn />
  <sluttbrukersystemUrl />
  <samtykkeTilByggeplaner />
  <klartForSigneringFraSluttbrukersystem>true</klartForSigneringFraSluttbrukersystem>
</metadata>

ID som kan angis for alle innsendinger for samme byggesak.
GUID som defineres av søknadssystemet.
FtB oppretter en tabell med AR til ftbId relasjoner i databasen (som illustrert under)
Kobler sammen flere innsendinger (AR) til samme byggesak
Valgfri
Fremtidig bruksområde er å kunne presentere en komplett status på byggesak via API (data fra søknadsystem og kommunen)

prosjektnavn

Valgfritt felt om man ønsker å legge ved et prosjektnavn. Gir bedre visning i Altinn meldinger til ansvarlig søker.

sluttbrukersystemUrl

Valgfri URL som kan hjelpe å komme tilbake til søknadsystemet eller direkte til søknaden. Blir vist i Altinn istedet for å tillate skjemautfylling.

samtykkeTilByggeplaner

Id (GUID) for utført signatur for tiltakshaver (veiviser).

Sluttbrukersystemet får tilgang til en ID som identifiserer at tiltakshaver har signert for byggeplanene gjennom veiviser for “Samtykke til Byggeplaner”.

Når id er fylt ut legger vi på et ekstra vedlegg med tiltakshavers fødselsnummer som kun blir levert til kommunen. Fødselsnummer legges ved for å kunne støtte elektronisk kommunikasjon fra kommunen (for eksempel fakturering) uten at søknadssystemene trenger å vite om eller håndterer fødselsnummeret.

Tjenesten for å innhente tiltakshavers signatur gjennom “Samtykke til Byggeplaner” blir tilgjengelig i første kvartal 2021.

klartForSigneringFraSluttbrukersystem

Dette feltet støtter en mekanisme for å forhindre at brukere sender inn påbegynte søknader direkte fra Altinn portalen. Den legger også på en melding på toppen av skjemaet for å indikerer at dette ikke er et ferdig utfylt skjema. Dette forhindrer brukere å laste ned en forhåndsvisning av skjemaet i Altinn og sende dette inn til kommunen.

Hvis feltet settes til “true” vil det ikke ha noen innvikring på skjemabehandlingen, så dette er den bakoverkompatible løsningen.

Hvis feltet ikke blir satt (null), fungerer det som om det er satt til false som beskrevet under.

Bruk av feltet

Når innsendingsobjektet blir initiert i Altinn, setter man feltet til “false”.
Gjennom REST APIet oppdaterer man søknaden med underskjema og eller vedlegg etter behov.
Rett før søknadens skal signeres og sendes inn, sender men en oppdatering av XML (ny XML av hovedskjema) med feltet satt til “true.

Ved REST API innsending for signering med feltet satt til “false” får man denne feilmeldingen:

status=error{
"ValidationErrors":[
  {
  "FieldName":"ns4:klartForSigneringFraSluttbrukersystem",
  "ErrorMessage":"Søknaden må sendes inn fra et godkjent søknadssystem som støtter Fellestjenester bygg"
  }
]
} 
400 Form validation failed, see the attached validation details

Hvis feltet er tilgjengelig på underskjema (slik som Gjennomføringsplan V6) settes det til “true”.