Test av innrapportering skattemelding API
Hvordan komme i gang
Formålet med testen er å verifisere uthenting av skattemelding, bruk av valideringstjenesten hos Skatteetaten, sende inn og få tilbakmelding.
Konkret må sluttbrukersystemet gjøre følgende:
- Få etablert et kundeforhold hos Digitaliseringsdirektoratet (DigDir) og ta i bruk ID-porten.
- Logge inn hos ID-porten for å få en sesjon (og token).
- Utvikle en applikasjon/klient som:
- Sender en request til Skatteetatens tjeneste for å hente ut skattemeldingen for en skattepliktig.
- Sender en request til Skatteetatens tjeneste for å validere skattemelding med næringsinformasjon for en skattepliktig
- Mottar og tolker resultatet fra valideringstjenesten.
- Når det ikke er feil i retur fra valideringstjenesten kan man gå til neste punkt.
- Kaller Altinn sin nye plattform for å instansiere opp App'en for innsending av skattemelding for næringsdrivende.
- Hvis nødvendig, kaller Altinn for å laste opp vedlegg til skattemeldingen eller næringsspesifikasjonen
- Kaller Altinn for å laste opp skattemelding og næringsspesifikasjon på den instansierte App'en fra forrige punkt.
- Kaller Altinn for å laste ned kvittering/tilbakemelding fra Skatteetaten.
Skatteetaten har tilgjengeliggjort en testapplikasjon som viser hvordan trinnene beskrevet over kan utføres. Den er skrevet i Jupyter notebook-formatet:
- Jupyter notebook demo for henting, validering og innsending. Last ned katalogen testinnsending og kjør skriptet demo.ipynb (skriptet vil utføre alle trinn som inngår i prosessen: hente/velidere skattemelding og innsending av skattemelding til Altinn)
- Eksempel XML-er
- Flere demoklienter finnes på Skatteetatens GitHub
Det er også laget en brukerveiledning for testdata i PowerPoint.