Testing av nytt a-meldings API

Før du starter testing  

Du må ha gjort følgende før du kan starte testing: 

1. Koble til Maskinporten med reelt organisasjonsnummer. Maskinporten – Altinn 
2. Koble til Altinn. Ta i bruk - Sluttbrukersystem | Samarbeidsportalen 
3. Registrer systemet i Systemregisteret. Opprett et nytt system i systemregister – Altinn 
4. Tilpass systemet for systembrukere. Systembruker | API-dokumentasjon 
5. Sett opp tilgang til brukerstøttetjenesten.  
6. Bestill tilgang til Skatteetatens tjenester for A-ordningen via Brukerstøttetjenesten. Både å sette opp tilgang og bestille tilgang finner dere lenker til fra denne siden under «trenger du hjelp»: A-meldingen – for sluttbrukersystemer - Skatteetaten 
7. Tilpass systemet til innsending av a-melding i JSON: Innrapportering A-melding API | API-dokumentasjon  

Utfyllende sjekkliste og veiledning: Oppkobling til Skatteetatens tjenester 

Spørsmål som omhandler maskinporten må rettes til Digdir: Maskinporten | Samarbeidsportalen 

Trenger du faglig eller teknisk brukerstøtte knyttet til integrasjon mot a-meldingen kan du kontakte oss på e-post. [email protected] 

Filstørrelse 

Merk at størrelsen på request-body via innrapporting a-melding API i testmiljøet må være under 2 MB. 

Det vil også være en begrensning på request-body ved bruk av innrapportering a-melding API i produksjon. Her er grensen satt til 10 MB, noe som tilsvarer omtrent 1000 inntektsmottakere. A-meldinger over 10 MB må sendes via et eget API for filopplasting. API for filopplasting er under utvikling, og vi vil komme tilbake med mer informasjon om dette senere.  

Følgende er foreløpig ikke klart for testing  

• Avstemmingsrapport (A06/A07) 

• Innsending av a-meldinger over 2 MB  

• Nytt API for uthenting av tilbakemelding (API er under arbeid og  OPEN API spesifikasjon vil bli tilgjengelig på Swagger fortløpende her https://app.swaggerhub.com/apis/skatteetaten/amelding-tilbakemelding-api)  

Vi vil gi informasjon når dette er klart for testing.  

Tilbakemelding på testinnsending  

Tilbakemelding for innsendt a-melding i testmiljøet vil foreløpig kun vises i innboksen i Altinn 2/TT02 i XML-format. Vi jobber med å få den tilgjengeliggjort i «min innboks» på skatteetaten.no. 

Frist for overgang i produksjon 

Alle lønns- og personalsystemer må ta i bruk de nye API-ene i produksjon innen 1.april 2026. 

Nyttige lenker  

• Slik kobler du deg opp til våre reetablerte tjenester - Skatteetaten 
• Skatteetaten reetablerer tjenester på egen plattform og tar i bruk fellesløsninger fra Altinn - Skatteetaten 
• Teknisk dokumentasjon for innrapportering a-melding API: Innrapportering A-melding API | API-dokumentasjon 
• Nyheter og annen dokumentasjon om a-meldingen: A-meldingen – for sluttbrukersystemer - Skatteetaten 
• Tenor Testdatasøk: https://skatteetaten.github.io/api-dokumentasjon/test/tenor 
• DigDir Dialogporten (Test): https://af.tt.altinn.no/ 
• Skatteetatens Min Side/Innboks: https://skatt-test.sits.no/web/innboks/