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

brynq_sdk_acerta/schemas/bank_account.py

@@ -0,0 +1,87 @@
+"""
+Schemas for Bank Accounts resource
+"""
+
+import pandas as pd
+import pandera as pa
+from pandera.typing import Series
+from pydantic import BaseModel, Field
+from typing import Optional, Literal
+from brynq_sdk_functions import BrynQPanderaDataFrameModel
+
+
+# GET via Agreements Remuneration
+class AgreementBankAccountsGet(BrynQPanderaDataFrameModel):
+    """Schema for bank account fields within GET /v3/agreements/{agreementId}/remuneration."""
+
+    agreement_id: Series[pd.StringDtype] = pa.Field(coerce=True, alias="agreementId")
+    period_start_date: Series[pd.StringDtype] = pa.Field(coerce=True, alias="period.startDate")
+    period_end_date: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, alias="period.endDate")
+
+    payment_method_type_code: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, alias="methodOfPayment.type.code")
+    payment_method_type_description: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, alias="methodOfPayment.type.description")
+
+    employee_main_iban: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, alias="methodOfPayment.employeeBankAccounts.mainAccount.iban")
+    employee_main_bic: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, alias="methodOfPayment.employeeBankAccounts.mainAccount.bic")
+    employee_second_iban: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, alias="methodOfPayment.employeeBankAccounts.secondAccount.iban")
+    employee_second_bic: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, alias="methodOfPayment.employeeBankAccounts.secondAccount.bic")
+
+    employer_main_iban: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, alias="methodOfPayment.employerBankAccounts.mainAccount.iban")
+    employer_main_bic: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, alias="methodOfPayment.employerBankAccounts.mainAccount.bic")
+    employer_second_iban: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, alias="methodOfPayment.employerBankAccounts.secondAccount.iban")
+    employer_second_bic: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, alias="methodOfPayment.employerBankAccounts.secondAccount.bic")
+
+    class Config:
+        strict = False
+        metadata = {"class": "AgreementBankAccounts", "dependencies": []}
+
+# POST/PUT Schemas (Pydantic - Request)
+class OwnerName(BaseModel):
+    """Reusable bank account owner name schema (no prefix)"""
+    first_name: str = Field(..., min_length=1, max_length=35, example="John", description="Owner first name of the bank account", alias="firstName")
+    last_name: str = Field(..., min_length=1, max_length=35, example="Doe", description="Owner last name of the bank account", alias="lastName")
+
+    class Config:
+        populate_by_name = True
+
+
+class BankOwner(BaseModel):
+    """Reusable bank account owner schema (no prefix)"""
+    name: OwnerName = Field(..., description="Owner name of the bank account", alias="name", json_schema_extra={"prefix": "name_"})
+    street: str = Field(..., min_length=1, max_length=40, example="Main Street", description="Owner street name of the bank account", alias="street")
+    house_number: str = Field(..., min_length=1, max_length=9, example="123", description="Owner house number of the bank account", alias="houseNumber")
+    box_number: Optional[str] = Field(None, min_length=1, max_length=4, example="A", description="Owner box number of the bank account", alias="boxNumber")
+    postal_code: str = Field(..., min_length=1, max_length=14, example="1000", description="Owner zip code of the bank account", alias="postalCode")
+    city: str = Field(..., min_length=1, max_length=35, example="Brussels", description="Owner city name of the bank account", alias="city")
+    country: str = Field(..., min_length=3, max_length=3, example="BEL", description="Owner country code", alias="country")
+
+    class Config:
+        populate_by_name = True
+
+
+class BankDetails(BaseModel):
+    """Reusable bank details schema (no prefix)"""
+    bic: str = Field(..., min_length=8, max_length=11, pattern=r"^([A-Z]{4}[A-Z]{2}[A-Z0-9]{2}[A-Z0-9]{3}|[A-Z]{4}[A-Z]{2}[A-Z0-9]{2})$", example="SZNBDLYL", description="BIC Number", alias="bic")
+    name: Optional[str] = Field(None, min_length=1, max_length=35, example="Bank Name", description="Name of the bank account", alias="name")
+    street: Optional[str] = Field(None, min_length=1, max_length=40, example="Bank Street", description="Street name of the bank account", alias="street")
+    house_number: Optional[str] = Field(None, min_length=1, max_length=9, example="456", description="House number of the bank account", alias="houseNumber")
+    box_number: Optional[str] = Field(None, min_length=1, max_length=4, example="B", description="Box number of the bank account", alias="boxNumber")
+    postal_code: Optional[str] = Field(None, min_length=1, max_length=14, example="2000", description="Zip code of the bank account", alias="postalCode")
+    city: Optional[str] = Field(None, min_length=1, max_length=35, example="Antwerp", description="City name of the bank account", alias="city")
+    country: Optional[str] = Field(None, min_length=3, max_length=3, example="BEL", description="Country code", alias="country")
+    costs: Literal["DEBT", "CRED", "SHAR"] = Field(..., example="DEBT", description="Costs code", alias="costs")
+
+    class Config:
+        populate_by_name = True
+
+
+class BankAccountUpdate(BaseModel):
+    """Schema for PUT /v1/employees/{employeeId}/bank-accounts/{bankAccountId} endpoint"""
+
+    iban: str = Field(..., min_length=1, max_length=34, example="BE68539007547034", description="Bank account number", alias="iban")
+    text: Optional[str] = Field(None, min_length=1, max_length=40, example="Notice text", description="Notice text", alias="text")
+    bank_details: Optional[BankDetails] = Field(None, description="If not a Belgian account, bankDetails must be specified", alias="bankDetails", json_schema_extra={"prefix": "bank_details_"})
+    owner: Optional[BankOwner] = Field(None, description="If the owner is not the owner of the bankaccount, some extra data must be provided", alias="owner", json_schema_extra={"prefix": "owner_"})
+
+    class Config:
+        populate_by_name = True

brynq_sdk_acerta/schemas/company_car.py

@@ -0,0 +1,124 @@
+"""
+Schemas for Company Cars resource
+"""
+
+from typing import Optional
+import pandas as pd
+import pandera as pa
+from pandera.typing import Series
+from pydantic import BaseModel, Field
+from brynq_sdk_functions import BrynQPanderaDataFrameModel
+
+
+# ============================================
+# GET SCHEMA (Pandera - DataFrame)
+# ============================================
+
+class CompanyCarGet(BrynQPanderaDataFrameModel):
+    """Schema for GET /v1/employers/{employerId}/company-cars endpoints."""
+
+    # Period
+    period_start_date: Series[pd.StringDtype] = pa.Field(coerce=True, description="The start date of the record", alias="period.startDate")
+    period_end_date: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, description="The end date of the record", alias="period.endDate")
+
+    # Identification
+    company_car_id: Series[pd.StringDtype] = pa.Field(coerce=True, description="Unique identifier of the company car", alias="companyCarId")
+    license_plate: Series[pd.StringDtype] = pa.Field(coerce=True, description="License plate of the car", alias="licensePlate")
+
+    # Vehicle details
+    brand: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, description="Brand of the car", alias="brand")
+    type: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, description="Type/model of the car", alias="type")
+    co2: Series[pd.Int64Dtype] = pa.Field(coerce=True, description="CO2 value of the car", alias="co2")
+    fuel_code: Series[pd.StringDtype] = pa.Field(coerce=True, description="Fuel type code of the car", alias="fuel.code")
+    fuel_description: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, description="Fuel type description", alias="fuel.description")
+    catalogue_value: Series[pd.Float64Dtype] = pa.Field(coerce=True, nullable=True, description="Catalogue value of the car", alias="catalogueValue")
+    fiscal_hp: Series[pd.Int64Dtype] = pa.Field(coerce=True, nullable=True, description="Fiscal horsepower of the car", alias="fiscalHp")
+    is_light_cargo: Series[pd.BooleanDtype] = pa.Field(coerce=True, description="Is the car Light commercial only used for commuting?", alias="isLightCargo")
+    first_subscription_date: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, description="First subscription date of the car", alias="firstSubscriptionDate")
+    acquire_date: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, description="Date of acquisition of the car", alias="acquireDate")
+    is_hybrid: Series[pd.BooleanDtype] = pa.Field(coerce=True, nullable=True, description="Is it a hybrid car?", alias="isHybrid")
+    is_fake_hybrid: Series[pd.BooleanDtype] = pa.Field(coerce=True, nullable=True, description="Is the car a fake hybrid?", alias="isFakeHybrid")
+    co2_fake_hybrid: Series[pd.Int64Dtype] = pa.Field(coerce=True, nullable=True, description="CO2 of the fake hybrid car", alias="co2FakeHybrid")
+    is_pool_car: Series[pd.BooleanDtype] = pa.Field(coerce=True, nullable=True, description="Whether the company car is a poolcar", alias="isPoolCar")
+
+    class _Annotation:
+        primary_key = "company_car_id"
+        foreign_keys = {}
+
+    class Config:
+        metadata = {"class": "CompanyCar", "dependencies": []}
+
+
+# ============================================
+# POST/PATCH SCHEMAS (Pydantic - Request)
+# ============================================
+
+class CompanyCarPeriod(BaseModel):
+    """Reusable company car period schema - no prefix in field names"""
+    start_date: str = Field(..., example="1984-10-30", description="The start date of the record", alias="startDate")
+    end_date: Optional[str] = Field(None, example="1984-10-30", description="The end date of the record", alias="endDate")
+
+    class Config:
+        populate_by_name = True
+
+
+class CompanyCarCreate(BaseModel):
+    """
+    Schema for POST /v1/employers/{employerId}/company-cars endpoint
+    """
+    # Function parameters
+    employer_id: str = Field(..., description="Employer identifier", alias="employerId")
+
+    period: CompanyCarPeriod = Field(..., description="The time span of the record for which this data is valid", alias="period", json_schema_extra={"prefix": "period_"})
+    license_plate: str = Field(..., min_length=1, max_length=10, example="2-DCR-765", description="License plate of the car", alias="licensePlate")
+    brand: Optional[str] = Field(None, min_length=1, max_length=35, example="Renault", description="Brand of the car", alias="brand")
+    type: Optional[str] = Field(None, min_length=1, max_length=50, example="megane", description="Type/model of the car", alias="type")
+    co2: int = Field(..., ge=0, le=99999, example=110, description="CO2 value of the car", alias="co2")
+    fuel: str = Field(..., min_length=2, max_length=2, example="02", description="Fuel type of the car (COD: B11_Fuel)", alias="fuel")
+    catalogue_value: Optional[float] = Field(None, ge=0, le=999999999.99, multiple_of=0.01, example=49649.99, description="Catalogue value of the car", alias="catalogueValue")
+    fiscal_hp: Optional[int] = Field(None, ge=0, le=99, example=8, description="Fiscal horsepower of the car", alias="fiscalHp")
+    is_light_cargo: bool = Field(..., description="Is the car Light commercial only used for commuting?", alias="isLightCargo")
+    first_subscription_date: Optional[str] = Field(None, example="2020-09-08", description="Date of first subscription of the car", alias="firstSubscriptionDate")
+    acquire_date: Optional[str] = Field(None, example="2020-09-08", description="Date of acquisition of the car", alias="acquireDate")
+    is_hybrid: Optional[bool] = Field(None, description="Is it a hybrid car?", alias="isHybrid")
+    is_fake_hybrid: Optional[bool] = Field(None, description="Is the car a fake hybrid?", alias="isFakeHybrid")
+    co2_fake_hybrid: Optional[int] = Field(None, ge=0, le=99999, example=50, description="CO2 of the fake hybrid car", alias="co2FakeHybrid")
+    is_pool_car: Optional[bool] = Field(None, description="Is the car a pool car?", alias="isPoolCar")
+
+    class Config:
+        populate_by_name = True
+
+
+class CompanyCarPeriodPatch(BaseModel):
+    """Period for PATCH - start date required, end date optional"""
+    start_date: str = Field(..., example="1984-10-30", description="The start date of the record", alias="startDate")
+    end_date: Optional[str] = Field(None, example="1984-10-30", description="The end date of the record", alias="endDate")
+
+    class Config:
+        populate_by_name = True
+
+
+class CompanyCarUpdate(BaseModel):
+    """Schema for PATCH /v1/employers/{employerId}/company-cars/{companyCarId}"""
+    # Function parameters
+    employer_id: str = Field(..., description="Employer identifier", alias="employerId")
+    company_car_id: str = Field(..., description="Company car identifier", alias="companyCarId")
+
+    period: Optional[CompanyCarPeriodPatch] = Field(None, description="The time span of the record for which this data is valid", alias="period", json_schema_extra={"prefix": "period_"})
+    license_plate: Optional[str] = Field(None, min_length=1, max_length=10, example="2-DCR-765", description="License plate of the car", alias="licensePlate")
+    brand: Optional[str] = Field(None, min_length=1, max_length=35, example="Renault", description="Brand of the car", alias="brand")
+    type: Optional[str] = Field(None, min_length=1, max_length=50, example="megane", description="Type/model of the car", alias="type")
+    co2: Optional[int] = Field(None, ge=0, le=99999, example=110, description="CO2 value of the car", alias="co2")
+    fuel: Optional[str] = Field(None, min_length=2, max_length=2, example="02", description="Fuel type of the car (COD: B11_Fuel)", alias="fuel")
+    catalogue_value: Optional[float] = Field(None, ge=0, le=999999999.99, multiple_of=0.01, example=49649.99, description="Catalogue value of the car", alias="catalogueValue")
+    fiscal_hp: Optional[int] = Field(None, ge=0, le=99, example=8, description="Fiscal horsepower of the car", alias="fiscalHp")
+    is_light_cargo: Optional[bool] = Field(None, description="Is the car Light commercial only used for commuting?", alias="isLightCargo")
+    first_subscription_date: Optional[str] = Field(None, example="2020-09-08", description="Date of first subscription of the car", alias="firstSubscriptionDate")
+    acquire_date: Optional[str] = Field(None, example="2020-09-08", description="Date of acquisition of the car", alias="acquireDate")
+    is_hybrid: Optional[bool] = Field(None, description="Is it a hybrid car?", alias="isHybrid")
+    is_fake_hybrid: Optional[bool] = Field(None, description="Is the car a fake hybrid?", alias="isFakeHybrid")
+    co2_fake_hybrid: Optional[int] = Field(None, ge=0, le=99999, example=50, description="CO2 of the fake hybrid car", alias="co2FakeHybrid")
+    is_pool_car: Optional[bool] = Field(None, description="Whether the company car is a poolcar", alias="isPoolCar")
+
+    class Config:
+        populate_by_name = True

brynq_sdk_acerta/schemas/contact_information.py

@@ -0,0 +1,83 @@
+"""
+Schema for GET /employee-data-management/v3/employees/{employeeId}/contact-information
+"""
+
+import pandas as pd
+import pandera as pa
+from pandera.typing import Series
+from pydantic import BaseModel, Field
+from typing import Optional
+from brynq_sdk_functions import BrynQPanderaDataFrameModel
+
+
+class ContactInformationGet(BrynQPanderaDataFrameModel):
+    """Schema for GET /employee-data-management/v3/employees/{employeeId}/contact-information endpoint"""
+
+    # Employee identification
+    employee_id: Series[pd.StringDtype] = pa.Field(coerce=True, description="Employee identifier", alias="employeeId")
+
+    # Personal contact information
+    personal_telephone: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, description="Personal phone number", alias="personal.telephone")
+    personal_mobile: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, description="Personal mobile number", alias="personal.mobile")
+    personal_email: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, description="Personal email", alias="personal.email")
+
+    # Work contact information
+    work_telephone: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, description="Work phone number", alias="work.telephone")
+    work_mobile: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, description="Work mobile number", alias="work.mobile")
+    work_email: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, description="Work email", alias="work.email")
+
+    # Primary emergency contact
+    primary_emergency_relationship_code: Optional[Series[pd.StringDtype]] = pa.Field(coerce=True, nullable=True, description="Primary emergency contact relationship code", alias="primaryEmergencyContact.relationship.code")
+    primary_emergency_relationship_description: Optional[Series[pd.StringDtype]] = pa.Field(coerce=True, nullable=True, description="Primary emergency contact relationship description", alias="primaryEmergencyContact.relationship.description")
+    primary_emergency_name: Optional[Series[pd.StringDtype]] = pa.Field(coerce=True, nullable=True, description="Primary emergency contact name", alias="primaryEmergencyContact.name")
+    primary_emergency_number: Optional[Series[pd.StringDtype]] = pa.Field(coerce=True, nullable=True, description="Primary emergency contact number", alias="primaryEmergencyContact.number")
+
+    # Secondary emergency contact
+    secondary_emergency_relationship_code: Optional[Series[pd.StringDtype]] = pa.Field(coerce=True, nullable=True, description="Secondary emergency contact relationship code", alias="secondaryEmergencyContact.relationship.code")
+    secondary_emergency_relationship_description: Optional[Series[pd.StringDtype]] = pa.Field(coerce=True, nullable=True, description="Secondary emergency contact relationship description", alias="secondaryEmergencyContact.relationship.description")
+    secondary_emergency_name: Optional[Series[pd.StringDtype]] = pa.Field(coerce=True, nullable=True, description="Secondary emergency contact name", alias="secondaryEmergencyContact.name")
+    secondary_emergency_number: Optional[Series[pd.StringDtype]] = pa.Field(coerce=True, nullable=True, description="Secondary emergency contact number", alias="secondaryEmergencyContact.number")
+
+    class _Annotation:
+        primary_key = "employee_id"
+        foreign_keys = {}
+
+    class Config:
+        metadata = {"class": "ContactInformation", "dependencies": []}
+
+
+
+
+# Reusable base schemas - no prefix in field names
+class Contact(BaseModel):
+    """Reusable contact schema - no prefix in field names"""
+    telephone: Optional[str] = Field(None, min_length=1, max_length=100, example="016588774", description="Phone number", alias="telephone")
+    mobile: Optional[str] = Field(None, min_length=1, max_length=100, example="0479877458", description="Mobile number", alias="mobile")
+    email: Optional[str] = Field(None, min_length=1, max_length=100, pattern=r"^[^@\s]+@[^@\s]+\.[^@\s]+$", example="contact@example.com", description="E-mail", alias="email")
+
+    class Config:
+        populate_by_name = True
+
+
+class EmergencyContact(BaseModel):
+    """Reusable emergency contact schema - no prefix in field names"""
+    relationship: Optional[str] = Field(None, min_length=2, max_length=2, example="10", description="Relationship with the person", alias="relationship")
+    name: Optional[str] = Field(None, min_length=1, max_length=50, example="John Emergency", description="Name of the person", alias="name")
+    number: Optional[str] = Field(None, min_length=1, max_length=100, example="0498778855", description="Contact phone number", alias="number")
+
+    class Config:
+        populate_by_name = True
+
+
+class ContactInformationUpdate(BaseModel):
+    """Schema for PATCH /employee-data-management/v3/employees/{employeeId}/contact-information - uses json_schema_extra for prefixes"""
+    # Function parameters
+    employee_id: str = Field(..., description="Employee identifier", alias="employeeId")
+
+    personal: Optional[Contact] = Field(None, description="Personal contact information", alias="personal", json_schema_extra={"prefix": "personal_"})
+    work: Optional[Contact] = Field(None, description="Work contact information", alias="work", json_schema_extra={"prefix": "work_"})
+    primary_emergency_contact: Optional[EmergencyContact] = Field(None, description="Primary emergency contact", alias="primaryEmergencyContact", json_schema_extra={"prefix": "primary_emergency_"})
+    secondary_emergency_contact: Optional[EmergencyContact] = Field(None, description="Secondary emergency contact", alias="secondaryEmergencyContact", json_schema_extra={"prefix": "secondary_emergency_"})
+
+    class Config:
+        populate_by_name = True

brynq_sdk_acerta/schemas/cost_center.py

@@ -0,0 +1,82 @@
+"""
+Schemas for Cost Centers resource
+"""
+
+import pandas as pd
+import pandera as pa
+from pandera.typing import Series
+from pydantic import BaseModel, Field
+from typing import Optional, List, Literal
+from brynq_sdk_functions import BrynQPanderaDataFrameModel
+
+
+# ============================================
+# GET SCHEMA (Pandera - DataFrame)
+# ============================================
+
+class CostCenterGet(BrynQPanderaDataFrameModel):
+    """Schema for GET /v1/employers/{employerId}/cost-centers endpoint."""
+
+    # Cost Center identification
+    cost_center_id: Series[pd.StringDtype] = pa.Field(coerce=True, description="The service receiver cost center number", alias="costCenterId")
+
+    # Period information
+    period_start_date: Series[pd.StringDtype] = pa.Field(coerce=True, description="The start date of the record", alias="period.startDate")
+    period_end_date: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, description="The end date of the record", alias="period.endDate")
+
+    # Optional fields
+    accountancy: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, description="The accountancy cost center linked to the service receiver cost center number", alias="accountancy")
+    acknowledgement_number: Series[pd.StringDtype] = pa.Field(coerce=True, nullable=True, description="The acknowledgement number linked to the service receiver cost center number", alias="acknowledgementNumber")
+
+    # Descriptions (handled as JSON string since it's a list)
+    descriptions: Series[pd.StringDtype] = pa.Field(coerce=True, description="Cost center descriptions per language (as JSON)", alias="descriptions")
+
+    class _Annotation:
+        primary_key = "cost_center_id"
+        foreign_keys = {}
+
+    class Config:
+        metadata = {"class": "CostCenter", "dependencies": []}
+
+
+# ============================================
+# POST SCHEMAS (Pydantic - Request)
+# ============================================
+
+class CostCenterDescription(BaseModel):
+    """Reusable cost center description schema - no prefix in field names"""
+    language: Literal["EN", "en", "NL", "nl", "FR", "fr"] = Field(..., example="EN", description="Language of the description", alias="language")
+    description: str = Field(..., min_length=1, max_length=100, example="Cost center for business line 4454-01.", description="Description of the cost center", alias="description")
+
+    class Config:
+        populate_by_name = True
+
+
+class CostCenterPeriod(BaseModel):
+    """Reusable cost center period schema - no prefix in field names"""
+    start_date: str = Field(..., example="1984-10-30", description="The start date of the record", alias="startDate")
+    end_date: Optional[str] = Field(None, example="1984-10-30", description="The end date of the record", alias="endDate")
+
+    class Config:
+        populate_by_name = True
+
+
+class CostCenterCreate(BaseModel):
+    """
+    Schema for POST /v1/employers/{employerId}/cost-centers endpoint
+
+    Uses json_schema_extra with prefixes for flat-to-nested conversion support.
+    Works with Functions.flat_to_nested_with_prefix() to convert flat dictionaries
+    to properly nested structures.
+    """
+    # Function parameters
+    employer_id: str = Field(..., description="Employer identifier", alias="employerId")
+
+    cost_center_id: str = Field(..., min_length=1, max_length=12, example="4454-01", description="The service receiver cost center number", alias="costCenterId")
+    descriptions: List[CostCenterDescription] = Field(..., min_items=1, max_items=3, description="Cost center descriptions per language", alias="descriptions", json_schema_extra={"prefix": "descriptions_"})
+    period: CostCenterPeriod = Field(..., description="The time span of the record for which this data is valid", alias="period", json_schema_extra={"prefix": "period_"})
+    accountancy: Optional[str] = Field(None, min_length=1, max_length=12, example="ADMINISTR1", description="The accountancy cost center linked to the service receiver cost center number", alias="accountancy")
+    acknowledgement_number: Optional[str] = Field(None, min_length=1, max_length=8, example="975", description="The acknowledgement number linked to the service receiver cost center number", alias="acknowledgementNumber")
+
+    class Config:
+        populate_by_name = True