Wissenswertes zur Classic Line Version 2012 WDB Artikel: 18845 Formatbeschreibungen Importschnittstelle (XML-Format) Lohndaten / Gegenerfassung / Fehlzeiten © Copyright 2012 Sage Software Die Inhalte und Themen in dieser Unterlage wurden mit sehr großer Sorgfalt ausgewählt, erstellt und getestet. Fehlerfreiheit können wir jedoch nicht garantieren. Sage haftet nicht für Fehler in dieser Dokumentation. Die Beschreibungen stellen ausdrücklich keine zugesicherten Eigenschaften im Rechtssinne dar. Inhaltsverzeichnis Inhaltsverzeichnis......................................................................................................................... 2 1. Einführung............................................................................................................................. 3 1.1 Was ist zu beachten................................................................................................................. 3 1.1.1 Lohnarten ............................................................................................................................ 3 1.1.2 Gegenerfassung ................................................................................................................... 3 1.1.3 Fehlzeiten, AU-Zeiten und Vorerkrankungen ...................................................................... 3 1.2 Formatbeschreibung ............................................................................................................... 4 1.2.1 Personal und Periode .......................................................................................................... 4 1.2.2 Lohndatenerfassung, Tarifzeiten, Arbeitszeit Gegenerfassung .......................................... 4 1.2.3 Fehlzeiten, AU-Zeiten und Vorerkrankungen, Mutterschutz .............................................. 5 1.2.4 Beispiel gesamt .................................................................................................................... 8 1.3 Import und Protokollierung..................................................................................................... 9 1.3.1 Import aktuelle Periode....................................................................................................... 9 1.3.2 Rückrechnung .................................................................................................................... 11 © Copyright 2012 Sage Software Die Inhalte und Themen in dieser Unterlage wurden mit sehr großer Sorgfalt ausgewählt, erstellt und getestet. Fehlerfreiheit können wir jedoch nicht garantieren. Sage haftet nicht für Fehler in dieser Dokumentation. Die Beschreibungen stellen ausdrücklich keine zugesicherten Eigenschaften im Rechtssinne dar. 1. Einführung Mithilfe des Importprogramms können gleichzeitig folgende Daten eingelesen werden: • Lohndatenerfassung inkl. Tarifzeiten • Arbeitszeit Gegenerfassung • Fehlzeiten • Vorerkrankungen • AU-Zeiten • Mutterschutzzeiten mit Mutterschaftswerten Änderungen an den nachfolgenden „Formatbeschreibungen Importschnittstelle (XMLFormat)“ behalten wir uns ausdrücklich vor. Sollten Probleme beim Datenimport mit älteren Formatbeschreibungen, die nicht in diesem Dokument beschrieben sind, auftreten, so besteht kein Anspruch auf eine Änderung der Schnittstelle durch Sage Software. 1.1 Was ist zu beachten Bitte beachten Sie folgende Besonderheiten der Import-Logik in den einzelnen Bereichen: Pro Periode wird geprüft, ob die Periode bereits abgeschlossen ist. Wenn ja, wird der Mitarbeiter für die Rückrechnung markiert (ab dieser Periode, falls er nicht schon ab einer früheren Periode markiert ist). 1.1.1 Lohnarten Übergebene Lohnarten werden (wie beim herkömmlichen „Import Zeiterfassung“) zu bereits früher übergebenen Lohnarten hinzuaddiert, d.h., bei erneuter Übergabe sind nur Differenzen zu übergeben. 1.1.2 Gegenerfassung Gegenerfassungszeiten sind immer für einen Monat komplett oder gar nicht anzugeben d.h., wenn ein Gegenerfassungs-Datensatz übergeben wird, werden alle bisher für diese Periode erfassten Gegenerfassungszeiten gelöscht und durch die übergebenen Zeiten ersetzt. 1.1.3 Fehlzeiten, AU-Zeiten und Vorerkrankungen Fehlzeiten (inkl. AU-Zeiten und Vorerkrankungen) sind für eine Beschäftigung entweder komplett oder gar nicht anzugeben, d.h., wenn ein Fehlzeiten-, ein AU- oder ein Vorerkrankungs-Datensatz übergeben wird, werden alle bisher erfassten Fehlzeiten, AU-Zeiten und Vorerkrankungen gelöscht und durch die übergebenen Daten ersetzt. Pro Fehlzeit, pro AU-Zeiten und pro Vorerkrankung wird geprüft, ob sich gegenüber bestehender Zeiten Änderungen ergeben haben. Wenn ja, wird der Mitarbeiter ggf. für die Rückrechnung markiert (ab der Periode in die die erste Änderung fällt, falls er nicht schon ab einer früheren Periode markiert ist). Es ist keine rückrechnungsrelevante Änderung erfolgt, wenn alle importierten Zeiten identisch sind mit den bestehenden und (um gelöschte Zeiten zu erkennen) alle bereits bestehenden Zeiten identisch sind mit den importierten. © Copyright 2012 Sage Software Die Inhalte und Themen in dieser Unterlage wurden mit sehr großer Sorgfalt ausgewählt, erstellt und getestet. Fehlerfreiheit können wir jedoch nicht garantieren. Sage haftet nicht für Fehler in dieser Dokumentation. Die Beschreibungen stellen ausdrücklich keine zugesicherten Eigenschaften im Rechtssinne dar. 1.2 Formatbeschreibung 1.2.1 Personal und Periode In Ebene 1 werden die Mitarbeiter definiert, deren Daten importiert werden sollen. Unter der Ebene <Personal ..> befindet sich die Ebene mit den (optionalen) Elementen <Perioden> und <Fehlzeiten>. <Personal Nummer="000000" Eintrittsdatum="jjjjmmtt"> </Personal> A1 Ebene: Personal Werte: Nummer, Eintrittsdatum A2 Ebene: Perioden Wert: Unter: Personal A3 Ebene: Periode Wert: Jahr, Monat =JJJJMM Unter: - 1.2.2 Lohndatenerfassung, Tarifzeiten, Arbeitszeit Gegenerfassung Pro Periode sind in Ebene 4 mehrere Lohnarten, Tarifzeiten und ein Gegenerfassungs-Element möglich. A3a Ebene: Lohnart, Kostenträger, Kostenstelle, Gegenerfassung, Tarifzeit Werte: Nummer, Zeit, Betrag, Kostentraeger_Nr, Kostenstelle_Nr, Bei Splitting: Kst1_Nr, Kst2_Nr, Kst3_Nr, Kst1_Satz, Kst2_Satz, Kst3_Satz Unter: Periode A3b Ebene: Tarifzeit Werte: Zeiteinheit["STUNDEN"/"TAGE"], Modus["ERSETZEN"/"ADDIEREN"/"SUBTRAHIEREN"], Zeit Unter: Periode A3c Ebene: Gegenerfassung Werte: Tag01, ... , Tag31 Unter: Periode © Copyright 2012 Sage Software Die Inhalte und Themen in dieser Unterlage wurden mit sehr großer Sorgfalt ausgewählt, erstellt und getestet. Fehlerfreiheit können wir jedoch nicht garantieren. Sage haftet nicht für Fehler in dieser Dokumentation. Die Beschreibungen stellen ausdrücklich keine zugesicherten Eigenschaften im Rechtssinne dar. 1.2.2.1 Beispiel Lohndatenerfassung <Personal Nummer="000000" Eintrittsdatum="jjjjmmtt"> <Perioden> <Periode Wert="jjjjmm"> <Lohnart Nummer="000" Zeit="000000.00" Betrag="00000000.00" Kostentraeger="0000000000" <!-- Angabe nur wenn abweichend vom Stammkst./-ktr. --> Kostenstelle="0000000000" Kostentraeger="0000000000" <!-- Angabe nur bei Kst.-Splitting --> Kst1_Nr="0000000000" Kst1_Satz="000.00" Kst2_Nr="0000000000" Kst2_Satz="000.00" Kst3_Nr="0000000000" Kst3_Satz="000.00" /> <Lohnart ... /> <Gegenerfassung Tag01="00.00" Tag02="00.00" ... Tag31="00.00" /> <Tarifzeit Zeiteinheit=" " Modus=" " Zeit="000000.00"/> </Periode> </Perioden> </Personal> 1.2.3 Fehlzeiten, AU-Zeiten und Vorerkrankungen, Mutterschutz Pro Mitarbeiter können in Ebene 2 mehrere Fehlzeiten (und mehrere Perioden) angegeben werden. Pro Fehlzeit sind in Ebene 3 mehrere Vorerkrankungen und AU Zeiten möglich. Bitte beachten Sie, wenn: <Fehlzeiten> fehlt, erfolgt keine Übergabe von Fehlzeiten, Fehlzeiten der Classic Line bleiben unverändert Innerhalb der einzelnen Fehlzeit müssen mind. Nummer, DatumVon, DatumBis, LeistungGrund, TraegerArt angegeben werden. Zusätzlich müssen immer die Elemente <Vorerkrankungen> und <AuZeiten> vorhanden sein, ggf. ohne hinterlegte Werte (leer). B2 Ebene: Fehlzeiten Werte: Unter: Personal B3 Ebene: Fehlzeit Werte: Nummer, DatumVon, DatumBis, ArbStundenErsterKrankTag, KindVorname, LeistungGrund [0-3], LeistungDatum, TraegerArt [0-4], TraegerSchluessel [0-3] Unter: B4 Ebene: Vorerkrankungen Werte: Unter: Fehlzeit B4a Ebene: Vorerkrankung Werte: Nummer, DatumVon, DatumBis Unter: B5 Ebene: AuZeiten Werte: Unter: Fehlzeit © Copyright 2012 Sage Software Die Inhalte und Themen in dieser Unterlage wurden mit sehr großer Sorgfalt ausgewählt, erstellt und getestet. Fehlerfreiheit können wir jedoch nicht garantieren. Sage haftet nicht für Fehler in dieser Dokumentation. Die Beschreibungen stellen ausdrücklich keine zugesicherten Eigenschaften im Rechtssinne dar. B5a Ebene: AuZeit Werte: DatumVon, DatumBis, DatumFestgestellt, Erstbescheinigung[0-1], Anrechnung[1-4] Unter: AuZeiten B6 Ebene: Mutterschutzzeit Wert: Unter: Fehlzeit B6a Ebne: Wert: Mutterschaftswerte lfd. Nummer, voraussichtlicher Geburtstermin, Kz. für die Mehrlingsgeburt (0,1), Kz. für die Folgefehlzeit für Elternzeit (0,1), Nr. der Bruttolohnart, Nr. der Nettolohnart, Nr. der Lohnart bei Mehrfachbeschäftigung, Lohnart für den Zuschuss SV-Frei, Lohnart für den Zuschuss SV-Pflichtig, Brutto Monat1 autom. ermittelt, Brutto Monat2 autom. ermittelt, Brutto Monat 3 autom. ermittelt, Netto Monat 1 autom. ermittelt, Netto Monat2 autom. ermittelt, Netto Monat3 autom. ermittelt, Netto Fremd Monat1 manuell. Netto Fremd Monat2 manuell, Netto Fremd Monat3 manuell, Brutto Monat1 manuell, Brutto Monat2 manuell, Brutto Monat3 manuell, Netto Monat1 manuell, Netto Monat2 manuell, Netto Monat3 manuell, Brutto gesamt, weiter gezahltes Entgelt bis, Zeitstempel fiktive Abrechnung, Brutto Monat1 ZVK, Brutto Monat2 ZVK, Brutto Monat3 ZVK, Lohnart für ZVK Unter: Mutterschutz 1.2.3.1 Beispiel Fehlzeiten ohne Mutterschutz <Personal Nummer="000001" Eintrittsdatum="20070101"> <Fehlzeiten> <Fehlzeit Nummer="20" DatumVon="20100111" DatumBis="20100122" ArbStundenErsterKrankTag="2.75" KindVorname="Gundula" LeistungGrund="1" LeistungDatum="20100111" TraegerArt="1" TraegerSchluessel="0"> <Vorerkrankungen> <Vorerkrankung Nummer="20" DatumVon="20091115" DatumBis="20091111" KindVorname="Gundula"/> <Vorerkrankung Nummer="20" DatumVon="20091215" DatumBis="20061211" KindVorname="Gundula"/> </Vorerkrankungen> <AuZeiten> <AuZeit DatumVon="20100111" DatumBis="20100112" DatumFestgestellt="20100115" Erstbescheinigung="1" Anrechnung="1"/> <AuZeit DatumVon="20100113" DatumBis="20100122" DatumFestgestellt="20100113" Erstbescheinigung="0" Anrechnung="1"/> </AuZeiten> </Fehlzeit> </Fehlzeiten> </Personal> © Copyright 2012 Sage Software Die Inhalte und Themen in dieser Unterlage wurden mit sehr großer Sorgfalt ausgewählt, erstellt und getestet. Fehlerfreiheit können wir jedoch nicht garantieren. Sage haftet nicht für Fehler in dieser Dokumentation. Die Beschreibungen stellen ausdrücklich keine zugesicherten Eigenschaften im Rechtssinne dar. 1.2.3.2 Beispiel Fehlzeiten mit Mutterschutz <Personal Nummer="000001" Eintrittsdatum="20070101"> <Fehlzeiten> <Fehlzeit Nummer="01" DatumVon="20111201" DatumBis="20111210" LeistungGrund="0" TraegerArt="0"> <Vorerkrankungen> </Vorerkrankungen> <AuZeiten> </AuZeiten> </Fehlzeit> <Fehlzeit Nummer="06" DatumVon="20120128" DatumBis="20120505" LeistungsGrund="0" TraegerArt="0"> <Vorerkrankungen> </Vorerkrankungen> <AuZeiten> </AuZeiten> <Mutterschaftszeit> <Mutterschaftswerte Nummer="01" GeburtsterminVoraussichtlich="20120210" MehrlingsgeburtKz="0" FolgefehlzeitElternzeitKz="1" BruttoLohnartNr="492" NettoLohnartNr="493" MehrfachLohnartNr="494" ZuschussSvFreiLohnartNr="495" ZuschussSvPflichtigLohnartNr="000" BruttoMonat1Auto="2785.00" BruttoMonat2Auto="2790.00" BruttoMonat3Auto="2795.00" NettoMonat1Auto="1496.22" NettoMonat2Auto="1462.67" NettoMonat3Auto="1467.67" NettoFremdMonat1Manuell="0.00" NettoFremdMonat2Manuell="0.00" NettoFremdMonat3Manuell="0.00" BruttoMonat1Manuell="0.00" BruttoMonat2Manuell="0.00" BruttoMonat3Manuell="0.00" NettoMonat1Manuell="0.00" NettoMonat2Manuell="0.00" NettoMonat3Manuell="0.00" BruttoGesamt="2790.00" LaufendesEntgeltBisDatum="20120127" ZeitstempelFiktiveAbrechnung="" BruttoMonat1Zvk="0.00" BruttoMonat2Zvk="0.00" BruttoMonat3Zvk="0.00" ZvkLohnartNr="000"> </Mutterschaftswerte> </Mutterschaftszeit> </Fehlzeit> </Fehlzeiten> </Personal> © Copyright 2012 Sage Software Die Inhalte und Themen in dieser Unterlage wurden mit sehr großer Sorgfalt ausgewählt, erstellt und getestet. Fehlerfreiheit können wir jedoch nicht garantieren. Sage haftet nicht für Fehler in dieser Dokumentation. Die Beschreibungen stellen ausdrücklich keine zugesicherten Eigenschaften im Rechtssinne dar. 1.2.4 Beispiel gesamt <?xml version="1.0" encoding="windows-1252"?> <CL_LohndatenImport> <!-- Bsp. CL2010 - Demomandant 01/2010 --> <Personal Nummer="000001" Eintrittsdatum="20070101"> <Perioden> <Periode Wert="201001"> <Lohnart Nummer="124" Zeit="000010.00" Betrag="0.00" Kostentraeger="1000000000"/> <Lohnart Nummer="001" Zeit="000000.00" Betrag="1234.56" Kostentraeger="1000000000" Kostenstelle="2000000000" Kst1_Nr="1010000000" Kst1_Satz="020.00" Kst2_Nr="1020000000" Kst2_Satz="025.00" Kst3_Nr="1030000000" Kst3_Satz="015.00"/> <Gegenerfassung Tag01="07.50" Tag04="08.00" Tag05="07.25"/> <Gegenerfassung Tag06="08.50" Tag07="09.00" Tag08="07.25"/> <Gegenerfassung Tag09="03.50" Tag25="08.00" Tag26="07.25"/> <Gegenerfassung Tag27="07.50" Tag28="08.50" Tag29="07.00"/> <Gegenerfassung Tag30="03.00"/> </Periode> </Perioden> <Fehlzeiten> <Fehlzeit Nummer="01" DatumVon="20100201" DatumBis="20100205" LeistungGrund="0" TraegerArt="0"> <Vorerkrankungen> </Vorerkrankungen> <AuZeiten> </AuZeiten> </Fehlzeit> <Fehlzeit Nummer="20" DatumVon="20100111" DatumBis="20100122" ArbStundenErsterKrankTag="2.75" KindVorname="Gundula" LeistungGrund="1" LeistungDatum="20100111" TraegerArt="1" TraegerSchluessel="0"> <Vorerkrankungen> <Vorerkrankung Nummer="20" DatumVon="20091115" DatumBis="20091111" /> <Vorerkrankung Nummer="20" DatumVon="20091215" DatumBis="20061211" /> </Vorerkrankungen> <AuZeiten> <AuZeit DatumVon="20100111" DatumBis="20100112" DatumFestgestellt="20100115" Erstbescheinigung="1" Anrechnung="1"/> <AuZeit DatumVon="20100113" DatumBis="20100122" DatumFestgestellt="20100113" Erstbescheinigung="0" Anrechnung="1"/> </AuZeiten> </Fehlzeit> <Fehlzeit Nummer="01" DatumVon="20100104" DatumBis="20100104" LeistungGrund="0" TraegerArt="0"> <Vorerkrankungen> </Vorerkrankungen> <AuZeiten> </AuZeiten> </Fehlzeit> </Fehlzeiten> </Personal> <Personal Nummer="000023" Eintrittsdatum="19830101"> <Perioden> <Periode Wert="201001"> <Tarifzeit Zeiteinheit="Stunden" Modus="Ersetzen" Zeit="000161.25"/> <Tarifzeit Zeiteinheit="Tage" Modus="Subtrahieren" Zeit="00.75"/> <Tarifzeit Zeiteinheit="Tage" Modus="Addieren" Zeit="000021.50"/> </Periode> </Perioden> </Personal> </CL_LohndatenImport> © Copyright 2012 Sage Software Die Inhalte und Themen in dieser Unterlage wurden mit sehr großer Sorgfalt ausgewählt, erstellt und getestet. Fehlerfreiheit können wir jedoch nicht garantieren. Sage haftet nicht für Fehler in dieser Dokumentation. Die Beschreibungen stellen ausdrücklich keine zugesicherten Eigenschaften im Rechtssinne dar. 1.3 Import und Protokollierung 1.3.1 Import aktuelle Periode Über < Abrechnung und Erfassung / Lohndatenerfassung / Import Lohndaten (XML) > oder über den Direktaufruf "PW8495/02“ in der Symbolleiste "Ausführen" können sie den Import starten. Nach dem Aufruf des Programms erscheint eine Selektionsmaske, in der der Pfadname zur Importdatei hinterlegt bzw. ausgewählt werden kann. © Copyright 2012 Sage Software Die Inhalte und Themen in dieser Unterlage wurden mit sehr großer Sorgfalt ausgewählt, erstellt und getestet. Fehlerfreiheit können wir jedoch nicht garantieren. Sage haftet nicht für Fehler in dieser Dokumentation. Die Beschreibungen stellen ausdrücklich keine zugesicherten Eigenschaften im Rechtssinne dar. Nach dem Start des Imports wird immer ein Protokoll erstellt, indem alle Importdaten aufgeführt werden. Befinden sich keine fehlerhaften Daten in der Importdatei, erfolgt nach dem Import-Protokoll eine Abfrage, ob der Import abgeschlossen werden soll. © Copyright 2012 Sage Software Die Inhalte und Themen in dieser Unterlage wurden mit sehr großer Sorgfalt ausgewählt, erstellt und getestet. Fehlerfreiheit können wir jedoch nicht garantieren. Sage haftet nicht für Fehler in dieser Dokumentation. Die Beschreibungen stellen ausdrücklich keine zugesicherten Eigenschaften im Rechtssinne dar. Innerhalb des Import-Protokolls werden auch fehlerhafte Daten dargestellt. Sie haben die Möglichkeit anschl. den Import vollständig abzubrechen oder nur die fehlerfreien Daten zu importieren. 1.3.2 Rückrechnung Befinden sich Datenänderungen für bereits abgeschlossene Perioden in der Importdatei, können Sie vor der Durchführung des Imports entscheiden, ob eine Rückrechnung gestartet werden soll. Falls Sie diese Abfrage mit „Nein“ beantworten, werden nur die Daten für nicht abgeschlossene Perioden importiert. © Copyright 2012 Sage Software Die Inhalte und Themen in dieser Unterlage wurden mit sehr großer Sorgfalt ausgewählt, erstellt und getestet. Fehlerfreiheit können wir jedoch nicht garantieren. Sage haftet nicht für Fehler in dieser Dokumentation. Die Beschreibungen stellen ausdrücklich keine zugesicherten Eigenschaften im Rechtssinne dar.
© Copyright 2024 ExpyDoc
