Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar Anläggningsprojekt för ett nationellt inkomstregister

Transkript

1 Version 1.02 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar Anläggningsprojekt för ett nationellt inkomstregister

2 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 2 (24) Versionshistoria Version Datum Beskrivning Dokumentet har publicerats Stycket Tidsstämplar i avsnittet Allmänt har fått ett nytt namn => Datum och klocktider. Behandlingen av datum och klocktider preciseras i stycket Namnet på koduppsättningen för elementet Typ av underorganisationens identifierare i datagruppen Betalarens underorganisationer har uppdaterats: SubrgType => PayerSubrgType. Behandlingsregeln av elementet ProductionEnvironment har preciserats. Behandlingsreglerna som gäller datagruppen Betalarens underorganisationer (Subrgs) och dess uppgifter har preciserats. Elektronisk underskrift har lagts till: datagruppen Underskrift (Signature) på materialets huvudnivå. Datatypen xs:boolean har ändrats till datatypen irct:truerfalse (IRCommonTypes.xsd). Reglerna för tolkning av stora och små bokstäver i avsnittet Allmänt/Teckentabell har preciserats. Namnrymden för XML-underskriftens schema har lagts till i avsnittet Allmänt/Schema. Datastrukturen av arbetsolycksfallsförsäkringsbolagets identifierare som anges i datagruppen Arbetsolycksfallsförsäkring (AccidentInsurance) har ändrats på så sätt att det också är möjligt att ange andra identifierare än ett finskt F-nummer. Behandlingsreglerna av uppgifterna i datagruppen Arbetspensionsförsäkringar (PensionInsurances) har preciserats så att de motsvarar reglerna för anmälningar om löneuppgifter.

3 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 3 (24) INNEHÅLL 1 Allmänt Schema Teckentabell Datum och klocktider Läsanvisning för dokument Arbetsgivarens separata anmälan (PayerSummaryReportsToIR) Uppgifter om materialet (DeliveryData) Kontaktpersoner för materialet (ContactPersons) Uppgifter om betalaren (Payer) Betalarens identifierare (PayerIds) Grundläggande uppgifter om betalaren (PayerBasic) Betalarens adress (Address) Betalarens underorganisationer (Subrgs) Arbetspensionsförsäkringar (PensionInsurances) Arbetsolycksfallsförsäkringar (AccidentInsurances) Uppgifter om anmälningar (Reports) Uppgifter om tjänsten (ReportData) Rapporteringsperiod (PaymentMonth) Inkomstslag (Transactions)... 24

4 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 4 (24) 1 ALLMÄNT 1.1 Schema Arbetsgivarens separata anmälningar sänds till inkomstregistret med schemat PayerSummaryReportsToIR. Schemats namnrymder är som följer: Filens namn Prefix Namespace xmlns:xs PayerSummaryReportsToIR.xsd xmlns:psrtir PayerSummaryReportsToIRTypes.xsd xmlns:psrtirt IRCommonTypes.xsd xmlns:irct xmldsig-core-schema.xsd xmlns:ds Tomma element godkänns inte i meddelandena. m ett element inte får ett värde, utelämnas det helt från meddelandet. Tomma teckensekvenser godkänns inte, dvs. längden på alla värden är minst Teckentabell I inkomstregistrets scheman används standardteckentabellen för XML, UTF-8. Filen får inte innehålla tecknet Byte rder Mark (BM). I tabellen nedan presenteras kraven på konvertering av specialtecken som förekommer i meddelandena. Märke Beskrivning Format som entitet & et-tecken & obligatorisk konvertering < mindre än < obligatorisk konvertering > större än > konvertering är inte obligatorisk, men förenlig med god praxis ' apostrof &apos; konvertering är inte obligatorisk, men förenlig med god praxis " citattecken " konvertering är inte obligatorisk, men förenlig med god praxis -- dubbelstrecken Tecknet får inte förekomma i en xml-fil /* snedstreck asterisk Tecknet får inte förekomma i en xml-fil &# et-tecken nummertecken Tecknet får inte förekomma i en xml-fil Stora och små bokstäver har betydelse i följande uppgifter: Landskoder i alla datagrupper (t.ex. DE tolkas som en annan kod än De ).

5 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 5 (24) Kundnummer i alla datagrupper (t.ex H tolkas som en annan identifierare än h ). 1.3 Datum och klocktider I datum (datatyp xs:date) får tidszonuppgiften inte inkluderas. Exempel på datum: <StartDate> </StartDate> I dataelement som innehåller klocktider (datatyperna xs:datetime och xs:time) ska tidszonen inkluderas. Exempel: i Finlands tidszon (UTC+2): <Timestamp> T08:00:00+02:00</Timestamp> <Time>08:00:00+02:00</Time> Exempel: i UTC-tid (UTC+0): <Timestamp> T6:00:00Z</Timestamp> <Time>06:00:00Z</Time> 1.4 Läsanvisning för dokument Markeringen 0.. längst nere till höger i elementen i dokumentets scheman betyder att elementet kan upprepas flera gånger och kan också saknas helt. Markeringen 1.. betyder att elementet kan upprepas flera gånger, men alltid minst en gång. bligatoriska element har märkts ut med en sammanhängande kantlinje och frivilliga element med en streckad kantlinje. I dokumentets tabeller anges huruvida element är obligatoriska eller frivilliga med följande markeringar: F/ F F/ Förklaring Elementet är alltid frivilligt. Elementet är obligatoriskt om dess "moderelement" är med. Elementet är villkorligt obligatoriskt. I behandlingsreglerna av uppgifter beskrivs de situationer i vilka elementet är obligatoriskt. I vissa element används värden i en begränsad värderymd, dvs. koder, på meddelandena. Elementens värderymd, dvs. möjliga värden beskrivs i dokumentet "Koduppsättningar" och "Koduppsättningar - Inkomstslag". I detta dokument hänvisas till värden som anges i en koduppsättning med namnet "koduppsättningar".

6 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 6 (24) 2 ARBETSGIVARENS SEPARATA ANMÄLAN (PAYERSUMMARYREPRTSTIR) Material som innehåller arbetsgivarens separata anmälan sänds till inkomstregistret har följande allmänna struktur: Datagruppens namn Typ F/ Uppgifter om materialet (DeliveryData) psrfirt:deliverydata Kontaktpersoner för materialet (ContactPersons) psrfirt:contactpersons Uppgifter om betalaren (Payer) psrfirt:payer Betalarens identifierare (PayerIds) psrfirt:payerids F/ Grundläggande uppgifter om betalaren (PayerBasic) psrfirt:payerbasic F/ Betalarens adress (Address) psrfirt:address F/ Betalarens underorganisationer (Subrgs) psrfirt:subrgs F/ Arbetspensionsförsäkringar (PensionInsurances) psrfirt:pensioninsurances F Arbetsolycksfallsförsäkringar (AccidentInsurances) psrfirt:accidentinsurances F Uppgifter om anmälningar (Reports) psrfirt:reports Anmälan (Report) psrfirt:report Uppgifter om tjänsten (ReportData) psrfirt:reportdata Rapporteringsperiod (PaymentMonth) psrfirt:paymentmonth Inkomstslag (Transactions) psrfirt:transactions Uppgifter om inkomstslaget (Transaction) psrfirt:transaction Allmänna uppgifter om inkomstslaget (TransactionBasic) psrfirt:transactionbasic Allekirjoitus (Signature) xsig:signaturetype

7 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 7 (24) 2.1 Uppgifter om materialet (DeliveryData) Uppgiftens namn Typ Tillåtna värden F/ Behandlingsregel Uppgifter om materialet (DeliveryData) psrtirt:deliverydata Tidpunkten då materialet bildades xsd:datetime

8 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 8 (24) (Timestamp) Datakälla (Source) irct:string30 Typ av material (DeliveryDataType) xs:int koduppsättning: DeliveryDataType och av det värdet 101 Materialets ägares (betalarens) materialreferens (DeliveryId) Kontroll av processeringen av felaktiga uppgifter (anmälningar) (FaultyControl) irct:string40 Materialets ägares materialreferens ska specificera alla material för en bestämd betalare (Payer) som innehåller arbetsgivarens separata anmälan (DeliveryDataType=101). xs:int koduppsättning: FaultyControl Produktionsmiljö (ProductionEnvironment) irct:truerfalse koduppsättning: ProductionEnvironment m materialet innehåller felaktiga anmälningar, används uppgiften för att styra huruvida endast felaktiga anmälningar i materialet förkastas eller om hela materialet förkastas. m uppgiften är true ska materialet vara sänt till inkomstregistrets produktionsmiljö. m uppgiften är false ska materialet vara sänt till inkomstregistrets testmiljö. Materialets ägare (DeliveryDatawner) psrtirt:id Som materialets ägare ska samma part som betalaren (Payer) anges i datagruppen. m betalaren inte har ett kundnummer, anges materialets skapare (DeliveryDataCreator) som materialets ägare. Typ av identifierare (Type) xs:int koduppsättning: IdType Identifierare (Code) irct:string30 m "Typ av identifierare" är "F-nummer", ska identifieraren vara existerande (utifrån information som finns att få i Företags- och organisationsdatasystemet FDS). m Typ av identifierare är Finsk personbeteckning, ska identifieraren vara existerande (utifrån information som finns att få i Befolkningsdatasystemet BDS). Landskod (CountryCode) irct:string2 En kod med två bokstäver i enlighet med landskodsystemet IS3166. m landet är okänt, anges värdet "99". F/ bligatorisk uppgift om "Typ av identifierare" är någon annan än "F-nummer" eller "Finsk personbeteckning". Landets namn (CountryName) irct:string70 F/ bligatorisk uppgift om "Landskod" är "99". Materialets skapare (DeliveryDataCreator) psrtirt:id Behandlingsreglerna för Typ av identifierare, Identifierare, Landskod och Landets namn på samma sätt som för datagruppen Materialets ägare (DeliveryDatawner). Materialets avsändare (DeliveryDataSender) psrtirt:id Behandlingsreglerna för Typ av identifierare, Identifierare, Landskod och Landets namn på samma sätt som för datagruppen Materialets ägare (DeliveryDatawner).

9 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 9 (24) Kontaktpersoner för materialet (ContactPersons) psrtirt:contactpersons Anmälningsdag (Reportdate) xs:date Uppgiften ska vara den innevarande dagen eller tidigare. Uppgiften kan inte vara tidigare än Uppgifter om betalaren (Payer) psrtirt:payer Uppgifter om anmälningar (Reports) psrtirt:reports Underskrift (Signature) xsig:signaturetype I datagruppen levereras materialets elektroniska underskrift.

10 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 10 (24) 2.2 Kontaktpersoner för materialet (ContactPersons) Uppgiftens namn Typ Tillåtna värden F/ Behandlingsregel Kontaktpersoner för materialet (ContactPersons) psrtirt:contactpersons Kontaktperson för materialet (ContactPerson) psrtirt:contactperson Det kan finnas flera kontaktpersoner. Namn (Name) irct:string200 Telefonnummer (Telephone) irct:string40 E-postadress ( ) irct:string70 F Ansvarsområde (ResponsibilityCode) xs:int koduppsättning: ResponsibilityCode F

11 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 11 (24) 2.3 Uppgifter om betalaren (Payer) Uppgiftens namn Typ Tillåtna värden F/ Behandlingsregel Uppgifter om betalaren (Payer) psrtirt:payer Betalarens identifierare (PayerIds) psrtirt:payerids F/ Grundläggande uppgifter om betalaren (PayerBasic) psrtirt:payerbasic Betalarens adress (Address) psrtirt:address F/ Betalarens underorganisationer (Subrgs) psrtirt:subrgs F/ Arbetspensionsförsäkringar (PensionInsurances) Arbetsolycksfallsförsäkringar (AccidentInsurances) psrtirt:pensioninsuranc es psrtirt:accidentinsuranc es F/ F F

12 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 12 (24) 2.4 Betalarens identifierare (PayerIds) Uppgiftens namn Typ Tillåtna värden F/ Behandlingsregel Betalarens identifierare (PayerIds) psrtirt:payerids F/ bligatorisk datagrupp, om uppgiften "Betalaren saknar kundnummer" inte har angetts. Betalarens identifierare (Id) psrtirt:id Betalaren kan ha flera identifierare. Typ av identifierare (Type) xs:int koduppsättning: IdType Identifierare (Code) irct:string30 m "Typ av identifierare" är "F-nummer", ska identifieraren vara existerande (utifrån information som finns att få i Företags- och organisationsdatasystemet FDS). m Typ av identifierare är Finsk personbeteckning, ska identifieraren vara existerande (utifrån information som finns att få i Befolkningsdatasystemet BDS). Landskod (CountryCode) irct:string2 En kod med två bokstäver i enlighet med landskodsystemet IS3166. m landet är okänt, anges värdet "99". F/ bligatorisk uppgift om "Typ av identifierare" är någon annan än "F-nummer" eller "Finsk personbeteckning". Landets namn (CountryName) irct:string70 F/ bligatorisk uppgift om "Landskod" är "99".

13 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 13 (24)

14 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 14 (24) 2.5 Grundläggande uppgifter om betalaren (PayerBasic) Uppgiftens namn Typ Tillåtna värden F/ Behandlingsregel Grundläggande uppgifter om betalaren (PayerBasic) psrtirt:payerbasic F/ bligatorisk uppgift, om man i datagruppen "Betalarens identifierare" inte har angett någon sådan identifierare där "Typ av identifierare" är "F-nummer" eller "Finsk personbeteckning". Betalaren saknar kundnummer (MissingId) irct:true "true F/ bligatorisk uppgift, om ingen identifierare har angetts i datagruppen "Betalarens identifierare". Företagets namn (CompanyName) irct:string200 F/ bligatorisk uppgift i följande fall: I datagruppen "Betalarens identifierare" har inte angetts en identifierare där "Typ av identifierare" är "F-nummer" eller "Finsk personbeteckning" och uppgifterna "Efternamn", "Förnamn" har inte angetts. Uppgiften "Betalaren saknar kundnummer" är "true" och uppgifterna "Efternamn", "Förnamn" har inte angetts. Efternamn (LastName) irct:string200 F/ bligatorisk uppgift i följande fall: I datagruppen "Betalarens identifierare" har inte angetts en identifierare där "Typ av identifierare" är "F-nummer" eller "Finsk personbeteckning" och uppgiften "Företagets namn" har inte angetts. Uppgiften "Betalaren saknar kundnummer" är "true" och uppgiften "Företagets namn" har inte angetts.

15 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 15 (24) Förnamn (FirstName) irct:string100 F/ Kontrolleras i likhet med "Efternamn". Födelsedatum (BirthDate) xs:date F/ bligatorisk uppgift i följande fall: I datagruppen "Betalarens identifierare" har inte angetts en identifierare där "Typ av identifierare" är "Finsk personbeteckning" och uppgifterna "Förnamn", "Efternamn" har angetts. Uppgiften "Betalaren saknar kundnummer" är "true" och uppgifterna "Förnamn, "Efternamn" har angetts. Kontaktspråk (Language) xs:int koduppsättning: Language F Födelsedatumet får inte vara senare än innevarande dag.

16 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 16 (24) 2.6 Betalarens adress (Address) Uppgiftens namn Typ Tillåtna värden F/ Behandlingsregel Betalarens adress (Address) psrtirt:address F/ bligatorisk datagrupp i följande fall: I datagruppen "Betalarens identifierare" har inte angetts någon sådan identifierare, där "Typ av identifierare" är "F-nummer" eller "Finsk personbeteckning". Uppgiften "Betalaren saknar kundnummer" är "true". c/o-identifierare (Co) irct:string70 F Gatuadress (Street) irct:string100 F/ m datagruppen anges, ska antingen Gatuadress eller PB anges. PB (PBox) irct:string10 F/ m datagruppen anges, ska antingen Gatuadress eller PB anges. Postnummer (PostalCode) irct:string20 Postanstalt (Postffice) irct:string200 Landskod (CountryCode) irct:string2 En kod med två bokstäver i enlighet med landskodsystemet IS3166. m landet är okänt, anges värdet "99". F/ bligatorisk uppgift i följande fall: I datagruppen Betalarens identifierare har inte angetts någon sådan identifierare, där Typ av identifierare är F-nummer eller Finsk personbeteckning. Uppgiften "Betalaren saknar kundnummer" är "true". Landets namn (CountryName) irct:string70 F/ bligatorisk uppgift om "Landskod" är "99".

17 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 17 (24) 2.7 Betalarens underorganisationer (Subrgs) Uppgiftens namn Typ Tillåtna värden F/ Behandlingsregel Betalarens underorganisationer (Subrgs) psrtirt:subrgs F/ bligatorisk datagrupp om Arbetspensionsanstaltens bolagskod (PensionProvIdCode), som är 20, 24, 25, 29 eller 30, har angetts i datagruppen Arbetspensionsförsäkringar (PensionInsurances). Då ska betalarens underorganisation, vars "Typ av underorganisationens identifierare" är "Kevas anmälarkoder" anges i datagruppen. Betalarens underorganisation (Subrg) psrtirt:subrg Betalaren kan ha flera underorganisationer. Typ av underorganisationens identifierare (Type) xs:int koduppsättning: PayerSubrgType Betalaren kan endast ha en underorganisation för en bestämd uppgift Typ av underorganisationens identifierare. Exempel: Betalaren kan endast ha en underorganisation vars Typ av underorganisationens identifierare är Kevas anmälarkoder. Underorganisationens identifierare (Code) irct:string20 m "Typ av underorganisationens identifierare" är "Kevas anmälarkoder", ska den uppgift som ges vara giltig på den dag som anges i Kevas koduppsättning som "Anmälningsdag". m Typ av underorganisationens identifierare är någon annan ska uppgiften finnas i den koduppsättning som angetts. m koduppsättningen har en giltighetstid ska uppgiften vara giltig på en sådan dag som anges i uppgiften Prestationens betalningsdag eller annan anmälningsdag i koduppsättningen.

18 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 18 (24) 2.8 Arbetspensionsförsäkringar (PensionInsurances) Uppgiftens namn Typ Tillåtna värden F/ Behandlingsregel Arbetspensionsförsäkringar (PensionInsurances) Arbetspensionsförsäkring (PensionInsurance) Arbetspensionsanstaltens bolagskod (PensionProvIdCode) Pensionsarrangemangnummer (PensionPolicyNo) psrtirt:pensioninsuranc es psrtirt:pensioninsuranc e xs:int irct:pensionpolicyno koduppsättning: PensionProvIdCode Arbetspensionsanstaltern as koduppsättning för pensionsarrangemangnu mmer F Betalaren kan ha flera arbetspensionsförsäkringar. Uppgiften ska vara identisk med de första två tecknen i uppgiften Pensionsarrangemangnummer. Uppgiften ska vara pensionsarrangemangnumret i enlighet med Arbetspensionsanstalternas koduppsättning för pensionsarrangemangnummer och den ska vara giltig på den dag som anges i uppgiften Prestationens betalningsdag eller annan anmälningsdag.

19 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 19 (24) 2.9 Arbetsolycksfallsförsäkringar (AccidentInsurances) Uppgiftens namn Typ Tillåtna värden F/ Behandlingsregel Arbetsolycksfallsförsäkringar (AccidentInsurances) Arbetsolycksfallsförsäkring (AccidentInsurance) Arbetsolycksfallsförsäkringsbolagets identifierare (AccInsProvId) psrtirt:accidentinsuranc es psrtirt:accidentinsuranc e psrtirt:id Typ av identifierare (Type) xs:int koduppsättning: IdType F Betalaren kan ha flera arbetsolycksfallsförsäkringar. Identifierare (Code) irct:string30 m "Typ av identifierare" är "F-nummer", ska identifieraren vara existerande (utifrån information som finns att få i Företags- och organisationsdatasystemet FDS). Landskod (CountryCode) irct:string2 En kod med två bokstäver i enlighet med landskodsystemet IS3166. m landet är okänt, anges värdet "99". F/ bligatorisk uppgift om Typ av identifierare är någon annan än F-nummer. Landets namn (CountryName) irct:string70 F/ bligatorisk uppgift om "Landskod" är "99". Arbetsolycksfallsförsäkringens irct:string20

20 försäkringsnummer (AccInsPolicyNo) Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 20 (24)

21 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 21 (24) 2.10 Uppgifter om anmälningar (Reports) Uppgiftens namn Typ Tillåtna värden F/ Behandlingsregel Uppgifter om anmälningar (Reports) psrtirt:reports Uppgifter om anmälan (Report) psrtirt:report Det kan finnas flera anmälningar. Uppgifter om tjänsten (ReportData) psrtirt:reportdata Rapporteringsperiod (PaymentMonth) psrtirt:paymentmonth Inkomstslag (Transactions) psrtirt:transactions

22 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 22 (24) 2.11 Uppgifter om tjänsten (ReportData) Uppgiftens namn Typ Tillåtna värden F/ Behandlingsregel Uppgifter om tjänsten (ReportData) psrtirt:reportdata En anmälan får förekomma i materialet endast en gång (både den nya anmälningen och en eller flera ersättande anmälningar får inte finnas i samma material). Åtgärdstyp (ActionCode) xs:int koduppsättning: ActionCode Inkomstregistrets anmälningsreferens (IRReportId) irct:guid F/ bligatorisk uppgift, om "Åtgärdstyp" är "Ersättande anmälan" och uppgiften "Betalarens anmälningsreferens" inte har angetts. Uppgiften får inte anges om "Åtgärdstyp" är "Ny anmälan". Betalarens anmälningsreferens (ReportId) irct:string40 F/ bligatorisk uppgift i följande fall: "Åtgärdstyp" är "Ny anmälan". "Åtgärdstyp" är "Ersättande anmälan" och uppgiften "Inkomstregistrets anmälningsreferens" har inte angetts. Anmälningens versionsnummer (ReportVersion) Betalarens anmälningsreferens ska specificera alla arbetsgivarens separata anmälningar för en bestämd betalare. xs:int F Versionsnumret ska vara ett positivt heltal som är större än noll. Uppgiften får inte anges om "Åtgärdstyp" är "Ny anmälan".

23 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 23 (24) 2.12 Rapporteringsperiod (PaymentMonth) Uppgiftens namn Typ Tillåtna värden F/ Behandlingsregel Rapporteringsperiod (PaymentMonth) psrtirt:paymentmonth Betalningsmånad (Month) irct:monthstype Betalningsår (Year) xs:int Betalningsåret kan tidigast vara Betalningsåret kan vara högst innevarande år + 1 år.

24 Sändning av uppgifter Scheman Arbetsgivarens separata anmälningar 24 (24) 2.13 Inkomstslag (Transactions) Uppgiftens namn Typ Tillåtna värden F/ Behandlingsregel Inkomstslag (Transactions) psrtirt:transactions Uppgifter om inkomstslaget (Transaction) psrtirt:transaction Det kan finnas flera olika inkomstslag. Allmänna uppgifter om inkomstslaget (TransactionBasic) Inkomstslagets kod (SummaryTransactionCode) psrtirt:transactionbasic xs:int koduppsättning: SummaryTransactionCod e Belopp (Amount) irct:decimal2 F/ Uppgiften är obligatorisk, om "Inkomstslagets kod" inte är "101" (Ingen lönebetalning).