Informasjon om datamodellen for tjenesten finnes her: Distribusjonstjeneste for erklæring om ansvarsrett
...
- Ansvarlig søker/søknadssystemet sender inn en liste av de Ansvarlige Foretak som skal signere for ansvarsrett. Listen inneholder adresseinformasjon og beskrivelse av ansvarsområdet for foretakene som skal signere for ansvarsrett. Videre er det gitt addresse infomrsjon for prosjektet hvor jobben skal utføres og informasjon om avsender (Ansvarlig Søker).
Vi har lagt opp til at bare nye signeringer blir lagt i listen, underforstått at søknadssystemet passer på en hovedliste av ansvarlige foretak og deres statuser. Listen sendes inn med en Altinn innsendingstjeneste over REST API. Vi bruker tilnærmet samme datamodell som gjennomføringsplan. Tjenesteinformasjon og XSD kan hentes her:
https://fellesbygg.dibk.no/Metadata?ServiceCode=4762&ServiceEdition=1 - Arbeidsflyt-tjenesten laster ned listen fra Altinn, tar for seg hvert foretak og setter opp ett Erklæring om Ansvarsrett skjema for hver ansvarsområde i listen. Dette skjer over en skjemaopprettingsfunksjon (prefill) i Altinn. Datamodellen for disse skjemaene som blir generert finnes her:
https://fellesbygg.dibk.no/Metadata?ServiceCode=4419&ServiceEdition=1. Dette er formatet på dataene som blir returnert til Ansvarlig Søker. - Ansvarlig foretak får nå ansvarsrett skjemaet i sin Altinn meldingsboks (på samme måte som selvangivelsen) og kan velge å signere skjemaet direkte i Altinn eller det kan hentes ned over Altinn REST API for behandling og signering i et sluttbrukersystem som er integrert i Fellestjenester Bygg .
- Etter at skjemaet er signert, kommer det tilbake til Arbeidsflytfunksjonen. Her laster vi ned data XMLen og en PDF versjon av skjemaet og sender dette tilbake til Ansvarlig søker gjennom en Meldingstjeneste. Disse kan så lastes ned fra Altinn.
Søknadssystem steg
| Steg | Beskrivelse | API | Datamodell | Informasjon |
|---|---|---|---|---|
| 1 | Innsending av Distribusjonstjeneste | https://www.altinn.no/api/Help/Api/POST-who-Messages_language_complete_sign (complete=true) | https://fellesbygg.dibk.no/Metadata?ServiceCode=4762&ServiceEdition=1 | |
| 2 | Hent status via Status API | https://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:"Distribusjoner": [ | |||
| - 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": [ | |||
- Når ansvarsrett skjemaet er videresendt tilbake til Ansvarlig Søker viser Status API "recieptSent" for den aktuelle ansvarsretten. 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": [ | |||
| 3 | Hente 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 |
Status API for Distribusjonstjeneste for Erklæring om Ansvarsrett
...