brynq-sdk-zenegy 1.3.7__py3-none-any.whl → 1.3.10__py3-none-any.whl

brynq_sdk_zenegy/employees.py

@@ -1,21 +1,25 @@
 # Generated endpoint class for tag: Employees
+from typing import Any, Dict, List, Tuple
+from uuid import UUID
+
 import pandas as pd
 import requests
-from uuid import UUID
+
 from brynq_sdk_functions import Functions
 
-from .schemas.employees import (EmployeeCreate,
-                                EmployeeUpdate,
-                                EmployeesGet,
-                                EmployeesGetById,
-                                EmployeeEmploymentDataUpdate,
-                                EmployeeEmploymentUpdate,
-                                EmployeeAdditionalUpdate,
-                                StartSaldo,
-                                EmployeePatch)
 from .paychecks import PayChecks
 from .pensions import Pensions
-from typing import Dict, Any, Tuple, List
+from .schemas.employees import (
+    EmployeeAdditionalUpdate,
+    EmployeeCreate,
+    EmployeeEmploymentDataUpdate,
+    EmployeeEmploymentUpdate,
+    EmployeePatch,
+    EmployeesGet,
+    EmployeesGetById,
+    EmployeeUpdate,
+    StartSaldo,
+)
 
 
 class Employees:
@@ -282,7 +286,7 @@ class Employees:
         Single entry point for patching employees using a flat data dictionary.
         Flat keys may include prefixes for nested fields using a single underscore '_',
         e.g., 'start_saldo_start_g_days', 'language_name'. All generated operations
-        are sent in ONE PATCH request as a JSON array per endpoint capability.
+        are grouped into one or more PATCH requests to avoid all-or-none failures.
 
         Args:
             employee_uid (UUID): The employee uid
@@ -296,41 +300,122 @@ class Employees:
             if not op:
                 raise ValueError("Patch operation 'op' must be provided")
 
-            operations = self.build_patch_operations(data=data, op=op)
+            operation_batches = self.build_patch_operation_batches(data=data, op=op)
+            if not operation_batches:
+                raise ValueError("No valid fields to patch")
+
             endpoint = f"{self.endpoint}/{employee_uid}".lstrip('/')
-            response = self.zenegy.patch(endpoint=endpoint, json=operations)
-            self.zenegy.raise_for_status_with_details(response)
-            return response
+            last_response = None
+            for operations in operation_batches:
+                response = self.zenegy.patch(endpoint=endpoint, json=operations)
+                self.zenegy.raise_for_status_with_details(response)
+                last_response = response
+            return last_response
         except Exception as e:
             raise Exception(f"Failed to patch employee: {str(e)}")
 
 
-    def build_patch_operations(self, data: Dict[str, Any], op: str = "replace") -> List[Dict[str, Any]]:
+    def build_patch_operation_batches(self, data: Dict[str, Any], op: str = "replace") -> List[List[Dict[str, Any]]]:
         """
-        Build JSON Patch operations from a flat employee data dictionary using
-        the EmployeePatch flat schema (aliases map directly to JSON Patch paths).
+        Build grouped JSON Patch operations from a flat employee data dictionary.
+        Grouping reduces validation failures when certain fields must be updated together.
 
         Args:
             data (Dict[str, Any]): Flat data with pythonic keys (e.g., name, email, start_g_days)
             op (str): JSON Patch op. Defaults to "replace".
 
         Returns:
-            List[Dict[str, Any]]: JSON Patch operations
+            List[List[Dict[str, Any]]]: Batches of JSON Patch operations
         """
         if not isinstance(data, dict):
             raise ValueError("data must be a dictionary")
         if not op:
             raise ValueError("Patch operation 'op' must be provided")
 
-        # Validate against flat schema and dump using alias names
-        validated = EmployeePatch(**data)
-        alias_dump: Dict[str, Any] = validated.model_dump(by_alias=True, mode='json', exclude_none=True, exclude_unset=True)
-
-        operations: List[Dict[str, Any]] = []
-        for alias_key, value in alias_dump.items():
-            operations.append({
-                "op": op,
-                "path": f"/{alias_key}",
-                "value": value,
-            })
-        return operations
+        def is_blank_value(value: Any) -> bool:
+            if value is None:
+                return True
+            if isinstance(value, str) and value.strip() == "":
+                return True
+            if isinstance(value, str) and value in ("nan", "NaN"):
+                return True
+            try:
+                if pd.isna(value):
+                    return True
+            except Exception:
+                pass
+            return False
+
+        payloads: List[Dict[str, Any]] = []
+        processed_fields: set[str] = set()
+
+        # Address fields must be patched together and cannot be blank
+        address_fields = ["address", "postal_number", "city"]
+        if any(field in data for field in address_fields):
+            address_payload: Dict[str, Any] = {}
+            for field in address_fields:
+                if field in data:
+                    value = data.get(field)
+                    if not is_blank_value(value):
+                        address_payload[field] = value
+                    processed_fields.add(field)
+            if address_payload:
+                payloads.append(address_payload)
+
+        # reg_number and konto_number should be patched together
+        bank_fields = ["reg_number", "konto_number"]
+        if any(field in data for field in bank_fields):
+            bank_payload: Dict[str, Any] = {}
+            for field in bank_fields:
+                if field in data:
+                    bank_payload[field] = data[field]
+                    processed_fields.add(field)
+            if bank_payload:
+                payloads.append(bank_payload)
+
+        # swift should be patched together with iban if provided
+        if "swift" in data:
+            swift_payload: Dict[str, Any] = {"swift": data.get("swift")}
+            processed_fields.add("swift")
+            if "iban" in data:
+                swift_payload["iban"] = data.get("iban")
+                processed_fields.add("iban")
+            payloads.append(swift_payload)
+
+        # department_id and department_uid should be patched together when available
+        if "department_id" in data:
+            dept_payload: Dict[str, Any] = {"department_id": data.get("department_id")}
+            processed_fields.add("department_id")
+            if "department_uid" in data:
+                dept_payload["department_uid"] = data.get("department_uid")
+                processed_fields.add("department_uid")
+            payloads.append(dept_payload)
+
+        # Every other field is sent separately to avoid all-or-none failures
+        for field, value in data.items():
+            if field not in processed_fields:
+                payloads.append({field: value})
+                processed_fields.add(field)
+
+        operation_batches: List[List[Dict[str, Any]]] = []
+        for payload in payloads:
+            validated = EmployeePatch(**payload)
+            alias_dump: Dict[str, Any] = validated.model_dump(
+                by_alias=True,
+                mode='json',
+                exclude_none=True,
+                exclude_unset=True,
+            )
+            if not alias_dump:
+                continue
+            operations: List[Dict[str, Any]] = []
+            for alias_key, value in alias_dump.items():
+                operations.append({
+                    "op": op,
+                    "path": f"/{alias_key}",
+                    "value": value,
+                })
+            if operations:
+                operation_batches.append(operations)
+
+        return operation_batches

brynq_sdk_zenegy/payslips.py

@@ -27,7 +27,7 @@ class Payslips:
             Tuple of (valid_data, invalid_data) DataFrames
         """
         try:
-            endpoint = f"api/companies/{self.zenegy.company_uid}/employees/{employee_uid}/payslips"
+            endpoint = f"api/companies/{self.zenegy.company_uid}/employees/{employee_uid}/payslips/report"
             content = self.zenegy.get(endpoint=endpoint)
 
             # Normalize the response (data field contains the list)

brynq_sdk_zenegy/schemas/employee_pay_checks.py

@@ -9,7 +9,10 @@ from brynq_sdk_zenegy.schemas.company_departments import CompanyDepartmentData
 
 class PaycheckCreate(BaseModel):
     """Schema for creating pay checks."""
+    # Function Parameters
+    employee_uid: UUID = Field(..., description="Employee identifier", alias="employeeUid")
     paycheck_for: Optional[int] = Field(alias="payCheckFor", default=None, description="Target paycheck type/code", example=1)
+
     name: str = Field(..., min_length=0, max_length=128, description="Paycheck item name", example="Bonus")
     unit: Optional[float] = Field(default=None, description="Units for the item", example=10.0)
     payment_per_unit: Optional[float] = Field(alias="paymentPerUnit", default=None, description="Payment per unit", example=150.0)
@@ -30,7 +33,11 @@ class PaycheckCreate(BaseModel):
 
 class PaycheckUpdate(BaseModel):
     """Schema for updating pay checks."""
+    # Function Parameters
+    employee_uid: UUID = Field(..., description="Employee identifier", alias="employeeUid")
+    paycheck_uid: UUID = Field(..., description="Paycheck identifier", alias="paycheckUid")
     paycheck_for: Optional[int] = Field(alias="payCheckFor", default=None, description="Target paycheck type/code", example=1)
+
     name: str = Field(..., min_length=0, max_length=128, description="Paycheck item name", example="Bonus")
     unit: Optional[float] = Field(default=None, description="Units for the item", example=10.0)
     payment_per_unit: Optional[float] = Field(alias="paymentPerUnit", default=None, description="Payment per unit", example=150.0)

brynq_sdk_zenegy/schemas/employee_pensions.py

@@ -22,10 +22,13 @@ class Pension(BaseModel):
         populate_by_name = True
 
 class EmployeePensionCreate(BaseModel):
+    # Function Parameters
+    employee_uid: UUID = Field(..., description="Employee identifier", alias="employeeUid")
     pension_uid: Optional[UUID] = Field(
         example="00000000-0000-0000-0000-000000000000", alias="pensionUid", default=None,
         description="Target pension UID (if updating an existing pension)"
     )
+
     pension: Pension = Field(
         default=None,
         description="Pension master data (name, type, PBS codes)",

{brynq_sdk_zenegy-1.3.7.dist-info → brynq_sdk_zenegy-1.3.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: brynq_sdk_zenegy
-Version: 1.3.7
+Version: 1.3.10
 Summary: Zenegy wrapper from BrynQ
 Author: BrynQ
 Author-email: support@brynq.com

{brynq_sdk_zenegy-1.3.7.dist-info → brynq_sdk_zenegy-1.3.10.dist-info}/RECORD

@@ -4,12 +4,12 @@ brynq_sdk_zenegy/companies.py,sha256=DbNx4E-tjqdohbqpPeVrKTWCNCyOa9m7ZIXwuPx4ctU
 brynq_sdk_zenegy/cost_center.py,sha256=zdBSe8KZ683LIeHIXCt5Y9sCY4HcXI_eEcooq3P9jSU,2763
 brynq_sdk_zenegy/departments.py,sha256=o2G59BkLioyo9_FhwppA_1nurzNf30k6XkkTYDLdsa4,2451
 brynq_sdk_zenegy/employee_documents.py,sha256=xYXukrSd6gqI5UbiupGb5_zrKzOsNeh4FbVippdIpw8,1396
-brynq_sdk_zenegy/employees.py,sha256=buIEIxGjeSq-C8yy1PJcc11CP7YNIHAXjvNj3epKhnY,13650
+brynq_sdk_zenegy/employees.py,sha256=7dKAIe431EwGTP2H9aJJBSMm5EU19yLJjlLE9d9j6n0,16740
 brynq_sdk_zenegy/global_value_sets.py,sha256=2T63dLUvD4mY7L1coXYQD8UttE4m0gKGolH55r_2mmI,10289
 brynq_sdk_zenegy/global_values.py,sha256=RBv33piYctIu95Z022noDFsMhPjSzsaBbyeaU84V2bw,10598
 brynq_sdk_zenegy/paychecks.py,sha256=9kUuFY3jc8vfyYVxqBXDWSVXD_X-FlW693an-CirlTw,4844
 brynq_sdk_zenegy/payroll.py,sha256=gVLBEaMe2Rq3Vt06Gf2KllnGmwt5glNJFFiSylQ4AMs,4921
-brynq_sdk_zenegy/payslips.py,sha256=2Tkb99rMy2uj9rDFWnlzOA4u1NqjfFxyBMt6Tdmw1tU,2210
+brynq_sdk_zenegy/payslips.py,sha256=yqYhREtpO41fO-7C4eGC9a8UO4BqoFTq4cHASUnWPGI,2217
 brynq_sdk_zenegy/pensions.py,sha256=1-IBvs8CzABTCDh_FYjx9nSk4qWQ0e6gXijncWXxgzg,4581
 brynq_sdk_zenegy/supplements_and_deductions_rates.py,sha256=cGVs73SYDFxeIifzvHfKGqzd_SrtxqeG-KFGJdDu2pA,2723
 brynq_sdk_zenegy/zenegy.py,sha256=XbRm-Wj8jC4fVNmZfbOj-Rk0d6cFoPDeQYGz_MSXFsU,7745
@@ -19,15 +19,15 @@ brynq_sdk_zenegy/schemas/companies.py,sha256=8HAs1Y6E1lj54P8bN_HgEt_WDrABm7F1_pe
 brynq_sdk_zenegy/schemas/company_cost_centers.py,sha256=PG1POeqMDVSUg_NE_ICNOiBy7hTlO1f4SGPhvUiNTlc,1896
 brynq_sdk_zenegy/schemas/company_departments.py,sha256=supGcTOp5cKq10OFzt82zdo5ZJjzd2h_A6W33qMNiOg,11449
 brynq_sdk_zenegy/schemas/employee_documents.py,sha256=eGVDkx48GFTQ31C1uKZ9rC2fXD-_-KqFu8azNU2rskY,1871
-brynq_sdk_zenegy/schemas/employee_pay_checks.py,sha256=sRsx8BGo3Roi3WcdOKEujTfeoVVX6Ihq3QBtdPKADsA,20985
-brynq_sdk_zenegy/schemas/employee_pensions.py,sha256=MrpNRaqlaX4B3IBBufwFI7fD1yNqK5W0SQ_acRofIcY,9231
+brynq_sdk_zenegy/schemas/employee_pay_checks.py,sha256=gXZ7A9t35Pp3rkcG5dykkmv3VLPx5Bb70vTovW0h_Rg,21315
+brynq_sdk_zenegy/schemas/employee_pensions.py,sha256=rbVezcnD4vSJPDna7EZgiBVfb0ha272dS9iOXnRUHe8,9350
 brynq_sdk_zenegy/schemas/employees.py,sha256=Fb5S7LOZiZJ6FzMHPdR_yh-Qn1yWSn_rIc173EShXLQ,225480
 brynq_sdk_zenegy/schemas/global_value_sets.py,sha256=YEZm-im-22VbTcDpiBwNLcJgT7UAqkBUN3I961ffd8Y,12912
 brynq_sdk_zenegy/schemas/global_values.py,sha256=cdfOewCPiMIJynWaxml-GAmY44qR5SQwGYgijD-f7fg,34270
 brynq_sdk_zenegy/schemas/payrolls.py,sha256=DLCDpm5jSBeC4KhdRHVVbne8x3zdbAKwRM3MOChWHBM,16514
 brynq_sdk_zenegy/schemas/payslips.py,sha256=kgRuEky2B2huVtag7OZzaXOX_hc2_cZMOS84DyZCZvo,2466
 brynq_sdk_zenegy/schemas/supplements_and_deductions_rates.py,sha256=Ig4V27KhJrt_HqF1mOrr0yb0KgYxiYqs1A3k3AcQ-Ng,16928
-brynq_sdk_zenegy-1.3.7.dist-info/METADATA,sha256=wBoaz8xh2mtlDRsJPAxWnqrf6m1tkC7iQd4DHMSZY-c,341
-brynq_sdk_zenegy-1.3.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-brynq_sdk_zenegy-1.3.7.dist-info/top_level.txt,sha256=quyHxFQMtqHujnE15mGvieYNp-0MR1aLx0ns5VYYWOo,17
-brynq_sdk_zenegy-1.3.7.dist-info/RECORD,,
+brynq_sdk_zenegy-1.3.10.dist-info/METADATA,sha256=LNd-kTiWkxod-_znMdHe1aVFvBUw6wmwVuHocClFKZo,342
+brynq_sdk_zenegy-1.3.10.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+brynq_sdk_zenegy-1.3.10.dist-info/top_level.txt,sha256=quyHxFQMtqHujnE15mGvieYNp-0MR1aLx0ns5VYYWOo,17
+brynq_sdk_zenegy-1.3.10.dist-info/RECORD,,

{brynq_sdk_zenegy-1.3.7.dist-info → brynq_sdk_zenegy-1.3.10.dist-info}/WHEEL

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