# info.description
API for å finne vedtak og meldekort for NAV-brukere som mottar Arbeidsavklaringspenger (AAP).

Påkrevd scope-verdi for bruk av API'et er `nav:arbeid/v1/aap`.

Altinn tjenestekode og tjenesteutgavekode er `5252_X`, hvor `X` er 1 eller større.

Klikk [her](https://apimgmtstdp9yhy11s8y8cys.blob.core.windows.net/content/MediaLibrary/begrep/BegrepsforklaringerAAP20191022-1.pdf) for begrepsforklaringer og kodeverksbeskrivelser.

# paths./vedtak.get.summary
Finn alle AAP-vedtak for en NAV-bruker i spesifisert tidsperiode.

# paths./vedtak.get.description
Operasjonen henter en liste av AAP-vedtak for en NAV-bruker. Oppslag er på fødselsnummer. Kun vedtak som er iverksatt (løpende) eller avsluttet vil bli returnert. Dersom ingen vedtak tilfredstiller uttrekkskriteriene eller dersom NAV-brukeren ikke finnes i fagsystemet, vil en tom vedtaksliste bli returnert.

Operasjonen kan filtrere på perioden som vedtakene dekker ved å spesifisere fra-og-med- og til-og-med-datoer i input (fomDato/tomDato). Reglene for hvilke vedtaksdata som returneres, er som følger.
* Ingen data som ligger utenfor samtykkeperioden vil bli returnert.
* Dersom ikke fomDato og/eller tomDato er spesifisert, vil operasjonen i stedet bruke samtykkeperiodens start- og/eller sluttdato.
* Dersom fomDato er spesifisert og et vedtak gjelder på denne datoen, vil vedtakets faktiske virkning fra dato bli returnert, eventuelt avgrenset til starten på samtykkeperioden.
* Dersom tomDato er spesifisert og et vedtak gjelder på denne datoen, vil vedtakets faktiske virkning til dato bli returnert, eventuelt avgrenset til slutten på samtykkeperioden.
* Dersom fomDato og/eller tomDato er spesifisert, men ligger utenfor samtykkeperioden, vil en 403-feil (ikke tilgang) bli returnert.

Tidligste vedtaksdata som uansett kan returneres for AAP er 01.03.2010.

# paths./vedtak.get.parameters[].description
Format - date (as full-date in RFC3339). Fra-og-med-dato på ISO-8601 format for vedtak som ønskes returnert. Dersom parameteren ikke er spesifisert, brukes samtykkeperiodens startdato.

# paths./vedtak.get.parameters[].description
Format - date (as full-date in RFC3339). Til-og-med-dato på ISO-8601 format for vedtak som ønskes returnert. Dersom parameteren ikke er spesifisert, brukes samtykkeperiodens sluttdato.

# paths./vedtak.get.parameters[].description
Format - byte. Standard Authorization header som inneholder et Base64-kodet Bearer-token (JWT-aksesstoken) utstedt av ID-Porten (Difi). Verdien må starte med "Bearer ", deretter følger tokenstrengen.

# paths./vedtak.get.parameters[].description
Format - byte. Base64-kodet JWT-samtykketoken utstedt av Altinn.

# paths./vedtak.get.parameters[].description
Fødselsnummer til NAV-brukeren som det spørres på.

# paths./vedtak.get.responses.200.description
Returnerer vedtakene som ble funnet. Returneres også dersom NAV-brukeren ikke finnes i fagsystemet.

# paths./vedtak.get.responses.403.description
Konsumenten har ikke tilgang til vedtaksinformasjon. Situasjoner som kan gi feilen er som følger.
* Scope til aksesstoken gir ikke tilgang til vedtaksdata.
* Konsumenten mangler gyldig samtykketoken.
* Samtykketokenet er ikke utstedt av altinn.no (iss).
* Samtykket har passert utløpstidspunktet (ValidToDate).
* Organisasjonsnummer som samtykket er i gitt til er ikke i overensstemmelse med organisasjonsnummeret som aksesstokenet er utstedt til.
* Fødselsnummeret som har gitt samtykket er ikke i overensstemmelse med fødselsnummeret det spørres på.
* Forespurt periode ligger utenfor samtykkeperioden.

# paths./meldekort.get.summary
Finn alle meldekort tilknyttet AAP-vedtak for en NAV-bruker i spesifisert tidsperiode.

# paths./meldekort.get.description
Operasjonen henter en liste av leverte meldekort tilknyttet AAP-vedtakene for en NAV-bruker. Oppslag er på fødselsnummer. Kun meldekort for AAP-vedtak som er iverksatt (løpende) eller avsluttet vil bli returnert. Dersom ingen vedtak tilfredstiller uttrekkskriteriene, ingen meldekort er levert eller NAV-brukeren ikke finnes i fagsystemet, vil en tom meldekortliste bli returnert.

Operasjonen kan filtrere på perioden som meldekortene dekker ved å spesifisere fra-og-med- og til-og-med-datoer i input (fomDato/tomDato). Reglene for hvilke meldekortdata som returneres, er som følger.
* Ingen data som ligger utenfor samtykkeperioden vil bli returnert.
* Dersom ikke fomDato og/eller tomDato er spesifisert, vil operasjonen i stedet bruke samtykkeperiodens start- og/eller sluttdato.
* Dersom fomDato er spesifisert og et meldekort dekker denne datoen, vil hele meldekortet bli returnert, eventuelt avgrenset til starten på samtykkeperioden.
* Dersom tomDato er spesifisert og et meldekort dekker denne datoen, vil hele meldekortet bli returnert, eventuelt avgrenset til slutten på samtykkeperioden.
* Dersom fomDato og/eller tomDato er spesifisert, men ligger utenfor samtykkeperioden, vil en 403-feil (ikke tilgang) bli returnert.

Tidligste meldekort tilknyttet AAP-vedtak som kan returneres er 01.03.2010.

# paths./meldekort.get.parameters[].description
Format - date (as full-date in RFC3339). Fra-og-med-dato på ISO-8601 format for meldekort som ønskes returnert. Dersom parameteren ikke er spesifisert, brukes samtykkeperiodens startdato.

# paths./meldekort.get.parameters[].description
Format - date (as full-date in RFC3339). Til-og-med-dato på ISO-8601 format for meldekort som ønskes returnert. Dersom parameteren ikke er spesifisert, brukes samtykkeperiodens sluttdato.

# paths./meldekort.get.parameters[].description
Format - byte. Standard Authorization header som inneholder et Base64-kodet Bearer-token (JWT-aksesstoken) utstedt av ID-Porten (Difi). Verdien må starte med "Bearer ", deretter følger tokenstrengen.

# paths./meldekort.get.parameters[].description
Format - byte. Base64-kodet JWT-samtykketoken utstedt av Altinn.

# paths./meldekort.get.parameters[].description
Fødselsnummer til NAV-brukeren som det spørres på.

# paths./meldekort.get.responses.200.description
Returnerer leverte meldekort tilknyttet brukers AAP-vedtak. Returneres også dersom NAV-brukeren ikke finnes i fagsystemet.

# paths./meldekort.get.responses.403.description
Konsumenten har ikke tilgang til meldekortinformasjon. Situasjoner som kan gi feilen er som følger.
* Scope til aksesstokenet gir ikke tilgang til meldekortdata.
* Konsumenten mangler gyldig samtykketoken.
* Samtykketokenet er ikke utstedt av altinn.no (iss).
* Samtykket har passert utløpstidspunktet (ValidToDate).
* Organisasjonsnummer som samtykket er i gitt til er ikke i overensstemmelse med organisasjonsnummeret som aksesstokenet er utstedt til.
* Fødselsnummeret som har gitt samtykket er ikke i overensstemmelse med fødselsnummeret det spørres på.
* Forespurt periode ligger utenfor samtykkeperioden.

# components.schemas.Meldekort.properties.antallTimerArbeidet.description
Antall timer med arbeid ført på meldekortet samlet for returnert meldekortperiode.

# components.schemas.Vedtakstype.description
Kodeverk for vedtakstype.

Kodeverdi | Termnavn
O | Ny rettighet
E | Endring
G | Gjenopptak
S | Stans

# components.schemas.Vedtaksvariant.description
Kodeverk for vedtaksvariant. Prefiks (O/E/G/S) refererer til vedtakstypen som vedtaksvarianten gjelder for.

Kodeverdi | Termnavn
O_AVSLAG | Avslag på søknad
O_INNV_NAV | Innvilgelse (generell)
O_INNV_SOKNAD | Innvilgelse av søknad
E_FORLENGE | Forlengelse
E_VERDI | Endring
G_AVSLAG | Avslag på søknad om gjenopptak
G_INNV_NAV | Gjenopptak (av andre grunner enn etter søknad)
G_INNV_SOKNAD | Innvilgelse av søknad om gjenopptak
S_DOD | Stans ved dødsfall
S_OPPHOR | Opphør (Endelig avslag)
S_STANS | Stans

# components.schemas.Vedtaksstatus.description
Kodeverk for vedtaksstatus.

Kodeverdi | Termnavn
AVSLU | Avsluttet
IVERK | Iverksatt

# components.schemas.Rettighetstype.description
Kodeverk for rettighetstype.

Kodeverdi | Termnavn
AAP | Arbeidsavklaringspenger
AA115 | §11-5 nedsatt arbeidsevne

# components.schemas.Utfall.description
Kodeverk for utfallet til vedtaket.

Kodeverdi | Termnavn
JA | Ja
NEI | Nei

# components.schemas.Aktivitetsfase.description
Kodeverk for aktivitetsfasen til vedtaket.

Kodeverdi | Termnavn
AU | Arbeidsutprøving
FA | Ferdig avklart
IKKE | Ikke spesif. aktivitetsfase
SPE | Sykepengeerstatning
UA | Under arbeidsavklaring
UVUP | Vurdering for uføre

# components.schemas.Periode.description
Representerer en tidsperiode gitt ved en fra-og-med-dato og en valgfri til-og-med-dato.

# components.schemas.ApiError.properties.status.description
Inneholder HTTP statuskoden som ble returnert.

# components.schemas.ApiError.properties.method.description
HTTP-metoden i API-kallet. (Normalt GET.)

# components.schemas.ApiError.properties.path.description
Request URI til operasjonen som ble kalt.

# components.schemas.ApiError.properties.correlationId.description
Korrelasjon ID som kan oppgis som referanse ved feil fra API-kallet.

# components.schemas.ApiError.description
Feilinformasjon som normalt blir returnert ved HTTP status 4xx og 5xx.