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.