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

brynq_sdk_sage_germany/schemas/organization.py

@@ -0,0 +1,172 @@
+"""
+Schemas for Sage Germany organization payloads.
+"""
+
+from typing import List, 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__ = [
+    "OrganizationGet",
+    "OrganizationCreate",
+]
+
+
+class OrgIdText(BaseModel):
+    id: Optional[int] = Field(default=None, alias="Id", description="Identifier value.", example=1)
+    text: Optional[str] = Field(default=None, alias="Text", description="Display text value.", example="Sample text")
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class OrganizationKey(BaseModel):
+    date: str = Field(alias="Date", description="Snapshot date.", example="2024-01-01T00:00:00", json_schema_extra={"prefix": "key_"})
+    company_id: int = Field(alias="MdNr", description="Company id (Mandant).", example=1, json_schema_extra={"prefix": "key_"})
+    employee_number: int = Field(alias="AnNr", description="Employee number.", example=100, json_schema_extra={"prefix": "key_"})
+    combined_key: Optional[str] = Field(default=None, alias="CombinedKey", description="Combined key string.", example="1_100", json_schema_extra={"prefix": "key_"})
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class OrgGeneralData(BaseModel):
+    use_operating_sites: Optional[bool] = Field(default=None, alias="VerwendungBetriebsstaetten", description="Use operating sites flag.", example=True, json_schema_extra={"prefix": "general_"})
+    payroll_group: Optional[OrgIdText] = Field(default=None, alias="Abrechnungskreis", description="Payroll group reference.", json_schema_extra={"prefix": "general_payroll_group_"})
+    payroll_run: Optional[OrgIdText] = Field(default=None, alias="Abrechnungslauf", description="Payroll run reference.", json_schema_extra={"prefix": "general_payroll_run_"})
+    federal_state: Optional[OrgIdText] = Field(default=None, alias="Bundesland", description="Federal state reference.", json_schema_extra={"prefix": "general_state_"})
+    site: Optional[OrgIdText] = Field(default=None, alias="Betriebsstaette", description="Operating site reference.", json_schema_extra={"prefix": "general_site_"})
+    debtor_number: Optional[str] = Field(default=None, alias="DebitorenNummer", description="Debtor number.", example="DEB001", json_schema_extra={"prefix": "general_"})
+    calc_cost_center: Optional[OrgIdText] = Field(default=None, alias="KalkulatorischeKostenstelle", description="Calculated cost center reference.", json_schema_extra={"prefix": "general_calc_cost_center_"})
+    position: Optional[OrgIdText] = Field(default=None, alias="Position", description="Position reference.", json_schema_extra={"prefix": "general_position_"})
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class OrgSearchTerms(BaseModel):
+    search_1: Optional[str] = Field(default=None, alias="Such1", description="Search term 1.", example="Engineering", json_schema_extra={"prefix": "search_terms_"})
+    search_2: Optional[str] = Field(default=None, alias="Such2", description="Search term 2.", example="Berlin", json_schema_extra={"prefix": "search_terms_"})
+    search_3: Optional[str] = Field(default=None, alias="Such3", description="Search term 3.", example="Full-time", json_schema_extra={"prefix": "search_terms_"})
+    search_4: Optional[str] = Field(default=None, alias="Such4", description="Search term 4.", example="Active", json_schema_extra={"prefix": "search_terms_"})
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class OrgSplitEntry(BaseModel):
+    id: Optional[int] = Field(default=None, alias="Id", description="Split entry identifier.", example=1)
+    number: Optional[str] = Field(default=None, alias="Number", description="Split entry number.", example="001")
+    text: Optional[str] = Field(default=None, alias="Text", description="Split entry text.", example="Main")
+    portion: Optional[float] = Field(default=None, alias="Anteil", description="Portion percentage.", example=100.0)
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class OrgSplitContainer(BaseModel):
+    split: Optional[List[OrgSplitEntry]] = Field(default=None, alias="Aufteilung", description="Split entries list.", example=[])
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class OrgStructure(BaseModel):
+    id: Optional[str] = Field(default=None, alias="Id", description="Structure identifier.", example="STR001")
+    structure: Optional[OrgIdText] = Field(default=None, alias="Struktur", description="Structure reference.")
+    unit: Optional[OrgIdText] = Field(default=None, alias="Einheit", description="Unit reference.")
+    valid_from: Optional[str] = Field(default=None, alias="ValidFrom", description="Valid from date.", example="2024-01-01")
+    valid_to: Optional[str] = Field(default=None, alias="ValidTo", description="Valid to date.", example="2024-12-31")
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class OrgFixedDistribution(BaseModel):
+    id: Optional[int] = Field(default=None, alias="Id", description="Fixed distribution identifier.", example=1)
+    cost_center: Optional[OrgIdText] = Field(default=None, alias="Kostenstelle", description="Cost center reference.")
+    cost_unit: Optional[OrgIdText] = Field(default=None, alias="Kostentraeger", description="Cost unit reference.")
+    dimension_one: Optional[OrgIdText] = Field(default=None, alias="Dimension1", description="Dimension 1 reference.")
+    dimension_two: Optional[OrgIdText] = Field(default=None, alias="Dimension2", description="Dimension 2 reference.")
+    dimension_three: Optional[OrgIdText] = Field(default=None, alias="Dimension3", description="Dimension 3 reference.")
+    portion: Optional[float] = Field(default=None, alias="Anteil", description="Portion percentage.", example=100.0)
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class OrganizationCreate(BaseModel):
+    key: OrganizationKey = Field(alias="Key", description="Organization key.", json_schema_extra={"prefix": "key_"})
+    is_fixed_cost_split: Optional[bool] = Field(default=None, alias="IstFesteKostenAufteilung", description="Fixed cost split flag.", example=False)
+    general_data: Optional[OrgGeneralData] = Field(default=None, alias="AllgemeineDaten", description="General data block.", json_schema_extra={"prefix": "general_"})
+    search_terms: Optional[OrgSearchTerms] = Field(default=None, alias="Suchbegriffe", description="Search terms block.", json_schema_extra={"prefix": "search_terms_"})
+    cost_centers: Optional[OrgSplitContainer] = Field(default=None, alias="Kostenstellen", description="Cost centers container.", json_schema_extra={"prefix": "cost_center_"})
+    cost_units: Optional[OrgSplitContainer] = Field(default=None, alias="Kostentraeger", description="Cost units container.", json_schema_extra={"prefix": "cost_unit_"})
+    dimension_one: Optional[OrgSplitContainer] = Field(default=None, alias="Dimension1", description="Dimension 1 container.", json_schema_extra={"prefix": "dimension_one_"})
+    dimension_two: Optional[OrgSplitContainer] = Field(default=None, alias="Dimension2", description="Dimension 2 container.", json_schema_extra={"prefix": "dimension_two_"})
+    dimension_three: Optional[OrgSplitContainer] = Field(default=None, alias="Dimension3", description="Dimension 3 container.", json_schema_extra={"prefix": "dimension_three_"})
+    org_assignments: Optional[List[OrgStructure]] = Field(default=None, alias="OrgaEinordnungen", description="Organization assignments list.", example=[], json_schema_extra={"prefix": "org_assign_"})
+    fixed_distribution: Optional[List[OrgFixedDistribution]] = Field(default=None, alias="FesteAufteilung", description="Fixed distribution list.", example=[], json_schema_extra={"prefix": "fixed_"})
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class OrganizationGet(BrynQPanderaDataFrameModel):
+    """
+    Pandera schema for employee organization data (cost centers, cost units, structures).
+    """
+
+    # Key
+    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="Key empty flag.")
+
+    # Flags
+    fixed_cost_split: Optional[Series[bool]] = pa.Field(alias="IstFesteKostenAufteilung", coerce=True, nullable=True, description="Fixed cost split flag.")
+    uses_operating_sites: Optional[Series[bool]] = pa.Field(alias="AllgemeineDaten__VerwendungBetriebsstaetten", coerce=True, nullable=True, description="Uses operating sites flag.")
+
+    # General data
+    payroll_group_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="AllgemeineDaten__Abrechnungskreis__Id", coerce=True, nullable=True, description="Payroll group id.")
+    payroll_group_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="AllgemeineDaten__Abrechnungskreis__Text", coerce=True, nullable=True, description="Payroll group text.")
+    payroll_group_id_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="AllgemeineDaten__Abrechnungskreis__IdMitText", coerce=True, nullable=True, description="Payroll group id+text.")
+
+    payroll_run_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="AllgemeineDaten__Abrechnungslauf__Id", coerce=True, nullable=True, description="Payroll run id.")
+    payroll_run_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="AllgemeineDaten__Abrechnungslauf__Text", coerce=True, nullable=True, description="Payroll run text.")
+    payroll_run_id_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="AllgemeineDaten__Abrechnungslauf__IdMitText", coerce=True, nullable=True, description="Payroll run id+text.")
+
+    site_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="AllgemeineDaten__Betriebsstaette__Id", coerce=True, nullable=True, description="Site id.")
+    site_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="AllgemeineDaten__Betriebsstaette__Text", coerce=True, nullable=True, description="Site text.")
+    site_id_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="AllgemeineDaten__Betriebsstaette__IdMitText", coerce=True, nullable=True, description="Site id+text.")
+
+    position_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="AllgemeineDaten__Position__Id", coerce=True, nullable=True, description="Position id.")
+    position_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="AllgemeineDaten__Position__Text", coerce=True, nullable=True, description="Position text.")
+    position_id_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="AllgemeineDaten__Position__IdMitText", coerce=True, nullable=True, description="Position id+text.")
+
+    debtor_number: Optional[Series[pd.StringDtype]] = pa.Field(alias="AllgemeineDaten__DebitorenNummer", coerce=True, nullable=True, description="Debtor number.")
+    calc_cost_center: Optional[Series[pd.StringDtype]] = pa.Field(alias="AllgemeineDaten__KalkulatorischeKostenstelle", coerce=True, nullable=True, description="Calculated cost center.")
+
+    # Search terms
+    search_term_1: Optional[Series[pd.StringDtype]] = pa.Field(alias="Suchbegriffe__Such1", coerce=True, nullable=True, description="Search term 1.")
+    search_term_2: Optional[Series[pd.StringDtype]] = pa.Field(alias="Suchbegriffe__Such2", coerce=True, nullable=True, description="Search term 2.")
+    search_term_3: Optional[Series[pd.StringDtype]] = pa.Field(alias="Suchbegriffe__Such3", coerce=True, nullable=True, description="Search term 3.")
+    search_term_4: Optional[Series[pd.StringDtype]] = pa.Field(alias="Suchbegriffe__Such4", coerce=True, nullable=True, description="Search term 4.")
+
+    # Cost centers split
+    cost_center_split: Optional[Series[pd.StringDtype]] = pa.Field(alias="Kostenstellen__Aufteilung", coerce=True, nullable=True, description="Cost center split payload.")
+    cost_unit_split: Optional[Series[pd.StringDtype]] = pa.Field(alias="Kostentraeger__Aufteilung", coerce=True, nullable=True, description="Cost unit split payload.")
+
+    # Dimensions
+    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.")
+
+    # Org assignments payloads
+    org_assignments: Optional[Series[pd.StringDtype]] = pa.Field(alias="OrgaEinordnungen", coerce=True, nullable=True, description="Organization assignments payload.")
+    fixed_distribution: Optional[Series[pd.StringDtype]] = pa.Field(alias="FesteAufteilung", coerce=True, nullable=True, description="Fixed distribution payload.")
+
+    class _Annotation:
+        primary_key = "combined_key"
+
+    class Config:
+        coerce = True
+        strict = "filter"

brynq_sdk_sage_germany/schemas/organization_assignment.py

@@ -0,0 +1,61 @@
+"""
+Schemas for Sage Germany organization assignment (person/organisation) payloads.
+"""
+
+from typing import Optional
+
+import pandas as pd
+import pandera as pa
+from pandera.typing import Series
+
+from brynq_sdk_functions import BrynQPanderaDataFrameModel
+
+
+class OrganizationAssignmentGet(BrynQPanderaDataFrameModel):
+    """
+    Pandera schema for employee organization assignment data.
+    """
+
+    # Base identifiers
+    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="Key empty flag.")
+
+    fixed_cost_split: Optional[Series[bool]] = pa.Field(alias="IstFesteKostenAufteilung", coerce=True, nullable=True, description="Fixed cost split flag.")
+
+    # General data
+    uses_operating_sites: Optional[Series[bool]] = pa.Field(alias="AllgemeineDaten__VerwendungBetriebsstaetten", coerce=True, nullable=True, description="Uses operating sites flag.")
+    payroll_group_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="AllgemeineDaten__Abrechnungskreis__Id", coerce=True, nullable=True, description="Payroll group id.")
+    payroll_group_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="AllgemeineDaten__Abrechnungskreis__Text", coerce=True, nullable=True, description="Payroll group text.")
+    payroll_run_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="AllgemeineDaten__Abrechnungslauf__Id", coerce=True, nullable=True, description="Payroll run id.")
+    payroll_run_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="AllgemeineDaten__Abrechnungslauf__Text", coerce=True, nullable=True, description="Payroll run text.")
+    site_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="AllgemeineDaten__Betriebsstaette__Id", coerce=True, nullable=True, description="Site id.")
+    site_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="AllgemeineDaten__Betriebsstaette__Text", coerce=True, nullable=True, description="Site text.")
+    position_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="AllgemeineDaten__Position__Id", coerce=True, nullable=True, description="Position id.")
+    position_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="AllgemeineDaten__Position__Text", coerce=True, nullable=True, description="Position text.")
+
+    # Search terms
+    search_term_1: Optional[Series[pd.StringDtype]] = pa.Field(alias="Suchbegriffe__Such1", coerce=True, nullable=True, description="Search term 1.")
+    search_term_2: Optional[Series[pd.StringDtype]] = pa.Field(alias="Suchbegriffe__Such2", coerce=True, nullable=True, description="Search term 2.")
+    search_term_3: Optional[Series[pd.StringDtype]] = pa.Field(alias="Suchbegriffe__Such3", coerce=True, nullable=True, description="Search term 3.")
+    search_term_4: Optional[Series[pd.StringDtype]] = pa.Field(alias="Suchbegriffe__Such4", coerce=True, nullable=True, description="Search term 4.")
+
+    # Dimensions
+    dimension_one: Optional[Series[pd.StringDtype]] = pa.Field(alias="Dimension1", coerce=True, nullable=True, description="Custom dimension 1.")
+    dimension_two: Optional[Series[pd.StringDtype]] = pa.Field(alias="Dimension2", coerce=True, nullable=True, description="Custom dimension 2.")
+    dimension_three: Optional[Series[pd.StringDtype]] = pa.Field(alias="Dimension3", coerce=True, nullable=True, description="Custom dimension 3.")
+
+    # Raw payloads for splits and org assignments
+    cost_centers_payload: Optional[Series[pd.StringDtype]] = pa.Field(alias="Kostenstellen", coerce=True, nullable=True, description="Cost centers split payload.")
+    cost_units_payload: Optional[Series[pd.StringDtype]] = pa.Field(alias="Kostentraeger", coerce=True, nullable=True, description="Cost units split payload.")
+    org_assignments_payload: Optional[Series[pd.StringDtype]] = pa.Field(alias="OrgaEinordnungen", coerce=True, nullable=True, description="Organization assignments payload.")
+    fixed_distribution_payload: Optional[Series[pd.StringDtype]] = pa.Field(alias="FesteAufteilung", coerce=True, nullable=True, description="Fixed distribution payload.")
+
+    class _Annotation:
+        primary_key = "combined_key"
+
+    class Config:
+        coerce = True
+        strict = "filter"

brynq_sdk_sage_germany/schemas/payroll.py

@@ -0,0 +1,287 @@
+"""
+Schemas for Sage Germany payroll 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__ = [
+    "PayrollMasterDataCreate",
+    "PayrollMasterDataGet",
+    "PayrollGet",
+]
+
+
+class PayrollIdText(BaseModel):
+    id: Optional[int] = Field(default=None, alias="Id", description="Identifier value.", example=1)
+    text: Optional[str] = Field(default=None, alias="Text", description="Display text value.", example="Sample text")
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class PayrollKey(BaseModel):
+    date: str = Field(alias="Date", description="Snapshot date.", example="2024-01-01T00:00:00", json_schema_extra={"prefix": "key_"})
+    company_id: int = Field(alias="MdNr", description="Company id (Mandant).", example=1, json_schema_extra={"prefix": "key_"})
+    employee_number: int = Field(alias="AnNr", description="Employee number.", example=100, json_schema_extra={"prefix": "key_"})
+    combined_key: Optional[str] = Field(default=None, alias="CombinedKey", description="Combined key string.", example="1_100", json_schema_extra={"prefix": "key_"})
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class PayrollTaxData(BaseModel):
+    tax_by_class: Optional[bool] = Field(default=None, alias="BesteuerungNachSteuerklasse", description="Tax by class flag.", example=True, json_schema_extra={"prefix": "tax_data_"})
+    last_registration: Optional[str] = Field(default=None, alias="LetzteAnmeldung", description="Last registration date.", example="2024-01-01", json_schema_extra={"prefix": "tax_data_"})
+    elstam_status_id: Optional[str] = Field(default=None, alias="ElstamStatusId", description="ELStAM status id.", example="1", json_schema_extra={"prefix": "tax_data_"})
+    elstam_status_text: Optional[str] = Field(default=None, alias="ElstamStatusText", description="ELStAM status text.", example="Active", json_schema_extra={"prefix": "tax_data_"})
+    employment_type: Optional[PayrollIdText] = Field(default=None, alias="Beschaeftigungsart", description="Employment type reference.", json_schema_extra={"prefix": "tax_data_employment_type_"})
+    elstam_exclusion_reason: Optional[PayrollIdText] = Field(default=None, alias="GrundElstamAusschluss", description="ELStAM exclusion reason.", json_schema_extra={"prefix": "tax_data_elstam_exclusion_reason_"})
+    tax_calc_type: Optional[PayrollIdText] = Field(default=None, alias="ArtDerSteuerberechnung", description="Tax calculation type.", json_schema_extra={"prefix": "tax_data_tax_calc_type_"})
+    tax_class: Optional[int] = Field(default=None, alias="Steuerklasse", description="Tax class.", example=1, json_schema_extra={"prefix": "tax_data_"})
+    factor: Optional[float] = Field(default=None, alias="Faktor", description="Tax factor.", example=1.0, json_schema_extra={"prefix": "tax_data_"})
+    child_allowance: Optional[float] = Field(default=None, alias="Kinderfreibetrag", description="Child allowance.", example=0.5, json_schema_extra={"prefix": "tax_data_"})
+    religion: Optional[PayrollIdText] = Field(default=None, alias="Konfession", description="Religion reference.", json_schema_extra={"prefix": "tax_data_religion_"})
+    spouse_religion: Optional[PayrollIdText] = Field(default=None, alias="KonfessionEhegatte", description="Spouse religion reference.", json_schema_extra={"prefix": "tax_data_spouse_religion_"})
+    allowance_year: Optional[float] = Field(default=None, alias="FreibetragJahr", description="Yearly allowance.", example=1200.0, json_schema_extra={"prefix": "tax_data_"})
+    allowance_month: Optional[float] = Field(default=None, alias="FreibetragMonat", description="Monthly allowance.", example=100.0, json_schema_extra={"prefix": "tax_data_"})
+    addback_year: Optional[float] = Field(default=None, alias="HinzurechungsbetragJahr", description="Yearly addback.", example=0.0, json_schema_extra={"prefix": "tax_data_"})
+    addback_month: Optional[float] = Field(default=None, alias="HinzurechnungsbetragMonat", description="Monthly addback.", example=0.0, json_schema_extra={"prefix": "tax_data_"})
+    income_tax_equalization: Optional[bool] = Field(default=None, alias="Lohnsteuerjahresausgleich", description="Income tax equalization flag.", example=True, json_schema_extra={"prefix": "tax_data_"})
+    clawback_tax: Optional[bool] = Field(default=None, alias="Nachversteuerung", description="Clawback tax flag.", example=False, json_schema_extra={"prefix": "tax_data_"})
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class PayrollActivity(BaseModel):
+    person_group: Optional[PayrollIdText] = Field(default=None, alias="Personengruppenschluessel", description="Person group reference.", json_schema_extra={"prefix": "activity_person_group_"})
+    multi_employed: Optional[bool] = Field(default=None, alias="Mehrfachbeschaeftigt", description="Multi-employed flag.", example=False, json_schema_extra={"prefix": "activity_"})
+    education: Optional[PayrollIdText] = Field(default=None, alias="Schulabschluss", description="Education level reference.", json_schema_extra={"prefix": "activity_education_"})
+    apprenticeship: Optional[PayrollIdText] = Field(default=None, alias="Ausbildung", description="Apprenticeship reference.", json_schema_extra={"prefix": "activity_apprenticeship_"})
+    contract_form: Optional[PayrollIdText] = Field(default=None, alias="Vertragsform", description="Contract form reference.", json_schema_extra={"prefix": "activity_contract_form_"})
+    employment: Optional[PayrollIdText] = Field(default=None, alias="Beschaeftigung", description="Employment reference.", json_schema_extra={"prefix": "activity_employment_"})
+    leasing: Optional[int] = Field(default=None, alias="Leiharbeit", description="Leasing worker code.", example=0, json_schema_extra={"prefix": "activity_"})
+    special_case: Optional[PayrollIdText] = Field(default=None, alias="Besonderheit", description="Special case reference.", json_schema_extra={"prefix": "activity_special_case_"})
+    occupation_key: Optional[str] = Field(default=None, alias="Taetigkeitsschluessel", description="Occupation key.", example="12345", json_schema_extra={"prefix": "activity_"})
+    occupation_key_2010: Optional[str] = Field(default=None, alias="Taetigkeitsschluessel2010", description="Occupation key 2010.", example="54321", json_schema_extra={"prefix": "activity_"})
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class PayrollHealthFund(BaseModel):
+    id: Optional[int] = Field(default=None, alias="Id", description="Health fund identifier.", example=1)
+    name: Optional[str] = Field(default=None, alias="Name", description="Health fund name.", example="AOK")
+    fund_type: Optional[str] = Field(default=None, alias="Kassenart", description="Fund type.", example="Public")
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class PayrollSocialInsurance(BaseModel):
+    social_key: Optional[str] = Field(default=None, alias="SVSchluessel", description="Social insurance key.", example="1111", json_schema_extra={"prefix": "social_insurance_"})
+    health_fund: Optional[PayrollHealthFund] = Field(default=None, alias="Krankenkasse", description="Health fund reference.", json_schema_extra={"prefix": "social_insurance_health_fund_"})
+    pension_fund: Optional[PayrollHealthFund] = Field(default=None, alias="Versorgungswerk", description="Pension fund reference.", json_schema_extra={"prefix": "social_insurance_pension_fund_"})
+    employee_health_share: Optional[float] = Field(default=None, alias="ArbeitnehmeranteilKrankenversicherung", description="Employee health insurance share.", example=7.3, json_schema_extra={"prefix": "social_insurance_"})
+    employer_health_share: Optional[float] = Field(default=None, alias="ArbeitgeberanteilKrankenversicherung", description="Employer health insurance share.", example=7.3, json_schema_extra={"prefix": "social_insurance_"})
+    total_private_health: Optional[float] = Field(default=None, alias="GesamtbeitragPrivateKrankenversicherung", description="Total private health insurance.", example=0.0, json_schema_extra={"prefix": "social_insurance_"})
+    base_private_health: Optional[float] = Field(default=None, alias="BasistarifPrivateKrankenversicherung", description="Base private health insurance.", example=0.0, json_schema_extra={"prefix": "social_insurance_"})
+    employee_care_share: Optional[float] = Field(default=None, alias="ArbeitnehmeranteilPflegeversicherung", description="Employee care insurance share.", example=1.525, json_schema_extra={"prefix": "social_insurance_"})
+    employer_care_share: Optional[float] = Field(default=None, alias="ArbeitgeberanteilPflegeversicherung", description="Employer care insurance share.", example=1.525, json_schema_extra={"prefix": "social_insurance_"})
+    total_private_care: Optional[float] = Field(default=None, alias="GesamtbeitragPrivatePflegeversicherung", description="Total private care insurance.", example=0.0, json_schema_extra={"prefix": "social_insurance_"})
+    base_private_care: Optional[float] = Field(default=None, alias="BasistarifPrivatePflegeversicherung", description="Base private care insurance.", example=0.0, json_schema_extra={"prefix": "social_insurance_"})
+    parent_status: Optional[PayrollIdText] = Field(default=None, alias="Elterneigenschaft", description="Parent status reference.", json_schema_extra={"prefix": "social_insurance_parent_status_"})
+    health_insurance: Optional[PayrollIdText] = Field(default=None, alias="Krankenversicherung", description="Health insurance reference.", json_schema_extra={"prefix": "social_insurance_health_insurance_"})
+    pension_insurance: Optional[PayrollIdText] = Field(default=None, alias="Rentenversicherung", description="Pension insurance reference.", json_schema_extra={"prefix": "social_insurance_pension_insurance_"})
+    member_number_pension_fund: Optional[str] = Field(default=None, alias="MitgliedsnummerVersorgungswerk", description="Pension fund member number.", example="12345", json_schema_extra={"prefix": "social_insurance_"})
+    employee_pension_share: Optional[float] = Field(default=None, alias="ArbeitnehmeranteilRentenversicherung", description="Employee pension share.", example=9.3, json_schema_extra={"prefix": "social_insurance_"})
+    employer_pension_share: Optional[float] = Field(default=None, alias="ArbeitgeberanteilRentenversicherung", description="Employer pension share.", example=9.3, json_schema_extra={"prefix": "social_insurance_"})
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class PayrollLevy(BaseModel):
+    levy_mode: Optional[str] = Field(default=None, alias="AbfuehrungUmlage", description="Levy mode.", example="Standard", json_schema_extra={"prefix": "levy_"})
+    levy_fund: Optional[PayrollHealthFund] = Field(default=None, alias="UmlageKasse", description="Levy fund reference.", json_schema_extra={"prefix": "levy_fund_"})
+    insolvency_levy: Optional[bool] = Field(default=None, alias="AbfuehrungInsolvenzgeldumlage", description="Insolvency levy flag.", example=True, json_schema_extra={"prefix": "levy_"})
+    insolvency_fund: Optional[PayrollHealthFund] = Field(default=None, alias="InsolvenzgeldumlageKasse", description="Insolvency fund reference.", json_schema_extra={"prefix": "levy_insolvency_fund_"})
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class PayrollMasterDataCreate(BaseModel):
+    key: PayrollKey = Field(alias="Key", description="Payroll key.", json_schema_extra={"prefix": "key_"})
+    tax_data: Optional[PayrollTaxData] = Field(default=None, alias="Steuerdaten", description="Tax data block.", json_schema_extra={"prefix": "tax_data_"})
+    activity: Optional[PayrollActivity] = Field(default=None, alias="Taetigkeit", description="Activity block.", json_schema_extra={"prefix": "activity_"})
+    social_insurance: Optional[PayrollSocialInsurance] = Field(default=None, alias="Sozialversicherung", description="Social insurance block.", json_schema_extra={"prefix": "social_insurance_"})
+    levy: Optional[PayrollLevy] = Field(default=None, alias="Umlage", description="Levy block.", json_schema_extra={"prefix": "levy_"})
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class PayrollMasterDataGet(BrynQPanderaDataFrameModel):
+    """
+    Pandera schema for payroll master data (Grunddaten) records.
+    """
+
+    # Base identifiers
+    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="Key empty flag.")
+
+    # Tax data
+    tax_by_class: Optional[Series[bool]] = pa.Field(alias="Steuerdaten__BesteuerungNachSteuerklasse", coerce=True, nullable=True, description="Tax based on class flag.")
+    last_registration: Optional[Series[pd.StringDtype]] = pa.Field(alias="Steuerdaten__LetzteAnmeldung", coerce=True, nullable=True, description="Last registration date.")
+    elstam_status_id: Optional[Series[pd.StringDtype]] = pa.Field(alias="Steuerdaten__ElstamStatusId", coerce=True, nullable=True, description="ELStAM status id.")
+    elstam_status_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="Steuerdaten__ElstamStatusText", coerce=True, nullable=True, description="ELStAM status text.")
+    employment_type_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Steuerdaten__Beschaeftigungsart__Id", coerce=True, nullable=True, description="Employment type id.")
+    employment_type_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="Steuerdaten__Beschaeftigungsart__Text", coerce=True, nullable=True, description="Employment type text.")
+    tax_class: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Steuerdaten__Steuerklasse", coerce=True, nullable=True, description="Tax class.")
+    church_tax_flat: Optional[Series[bool]] = pa.Field(alias="Steuerdaten__PauschaleKirchensteuer", coerce=True, nullable=True, description="Flat church tax flag.")
+    church_tax_cap: Optional[Series[bool]] = pa.Field(alias="Steuerdaten__KirchensteuerKappung", coerce=True, nullable=True, description="Church tax cap flag.")
+    tax_factor: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuerdaten__Faktor", coerce=True, nullable=True, description="Tax factor.")
+    child_allowance: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuerdaten__Kinderfreibetrag", coerce=True, nullable=True, description="Child allowance.")
+    religion_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Steuerdaten__Konfession__Id", coerce=True, nullable=True, description="Religion id.")
+    religion_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="Steuerdaten__Konfession__Text", coerce=True, nullable=True, description="Religion text.")
+    spouse_religion_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Steuerdaten__KonfessionEhegatte__Id", coerce=True, nullable=True, description="Spouse religion id.")
+    spouse_religion_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="Steuerdaten__KonfessionEhegatte__Text", coerce=True, nullable=True, description="Spouse religion text.")
+    allowance_year: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuerdaten__FreibetragJahr", coerce=True, nullable=True, description="Allowance per year.")
+    allowance_month: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuerdaten__FreibetragMonat", coerce=True, nullable=True, description="Allowance per month.")
+    addback_year: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuerdaten__HinzurechungsbetragJahr", coerce=True, nullable=True, description="Add-back amount year.")
+    addback_month: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuerdaten__HinzurechungsbetragMonat", coerce=True, nullable=True, description="Add-back amount month.")
+    income_tax_equalization: Optional[Series[bool]] = pa.Field(alias="Steuerdaten__Lohnsteuerjahresausgleich", coerce=True, nullable=True, description="Income tax equalization flag.")
+    clawback_tax: Optional[Series[bool]] = pa.Field(alias="Steuerdaten__Nachversteuerung", coerce=True, nullable=True, description="Clawback tax flag.")
+    energy_bonus_claim: Optional[Series[bool]] = pa.Field(alias="Steuerdaten__AnspruchAufEnergiepreispauschale", coerce=True, nullable=True, description="Energy bonus eligibility.")
+    chamber_fee: Optional[Series[bool]] = pa.Field(alias="Steuerdaten__KammerbeitragBerechnen", coerce=True, nullable=True, description="Chamber fee flag.")
+    company_state_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Steuerdaten__BundeslandBetrieb__Id", coerce=True, nullable=True, description="Company federal state id.")
+    company_state_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="Steuerdaten__BundeslandBetrieb__Text", coerce=True, nullable=True, description="Company federal state text.")
+
+    # Activity data
+    employee_group_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Taetigkeit__Personengruppenschluessel__Id", coerce=True, nullable=True, description="Employee group id.")
+    employee_group_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="Taetigkeit__Personengruppenschluessel__Text", coerce=True, nullable=True, description="Employee group text.")
+    multi_employed: Optional[Series[bool]] = pa.Field(alias="Taetigkeit__Mehrfachbeschaeftigt", coerce=True, nullable=True, description="Multiple employment flag.")
+    status_flag_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Taetigkeit__Statuskennzeichen__Id", coerce=True, nullable=True, description="Status flag id.")
+    status_flag_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="Taetigkeit__Statuskennzeichen__Text", coerce=True, nullable=True, description="Status flag text.")
+    education_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Taetigkeit__Ausbildung__Id", coerce=True, nullable=True, description="Education id.")
+    education_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="Taetigkeit__Ausbildung__Text", coerce=True, nullable=True, description="Education text.")
+    contract_form_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Taetigkeit__Vertragsform__Id", coerce=True, nullable=True, description="Contract form id.")
+    contract_form_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="Taetigkeit__Vertragsform__Text", coerce=True, nullable=True, description="Contract form text.")
+    occupation_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Taetigkeit__Beschaeftigung__Id", coerce=True, nullable=True, description="Occupation id.")
+    occupation_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="Taetigkeit__Beschaeftigung__Text", coerce=True, nullable=True, description="Occupation text.")
+    leasing_indicator: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Taetigkeit__Leiharbeit", coerce=True, nullable=True, description="Leasing indicator.")
+    special_case_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Taetigkeit__Besonderheit__Id", coerce=True, nullable=True, description="Special case id.")
+    special_case_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="Taetigkeit__Besonderheit__Text", coerce=True, nullable=True, description="Special case text.")
+    occupation_key: Optional[Series[pd.StringDtype]] = pa.Field(alias="Taetigkeit__Taetigkeitsschluessel", coerce=True, nullable=True, description="Occupation key.")
+    occupation_key_2010: Optional[Series[pd.StringDtype]] = pa.Field(alias="Taetigkeit__Taetigkeitsschluessel2010", coerce=True, nullable=True, description="Occupation key 2010.")
+
+    # Social insurance
+    social_insurance_key: Optional[Series[pd.StringDtype]] = pa.Field(alias="Sozialversicherung__SVSchluessel", coerce=True, nullable=True, description="Social insurance key.")
+    health_fund_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Sozialversicherung__Krankenkasse__Id", coerce=True, nullable=True, description="Health fund id.")
+    health_fund_name: Optional[Series[pd.StringDtype]] = pa.Field(alias="Sozialversicherung__Krankenkasse__Name", coerce=True, nullable=True, description="Health fund name.")
+    health_fund_type: Optional[Series[pd.StringDtype]] = pa.Field(alias="Sozialversicherung__Krankenkasse__Kassenart", coerce=True, nullable=True, description="Health fund type.")
+    mini_job_health_fund_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Sozialversicherung__KrankenkasseMinijobber__Id", coerce=True, nullable=True, description="Mini-job health fund id.")
+    mini_job_health_fund_name: Optional[Series[pd.StringDtype]] = pa.Field(alias="Sozialversicherung__KrankenkasseMinijobber__Name", coerce=True, nullable=True, description="Mini-job health fund name.")
+    mini_job_insurance_type: Optional[Series[pd.StringDtype]] = pa.Field(alias="Sozialversicherung__ArtDerVersicherungMinijobber", coerce=True, nullable=True, description="Mini-job insurance type.")
+    insurance_scheme: Optional[Series[pd.StringDtype]] = pa.Field(alias="Sozialversicherung__Krankenversicherung", coerce=True, nullable=True, description="Health insurance scheme.")
+    pension_insurance: Optional[Series[pd.StringDtype]] = pa.Field(alias="Sozialversicherung__Rentenversicherung", coerce=True, nullable=True, description="Pension insurance info.")
+    employee_health_share: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__ArbeitnehmeranteilKrankenversicherung", coerce=True, nullable=True, description="Employee health contribution.")
+    employer_health_share: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__ArbeitgeberanteilKrankenversicherung", coerce=True, nullable=True, description="Employer health contribution.")
+    employee_pension_share: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__ArbeitnehmeranteilRentenversicherung", coerce=True, nullable=True, description="Employee pension contribution.")
+    employer_pension_share: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__ArbeitgeberanteilRentenversicherung", coerce=True, nullable=True, description="Employer pension contribution.")
+    children_count_pv_discount: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Sozialversicherung__AnzahlKinderPVAbschlag", coerce=True, nullable=True, description="Children count for nursing care discount.")
+
+    # Levy data
+    levy_mode: Optional[Series[pd.StringDtype]] = pa.Field(alias="Umlage__AbfuehrungUmlage", coerce=True, nullable=True, description="Levy deduction mode.")
+    levy_fund_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Umlage__UmlageKasse__Id", coerce=True, nullable=True, description="Levy fund id.")
+    levy_fund_name: Optional[Series[pd.StringDtype]] = pa.Field(alias="Umlage__UmlageKasse__Name", coerce=True, nullable=True, description="Levy fund name.")
+    insolvency_levy: Optional[Series[bool]] = pa.Field(alias="Umlage__AbfuehrungInsolvenzgeldumlage", coerce=True, nullable=True, description="Insolvency levy flag.")
+    insolvency_fund_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Umlage__InsolvenzgeldumlageKasse__Id", coerce=True, nullable=True, description="Insolvency fund id.")
+    insolvency_fund_name: Optional[Series[pd.StringDtype]] = pa.Field(alias="Umlage__InsolvenzgeldumlageKasse__Name", coerce=True, nullable=True, description="Insolvency fund name.")
+
+    # Pension data
+    pension_type_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Rente__Rentenart__Id", coerce=True, nullable=True, description="Pension type id.")
+    pension_type_text: Optional[Series[pd.StringDtype]] = pa.Field(alias="Rente__Rentenart__Text", coerce=True, nullable=True, description="Pension type text.")
+    waive_pension_exemption: Optional[Series[bool]] = pa.Field(alias="Rente__VerzichtRVFreiheit", coerce=True, nullable=True, description="Waiver of pension exemption flag.")
+    waiver_submitted_at: Optional[Series[pd.StringDtype]] = pa.Field(alias="Rente__RVFreiheitVerzichtserklAm", coerce=True, nullable=True, description="Waiver submission date.")
+    waiver_valid_from: Optional[Series[pd.StringDtype]] = pa.Field(alias="Rente__RVFreiheitVerzichtserklGueltigAb", coerce=True, nullable=True, description="Waiver valid from date.")
+
+    class _Annotation:
+        primary_key = "combined_key"
+
+    class Config:
+        coerce = True
+        strict = "filter"
+
+
+class PayrollGet(BrynQPanderaDataFrameModel):
+    """
+    Pandera schema for payroll (abrechnungsdaten) run results.
+    """
+
+    company_id: Series[pd.Int64Dtype] = pa.Field(alias="company_id", coerce=True, nullable=False, description="Company id.")
+    employee_number: Series[pd.Int64Dtype] = pa.Field(alias="employee_number", coerce=True, nullable=False, description="Employee number.")
+    combined_key: Series[pd.StringDtype] = pa.Field(alias="combined_key", coerce=True, nullable=False, description="Composite key (company/employee/date).")
+    source_date: Series[pd.StringDtype] = pa.Field(alias="source_date", coerce=True, nullable=False, description="Payroll reference date.")
+
+    gross_amount: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Brutto", coerce=True, nullable=True, description="Gross pay.")
+    statutory_deductions: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="GesetzlicheAbzuege", coerce=True, nullable=True, description="Statutory deductions.")
+    net_amount: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Netto", coerce=True, nullable=True, description="Net pay.")
+    additional_allowances: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="ZusaetzlicheBeAbzuege", coerce=True, nullable=True, description="Additional allowances/deductions.")
+    non_cash_benefits: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sachbezug", coerce=True, nullable=True, description="Non-cash benefits.")
+    payout_amount: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Auszahlung", coerce=True, nullable=True, description="Final payout.")
+
+    tax_days: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Steuer__Tage", coerce=True, nullable=True, description="Tax-relevant days.")
+    tax_running_gross: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuer__LaufenderBezug__Brutto", coerce=True, nullable=True, description="Running payroll gross.")
+    tax_running_income_tax: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuer__LaufenderBezug__Lohnsteuer", coerce=True, nullable=True, description="Income tax for running payroll.")
+    tax_running_solidarity: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuer__LaufenderBezug__Solizuschlag", coerce=True, nullable=True, description="Solidarity surcharge for running payroll.")
+    tax_running_church: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuer__LaufenderBezug__Kirchensteuer", coerce=True, nullable=True, description="Church tax for running payroll.")
+
+    tax_misc_gross: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuer__SonstigerBezug__Brutto", coerce=True, nullable=True, description="Miscellaneous gross pay.")
+    tax_misc_income_tax: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuer__SonstigerBezug__Lohnsteuer", coerce=True, nullable=True, description="Misc income tax.")
+    tax_misc_solidarity: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuer__SonstigerBezug__Solizuschlag", coerce=True, nullable=True, description="Misc solidarity surcharge.")
+    tax_misc_church: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuer__SonstigerBezug__Kirchensteuer", coerce=True, nullable=True, description="Misc church tax.")
+
+    tax_flat_employee_income_tax: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuer__Pauschalsteuer__Arbeitnehmer__Lohnsteuer", coerce=True, nullable=True, description="Flat employee income tax.")
+    tax_flat_employee_solidarity: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuer__Pauschalsteuer__Arbeitnehmer__Solizuschlag", coerce=True, nullable=True, description="Flat employee solidarity surcharge.")
+    tax_flat_employee_church: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuer__Pauschalsteuer__Arbeitnehmer__Kirchensteuer", coerce=True, nullable=True, description="Flat employee church tax.")
+    tax_flat_employer_income_tax: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuer__Pauschalsteuer__Arbeitgeber__Lohnsteuer", coerce=True, nullable=True, description="Flat employer income tax.")
+    tax_flat_employer_solidarity: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuer__Pauschalsteuer__Arbeitgeber__Solizuschlag", coerce=True, nullable=True, description="Flat employer solidarity surcharge.")
+    tax_flat_employer_church: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Steuer__Pauschalsteuer__Arbeitgeber__Kirchensteuer", coerce=True, nullable=True, description="Flat employer church tax.")
+
+    social_days: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="Sozialversicherung__Tage", coerce=True, nullable=True, description="Social insurance days.")
+    social_running_gross: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__LaufenderBezug__Brutto", coerce=True, nullable=True, description="Running social insurance gross.")
+
+    health_gross: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__LaufenderBezug__Krankenversicherung__Brutto", coerce=True, nullable=True, description="Health insurance gross.")
+    health_employee: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__LaufenderBezug__Krankenversicherung__Arbeitnehmer", coerce=True, nullable=True, description="Employee health contribution.")
+    health_employer: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__LaufenderBezug__Krankenversicherung__Arbeitgeber", coerce=True, nullable=True, description="Employer health contribution.")
+
+    pension_gross: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__LaufenderBezug__Rentenversicherung__Brutto", coerce=True, nullable=True, description="Pension insurance gross.")
+    pension_employee: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__LaufenderBezug__Rentenversicherung__Arbeitnehmer", coerce=True, nullable=True, description="Employee pension contribution.")
+    pension_employer: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__LaufenderBezug__Rentenversicherung__Arbeitgeber", coerce=True, nullable=True, description="Employer pension contribution.")
+
+    unemployment_employee: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__LaufenderBezug__Arbeitslosenversicherung__Arbeitnehmer", coerce=True, nullable=True, description="Employee unemployment insurance.")
+    unemployment_employer: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__LaufenderBezug__Arbeitslosenversicherung__Arbeitgeber", coerce=True, nullable=True, description="Employer unemployment insurance.")
+
+    care_employee: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__LaufenderBezug__Pflegeversicherung__Arbeitnehmer", coerce=True, nullable=True, description="Employee care insurance.")
+    care_employer: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__LaufenderBezug__Pflegeversicherung__Arbeitgeber", coerce=True, nullable=True, description="Employer care insurance.")
+
+    lump_sum_gross: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__EimaligeZuwendung__Brutto", coerce=True, nullable=True, description="One-time bonus gross.")
+    lump_sum_health_employee: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__EimaligeZuwendung__Krankenversicherung__Arbeitnehmer", coerce=True, nullable=True, description="One-time health employee share.")
+    lump_sum_health_employer: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__EimaligeZuwendung__Krankenversicherung__Arbeitgeber", coerce=True, nullable=True, description="One-time health employer share.")
+    lump_sum_pension_employee: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__EimaligeZuwendung__Rentenversicherung__Arbeitnehmer", coerce=True, nullable=True, description="One-time pension employee share.")
+    lump_sum_pension_employer: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__EimaligeZuwendung__Rentenversicherung__Arbeitgeber", coerce=True, nullable=True, description="One-time pension employer share.")
+    lump_sum_unemployment_employee: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__EimaligeZuwendung__Arbeitslosenversicherung__Arbeitnehmer", coerce=True, nullable=True, description="One-time unemployment employee share.")
+    lump_sum_unemployment_employer: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__EimaligeZuwendung__Arbeitslosenversicherung__Arbeitgeber", coerce=True, nullable=True, description="One-time unemployment employer share.")
+    lump_sum_care_employee: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__EimaligeZuwendung__Pflegeversicherung__Arbeitnehmer", coerce=True, nullable=True, description="One-time care employee share.")
+    lump_sum_care_employer: Optional[Series[pd.Float64Dtype]] = pa.Field(alias="Sozialversicherung__EimaligeZuwendung__Pflegeversicherung__Arbeitgeber", coerce=True, nullable=True, description="One-time care employer share.")
+
+    class _Annotation:
+        primary_key = "combined_key"
+
+    class Config:
+        coerce = True
+        strict = "filter"

brynq_sdk_sage_germany/schemas/payslips.py

@@ -0,0 +1,34 @@
+"""
+Schemas for Sage Germany payslip metadata payloads.
+"""
+
+from typing import Optional
+
+import pandas as pd
+import pandera as pa
+from pandera.typing import Series
+
+from brynq_sdk_functions import BrynQPanderaDataFrameModel
+
+
+class PayslipsGet(BrynQPanderaDataFrameModel):
+    """Pandera schema for payslip (Verdienstbescheinigung) listings."""
+
+    document_id: Series[pd.Int64Dtype] = pa.Field(alias="ID", coerce=True, nullable=False, description="Document identifier.")
+    company_id: Series[pd.Int64Dtype] = pa.Field(alias="MdNr", coerce=True, nullable=False, description="Company id.")
+    employee_number: Series[pd.Int64Dtype] = pa.Field(alias="AnNr", coerce=True, nullable=False, description="Employee number.")
+    template_id: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="TemplateID", coerce=True, nullable=True, description="Template identifier.")
+    report_period: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="RptPeriode", coerce=True, nullable=True, description="Reported period.")
+    correction_period: Optional[Series[pd.Int64Dtype]] = pa.Field(alias="KoPeriode", coerce=True, nullable=True, description="Correction period.")
+    document_name: Optional[Series[pd.StringDtype]] = pa.Field(alias="Name", coerce=True, nullable=True, description="Document name.")
+    released: Optional[Series[bool]] = pa.Field(alias="Released", coerce=True, nullable=True, description="Release flag.")
+    created_on: Optional[Series[pd.StringDtype]] = pa.Field(alias="CreatedOn", coerce=True, nullable=True, description="Creation timestamp.")
+    sbc_document_id: Optional[Series[pd.StringDtype]] = pa.Field(alias="SbcDocumentId", coerce=True, nullable=True, description="SBC document identifier.")
+    to_be_deleted: Optional[Series[bool]] = pa.Field(alias="ToBeDeleted", coerce=True, nullable=True, description="Deletion flag.")
+
+    class _Annotation:
+        primary_key = "document_id"
+
+    class Config:
+        coerce = True
+        strict = "filter"