API för Arbetsgivardeklaration på individnivå

API funktionen finns i Agda PS från och med version 2019.2.

För att använda öppna APIer är förutsättningen att du har licens till Agda PS webb Lön (har du inte licens för Agda PS webb Lön så kontakta din säljare eller lägg ett ärende i Communityn). När det gäller funktioner med API görs dessa uppsättningar i Agda PS webb. Att skicka AGI via API innebär att uppgifterna skickas direkt till Skatteverket när du skapar rapporten i Rapportcentralen.

Det behövs ett antal inställningar för att systemen ska kunna kommunicera med varandra via API. Dessa inställningar görs i ett nytt program som finns under Inställningar - Företagets inställningar - Integration i Agda PS webb. Programmet har P-id 9247 Integrationer och skrivbehörighet krävs.

Knappen Aktivera AGI måste markeras innan du börjar att skicka uppgifter till Skatteverket via API. När knappen är aktiverad skickas uppgifter direkt till Skatteverket när du klickar på knappen Skapa rapport i Rapportcentralen.

För att skicka en fil till Skatteverket skapas en XML-fil i Rapportcentralen. Filen skapas på samma sätt oavsett om den ska skickas manuellt eller via APL.

I AGI rapporten finns det ett urval under Frekventa inställningar som bestämmer om filen ska skickas via API direkt till Skatteverket, Skicka XMLfil via API. Rutan är som standard omarkerad och måste markeras när fil ska skickas via Skatteverkets öppna API. Har inte funktionen aktiverats under Inställningar - Företagets inställningar - Integrationer i Agda PS webb visas ett meddelande med information att det saknas inställningar när filen skapas.

När inställningarna är korrekta och rapporten skapas visas ett meddelande med information om hur många företag som skickats till Skatteverket.

Hur överföringen till Skatteverket har gått kan kontrolleras under Rapporter - Integrationer - Status integrationer i Agda PS webb. För att statussidan ska visas krävs det skrivbehörighet till P-id 9255 Status Integrationer.

Funktionen Status integrationer tar inte hänsyn till användarens personprofil utan här visas samtliga överföringar.

Det finns tre olika ikoner som visar en översiktsbild av statusen för respektive integration.

Informationsikon, denna visas när integrationen inte startas upp och det finns ingen information att visa
Lyckat resultat, denna visas när data som skickats har tagits emot på korrekt sätt
Felaktigheter finns, denna visar att det finns felaktigheter i överföringen av data

I Status Integrationer visas en flik för Skickade och en för Signerade. Fliken Skickade visar status för överförda XML-filer och det går att göra urval på:

  • -Redovisningsperiod
  • -Status
  • Visa endast mina skickade filer

Även om det från Rapportcentralen är valt att endast skicka en XML-fil för alla företag kommer det att delas upp per företag när statusen presenteras. Detta beror på att varje organisationsnummer måste signeras var för sig hos Skatteverket.

När du klickar på ett id i kolumnen ID visas på högra sidan det svar som Skatteverket skickar tillbaka. OBS! Det är Skatteverkets svar inte något som Agda PS genererar. Det går också att komma till inloggningssidan hos Skatteverket genom att klicka på länken högst upp på höger sida.

Efter att användaren har klickat på länken till Skatteverket kommer det företaget med aktuellt ID att flyttas till fliken Signerade.

Om resultatet rapporterar tillbaka felaktigheter markeras raden med en röd statusikon. Klickar användaren på raden visas resultatet på höger sida. Om uppgifterna innehåller felaktigheter som gör att filen inte kan signeras och godkännas visas samma typ av svar som vid manuell överföring på Skatteverkets hemsida och kan vara av olika karaktär.

Om det finns fel i en fil så går det att välja att spara filen hos Skatteverket eller ta bort den.Vid fel i en fil rekommenderar vi att en korrigering görs i Agda PS för att säkerställa att det är samma värden där som på Mina sidor hos Skatteverket.

Det är alltid senast inlästa individuppgift som gäller så dessa kan läsas in och ersättas fram till dess att de signerats.När information skickas med hjälp av API är det de senaste överföringarna som är av intresse. Det är enkelt att ta bort information rad för rad eller hela sidor med hjälp av Soptunnan.

Tas det inte bort någon information kommer Agda PS vid varje versionsuppdatering att ta bort ID:n som är äldre än 90 dagar.

Film