---
title: Innrapportering A-melding API
slug: /api/innrapportering-amelding
folder: api
sidebar: mydoc_sidebar
datatable: true
tags: [API, A-ordning]
keywords: [a-melding, aordning]
last_updated: Feb 17, 2026
hide_table_of_contents: true
---
Tjeneste for innrapportering av A-meldingen (tidligere A02).
For generell informasjon om tjenestene se egne sider om:
* [Sikkerhetsmekanismer](../om/sikkerhet.md)
* [Systembruker](../om/systembruker.md)
* [Feilhåndtering](../om/feil.md)
* [Versjonering](../om/versjoner.md)
* [Teknisk spesifikasjon](../om/tekniskspesifikasjon.md)
## Status nye APIer
Tilgjengelig i **produksjonsmiljø**: [REST-api](https://app.swaggerhub.com/apis/skatteetaten/innrapportering-amelding-api/), [filopplasting-api](https://skatteetaten.github.io/api-dokumentasjon/api/innrapportering-amelding-filopplasting) og [tilbakemelding](https://app.swaggerhub.com/apis/skatteetaten/amelding-tilbakemelding-api/).
Tilgjengelig i **testmiljø**: [REST-api](https://app.swaggerhub.com/apis/skatteetaten/innrapportering-amelding-api/), [filopplasting-api](https://skatteetaten.github.io/api-dokumentasjon/api/innrapportering-amelding-filopplasting) og [tilbakemelding](https://app.swaggerhub.com/apis/skatteetaten/amelding-tilbakemelding-api/).
Manuell filopplasting er også tilgjengelig i test: [Manuell filopplasting](https://ameldingfilopplasting.skatteetaten-test.no/web/amelding-filopplasting/) for XML-filer.
Følg gjerne nyheter på [Nyheter for sluttbrukersystemer](https://www.skatteetaten.no/samarbeidspartnere/sluttbrukersystemer/sbs-nyheter/)
## Scope
Følgende scope skal benyttes ved autentisering i Maskinporten: `skatteetaten:innrapporteringamelding`.
Dette scopet skal brukes for REST-api, filopplasting-api og tilbakemelding-api.
Mer informasjon og søknad på scope finner du på [tilgang til scope - skatteetaten.no](https://www.skatteetaten.no/samarbeidspartnere/sluttbrukersystemer/sbs-nyheter/her-kan-du-soke-om-tilgang-til-tjenester-for-innrapportering-til-skatteetaten/)
## Delegering
Tilgang til dette API-et kan delegeres i Altinn, f.eks. dersom leverandør benyttes for den tekniske oppkoblingen.
## Systemtilgang med systembruker
Steg for steg: [Slik kobler du deg opp til våre reetablerte tjenester](https://www.skatteetaten.no/samarbeidspartnere/reetablering-altinn/systemleverandor/oppkobling/)
Dette APIet krever at systemet og dets systembrukere har tilgang til én eller flere av følgende tilgangspakker:
```json
"accessPackages": [
{
"urn": "urn:altinn:accesspackage:regnskapsforer-med-signeringsrettighet"
},
{
"urn": "urn:altinn:accesspackage:regnskapsforer-uten-signeringsrettighet"
},
{
"urn": "urn:altinn:accesspackage:ansvarlig-revisor"
},
{
"urn": "urn:altinn:accesspackage:revisormedarbeider"
},
{
"urn": "urn:altinn:accesspackage:regnskapsforer-lonn"
},
{
"urn": "urn:altinn:accesspackage:a-ordning"
}
]
```
Ved bruk av standard systembruker kan man også benytte enkeltrettigheter for tilgang til tjenesten:
```JSON
"Rights": [
{
"Resource": [
{
"value": "ske-innrapportering-amelding",
"id": "urn:altinn:resource"
}
]
}
]
```
## Teknisk spesifikasjon
REST-api (for innsendinger mindre enn 10 000 000 bytes): URL-er til innrapprterings API-et, beskrivelsen av parameterne, endepunkter og respons ligger i Open API spesifikasjonen på
[SwaggerHub REST-api](https://app.swaggerhub.com/apis/skatteetaten/innrapportering-amelding-api)
Filopplasting-api (kan også brukes for innsendinger større enn 10 000 000 bytes): URL-er til innrapprterings API-et, beskrivelsen av parameterne, endepunkter og respons ligger i Open API spesifikasjonen på
[SwaggerHub A-melding filopplasting](https://app.swaggerhub.com/apis/skatteetaten/innrapportering-amelding-filopplasting-api/). **Spesifikasjonen for A-meldingen (payload) er den samme som for REST-apiet**.
Tilsvarende for tilbakemeldingen ligger i Open API spesifikasjonen på
[SwaggerHub tilbakemelding](https://app.swaggerhub.com/apis/skatteetaten/amelding-tilbakemelding-api/)
**VIKTIG!!** For å hente tilbakemeldingen må man lytte på hendelser hos Dialogporten. Dette er beskrevet hos Digdir: [Hvordan hente meldinger gjennom Dialogporten](https://samarbeid.digdir.no/altinn/hvordan-hente-meldinger-gjennom-dialogporten/2869)
**OBS OBS!! Endring - foreløpig kun i testmiljø**
I test har nå forsendelsen (transmission-en) i Dialogporten to URL-er, som vist under.
```json
"urls": [
{
"id": "019e1687-...",
"url": "https://skatt-test.sits.no/web/aor-tilbakemelding/uthenting/v1/dialoger/019c27bc-...",
"mediaType": "application/json",
"consumerType": "Gui" <<<—————— for nedlasting fra innboks
},
{
"id": "019e1687-...",
"url": "https://ameldingtilbakemelding.api.skatteetaten-test.no/v1/forsendelser/019e1687-...",
"mediaType": "application/json",
"consumerType": "Api" <<<—————— for oppslag fra API
}
]
```
Gui-URLen må Skatteetaten ha for å gjøre tilbakemeldingen nedlastbar fra Dialogpottens innboks og Skatteetatens Min side.
Api-URL er for oppslag for m2m-uthenting av tilbakemeldingen.
**De systemene som allerede er i produksjon bør verifisere i test at de bruker riktig URL - slik at uthenting også vil fungere i produkjson når endringen deployes der.**
Nyhet om tidspunkt for endrigen i produksjon vil bli publisert på skatteetaten.no og Slack.
Nødvendige åpninger i en evt. brannmur er beskrevet [her](../om/sikkerhet.md)
### Parameter: idempotencyKey
idempotencyKey parameteren er påkrevet. Innholdet skal være en unik UUID. Hvert nye kall til API-et skal ha en
tilsvarende ny idempotencyKey. Flere etterfølgende POST kall med samme request-body og samme idempotencyKey vil gi den
samme responsen. Kun det første av denne rekken med like API kall vil behandles. IdempotencyKey muliggjør at man trygt
kan prøve innsendinger på nytt der man av ulike årsaker ikke har fått en tilbakemelding fra API-et.
## Datakatalog
Dette API-et er pt. ikke dokumentert i Felles datakatalog.
## Innsending
Dokumentasjon for REST-api finner du på [SwaggerHub REST-api](https://app.swaggerhub.com/apis/skatteetaten/innrapportering-amelding-api/).
Dokumentasjon for filopplasting-api finner du på [SwaggerHub A-melding filopplasting](https://app.swaggerhub.com/apis/skatteetaten/innrapportering-amelding-filopplasting-api/)
## Tilbakemelding
Dokumentasjon finner du på [SwaggerHub tilbakemelding](https://app.swaggerhub.com/apis/skatteetaten/amelding-tilbakemelding-api/)
Benytt samme scope som for innsending ved autentisering i Maskinporten: `skatteetaten:innrapporteringamelding`.
**VIKTIG!!** For å hente tilbakemeldingen må man lytte på hendelser hos Dialogporten. Dette er beskrevet hos Digdir: [Hvordan hente meldinger gjennom Dialogporten](https://samarbeid.digdir.no/altinn/hvordan-hente-meldinger-gjennom-dialogporten/2869)
Tabellen under viser en oversikt over hvilke spesifikke feilkoder denne applikasjonen kan gi.
| Feilkode | HTTP Statuskode | Feilområde |
|----------|-----------------|----------------------------------------------|
| AMLD_001 | 500 | Uventet feil på tjenesten |
| AMLD_004 | 401 | Feil i forbindelse med autentisering |
| AMLD_005 | 403 | Feil i forbindelse med autorisering |
| AMLD_006 | 400 | Feil i request |
| AMLD_008 | 400 | Strukturell feil i tilknyttet dataformat |
| AMLD_010 | 400 | Feil i forbindelse med validering av payload |
| AMLD_011 | 400 | Feil i metadata |
| AMLD_017 | 500 | Uspesifisert systemfeil |
| AMLD_019 | 409 | Idempotensnøkkel er benyttet tidligere |
| AMLD_021 | 404 | Finner ikke forespurt ressurs |
| AMLD_022 | 405 | HTTP-metode ikke støttet |
| AMLD_023 | 500 | Uventet feil i et bakenforliggende system |
Feilresponsene kan også inneholde en feilspesifiseringskode som presiserer feilen ytterligere.
Tabellen under viser hvilke feilspesifiseringskoder applikasjonen kan gi.
Dersom det finnes mer detaljert feilinformasjon enn generelt feilområde vil det beskrives i melding, sti og angitt verdi
feltene.
| Feilspesifiseringskode | Feilområde | Årsak |
|------------------------|------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------|
| AMLD_1008 | Ugyldig token | Ugyldig token |
| AMLD_1015 | Ikke autorisert for denne dialogen | Ikke autorisert for denne dialogen |
| AMLD_1022 | Feil i parametre | Diverse feil med parametre i request. Mer detaljert beskrivelse ligger i melding, sti og angitt verdi dersom det er aktuelt |
| AMLD_1023 | Finner ingen ressurs for denne urlen | Det er ikke noe innhold tilgjengelig på denne URLen |
| AMLD_1027 | Inntektsår er ikke støttet | Det er ikke tillatt å levere på oppgitt inntektsår |
| AMLD_1028 | Header mangler | Påkrevd header er ikke med i requesten |
| AMLD_1030 | Accept-header må være av type application/json | Accept header er feil. APIet har kun støtte for json i response |
| AMLD_1032 | Feil i json-innhold | Feil i json-innhold |
| AMLD_1047 | Content type må være application/json | Content-type header er feil. APIet har kun støtte for json i request body |
| AMLD_1050 | Finner ikke et dokument med denne IDen på denne forsendelsen | Finner ikke et dokument med denne IDen på denne forsendelsen |
| AMLD_1051 | Opplysningspliktig i path og i innsending er ulike | Opplysningspliktig i path og i innsending er ulike |
| AMLD_1052 | Periode (kalendermåned) i path og i innsending er ulike | Periode (kalendermåned) i path og i innsending er ulike |
| AMLD_1053 | Uventet feil i et bakenforliggende system, vennligst prøv igjen senere | Uventet feil i et bakenforliggende system, vennligst prøv igjen senere |
| AMLD_1061 | Det finnes ingen forsendelse med denne IDen for denne ordningen | Det finnes ingen forsendelse med denne IDen for denne ordningen |
| AMLD_1062 | Oppgavegiver er ikke hovedenhet, og kan derfor ikke rapportere for ordningen | Oppgavegiver er ikke hovedenhet, og kan derfor ikke rapportere for ordningen |
| AMLD_1063 | Tokenet mangler informasjon om systembruker i authorization_details | Tokenet mangler informasjon om systembruker i authorization_details |
Informasjonsmodell kan også lastes ned i [PDF-format](../../static/download/a-melding/Informasjonsmodell_A-meldingen_V2_3.pdf)
|
### Testmiljøer
For spesifikke URL'er til testmiljø hos Skatteetaten, se
[SwaggerHub REST-api](https://app.swaggerhub.com/apis/skatteetaten/innrapportering-amelding-api)
[SwaggerHub A-melding filopplasting](https://app.swaggerhub.com/apis/skatteetaten/innrapportering-amelding-filopplasting-api/)
[SwaggerHub tilbakemelding](https://app.swaggerhub.com/apis/skatteetaten/amelding-tilbakemelding-api/)
Digdir benytter TT02 som testmiljø, hvor følgende tilbys:
* Dialogporten
* Autentisering med Maskinporten
* Autorisering med Systembruker
* Altinn innboks
Konsumenter må ha egne testmiljøer som kan kobles mot testmiljøer hos Skatteetaten og Digdir.
### Tenor testdatasøk
[Testdata] (https://www.skatteetaten.no/testdata/)
### Testdata
Det skal utelukkende benyttes syntetiske testdata ved test av tjenesten. Tenor testdatasøk tilbyr dette. Det er ikke tillatt å bruke/sende skarpe data i test pga krav fra GDPR-regelverket.
Trenger du faglig eller teknisk brukerstøtte knyttet til integrasjon mot A-meldingen kan du kontakte oss via [Brukerstøttetjenesten](https://eksternjira.sits.no/servicedesk/customer/user/login?destination=plugins/servlet/desk/site/global)
Lenke til å sette opp tilgang til brukerstøttetjenesten og bestille tilgang til ny tjeneste/scope finner dere på denne siden (under «trenger du hjelp»): [A-meldingen - for sluttbrukersystemer - Skatteetaten](https://www.skatteetaten.no/samarbeidspartnere/sluttbrukersystemer/a-meldingen-sbs/)