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

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

1. Forhåndsvalidere søknaden

Rest API for validering av skjema i fellestjenester bygg

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

Eksempel på valideringsresultat:

{
"Errors": 2,
"Warnings": 1,
"messages": [
{
"message": "'Vedlegg' ny fasade, ny plantegning og nytt snitt er anbefalt da der er valgt endring av areal eller annet. De kan være samlet på ett eller flere vedlegg.",
"messagetype": "WARNING",
"reference": "4402.1.73",
"xpathField": "EndringAvTillatelse/endringAreal"
},
{
"message": "Dersom ansvarlig søker er et foretak, skal Gjennomføringsplan eller Søknad om ansvarsrett for selvbygger følge med søknaden.",
"messagetype": "ERROR",
"reference": "4402.1.70",
"xpathField": "EndringAvTillatelse/ansvarligSoeker/organisasjonsnummer"
},
{
"message": "Ugyldig kommunenummer ({0})",
"messagetype": "ERROR",
"reference": "4402.1.2",
"xpathField": "EndringAvTillatelse/eiendomByggested[0]/eiendomsidentifikasjon/kommunenummer"
}
],

Oppdatering 22.09.20: Bruk “rulesChecked” for å finne mer informasjon om sjekkpunktet

I løpet av 2020 går vi gradvis over fra å bruke "xpathField": "/Vedlegg" til å bruke stien til feltet valideringen gjelder (f.eks. "xpathField": "EndringAvTillatelse/endringAreal" i eksempelet over).

For å se hvilken “precondition” og sjekkpunkt valideringen gjelder, kan dere søke “reference”=”id” i “rulesChecked” i validerings-APIet. Her finner dere mer informasjon:

{
"id": "4402.1.73",
"message": "'Vedlegg' ny fasade, ny plantegning og nytt snitt er anbefalt da der er valgt endring av areal eller annet. De kan være samlet på ett eller flere vedlegg.",
"messagetype": "WARNING",
"preCondition": "Vedlegg",
"checklistReference": "",
"xpathField": "EndringAvTillatelse/endringAreal"
}

Metoden kan for eksempel brukes til å samle alle valideringsregler som omhandler vedlegg eller lenke til sjekklistepunkter.

Denne bruken av validerings-APIet er implementert i endringssøknad. Vi vil også rulle ut denne formen i rammesøknad, ettrinnssøknad, tiltak uten ansvarsrett utover høsten 2020.

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

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