För programutvecklare - 3/2025

En ny version av Ilmoitin.fi har publicerats ut den 3 juni 2025

De viktigaste ändringarna:

• CRS/DAC2 / Nya kontroller:
  • Födelsedatumet är obligatoriskt om självcertifiering har mottagits (Self-Certification == CRS972) (Kontrollen gäller Individual-kontohavare).
  • Om kontot är nytt (AccountTreatment == CRS982) är uppgiften om självcertifiering obligatorisk (Self-Certification CRS971 eller CRS972).
  • Om ett odokumenterat konto har anmälts (UndocumentedAccount == true) kan man inte anmäla att självcertifiering har mottagits (Self-Certification = CRS972).
• DPI (DAC7)
  • Nya kontroller:
    • Ilmoitin kontrollerar att beteckningen 0000000-0 inte har getts i elementet ReportableSeller/Entity och att beteckningen 000000-0000 inte har getts i elementet ReportableSeller/Individual.
    • Ilmoitin kontrollerar att strukturen ReportableSeller har getts om MessageTypeIndic är DPI401 eller DPI402.
  • Ny anmärkning om det i anmälan ges uppgifter i elementet Taxes:
    • Ni håller på att anmäla skatter som plattformsoperatören tagit ut av säljaren i elementet Taxes. Försäkra er om att skatten som anmäls till exempel inte är moms.
• FPA / eSARA
  • Användningen av eSARA-filer som skickas via Ilmoitin.fi kommer att upphöra den 30 september 2025.
  • FPA rekommenderar att
    • stora arbetsgivare som ansöker om förmåner med eSARA-filer snart övergår till att ansöka om förmåner i inkomstregistret
    • och att små arbetsgivare ansöker om förmåner antingen i inkomstregistret eller i Dagpennings- och ersättningstjänsten för arbetsgivare.
  • Läs mer om övergångsperioden

Aktuellt om Vero API

Ändringar i header-kraven för Vero API-anrop

• Observera att från och med den 12 maj 2025 kommer alla REST API-anrop till Vero API-testmiljön (apitest.vero.fi) att kräva följande vanliga headers: User-Agent, Content-Type och Accept.
• I produktionsmiljön (api.vero.fi) blir dessa headers obligatoriska den 15 september 2025. Denna förändring förbättrar säkerheten och kompatibiliteten. Se till att din programvara inkluderar dessa headers i alla API-anrop. Header-kraven för produktionsmiljön kan uppdateras i programvaran omedelbart.
• Följande information rekommenderas i User-Agent-Headern:
  • Applikationsnamn: Hjälper till att identifiera vilken applikation som gör begäran.
  • Version: Anger applikationens version, vilket gör det möjligt för servern att särskilja olika versioner.
  • Operativsystem: Ger information om vilket operativsystem applikationen körs på.
  • Exempel: User-Agent: MyApp/1.0 (Windows NT 10.0; Win64; x64)

Läs mer: Tekniska riktlinjer för Vero API-gränssnitten - vero.fi

Skatteförvaltningens certifikattjänst

Uppdaterade och nya anvisningar:

• Skatteförvaltningens certifikattjänst – beskrivning av PKI-systemet och gränssnitten dokumentet innehåller tekniska förtydliganden gällande RSA-nyckellängden.
• Snabbguide till att skapa certifikat - innehåller tekniska förtydliganden gällande RSA-nyckellängden.
• Exemplet på certifikatförnyelse har flyttats till en separat undersida på certifikattjänstens webbplats.
• Hur kan utländska organisationer och privatpersoner sköta ärenden i certifikattjänsten
• Ansökan av produktionscertifikat för en utländsk användare som inte har ett finländskt identifieringsverktyg

Kontaktuppgifter och frågor

ohjelmistotalot(at)vero.fi

Till programvaruleverantörernas e-post kan man i fortsättningen även skicka programvaruleverantörerna frågor som gäller inkomstregistret. Frågorna skickas vidare till Inkomstregisterenheten, men det är bra att komma ihåg att

• e-posten är avsedd endast för programvaruleverantörerna
• e-posten är avsedd för rådgivning till stöd för utvecklingen
• e-posten inte är avsedd för hantering av fel i produktionen
• tekniska störningar eller observationer ska fortfarande rapporteras på observationsblanketten för inkomstregistret