KMD Fravær Snitfladebeskrivelse for DH300010Q - Transaktioner til KMD Fravær Version 1.2 05.10.2009 KMD 2001. Alle rettigheder forbeholdes. Dette materiale er ophavsretligt beskyttet og må ikke kopieres i videre omfang end forudsat i ophavsretsloven.
lndholdsfortegnelse 1. Brug af snitfladebeskrivelsen... 3 2. Formål og målgrupper... 4 Hvad er formålet med standardsnitfladen?... 4 Hvem er målgrupperne?... 4 Forudsætninger.... 4 3. Standardsnitfladens arkitektur... 5 4. Teknisk implementering... 6 KFS-3270/Win... 6 KFS/LAN-NT eller KFS/LAN-UNIX... 6 5. Betingelser for anvendelse af standardsnitfladen... 7 6. Garantier... 7 7. Protokol for dataudveksling... 8 Definition af datasæt... 8 Hvordan opbygges datastrømmen?... 8 Start-identifikationstransaktion... 8 Slut-identifikationstransaktion... 9 Eksempel på anvendelse... 9 Hvilke(t) tegnsæt skal anvendes?... 9 Hvilke datastrukturer skal anvendes?... 9 DH6 - Fraværsoplysninger... 11 Hvilke dataformater skal anvendes?... 12 Generelle regler for udfyldelse af felter... 12 Feltbeskrivelser... 12 8. Validering af data... 19 Hvilke krav stilles der til validiteten af data?... 19 Numeriske felter... 19 Feltkombinationskontroller... 19 Registerkontroller... 20 9. Sikkerhed... 21 10. Eksempler... 22 Article Article I. II. Article III. Article IV.
Article V. Grundlag for indgåelse af aftaler. Article VI. 1. Brug af snitfladebeskrivelsen Denne snitfladebeskrivelse udgør grundlaget for indgåelse af konkrete aftaler med KMD's kunder om udveksling af data med KMD Fravær baseret på standardsnitfladen FRAVÆR 01. Den er desuden et praktisk arbejdsredskab til støtte for kommunikationen mellem kunderne og KMD om standardsnitfladens anvendelse. Beskrivelsen må ikke overdrages eller kopieres i videre omfang end forudsat i ophavsretsloven men kun udlånes til softwareleverandører i forbindelse med etablering af snitfladen samt ved fremtidige ændringer. Henvendelser vedrørende standardsnitfladen rettes til: KMD Aalborg Serviceteam Tidsstyring Lauritzens Plads 1, 9000 Aalborg Ansvarlig enhed/gruppe i KMD er Produktudvikling Løn og personale. Udlån til andre leverandører. Kontakt til KMD. 3
Article VII. 2. Formål og målgrupper Section 7.01 Hvad er formålet med standardsnitfladen? Formålet med standardsnitfladen er at give andre systemer mulighed for, via en fælles snitflade, at aflevere til KMD Fravær. Ved udnyttelse af dette systems funktioner, kan et hvilket som helst system, der er "optaget" som dataleverandør, forholdsvis enkelt sikre sig korrekte transaktioner til KMD Fravær. Section 7.02 Hvem er målgrupperne? Beskrivelsen henvender sig til såvel interne som eksterne interessenter, der ønsker at optræde som dataleverandør. Ved interne interessenter forstås systemafdelinger i KMD, der har det produktmæssige ansvar for et fælleskommunalt eller individuelt system. Eksterne interessenter er kunder, som ønsker at aflevere fraværsoplysninger til KMD Fravær. Det kan f.eks. også være pc-systemer, som kunden får udviklet hos andre softwareleverandører. I sådanne tilfælde er det kunden og ikke softwareleverandøren, der kan blive abonnent på snitfladebeskrivelsen. Section 7.03 Forudsætninger. En forudsætning for eksterne kunder som ønsker at aflevere fraværsoplysninger til KMD Fravær er, at der er oprettet brugeroplysninger via skærmbillede DH06 og evt. oplysninger vedr. sygdomspolitik via skærmbillede DH05. Derudover skal lønmodtagerne være oprettet i KMD s Løn- og Personalesystem (herefter kaldet KLP)/KMD Opus Personale. Der er mulighed for at specificere fravær vedr. kursus, tjenestefri og orlov via en kursus/tjenestefri/orlov kode. Kunden skal på forhånd have opbygget kursuskodetabel via skærmbillede DH29 og/eller tjenestefrikodetabel via skærmbillede DH30 og/eller orlovskodetabel via skærmbillede DH31 inden denne kode benyttes ved overførsel af fraværsoplysninger. 4
Article VIII. 3. Standardsnitfladens arkitektur Data Validering og omformning Fejlliste KMD Fravær 5
Article IX. 4. Teknisk implementering Transaktioner til KMD Fravær skal fremsendes på en af følgende måder: - Via KFS-3270/Win - Via KFS/LAN-NT - Via KFS/LAN-UNIX hvor KFS er betegnelsen for KMDs FilforsendelsesSystem. Section 9.01 KFS-3270/Win De afsendte data kan enten være opbygget i EBCDIC- eller ASCII-code. Ved modtagelse i KMD skal data være opbygget i EBCDIC-code. Evt. konvertering fra ASCII- til EBCDIC-code skal være foretaget inden modtagelse hos KMD. En sådan konvertering kan ske via KFS-3270/Win. Section 9.02 KFS/LAN-NT eller KFS/LAN-UNIX De afsendte data kan enten være opbygget i ANSI- eller ASCII-code. Konvertering fra ASCII/ANSI- til EBCDIC-code skal være foretaget inden modtagelse hos KMD. En sådan konvertering sker automatisk via KFS/LAN-NT/UNIX. 6
Article X. 5. Betingelser for anvendelse af standardsnitfladen Det er en forudsætning, at det system, der sender data, sikrer den nødvendige indpakning af transaktionerne. Dataleverandøren må derfor tilegne sig det nødvendige kendskab til opbygning af startidentifikations- og sluttransaktion (Z300 og SLUTD). Se yderligere oplysninger i afsnittet Protokol for dataudveksling. I forbindelse med udlevering af snitfladebeskrivelsen skal der indgås endelig aftale om måden, dataleverandøren forsender data på. Ønskes den endelige aftale ændret af dataleverandøren, skal dette meddeles KMD skriftligt. Ved ændret aftale fremsendes ikke revideret snitfladebeskrivelse. Det er dataleverandørens/snitfladeabonnentens ansvar, at transaktionerne er afsendt til KMD i overensstemmelse med denne snitfladebeskrivelse samt rettidigt i forhold til fraværskørsler i KMD Fravær. Indpakning af transaktioner Indgåelse af aftale om forsendelses-metoden. Dataleverandørens ansvar Article XI. 6. Garantier Ændringsvarsel i forbindelse med datastrukturer og valideringsregler er 3 måneder. 7
Article XII. 7. Protokol for dataudveksling Section 12.01 Definition af datasæt Datasættet der benyttes skal defineres som Variabel Blokket med en recordlængde på 131. Inden for hver Z300/SLUTD skal transaktionerne være sorteret på: Brugernummer/aflønningsform/personnummer/ekstra ciffer Section 12.02 Hvordan opbygges datastrømmen? Transaktioner skal indpakkes i Z300/SLUTD. Det betyder: at første transaktion i en forsendelse altid skal være Z300 at sidste transaktion i en forsendelse altid skal være SLUTD Symbolforklaring til kolonnen repræsentation: AN = Alfanumerisk felt N = Numerisk felt I transaktionerne skal felterne angives i den viste rækkefølge, udfyldes som angivet og altid have den angivne faste længde. (a) Start-identifikationstransaktion Feltbetegnelse Feltlængde Repræsent. Udfyldes således Transaktionskode 4 AN Z300 Disponibel 1 AN Blank Brugernummer 4 N XXXX Medietype 1 N 6 Brugerens volumenummer 6 AN Blanke Registrerings dagnummer 3 N Dagnr. i året Kode for blandede transer 1 N 0 Terminal afsender identifikation 3 AN XXX Til eget brug Opgavenummer 1 AN D Logisk datasætnummer 2 N 25 - hvis via filoverførsel 26 - hvis via web Fast længde: 26 8
(b) Slut-identifikationstransaktion Article XIII. Feltbetegnelse Feltlængde Repræsent. Udfyldes således Slutidentifikation 5 AN SLUTD Antal records 5 N Fast længde: 10 Feltet Antal records skal udfyldes med det samlede antal records (eks. 00057). Start-individ (Z300) og slut-individ (SLUTD) skal ikke tælles med. (a) Eksempel på anvendelse De i eksemplet angivne x er erstattes af transaktioner, som beskrevet ovenfor. Z300 02356 1230001D25 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx SLUTD00004 Section 13.02 Hvilke(t) tegnsæt skal anvendes? For at sikre, at data afleveres korrekt, og for ikke at få problemer med danske specialtegn som æ, ø, og å skal data til KMD afsendes med følgende codepages uanset den valgte forsendelsesmetode: Pc'er/servere med Windows 3.x skal anvende Codepage 850. Pc'er/servere med Windows 95 eller nyere og Windows NT skal anvende Codepage 1252 (alternativt Codepage 819). Section 13.03 Hvilke datastrukturer skal anvendes? Dataleverandøren kan aflevere følgende transaktionstyper til KDM Fravær: Transtype Betegnelse for transen i) D H 6 Indeholder oplysninger om den enkelte lønmodtagers fravær samt evt. supplerende transaktion til løn vedr. betaling omkring fravær. Transaktionerne afleveres i henhold til de strukturer, der er nærmere beskrevet i det følgende. Symbolforklaringer til strukturerne: Kolonnens udfyldelse: F = Feltet skal altid udfyldes med en fast værdi. Denne faste værdi er angivet under eksempel. X = Krævede felter, skal altid udfyldes. 9
V = Valgfrie felter. Ikke udfyldte felter skal være blanke. <AA> = Feltet afhængigt af andet felt jævnfør regler beskrevet under pkt. 6.3 Kombinationskontroller. AA henviser til det felt, der bestemmer indholdet. Blank = Feltet må ikke anvendes. Kolonnens repræsentation: AN = Alfanumerisk felt. N = Numerisk felt. I transaktionerne skal felterne angives i den viste rækkefølge og altid have den angivne faste længde. 10
(b) DH6 - Fraværsoplysninger Feltbetegnelse Feltnr. Udfyldelse Feltlængde Repræsent. Eksempel Dataleverandørident 01 F 4 AN 1DHI Transaktionstype 02 F 3 AN DH6 Tidsstempling 03 X 20 N Brugernummer 04 X 4 N Aflønningsform 05 X 1 N Personnummer 06 X 10 N Ekstra ciffer 07 V,<06> 1 N Raskmeldingskode 20 V 1 AN Første fraværsdato 21 V,<23,24> 8 N Indberetningsdato 22 X 8 N Sidste fraværsdato 23 V 8 N Årsagskode 24 V,<21> 2 AN Antal fraværstimer 25 V,<24> 6 N Antal arbejdsdage 26 V,<24> 5 N Kursus/tjenestefri/orlov kode 27 V,<24> 3 AN Ansættelsesmåde 28 V,<24> 2 AN Forventet dato for fødsel 29 V,<24,30> 8 N Faktiske dato for fødsel 30 V,<24,29> 8 N TF-kode til løntrans 31 V,<34> 4 N Antal enheder til løntrans 32 V,<31> 9 N Enhedspris til løntrans 33 V,<31> 9 N Historik 34 V 1 AN Slet denne fraværsperiode 35 V<21> 1 AN Slet hele lønmodtageren 36 V 1 AN Fast længde: 127 11
Section 13.04 Hvilke dataformater skal anvendes? (a) Generelle regler for udfyldelse af felter Med mindre andet er angivet under beskrivelsen af det enkelte felt gælder følgende regler: Alle numeriske felter højrestilles med foranstillede nuller. Alle alfanumeriske felter venstrestilles med efterfølgende blanke. De felter i strukturen, som ikke anvendes, skal minimumstilles, det vil sige numeriske felter nulstilles og alfanumeriske felter blankes/udfyldes jvf. værdisæt for det enkelte felt. Datofelter angives altid med 4-cifrede årstal i formatet HHÅÅ. HH angiver århundrede, som kan være 19 eller 20. ÅÅ angiver år, som kan være 00-99. Eksempler på datofelter: 19991230 angiver 30. december 1999 20010117 angiver 17. januar 2001 Visse datofelter kan desuden indeholde specielle værdier. Dette vil fremgå af værdisættet for det enkelte felt. Nogle beløbsfelter kan indeholde såvel negative som positive beløb, mens andre kun kan indeholde positive beløb. Dette vil fremgå af værdisættet for det enkelte beløb. Afhængig af oplysningerne i strukturen skrives beløb som et 8-cifret, et 10-cifret eller et 12-cifret felt efterfulgt af et fortegn på 1 position. Alle beløb er med foranstillede nuller. Positive beløb har fortegnet "+" og negative fortegnet "-". Eksempler på beløbsfelter: 8 cifre + fortegn: 01234567+ 01234567-00000000+ 10 cifre + fortegn: 0001234567+ 0001234567-0000000000+ 12 cifre + fortegn: 000001234567+ 000001234567-000000000000+ (b) Feltbeskrivelser 01 DATALEVERANDØR IDENT: Identifikation på den leverandør som afleverer transaktionerne. Repræsentation : Alfanumerisk 4 positioner Værdisæt : Følgende er tildelt dataleverandøren af KMD ved aftale om abonnement på snitfladen: 1DHI 02 TRANSAKTIONSTYPE: Feltet angiver hvilken typetransaktion, det drejer sig om. Repræsentation : Alfanumerisk 3 positioner Værdisæt : Se afsnit 7 i denne snitfladebeskrivelse. DH6 Fraværsoplysninger med evt. supplerende oplysninger til lønsystem 12
03 TIDSSTEMPLING: Tidsstempling af den enkelte transaktion for at sikre korrekt ajourføringssekvens. Repræsentation : Numerisk 20 cifre Værdisæt : HHÅÅMMDDttmmssssssss!!!!!!!---> sekundtal!!!!!!-----> minuttal!!!!!-------> timetal!!!! --------> dag!!!-----------> måned!!-------------> år!---------------> århundrede Eksempel : 19990114123120672228 04 BRUGERNUMMER: Identifikation af det brugernummer, som transaktionen skal henføres til. Repræsentation : Numerisk 4 cifre Værdisæt : 0000-9999 05 AFLØNNINGSFORM: Identifikation af den enkelte lønmodtagers aflønningsform. Repræsentation : Alfanumerisk 1 position Værdisæt : 0,1,2,3,4,5,6,7. 06 PERSONNUMMER Identifikation af en lønmodtager. Repræsentation : Numerisk 10 cifre Værdisæt : Personnummer: 010100xxxx - 311299xxxx, hvor xxxx er løbenummeret. Valideringsregel : Personnummer skal være korrekt i henhold til Indenrigsministeriets regler. Personnummeret skal overholde modulus-11 kontrol, som beskrevet på CPR-kontorets hjemmeside på internettet - www.cpr.dk. 07 EKSTRA CIFFER: Anvendes til identifikation af lønmodtagerens ansættelsesforhold, dermed kan samme medarbejder være registreret i flere forskellige ansættelsesforhold. Repræsentation : Numerisk 1 ciffer Værdisæt : 0-9 Valideringsregel : Hvis feltet ikke anvendes, skal det udfyldes med 0. 20 RASKMELDINGSKODE: Kode for raskmelding af en fraværsperiode. Repræsentation : Alfanumerisk 1 position Værdisæt : Blank eller R Valideringsregel : Hvis feltet er udfyldt med R må første fraværsdato ikke være udfyldt, og sidste fraværsdato skal være udfyldt. Ved raskmelding af NT, BG, BD, PG og PD skal feltet være blankt. Bliver afvist hvis der ikke er en uafsluttet periode. 13
21 FØRSTE FRAVÆRSDATO: Dato for første fraværsdag. Repræsentation : Numerisk 8 cifre Værdisæt : HHÅÅMMDD!!!!-------> dag!!! --------> måned!!-----------> år!-------------> århundrede Valideringsregel : Feltet skal udfyldes når årsagskode er udfyldt bortset fra ved raskmelding. Dog skal datoen udfyldes ved raskmelding af årsagskode NT, BG, BD, PG og PD. Datoen kan fremdateres ved årsagskode BA, BU, BG, BD, AP, PU, PG, PD, KU og TJ. Datoen skal være mindre end eller lig med sidste fraværsdato. Datoen skal udfyldes hvis der er indtastet slettemarkering for at slette denne fraværsperiode Udfyldes feltet med 00000000 (nuller) anvendes datoen ikke. 22 INDBERETNINGSDATO: Dato for indberetning. Datoen føres ikke med over i fraværssystem, men er udelukkende til eget brug. Indberetningsdatoen på fraværstransaktionen vil være det tidspunkt hvor den oprettes i fraværssystemet. Repræsentation Værdisæt Valideringsregel : Numerisk 8 cifre : HHÅÅMMDD!!!!-------> dag!!! --------> måned!!-----------> år!-------------> århundrede : Udfyldes feltet med 00000000 (nuller) anvendes datoen ikke. 23 SIDSTE FRAVÆRSDATO: Dato for sidste fraværsdag(bemærk: ikke første arbejdsdag). Repræsentation : Numerisk 8 cifre Værdisæt : HHÅÅMMDD!!!!-------> dag!!! --------> måned!!-----------> år!-------------> århundrede Valideringsregel : Kan fremdateres. Hvis feltet er udfyldt, skal det være større end eller lig med første fraværsdato. Skal udfyldes som første fraværsdato hvis årsagskoden er HJ eller DS (altid én dag) Udfyldes feltet med 00000000 (nuller) anvendes datoen ikke 14
24 ÅRSAGSKODE: Kode for årsagen til fraværet. Repræsentation : Alfanumerisk 2 positioner Værdisæt : Hvis feltet udfyldes kan følgende værdier anvendes: AP = Adoption PU = Adoption uden løn PG = Adoption uden løn med delvis genoptagelse af arbejde PD = Drypvis adoption BA = Barsel BU = Barsel uden løn BG = Barsel uden løn med delvis genoptagelse af arbejde BD = Drypvis barsel DS = Delvis syg GG = Graviditetsgener HJ = Barns 1. sygedag KU = Kursus NT= Nedsat tjeneste OR = Orlov OS = Omsorgsdage P2 = Fravær paragraf 28 SY = Sygdom TJ = Tjenestefri TT = Tilskadekomst i tjenesten SO = Seniordage FV = Fritvalgsordning Valideringsregel : Skal udfyldes hvis første fraværsdato er udfyldt. Må ikke udfyldes ved sletning og raskmelding. Dog skal raskmelding af årsagskode NT, BG, BD, PG og PD have feltet udfyldt. Årsagskode GG må kun benyttes af kvinder. 25 ANTAL FRAVÆRSTIMER: Antal fraværstimer. Benyttes til registrering i fraværsstatistikker, evt. videresendelse til Basislønmodulet og til brug for ledelsesinformation, f.eks. LBN og KMD Opus Overblik. Repræsentation : Numerisk 6 cifre. Værdisæt : 000000-999999 Timetallet angives i hundrededele. Valideringsregel : Feltet må ikke udfyldes ved sletning. Antal timer må max. være 740 (7,4 time) ved årsagskode NT. Anvendes feltet ikke skal det udfyldes med 000000 (nuller). Bemærk Såfremt der under TF-kode indberettes 875x, 879x, eller 889 vil antal timer automatisk blive foranstillet med minus ved overførsel af transaktionen til Basislønmodulet. 26 ANTAL ARBEJDSDAGE: Antal arbejdsdage lønmodtageren er fraværende. Repræsentation : Numerisk 5 cifre. Værdisæt : 00000-99999 Antal dage angives i hundrededele. Valideringsregel : Feltet må ikke udfyldes ved sletning eller raskmelding. Må kun indberettes ved årsagskode: KU, TJ, OR eller OS. Hvis årsagskoden er OS, SO eller FV skal feltet udfyldes. Anvendes feltet ikke skal det udfyldes med 00000 (nuller). 15
27 KURSUS/TJENESTEFRI/ORLOV KODE: Kode for kursus/tjenestefri eller orlov. Repræsentation : Alfanumerisk 3 positioner. Værdisæt : Blank eller en kode som er indeholdt i brugers kursuskodetabel, tjenestefritabel eller orlovskodetabel. Valideringsregel : Feltet må ikke udfyldes ved sletning eller raskmelding. Må kun indberettes ved årsagskode: KU, TJ, eller OR. 28 ANSÆTTELSESMÅDE: Kode for lønmodtagerens ansættelsesmåde til styring af dagpengeskemaudskrivning ved adoptionsog barselsfravær. Repræsentation Værdisæt Valideringsregel : Alfanumerisk 2 positioner : Blank = Der udskrives DP401- og DP402-skemaer til aflønningsform 0 og 1 og DP400A-skema for aflønningsform 2-7. DP = Der udskrives DP400A-skema. : Kan kun benyttes hvis årsagskoden er BA eller AP 29 FORVENTET DATO FOR FØDSEL: Dato for forventet fødselstidspunkt eller forventet hjemtagelsesdato ved adoption. Repræsentation : Numerisk 8 cifre Værdisæt : HHÅÅMMDD!!!!-------> dag!!! --------> måned!!-----------> år!-------------> århundrede Valideringsregel : Årsagskoden skal være BA, AP eller GG. Må ikke anvendes ved mænd, hvis årsagskoden er BA eller GG. Ved årsagskode BA for kvinder skal forventet dato for fødsel eller faktiske dato for fødsel være udfyldt. Udfyldes feltet med 00000000 (nuller) anvendes datoen ikke 30 FAKTISKE DATO FOR FØDSEL: Dato for faktiske fødselstidspunkt eller faktiske hjemtagelsesdato ved adoption. Repræsentation : Numerisk 8 cifre Værdisæt : HHÅÅMMDD!!!!-------> dag!!! --------> måned!!-----------> år!-------------> århundrede Valideringsregel : Årsagskoden skal være BA, BU, BG, BD, AP, PU, PG, PD eller OS. Feltet skal udfyldes ved årsagskode OS. Ved årsagskode BA for kvinder skal forventet dato for fødsel eller faktiske dato for fødsel være udfyldt. Hvis årsagskoden er BA, BU, BG, BD, AP, PU, PG PD, og feltet er udfyldt, skal første fraværsdato også udfyldes. Feltet må ikke udfyldes hvis årsagskoden er BA og sidste fraværsdato er udfyldt. Dette gælder dog ikke hvis historik markering = X. Hvis årsagskoden er OS skal sidste fraværsdato være større end faktiske dato for fødsel. Feltet må ikke være udfyldt samtidig med, at forventet dato for fødsel er udfyldt. Udfyldes feltet med 00000000 (nuller) anvendes datoen ikke 16
31 TF-KODE TIL LØNTRANS: En given TF-kode incl. 4. ciffer. Repræsentation : Numerisk 4 cifre Værdisæt : 0001-9998 Valideringsregel : Feltet må ikke udfyldes hvis der er krydsmarkering i feltet til historik. Anvendes feltet ikke skal det udfyldes med 0000 (nuller). 32 ANTAL ENHEDER TIL LØNTRANS: Antal enheder. Repræsentation : Numerisk 8 cifre + fortegn. Værdisæt : 99999999- - 99999999+ Beløbet angives i ører. + = Positivt beløb - = Negativt beløb Valideringsregel : Feltet kan udfyldes ved supplerende transaktion til løn. Feltet skal udfyldes hvis TF-koden er udfyldt. Feltet må ikke udfyldes ved sletning eller raskmelding Anvendes feltet ikke skal det udfyldes med 00000000+ (nuller). 17
33 ENHEDSPRIS TIL LØNTRANS: Enhedspris. Repræsentation : Numerisk 8 cifre + fortegn. Værdisæt : 99999999- - 99999999+ Beløbet angives i ører. + = Positivt beløb - = Negativt beløb Valideringsregel : Feltet kan udfyldes ved supplerende transaktion til løn. Hvis feltet er udfyldt skal TF-koden også udfyldes. Feltet må ikke udfyldes ved sletning, raskmelding eller ved årsagskoderne KU, TJ, OR. Anvendes feltet ikke skal det udfyldes med 00000000+ (nuller). 34 HISTORIK MARKERING: Markering for om man ønsker fraværsoplysningerne som historik. Repræsentation : Alfanumerisk 1 position. Værdisæt : Blank eller X Valideringsregel Feltet benyttes ved nye brugere hvor 1. fraværsdag ligger før opstartsdatoen i KLP/KMD Opus Personale. Der udskrives ingen dagpengeskemaer, men der optælles til 120 dages regel. Hvis feltet er udfyldt må TF-koden ikke være udfyldt. 35 SLET DENNE FRAVÆRSPERIODE: Markering for om denne fraværsperiode skal slettes i KMD Fravær. Repræsentation : Alfanumerisk 1 position Værdisæt : Blank eller S Valideringsregel : Feltet kan udfyldes hvis man ønsker at slette den fraværsperiode som har samme første fraværsdato som den angivne dato i første fraværsdato. Første fraværsdato skal være udfyldt. 36 SLET HELE LØNMODTAGEREN: Markering for om lønmodtagerens stamoplysninger samt alle fraværsperioder skal slettes i KMD Fravær. Repræsentation : Alfanumerisk 1 position. Værdisæt : Blank eller S Valideringsregel : Feltet kan udfyldes hvis man ønsker at slette alle oplysninger for lønmodtageren i KMD Fravær. 18
Article XIV. 8. Validering af data Section 14.01 Hvilke krav stilles der til validiteten af data? (a) Numeriske felter Alle numeriske felter skal udfyldes med nuller hvis de ikke anvendes. (b) Feltkombinationskontroller For hver transaktion udføres følgende kontroller af indbyrdes feltafhængigheder vedrørende udfyldelse. Felt 20 (Raskmeldingskode): Hvis feltet er udfyldt med R må første fraværsdato (felt 21) ikke være udfyldt. Desuden skal sidste fraværsdato (felt 23) være udfyldt. Felt 21 (Første fraværsdato): Feltet skal udfyldes hvis årsagskoden (felt 24) er udfyldt bortset fra ved raskmelding. Feltet skal udfyldes hvis der er slettemarkering for at slette denne fraværsperiode (felt 36) Felt 21 (Første fraværsdato) og felt 23 (Sidste fraværsdato) skal være angivet tidsmæssigt korrekt i forhold til hinanden: Felt Tidsmæssig afhængighed Felt 21 mindre end eller lig med 23 Felt 23 (Sidste fraværsdato): Sidste fraværsdato være lig med første fraværsdato (felt 21) ved de årsagskoder som er angivet i afsnit 7 under valideringsregler for Sidste fraværsdato. Felt 24 (Årsagskode): Feltet skal udfyldes hvis første fraværsdato (felt 21) er udfyldt bortset fra ved sletning eller raskmelding (dog ikke raskmelding af årsagskode NT, BG, BD, PG eller PD ). Felt 25 (Antal fraværstimer): Feltet må max. indeholde 740 hvis årsagskoden (felt 24) er udfyldt med den værdi som er angivet i afsnit 7 under valideringsregler for Antal fraværstimer Felt 26 (Antal arbejdsdage): Feltet må kun udfyldes hvis årsagskoden (felt 24) er udfyldt med de værdier som er angivet i afsnit 7 under valideringsregler for Antal arbejdsdage Felt 27 (Kursus/tjenestefri/orlov kode): Feltet må kun udfyldes hvis årsagskoden (felt 24) er udfyldt med de værdier som er angivet i afsnit 7 under valideringsregler for Kursus/tjenestefri/orlov kode Felt 28 (Ansættelsesmåde): Feltet må kun udfyldes hvis årsagskoden (felt 24) er udfyldt med de værdier som er angivet i afsnit 7 under valideringsregler for Ansættelsesmåde 19
Felt 29 (Forventet dato for fødsel): Feltet må kun udfyldes hvis årsagskoden (felt 24) er udfyldt med de værdier som er angivet i afsnit 7 under valideringsregler for Forventet dato for fødsel. Felt 29 (Forventet dato for fødsel) og felt 30 (Faktiske dato for fødsel): Hvis årsagskoden (felt 24) er udfyldt med de værdier som er angivet i afsnit 7 under valideringsregler for Faktiske dato for fødsel og fraværet er for en kvinde, skal enten Forventet dato for fødsel (felt 29) eller Faktiske dato for fødsel (felt 30) være udfyldt. Felt 30 (Faktiske dato for fødsel): Feltet må kun udfyldes hvis årsagskoden (felt 24) er udfyldt med de værdier som er angivet i afsnit 7 under valideringsregler for Faktiske dato for fødsel. Felt 31 (TF-kode): Feltet må ikke udfyldes hvis der er krydsmarkering i feltet til historik (felt 34). Felt 32 (Antal enheder): Feltet kan udfyldes ved løntransaktioner, men skal udfyldes når TF-koden (felt 31) er udfyldt. Felt 33 (Enhedspris): Hvis feltet er udfyldt skal TF-koden (felt 31) også være udfyldt. Felt 35 (Slet denne fraværsperiode): Hvis feltet er udfyldt skal Første fraværsdato (felt 21) være udfyldt. (c) Registerkontroller For hver transaktion udføres følgende kontroller op imod tabeller/registre. Felt 04 (Brugernummer): Skal findes i KMD Fraværs brugerregister. Felt 05 (Aflønningsform): Brugeren skal have lønmodtagere oprettet i KLP/KMD Opus Personale med pågældende aflønningsform. Felt 06 (Personnummer) og felt 07(Ekstra ciffer): Lønmodtageren skal være oprettet i KLP/KMD Opus Personale for det pågældende ekstra ciffer. 20
Article XV. 9. Sikkerhed I KMD Fravær findes 'dørvogterprogrammel', der holder kontrol med, at det kun er transaktioner fra kendte dataleverandører, der accepteres. Dette sikres ved at snitfladeabonnenter får tildelt en kode på 4 positioner (DATALEVERANDØR IDENT), som skal indsættes i de transaktioner, det pågældende system leverer. Kun transaktioner fra kendte dataleverandører. 21
Article XVI. 10. Eksempler Efterfølgende er en række eksempler på fraværstransaktioner til snitfladen: Bemærk! Stjernemarkering betyder at feltet skal udfyldes med blanke. Adoption (AP, PU, PG eller PD) Start adoption med faktiske hjemtagelsesdato i faktiske fødsel (AP, PU, PG, PD) XXXXDH6200103281231206722280899101117800000*200103262001032800000000AP00000000 000*****0000000020010215000000000000+00000000+*** Start adoption med forventet hjemtagelsesdato i forventet fødsel (AP) XXXXDH6200103281231206722280899125077500000*200103192001032800000000AP00000000 000*****2001041000000000000000000000+00000000+*** Slut efter en åben adoptionsperiode med koderne AP eller PU XXXXDH6200103281231206722280899006077100000R000000002001032820010525**00000000 Slut en åben adoptionsperiode med kode PG eller PD. Årsagskode, første og sidste fraværsdato er udfyldt. XXXXDH6200103281231206722280899006077100000*200103262001032820010525PG00000000 Barsel (BA, BU, BG eller BD) Start barsel med faktiske fødselsdato. 1. fraværsdag udfyldt med 1. barselsorlovsdag (BA, BU, BG, BD) XXXXDH6200103281231206722280899001116600000*200103192001032800000000BA00000000 000*****0000000020010318000000000000+00000000+*** Start barsel med forventet fødselsdato. 1. fraværsdag udfyldt med 1. barselsorlovsdag (BA) XXXXDH6200103281231206722280899125077500000*200103192001032800000000BA00000000 000*****2001041000000000000000000000+00000000+*** Slut en åben barselsperiode med koderne BA eller BU XXXXDH6200103281231206722280899103047100000R000000002001032820010525**00000000 Slut en åben barselsperiode med kode BG eller BD. Årsagskode, første og sidste fraværsdato er udfyldt. XXXXDH6200103281231206722280899103047100000*200103192001032820010525BG00000000 Delvis fravær (DS) Altid kun én record med én dag XXXXDH6200103281231206722280899117067500000*200103262001032820010326DS00020000 Graviditetsgener (GG) Start graviditetsgener med forventet fødselsdato XXXXDH6200103281231206722280899117067500000*200103262001032800000000GG00000000 000*****2001052700000000000000000000+00000000+*** 22
Raskmelding efter graviditetsgener. XXXXDH6200103281231206722280899115086200000R000000002001032820010325**00000000 Barns 1. sygedag (HJ) Altid kun én record med én dag XXXXDH6200103281231206722280899117067500000*200103262001032820010326HJ00000000 Kursus (KU) Altid kun én record med begge datoer udfyldt XXXXDH6200103281231206722280899115076800000*200102162001032820010216KU00040000 Kursuskode er udfyldt XXXXDH6200103281231206722280899115076800000*200102152001032820010216KU00000000 000FOR**0000000000000000000000000000+00000000+*** Nedsat tjeneste (NT) Start på nedsat tjeneste XXXXDH6200103281231206722280899114047500000*200103262001032800000000NT00000000 Raskmelding efter nedsat tjeneste - både årsagskode og begge datoer udfyldt. XXXXDH6200103281231206722280899127057500000*200101152001032820010326NT00000000 Orlov (OR) Start record XXXXDH6200107121015231210320899115066800000*200107112001071200000000OR00000000 Slut record XXXXDH6200107121015231210320899115066800000R000000002001071220011018**00000000 Orlov (OR) med orlovskode. Start record XXXXDH6200108181015231210320899115066800000*200108142001081800000000OR00000000 000BØR**0000000000000000000000000000+00000000+*** Record med afsluttet periode XXXXDH6200103201015231210320899115066800000*200103202001032020010707OR00000000 000BØR**0000000000000000000000000000+00000000+*** Omsorgsdage (OS) Altid kun én record både start og slut skal udfyldes XXXXDH6200108121015231210320899115066800000*200108112001081220010811OS00000000 100*****0000000019970226000000000000+00000000+*** Seniordage (SO) Altid kun én record med hel eller halv dag XXXXDH6200108121015231210320899115066800000*200108112001081220010811SO00000000 100*****0000000000000000000000000000+00000000+*** XXXXDH6200108121015231210320899115066800000*200108112001081220010811SO00000000 050*****0000000000000000000000000000+00000000+*** 23
Fritvalgsordning (FV) Altid kun én record med hel eller halv dag XXXXDH6200108121015231210320899115066800000*200108112001081220010811FV00000000 100*****0000000000000000000000000000+00000000+*** XXXXDH6200108121015231210320899115066800000*200108112001081220010811FV00000000 050*****0000000000000000000000000000+00000000+*** Fravær paragraf 28 (P2) Start record XXXXDH6200107121015231210320899115066800000*200107112001071200000000P200000000 Slut record XXXXDH6200108201015231210320899115066800000R000000002001082020010816**00000000 Sygdom (SY) Start record XXXXDH6200107121015231210320899115066800000*200107112001071200000000SY00000000 Slut record XXXXDH6200108201015231210320899115066800000R000000002001082020010816**00000000 Record med afsluttet periode XXXXDH6200108201015231210320899115066800000*200108192001082020010820SY00000000 Tjenestefri (TJ) Altid record med afsluttet periode XXXXDH6200108181015231210320899115066800000*200108142001081820010816TJ00000000 Tjenestefri (TJ) med tjenestefrikode. Altid record med afsluttet periode XXXXDH6200108181015231210320899115066800000*200108142001081820010816TJ00000000 000TJM**0000000000000000000000000000+00000000+*** Tilskadekomst i tjenesten (TT) Start record XXXXDH6200103281015231210320899115066800000*200103052001032800000000TT00000000 Slut record XXXXDH6200104201015231210320899115066800000R000000002001042020010328**00000000 Opret fraværsoplysninger som historik Record XXXXDH6200103281015231210320899115066800000*200103052001032820010305OS00000000 100*****0000000019980501000000000000+00000000+X** 24
Slet en enkelt fraværsperiode Record XXXXDH6200103281015231210320899115066800000*200103052001032800000000**00000000 000*****0000000000000000000000000000+00000000+*S* Slet en lønmodtagers fraværsoplysninger Record XXXXDH6200103281015231210320899115066800000*000000002001032800000000**00000000 000*****0000000000000000000000000000+00000000+**S Timer og beløb til løntransaktion XXXXDH6200103281231206722280899117067500000*200103262001032820010326HJ00000000 000*****00000000000000000932000000700-00010000-*** 25