Hämtning av skatteuppgifter via FOS - Årliga körningar

I HR-plus 8 kan du hämta skatteuppgifter från Skatteverket direkt via deras gränssnitt (API) för FOS - “Fråga om skatt” (gamla CSR). Det nya programmet heter Hämtning av skatteuppgifter och i denna dokumentation kallar vi den för FOS.

Det som hämtas är personens skattetabell samt eventuella jämkningsbeslut (procent, datum men INTE maxbelopp). Hämtningen sker direkt när du kör programmet. Du slipper att skicka in en fil och du slipper att vänta på att få tillbaka och läsa in svarsfilen senare.

Tänk på att när du ska göra den årliga hämtningen av samtliga personers skatteuppgifter för nästa år kan du inte göra körningen förrän i slutet av december. Det är först då Skatteverket kan lämna ut nästa års skatteuppgifter. Eftersom körningen numera hämtar uppgifterna direkt vid körningstillfället kan du inte göra körningen “i förväg”.

Om du inte har hunnit köra Hämtning av skatteuppgifter i December månad utan är i Januari så kommer det inte att gå att köra årshämtningen. Vad du kan göra då är att gå in i programkonfigurationen för årshämtningen och avmarkera kryssrutan Hämta nästa år och sedam starta körningen. Efter körningen går du tillbaka och markerar kryssrutan igen.

Uppsättning

Nycklarna som behövs för att köra FOS ansvarar Visma för och detta ligger inlagt för alla kunder.

Innan du kan köra funktionen måste du dock förbereda följande:

Webben: Admin/Programkonfigurationer:

Lägg upp två programkonfigurationer för programmet Hämtning av skatteuppgifter.

- en grundkonfiguration som endast hämtar på de som saknar uppgift

- en konfiguration på variant ”Årsskifte” som hämtar allas uppgifter för nästa år.

Om du behöver hjälp med detta, kontakta supporten.

Klienten: Uppdatera fältet Hämtn. Skatteuppg. 

Fältet CSR-svar (fältid: arb051) har bytt namn till Hämtn. skatteuppg. och listboxen till fältet innehåller numera följande tre val: Ska hämtas, Har hämtats och Spärrad. 

Uppdatera alla arbetstagare till rätt värde i det här fältet. Det görs enklast via rutin Kontroll innev löneperiod, översikt Skatteuppgifter.

Fältet ligger längst bort till höger:

  • De som saknar skatteuppgifter ska ha valet Ska hämtas.

  • De som ska uppdateras vid den årliga hämtningen ska ha valet Har hämtats.

  • De som inte ska uppdateras ska ha valet Spärrad. Dessa får du hantera manuellt istället.

Användning

  • Körningen startar du via kortet för hämtning av skatteuppgifter i aktuell löneprocess i webbens lönemodul.

  • Körningen skapar nya rader i Skatteuppgifter (tabellid: std_skat) för alla personer vilkas värden skiljer sig från gällande rad i Skatteuppgifter. De som har samma uppgifter som förra året får ingen ny rad.

  • Vid hämtning av årets uppgifter blir fr.o.m.-datum = körningsdatum.

  • Vid hämtning av nästa års uppgifter blir fr.o.m.-datum = 1 januari nästa år.

  • De uppgifter som erhålls från FOS är skatteform, tabell och jämkningsbeslut.

  • Skatteform A och Fa får värdet Vanlig löntagare i HR-plus 8.

  • Skatteform F får värdet F-skatt i HR-plus 8.

  • Skattekolumn sätts till "1" för alla, utom pensionärer som får en 3:a. De med jämkningsbeslut på 0% skatt får ett "E" (Ej skatteberäkning).

  • De uppgifter som inte erhålls från FOS kopieras från föregående rad när ny rad skapas. Det gäller fälten Period, Skatteform SINK och A-SINK, Socialavg.avtal finns, A-SINK verksamhetsart och Procent extrautbetalning.

  • Du kan kontrollera vilka som har uppdaterats genom att i klienten göra urval på fr.o.m.-datum = körningsdatum i behörighetsgrupp Installationsfunktioner, rutin Felsökning HR-plus, översikt Tabell std_skat.

  • Alla som uppdateras via programmet får status Har hämtats efter att körningen är klar och kommer därmed fortsättningsvis endast att uppdateras vid årsskifteskörningen.

  • Om du vill tvinga fram en ny hämtning för en anställd som redan har uppdaterats, ändrar du till status Ska hämtas så kommer den att uppdateras nästa gång du kör programmet.

  • Personer med jämkningsbeslut fr.o.m. ett annat datum än 1 januari eller t.o.m. ett annat datum än 31 december får fler än en ny rad i skatteuppgifter eftersom det skapas en separat rad för tiden då jämkningen gäller.

Meddelande i jobbloggen

  • Vid status 200 kan personposterna innehålla felkoden: “Person-/organisationsnummer är felaktigt” och avser felkod1 hos Skatteverket. Du behöver kontakta Skatteverket för information om hur personen ska beskattas.

  • Vid status 200 kan personposterna innehålla felkoden: “Person-/organisationsnr saknas i skatteregistret” och avser felkod 2 hos Skatteverket. Du behöver kontakta Skatteverket för information om hur personen ska beskattas.

  • Vid status 200 kan personposterna innehålla felkoden: “Preliminärskatteuppgifter kan inte visas” och avser felkod 10 hos Skatteverket. Detta brukar avse personer med skyddad identitet. För att det inte ska synas i HR-plus 8 att de särbehandlas så ändras statusen på dessa till Har hämtats trots att uppdatering ej gjorts. Kontakta Skatteverket för information om hur personen ska beskattas.

  • Vid status 200 kan personposterna innehålla felkoden: “Beslut om jämkning finns men kan inte visas” och avser felkod 11 hos Skatteverket. Detta brukar avse skolungdomar. Dessa blir uppdaterade med skatteform och tabell, men du behöver kontakta Skatteverket för att få information om jämkning.

  • “Den senaste radens från och med datum är senare än den nya radens”. Detta betyder att personen har en rad i Skatteuppgifter med fr.o.m.-datum längre fram i tiden än körningsdatum. Programmet kan då inte lägga in uppdaterade uppgifter utan det måste du göra manuellt.

  • “Person fick tillbaka svar med ‘F’/’Fa’”. Programmet sätter med automatik värdet Vanlig löntagare och skattekolumn 1 på den som har skatteform F eller Fa. Kontrollera med Skatteverket om F-skatt ska gälla påpersonen och lägg i så fall in skattekolumn 7 (ingen skatteberäkning) på personen.

  • "Ett systemfel avbröt körningen, kontakta support med följande information. Mer teknisk information.". Innan ni kontaktar supporten, kontrollera att rätt URL är ifylld i konfigureringen av den externa integrationen (det ska ej vara den för test-api'et).

Kontrollera med Skatteverket om F-skatt ska gälla på de som har skatteform "F" och ange i så fall valet Ingen skatteberäkning (7) på personen.

Tänk på att om du manuellt ändrar skatteuppgifterna på en person, bör du sätta om statusen från Ska hämtas till Har hämtats. Då slipper du få samma varning igen vid nästa körning. Ska den manuella ändringen gälla även över årsskiftet, så ändrar du till status Spärrad istället.

Fel och felkoder via statuskoder:

  • 403 = Felaktigt client_id eller client_secret

  • 429 = För många anrop inom ett tidsintervall

  • 503 = Service Unavailable

Felsökning

Om du har en anställd som inte blir uppdaterad trots att du tycker den borde ha blivit det, kolla följande:

  • Har det blivit någon varning på personen i jobbloggen?

  • Har personen rätt status i fältet Hämtn. skatteuppg. (fältid arb051)?

  • Har personen skattekolumn 7 (fältid arb042)?

  • Har personen en skattekolumn som är exkluderad i programkonfigurationen?

  • Har personen ett slutdatum som är tidigare än den första i månaden innan körningsdatumet? Sådana personer måste uppdateras manuellt.

Meddelande i jobbloggen

Tänk på att om du manuellt ändrar skatteuppgifterna på en person så bör du sätta om statusen från Ska hämtas till Har hämtats. Då slipper du få samma varning igen vid nästa körning. Om den manuella ändringen ska gälla även över årsskiftet så ändrar du till status Spärrad istället.

Relaterad hjälp