Versjonssammenligning

Gammel versjon 8

changes.mady.by.user Veslemøy Søbak

Lagret den

sammenlignet med

Ny versjon Gjeldende

changes.mady.by.user Helga Jerven

Lagret den

Nøkkel

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

Vi har satt opp Ansako 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:

https://dibk.atlassian.net/wiki/spaces/FB/pages/51480712

https://dibk.atlassian.net/wiki/spaces/FB/pages/2156691469 FtB Arbeidsflyt Status API

InnsendingsAPI - Status

Ved bruk i Ansako 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 Ansakosigneringstjenesten: b9c14658-ccf4-4e1b-b02a-1f5d4b4f62e0

...

"Distribusjoner"-bolken inneholder bare én distribusjon siden Ansako 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 AnsakoSigneringstjenesten 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):

Kodeblokk
languagejson
{
    "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

Kodeblokk
languagejson
{
    "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

Kodeblokk
languagejson
{
    "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

Kodeblokk
{
    "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
        }
    }
}

...

Eksempel innsendings-API etter signering

/api/v1/innsending/b9c14658-ccf4-4e1b-b02a-1f5d4b4f62e0

Kodeblokk
{
    "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

Kodeblokk
languagejson
{
    "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

Kodeblokk
languagejson
{
    "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"
                    }
                }
            }
        ]
    }
}

...