API:er och öppna data
Kontakta oss om API:er och öppna data
Kontakta oss om du har frågor, funderingar eller idéer om API:er eller öppna data som du vill diskutera. Vi välkomnar även förslag på hur vi kan samarbeta för att ta fram bättre tjänster.
Använd det här formuläret om du har idéer eller konkreta förslag på hur vi kan samarbeta kring Skatteverkets datamängder.
Använd det här formuläret om du vill uppdatera din API-applikation eller avregistrera tillgången till ett befintligt API.
Använd det här formuläret om du vill ställa frågor om API:ets användning, teknik, villkor eller avtal.
Använd det här formuläret om du undrar någon om Skatteverkets öppna data-filer.
Vanliga frågor om att samarbeta
Varför ska vi samarbeta?
Digitalisering av vår värld ger stora möjligheter att skapa tjänster eller lösningar som förut har varit omöjliga. Hörnstenarna i den utvecklingen är tillgången till data och den teknik som nu finns för att dela data.
Ingen kan dock skapa lösningarna helt själv. Vardagen för en vanlig person eller för ett företag är ett stort pussel där många bitar behövs för att skapa helheten. Tillsammans kan vi skapa nytta för våra kunder, för oss själva och för samhället i stort.
Vad är det som gäller när vi samarbetar?
För att vi ska lyckas med samutvecklingen behöver parterna göra långsiktiga åtaganden, ibland för kortsiktiga resultat. Det här är Skatteverkets förhållningssätt:
- Det är frivilligt att delta. En part kommer inte att förfördelas för att den inte deltar.
- Alla parter har ett ansvar att bidra. Samutveckling bygger på att alla deltagare kan se hur respektive part bidrar.
- Inga ekonomiska avtal eller ersättningar. Det ska inte förekomma kommersiella diskussioner om till exempel
- priser, rabatter eller andra prispåverkande villkor,
- marknadsandelar, försäljningsvolymer, kostnader eller andra företagshemligheter. - Skatteverket vill vara helt transparenta. När vi samarbetar med externa parter är vi öppna med det utåt. Det innebär att vi kommer att berätta när vi har möten, vilka vi träffar, vad syftet med mötena är och vad mötena har resulterat i. Information som en deltagande part inte vill ska bli allmän handling ska inte lämnas in i någon dokumenterad form, till exempel dokument, bilder eller presentationer. Det går bra att berätta om företagshemligheter på möten. Var tydlig med vilken information du vill skydda. Skatteverket kommer då inte att dokumentera sådan information.
- Inga ersättningar. Varje deltagande part står för sina egna kostnader. Det innebär att Skatteverket inte kommer att köpa något från andra parter inom ramen för samverkan.
Skatteverket träffar dig gärna. Om ett konkret projekt formas kommer vi att teckna ett särskilt avtal. Vi kommer att kommunicera innehållet i alla samverkansprojekt som vi deltar i. Avtalet reglerar syftet för deltagarna samt respektive parts engagemang och bidrag.
Kontakta oss om samarbete
Fyll i vårt kontaktformulär om du har ett konkret förslag på samarbete eller om du vill ha ett första samtal om ett samarbete.
Kan jag samarbeta och samtidigt skydda mina företagshemligheter?
Vi är helt transparenta i våra samarbeten. Vi kan inte särbehandla eller ge fördelar till vissa företag. Det innebär att vi alltid berättar vilka vi samarbetar med, när vi träffar dem och vad vi pratar om.
Om ditt företag har delar av sin utveckling som du inte vill ska exponeras för andra, kommer vi inte att föra den informationen vidare. Det förutsätter dock att du aldrig lämnar den informationen till Skatteverket i dokumenterad form. Det går bra att berätta om företagshemligheter på möten. Var tydlig med vilken information du vill skydda. Skatteverket kommer då inte att dokumentera sådan information.
Vi vill samarbeta med Skatteverket, hur gör vi det?
Fyll i vårt kontaktformulär längre upp på sidan om du har ett konkret förslag på samarbete eller om du vill ha ett första samtal om ett samarbete.
Vilka företag har Skatteverket träffat?
De här företagen har Skatteverket träffat och diskuterat olika samarbeten med:
Agrando, Almega, Atronic Försäljning AB, BL info, Bokio, Collectum, Deloitte, Dooer, Entersale, FAR, Fora AB, Fortnox, Grant Thornton, Hogia, InterPares, LRF Konsult, Marksikt, NEA, PE Accounting, Produktpoolen, PwC, Red Flag, Retail, Innovation, SEB, SoftOne, Speedledger, Srf konsulterna, Visma, Wint, Wrebit.
Vanliga frågor om öppna data
Hur får jag använda informationen?
Skatteverkets data består idag enbart av data där det inte går att urskilja enskilda personer. Datan är fri att använda utan några avtal eller avgifter.
Lagar om vidareutnyttjande av information
Vidareutnyttjande av myndighetsinformation regleras i PSI-lagen. PSI står för Public Sector Information, alltså offentlig information.
Information för vidareutnyttjande omfattar aldrig information där privatpersoner eller företag kan identifieras direkt eller indirekt. Det regleras i de här lagarna:
I vilket format finns Skatteverkets öppna data?
Informationen lämnas i ett format som följer en öppen standard, främst csv (comma-separated values) och ett tillhörande API (application programming interface). För informationsmängder där andra format efterfrågats försöker vi tillhandahålla även dessa. Det kan vara till exempel excel eller txt.
Vi publicerar informationen i så maskinläsbar form som möjligt. På sikt vill vi tillgängliggöra informationen som ett API eller som länkad data.
Vanliga frågor om API:er
Vilken teknisk lösning använder Skatteverket?
Skatteverket använder idag olika tekniska plattformar för API:erna. Våra API:er bygger i första hand på REST över http och json med OAuth2 som teknik för auktorisation.
I Utvecklarportalen kan du läsa om vad som gäller för varje enskilt API. Där finns all dokumentation om API:et; allmän information, säkerhetsinformation, teknisk dokumentation och exempelkod som visar hur anrop och svar ska se ut. I Utvecklarportalen finns också information om de villkor och avtal som gäller för att få tillgång till API:et.
Vilka miljöer finns?
Varje API lanseras som enkel testtjänst (mockup), komplett testtjänst (sandbox) och driftsatt tjänst. På så sätt kan du som programvaruutvecklare starta din utveckling av nya tjänster redan innan ett API är driftsatt.
Enkel testtjänst (mockup)
Enkel testtjänst är en testmiljö med statiskt hårdkodad data. Den enkla testtjänsten är öppen för alla och tillgänglig för respektive API i Utvecklarportalen.
Komplett testtjänst (sandbox)
Komplett testtjänst är en testmiljö med dynamiska data. För att få tillgång behöver du ansöka via formuläret i anslutning till API:et och godkänna Skatteverkets användarvillkor för öppet API i testmiljö. När vi har godkänt din förfrågan får du API-nycklar, client_id och client_secret, som du behöver för att anropa API:et. Nycklarna skickas via mejl. Testdata och URI till den kompletta testtjänsten finns för respektive API i Utvecklarportalen.
Driftsatt tjänst
Driftsatt tjänst är API:et i produktion. För att få tillgång ska ditt företag uppfylla Skatteverkets krav för API:et och du ska skriva under ett avtal. Du kan ta del av avtal och villkor för respektive API i Utvecklarportalen. Fyll sedan i formuläret ”Begär tillgång till driftsatt tjänst”. När vi har godkänt din förfrågan och avtalen är signerade får du API-nycklar, client_id och client_secret, som du behöver för att anropa API:et. Nycklarna skickas via mejl och sms. URI till den driftsatta tjänsten finns för respektive API i Utvecklarportalen.
Hur får jag tillgång till API:erna?
Detaljerad teknisk information
I Utvecklarportalen finns all dokumentation om API:et; allmän information, säkerhetsinformation, teknisk dokumentation och exempelkod som visar hur anrop och svar ska se ut. Här finns också information om de villkor och avtal som gäller för att få tillgång till API:et.
Begär tillgång till API – komplett testtjänst
För att begära access till komplett testtjänst (sandbox) för ett API behöver du fylla i och skicka in ett formulär för valt API.
- Begär tillgång till komplett testtjänst för Arbetsgivardeklaration
- Begär tillgång till komplett testtjänst för Skatteavdrag
- Begär tillgång till komplett testtjänst för Skattekonto
- Begär tillgång till komplett testtjänst för Ombudshantering
Du godkänner Skatteverkets användarvillkor för öppet API i testmiljö i samband med att du skickar in formuläret.
Begär tillgång till API – driftsatt tjänst
För att få tillgång till ett API i driftsatt tjänst behöver du fylla i och skicka in ett formulär till Skatteverket.
- Begär tillgång till driftsatt tjänst för Arbetsgivardeklaration
- Begär tillgång till driftsatt tjänst för Skatteavdrag
- Begär tillgång till driftsatt tjänst för Skattekonto
De krav som Skatteverket ställer finns i Utvecklarportalen på sidan Villkor under respektive API.
Hur får jag använda API:erna?
Vi använder oss av en anslutningsprocess, avtal och tekniska säkerhetslösningar för att säkerställa att personrelaterad och sekretessbelagd information skyddas. För varje API finns det specifika krav som du behöver uppfylla för att få tillgång till API:et. De krav som Skatteverket ställer finns i Utvecklarportalen på sidan Villkor under respektive API.
Hur uppdaterar eller avregistrerar jag tillgången till ett API?
Kontakta oss genom att fylla i ett formuläret "Uppdatera eller avsluta befintligt API". Kontakta oss om API:er om du behöver uppdatera din API-applikation med ny information, såsom nytt redirect_URI eller ny kontaktperson. Du kan även avregistrera tillgången till API:et via formuläret.
Fyll i de sex sista siffrorna i API-nycklarna, alltså ditt client_id och client_secret i formuläret. På så vis identifierar du dig på ett säkert sätt.
När vi har tagit emot ditt ärende gör vi förändringen och meddelar dig via mejl.
Kontakta oss
Aktuellt
-
Coronavirusets effekter på ekonomin
Ansökningarna om tillfälligt anstånd har minskat medan omsättningen fortsätter a...
-
Hälsoappar för hemmaträning kan ge friskvårdsbidrag
Internettjänster som kan användas för att träna hemma eller på annan plats omfat...
-
Nya lagar och regler träder i kraft i sommar
Den 1 juli och den 1 augusti börjar ett antal nya lagar att gälla. Lagändringarn...
Tillsammans gör vi samhället möjligt