Krav og betalinger API
Tjeneste som tilbyr oversikt av krav, innbetalinger og utbetalinger tilhørende en part.
For generell informasjon om tjenestene se egne sider om:
- Bruk av tjenestene
- Sikkerhetsmekansimer
- Rettighetspakker
- Feilhåndtering
- Versjonering
- Teknisk spesifikasjon
Scope
Følgende scope skal benyttes ved autentisering i Maskinporten: skatteetaten:kravogbetalinger
Delegering
Tilgang til dette API-et kan delegeres i Altinn, f.eks. dersom leverandør benyttes for den tekniske oppkoblingen. Søk
opp følgende tjeneste i Altinn for å delegere tilgangen: Krav og betalinger API - På vegne av
Teknisk spesifikasjon
URL-er til API-et, beskrivelsen av parameterne, endepunkter og respons ligger i Open API spesifikasjonen på SwaggerHub.
API-et har 4 endepunkter:
- Åpne krav: Hent oversikt over åpne krav og uplasserte innbetalinger. Gjør oppslag mot reskontrosystemene på åpne krav og uplasserte innbetalinger og oppgir de samlet med en summert oversikt
- Krav: Hent alle krav innen et gitt tidsrom. Gjør oppslag mot reskontrosystemene på alle krav innen et gitt tidsrom på maks ett år.
- Innbetalinger: Hent alle innbetalinger innen et gitt tidsrom. Gjør oppslag mot reskontrosystemene på alle innbetalinger innen et gitt tidsrom på maks ett år.
- Utbetalinger: Hent alle utbetalinger innen et gitt tidsrom. Gjør oppslag mot reskontrosystemene på alle utbetalinger innen et gitt tidsrom på maks ett år.
Se også eksempler for de ulike endepunktene.
Rettighetspakker
For denne tjenesten finns følgende rettighetspakker
| Navn på rettighetspakke | Formål med rettighetspakke | Egenskaper ved rettighetspakke |
|---|---|---|
| finans | Banker og finansforetak som skal vise krav og betalinger i nettbank | Finans-rettighetspakken krever bruk av Altinn-samtykke, og den gir tilgang til alle 4 endepunkter med oppslag for virksomheter (vil etter hvert bli utvidet også til oppslag for personer) |
| regnskapssystem | Regnskapssystemer som skal vise krav og betalinger i sine sluttbrukersystemer | Regnskapssystem-rettighetspakken krever bruk av den nye Systembruker-løsningen fra Digdir for virksomhet, og gir tilgang til alle 4 endepunkter. Det kommer mer informasjon om Systembruker etter hvert. I pilotfasen vil systemleverandører kun få tilgang til egne data. |
| lovfestetrevisjon | Hjemmelsbasert deling av data med revisorer |
Samtykke
For rettighetspakken finans kreves samtykke for dette API-et.
| ServiceCode | ServiceEditionCode | Formål |
|---|---|---|
| 5928 | 202301 | Kreves for rettighetspakken finans |
Datakatalog
Datatjenestebeskrivelse i Felles datakatalog.