brynq-sdk-sage-germany 1.0.0__py3-none-any.whl

brynq_sdk_sage_germany/schemas/absences.py

@@ -0,0 +1,311 @@
+"""
+Schemas for Sage Germany absence payloads.
+"""
+
+from typing import Optional, Any, List
+
+import pandas as pd
+import pandera as pa
+from pandera.typing import Series
+from pydantic import BaseModel, Field, ConfigDict
+
+from brynq_sdk_functions import BrynQPanderaDataFrameModel
+
+__all__ = ["AbsencesGet", "AbsenceTypesGet", "AbsenceCreate", "AbsenceDelete"]
+
+
+class AbsencesGet(BrynQPanderaDataFrameModel):
+    """
+    Pandera schema for flattened absence records.
+    """
+
+    # Base identifiers
+    absence_id: Series[pd.Int64Dtype] = pa.Field(alias="Id", coerce=True, nullable=False, description="Unique absence identifier.")
+    tenant_number: Series[pd.Int64Dtype] = pa.Field(alias="MdNr", coerce=True, nullable=False, description="Tenant (Mandant) number.")
+    employee_number: Series[pd.Int64Dtype] = pa.Field(alias="AnNr", coerce=True, nullable=False, description="Employee number.")
+
+    #Absence details
+    date_from: Optional[Series[pd.StringDtype]] = pa.Field(alias="From", coerce=True, nullable=True, description="Absence start timestamp.")
+    from_day_type: Optional[Series[pd.StringDtype]] = pa.Field(alias="FromDayType", coerce=True, nullable=True, description="Start day granularity.")
+    date_to: Optional[Series[pd.StringDtype]] = pa.Field(alias="To", coerce=True, nullable=True, description="Absence end timestamp.")
+    to_day_type: Optional[Series[pd.StringDtype]] = pa.Field(alias="ToDayType", coerce=True, nullable=True, description="End day granularity.")
+    last_working_day: Optional[Series[pd.StringDtype]] = pa.Field(alias="LastWorkingDay", coerce=True, nullable=True, description="Last working day before absence.")
+    absence_category: Optional[Series[pd.StringDtype]] = pa.Field(alias="AbsenceType", coerce=True, nullable=True, description="Absence category.")
+    absence_category_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="AbsenceTypeText", coerce=True, nullable=True, description="Absence category description.")
+    open_end: Optional[Series[bool]] = pa.Field(alias="OpenEnd", coerce=True, nullable=True, description="Indicates an open-ended absence.")
+    state: Optional[Series[pd.StringDtype]] = pa.Field(alias="State", coerce=True, nullable=True, description="Absence state.")
+    accepted_in_payroll: Optional[Series[bool]] = pa.Field(alias="AcceptedPayroll", coerce=True, nullable=True, description="Indicates acceptance in payroll.")
+
+
+    # Absence type metadata
+    absence_type_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Type__Id", coerce=True, nullable=True, description="Absence type identifier.")
+    absence_type_tenant_number: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Type__MdNr", coerce=True, nullable=True, description="Absence type tenant number.")
+    absence_type_number: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Type__Number", coerce=True, nullable=True, description="Absence type number.")
+    absence_type_name: Optional[Series[pd.StringDtype]] = pa.Field(alias="Type__Name", coerce=True, nullable=True, description="Absence type name.")
+    absence_type_status_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Type__Status__Id", coerce=True, nullable=True, description="Absence type status identifier.")
+    absence_type_status: Optional[Series[pd.StringDtype]] = pa.Field(alias="Type__Status__Status", coerce=True, nullable=True, description="Absence type status.")
+    absence_type_status_short: Optional[Series[pd.StringDtype]] = pa.Field(alias="Type__Status__StatusShort", coerce=True, nullable=True, description="Absence type status short label.")
+    absence_day_type: Optional[Series[pd.StringDtype]] = pa.Field(alias="Type__DayType", coerce=True, nullable=True, description="Absence day type.")
+    absence_color: Optional[Series[pd.StringDtype]] = pa.Field(alias="Type__Color", coerce=True, nullable=True, description="Primary calendar color.")
+    absence_is_historic: Optional[Series[bool]] = pa.Field(alias="Type__IsHistoric", coerce=True, nullable=True, description="Indicates historic absence type.")
+    absence_is_holiday: Optional[Series[bool]] = pa.Field(alias="Type__IsHoliday", coerce=True, nullable=True, description="Indicates holiday type.")
+    absence_is_sick: Optional[Series[bool]] = pa.Field(alias="Type__IsSick", coerce=True, nullable=True, description="Indicates sickness type.")
+    absence_color_previous_year: Optional[Series[pd.StringDtype]] = pa.Field(alias="Type__ColorPreviousYear", coerce=True, nullable=True, description="Previous year color code.")
+    absence_priority: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Type__Priority", coerce=True, nullable=True, description="Absence priority.")
+    absence_has_last_working_day: Optional[Series[bool]] = pa.Field(alias="Type__HasLastWorkingDay", coerce=True, nullable=True, description="Indicates requirement for last working day.")
+    absence_acquisition_unit: Optional[Series[pd.StringDtype]] = pa.Field(alias="Type__AcquisitionUnit", coerce=True, nullable=True, description="Absence acquisition unit.")
+    absence_valid_from: Optional[Series[pd.StringDtype]] = pa.Field(alias="Type__ValidFrom", coerce=True, nullable=True, description="Type valid-from date.")
+    absence_valid_to: Optional[Series[pd.StringDtype]] = pa.Field(alias="Type__ValidTo", coerce=True, nullable=True, description="Type valid-to date.")
+    holiday_calculation_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Type__HolidayCalculation__Id", coerce=True, nullable=True, description="Holiday calculation identifier.")
+    holiday_calculation_description: Optional[Series[pd.StringDtype]] = pa.Field(alias="Type__HolidayCalculation__Description", coerce=True, nullable=True, description="Holiday calculation description.")
+    holiday_calculation_code: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Type__HolidayCalculation__Calculation", coerce=True, nullable=True, description="Holiday calculation code.")
+
+    # Replacement and deputy metadata
+    replacement_employee_number: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="AbsencePlaning__Replacement__AnNr", coerce=True, nullable=True, description="Replacement employee number.")
+    replacement_first_name: Optional[Series[pd.StringDtype]] = pa.Field(alias="AbsencePlaning__Replacement__Name__Firstname", coerce=True, nullable=True, description="Replacement first name.")
+    replacement_last_name: Optional[Series[pd.StringDtype]] = pa.Field(alias="AbsencePlaning__Replacement__Name__Lastname", coerce=True, nullable=True, description="Replacement last name.")
+    replacement_full_name: Optional[Series[pd.StringDtype]] = pa.Field(alias="AbsencePlaning__Replacement__Name__Fullname", coerce=True, nullable=True, description="Replacement full name.")
+    deputy_tenant_number: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Deputy__MdNr", coerce=True, nullable=True, description="Deputy tenant number.")
+    deputy_employee_number: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Deputy__AnNr", coerce=True, nullable=True, description="Deputy employee number.")
+    deputy_combined_key: Optional[Series[pd.StringDtype]] = pa.Field(alias="Deputy__CombinedKey", coerce=True, nullable=True, description="Deputy combined key.")
+    deputy_is_empty: Optional[Series[bool]] = pa.Field(alias="Deputy__IsEmpty", coerce=True, nullable=True, description="Indicates whether deputy payload is empty.")
+
+
+    # Duration and accident statistics
+    days_count: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="DaysCount", coerce=True, nullable=True, description="Total number of days.")
+    days_count_own: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="DaysCountOwn", coerce=True, nullable=True, description="Own quota days.")
+    days_count_previous_year: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="DaysCountPrevYear", coerce=True, nullable=True, description="Days counted from previous year.")
+    days_divergent: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="DaysDivergent", coerce=True, nullable=True, description="Divergent day count.")
+    accident_at_work: Optional[Series[bool]] = pa.Field(alias="AccidentAtWork", coerce=True, nullable=True, description="Work accident flag.")
+    day_of_accident: Optional[Series[pd.StringDtype]] = pa.Field(alias="DayOfAccident", coerce=True, nullable=True, description="Accident day timestamp.")
+    accident_insurance_number: Optional[Series[pd.StringDtype]] = pa.Field(alias="AccidentInsuranceNumber", coerce=True, nullable=True, description="Accident insurance number.")
+    accident_insurance_reference_number: Optional[Series[pd.StringDtype]] = pa.Field(alias="AccidentInsuranceReferenceNumber", coerce=True, nullable=True, description="Accident insurance reference number.")
+    third_party_harm: Optional[Series[bool]] = pa.Field(alias="ThirdPartyHarm", coerce=True, nullable=True, description="Third-party harm flag.")
+    worked_on_first_absence_day: Optional[Series[bool]] = pa.Field(alias="WorkedOnFirstAbsenceday", coerce=True, nullable=True, description="Indicates if employee worked on first absence day.")
+
+    # Audit trail
+    created_at: Optional[Series[pd.StringDtype]] = pa.Field(alias="CreatedAt", coerce=True, nullable=True, description="Creation timestamp.")
+    created_by: Optional[Series[pd.StringDtype]] = pa.Field(alias="CreatedBy", coerce=True, nullable=True, description="Creator identifier.")
+    changed_at: Optional[Series[pd.StringDtype]] = pa.Field(alias="ChangedAt", coerce=True, nullable=True, description="Last modification timestamp.")
+    changed_by: Optional[Series[pd.StringDtype]] = pa.Field(alias="ChangedBy", coerce=True, nullable=True, description="Modifier identifier.")
+    comment: Optional[Series[pd.StringDtype]] = pa.Field(alias="Comment", coerce=True, nullable=True, description="Absence comment.")
+
+    # Workflow and validation payloads
+    follow_absence_time_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="FollowAbsenceTimeId", coerce=True, nullable=True, description="Follow-up absence identifier.")
+    absence_planing_payload: Optional[Series[pd.StringDtype]] = pa.Field(alias="AbsencePlaning", coerce=True, nullable=True, description="Absence planning payload.")
+    is_task: Optional[Series[bool]] = pa.Field(alias="IsTask", coerce=True, nullable=True, description="Absence is linked to a task.")
+    task_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="TaskId", coerce=True, nullable=True, description="Task identifier.")
+    workflow_plan_value_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="WorkflowPlanValID", coerce=True, nullable=True, description="Workflow plan value identifier.")
+    additional_input_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="AdditionalInputId", coerce=True, nullable=True, description="Additional input identifier.")
+    deputy_payload: Optional[Series[pd.StringDtype]] = pa.Field(alias="Deputy", coerce=True, nullable=True, description="Deputy payload.")
+    deputy_name: Optional[Series[pd.StringDtype]] = pa.Field(alias="DeputyName", coerce=True, nullable=True, description="Deputy name.")
+    previous_sickness: Optional[Series[bool]] = pa.Field(alias="PreviousSickness", coerce=True, nullable=True, description="Previous sickness flag.")
+    previous_sickness_request: Optional[Series[pd.StringDtype]] = pa.Field(alias="PreviousSicknessRequest", coerce=True, nullable=True, description="Previous sickness request state.")
+    previous_sickness_absence_time_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="PreviousSicknessAbsenceTimeId", coerce=True, nullable=True, description="Previous sickness absence time identifier.")
+    previous_sickness_absence_time_task_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="PreviousSicknessAbsenceTimeTaskId", coerce=True, nullable=True, description="Previous sickness task identifier.")
+    previous_sickness_absence_time_ids: Optional[Series[pd.StringDtype]] = pa.Field(alias="PreviousSicknessAbsenceTimeIds", coerce=True, nullable=True, description="Previous sickness related ids.")
+    end_of_payment_for_longtime_sickness: Optional[Series[pd.StringDtype]] = pa.Field(alias="EndOfPaymentForLongtimeSickness", coerce=True, nullable=True, description="End of payment date for long-time sickness.")
+    errors_payload: Optional[Series[pd.StringDtype]] = pa.Field(alias="Errors", coerce=True, nullable=True, description="Errors payload.")
+    deputies_payload: Optional[Series[pd.StringDtype]] = pa.Field(alias="Deputies", coerce=True, nullable=True, description="Deputies payload.")
+    approver_payload: Optional[Series[pd.StringDtype]] = pa.Field(alias="Approver", coerce=True, nullable=True, description="Approver payload.")
+    status_eau_anfrage_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="StatusEauAnfrage__Id", coerce=True, nullable=True, description="Electronic AU status identifier.")
+    status_eau_anfrage_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="StatusEauAnfrage__Text", coerce=True, nullable=True, description="Electronic AU status text.")
+    status_eau_anfrage_id_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="StatusEauAnfrage__IdMitText", coerce=True, nullable=True, description="Electronic AU status id-text.")
+    absence_time_eau_anfrage: Optional[Series[pd.StringDtype]] = pa.Field(alias="AbsenceTimeEauAnfrage", coerce=True, nullable=True, description="Absence time electronic AU payload.")
+    hours_payload: Optional[Series[pd.StringDtype]] = pa.Field(alias="Hours", coerce=True, nullable=True, description="Hours payload.")
+    manual_different_days: Optional[Series[bool]] = pa.Field(alias="ManualDifferentDays", coerce=True, nullable=True, description="Manual different days flag.")
+
+    class _Annotation:
+        primary_key = "absence_id"
+
+    class Config:
+        coerce = True
+        strict = "filter"
+
+
+class AbsenceStatus(BaseModel):
+    id: Optional[int] = Field(default=None, alias="Id", description="Status identifier.", example=1)
+    status: Optional[str] = Field(default=None, alias="Status", description="Status text.", example="Approved")
+    status_short: Optional[str] = Field(default=None, alias="StatusShort", description="Short status text.", example="APP")
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class AbsenceHolidayCalculation(BaseModel):
+    id: Optional[int] = Field(default=None, alias="Id", description="Holiday calculation identifier.", example=1)
+    description: Optional[str] = Field(default=None, alias="Description", description="Description text.", example="Standard calculation")
+    calculation: Optional[int] = Field(default=None, alias="Calculation", description="Calculation code.", example=1)
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class AbsenceTypePayload(BaseModel):
+    id: int = Field(alias="Id", description="Absence type identifier.", example=1, json_schema_extra={"prefix": "type_"})
+    company_id: int = Field(alias="MdNr", description="Company id (Mandant).", example=1, json_schema_extra={"prefix": "type_"})
+    number: Optional[int] = Field(default=None, alias="Number", description="Absence type number.", example=100, json_schema_extra={"prefix": "type_"})
+    name: Optional[str] = Field(default=None, alias="Name", description="Absence type name.", example="Vacation", json_schema_extra={"prefix": "type_"})
+    show_in_web: Optional[bool] = Field(default=None, alias="ShowInWeb", description="Visible on web.", example=True, json_schema_extra={"prefix": "type_"})
+    is_historic: Optional[bool] = Field(default=None, alias="IsHistoric", description="Historic flag.", example=False, json_schema_extra={"prefix": "type_"})
+    is_holiday: Optional[bool] = Field(default=None, alias="IsHoliday", description="Holiday flag.", example=True, json_schema_extra={"prefix": "type_"})
+    is_chargeable_workingtime: Optional[bool] = Field(default=None, alias="IsChargeableWorkingtime", description="Chargeable working time flag.", example=False, json_schema_extra={"prefix": "type_"})
+    day_type: Optional[str] = Field(default=None, alias="DayType", description="Day type.", example="FullDay", json_schema_extra={"prefix": "type_"})
+    workflow_plan_id: Optional[int] = Field(default=None, alias="WorkFlowPlanId", description="Workflow plan id.", example=1, json_schema_extra={"prefix": "type_"})
+    storno_workflow_plan_id: Optional[int] = Field(default=None, alias="StornoWorkFlowPlanId", description="Storno workflow plan id.", example=2, json_schema_extra={"prefix": "type_"})
+    status: Optional[AbsenceStatus] = Field(default=None, alias="Status", description="Status payload.", json_schema_extra={"prefix": "type_status_"})
+    holiday_calculation: Optional[AbsenceHolidayCalculation] = Field(default=None, alias="HolidayCalculation", description="Holiday calculation payload.", json_schema_extra={"prefix": "type_holiday_calculation_"})
+    acquisition_unit: Optional[str] = Field(default=None, alias="AcquisitionUnit", description="Acquisition unit.", example="Days", json_schema_extra={"prefix": "type_"})
+    valid_from: Optional[str] = Field(default=None, alias="ValidFrom", description="Valid-from date.", example="2024-01-01", json_schema_extra={"prefix": "type_"})
+    valid_to: Optional[str] = Field(default=None, alias="ValidTo", description="Valid-to date.", example="2024-12-31", json_schema_extra={"prefix": "type_"})
+    pre_existing_condition: Optional[bool] = Field(default=None, alias="PreExistingCondition", description="Pre-existing condition.", example=False, json_schema_extra={"prefix": "type_"})
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class AbsenceEmployeeKey(BaseModel):
+    company_id: Optional[int] = Field(default=None, alias="MdNr", description="Company id.", example=1, json_schema_extra={"prefix": "absence_planing_employee_key_"})
+    employee_number: Optional[int] = Field(default=None, alias="AnNr", description="Employee number.", example=100, json_schema_extra={"prefix": "absence_planing_employee_key_"})
+    combined_key: Optional[str] = Field(default=None, alias="CombinedKey", description="Combined key.", example="1_100", json_schema_extra={"prefix": "absence_planing_employee_key_"})
+    is_empty: Optional[bool] = Field(default=None, alias="IsEmpty", description="Empty flag.", example=False, json_schema_extra={"prefix": "absence_planing_employee_key_"})
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class AbsencePlaning(BaseModel):
+    employee_key: Optional[AbsenceEmployeeKey] = Field(default=None, alias="EmployeeKey", description="Employee key.", json_schema_extra={"prefix": "absence_planing_"})
+    id: Optional[int] = Field(default=None, alias="Id", description="Absence planning id.", example=1, json_schema_extra={"prefix": "absence_planing_"})
+    replacement: Optional[Any] = Field(default=None, alias="Replacement", description="Replacement payload.", example=None, json_schema_extra={"prefix": "absence_planing_"})
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class AbsenceCreate(BaseModel):
+    """
+    Pydantic schema for absence creation payloads.
+    """
+
+    id: Optional[int] = Field(default=None, alias="Id", description="Absence id.", example=1)
+    company_id: int = Field(alias="MdNr", description="Company id (Mandant).", example=1)
+    employee_number: int = Field(alias="AnNr", description="Employee number.", example=100)
+    type: AbsenceTypePayload = Field(alias="Type", description="Absence type payload.")
+    date_from: str = Field(alias="From", description="Start timestamp.", example="2024-01-15T00:00:00")
+    date_to: str = Field(alias="To", description="End timestamp.", example="2024-01-20T00:00:00")
+    from_day_type: Optional[str] = Field(default=None, alias="FromDayType", description="Start day type.", example="FullDay")
+    to_day_type: Optional[str] = Field(default=None, alias="ToDayType", description="End day type.", example="FullDay")
+    last_working_day: Optional[str] = Field(default=None, alias="LastWorkingDay", description="Last working day before absence.", example="2024-01-14")
+    absence_planing: Optional[AbsencePlaning] = Field(default=None, alias="AbsencePlaning", description="Absence planning payload.")
+    follow_absence_time_id: Optional[int] = Field(default=None, alias="FollowAbsenceTimeId", description="Follow-up absence id.", example=2)
+    absence_type: Optional[str] = Field(default=None, alias="AbsenceType", description="Absence type category.", example="Vacation")
+    absence_type_text: Optional[str] = Field(default=None, alias="AbsenceTypeText", description="Absence type description.", example="Annual Leave")
+    open_end: bool = Field(alias="OpenEnd", description="Open-end flag.", example=False)
+    state: Optional[str] = Field(default=None, alias="State", description="State value.", example="Approved")
+    days_count: Optional[float] = Field(default=None, alias="DaysCount", description="Total days.", example=5.0)
+    days_previous_year: Optional[float] = Field(default=None, alias="DaysVJ", description="Previous year days.", example=0.0)
+    days_current_year: Optional[float] = Field(default=None, alias="DaysKJ", description="Current year days.", example=5.0)
+    days_divergent: Optional[float] = Field(default=None, alias="DaysDivergent", description="Divergent days.", example=0.0)
+    accident_at_work: Optional[bool] = Field(default=None, alias="AccidentAtWork", description="Accident at work flag.", example=False)
+    day_of_accident: Optional[str] = Field(default=None, alias="DayOfAccident", description="Day of accident.", example="2024-01-15")
+    accident_insurance_number: Optional[str] = Field(default=None, alias="AccidentInsuranceNumber", description="Accident insurance number.", example="INS123")
+    accident_insurance_reference_number: Optional[str] = Field(default=None, alias="AccidentInsuranceReferenceNumber", description="Accident insurance reference number.", example="REF456")
+    third_party_harm: Optional[bool] = Field(default=None, alias="ThirdPartyHarm", description="Third party harm flag.", example=False)
+    worked_on_first_absence_day: Optional[bool] = Field(default=None, alias="WorkedOnFirstAbsenceday", description="Worked on first absence day flag.", example=False)
+    changed_at: Optional[str] = Field(default=None, alias="ChangedAt", description="Changed at timestamp.", example="2024-01-10T10:00:00")
+    created_by: Optional[str] = Field(default=None, alias="CreatedBy", description="Created by.", example="admin")
+    created_at: Optional[str] = Field(default=None, alias="CreatedAt", description="Created at timestamp.", example="2024-01-10T09:00:00")
+    changed_by: Optional[str] = Field(default=None, alias="ChangedBy", description="Changed by.", example="admin")
+    comment: Optional[str] = Field(default=None, alias="Comment", description="Comment text.", example="Vacation request")
+    is_task: Optional[bool] = Field(default=None, alias="IsTask", description="Task flag.", example=False)
+    task_id: Optional[int] = Field(default=None, alias="TaskId", description="Task id.", example=1)
+    workflow_plan_val_id: Optional[int] = Field(default=None, alias="WorkflowPlanValID", description="Workflow plan validation id.", example=1)
+    deputy: Optional[Any] = Field(default=None, alias="Deputy", description="Deputy payload.", example=None)
+    deputy_name: Optional[Any] = Field(default=None, alias="DeputyName", description="Deputy name payload.", example=None)
+    previous_sickness: Optional[bool] = Field(default=None, alias="PreviousSickness", description="Previous sickness flag.", example=False)
+    previous_sickness_request: Optional[str] = Field(default=None, alias="PreviousSicknessRequest", description="Previous sickness request.", example="None")
+    previous_sickness_absence_time_id: Optional[int] = Field(default=None, alias="PreviousSicknessAbsenceTimeId", description="Previous sickness absence time id.", example=0)
+    previous_sickness_absence_time_task_id: Optional[int] = Field(default=None, alias="PreviousSicknessAbsenceTimeTaskId", description="Previous sickness absence task id.", example=0)
+    end_of_payment_for_longtime_sickness: Optional[str] = Field(default=None, alias="EndOfPaymentForLongtimeSickness", description="End of payment for long sickness.", example="2024-12-31")
+    errors: Optional[List[Any]] = Field(default=None, alias="Errors", description="Errors payload.", example=[])
+    deputies: Optional[List[Any]] = Field(default=None, alias="Deputies", description="Deputies payload.", example=[])
+    approver: Optional[Any] = Field(default=None, alias="Approver", description="Approver payload.", example=None)
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class AbsenceDelete(BaseModel):
+    """
+    Minimal payload for deleting an absence entry.
+    """
+
+    id: int = Field(alias="Id", description="Absence identifier.", example=1)
+    company_id: int = Field(alias="MdNr", description="Company id (Mandant).", example=1)
+    employee_number: int = Field(alias="AnNr", description="Employee number.", example=100)
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class AbsenceTypesGet(BrynQPanderaDataFrameModel):
+    """
+    Pandera schema for absence type reference data.
+    """
+
+    # Base identifiers
+    type_id: Series[pd.Int64Dtype] = pa.Field(alias="Id", coerce=True, nullable=False, description="Absence type identifier.")
+    tenant_number: Series[pd.Int64Dtype] = pa.Field(alias="MdNr", coerce=True, nullable=False, description="Tenant (Mandant) number.")
+    type_number: Series[pd.Int64Dtype] = pa.Field(alias="Number", coerce=True, nullable=False, description="Absence type number.")
+
+    # Labels and descriptions
+    name: Optional[Series[pd.StringDtype]] = pa.Field(alias="Name", coerce=True, nullable=True, description="Absence type name.")
+    name_short: Optional[Series[pd.StringDtype]] = pa.Field(alias="NameShort", coerce=True, nullable=True, description="Short name.")
+    description: Optional[Series[pd.StringDtype]] = pa.Field(alias="Description", coerce=True, nullable=True, description="Description text.")
+
+    # Visuals
+    color: Optional[Series[pd.StringDtype]] = pa.Field(alias="Color", coerce=True, nullable=True, description="Primary color.")
+    color_previous_year: Optional[Series[pd.StringDtype]] = pa.Field(alias="ColorPreviousYear", coerce=True, nullable=True, description="Previous year color.")
+
+    # Flags
+    show_in_web: Optional[Series[bool]] = pa.Field(alias="ShowInWeb", coerce=True, nullable=True, description="Display in web flag.")
+    is_used_for_training: Optional[Series[bool]] = pa.Field(alias="IsUsedForTraining", coerce=True, nullable=True, description="Training flag.")
+    is_historic: Optional[Series[bool]] = pa.Field(alias="IsHistoric", coerce=True, nullable=True, description="Historic flag.")
+    is_holiday: Optional[Series[bool]] = pa.Field(alias="IsHoliday", coerce=True, nullable=True, description="Holiday flag.")
+    is_sick: Optional[Series[bool]] = pa.Field(alias="IsSick", coerce=True, nullable=True, description="Sickness flag.")
+    day_type: Optional[Series[pd.StringDtype]] = pa.Field(alias="DayType", coerce=True, nullable=True, description="Day type.")
+    acquisition_unit: Optional[Series[pd.StringDtype]] = pa.Field(alias="AcquisitionUnit", coerce=True, nullable=True, description="Acquisition unit.")
+
+    # Status info
+    status_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Status__Id", coerce=True, nullable=True, description="Status identifier.")
+    status_name: Optional[Series[pd.StringDtype]] = pa.Field(alias="Status__Status", coerce=True, nullable=True, description="Status name.")
+    status_short: Optional[Series[pd.StringDtype]] = pa.Field(alias="Status__StatusShort", coerce=True, nullable=True, description="Status short code.")
+
+    # Holiday calculation
+    holiday_calculation_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="HolidayCalculation__Id", coerce=True, nullable=True, description="Holiday calc identifier.")
+    holiday_calculation_description: Optional[Series[pd.StringDtype]] = pa.Field(alias="HolidayCalculation__Description", coerce=True, nullable=True, description="Holiday calc description.")
+    holiday_calculation_code: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="HolidayCalculation__Calculation", coerce=True, nullable=True, description="Holiday calc code.")
+
+    # Lifecycle
+    valid_from: Optional[Series[pd.StringDtype]] = pa.Field(alias="ValidFrom", coerce=True, nullable=True, description="Valid from timestamp.")
+    valid_to: Optional[Series[pd.StringDtype]] = pa.Field(alias="ValidTo", coerce=True, nullable=True, description="Valid to timestamp.")
+    used_until: Optional[Series[pd.StringDtype]] = pa.Field(alias="UsedUntil", coerce=True, nullable=True, description="Used until timestamp.")
+    gueltig_ab: Optional[Series[pd.StringDtype]] = pa.Field(alias="GueltigAb", coerce=True, nullable=True, description="Localized valid from.")
+    gueltig_bis: Optional[Series[pd.StringDtype]] = pa.Field(alias="GueltigBis", coerce=True, nullable=True, description="Localized valid to.")
+
+    # Behavioral flags
+    is_sickness_without_eau: Optional[Series[bool]] = pa.Field(alias="IsSicknessWithoutEAU", coerce=True, nullable=True, description="Sickness without EAU flag.")
+    pre_existing_condition: Optional[Series[bool]] = pa.Field(alias="PreExistingCondition", coerce=True, nullable=True, description="Pre-existing condition flag.")
+    book_interruption: Optional[Series[bool]] = pa.Field(alias="BookInterruption", coerce=True, nullable=True, description="Book interruption flag.")
+    fill_to_target_time: Optional[Series[bool]] = pa.Field(alias="FillToTargetTime", coerce=True, nullable=True, description="Fill to target time flag.")
+    ignore_rules_on_half_holidays: Optional[Series[bool]] = pa.Field(alias="IgnoreRulesOnHalfHolidays", coerce=True, nullable=True, description="Ignore half-holiday rules flag.")
+    full_time_statistics_deduction: Optional[Series[bool]] = pa.Field(alias="MinderungVollbeschaeftigtenStatistik", coerce=True, nullable=True, description="Full-time statistics deduction flag.")
+    has_last_working_day: Optional[Series[bool]] = pa.Field(alias="HasLastWorkingDay", coerce=True, nullable=True, description="Requires last working day flag.")
+
+    # Priorities and workflow
+    priority: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Priority", coerce=True, nullable=True, description="Priority value.")
+    is_not_deletable: Optional[Series[bool]] = pa.Field(alias="IsNotDeletable", coerce=True, nullable=True, description="Deletion protection flag.")
+    is_in_use: Optional[Series[bool]] = pa.Field(alias="IsInUse", coerce=True, nullable=True, description="In-use flag.")
+    workflow_plan_cancel_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="WorkflowPlanCancelId", coerce=True, nullable=True, description="Workflow cancel plan id.")
+    workflow_plan_request_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="WorkflowPlanRequestId", coerce=True, nullable=True, description="Workflow request plan id.")
+
+    class _Annotation:
+        primary_key = "type_id"
+
+    class Config:
+        coerce = True
+        strict = "filter"

brynq_sdk_sage_germany/schemas/allowances.py

@@ -0,0 +1,147 @@
+"""
+Schemas for Sage Germany employee allowances payloads.
+"""
+
+from datetime import datetime
+from typing import Optional
+
+import pandas as pd
+import pandera as pa
+from pandera.typing import Series
+from pydantic import BaseModel, Field, ConfigDict
+
+from brynq_sdk_functions import BrynQPanderaDataFrameModel
+
+
+class AllowanceKey(BaseModel):
+    """
+    Snapshot key for a single allowance record.
+    """
+
+    date: datetime = Field(alias="Date", description="Snapshot date.", example="2024-01-01T00:00:00")
+    company_id: int = Field(alias="MdNr", description="Company id (Mandant).", example=1)
+    employee_number: int = Field(alias="AnNr", description="Employee number.", example=100)
+    combined_key: str = Field(alias="CombinedKey", description="Combined key string.", example="1_100")
+    is_empty: bool = Field(alias="IsEmpty", description="Empty marker.", example=False)
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class WageType(BaseModel):
+    """
+    Wage type metadata used in allowances.
+    """
+
+    number: int = Field(alias="LaNr", description="Wage type number.", example=1000)
+    display_name: Optional[str] = Field(default=None, alias="AnzeigeName", description="Display name.", example="Bonus")
+    company_id: Optional[int] = Field(default=None, alias="MdNr", description="Company id.", example=1)
+    description: Optional[str] = Field(default=None, alias="Bezeichnung", description="Description.", example="Monthly Bonus")
+    is_deduction: Optional[bool] = Field(default=None, alias="IstAbzug", description="Deduction flag.", example=False)
+    surcharge: Optional[float] = Field(default=None, alias="Zuschlag", description="Surcharge value.", example=0.0)
+    surcharge_unit: Optional[str] = Field(default=None, alias="ZuschlagEinheit", description="Surcharge unit.", example="EUR")
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class PaymentFrequency(BaseModel):
+    """
+    Payment rhythm block.
+    """
+
+    id: int = Field(alias="Id", description="Payment rhythm identifier.", example=1)
+    text: Optional[str] = Field(default=None, alias="Text", description="Payment rhythm text.", example="Monthly")
+    id_with_text: Optional[str] = Field(default=None, alias="IdMitText", description="Payment rhythm id-text.", example="1 - Monthly")
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class AllowanceCreateRequest(BaseModel):
+    """
+    Pydantic schema for posting allowance payloads to Sage Germany.
+    """
+
+    id: Optional[int] = Field(default=None, alias="Id", description="Allowance identifier.", example=1)
+    key: AllowanceKey = Field(
+        alias="Key",
+        description="Key block for the allowance.",
+        json_schema_extra={"prefix": "key_"},
+    )
+    wage_type: WageType = Field(
+        alias="Lohnart",
+        description="Wage type metadata.",
+        json_schema_extra={"prefix": "wage_type_"},
+    )
+    amount: Optional[float] = Field(default=None, alias="Betrag", description="Allowance amount.", example=500.00)
+    quantity: Optional[float] = Field(default=None, alias="Anzahl", description="Allowance quantity.", example=1.0)
+    payment_frequency: Optional[PaymentFrequency] = Field(
+        default=None,
+        alias="Zahlungsrhythmus",
+        description="Payment rhythm.",
+        json_schema_extra={"prefix": "payment_frequency_"},
+    )
+    payment_month: Optional[str] = Field(default=None, alias="Zahlungsmonat", description="Payment month.", example="01")
+    cost_center: Optional[str] = Field(default=None, alias="Kostenstelle", description="Cost center.", example="CC001")
+    cost_unit: Optional[str] = Field(default=None, alias="Kostentraeger", description="Cost unit.", example="CU001")
+    valid_from: Optional[datetime] = Field(default=None, alias="GueltigAb", description="Validity start.", example="2024-01-01T00:00:00")
+    valid_to: Optional[datetime] = Field(default=None, alias="GueltigBis", description="Validity end.", example="2024-12-31T00:00:00")
+    text: Optional[str] = Field(default=None, alias="Text", description="Free text.", example="Monthly allowance")
+    dimension_one: Optional[str] = Field(default=None, alias="Dimension1", description="Dimension 1.", example="D1")
+    dimension_two: Optional[str] = Field(default=None, alias="Dimension2", description="Dimension 2.", example="D2")
+    dimension_three: Optional[str] = Field(default=None, alias="Dimension3", description="Dimension 3.", example="D3")
+    read_only: Optional[bool] = Field(default=None, alias="ReadOnly", description="Read-only flag.", example=False)
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class AllowancesGet(BrynQPanderaDataFrameModel):
+    """
+    Pandera schema for employee allowances (fixed earnings/deductions).
+    """
+
+    # Base identifiers
+    allowance_id: Series[pd.Int64Dtype] = pa.Field(alias="Id", coerce=True, nullable=False, description="Allowance identifier.")
+    key_date: Series[pd.StringDtype] = pa.Field(alias="Key__Date", coerce=True, nullable=False, description="Snapshot date.")
+    company_id: Series[pd.Int64Dtype] = pa.Field(alias="Key__MdNr", coerce=True, nullable=False, description="Company id.")
+    employee_number: Series[pd.Int64Dtype] = pa.Field(alias="Key__AnNr", coerce=True, nullable=False, description="Employee number.")
+    combined_key: Series[pd.StringDtype] = pa.Field(alias="Key__CombinedKey", coerce=True, nullable=False, description="Combined key.")
+    key_is_empty: Optional[Series[bool]] = pa.Field(alias="Key__IsEmpty", coerce=True, nullable=True, description="Indicates empty key payload.")
+
+    # Wage type metadata
+    wage_type_number: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Lohnart__LaNr", coerce=True, nullable=True, description="Wage type number.")
+    wage_type_display_name: Optional[Series[pd.StringDtype]] = pa.Field(alias="Lohnart__AnzeigeName", coerce=True, nullable=True, description="Display name.")
+    wage_type_company_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Lohnart__MdNr", coerce=True, nullable=True, description="Wage type company id.")
+    wage_type_description: Optional[Series[pd.StringDtype]] = pa.Field(alias="Lohnart__Bezeichnung", coerce=True, nullable=True, description="Wage type description.")
+    wage_type_is_deduction: Optional[Series[bool]] = pa.Field(alias="Lohnart__IstAbzug", coerce=True, nullable=True, description="Deduction flag.")
+    wage_type_surcharge: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Lohnart__Zuschlag", coerce=True, nullable=True, description="Surcharge value.")
+    wage_type_surcharge_unit: Optional[Series[pd.StringDtype]] = pa.Field(alias="Lohnart__ZuschlagEinheit", coerce=True, nullable=True, description="Surcharge unit.")
+
+    # Amounts
+    amount: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Betrag", coerce=True, nullable=True, description="Allowance amount.")
+    surcharge_amount: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Zuschlag", coerce=True, nullable=True, description="Allowance surcharge.")
+    quantity: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Anzahl", coerce=True, nullable=True, description="Allowance quantity.")
+
+    # Payment rhythm
+    payment_frequency_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Zahlungsrhythmus__Id", coerce=True, nullable=True, description="Payment rhythm identifier.")
+    payment_frequency_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="Zahlungsrhythmus__Text", coerce=True, nullable=True, description="Payment rhythm text.")
+    payment_frequency_id_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="Zahlungsrhythmus__IdMitText", coerce=True, nullable=True, description="Payment rhythm id-text.")
+    payment_month: Optional[Series[pd.StringDtype]] = pa.Field(alias="Zahlungsmonat", coerce=True, nullable=True, description="Specific payment month.")
+
+    # Cost objects
+    cost_center: Optional[Series[pd.StringDtype]] = pa.Field(alias="Kostenstelle", coerce=True, nullable=True, description="Cost center.")
+    cost_unit: Optional[Series[pd.StringDtype]] = pa.Field(alias="Kostentraeger", coerce=True, nullable=True, description="Cost unit.")
+
+    # Validity & dimensions
+    valid_from: Optional[Series[pd.StringDtype]] = pa.Field(alias="GueltigAb", coerce=True, nullable=True, description="Valid from date.")
+    valid_to: Optional[Series[pd.StringDtype]] = pa.Field(alias="GueltigBis", coerce=True, nullable=True, description="Valid to date.")
+    wage_type_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="LgaText", coerce=True, nullable=True, description="Additional wage type text.")
+    dimension_one: Optional[Series[pd.StringDtype]] = pa.Field(alias="Dimension1", coerce=True, nullable=True, description="Dimension 1.")
+    dimension_two: Optional[Series[pd.StringDtype]] = pa.Field(alias="Dimension2", coerce=True, nullable=True, description="Dimension 2.")
+    dimension_three: Optional[Series[pd.StringDtype]] = pa.Field(alias="Dimension3", coerce=True, nullable=True, description="Dimension 3.")
+    read_only: Optional[Series[bool]] = pa.Field(alias="ReadOnly", coerce=True, nullable=True, description="Read-only flag.")
+
+    class _Annotation:
+        primary_key = "allowance_id"
+
+    class Config:
+        coerce = True
+        strict = "filter"

brynq_sdk_sage_germany/schemas/cost_centers.py

@@ -0,0 +1,46 @@
+"""
+Schemas for Sage Germany cost center payloads.
+"""
+
+from typing import Optional
+
+import pandas as pd
+import pandera as pa
+from pandera.typing import Series
+from pydantic import BaseModel, ConfigDict, Field
+
+from brynq_sdk_functions import BrynQPanderaDataFrameModel
+
+__all__ = ["CostCentersGet", "CostCenterCreate"]
+
+
+class CostCentersGet(BrynQPanderaDataFrameModel):
+    """
+    Pandera schema for company cost center records.
+    """
+
+    company_id: Series[pd.Int64Dtype] = pa.Field(alias="MdNr", coerce=True, nullable=False, description="Company id (Mandant).")
+    cost_center_number: Series[pd.StringDtype] = pa.Field(alias="Nr", coerce=True, nullable=False, description="Cost center number.")
+    cost_center_id: Series[pd.Int64Dtype] = pa.Field(alias="Id", coerce=True, nullable=False, description="Cost center identifier.")
+    cost_center_name: Optional[Series[pd.StringDtype]] = pa.Field(alias="Bezeichnung", coerce=True, nullable=True, description="Cost center label.")
+    address: Optional[Series[pd.StringDtype]] = pa.Field(alias="Anschrift", coerce=True, nullable=True, description="Cost center address.")
+
+    class _Annotation:
+        primary_key = "cost_center_id"
+
+    class Config:
+        coerce = True
+        strict = "filter"
+
+
+class CostCenterCreate(BaseModel):
+    """
+    Pydantic schema for creating or updating cost centers.
+    """
+
+    company_id: int = Field(alias="MdNr", description="Company id (Mandant).", example=1)
+    cost_center_number: str = Field(alias="Nr", description="Cost center number.", example="CC001")
+    cost_center_name: str = Field(alias="Bezeichnung", description="Cost center label.", example="Engineering Department")
+    address: Optional[str] = Field(default=None, alias="Anschrift", description="Cost center address.", example="Main Street 123")
+
+    model_config = ConfigDict(populate_by_name=True)