Validering av søknaden gjøres i flere trinn. 

1. Det anbefales å forhåndsvalidere søknaden før innsending. Dette kan gjøres ved å bruke valideringsAPI til fellestjenester bygg
   1. Dette validerings APIet sjekker alle søknadsdata men kan ikke validere data angående innlogget bruker og foretaksrepresentasjon fra Altinn
2. Når søknaden sendes inn til Altinn for signering og innsending så valideres strukturen på søknaden og lovlige verdier.
   1. Status på denne endelige valideringen kan hentes via Status API. Saksflyten kan ta opp til 5 minutter (muligens mer ved mange og store vedlegg).
3. Validering av datainnhold og forretningsregler(se forretningsregler under hvert skjema) gjøres før videresending til kommune gjennom FIKS (samme validering som pkt 1).
   1. Sendes videre hvis ingen feil oppdages
   2. Hvis feil oppdages så sendes en melding til søkers meldingsboks i Altinn

Forhåndsvalidere søknaden

Rest API for validering av skjema i fellestjenester bygg

Se http://test-admbygg.dibk.no/swagger/ui/index#!/FormValidation/FormValidation_ValidateForm

Eksempel på valideringsresultat

{
"Errors": 1,
"Warnings": 3,
"messages": [
{
"message": "Vedlegg Avkjørselsplan er anbefalt da det er valgt at tiltaket gir ny eller endret adkomst",
"messagetype": "WARNING",
"reference": "4397.2.30",
"xpathField": "/Vedlegg"
},
{
"message": "Utregningen av utnyttelsesgrad er ikke riktig for %BYA, %BRA eller TU. Utfylt grad av utnytting er 23 og beregnet grad av utnytting er 24. Utregning ((arealBebyggelseEksisterende - arealBebyggelseSomSkalRives + arealBebyggelseNytt + parkeringsarealTerreng)/tomtearealBeregnet)*100 avrundet opp.",
"messagetype": "WARNING",
"reference": "4397.2.49",
"xpathField": "/Rammetillatelse/rammebetingelser/arealdisponering/beregnetGradAvUtnytting"
},
{
"message": "Når en velger at yrkesbygg berører arbeidsplasser må samtykke fra Arbeidstilsynet være på plass før igangsettingstillatelse kan gis. Det anbefales at enten vedlegg SamtykkeArbeidstilsynet eller underskjema Søknad om Arbeidstilsynets samtykke legges ved denne søknaden.",
"messagetype": "WARNING",
"reference": "4397.2.7",
"xpathField": "/Rammetillatelse/rammebetingelser/generelleVilkaar/beroererArbeidsplasser"
},
{
"message": "Underskjema Opplysninger gitt i nabovarsel (GjenpartNabovarsel) mangler da nabovarsling kreves for tiltaket.",
"messagetype": "ERROR",
"reference": "4397.2.14",
"xpathField": "/Rammetillatelse/varsling/fritattFraNabovarsling"
}
]
}

Validering ved innsending i Altinn API

Se Altinn dokumentasjon for validering - https://altinn.github.io/docs/guides/integrasjon/sluttbrukere/api/meldinger/validere/

Eks Ikke valgt gyldig kodeverdi:

HTTP Status Code: 401 (Form validation failed, see the attached validation details)

{"ValidationErrors": [

    {"FieldName": "ta:kodeverdi",

      "ErrorMessage": "Ugyldig vegtype. Verdien er ikke en gyldig verdi i henhold til kodelisten for vegtyper. Ugyldig verdi i feltet: /ta:TiltakUtenAnsvarsrett/ta:beskrivelseAvTiltak/ta:tiltak/ta:adkomst/ta:vegrett/ta:vegrett/ta:vegtype/ta:kodeverdi" }

]}

Eks brukt ugyldig vedleggstype:

HTTP Status Code: 401 Attachment validation failed: AttachmentType(s) Situasjonskart, Situasjonskart is invalid for this service.

Validering av datainnhold og forretningsregler i fellestjenester bygg

Denne valideringen foregår før sending til kommunen gjennom FIKS og er den samme som gjøres i evt forhåndsvalidering.

Hvis valideringen inneholder feil så vil denne stoppes og tilbakemelding om valideringsfeil sendes søker.

For å feilsøke situasjonen så kan det være nyttig å se kvitteringen i Altinn på hva som er sendt fra sluttbrukersystem til Altinn. Spesielt der vedlegg og underskjema melder om feil eller advarsler

Kobling mot nasjonale sjekklister for byggesak

Se dokumentasjon her: Nasjonale sjekklister for byggesak