Arbetsgivardeklaration via Öppet API

Transkript

1 Arbetsgivardeklaration via Öppet API

2 Att deklarera via API, scenarion et färdigställer de uppgifter som ska vara underlag för deklaration i sitt lönesystem. Användaren väljer att överföra deklarationsunderlag via sitt lönesystem till Skatteverket. En säker förbindelse upprättas mellan företagarens lönesystem och Skatteverket enligt specificerad anslutningsprocess (avtal, certifikat). I samband med överföringen kontrolleras underlagen av Skatteverket. Resultatet av kontroller returneras. Överförda underlag är därefter tillgängliga för företaget under deklarationsperioden för: Deklaration om uppgifter är korrekta och kompletta. Detta sker efter granskning antingen via API eller via e-tjänst. Komplettering om uppgifter saknas. Sker genom ny överföring via API eller via e- tjänst, överföring eller registrering. Korrigering om överförda underlag är felaktiga. Sker via överföring av korrekta uppgifter via API eller via e-tjänst, överföring eller registrering. För granskning och signering krävs att behörig företrädare identifierar sig med e-legitimation och att roll verifieras av BKS-EXT. När deklaration signeras sparas och visas en kvittens på att deklarationen tagits emot av Skatteverket. Tre API:er för läsa in underlag, hämta kontrollresultat samt förbereda deklaration. För granska/signera används inloggning/verifiering via länk till annan del av Skatteverket som renderar granskningssida och signeringsfunktionalitet.

3 API: Arbetsgivardeklaration, operation: Läs in underlag När företagets lönekörning för perioden är klar startar en löneadministratör en strömmande överföring av underlag till företagets Egna utrymme hos Skatteverket. När uppgiftsströmmen landat returneras ett deklarations-id till överförda uppgifterna som därefter kontrolleras och verifieras i en asynkron process. Inläsnings-ID används i operation: hämta kontrollresultat från inläsning. Certifikat Meddelande in: AG deklarationunderlag Meddelande ut: Inläsnings-ID

4 API: Arbetsgivardeklaration, operation: Hämta kontrollresultat Med inläsnings-id från operation: Läs in underlag kan lönesystemet fråga efter ( polla ) kontrollresultatet från inläsningen av underlag. När ett resultat finns returneras detta i ett strukturerat format. Resultatet sparas så det kan även hämtas senare. Kontrollresultatet innefattar både sambandskontroller (verksamhetsregler), rimlighetsavvikelser samt summeringskontroller. Certifikat Meddelande in: inläsnings-id Meddelande ut: Resultat, inläsning av uppgifter

5 API: Arbetsgivardeklaration, operation: Skapa granskningsunderlag Mha. ArbetsgivarregistradID/Redovisningsperiod kan lönesystemet begära att ett granskningsunderlag ska skapas/förberedas. Villkoret är att redovisningsperioden för arbetsgivaren är komplett och kontrollerad. En djuplänk till granskningsunderlaget returneras som kan lagras i lönesystem och/eller skickas till behörig företrädare som ska granska och signera deklarationen. Certifikat Meddelande in: AGregID/Redovisningsperiod Meddelande ut: Djuplänk

6 Scenario Granska & signera redovisningsperiod Med hjälp av djuplänk hämtas granskningsunderlaget för redovisningsperioden. Detta renderas av Mina Sidor. Åtkomst kräver inloggning (BankID) och verifiering i rollregister. Efter granskning signeras deklarationen för redovisningsperioden. Underlag i skickas in och tas emot av Skatteverket. Kvittens på inskickad deklaration för redovisningsperiod sparas och visas för företrädare. Behörig företrädare Logga in verifiera Mina Sidor Hämta underlag Identifiering & signering Djuplänk levererad från lönesystem eller direkt från administratör Granska Rendera Skicka in Signera