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

brynq_sdk_sage_germany/vacation_account.py

@@ -0,0 +1,70 @@
+"""
+Vacation account endpoint implementations for Sage Germany.
+"""
+
+from __future__ import annotations
+
+from datetime import datetime, timezone
+from typing import TYPE_CHECKING, Optional, Tuple
+
+import pandas as pd
+from brynq_sdk_functions import Functions
+
+from .schemas.vacation_account import VacationAccountGet
+
+if TYPE_CHECKING:
+    from .employees import Employees
+
+
+class VacationAccount:
+    """
+    Handles vacation balance operations scoped to employees.
+    """
+
+    def __init__(self, sage) -> None:
+        self.sage = sage
+        self.base_url = "/employeenew/person/urlaubskonto"
+
+    def get(
+        self,
+        date: Optional[str] = None,
+        company_id: Optional[int] = None,
+        employee_number: Optional[int] = None,
+    ) -> Tuple[pd.DataFrame, pd.DataFrame]:
+        """
+        Retrieve vacation account data for a specific employee or all employees.
+        """
+        try:
+            if company_id is not None and employee_number is not None:
+                employee_keys = [{"MdNr": company_id, "AnNr": employee_number}]
+            else:
+                employee_keys = self.sage._employee_search()
+
+            if not employee_keys:
+                return pd.DataFrame(), pd.DataFrame()
+
+            vacation_records = []
+            effective_date = date or datetime.now(timezone.utc).strftime("%Y-%m-%dT00:00:00")
+
+            for key in employee_keys:
+                response = self.sage.get(
+                    path=self.base_url,
+                    params={"MdNr": key["MdNr"], "AnNr": key["AnNr"], "date": effective_date},
+                )
+                response.raise_for_status()
+                payload = response.json()
+                if isinstance(payload, dict):
+                    vacation_records.append(payload)
+
+            if not vacation_records:
+                return pd.DataFrame(), pd.DataFrame()
+
+            dataframe = pd.json_normalize(vacation_records, sep="__")
+
+            valid_data, invalid_data = Functions.validate_data(
+                df=dataframe,
+                schema=VacationAccountGet,
+            )
+            return valid_data, invalid_data
+        except Exception as exc:
+            raise RuntimeError("Failed to retrieve vacation account data.") from exc

brynq_sdk_sage_germany/work_hours.py

@@ -0,0 +1,97 @@
+"""
+Work hours endpoint implementations for Sage Germany.
+"""
+
+from __future__ import annotations
+
+from datetime import datetime, timezone
+from typing import TYPE_CHECKING, Any, Dict, Optional, Tuple
+
+import pandas as pd
+from brynq_sdk_functions import Functions
+
+from .schemas.work_hours import WorkHoursCreate, WorkHoursGet
+
+if TYPE_CHECKING:
+    from .employees import Employees
+
+
+class WorkHours:
+    """
+    Handles work-hours-related operations scoped to employees.
+    """
+
+    def __init__(self, sage) -> None:
+        self.sage = sage
+        self.base_url = "/employeenew/person/arbeitszeiten"
+
+    def get(
+        self,
+        date: Optional[str] = None,
+        company_id: Optional[int] = None,
+        employee_number: Optional[int] = None,
+    ) -> Tuple[pd.DataFrame, pd.DataFrame]:
+        """
+        Retrieve work hours for a single employee or all employees.
+        """
+        try:
+            if company_id is not None and employee_number is not None:
+                employee_keys = [{"MdNr": company_id, "AnNr": employee_number}]
+            else:
+                employee_keys = self.sage._employee_search()
+
+            if not employee_keys:
+                return pd.DataFrame(), pd.DataFrame()
+
+            work_hours_records = []
+            effective_date = date or datetime.now(timezone.utc).strftime("%Y-%m-%dT00:00:00")
+
+            for key in employee_keys:
+                response = self.sage.get(
+                    path=self.base_url,
+                    params={"MdNr": key["MdNr"], "AnNr": key["AnNr"], "date": effective_date},
+                )
+                response.raise_for_status()
+                payload = response.json()
+                if isinstance(payload, dict):
+                    work_hours_records.append(payload)
+
+            if not work_hours_records:
+                return pd.DataFrame(), pd.DataFrame()
+
+            dataframe = pd.json_normalize(work_hours_records, sep="__").copy()
+            # Create combined key manually as it's not present in the payload
+            if {"MdNr", "AnNr"}.issubset(dataframe.columns):
+                mdnr_numeric = pd.to_numeric(dataframe["MdNr"], errors="coerce").astype("Int64")
+                annr_numeric = pd.to_numeric(dataframe["AnNr"], errors="coerce").astype("Int64")
+                dataframe["combined_key"] = pd.NA
+                valid_mask = mdnr_numeric.notna() & annr_numeric.notna()
+                dataframe.loc[valid_mask, "combined_key"] = (
+                    mdnr_numeric[valid_mask].astype("string")
+                    + "_"
+                    + annr_numeric[valid_mask].astype("string")
+                )
+
+            valid_data, invalid_data = Functions.validate_data(
+                df=dataframe,
+                schema=WorkHoursGet,
+            )
+            return valid_data, invalid_data
+        except Exception as exc:
+            raise RuntimeError("Failed to retrieve work hours data.") from exc
+
+    def create(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Create or update work hours (Arbeitszeiten) for an employee.
+        """
+        try:
+            validated_data = WorkHoursCreate(**data)
+            payload = validated_data.model_dump(by_alias=True, exclude_none=True, mode="json")
+            response = self.sage.post(
+                path=self.base_url,
+                body=payload,
+            )
+            response.raise_for_status()
+            return response
+        except Exception as exc:
+            raise RuntimeError("Failed to create Sage Germany work hours record.") from exc

brynq_sdk_sage_germany-1.0.0.dist-info/METADATA

@@ -0,0 +1,21 @@
+Metadata-Version: 2.4
+Name: brynq_sdk_sage_germany
+Version: 1.0.0
+Summary: Sage Germany wrapper from BrynQ
+Author: BrynQ
+Author-email: support@brynq.com
+License: BrynQ License
+Requires-Dist: brynq-sdk-brynq<5,>=4
+Requires-Dist: brynq-sdk-functions<3,>=2.1.3
+Requires-Dist: pandas<3,>=2
+Requires-Dist: pydantic>=2
+Requires-Dist: requests>=2
+Requires-Dist: pandera>=0.17
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: summary
+
+Sage Germany wrapper from BrynQ

brynq_sdk_sage_germany-1.0.0.dist-info/RECORD

@@ -0,0 +1,31 @@
+brynq_sdk_sage_germany/__init__.py,sha256=6bowHadUQZ678vRftuYv5B15lVWFpPMhnGSzq9V_awk,8815
+brynq_sdk_sage_germany/absences.py,sha256=-9zjnI4QUeIBcg7GzdeGSKjJMn_yig7RnZoGsgbxbts,6252
+brynq_sdk_sage_germany/allowances.py,sha256=6aZe4uJLHcCCHWfkpJ_gth16qNp4AA7jE2pibx69njg,3400
+brynq_sdk_sage_germany/contracts.py,sha256=cqYU_eq4OJBV5PfXKrjtJyXMH2YIxO248b8osSPeii8,4162
+brynq_sdk_sage_germany/cost_centers.py,sha256=wHuo7ytuSHJwqJlyhodAE4aEUByQnr8BWRkjb6oYBjY,3015
+brynq_sdk_sage_germany/employees.py,sha256=Ymt69a6zBllnua_SSLmD3BQYIna36s9AyIqbN4GzJxI,5168
+brynq_sdk_sage_germany/helpers.py,sha256=WmaDg5jd-k2AUpXwqYdbvV9D8QY08jqOvbvBEiJwNr8,14147
+brynq_sdk_sage_germany/organization.py,sha256=JLe3CmowaexzJlW2g3idkOCw0i0tjXA0gvHBOQ9oo9M,3171
+brynq_sdk_sage_germany/payroll.py,sha256=912KNRulXTEH36gO6htjvex1jzIFaqbZtnZwglJp6nM,6235
+brynq_sdk_sage_germany/payslips.py,sha256=gyHIoP9YfI1Xp9vtyH_8L_vU-OPhAWTTWNaT5gVjf8c,3378
+brynq_sdk_sage_germany/salaries.py,sha256=DUS-kurrXmW34KyPnTcpAWuiXuSWVE-Ci8SNVlN5I2Q,3402
+brynq_sdk_sage_germany/start_end_dates.py,sha256=pET99m2VbSLFoIQ0PuyD5xNQGvLLBsCcSjDGO-UNtJI,4125
+brynq_sdk_sage_germany/vacation_account.py,sha256=PiEtD3vJ5ULzBFkoyTZfyTa_5x8bDZpzRwsQIVZ_l1o,2256
+brynq_sdk_sage_germany/work_hours.py,sha256=K3e40pmMDquXet0nlhDZmseeSUJXEXIzAefFXRcvz-c,3570
+brynq_sdk_sage_germany/schemas/__init__.py,sha256=s3f9vKHWVZ5etWE2MnDlKfF2ynmtfTQuqrSjdPNBxFI,1254
+brynq_sdk_sage_germany/schemas/absences.py,sha256=HP90mERkHJcO-N9fthcnp7919ib_7LJQ4Yx0Nw-pewA,31080
+brynq_sdk_sage_germany/schemas/allowances.py,sha256=Avbe7OXu2bYdiu7PZyIZqqKLbEQbiVJCLqPond20B-Y,9253
+brynq_sdk_sage_germany/schemas/cost_centers.py,sha256=XVEvXEMt2BWSQ8CqNw7zYyaJWnIiZN4Gc3vMgRMiO_s,1867
+brynq_sdk_sage_germany/schemas/employees.py,sha256=mNfGUOcDdomo000th8EAXt5NQVUdne7jQjRmi7aFb2Q,32740
+brynq_sdk_sage_germany/schemas/organization.py,sha256=_QQ6f_9G1ikNrA4cm6rO_Salqa2uCXWZpr7IQTSXRLc,13359
+brynq_sdk_sage_germany/schemas/organization_assignment.py,sha256=KbatopHoRLNFA1UawYuez9UJJIwLzZmMgU69mLL_kOo,4689
+brynq_sdk_sage_germany/schemas/payroll.py,sha256=baIPi7WUqTw93i_S0aS8CVz-jeoKHzyRdc29G1WPY5E,33969
+brynq_sdk_sage_germany/schemas/payslips.py,sha256=K0yxUCpILe3mGgmhLDxx15u9FU6o2Gtn6Xg5u4G8Hv8,1970
+brynq_sdk_sage_germany/schemas/salaries.py,sha256=WOr8w6cqTpco46tPlqASpGtf7n6AgYCbN7T3PE-2nPM,9709
+brynq_sdk_sage_germany/schemas/start_end_dates.py,sha256=4hyUV-1p7GK0nHSMVg0z7me6npYAXuQqM7jSLrJrj4Y,7732
+brynq_sdk_sage_germany/schemas/vacation_account.py,sha256=a88SGGzYr2iwX-cW3JrAxgswAGG13Bb1C3Sn6Cn3Avk,13648
+brynq_sdk_sage_germany/schemas/work_hours.py,sha256=NWLnyo5Fo_-jF22jPSpvCofe-dQpY8gISu8RGTYjRl0,7527
+brynq_sdk_sage_germany-1.0.0.dist-info/METADATA,sha256=_MfapzG041837fxCwzAfYxHqckwEFLxANqyOu36ipII,518
+brynq_sdk_sage_germany-1.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+brynq_sdk_sage_germany-1.0.0.dist-info/top_level.txt,sha256=YhZNSFzDucaDPMjEkYY0jShXhMFgX1-JxRuosnHXbB0,23
+brynq_sdk_sage_germany-1.0.0.dist-info/RECORD,,

brynq_sdk_sage_germany-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

brynq_sdk_sage_germany-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+brynq_sdk_sage_germany