Status- og Nedlastings-API, signeringstjenesten
- Tor Oskar Ova Johnsen
- Helga Jerven
- Veslemøy Søbak
Vi har satt opp Signeringstjenesten for ansvarlige foretak slik at Status -og Nedlastings-API fungerer på samme måte som de tilsvarende distribusjonstjenestene i Altinn.
Dokumentasjonen for disse API-ene gjelder fortsatt:
Ved bruk i signeringstjenesten erstattes Altinn-arkivreferansen med erklæringens ID for å hente status på innsendelsen. Under ser du et eksempel på en innsending av en erklæring om ansvarsrett.
Eksempel på status-Api før signering
En ansvarsrett er sendt og har mottatt denne ID-en fra signeringstjenesten: 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 API-et henter en 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 én distribusjon siden Signeringstjenesten oppretter én og én erklæring. Den vil ha et "Status"-felt som følger hovedstatusene som ble brukt i den tidligere versjonen. Det er også et "AnSaKoStatus"-statusobjekt som tilbyr mer granulert statusinformasjon rundt statusene som blir brukt i Signeringstjenesten for ansvarlige foretak.
Ansako-statusene er dokumentert her: Behandlingsstatus, Signeringstjenesten
Eksempel på status-Api etter signering
Eksempel etter at signaturen 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 innsendings-API før signering
/api/v1/innsending/b9c14658-ccf4-4e1b-b02a-1f5d4b4f62e0
/api/v1/innsending/distribusjoner/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0
/api/v1/innsending/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0/hendelser
Eksempel innsendings-API etter signering
/api/v1/innsending/b9c14658-ccf4-4e1b-b02a-1f5d4b4f62e0
/api/v1/innsending/distribusjoner/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0
/api/v1/innsending/distribusjoner/B9C14658-CCF4-4E1B-B02A-1F5D4B4F62E0/distribusjonsdetaljer