Falska meddelanden har skickats ut i Skatteförvaltningens namn. Läs mer om falska meddelanden.

Förfrågan om förskottsinnehållningsuppgifter för betalare – Notifikationstjänsten

Den beräknade publiceringstidpunkten är senast i början av hösten

I denna anvisning beskrivs hur användningen av gränssnittet Förskottsinnehållningsuppgifter för utbetalare (förfrågan om skattekort) kan effektiveras med hjälp av notifikationstjänsten.

I alla skattekortens inkomstslag har det lagts till egna notifikationstyper som motsvarar de inkomstslag som finns i API-portalens dokumentation i gränssnittet för Förskottsinnehållningsuppgifter för utbetalare.

Användaren ska i en notifikationsbeställning välja de inkomstslag som hen vill få skattekortsnotifikationer om. Användaren får endast de valda notifikationstyperna för kunderna i beställningen, när det skapas nya skattekort för kunderna och notifikationsbeställningen är i kraft. I detta fall är kunden i beställningen en privatperson.

I och med att notifikationstjänsten har utvidgats till skattekort har vi i gränssnitten i tjänsten gjort följande ändringar som möjliggör förfrågan om skattekort. Exakta datainnehåll och scheman i gränssnitten finns i API-portalens dokumentation.

Notisen börjar.

Bekanta dig med följande anvisningar innan du börjar planera och implementera en gränssnittsintegration för gränssnittet Förfrågan om förskottsinnehållningsuppgifter samt för Notifikationstjänsten:

Notifikationstjänsten

Notifikationstjänstens tekniska krav

Dokumentation för notifikationstjänsten 

Dokumentation för förfrågan om förskottsinnehållningsuppgifter för betalare

Notisen slutar

  • Till beställningen via gränssnittet Beställ notifikationer har det lagts till möjligheten att välja: typ av inkomstslag för skattekort, typen privatperson och kundbeteckning (personbeteckning).
  • Gränssnittet Lista notifikationer returnerar skattekortsnotifikationens exakta inkomstslag, personbeteckning, typen privatperson och uppgiften om skattekortets första giltighetsdag.
  • Gränssnittet GetNotification (push notifikationstjänsten) returnerar skattekortsnotifikationens exakta inkomstslag, personbeteckning, typen privatperson och uppgiften om skattekortets första giltighetsdag.
  • Gränssnittet Lista beställningar returnerar också uppgifterna om aktiva eller stängda beställningar som gäller skattekort.
  • Gränssnittet RegisterPush är avsett för registrering i push-notifikationstjänsten. För registreringen väljs en https-adress som stöder mottagningen av Vero API push-notifikationer vid gränssnittet av användarens program. För registreringen väljs också en notifikationsbeställningskod, för att skicka notifikationerna enligt beställningen till program.

Användaren är ett företag som sköter löneberäkningen själv. Användaren kan också vara en löneberäknings- och bokföringsbyrå som sköter löneberäkningen för företag.

Företaget använder ett affärsprogram med inbyggd integration till gränssnittet Förfrågan om förskottsinnehållningsuppgifter samt Push-notifikationstjänsten.

Programmet har en inbyggd automatisk hantering av åtgärder och sålunda kan det ta emot push-notifikationer från Skatteförvaltningen. Programmet reagerar på push-notifikationerna genom att inhämta de nyaste skattekorten via gränssnittet Förfrågan om förskottsinnehållningsuppgifter för utbetalare. Programmet bokför också vilka notifikationer och skattekort som redan har behandlats i löneberäkningen.

Ordningsföljden för åtgärderna:

  1. I gränssnittet Beställ notifikationer väljs de personer vilkas skattekort förfrågas för betalning av lön eller annan inkomst. I beställningen väljs skattekortets inkomsttyp, till exempel: 'Lön', person A:s personbeteckning och kundtyp (privatperson) för vilken nya skattekortsnotifikationer vill tas emot.
  2. Programmet använder Push-notifikationstjänsten. Programmet har gjort en Push-registrering och i samma registrering har det valts med en skattekorts-notifikationsbeställning där person A ingår.
  3. För person A skapas ett skattekort i MinSkatt eller som kundservice i Skatteförvaltningens system. Då skapas en notifikation av skattekortet för kunden inom följande dygn.
  4. Notifikationens nyckeluppgift skickas automatiskt från Skatteförvaltningen till samma program som har en aktiv Push-registrering och en giltig skattekortsbeställning. Nyckeluppgiften innehåller ännu inte personuppgifter utan endast en notifikationsnyckel på basis av vilken själva notifikationens datainnehåll kan hämtas.
  5. Programmet hämtar på basis av nyckeluppgiften via gränssnittet GetNotification det exakta datainnehållet i notifikationen (inkomsttypen för skattekortet, personbeteckningen för person A, kundtypen och uppgiften om skattekortets första giltighetsdag).
  6. På basis av det exakta datainnehållet i notifikationen hämtar programmet person A:s skattekort för lön via gränssnittet Förfrågan om förskottsinnehållningsuppgifter.
    • Observera att skattekortet ändå inte kan hämtas i förväg även om notifikationen skickas till programmet efter skapandet. Skattekortet kan hämtas först när uppgiften om skattekortets första giltighetsdag är aktuell.
    • Exempel: Notifikationen skickas till programmet 15.6.2025. Skattekortets giltighet börjar först 1.7.2025. Skattekortet kan hämtas först 1.7.2025.
  7. Programmet använder skattekortet vid löneberäkningen och betalningen av förskottsinnehållningen till Skatteförvaltningen. Privatpersonen behöver inte själv lämna skattekortet till löneberäkningen.

Programmet förfrågar inte person A:s skattekort varje dag, utan endast när programmet får en notifikation om ett nytt skattekort. Flera personer kan väljas till samma notifikationsbeställning. För varje person vars skattekort man vill förfråga ska i beställningen väljas rätt inkomsttyp. Skattekorten för alla personer som valts med i beställningen hämtas till utbetalaren av lön endast när nya ändringsskattekort har skapats.

  • Dessutom har det skapats en funktion i programmet med vilken programmet regelbundet anropar gränssnittet ListNotifications och kontrollerar att alla notifikationer verkligen har behandlats.
  • Skatteförvaltningen garanterar inte att push-notifikationerna kommer fram i oväntade felsituationer. Därför har en extra kontroll lagts till i programmet. Felsituationer kan till exempel vara: service- eller datakommunikationsavbrott eller oväntade fel i Skatteförvaltningens/programmets funktioner.

Programmet har gjort en notifikationsbeställning för skattekort. I beställningen har valts de personer vilkas skattekort förfrågas för betalning av lön eller annan inkomst.

Företaget får nya kunder och en del personer som lön betalas till byts. Programmet ska avsluta den nuvarande skattekortsbeställningen via gränssnittet Avbeställ notifikationer. Ändringarna i den existerande beställningen görs genom att först avsluta den nuvarande beställningen och att efter det göra en ny beställning med önskade ändringar.

Om programmet har integrerats till push-notifikationstjänsten, avslutas push-registreringen samtidigt som notifikationsbeställningen avslutas. Programmet ska göra en ny push-registrering och för registreringen välja den nya uppdaterade skattekortsbeställningskoden. Om programmet använder endast gränssnittet ListNotifications såsom i exempel 2, byts den nya beställningskoden till gränssnittet ListNotifications.

Om användaren vill avsluta användningen av notifikationstjänsten helt och hållet, ska programmet utföra ovannämnda åtgärder och inte alls göra nya beställningar.

Sidan har senast uppdaterats 17.6.2025