API for saksoppdatering: Valideringsregler
Oversikt
Feltene merket med rødt er alltid obligatoriske å angi. Felter merket med oransje er obligatoriske å oppgi under gitte betingelser. Hvilke betingelser det er fremgår av kravtabellen under.
For mer informasjon om validering av metadata, saksnummer, milepæl og avsenders kontaktpunkt, se felles datafelt eller kravtabellen under.
Bortsett fra for metadata og saksnummer, skal feltene kun oppdateres dersom det er noe nytt å melde i saken.
Endring av søknadstype
Søknadstype skal kun sendes med API for saksoppdatering dersom søknadstypen endres fra ettrinnssøknad til rammesøknad. Vi validerer på at søknadstype er RS dersom feltet har verdi.
Endring av søknadstype skal alltid skje etter avtale mellom kommunen og ansvarlig søker, og dokumenteres enten med en melding eller et utgående brev.
Dersom søknadstypen skal endres av andre grunner, for eksempel fra uten ansvarsrett eller fra ferdigattest til midlertidig brukstillatelse, oppfordrer vi til at kommunen avslår søknaden, og at en ny søknad sendes inn.
Kravtabell
Kravtabellen under angir valideringsreglene for API for saksoppdatering.
Felt | Validering | Kommentar/betingelse |
|---|---|---|
Metadata | Du må fylle ut metadata om forsendelsen. |
|
FraEbyggesakssystem | Du må fylle ut navnet på eByggesakssystemet som oppdateringen sendes fra. |
|
InnsendingReferanse | Du må fylle ut referansen til innsendingen som oppdateringen svarer på. Dette er ofte en Altinn-referanse. |
|
FtBID | - |
|
AvsenderID | Du må fylle ut ‘avsenderID’. Dersom oppdateringen sendes fra en kommune, skal kommunenummer oppgis. Dersom oppdateringen sendes fra en sektormyndighet, skal organisasjonsnummer brukes. |
|
| ‘AvsenderID’ ({0}) er på feil format. ‘AvsenderID’ skal bestå av 4 siffer ved bruk av kommunenummer, eller 9 siffer ved bruk av organisasjonsnummer. | Slår ut dersom ‘AvsenderID’ ikke er 4 eller 9 siffer. |
AvsenderNavn | Du må fylle ut navnet på kommunen/sektormyndigheten oppdateringen sendes fra. |
|
EkspedertDato | Du må fylle ut datoen for når oppdateringen blir ekspedert. |
|
| ‘EkspedertDato’ kan ikke være nyere enn dagens dato. | Slår ut dersom ‘EkspedertDato’ er dagens dato eller tidligere. |
OffentligJournalUrl | - |
|
Saksnummer | Du må oppgi tildelt saksnummer med saksår og sakssekvensnummer. |
|
Saksaar | Du må oppgi saksnummer med saksår. |
|
| Saksår ({0}) for kommunens saksnummer er ikke gyldig. Saksåret må inneholde fire siffer, og kan ikke være nyere enn inneværende år. | Slår ut hvis
|
Sakssekvensnummer | Du må oppgi saksnummer med sekvensnummer. |
|
Journalpostnummer | - |
|
Melding | Du har oppdatert søknadstypen fra søknad i ett trinn til søknad om rammetillatelse. Du må sende en bekreftelse på at dette er avtalt med søker i ‘UtgaaendeDokument‘ eller ‘Melding‘. | Slår ut dersom
|
Utgående dokument | - | Se regel for melding. |
Distribusjon | Du må fylle ut informasjon om distribusjon av utgående dokument. | Slår ut hvis det er oppgitt noe annet i utgående dokument (f.eks. dokumentnavn) |
| Du må fylle ut distribusjonsmetoden for utgående dokument. Du kan sjekke gyldige distribusjonsmetoder på https://register.geonorge.no/kodelister/ebyggesak/distribusjonsmetode | Slår ut hvis det er oppgitt noe annet i utgående dokument (f.eks. dokumentnavn) |
| ‘{0}' er en ugyldig kodeverdi for 'distribusjonsmetode’. Gyldige kodeverdier er: ftb, svarut, epost, annen. Du kan sjekke gyldige verdier her: https://register.geonorge.no/kodelister/ebyggesak/distribusjonsmetode |
|
| Du har valgt å laste opp det utgående dokumentet til Fellestjenester BYGGs dokumentlager. Da må du oppgi dokumentets URL for nedlastning. | Slår ut dersom distribusjonsmetode = ftb |
DokumentNavn | Du må fylle ut navnet til det utgående dokumentet. | Slår ut hvis det er oppgitt noe annet i utgående dokument (f.eks. distribusjonsmetode) |
MimeType | Du har valgt å laste opp det utgående dokumentet til Fellestjenester BYGGs dokumentlager. Da må du oppgi filtypen for det utgående dokumentet. | Slår ut dersom distribusjonsmetode = ftb |
DokumentStorrelse | - |
|
Hoveddokument | Du må velge om det utgående dokumentet er et hoveddokument eller et vedlegg. | Slår ut hvis det er oppgitt noe annet i utgående dokument (f.eks. dokumentnavn) |
| Du må oppdatere saken med minst en av følgende opplysninger: soknadstype, tiltakstype, kontaktpunkt, eiendom eller utgående dokument. |
|
AvsenderKontaktpunkt | - |
|
Navn | - |
|
E-post | Kontaktpunktets e-postadresse ({0}) er på feil format. Riktig format er navn@domene.no. | Slår ut hvis e-postadresse er oppgitt, men på feil format. |
Telefon | Kontaktpunktets telefonnummer ({0}) er på feil format. Telefonnummeret kan bare inneholde tall og +. | Slår ut hvis telefonnummer er oppgitt, men på feil format. |
Mobil | Kontaktpunktets mobilnummer ({0}) er på feil format. Mobilnummeret kan bare inneholde tall og +. | Slår ut hvis mobilnummer er oppgitt, men på feil format. |
Soknadstype | ‘{0}' er en ugyldig kodeverdi for 'Soknadstype’. Gyldig kodeverdi er: RS. Du kan sjekke gyldige verdier her: https://register.geonorge.no/kodelister/byggesoknad/soknadstype |
|
Tiltakstype | - |
|
Eiendom | - |
|
Adresselinje 1 | Du må oppgi gjeldende adresselinje 1 for tiltaket. | Slår ut hvis det er verdi i et av de andre feltene for adresse, f.eks. gardsnummer. |
Gardsnummer | Du må oppgi det gjeldende gårdsnummeret for tiltaket. | Slår ut hvis det er verdi i et av de andre feltene for adresse, f.eks. adresselinje 1. |
Bruksnummer | Du må oppgi det gjeldende bruksnummeret for tiltaket. | Slår ut hvis det er verdi i et av de andre feltene for adresse, f.eks. adresselinje 1. |
Seksjonsnummer | - |
|
Festenummer | - |
|
Bygningsnummer | - |
|
Bruksenhetsnummer | - |
|