brynq-sdk-acerta 1.1.1__py3-none-any.whl

brynq_sdk_acerta/bank_accounts.py

@@ -0,0 +1,90 @@
+from typing import Dict, Any, Optional, Tuple
+import requests
+import pandas as pd
+from brynq_sdk_functions import Functions
+from .schemas.agreement import AgreementRemunerationBankAccountUpdate
+from .schemas.bank_account import AgreementBankAccountsGet
+from typing import TYPE_CHECKING
+if TYPE_CHECKING:
+	from .acerta import Acerta
+
+class BankAccounts:
+	"""Resource class for Employee Bank Accounts (HAL links)."""
+
+	def __init__(self, acerta):
+		self.acerta: Acerta = acerta
+		self.base_uri = "v1"
+
+	def get(self, agreement_id: Optional[str] = None, from_date: Optional[str] = None, until_date: Optional[str] = None, full_segments_only: Optional[bool] = None, accept_language: str = "en") -> Tuple[pd.DataFrame, pd.DataFrame]:
+		"""
+		GET /v3/agreements/{agreementId}/remuneration - derive bank accounts
+
+		Fetches remuneration segments for agreements and returns only the bank account related fields
+		(via methodOfPayment.employeeBankAccounts/employerBankAccounts).
+		"""
+		# Ensure we have agreement ids
+		if not agreement_id and not self.acerta._agreement_ids:
+			self.acerta.agreements.get()
+		agreement_ids = [agreement_id] if agreement_id else self.acerta._agreement_ids
+
+		params = {k: v for k, v in {
+			"fromDate": from_date,
+			"untilDate": until_date,
+			"fullSegmentsOnly": str(full_segments_only).lower() if isinstance(full_segments_only, bool) else full_segments_only,
+		}.items() if v is not None}
+
+		frames = []
+		headers = {"Accept-Language": accept_language} if accept_language else None
+		for agr_id in agreement_ids:
+			request_headers = self.acerta.session.headers.copy()
+			if headers:
+				request_headers.update(headers)
+			response = self.acerta.session.get(
+				url=f"{self.acerta.base_url}/agreement-data-management/v3/agreements/{agr_id}/remuneration",
+				params=params,
+				headers=request_headers,
+				timeout=self.acerta.TIMEOUT,
+			)
+			response.raise_for_status()
+			raw = response.json()
+			df = pd.json_normalize(
+				raw,
+				record_path=["remunerationSegments"],
+				meta=["agreementId"],
+				errors="ignore",
+				sep=".",
+			)
+			frames.append(df)
+
+		combined = pd.concat(frames, ignore_index=True) if frames else pd.DataFrame()
+		return Functions.validate_data(combined, AgreementBankAccountsGet, debug=self.acerta.debug)
+
+	def update(self, agreement_id: str, data: Dict[str, Any]) -> requests.Response:
+		"""
+		PUT /employee-data-management/v3/employees/agreement/{agreementId}/remuneration-bank-account - Agreement Remuneration Bank Account
+
+		Set the bank account for the employee and agreement. This endpoint updates the remuneration
+		bank account associated with a specific agreement.
+
+		Args:
+			agreement_id: Unique identifier of an agreement
+			data: Dictionary with bank account data (iban, bic)
+
+		Returns:
+			requests.Response: Raw response object
+
+		Raises:
+			Exception: If the update fails
+		"""
+		# Validate the data (no nesting required for this simple schema)
+		validated_data = AgreementRemunerationBankAccountUpdate(**data)
+
+		# Make API request
+		response = self.acerta.session.put(
+			url=f"{self.acerta.base_url}/employee-data-management/v3/employees/agreement/{agreement_id}/remuneration-bank-account",
+			json=validated_data.model_dump(by_alias=True, exclude_none=True),
+			timeout=self.acerta.TIMEOUT,
+		)
+		response.raise_for_status()
+
+		return response

brynq_sdk_acerta/code_lists.py

@@ -0,0 +1,264 @@
+from typing import List, Tuple
+import pandas as pd
+import requests
+from brynq_sdk_functions import Functions
+from .schemas.planning import CountryGet, BelgianCityGet
+from enum import Enum
+from typing import List
+from typing import TYPE_CHECKING
+if TYPE_CHECKING:
+	from .acerta import Acerta
+
+class CodeListAttribute(str, Enum):
+		ACE_CountryNisCode = 'ACE_CountryNisCode'
+		ACE_Gender = 'ACE_Gender'
+		ACE_Language = 'ACE_Language'
+		ACE_MaritalStatus = 'ACE_MaritalStatus'
+		ACE_Nationality = 'ACE_Nationality'
+		ACE_OfficialLanguageCode = 'ACE_OfficialLanguageCode'
+		ACE_RelationshipContact = 'ACE_RelationshipContact'
+		B10_AddressType = 'B10_AddressType'
+		B10_EducationalDegree = 'B10_EducationalDegree'
+		B10_LeadershipLevel = 'B10_LeadershipLevel'
+		B11_JointCommittee = 'B11_JointCommittee'
+		B11_PrefixNOSS = 'B11_PrefixNOSS'
+		B11_Qualification = 'B11_Qualification'
+		B11_PayFrequency = 'B11_PayFrequency'
+		B12_ApprenticeType = 'B12_ApprenticeType'
+		B12_CommunityCode = 'B12_CommunityCode'
+		B12_Customized_vacation_pay = 'B12_Customized_vacation_pay'
+		B12_Declaration_withholding_tax = 'B12_Declaration_withholding_tax '
+		B12_DMFA_Risc_labour_accident = 'B12_DMFA_Risc_labour_accident'
+		B12_Duration = 'B12_Duration'
+		B12_EarlyRetirementCode = 'B12_EarlyRetirementCode'
+		B12_EmployeeType = 'B12_EmployeeType'
+		B12_EmployeeTypeDet = 'B12_EmployeeTypeDet'
+		B12_ExemptionWorkPerformance = 'B12_ExemptionWorkPerformance'
+		B12_ExemptPartTimeCreditCode = 'B12_ExemptPartTimeCreditCode'
+		B12_Frequency_transport = 'B12_Frequency_transport'
+		B12_Functioncode = 'B12_Functioncode'
+		B12_HomeworkTransport = 'B12_HomeworkTransport'
+		B12_Involuntary_parttime = 'B12_Involuntary_parttime'
+		B12_Measure = 'B12_Measure'
+		B12_MeasureResumptionWorkCode = 'B12_MeasureResumptionWorkCode'
+		B12_Notion_NOSS = 'B12_Notion_NOSS'
+		B12_NotionDebtorCode = 'B12_NotionDebtorCode'
+		B12_Payment = 'B12_Payment'
+		B12_Reason_end_employment = 'B12_Reason_end_employment'
+		B12_Regularity = 'B12_Regularity'
+		B12_Salary_calculation = 'B12_Salary_calculation'
+		B12_Salary_split = 'B12_Salary_split'
+		B12_SalaryScaleTypeCode = 'B12_SalaryScaleTypeCode'
+		B12_Tariff_period = 'B12_Tariff_period'
+		B12_TimeCredit = 'B12_TimeCredit'
+		B12_TipsCode = 'B12_TipsCode'
+		B12_TipsTypeCode = 'B12_TipsTypeCode'
+		B12_Transport_type = 'B12_Transport_type'
+		B12_Type_of_subscription = 'B12_Type_of_subscription'
+		B12_Type_withholding_tax = 'B12_Type_withholding_tax'
+		B12_TypeAgreement = 'B12_TypeAgreement'
+		B12_WorkscheduleType = 'B12_WorkscheduleType'
+		BA4_BelgianPostalCode = 'BA4_BelgianPostalCode'
+		B12_MeasureNonProfit = 'B12_MeasureNonProfit'
+		B12_FunctionNOSS = 'B12_FunctionNOSS'
+		B12_PensionSystem = 'B12_PensionSystem'
+		B12_NACE = 'B12_NACE'
+		B12_Capelo_PersonnelCategory = 'B12_Capelo_PersonnelCategory'
+		B12_Capelo_Function = 'B12_Capelo_Function'
+		B12_Capelo_InstitutionType = 'B12_Capelo_InstitutionType'
+		B12_Capelo_ServiceType = 'B12_Capelo_ServiceType'
+		B12_SickLeaveReserve = 'B12_SickLeaveReserve'
+		B12_Wage_system = 'B12_Wage_system'
+		B12_Diploma = 'B12_Diploma'
+		B12_ParticularCompetence = 'B12_ParticularCompetence'
+		B12_DistinguishingLetter = 'B12_DistinguishingLetter'
+		B12_ServiceActivity = 'B12_ServiceActivity'
+		B12_StatusHospital = 'B12_StatusHospital'
+		B12_AdditionalKwalification = 'B12_AdditionalKwalification'
+		B12_Specialism = 'B12_Specialism'
+		B12_StaffTypeHospital = 'B12_StaffTypeHospital'
+		B12_FinancingCode = 'B12_FinancingCode'
+		B12_KwalificationEmployee = 'B12_KwalificationEmployee'
+		B12_OccupationalClassMWB = 'B12_OccupationalClassMWB'
+		B12_KwalificationSupervisor = 'B12_KwalificationSupervisor'
+		B12_IntensitySupervision = 'B12_IntensitySupervision'
+		B12_StatusTargetGroup = 'B12_StatusTargetGroup'
+		B12_Regional_recruitment_framework = 'B12_Regional_recruitment_framework'
+		B12_Level = 'B12_Level'
+		B12_ProgWorkResumpType = 'B12_ProgWorkResumpType'
+		B11_VIA = 'B11_VIA'
+		B12_SocialMaribel = 'B12_SocialMaribel'
+		B12_Tax_Statute = 'B12_Tax_Statute'
+		B12_Frontier_worker = 'B12_Frontier_worker'
+		B12_AidZone = 'B12_AidZone'
+		B12_Other_Social_Services = 'B12_Other_Social_Services'
+		B12_Restructuring_difficulties = 'B12_Restructuring_difficulties'
+		B12_Start_Job = 'B12_Start_Job'
+		B12_CareerMeasure = 'B12_CareerMeasure'
+		B12_Employer_recruitment_framework = 'B12_Employer_recruitment_framework'
+		B12_Employee_recruitment_framework = 'B12_Employee_recruitment_framework'
+		B12_IFICFunctionCode = 'B12_IFICFunctionCode'
+		B12_WageCategory = 'B12_WageCategory'
+		B12_RizivFrequencyCode = 'B12_RizivFrequencyCode'
+		B12_RizivCode = 'B12_RizivCode'
+		B12_PercentageCode = 'B12_PercentageCode'
+		B12_Employee_type_2 = 'B12_Employee_type_2'
+		B12_Statute = 'B12_Statute'
+		B12_Employee_type = 'B12_Employee_type'
+		B12_Sort = 'B12_Sort'
+		ACE_YesNoUnknown = 'ACE_YesNoUnknown'
+
+
+class CodeLists:
+	"""Resource class for Code Lists endpoints"""
+
+	def __init__(self, acerta):
+		self.acerta: Acerta = acerta
+		self.base_uri = "v1"
+		self.attributes = CodeListAttribute
+
+	def get_countries(self) -> Tuple[pd.DataFrame, pd.DataFrame]:
+		"""
+		GET /v1/countries - Countries
+
+		Retrieves the list of all countries with their NIS codes and descriptions.
+
+		Returns:
+			Tuple[pd.DataFrame, pd.DataFrame]: (valid_df, invalid_df) after validation
+
+		Raises:
+			Exception: If the retrieval fails
+		"""
+		# Make API request
+		response = self.acerta.session.get(
+			url=f"{self.acerta.base_url}/employee-data-management/v1/countries",
+			timeout=self.acerta.TIMEOUT,
+		)
+		response.raise_for_status()
+		data = response.json()
+
+		# Normalize data
+		if isinstance(data, list):
+			df = pd.json_normalize(data)
+		else:
+			df = pd.DataFrame([data])
+
+		# Validate with schema
+		valid_data, invalid_data = Functions.validate_data(df, CountryGet)
+
+		return valid_data, invalid_data
+
+	def get_belgian_cities(self) -> Tuple[pd.DataFrame, pd.DataFrame]:
+		"""
+		GET /v1/belgian-cities - Belgian Cities
+
+		Retrieves the list of all Belgian cities with their postal codes, names, and NIS codes.
+
+		Returns:
+			Tuple[pd.DataFrame, pd.DataFrame]: (valid_df, invalid_df) after validation
+
+		Raises:
+			Exception: If the retrieval fails
+		"""
+		# Make API request
+		response = self.acerta.session.get(
+			url=f"{self.acerta.base_url}/employee-data-management/v1/belgian-cities",
+			timeout=self.acerta.TIMEOUT,
+		)
+		response.raise_for_status()
+		data = response.json()
+
+		# Normalize data
+		if isinstance(data, list):
+			df = pd.json_normalize(data)
+		else:
+			df = pd.DataFrame([data])
+
+		# Validate with schema
+		valid_data, invalid_data = Functions.validate_data(df, BelgianCityGet)
+
+		return valid_data, invalid_data
+
+	def get_application_translations(self, app_id: str, lang: str, _format: str = "json"):
+		"""
+		GET /labelcms/v1/applications/{app_id}/translations - Application labels
+
+		Retrieves application labels/translations for specified languages.
+
+		Args:
+			app_id: Application ID
+			lang: Comma separated list of languages (e.g., "EN,NL,FR")
+			_format: Request format (default: "json")
+
+		Returns:
+			Raw JSON response from API
+
+		Raises:
+			Exception: If the retrieval fails
+		"""
+		params = {
+			"lang": lang,
+			"_format": _format
+		}
+		response = self.acerta.session.get(
+			url=f"{self.acerta.base_url}/labelcms/v1/applications/{app_id}/translations",
+			params=params,
+			timeout=self.acerta.TIMEOUT,
+		)
+		response.raise_for_status()
+		return response.json()
+
+
+	def get_cod_lists(
+		self,
+		attributes: List[CodeListAttribute],
+		lang: str = 'en,nl'
+	):
+		"""
+		GET /labelcms/v1/translations - Attributes collection (COD lists)
+
+		Retrieves generic COD lists applicable within Acerta (country codes, gender, fuel types, etc.).
+		These lists are mainly used to facilitate updates and creations of resources (Employee, Agreement, etc.).
+
+		Args:
+			attributes: List of COD list enum values or names (e.g., [CodListAttribute.B11_Fuel, CodListAttribute.B11_Gender]).
+			lang: Comma separated list of languages (e.g., "en,nl,fr,de")
+			_format: Request format (default: "json")
+
+		Returns:
+			Raw JSON response from API containing possible values for specified attributes and languages
+
+		Raises:
+			Exception: If the retrieval fails
+
+		Example:
+			response = acerta.planning.get_cod_lists(
+				attributes=[CodListAttribute.B11_Fuel, CodListAttribute.B11_Gender],
+				lang="en,nl"
+			)
+		"""
+		# Accept string literals as fallback but enforce they match enum
+		valid_values = set(item.value for item in attributes)
+		attribute_strings = []
+		for attribute in attributes:
+			if isinstance(attribute, CodeListAttribute):
+				attribute_strings.append(attribute.value)
+			elif isinstance(attribute, str) and attribute in valid_values:
+				attribute_strings.append(attribute)
+			else:
+				raise ValueError(
+					f"Invalid attribute: {attribute}. Possible values: {[a.value for a in attributes]}"
+				)
+
+		attribute_string = ",".join(attribute_strings)
+		params = {
+			"lang": lang,
+			"attributes": attribute_string,
+			"_format": "json"
+		}
+		response = requests.get(
+			url=f"https://labelcms.acerta.be/en/v1/translations",
+			params=params
+		)
+		response.raise_for_status()
+		return response.json()

brynq_sdk_acerta/company_cars.py

@@ -0,0 +1,135 @@
+from typing import Tuple, Dict, Any, Optional
+import pandas as pd
+import requests
+from brynq_sdk_functions import Functions
+from .schemas.company_car import CompanyCarGet, CompanyCarCreate, CompanyCarUpdate
+from typing import TYPE_CHECKING
+if TYPE_CHECKING:
+	from .acerta import Acerta
+
+
+class CompanyCars:
+	"""Resource class for Company Cars endpoints"""
+
+	def __init__(self, acerta):
+		self.acerta: Acerta = acerta
+		self.base_uri = "employer-data-management/v1/employers"
+
+	def get(
+		self,
+		from_date: str = "1900-01-01",
+		until_date: str = "9999-12-31",
+		license_plate: Optional[str] = None,
+		size: int = 20,
+		page: int = 0,
+	) -> Tuple[pd.DataFrame, pd.DataFrame]:
+		"""
+		GET /v1/employers/{employerId}/company-cars - Company cars
+
+		Retrieve company cars for all configured employer IDs within an optional time window
+		and optional license plate filter. Supports basic pagination parameters.
+
+		Args:
+			from_date: The lower bound of the time window (default: "1900-01-01")
+			until_date: The upper bound of the time window (default: "9999-12-31")
+			license_plate: Optional license plate filter (or part of a plate)
+			size: Number of items per page (default: 20)
+			page: Zero-based page index (default: 0)
+
+		Returns:
+			Tuple[pd.DataFrame, pd.DataFrame]: (valid_df, invalid_df) after normalizing and validating
+		"""
+		all_valid_data = []
+		all_invalid_data = []
+		for employer_id in self.acerta._employer_ids:
+			params = {
+				"fromDate": from_date,
+				"untilDate": until_date,
+				"size": size,
+				"page": page,
+			}
+			if license_plate:
+				params["licensePlate"] = license_plate
+			response = self.acerta.session.get(
+				url=f"{self.acerta.base_url}/{self.base_uri}/{employer_id}/company-cars",
+				params=params,
+				timeout=self.acerta.TIMEOUT,
+			)
+			response.raise_for_status()
+			items = response.json().get("companyCars", [])
+			df = pd.json_normalize(items, sep='.')
+			valid_data, invalid_data = Functions.validate_data(df, CompanyCarGet)
+			all_valid_data.append(valid_data)
+			all_invalid_data.append(invalid_data)
+
+		return (
+			pd.concat(all_valid_data, ignore_index=True) if all_valid_data else pd.DataFrame(),
+			pd.concat(all_invalid_data, ignore_index=True) if all_invalid_data else pd.DataFrame(),
+		)
+
+	def get_by_id(self, employer_id: str, company_car_id: str) -> Tuple[pd.DataFrame, pd.DataFrame]:
+		"""
+		GET /v1/employers/{employerId}/company-cars/{companyCarId} - Company car by ID
+
+		Args:
+			employer_id: Unique identifier of the employer (Acerta key)
+			company_car_id: Unique identifier of the company car (6 digits)
+
+		Returns:
+			Tuple[pd.DataFrame, pd.DataFrame]: (valid_df, invalid_df)
+		"""
+		response = self.acerta.session.get(
+			url=f"{self.acerta.base_url}/{self.base_uri}/{employer_id}/company-cars/{company_car_id}",
+			timeout=self.acerta.TIMEOUT,
+		)
+		response.raise_for_status()
+		raw = response.json()
+		if isinstance(raw, dict):
+			df = pd.json_normalize(raw, sep='.')
+		else:
+			df = pd.json_normalize([raw], sep='.')
+		return Functions.validate_data(df, CompanyCarGet)
+
+	def create(self, employer_id: str, data: Dict[str, Any]) -> requests.Response:
+		"""
+		POST /v1/employers/{employerId}/company-cars - Company car
+
+		Args:
+			employer_id: Unique identifier of the employer (Acerta key)
+			data: Flat dictionary with company car data
+
+		Returns:
+			requests.Response: Raw response object
+		"""
+		# Convert flat data to nested using Functions.flat_to_nested_with_prefix
+		nested = Functions.flat_to_nested_with_prefix(data, CompanyCarCreate)
+		validated = CompanyCarCreate(**nested)
+		response = self.acerta.session.post(
+			url=f"{self.acerta.base_url}/{self.base_uri}/{employer_id}/company-cars",
+			json=validated.model_dump(by_alias=True, exclude_none=True),
+			timeout=self.acerta.TIMEOUT,
+		)
+		response.raise_for_status()
+		return response
+
+	def update(self, employer_id: str, company_car_id: str, data: Dict[str, Any]) -> requests.Response:
+		"""
+		PATCH /v1/employers/{employerId}/company-cars/{companyCarId} - Update company car
+
+		Args:
+			employer_id: Unique identifier of the employer (Acerta key)
+			company_car_id: Unique identifier of the company car
+			data: Flat dictionary with update fields
+
+		Returns:
+			requests.Response: Raw response object
+		"""
+		nested = Functions.flat_to_nested_with_prefix(data, CompanyCarUpdate)
+		validated = CompanyCarUpdate(**nested)
+		response = self.acerta.session.patch(
+			url=f"{self.acerta.base_url}/{self.base_uri}/{employer_id}/company-cars/{company_car_id}",
+			json=validated.model_dump(by_alias=True, exclude_none=True),
+			timeout=self.acerta.TIMEOUT,
+		)
+		response.raise_for_status()
+		return response

brynq_sdk_acerta/contact_information.py

@@ -0,0 +1,79 @@
+from typing import Dict, Any, Tuple
+import pandas as pd
+import requests
+from brynq_sdk_functions import Functions
+from .schemas.contact_information import ContactInformationGet, ContactInformationUpdate
+from typing import TYPE_CHECKING
+if TYPE_CHECKING:
+    from .acerta import Acerta
+
+
+class ContactInformation:
+    """Resource class for Employee Contact Information endpoints"""
+
+    def __init__(self, acerta):
+        self.acerta: Acerta = acerta
+        self.base_uri = "employee-data-management/v3/employees"
+
+    def get(self) -> Tuple[pd.DataFrame, pd.DataFrame]:
+        """
+        GET /employee-data-management/v3/employees/{employeeId}/contact-information - Employee Contact Information
+
+        Retrieves employee contact information for all cached employees including personal contact (phone, mobile, email),
+        work contact, and emergency contacts (primary and secondary).
+
+        Args:
+
+        Returns:
+            Tuple[pd.DataFrame, pd.DataFrame]: (valid_df, invalid_df) after normalizing and validating
+        """
+        if not self.acerta._employee_ids:
+            self.acerta.agreements.get()
+
+        frames = []
+        for employee_id in self.acerta._employee_ids:
+            response = self.acerta.session.get(
+                url=f"{self.acerta.base_url}/{self.base_uri}/{employee_id}/contact-information",
+                timeout=self.acerta.TIMEOUT,
+            )
+            response.raise_for_status()
+            df = pd.json_normalize(response.json())
+            if 'externalReferences' in df.columns:
+                df = df.drop(columns=['externalReferences'])
+            frames.append(df)
+
+        combined = pd.concat(frames, ignore_index=True) if frames else pd.DataFrame()
+
+        valid_df, invalid_df = Functions.validate_data(combined, ContactInformationGet)
+
+        return valid_df, invalid_df
+
+    def update(self, employee_id: str, data: Dict[str, Any]) -> requests.Response:
+        """
+        PATCH /employee-data-management/v3/employees/{employeeId}/contact-information - Employee Contact Information
+
+        Update employee contact information including personal contact (phone, mobile, email),
+        work contact, and emergency contacts (primary and secondary).
+
+        Args:
+            employee_id: Unique identifier of an employee
+            data: Flat dictionary with contact information data
+
+        Returns:
+            requests.Response: Raw response object
+        """
+        # Convert flat data to nested using Functions.flat_to_nested_with_prefix
+        nested_data = Functions.flat_to_nested_with_prefix(data, ContactInformationUpdate)
+
+        # Validate the nested data
+        validated_data = ContactInformationUpdate(**nested_data)
+
+        # Make API request
+        response = self.acerta.session.patch(
+            url=f"{self.acerta.base_url}/{self.base_uri}/{employee_id}/contact-information",
+            json=validated_data.model_dump(by_alias=True, exclude_none=True),
+            timeout=self.acerta.TIMEOUT,
+        )
+        response.raise_for_status()
+
+        return response

brynq_sdk_acerta/cost_centers.py

@@ -0,0 +1,94 @@
+from typing import Tuple, Dict, Any
+import pandas as pd
+import requests
+from brynq_sdk_functions import Functions
+from .schemas.cost_center import CostCenterGet, CostCenterCreate
+from typing import TYPE_CHECKING
+if TYPE_CHECKING:
+	from .acerta import Acerta
+
+
+class CostCenters:
+	"""Resource class for Cost Centers endpoints"""
+
+	def __init__(self, acerta):
+		self.acerta: Acerta = acerta
+		self.base_uri = "employer-data-management/v1/employers"
+
+	def get(self, from_date: str = "1900-01-01", until_date: str = "9999-12-31",
+			size: int = 20, page: int = 0) -> Tuple[pd.DataFrame, pd.DataFrame]:
+		"""
+		GET /v1/employers/{employerId}/cost-centers - Cost centers
+
+		This endpoint returns the cost centers of an employer based on its employerId for a given period.
+		An employer can have 0 to N cost centers. Cost centers are primarily used for reporting purposes.
+
+		Args:
+			employer_id: Unique identifier of the employer (Acerta key)
+			from_date: The lower bound of the time window (default: "1900-01-01")
+			until_date: The upper bound of the time window (default: "9999-12-31")
+			size: Number of items to be returned on each page (default: 20)
+			page: Zero-based page index (default: 0)
+
+		Returns:
+			Tuple[pd.DataFrame, pd.DataFrame]: (valid_df, invalid_df) after normalizing and validating
+
+		Raises:
+			Exception: If the retrieval fails
+		"""
+		all_valid_data = []
+		all_invalid_data = []
+		for employer_id in self.acerta._employer_ids:
+			# Prepare query parameters
+			params = {
+				"fromDate": from_date,
+				"untilDate": until_date,
+				"size": size,
+				"page": page
+			}
+			# Make API request
+			response = self.acerta.session.get(
+				url=f"{self.acerta.base_url}/{self.base_uri}/{employer_id}/cost-centers",
+				params=params,
+				timeout=self.acerta.TIMEOUT,
+			)
+			response.raise_for_status()
+			cost_centers_data = response.json().get("costCenters", [])
+			df = pd.json_normalize(cost_centers_data, sep='.')
+			valid_data, invalid_data = Functions.validate_data(df, CostCenterGet)
+			all_valid_data.append(valid_data)
+			all_invalid_data.append(invalid_data)
+
+		return pd.concat(all_valid_data, ignore_index=True), pd.concat(all_invalid_data, ignore_index=True)
+
+	def create(self, employer_id: str, data: Dict[str, Any]) -> requests.Response:
+		"""
+		POST /v1/employers/{employerId}/cost-centers - Cost center
+
+		This endpoint creates a cost center for an employer.
+
+		Args:
+			employer_id: Unique identifier of the employer (Acerta key)
+			data: Flat dictionary with cost center data
+
+		Returns:
+			requests.Response: Raw response object
+
+		Raises:
+			Exception: If the creation fails
+		"""
+		# Convert flat data to nested using Functions.flat_to_nested_with_prefix
+		nested_data = Functions.flat_to_nested_with_prefix(data, CostCenterCreate)
+
+		# Validate the nested data
+		validated_data = CostCenterCreate(**nested_data)
+
+		# Make API request
+		response = self.acerta.session.post(
+			url=f"{self.acerta.base_url}/{self.base_uri}/{employer_id}/cost-centers",
+			json=validated_data.model_dump(by_alias=True, exclude_none=True),
+			timeout=self.acerta.TIMEOUT,
+		)
+		response.raise_for_status()
+
+		return response