Informasjon om datamodellen for tjenesten finnes her: Distribusjonstjeneste for erklæring om ansvarsrett
Skjema Erklæring om Ansvarsrett kan distribueres til de Ansvarlige Foretak ved å bruke en FtB Distribusjonstjeneste:
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 |
Ved innsending av en distribusjonstjeneste, er det normalt 3 prosesssteg:
Ansvarsrsrett er pre-utfylt og sendt til Ansvarlig Foretak (submittedPrefilled)
Ansvarlig foretak har signert Anvarsrett (signed)
Kvitteringmelding er sendt tilbake til Ansvarliog Søker (recieptSent)
Innsendelsen med Arkiv Referanse AR3302588 brukes som eksempel på API meldinger. Dette er en distribusjon med en ansvarsrett.
Status hentes fra https://admbygg.dibk.no/api/status/AR3302588
Før skjemaet er behandlet gis denne beskjeden:
"Finner ingen forsendelse med denne Altinn arkivreferanse" |
Når dataene er behandlet og i dette tilfellet en Erklæring om Ansvarsrett er sendt ut til Ansvarlig søker blir denne meldingen tilgjengelig på APIet.
{ "Arkivreferanse": "AR3302588", "AltinnInnsending": "2017-06-13T14:23:03.2", "Saksaar": 0, "Sakssekvensnummer": 0, "Hendelser": [ { "Beskrivelse": "Altinn utsendelse av ansvarsrett til SÆBØVÅGEN OG LONGYEARBYEN (911455307, organisasjonsnummer), 8190566, gjelder ansvarsområde Prosjektering av vann og avløp, samt sanitære installasjoner, Prefill Successfully Instantiated for Reportee: 911455307 - erklæring av ansvarsrett er opprettet", "Tidspunkt": "2017-06-13T12:25:07.337" }, { "Beskrivelse": "Behandler ansvarsrett skjemaer", "Tidspunkt": "2017-06-13T12:25:06.42" }, { "Beskrivelse": "Skjema er hentet fra Altinns tjenestearkiv for DiBK.", "Tidspunkt": "2017-06-13T12:25:06.387" }, { "Beskrivelse": "Skjema er lagt i kø for behandling til Distribusjonstjeneste.", "Tidspunkt": "2017-06-13T12:25:05.373" } ], "Distribusjoner": [ { "Distribusjonstype": "Erklæring om ansvarsrett", "ReferanseSluttbrukersystem": "c6e8b5db-a2c9-4174-befb-c0a594204565", "Status": "submittedPrefilled", "ReferanseIdSendt": "8190566", "Sendt": "2017-06-13T14:25:06.287" } ] } |
Etter Ansvarlig Foretak har signert skjemaet gir APIet denne oppdateringen:
{ "Arkivreferanse": "AR3302588", "AltinnInnsending": "2017-06-13T14:23:03.2", "Saksaar": 0, "Sakssekvensnummer": 0, "Hendelser": [ { "Beskrivelse": "Altinn utsendelse av ansvarsrett til SÆBØVÅGEN OG LONGYEARBYEN (911455307, organisasjonsnummer), 8190566, gjelder ansvarsområde Prosjektering av vann og avløp, samt sanitære installasjoner, Prefill Successfully Instantiated for Reportee: 911455307 - erklæring av ansvarsrett er opprettet", "Tidspunkt": "2017-06-13T12:25:07.337" }, { "Beskrivelse": "Behandler ansvarsrett skjemaer", "Tidspunkt": "2017-06-13T12:25:06.42" }, { "Beskrivelse": "Skjema er hentet fra Altinns tjenestearkiv for DiBK.", "Tidspunkt": "2017-06-13T12:25:06.387" }, { "Beskrivelse": "Skjema er lagt i kø for behandling til Distribusjonstjeneste.", "Tidspunkt": "2017-06-13T12:25:05.373" } ], "Distribusjoner": [ { "Distribusjonstype": "Erklæring om ansvarsrett", "ReferanseSluttbrukersystem": "c6e8b5db-a2c9-4174-befb-c0a594204565", "Status": "signed", "ReferanseIdSendt": "8190566", "ReferanseIdSignert": "AR3302601", "Sendt": "2017-06-13T14:25:06.287" } ] } |
Når det utfylte skjemaet er sendt tilbake til Ansvarlig Søker gis denne oppdateringen:
{ "Arkivreferanse": "AR3302588", "AltinnInnsending": "2017-06-13T14:23:03.2", "Saksaar": 0, "Sakssekvensnummer": 0, "Hendelser": [ { "Beskrivelse": "Altinn utsendelse av ansvarsrett til SÆBØVÅGEN OG LONGYEARBYEN (911455307, organisasjonsnummer), 8190566, gjelder ansvarsområde Prosjektering av vann og avløp, samt sanitære installasjoner, Prefill Successfully Instantiated for Reportee: 911455307 - erklæring av ansvarsrett er opprettet", "Tidspunkt": "2017-06-13T12:25:07.337" }, { "Beskrivelse": "Behandler ansvarsrett skjemaer", "Tidspunkt": "2017-06-13T12:25:06.42" }, { "Beskrivelse": "Skjema er hentet fra Altinns tjenestearkiv for DiBK.", "Tidspunkt": "2017-06-13T12:25:06.387" }, { "Beskrivelse": "Skjema er lagt i kø for behandling til Distribusjonstjeneste.", "Tidspunkt": "2017-06-13T12:25:05.373" } ], "Distribusjoner": [ { "Distribusjonstype": "Erklæring om ansvarsrett", "ReferanseSluttbrukersystem": "c6e8b5db-a2c9-4174-befb-c0a594204565", "Status": "receiptSent", "ReferanseIdSendt": "8190566", "Sendt": "2017-06-13T14:25:06.287", "ReferanseIdSignert": "AR3302601", "Signert": "2017-06-13T14:26:10.64", "ReferanseIdKvittering": "4476193", "SendtKvittering": "2017-06-13T14:27:23.027" } ] } |
Skulle det oppstå en feil i behandlingen av en av skjemadistribusjonene, blir status satt som følger.
"Distribusjoner": [ { "Distribusjonstype": "Erklæring om ansvarsrett", "ReferanseSluttbrukersystem": "c6e8b5db-a2c9-4174-befb-c0a594204565", "Status": "error" } |
Blir "error" rapportert i APIet har det oppstått en ikke-gjenopprettbar feil og distribusjonene må sendes om igjen.
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:
Beskrivelse av datamodellen:
Hovedelement | Node | Beskrivelse | Underfelter | Objekt |
---|---|---|---|---|
Distribusjon Ansvarsrett | EiendomByggested | Adressen til byggeprosjektet. Liste siden et byggeprosjekt kan omhandle flere adresser |
| |
GjennomfoeringsPlan (data om ansvarsretter) | Liste over foretak med ansvarsretter som skal signeres for |
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.
| ||
AnsvarligSoeker | Mottaker av signert skjema |
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. |
Kodelister brukt:
Det genererte Erklæring om Ansvarsrett skjemaet blir fylt ut som følger basert på dataene i distribusjonstjenesten:
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:
dibk:DistribusjonAnsvarsrett/dibk:hovedinnsendingsnummer
Den enkelte ansvarsrett kan også merkes med en selv definert ID "vaarReferanse":
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å
Distribusjonstjeneste sendt inn til Altinn:
Ansvarsrett signert
Ansvarlig søker får melding om signatur