Versjonssammenligning

Gammel versjon 6

changes.mady.by.user Tor Oskar Ova Johnsen

Lagret den

sammenlignet med

Ny versjon Gjeldende

changes.mady.by.user Veronika Andersen

Lagret den

Nøkkel

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

...

Status informasjon fra Arbeidsflytfunksjonen er gjort tilgjengelig gjennom et API. Hovedsaklig er status lagret under referansenummer (Archive Reference, AR) fra Altinn innsendelsen:

Altinn 2

...

Altinn 3

Den siste delen av en instans-id. Den får du i responsen når du oppretter en instans. Den vil og være tilgjengelig på kvitteringen i altinn innboks.

https:Image Removed//docs.altinn.studio/api/apps/instances/#create-instance

...


Basic Authentication

API kallet er sikret med basic authentication (Basic_access_authentication).

Kontakt fellestjenesterbygg@dibk.no for å få tildelt Basic Authentication brukernavn og passord.

Mer informasjon om oppsettet her.


Direkte nedlasting av filer

Tilgang til nedlasting av Erklæring om Ansvarsrett XML og PDF istedet for å finne disse i Ansvarlig Søkers Altinn meldingsboks. Linker er rapportert i status API og følger dette formatet, ingen basic authentication: https://admbygg.ft-test.dibk.no/api/download/{guid}/{filnavn}

Api kall:

Paste code macro
languagebash
titleAPI kall
https://admbygg.ft.dibk.no/api/status/AR3116668AR4231712


Respons (strukturen på respons er under revidering og vil bli oppdatert. Dette er bare et eksempelEksempel fra Distribusjonstjenesten for Ansvarsrett):

Paste code macro
languagejson
titleAPI response
{
	"Arkivreferanse": "AR3116668AR4231712",
	"AltinnInnsending": "20172018-0301-16T0931T10:5232:4914.66708",
	"Saksaar": 0,
	"Sakssekvensnummer": 0,
	"HendelserStatusInnsending": [
		{
			"Beskrivelse": "Altinn utsendelse av ansvarsrett for 911455307 Prosjektering av vann og avløp, samt sanitære installasjoner 85200c24-71b7-4eb2-8709-8da3b20a5231 Prefill Successfully Instantiated for Reportee: 911455307 er OK",
			"Tidspunkt": "2017-03-16T10:09:20.65"
		},"Ok",
	"Hendelser": [
		{
			"Beskrivelse": "Altinn utsendelseErklæring avom ansvarsrett forlaget 910297937 Arkitekturprosjektering e8d3142f-9640-4574-a85f-41cceafc6eb5 Prefill Successfully Instantiated for Reportee: 910297937 er OKtil (911455307), 15304944",
			"Tidspunkt": "20172018-0301-16T1031T09:0935:1710.32715"
		},
		{
			"Beskrivelse": "SenderAltinn utkvittering  ansvarsrett for 910297937preutfylling Arkitekturprosjektering,til intern911455307 referanse e8d3142f-9640-4574-a85f-41cceafc6eb5er OK",
			"Tidspunkt": "20172018-0301-16T1031T09:0935:1410.28315"
		},
		{
			"Beskrivelse": "SenderAltinn utErklæring om ansvarsrett forlaget 911455307 Prosjektering av vann og avløp, samt sanitære installasjoner, intern referanse 85200c24-71b7-4eb2-8709-8da3b20a5231",
			"Tidspunkt": "2017-03-16T10:09:14.283"
		},
		{
			"Beskrivelse": "Sender ut  ansvarsrett for 910297937 Arkitekturprosjektering, intern referanse 9deb253f-ada4-4248-b5ed-f2c262011149til (910297937), 15304941",
			"Tidspunkt": "20172018-0301-16T0931T09:5335:1709.62768"
		},
		{
			"Beskrivelse": "Unntak ved Altinn utsendelsekvittering avfor ansvarsrettpreutfylling fortil 910297937 Arkitekturprosjektering",
			"Tidspunkt": "2017-03-16T09:53:17.627"
		},
		{
			"Beskrivelse": "Skjema er hentet fra Altinns tjenestearkiv for DiBK.er OK",
			"Tidspunkt": "20172018-0301-16T0931T09:5335:1309.123667"
		},
		{
			"Beskrivelse": "SkjemaBehandler er lagt i kø for behandling til Distribusjonstjeneste.",
			"Tidspunkt": "2017-03-16T09:53:04.007"
		}
	]
}

Status API for Distribusjonstjeneste for Erklæring om Ansvarsrett

Ved innsending av en distribusjonstjeneste, er det normalt 3 prosesssteg:

  1. Ansvarsrsrett er pre-utfylt og sendt til Ansvarlig Foretak (submittedPrefilled)

  2. Ansvarlig foretak har signert Anvarsrett (signed)

  3. Kvitteringmelding er sendt tilbake til Ansvarliog Søker (recieptSent)

Informasjon om tjenesten finnes her: Distribusjonstjenester Ansvarsrett

Status API meldinger for distribusjonsflyt

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:

Paste code macro
languagejson
"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.

Paste code macro
languagejson
{
	"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 opprettetdistribusjonsskjema Distribusjon av ansvarsrett",
			"Tidspunkt": "20172018-0601-13T1231T09:2535:07.337"
		},
		{
			"Beskrivelse": "Behandler ansvarsrett skjemaer",
			"Tidspunkt": "2017-06-13T12:25:06.42"
09.063"
		},
		{
			"Beskrivelse": "Skjema er hentet fra Altinns tjenestearkiv for DiBK.",
			"Tidspunkt": "20172018-0601-13T1231T09:2535:0607.387763"
		},
		{
			"Beskrivelse": "Skjema er lagt i kø for behandling til Distribusjonstjeneste.",
			"Tidspunkt": "20172018-0601-13T1231T09:2535:0507.373437"
		}
	],
	"Distribusjoner": [
		{
			"Distribusjonstype": "Erklæring om ansvarsrett",
			"ReferanseSluttbrukersystem": "c6e8b5db52c2eb27-a2c9573e-41744ee1-befb8350-c0a594204565053b8ef5d55a",
			"Status": "submittedPrefilledreceiptSent",
			"ReferanseIdSendt": "819056615304944",
			"Sendt": "20172018-0601-13T1431T10:2535:06.287"
		}
	]
}

Etter Ansvarlig Foretak har signert skjemaet gir APIet denne oppdateringen:

Paste code macro
{
	"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 opprettet09.97",
			"ReferanseIdSignert": "AR4231740",
			"TidspunktSignert": "20172018-0601-13T1231T10:2539:0705.33749"
		},
		{
			"BeskrivelseReferanseIdKvittering": "Behandler ansvarsrett skjemaer5604043",
			"TidspunktSendtKvittering": "20172018-0601-13T1231T10:2540:0611.42703"
		},
		{
			"BeskrivelseFilnedlastinger": "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": ""Filbeskrivelse": "Erklæring om ansvarsrett",
					"ReferanseSluttbrukersystemFilURL": "c6e8b5db-a2c9-4174-befb-c0a594204565",
			"Status": "signed",
			"ReferanseIdSendt": "8190566",
https://test-admbygg.dibk.no//api/download/2dc5c2e6-412c-4bdb-b3d7-2107f9f1ad09/ErklaeringOmAnsvarsrett.xml",
					"ReferanseIdSignertMimetype": "AR3302601application/xml",
			"Sendt": "2017-06-13T14:25:06.287"
		}
	]
}

Når det utfylte skjemaet er sendt tilbake til Ansvarlig Søker gis denne oppdateringen:

Paste code macro
languagejson
{
	"Arkivreferanse": "AR3302588",
	"AltinnInnsending": "2017-06-13T14:23:03.2",
	"Saksaar": 0,
	"Sakssekvensnummer": 0,
	"Hendelser": [	{
		{
			"BeskrivelseFilbeskrivelse": "AltinnErklæring utsendelseom 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"
		},
		{
			"BeskrivelseFilURL": "Behandler ansvarsrett skjemaer",
			"Tidspunkt": "2017-06-13T12:25:06.42"
		}https://test-admbygg.dibk.no//api/download/2dc5c2e6-412c-4bdb-b3d7-2107f9f1ad09/ErklaeringOmAnsvarsrett.pdf",
		{
			"BeskrivelseMimetype": "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."application/pdf"
				}
			],
			"TidspunktReferanseOpprinneligDistribusjonSluttbrukersystem": "2017-06-13T12:25:05.373b33986db-1da2-448c-b7d0-8871c5a4257d"
		}
	],
	"Distribusjoner": [
		{
			"Distribusjonstype": "Erklæring om ansvarsrett",
			"ReferanseSluttbrukersystem": "c6e8b5db3de0c025-a2c9b522-41744f2f-befbbd0d-c0a594204565f2e2acd6f51b",
			"Status": "recieptSentsubmittedPrefilled",
			"ReferanseIdSendt": "819056615304941",
			"Sendt": "20172018-0601-13T1431T10:2535:0609.28746",
			"ReferanseIdSignertFilnedlastinger": "AR3302601"[],
			"SignertReferanseOpprinneligDistribusjonSluttbrukersystem": "2017b33986db-06-13T14:26:10.64",
			"ReferanseIdKvittering": "4476193",
			"SendtKvittering": "2017-06-13T14:27:23.0271da2-448c-b7d0-8871c5a4257d"
		}
	]
}

Skulle det oppstå en feil i behandlingen av en av skjemadistribusjonene, blir status satt som følger.

Paste code macro
languagejson
	"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.API informasjon om distribusjonstjeneste for ansvarsretter finnes her: Distribusjonstjenester Ansvarsrett


Testing

API tilgang kan testes med klient verktøy som https://insomnia.rest/ og med utvidelsen "Postman" i Chrome (https://chrome.google.com/webstore/detail/postman/fhbjgbiflinjbdggehcddcbncdddomop?hl=en)


...