Versjonssammenligning

Gammel versjon 17

changes.mady.by.user Tor Oskar Ova Johnsen

Lagret den

sammenlignet med

Ny versjon Gjeldende

changes.mady.by.user Helga Jerven

Lagret den

Nøkkel

  • Denne linjen ble lagt til.
  • Denne linjen ble fjernet.
  • Formateringen ble endret.

Informasjon om datamodellen for tjenesten finnes her: Distribusjonstjeneste for erklæring om ansvarsrett

...

StegBeskrivelseAPIDatamodellInformasjon
1Innsending av Distribusjonstjenestehttps://www.altinn.no/api/Help/Api/POST-who-Messages_language_complete_sign (complete=true)https://fellesbygg.dibk.no/Metadata?ServiceCode=4762&ServiceEdition=1
2Hent status via Status APIhttps://admbygg.dibk.no/api/status/{Arkiv Referanse}
Detaljert beskrivelse i bolk under.

- Før innseding

Status API:
"Finner ingen forsendelse med denne Altinn arkivreferanse"

- Når ansvarsrett skjemaer er distribuert til ansvarlige foretak.
Status API rapporterer "submittedPrefilled"



Status API:
"Distribusjoner": [
{
 "Distribusjonstype": "Erklæring om ansvarsrett",
 "Status": "submittedPrefilled",
 "ReferanseIdSendt": "8190566",
}]

- Når ansvarsrett skjemaet er signert av ansvarlig foretak.
Status API rapporterer "signed". Dette er vanligvis en kortvarig status siden tjenesten vil videresende skjemaet til Ansvarlig Søker umiddelbart.

Status API:
"Distribusjoner": [
{
 "Distribusjonstype": "Erklæring om ansvarsrett",
 "Status": "signed",
 "ReferanseIdSignert": "AR3302601",
 "Signert": "2017-06-13T14:26:10.64",
}]

- Når ansvarsrett skjemaet er videresendt tilbake til Ansvarlig Søker viser Status API "recieptSent" for den aktuelle ansvarsretten.

Denne statusen gir anledning til at søknadssystemet kan gå inn å laste ned signert PDF og data XML av ansvarsrett skjemaet fra Ansvarlig Søkers meldingsboks i Altinn.

Status felt "ReferanseIdKvittering" kan brukes til å finne melding over REST API ved at bokstaven "b" blir lagt til foran tallet: "ReferanseIdKvittering": "4476193" blir til b4476193

Bokstaven har mening b = arkivert (skjema under utfylling har referansen a = aktivt) 



Status API:
"Distribusjoner": [
 {
 "Distribusjonstype": "Erklæring om ansvarsrett",
 "ReferanseSluttbrukersystem": "c6e8b5db-a2c9-4174-befb-c0a594204565",
 "Status": "recieptSent",
 "ReferanseIdKvittering": "4476193",
 "SendtKvittering": "2017-06-13T14:27:23.027"
 }
3Hente den enkelte signerte Erklæring om Ansvarsrett skjema fra Ansvarlig Søkers meldingsboks.https://www.altinn.no/api/Help/Api/GET-who-Messages-messageId_language
hvor {messageId} er b{ReferanseIdKvittering}
"language=1044"

Erklæring om Ansvarsrett datamodell:

https://fellesbygg.dibk.no/Metadata?ServiceCode=4419&ServiceEdition=1


...

Blir "error" rapportert i APIet har det oppstått en ikke-gjenopprettbar feil og distribusjonene må sendes om igjen.


Ansvarsrettliste (Datamodell for distribusjonstjenesten)

Distribusjonstjenesten for ansvarsrett er basert på en Altinn innsendingstjeneste med en XSD definert XML med foretak og ansvarsområde data.

Datamodellen og andre metadata om tjenesten kan lastes ned her:

https://fellesbygg.dibk.no/Metadata?ServiceCode=4762&ServiceEdition=1


Hovedelementer i datamodellen:

Image Added


Beskrivelse av datamodellen:

HovedelementNodeBeskrivelseUnderfelterObjekt
Distribusjon AnsvarsrettEiendomByggested

Adressen til byggeprosjektet. Liste siden et byggeprosjekt kan omhandle flere adresser


  • Kommunenummer
  • Gårdsnummer
  • Bruksnummer
  • Festenummer
  • Seksjonsnummer
  • Adresse
  • Bygningsnummer
  • Bolignummer

Image Added


GjennomfoeringsPlan (data om ansvarsretter)Liste over foretak med ansvarsretter som skal signeres for
  • Fagomraade
  • Funksjon [kodeliste]
  • BeskrivelseAvAnsvarsomraade
  • Tiltaksklasse [kodeliste]
  • Foretak
    • Partstype [kodeliste]
    • Kontaktperson
    • Organisasjonsnummer
    • Navn
    • Adresse
    • Telefon/mobilnummer/epost
    • HarSentralGodkjenning
  • SamsvarKontrollPlanlagtVed ...
    • Rammetillatelse
    • Igangsettingstillatelse
    • MidlertidigBrukstillatelse
    • Ferdigattest
  • VaarReferanse
  • Varsling
  • FristDato


Det Altinn genererte Erklæring om Ansvarsrett skjemaet vill be sendt til organisasjonsnummeret i Foretak objektet.

Feltet "fristDato" blir oppgitt i Altinn som datoen man ønsker svar innen. Skjemaet er fremdeles tilgjengelig for utfylling etter denne datoen.


Data for "harSentralGodkjenning" kan settes til "usann" i distribusjonstjenesten. Ansvarlig foretak har anledning til å oppdatere dette før innsendelsen.

Image Added

Image Added


AnsvarligSoekerMottaker av signert skjema
  • Partstype [kodeliste]
  • Organisasjonsnummer
  • Kontaktperson
  • Navn
  • Adresse
  • Telefon/mobilnummer/epost


Erklæring om Ansvarsrett skjemaer behandlet i Altinn blir sendt til Altinn meldingsboksen til Ansvarlig Søker. Det er nødvendig å angi Ansvarlig Søkers organisasjonsnummer som er grunnlaget for behandling i Altinn.



Image Added

Kodelister brukt:

Funksjon

https://register.geonorge.no/subregister/byggesoknad/direktoratet-for-byggkvalitet/funksjon
Tiltaksklassehttps://register.geonorge.no/subregister/byggesoknad/direktoratet-for-byggkvalitet/tiltaksklasse
Partstypehttps://register.geonorge.no/subregister/byggesoknad/direktoratet-for-byggkvalitet/partstype


Det genererte Erklæring om Ansvarsrett skjemaet blir fylt ut som følger basert på dataene i distribusjonstjenesten:

Image Added

Image Added


Valgfrie felt

Det er lagt opp til at søknadsystem kan bruke visse valgfrie felt for bruk i søknadsystemet.

Ønskes det at selve distribusjonsinnsendelsen merkes med en egendefinert ID, kan feltet "hovedinnsendingsnummer" brukes:

Image Added


dibk:DistribusjonAnsvarsrett/dibk:hovedinnsendingsnummer


Den enkelte ansvarsrett kan også merkes med en selv definert ID "vaarReferanse":

Image Added

dibk:DistribusjonAnsvarsrett/dibk:gjennomfoeringsplan/dibk:gjenn/dibk:vaarReferanse


Det er også mulig å sette opp at Ansvarlig Foretak mottar en e-post varsling når et nytt Erklæring om Ansvarsrett skjema har blitt sendt til Altinn meldingsboks. Da må

  • Felte "varsling" settes til sann (dibk:DistribusjonAnsvarsrett/dibk:gjennomfoeringsplan/dibk:gjenn/dibk:varsling)
  • En e-post addresse må være oppgitt i foretak objektet (dibk:DistribusjonAnsvarsrett/dibk:gjennomfoeringsplan/dibk:gjenn/dibk:foretak/dibk:epost) 

 


Altinn Eksempel

Distribusjonstjeneste sendt inn til Altinn:

View file
nameDistribusjonstjeneste for erklæring av ansvarsrettDOK.pdf
height250


Ansvarsrett signert

View file
nameErklæring om AnsvarsrettDOK.pdf
height250


Ansvarlig søker får melding om signatur


Image Added