Vi har satt opp Ansako slik at status og nedlastings API fungerer på samme måte som de tilsvarende distribusjonstjenestene i Altinn.
Dokumentasjonen for disse APIene gjelder fortsatt:
Ved bruk i Ansako erstattes Altinn arkivreferansen med erklæringens ID for å hente status på innsendelsen.
Vi bruker en ansvarsrett innsending som eksempel.
Eksempel statusApi
En ansvarsrett er sendt og har mottatt denne IDen fra Ansako: b9c14658-ccf4-4e1b-b02a-1f5d4b4f62e0
Response fra Ansako SkjemaInnsending API:
"formType": "ansvarsrett", "referanseId": "b9c14658-ccf4-4e1b-b02a-1f5d4b4f62e0", "dataFormatId": "ErklaeringAnsvarsrett", "dataFormatVersion": "1", "formMetadata": { "signeringsfrist": "2021-09-30T21:49:00.4Z" }, xxxxxxx }
Ved å bruke det opprinnelige status APIet henter man denne statusen:
/api/status/b9c14658-ccf4-4e1b-b02a-1f5d4b4f62e0
{ "Arkivreferanse": "B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0", "AltinnInnsending": "2021-10-01T10:35:11.447", "Saksaar": 0, "Sakssekvensnummer": 0, "StatusInnsending": "Ok", "Hendelser": [ { "Beskrivelse": "Distribusjon av ansvarsrett mottatt", "Tidspunkt": "2021-10-01T10:35:22.487" }, { "Beskrivelse": "ErklaeringAnsvarsrett opprettet og distribuert", "Tidspunkt": "2021-10-01T10:35:22.487" } ], "Distribusjoner": [ { "Distribusjonstype": "Erklæring om ansvarsrett", "Status": "submittedPrefilled", "Sendt": "2021-10-01T10:35:11.447", "Filnedlastinger": [], "AnSaKoStatus": { "Status": "TilSignering", "Signeringsfrist": "2021-12-24T00:00:00" } } ] }
"Distribusjoner"
bolken inneholder bare en distribusjon siden Ansako oppretter en og en erklæring. Den vil ha et "Status"
felt som følger hovedstatusene som ble brukt i den tidligere versjonen. Det er også et "AnSaKoStatus"
status objekt som tilbyr mer granulert status informasjon rundt statusene som blir brukt i Ansako.
Kommer: liste over Ansako statuser
Eksempel etter at signature er utført og filer kan lastes ned (ID B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0) :
{ "Arkivreferanse": "B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0", "AltinnInnsending": "2021-10-01T10:35:11.447", "Saksaar": 0, "Sakssekvensnummer": 0, "StatusInnsending": "Ok", "Hendelser": [ { "Beskrivelse": "Distribusjon av ansvarsrett mottatt", "Tidspunkt": "2021-10-01T10:35:22.487" }, { "Beskrivelse": "ErklaeringAnsvarsrett opprettet og distribuert", "Tidspunkt": "2021-10-01T10:35:22.487" } ], "Distribusjoner": [ { "Distribusjonstype": "Erklæring om ansvarsrett", "Status": "signed", "Sendt": "2021-10-01T10:35:11.447", "ReferanseIdSignert": "8c7e577b-d859-4399-8b2c-032833cc45ea", "Signert": "2021-10-01T12:39:06.263", "Filnedlastinger": [ { "Filbeskrivelse": "Erklæring om ansvarsrett", "FilURL": "https://test-admbygg.dibk.no/api/download/8c7e577b-d859-4399-8b2c-032833cc45ea/ErklaeringAnsvarsrett-1_FormData.xml", "Mimetype": "application/xml" }, { "Filbeskrivelse": "Erklæring om ansvarsrett", "FilURL": "https://test-admbygg.dibk.no/api/download/8c7e577b-d859-4399-8b2c-032833cc45ea/testsigning-dac0089d-c601-4554-b55d-4b83129078eb.pdf", "Mimetype": "application/pdf" } ], "AnSaKoStatus": { "Status": "Signert", "Signeringsfrist": "2021-12-24T00:00:00" } } ] }
Eksempel innsending API
/api/v1/innsending/b9c14658-ccf4-4e1b-b02a-1f5d4b4f62e0
{ "referanse": "B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0", "innsendingsType": "Distribusjon", "altinnInnsending": "2021-10-01T10:35:11.447", "status": "Ok", "antallVedlegg": 0, "_links": { "self": { "href": "/api/v1/innsending/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0" }, "hendelser": { "href": "/api/v1/innsending/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0/hendelser" }, "distribusjon": { "href": "/api/v1/innsending/distribusjoner/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0" } } }
/api/v1/innsending/distribusjoner/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0
{ "antallDistribusjoner": 1, "antallDistribusjonerOk": 1, "antallDistribusjonerFeilet": 0, "_links": { "self": { "href": "/api/v1/innsending/distribusjoner/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0" }, "distribusjoner": { "href": "/api/v1/innsending/distribusjoner/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0/distribusjonsdetaljer" } } }
/api/v1/innsending/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0/hendelser
{ "hendelser": [ { "melding": "ErklaeringAnsvarsrett opprettet og distribuert", "tidspunkt": "2021-10-01T10:35:22.487" }, { "melding": "Distribusjon av ansvarsrett mottatt", "tidspunkt": "2021-10-01T10:35:22.487" } ], "totalResults": 2, "totalPages": 1, "page": 1, "_links": { "self": { "href": "/api/v1/innsending/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0/hendelser?page=1" }, "page": { "href": "/api/v1/innsending/{referanse}/hendelser{?page}", "templated": true } } }
Etter signering
/api/v1/innsending/b9c14658-ccf4-4e1b-b02a-1f5d4b4f62e0
{ "referanse": "B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0", "innsendingsType": "Distribusjon", "altinnInnsending": "2021-10-01T10:35:11.447", "status": "Ok", "antallVedlegg": 0, "_links": { "self": { "href": "/api/v1/innsending/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0" }, "hendelser": { "href": "/api/v1/innsending/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0/hendelser" }, "distribusjon": { "href": "/api/v1/innsending/distribusjoner/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0" } } }
/api/v1/innsending/distribusjoner/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0
{ "antallDistribusjoner": 1, "antallDistribusjonerOk": 1, "antallDistribusjonerFeilet": 0, "_links": { "self": { "href": "/api/v1/innsending/distribusjoner/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0" }, "distribusjoner": { "href": "/api/v1/innsending/distribusjoner/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0/distribusjonsdetaljer" } } }
/api/v1/innsending/distribusjoner/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0/distribusjonsdetaljer
{ "totalResults": 1, "totalPages": 1, "page": 1, "_links": { "self": { "href": "/api/v1/innsending/distribusjoner/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0/distribusjonsdetaljer?page=1" }, "page": { "href": "/api/v1/innsending/distribusjoner/{referanse}/distribusjonsdetaljer{?page}", "templated": true }, "distribusjoner": [ { "href": "/api/v1/innsending/distribusjoner/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0/distribusjonsdetaljer/cc9160df-e15b-4469-b42f-b40388c36ecf" } ] }, "_embedded": { "distribusjoner": [ { "distribusjonstype": "Erklæring om ansvarsrett", "status": "signed", "sendt": "2021-10-01T10:35:11.447", "referanseIdSignert": "8c7e577b-d859-4399-8b2c-032833cc45ea", "signert": "2021-10-01T12:39:06.263", "filnedlastinger": [ { "vedleggstype": "MaskinlesbarXml", "beskrivelse": "Erklæring om ansvarsrett", "filUrl": "https://test-admbygg.dibk.no/api/download/8c7e577b-d859-4399-8b2c-032833cc45ea/ErklaeringAnsvarsrett-1_FormData.xml", "mimeType": "application/xml" }, { "vedleggstype": "SkjemaPdf", "beskrivelse": "Erklæring om ansvarsrett", "filUrl": "https://test-admbygg.dibk.no/api/download/8c7e577b-d859-4399-8b2c-032833cc45ea/testsigning-dac0089d-c601-4554-b55d-4b83129078eb.pdf", "mimeType": "application/pdf" } ], "anSaKoStatus": { "status": "Signert", "signeringsfrist": "2021-12-24T00:00:00" }, "_links": { "self": { "href": "/api/v1/innsending/distribusjoner/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0/distribusjonsdetaljer/cc9160df-e15b-4469-b42f-b40388c36ecf" }, "signertsvar": { "href": "/api/v1/innsending/8c7e577b-d859-4399-8b2c-032833cc45ea" } } } ] } }
Legg til kommentar