Bilaga 3 – Teknisk specifikation för Beräkningsdata

Gäller från och med 5 maj 2025.

1. Inledning

Denna bilaga reglerar vilka informationsmängder Beräkningsdata består av samt hur Beräkningsdata ska överföras från Leverantören till Tillhandahållande myndighet.

2. Begreppet Beräkningsdata

Beräkningsdata definieras enligt tabellen nedan.

Informationsmängd

Beskrivning

Metadata


Leverantörs ID

Leverantörens unika identitetsnummer.

Period

Intervall för tidperiod där tjänster inom Auktorisationssystem utförts som genererat Beräkningsdata.

Datum från: ÅÅÅÅMMDD

Datum till: ÅÅÅÅMMDD

 

Ex: 20250101 – 20250131

Auktorisationssystems ID

Unikt nummer för respektive Auktorisationssystem.

Giltiga värden:

  • AS01 (Elektronisk identifiering)
  • AS02 (Digital post)

Anslutningsmetod

Sweden Connect

Fältet används för att informera om Leverantören ansluter enligt ramverket Sweden Connect.

Giltigt värden:

Värdet sätts till true då anslutningsmetoden är Sweden Connect, annars false.

Format: Boolean

Korrigering

Fältet används då överföring gäller en korrigering av Beräkningsdata.

En korrigering kan endast överföras då en tidigare originalöverföring har genomförts under samma period.

Giltigt värden:

Värdet sätts till true då överföringen gäller en korrigering i annat fall sätt den till false.

Format: Boolean

 

Informationsmängd

Beskrivning

Användning

Användning för Offentliga aktörer som är anslutna till respektive auktorisationssystem

Organisationsidentitet

Unikt nummer för organisation, organisationsnummer.

Format: Text

 

Exempel: 202100-6883

TjänsttypID

Unikt nummer för den tjänst inom respektive auktorisationssystem som avses för rapportering av antal Transaktioner.

Format: Text

Giltiga värden:

· AS011 (E-identifiering)

· AS012 (E-underskrift)

· AS021 (Skicka Meddelanden)

Antal Transaktioner Skicka meddelanden

Antal tillgängliggjorda Meddelanden under definierad tidperiod.

Format: Numerisk

Antal Transaktioner Elektronisk identifiering

Antal Transaktioner elektronisk identifiering under definierad tidsperiod.

Format: Numerisk

Antal Transaktioner Elektronisk underskrift

Antal Transaktioner elektronisk underskrift under definierad tidsperiod

Format: Numerisk

3. Teknisk specifikation – API för Beräkningsdata

Beräkningsdata ska överföras enligt specifikationen nedan.

3.1 API Design

Endpoint:

/ReportStatistics()

  • Metod: POST
  • Beskrivning: Ger Leverantör möjlighet att rapportera Beräkningsdata för flera Offentliga aktörer inom respektive auktorisationssystem. Rapporteringen sker månadsvis och kan anges som en korrigering vid behov av ändringar.

Request Body:

Endpointen accepterar en JSON-struktur där Leverantörens organisationsidentitet anges en gång, tillsammans med en lista över beräkningsdataposter:

Skicka Meddelanden ("AS021"):

json{  "leverantorOrgnr": "551010-1010",  "tjanst": "AS02",  "swedenConnect": false,  "arKorrigering": false,  "fom": "20240601",  "tom": "20240630",  "anvandning": [    {      "anvandarOrgnr": "556111-2222",      "transaktioner": [        {          "typ": "AS021",          "antal": 1234        }      ]    }  ]}

E-identifiering ("AS011"), E-underskrift ("AS012"):

json{  "leverantorOrgnr": "551010-1010",  "tjanst": "AS01",  "swedenConnect": false,  "arKorrigering": false,  "fom": "20240601",  "tom": "20240630",  "anvandning": [    {      "anvandarOrgnr": "556222-3333",      "transaktioner": [        {          "typ": "AS011",          "antal": 1234        },        {          "typ": "AS012",          "antal": 4567        }      ]    }  ]}

3.2 Miljöer

Det finns två separata miljöer för API:et:

  • Testmiljö:sandbox.digg.se
  • Produktionsmiljö:digg.se

3.3 Fältbeskrivning

  • leverantorOrgnr (string) (obligatorisk): Organisationsidentitet för Leverantören som rapporterar Beräkningsdata. Formatet ska vara XXXXXX-XXXX.
  • tjanst (string) (obligatorisk): Kod på auktorisationssystemet (t.ex. Auktorisationssystem för digital post (AS02) och Auktorisationssystem för elektronisk identifiering (AS01)).
  • swedenConnect(boolean): Flagga som sätts till True då anslutningsmetoden är Sweden connect. Detta gäller för Auktorisationssystem för elektronisk identifiering. För Auktorisationssystem för digital post ska värdet alltid sättas till False.
  • arKorrigering (boolean) (obligatorisk): Anger om detta är en korrigering av tidigare rapporterad data. Default är False.
  • fom (string) (obligatorisk): Anger från och med vilket datum i formatet YYYYMMDD (ÅrMånadDag).
  • tom (string) (obligatorisk): Anger till och med vilket datum i formatet YYYYMMDD (ÅrMånadDag)
  • anvandning (array) (obligatorisk): Lista med användningsposter.
    • anvandarOrgnr (string) (obligatorisk): Organisationsnummer för den Offentliga aktör Beräkningsdata avser. Formatet ska vara XXXXXX-XXXX.
    • transaktioner: Lista med antal Transaktioner och typ för Offentlig aktör under angiven period.
      • typ (string) (obligatorisk): Typ av Transaktion (t.ex. Skicka meddelanden (AS021), elektronisk identifiering (AS011), elektronisk underskrift (AS012)).
      • antal (int) (obligatorisk): Antal Transaktioner för varje typ och period.

3.4 Funktionalitet

  1. Ny rapportering
    • Leverantören rapporterar Beräkningsdata för Offentliga aktörer under en angiven period.
    • En ny post skapas i databasen för varje Offentlig aktör i listan.
    • Flaggan arKorrigering ska alltid vara False.
  2. Korrigering av rapportering
    • Vid korrigering sätts arKorrigering=True och endast felaktiga eller saknade poster skickas om.
    • Data som redan rapporterats får inte skickas igen om det inte har redigerats.
    • Det är möjligt att skicka både nya rader och korrigerade rader i samma anrop. Exempel: Om Leverantören tidigare skickat tio rader, kan denne senare skicka en korrigering med fyra rader där två är korrigeringar och två är nya poster som inte tidigare rapporterats.
  3. Validering
    • Systemet kontrollerar att alla obligatoriska fält är korrekt ifyllda.
    • Felaktigheter returneras till Leverantören med detaljerad information.
  4. Loggning
    • Alla anrop loggas med detaljer, inklusive om det gäller en korrigering eller ny rapportering.

3.5 Svarsexempel

200 OK: Rapportering mottagen.

json{    "status": "success",      "message": "Rapportering mottagen.",       "antalPoster": 2  }

400 Bad Request: Fel i indata.

json{  "status": "error",  "message": "Felaktiga data i rapporteringen.",  "fel": [    {      "rad": 1,      "fel": "Ogiltigt organisationsnummer för användare."    }  ]}

3.6 Autentisering

Autentisering sker med API-nyckel i både test- och produktionsmiljön. Varje leverantör tilldelas en unik API-nyckel för produktionsmiljön.

4. Medverkan i tester

När Leverantören ansluter till auktorisationssystem ska Leverantören testa överföringen av Beräkningsdata senast 30 dagar innan första anslutningsmånaden är avslutad.

När Tillhandahållande myndighet genomför ändringar av API för Beräkningsdata ska Leverantören genomföra de tester som Tillhandahållande myndighet anvisar senast 30 dagar innan ändringarna börjar gälla.

5. Korrigering av Beräkningsdata

När Leverantören ska korrigera Beräkningsdata ska Beräkningsdata endast innehålla de poster som ska korrigeras. Överföringen ska markeras med flaggan för Korrigering satt till true.

I de fall Leverantören ska korrigera Beräkningsdata som gäller för flera beräkningsperioder ska korrigerad Beräkningsdata skickas på nytt, uppdelat månadsvis.

Överföring av korrigerad Beräkningsdata kan endast överföras via API för Beräkningsdata under innevarande kalenderår.

Hjälpte denna information dig?

Ditt svar hjälper oss att förbättra sidan

Senast uppdaterad: