Snitfladebeskrivelse til Ferie Ind Version 1.1. 06-10-2007 KMD A/S 2003. 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 3. Teknisk implementering... 5 4. Ændringsvarsler... 5 5. Beskrivelse af snitfladen... 6 5.1 Sådan virker snitfladen:... 6 6. Beskrivelse af inddata til feriesnitfladen... 9 6.1 Input til KMD Opus Fravær/KMD Ferieadministration... 9 6.2 Validering og behandling af inputdata:... 10 Side 2
1. Brug af snitfladebeskrivelsen Denne snitfladebeskrivelse Ferie Ind, udgør grundlaget for at kunne danne filer, der kan benyttes af KMD Opus Fravær og KMD Ferieadminstration. De i snitfladen beskrevne felter og indholdet af disse er det, der er nødvendigt, for at KMD Opus Fravær og KMD Ferieadministration fungerer, når dataene kommer fra brugerne. Det er op til brugerne af snitfladen at udfylde felterne med de data, der er relevante i forhold til ferien. De steder, hvor der i snitfladen er beskrevet et fast værdisæt, og dette ikke passer med kundens eget værdisæt, må kunden selv konvertere disse, så de opfylder værdisættet, der er beskrevet her. Snitfladebeskrivelsen er desuden et praktisk arbejdsredskab til støtte for kommunikationen mellem kunderne og KMD om standardsnitfladens anvendelse. Beskrivelsen relaterer sig til KMD-programmellets opsætning i servicebureauløsning. 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, STL-Info-Udtræk : 2272@KMD.DK Ansvarlig enhed/gruppe i KMD er Produktudvikling Lønadministration. Side 3
2. Formål og målgrupper Hvad er formålet med standardsnitfladen? Formålet med standardsnitfladen er at give andre systemer mulighed for at kunne levere data til KMD Opus Fravær og KMD Ferieadministration. 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 kommuner og amter, der via "egne" systemer, altså ikke KMD standardsystemer, ønsker at kommunikere med KMD Opus Fravær eller KMD Ferieadministration. Det kan f.eks. være pc-systemer, som kommunen får udviklet hos andre softwareleverandører. I sådanne tilfælde er det kommunen og ikke softwareleverandøren, der kan blive abonnent på snitfladebeskrivelsen. Side 4
3. Teknisk implementering Der benyttes et sekventielle datasæt. Første record i datasættet skal være udfyldt efter strukturen DI74501N, og der må kun være en af disse records pr. datasæt. Derefter følger et variabelt antal records udfyldt efter strukturen DI74510N. Til sidst skal der komme en slutrecord udfyldt efter strukturen DI74599N. 4. Ændringsvarsler Ændringer i snitfladen vil normalt blive varslet mindst tre måneder i forvejen. Side 5
5. Beskrivelse af snitfladen KMD Opus Fravær og KMD Ferieadministration sikrer via snitfladen, at vedligeholdelse og ændringer i ferieloven kun foregår et sted. Samtidig sikrer snitfladen, at de forskellige saldi: ferie med løn, ferie uden løn og overført ferie bliver reduceret korrekt, samt at data bliver lagt rigtigt i tabellerne. 5.1 Sådan virker snitfladen: Det gælder generelt for nedenstående beskrivelser, at der er tale om lønmodtagere med ferieordning i timer. Er der tale om lønmodtagere med ferieordning i dage skal feltet FERIEDAGE_AFHOLDT udfyldes med antal enheder i stedet for feltet FERIETIMER_AFHOLDT. Almindelig ferieafholdelse med eller uden løntræk. KMD Opus Fravær og KMD Ferieadministration sørger for korrekt træk fra de forskellige saldi (ferie med og uden løn samt overført ferie) ud fra afholdelsesrækkefølgen, som er defineret i KLPs brugermodul. Der kan laves ferieafholdelser med løntræk. Der kan laves løntræk for hele ferieafholdelsen eller for dele af den. Der skal dog altid være en ferieafholdelse i forbindelse med løntrækket. Hvis der er løntræk, vil de indberettede enheder overstyre det automatiske udregnede løntræk. Hvis saldoen med løn efter en ferieafholdelse bliver mindre end nul, laves et automatisk løntræk. Der er ikke mulighed for at undgå dette løntræk, som vil blive lavet på alle ferieafholdelser, der resulterer i en saldo mindre end nul. Slet en indberettet ferie Hvis en ferieafholdelse ønskes slettes, sendes en record med samme lønnøgle (brugernummer, personnummer, ekstraciffer og aflønningsform) og samme FØRSTE_FERIEDAG som den ferieafholdelse, der skal slettes. Feltet FERIETIMER_AFHOLDT skal ikke udfyldes, da dette indikerer at ferien ønskes slettes. Ret en indberettet ferie Hvis en afholdt ferie skal rettes, sendes en record med samme lønnøgle (brugernummer, personnummer, ekstraciffer og aflønningsform) og samme FØRSTE_FERIEDAG som den ferieafholdelse der skal ændres. Feltet FERIETIMER_AFHOLDT udfyldes med de antal timer, ferieafholdelsen skal erstattes med. KMD Opus Fravær/KMD Ferieadministration sletter først den eksisterende ferieafholdelse og opretter derefter en ny ferieafholdelse med de nye data. Side 6
OBS! Denne måde at slette og rette på gør, at saldi med og uden løn samt overført ferie, altid vil blive håndteret korrekt og derfor kan tilbageskrives. For ovenstående funktioner gælder at FERIE_ART er udfyldt med FE for almindelig ferie. For ferieafholdelser for 6. ferieuge kan de samme funktioner som ved ferieafholdelser benyttes. Her skal FERIE_ART udfyldes med FF. Eks. på indberetninger af en almindelig ferieafholdelse: Felt navn Indtastning Kommentar INDIVIDTYPE 10 Skal altid udfyldes. NØGLE 102 Skal altid udfyldes. BRUGERNUMMER 0101 Skal altid udfyldes. PERSONNUMMER 0101010000 Skal altid udfyldes. ANS_FORHOLDS_NR 0 Skal altid udfyldes. AFLØNNINGSFORM 1 Skal altid udfyldes. FERIEOPTJENINGSÅR 2001 Kan være tomt. Udregnes automatisk af KMD Opus Fravær/KMD Ferieadministration ud fra FØRSTE_FERIEDAG FØRSTE_FERIEDAG 2002-06-15 Skal altid udfyldes. SIDSTE_FERIEDAG Ved slet og ret skal datoen være lig med den ferieafholdelse, der ønskes slettet eller rettet. Kan være tom. FERIETIMER_AFHOLDT 000500 Ved slet skal feltet være tomt, elles altid udfyldt hvis ferieordning i timer. Ved ret udfyldes med de timer, som ferieafholdelsen skal ændres til. FERIEDAGE_AFHOLDT FERIEARBEJDSDAGE STATUSKODE FERIETIMER_LØNTRÆK FFERIEDAGE_LØNTRÆK TF_KODE Ved ferieordning i dage skal feltet være tomt. Ved ferieordning i dage skal feltet være udfyldt efter samme regler som for feltet FERIETIMER_AFHOLDT. Ved ferieordning i timer kan feltet være 000000 (må aldrig være ). Hvis feltet udfyldes med 000000, udregnes antal dage automatisk af KMD Opus Fravær/KMD Ferieadministration. Hvis ferieordning er i timer og feltet er udfyldt, overstyrer de indberettede enheder den automatiske udregning af dagene. Kan være tomt. Udregnes automatisk af KMD Opus Fravær/KMD Ferieadministration. Kan være tomt. Sættes automatisk af KMD Opus Fravær/KMD Ferieadministration. Kan være tomt. Udregnes evt. automatisk af KMD Opus Fravær/ KMD Ferieadministration. Kan være tomt. Udregnes evt. automatisk af KMD Opus Fravær/KMD Ferieadministration. Kan være tomt. Hvis TF-koden er udfyldt bruges denne TF-kode, elles udfyldes feltet automatisk af KMD Opus Fravær/KMD Ferieadministration. 4. ciffer findes altid af KMD Opus Fravær/KMD Ferieadministration. Side 7
FERIE_ART FE Skal altid udfyldes. Side 8
6. Beskrivelse af inddata til feriesnitfladen INDDATA (indeholder oplysninger om ferieafholdelsen). Ud fra disse data udfyldes felter i KMD Opus Fravær/KMD Ferieadministration. 6.1 Input til KMD Opus Fravær/KMD Ferieadministration Der afleveres et datasæt med oplysninger om ferieafholdelser. Datasættet skal indeholde følgende oplysninger i char-format: 1. Header-record indeholdende dato og en beskrivelse af, hvorfra data kommer (DI74501N) INDIVIDTYPE CHAR (2) indhold: 01 NØGLE CHAR (3) Indhold: xxx (nummer udleveres af KMD) DATO CHAR (10) format: åååå-mm-dd BESKRIVELSE CHAR (30) indhold: Ferieafholdelser til KMD fra xxxxxxxxxx 2. Derefter datarecords med følgende indhold: (DI74510N) INDIVIDTYPE CHAR (2) indhold: 10 NØGLE CHAR (3) format: 999 BRUGERNUMMER CHAR (4) format: foranstillet 0 PERSONNUMMER CHAR (10) ANS_FORHOLD_NR CHAR (1) AFLØNNINGSFORM CHAR (1) FERIEOPTJENINGSÅR CHAR (4) FØRSTE_FERIEDAG CHAR (10) format: åååå-mm-dd SIDSTE_FERIEDAG CHAR (10) format: åååå-mm-dd FERIETIMER_AFHOLDT CHAR (6) format: 999999 (hundrede-dele timer uden komma) FERIEDAGE_AFHOLDT CHAR (6) format: 999999 (hundrede-dele dage uden komma) FERIEARBEJDSDAGE CHAR (6) format: 999999 (hundrede-dele dage uden komma) STATUSKODE CHAR (2) indhold: VE, AH, VA, VU, OT FERIETIMER_LØNTRÆK CHAR (6) format: 999999 (hundrede-dele timer uden komma) FERIEDAGE_LØNTRÆK CHAR (6) format: 999999 (hundrede-dele dage uden komma) TF-KODE CHAR (3) (999) FERIE_ART CHAR (2) indhold FE (alm. ferie) eller FF (feriefridagstimer) 3. En slut-record: (DI74599) INDIVIDTYPE CHAR (2) indhold: 99 NØGLE CHAR (3) Indhold: xxx (nummer udleveres af KMD) Side 9
6.2 Validering og behandling af inputdata: KMD Opus Fravær/KMD Ferieadministration validerer modtagne data. Behandling af data: Hvis data ikke afvises opdateres ferieafholdelser i KMD Opus Fravær eller KMD Ferieadministration. KMD Opus Fravær/KMD Ferieadministration foretager ingen sortering. Transaktionerne bliver behandlet i den orden, de bliver afleveret. Der er ingen afhængighed til lønkørslen. Dvs. at lønkørslen køres uafhængigt af, om transaktioner til KMD Opus Fravær og KMD Ferieadministration via ovenstående snitflade er kommet på plads. Side 10