@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Loket.nl API
@base https://api.loket.nl
@version V2
@auth ApiKey Authorization in header
@common_fields {Authorization: str, Accept: str}
@endpoints 1087
@hint download_for_search
@toc providers(1014), automaticpayroll(6), authorizationmodel(1), users(11), payrollcomponent(2), qwoatermicroservice(5), billing(2), year(4), person(1), wageprojection(2), rdwservices(1), achmeainsurancecontracts(2), qwoater(1), user(6), globalfilter(2), locationservices(1), address(1), route(1), aowDate(1), chamberofcommerce(1), datanewbusiness(2), applications(2), applicationset(13), provider(4), payrolltaxreturn(1)

@group providers
@endpoint GET /v2/providers/employers/employees/{employeeId}/absences
@required {employeeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/absences
@required {employeeId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/{employeeId}/absences/overview
@required {employeeId: str(uuid), startDate: str, endDate: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/absences/{absenceId}
@required {absenceId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/absences/{absenceId}
@required {absenceId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/absences/{absenceId}
@required {absenceId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/absences/{absenceId}/closeabsence
@required {absenceId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/absences/{absenceId}/reopenabsence
@required {absenceId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/absences/{absenceId}/absenceprogress
@required {absenceId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/absences/{absenceId}/absenceprogress
@required {absenceId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/absences/absenceprogress/{absenceProgressId}
@required {absenceProgressId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/absences/absenceprogress/{absenceProgressId}
@required {absenceProgressId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/absences/absenceprogress/{absenceProgressId}
@required {absenceProgressId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/absences/{absenceId}/absencecontactHistory
@required {absenceId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/absences/{absenceId}/absencecontactHistory
@required {absenceId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/absences/absencecontactHistory/{absencecontactHistoryId}
@required {absencecontactHistoryId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/absences/absencecontactHistory/{absencecontactHistoryId}
@required {absencecontactHistoryId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/absences/absencecontactHistory/{absencecontactHistoryId}
@required {absencecontactHistoryId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/absences/statistics/data
@required {employerId: str(uuid), startYearMonth: str, endYearMonth: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/administrations
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/administrations
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/payrolladministrations
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/payrolladministrations
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/payrolladministrations/configurations
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/configurations
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/configurations
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group automaticpayroll
@endpoint GET /automaticpayroll/payrolladministrations/{payrollAdministrationId}/automaticpayrollconfiguration
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /automaticpayroll/payrolladministrations/{payrollAdministrationId}/automaticpayrollconfiguration
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /automaticpayroll/payrolladministrations/years/{yearId}/automaticpayrolldates
@required {yearId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /automaticpayroll/payrolladministrations/years/{yearId}/automaticpayrolldates
@required {yearId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 500}

@endpoint PATCH /automaticpayroll/payrolladministrations/years/automaticpayrolldates/{automaticPayrollDateId}
@required {automaticPayrollDateId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /automaticpayroll/payrolladministrations/years/automaticpayrolldates/{automaticPayrollDateId}
@required {automaticPayrollDateId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group authorizationmodel
@endpoint GET /authorizationmodel
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/{employerId}/nonpayrolladministrations
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/nonpayrolladministrations
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/nonpayrolladministrations/{nonPayrollAdministrationId}
@required {nonPayrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/nonpayrolladministrations/{nonPayrollAdministrationId}
@required {nonPayrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/availablepayrollcomponentsets
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollcomponentsets
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollcomponentsets
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollcomponentsets/{payrollComponentSetId}
@required {payrollComponentSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/payrolladministrations/payrollcomponentsets/{payrollComponentSetId}
@required {payrollComponentSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/payrolladministrations/payrollcomponentsets/{payrollComponentSetId}
@required {payrollComponentSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/payrollcomponentsets
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/payrollcomponentsets
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/payrollcomponentsets/{payrollComponentSetId}
@required {payrollComponentSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/payrollcomponentsets/{payrollComponentSetId}
@required {payrollComponentSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/payrollcomponentsets/{payrollComponentSetId}
@required {payrollComponentSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollcomponents/year/{year}
@required {payrollAdministrationId: str(uuid), year: int(int32)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/employmentfunds/year/{year}
@required {payrollAdministrationId: str(uuid), year: int(int32)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/abpfunds/year/{year}
@required {payrollAdministrationId: str(uuid), year: int(int32)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group users
@endpoint GET /users/collectiveactions
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /users/collectiveactions/{collectiveActionId}
@required {collectiveActionId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/{employerId}/employmentActualMasterDataReport
@required {employerId: str(uuid), referenceDate: str(date)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employmentMasterDataReport
@required {employerId: str(uuid), referenceDate: str(date), includeEmploymentsThatEndedBeforeReferenceDate: bool}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/fiscalCompanyCarReport
@required {employerId: str(uuid), referenceDate: str(date), includeEmploymentsThatEndedBeforeReferenceDate: bool}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/annualpayrolltaxreturnreport
@required {payrollAdministrationId: str(uuid), reportYear: int}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/annualwagesheetreport
@required {payrollAdministrationId: str(uuid)}
@optional {reportYear: int, startPeriod: int, endPeriod: int}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/annualpawwdeclarationreport
@required {payrollAdministrationId: str(uuid)}
@optional {reportYear: int}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrolladministrationsettingsreport
@required {payrollAdministrationId: str(uuid), reportYear: int}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/accumulationsandbalancesreport
@required {payrollAdministrationId: str(uuid), reportType: str(baseForCalculationBalancesAtStartOfYear/leaveBalancesAtStartOfYear/leaveAccrualWithinYear), reportYear: int}
@optional {includeEmploymentsThatEndedBeforeStartOfTheYear: bool}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/accumulatedbasicjournalresultsreport
@required {payrollAdministrationId: str(uuid), reportType: str(nonAggregated/aggregatedPerGeneralLedgerAccount), groupingType: str(perPeriod/perDistributionUnit/perPeriodPerDistributionUnit), startPeriod: int, endPeriod: int}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/deviatingpremiumswab
@required {payrollAdministrationId: str(uuid), reportYear: int}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/attachmentsofearningsreport
@required {payrollAdministrationId: str(uuid), reportYear: int}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/accumulatedjournalrunresultsreport"
@required {payrollAdministrationId: str(uuid), startPeriod: int, endPeriod: int, reportJournalNumber: int(int32), reportVoucherNumber: int(int32), financialYear: int(int32), period: int(int32), date: str(date)}
@optional {reportDescription: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollPeriodDataReport
@required {payrollAdministrationId: str(uuid), payrollPeriodId: int}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/PayrollAuditReport"
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/employmentActualMasterDataReport
@required {employmentId: str(uuid), referenceDate: str(date)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/employmentMasterDataReport
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollPeriods/{payrollPeriodId}/payrollperioddata
@required {payrollAdministrationId: str(uuid), payrollPeriodId: int(int32), payslipType: int(int32)}
@optional {payrollComponentSet: str(uuid), payrollComponentCategory: int(int32), payrollComponentId: int(int32), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group payrollcomponent
@endpoint POST /payrollcomponent/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollPeriods/{payrollPeriodId}/payrollperioddata/smartpaste
@required {payrollAdministrationId: str(uuid), payrollPeriodId: int(int32)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /payrollcomponent/providers/employers/payrolladministrations/payrollPeriods/payrollperioddata/smartpaste/{smartPasteId}
@required {smartPasteId: str(uuid), employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/import/payrollperioddata"
@required {payrollAdministrationId: str(uuid), payrollPeriodId: int(int32), payslipType: int(int32), processingMethod: int(int32)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/import/payrollperioddata"
@required {payrollPeriodId: int(int32), payslipType: int(int32), processingMethod: int(int32)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/workflowtriggers
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/workflowtriggers/workflowtemplates/{workflowTemplateId}
@required {workflowTemplateId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/workflowtriggers/workflowtemplates/{workflowTemplateId}
@required {workflowTemplateId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/workflowtriggers/workflowtemplates/{workflowTemplateId}
@required {workflowTemplateId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/workflowtriggers/{workflowTriggerId}/workflowtemplates
@required {employerId: str(uuid), workflowTriggerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/workflowtriggermappings
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/workflowtriggermappings
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/workflowtriggermappings/{workflowTriggerMappingId}
@required {workflowTriggerMappingId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/workflowtriggermappings/{workflowTriggerMappingId}
@required {workflowTriggerMappingId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/workflowtriggermappings/{workflowTriggerMappingId}
@required {workflowTriggerMappingId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/changeaddressrequest
@required {employeeId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/changecontactinformationrequest
@required {employeeId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/workflow/InitiateChangeAddress
@required {employeeId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/workflow/InitiateChangeContactInformation
@required {employeeId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/workflow/InitiateChangePersonalInformation
@required {employeeId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/workflow/InitiateManagePartners
@required {employeeId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/workflow/InitiateManageContacts
@required {employeeId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/workflow/InitiateDeclaration
@required {employmentId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/employments/workflow/{workflowId}/initiatedDeclaration
@required {workflowId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/workflow/InitiateChangeIban
@required {employmentId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/workflow/InitiateLeaveRequest
@required {employmentId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/employments/workflow/{workflowId}/InitiatedLeaveRequest
@required {workflowId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/leaveRequests/{leaveRequestId}/workflow/WithdrawLeaveRequest
@required {leaveRequestId: str(uuid), employmentId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/workflows/initiatecontractextension
@required {employmentId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/workflows/initiateterminateemployment
@required {employmentId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/workflow/{workflowId}/attachment
@required {workflowId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/workflow/{workflowId}/attachment
@required {workflowId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endgroup

@group qwoatermicroservice
@endpoint GET /qwoatermicroservice/providers/employers/employees/employments/{employmentId}/workflows/withattachment
@required {employmentId: str(uuid), workflowIds: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /qwoatermicroservice/providers/employers/{employerId}/employees/employments/workflows/withattachment
@required {employerId: str(uuid), workflowIds: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint PATCH /v2/providers/employers/workflows/{workflowId}/cancel
@required {workflowId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/assignedworkflows
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group users
@endpoint GET /users/initiatedworkflows
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250, workflowFilters: map}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/{employerId}/workflows
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/workflows/{workflowId}
@required {workflowId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/workflows/{workflowId}/transition
@required {workflowId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/workflows
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/workflows/{workflowId}/workflowprogress
@required {workflowId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250, X-ReportInput: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/{employeeId}
@required {employeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/{employeeId}
@required {employeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/{employeeId}
@required {employeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/{employeeId}/contacts
@required {employeeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/contacts
@required {employeeId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/contacts/{contactId}
@required {contactId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/contacts/{contactId}
@required {contactId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/contacts/{contactId}
@required {contactId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/{employeeId}/children
@required {employeeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/children
@required {employeeId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/children/{childId}
@required {childId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/children/{childId}
@required {childId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/children/{childId}
@required {childId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/{employeeId}/occupationaldisabilities
@required {employeeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/{employeeId}/partners
@required {employeeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/partners
@required {employeeId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/partners/{partnerId}
@required {partnerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/partners/{partnerId}
@required {partnerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/partners/{partnerId}
@required {partnerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/{employeeId}/citizenservicenumber
@required {employeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/{employeeId}/citizenservicenumber
@required {employeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/{employeeId}/photo
@required {employeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/photo
@required {employeeId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/employees/{employeeId}/photo
@required {employeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/{employeeId}/photo/{version}
@required {employeeId: str(uuid), version: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/employee
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/{employeeId}/revokeEmployeeSelfServiceAccess
@required {employeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/employees/{employeeId}/customfields
@required {employeeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/customfields
@required {employeeId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/customfields/{employeeCustomFieldId}
@required {employeeCustomFieldId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/customfields/{employeeCustomFieldId}
@required {employeeCustomFieldId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/customfields/{employeeCustomFieldId}
@required {employeeCustomFieldId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/minimized
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/employers
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/employers/minimized
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/employers/informationForWizard
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/{employerId}
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/{employerId}/childEmployers
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250, includeParent: bool}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/functions
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/functions
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/functions/{functionId}
@required {functionId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/functions/{functionId}
@required {functionId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/{employerId}/departments
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/departments
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/departments/{departmentId}
@required {departmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/departments/{departmentId}
@required {departmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/{employerId}/useraccessibledepartments
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/logo
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/{employerId}/logo
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/logo
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/logo/{version}
@required {employerId: str(uuid), version: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/providerlogo
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/providerlogo/{version}
@required {employerId: str(uuid), version: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/dashboard
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/customfields
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/customfields
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/customfields/{customFieldId}
@required {customFieldId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/customfields/{customFieldId}
@required {customFieldId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/customfields/{customFieldId}
@required {customFieldId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/educationtypes
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/educationtypes
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/educationtypes/{educationTypeId}
@required {educationTypeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/educationtypes/{educationTypeId}
@required {educationTypeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/educationtypes/{educationTypeId}
@required {educationTypeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/educationfurtherindications
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/educationfurtherindications
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/educationfurtherindications/{educationFurtherIndicationId}
@required {educationFurtherIndicationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/educationfurtherindications/{educationFurtherIndicationId}
@required {educationFurtherIndicationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/educationfurtherindications/{educationFurtherIndicationId}
@required {educationFurtherIndicationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/contractcodes
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/contractcodes
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/contractcodes/{contractCodeId}
@required {contractCodeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/contractcodes/{contractCodeId}
@required {contractCodeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/contractcodes/{contractCodeId}
@required {contractCodeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/benefitinkindtypes
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/benefitinkindtypes
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/benefitinkindtypes/{benefitInKindTypeId}
@required {benefitInKindTypeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/benefitinkindtypes/{benefitInKindTypeId}
@required {benefitInKindTypeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/benefitinkindtypes/{benefitInKindTypeId}
@required {benefitInKindTypeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/customholidays
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/customholidays
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/customholidays/{customHolidayId}
@required {customHolidayId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/customholidays/{customHolidayId}
@required {customHolidayId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/customholidays/{customHolidayId}
@required {customHolidayId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group billing
@endpoint GET /billing/providers/employers/{employerId}/billableitems
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/{employerId}/nationalholidays
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/nationalholidays/{nationalHolidayId}
@required {employerId: str(uuid), nationalHolidayId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/{employerId}/nationalholidays/{nationalHolidayId}
@required {employerId: str(uuid), nationalHolidayId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/{employerId}/configuration
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/{employerId}/configuration
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/{employerId}/distributionunits
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/distributionunits
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/distributionunits/{distributionUnitId}
@required {distributionUnitId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/distributionunits/{distributionUnitId}
@required {distributionUnitId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endgroup

@group year
@endpoint PATCH /year/providers/employers/payrolladministrations/{payrollAdministrationId}/years/{yearId}/requestyeartransition
@required {payrollAdministrationId: str(uuid), yearId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint PATCH /year/providers/employers/payrolladministrations/years/{yearId}/undorequestyeartransition
@required {yearId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 409, 500}

@endpoint POST /year/providers/employers/payrolladministrations/years/{yearId}/requestyeartransition
@required {yearId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 409, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/{employerId}/conceptemployees/selfservice
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/conceptemployees/{conceptEmployeeId}/selfservice
@required {conceptEmployeeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/selfservice
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/{employerId}/employees/selfservice
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/employees/{employeeId}/selfservice
@required {employeeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/selfservice
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/selfservice/migration
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group person
@endpoint GET /person/account/person/employees/{employeeId}/information
@required {employeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/{employerId}/employees/essaccessstatus
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/{employerId}/employees/essaccessstatus
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/{employerId}/authorizations
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/authorizations
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/modules
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/{employerId}/modules
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/{providerId}/modules
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/conceptemployees
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/conceptemployees
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/conceptemployees/minimized/{conceptEmployeeId}
@required {conceptEmployeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/conceptemployees/minimized/{conceptEmployeeId}
@required {conceptEmployeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/conceptemployees/{conceptEmployeeId}
@required {conceptEmployeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/conceptemployees/{conceptEmployeeId}
@required {conceptEmployeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/conceptemployees/{conceptEmployeeId}
@required {conceptEmployeeId: str(uuid)}
@optional {deleteDocuments: bool}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/conceptemployees/{conceptEmployeeId}/citizenservicenumber
@required {conceptEmployeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/conceptemployees/{conceptEmployeeId}/citizenservicenumber
@required {conceptEmployeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint PATCH /v2/providers/employers/conceptemployees/{conceptEmployeeId}/convertToEmployee
@required {conceptEmployeeId: str(uuid)}
@optional {X-ValidateOnly: bool}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/conceptemployees/metadata/payrollAdministration/{payrollAdministrationId}/payScale/{payscaleKey}/paygrade/{paygradeKey}
@required {payrollAdministrationId: str(uuid), payscaleKey: int, paygradeKey: int}
@optional {date: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)

@endpoint GET /v2/providers/employers/conceptemployees/{conceptEmployeeId}/preboardingtrajectory
@required {conceptEmployeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/conceptemployees/{conceptEmployeeId}/preboardingtrajectory
@required {conceptEmployeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/conceptemployees/{conceptEmployeeId}/preboardingtrajectory
@required {conceptEmployeeId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/employees/employments/actualpaygradeamounts
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)

@endpoint POST /v2/providers/employers/conceptemployees/{conceptEmployeeId}/assessment/initiate
@required {conceptEmployeeId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/assessments
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/conceptemployees/{conceptEmployeeId}/contactpersons
@required {conceptEmployeeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/conceptemployees/{conceptEmployeeId}/contactpersons
@required {conceptEmployeeId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/conceptemployees/{conceptEmployeeId}/contactpersons/metadata
@required {conceptEmployeeId: str(uuid)}
@returns(200)
@errors {401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/conceptemployees/contactpersons/{contactPersonId}
@required {contactPersonId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/conceptemployees/contactpersons/{contactPersonId}
@required {contactPersonId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/conceptemployees/contactpersons/{contactPersonId}/metadata
@required {contactPersonId: str(uuid)}
@returns(200)
@errors {401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/notifications
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/notifications
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250, includeRead: bool=false}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/notifications
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/notifications/summary
@optional {startDate: str, endDate: str, filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/mutual/employers/notifications
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/notifications/{notificationId}
@required {notificationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/announcements
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/announcements
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250, includeRead: bool=false, includeExpired: bool=false, includeDescription: bool=false}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/announcements
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/announcements/summary
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/mutual/employers/announcements
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/announcements/{announcementId}
@required {announcementId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/minimized
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/comprehensive
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), removeEmptyLines: bool, filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/{employeeId}/employments
@required {employeeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/employments
@required {employeeId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/{employmentId}
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint PATCH /v2/providers/employers/employees/employments/{employmentId}
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/{employmentId}
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/transitioncompensation
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/employments/{employmentId}/employeeprofile
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/deleteinformation
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/employments/{employmentId}/terminate
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint PATCH /v2/providers/employers/employees/employments/{employmentId}/reinstate
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint PATCH /v2/providers/employers/employees/employments/{employmentId}/correctstartdate
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint PATCH /v2/providers/employers/{employerId}/payrollperioddata
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/payrollperioddata
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/payrollperioddata
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/employments/{employmentId}/payrollperioddata
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/payrollperioddata/{payrollperioddataId}
@required {payrollperioddataId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/payrollperioddata/{payrollperioddataId}
@required {payrollperioddataId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/payrollperioddata/{payrollperioddataId}
@required {payrollperioddataId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/benefitsanddeductions
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/benefitsanddeductions
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/benefitsAndDeductions/{benefitsanddeductionsId}
@required {benefitsanddeductionsId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/benefitsAndDeductions/{benefitsanddeductionsId}
@required {benefitsanddeductionsId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/benefitsAndDeductions/{benefitsanddeductionsId}
@required {benefitsanddeductionsId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/import/benefitsanddeductions"
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/import/benefitsanddeductions"
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 413, 415, 500}

@endpoint POST /v2/providers/employers/{employerId}/employees/employments/benefitsanddeductions
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/{employerId}/employees/employments/benefitsanddeductions
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/{employerId}/employees/employments/signalpaygradeadjustment
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/wageprojection
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/wageprojection/basedOnDefaultClaConfiguration
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group wageprojection
@endpoint GET /wageprojection/cladata/{collectiveLaborAgreementId}
@required {collectiveLaborAgreementId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /wageprojection/collectivelaboragreements
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/employees/{employeeId}/educations
@required {employeeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/educations
@required {employeeId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/educations/{employeeEducationId}
@required {employeeEducationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/educations/{employeeEducationId}
@required {employeeEducationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/educations/{employeeEducationId}
@required {employeeEducationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/declarations
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/declarations
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/declarations/{declarationId}
@required {declarationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/declarations/{declarationId}
@required {declarationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/declarations/{declarationId}
@required {declarationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/declarations/{declarationId}/audittrail
@required {declarationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/declarations/analyze/receipt
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/wages
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/wages
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/wages/{wageId}
@required {wageId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/wages/{wageId}
@required {wageId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/wages/{wageId}
@required {wageId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/import/wage"
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/import/wage"
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 413, 415, 500}

@endpoint POST /v2/providers/employers/{employerId}/employees/employments/wages
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/minimumwage
@required {employmentId: str(uuid), payscaleKey: int}
@optional {referenceDate: str(date), paygradeKey: int}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/costperhour
@required {employmentId: str(uuid)}
@optional {includeEstimation: bool, filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/costperhour
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/costperhour/{costPerHourId}
@required {costPerHourId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/costperhour/{costPerHourId}
@required {costPerHourId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/costperhour/{costPerHourId}
@required {costPerHourId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/workinghours
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/workinghours
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/workinghours/{workinghoursId}
@required {workinghoursId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/workinghours/{workinghoursId}
@required {workinghoursId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/workinghours/{workinghoursId}
@required {workinghoursId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/organizationalentities
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/organizationalentities
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/organizationalentities/{organizationalEntityId}
@required {organizationalEntityId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/organizationalentities/{organizationalEntityId}
@required {organizationalEntityId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/organizationalentities/{organizationalEntityId}
@required {organizationalEntityId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/paymentinformationsepa
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/paymentinformationsepa
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/paymentinformationsepa/{paymentInformationSepaId}
@required {paymentInformationSepaId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/paymentinformationsepa/{paymentInformationSepaId}
@required {paymentInformationSepaId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/paymentinformationsepa/{paymentInformationSepaId}
@required {paymentInformationSepaId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/paymentinformationsepaseparatepayments
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/paymentinformationsepaseparatepayments
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/paymentinformationsepaseparatepayments/{paymentInformationSepaSeparatePaymentId}
@required {paymentInformationSepaSeparatePaymentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/paymentinformationsepaseparatepayments/{paymentInformationSepaSeparatePaymentId}
@required {paymentInformationSepaSeparatePaymentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/paymentinformationsepaseparatepayments/{paymentInformationSepaSeparatePaymentId}
@required {paymentInformationSepaSeparatePaymentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/paymentinformationnonsepa
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/paymentinformationnonsepa
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/paymentinformationnonsepa/{paymentInformationNonSepaId}
@required {paymentInformationNonSepaId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/paymentinformationnonsepa/{paymentInformationNonSepaId}
@required {paymentInformationNonSepaId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/paymentinformationnonsepa/{paymentInformationNonSepaId}
@required {paymentInformationNonSepaId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/attachmentsofearnings
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/attachmentsofearnings
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/attachmentsofearnings/{attachmentOfEarningsId}
@required {attachmentOfEarningsId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/attachmentsofearnings/{attachmentOfEarningsId}
@required {attachmentOfEarningsId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/attachmentsofearnings/{attachmentOfEarningsId}
@required {attachmentOfEarningsId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/protectedearnings
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/protectedearnings
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/protectedearnings/{protectedEarningsId}
@required {protectedEarningsId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/protectedearnings/{protectedEarningsId}
@required {protectedEarningsId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/protectedearnings/{protectedEarningsId}
@required {protectedEarningsId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/fiscalproperties
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/fiscalproperties
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/fiscalproperties/{fiscalPropertiesId}
@required {fiscalPropertiesId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/fiscalproperties/{fiscalPropertiesId}
@required {fiscalPropertiesId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/fiscalproperties/{fiscalPropertiesId}
@required {fiscalPropertiesId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/employees/employments/calculatedannualsalary
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/employees/employments/fiscalproperties
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/fiscalcompanycars
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/fiscalcompanycars
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/fiscalcompanycars/{fiscalCompanyCarId}
@required {fiscalCompanyCarId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/fiscalcompanycars/{fiscalCompanyCarId}
@required {fiscalCompanyCarId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/fiscalcompanycars/{fiscalCompanyCarId}
@required {fiscalCompanyCarId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/import/fiscalcompanycars
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 413, 415, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/companycars
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/companycars
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/companycars/{companyCarId}
@required {companyCarId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/companycars/{companyCarId}
@required {companyCarId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/companycars/{companyCarId}
@required {companyCarId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group rdwservices
@endpoint GET /rdwservices/additionaltaxliability
@required {licensePlateNumber: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/employmentfunds
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/employmentfunds
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/employmentfunds/{employmentFundId}
@required {employmentFundId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/employmentfunds/{employmentFundId}
@required {employmentFundId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/employmentfunds/{employmentFundId}
@required {employmentFundId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/abpfunds
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/abpfunds
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/abpfunds/{abpFundId}
@required {abpFundId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/abpfunds/{abpFundId}
@required {abpFundId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/abpfunds/{abpFundId}
@required {abpFundId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/employees/employments/employmentfunds
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/{employerId}/employees/employments/employmentfunds
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/employees/employments/abpfunds
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/{employerId}/employees/employments/abpfunds
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/basesforemploymentfundcalculation
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/basesforemploymentfundcalculation
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/basesforemploymentfundcalculation/{baseforemploymentfundcalculationId}
@required {baseforemploymentfundcalculationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/basesforemploymentfundcalculation/{baseforemploymentfundcalculationId}
@required {baseforemploymentfundcalculationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/basesforemploymentfundcalculation/{baseforemploymentfundcalculationId}
@required {baseforemploymentfundcalculationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/basesforcalculation
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/basesforcalculation
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/basesforcalculation/{baseforcalculationId}
@required {baseforcalculationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/basesforcalculation/{baseforcalculationId}
@required {baseforcalculationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/basesforcalculation/{baseforcalculationId}
@required {baseforcalculationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/employees/employments/basesforcalculation
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/{employerId}/employees/employments/basesforcalculation
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/deviatingawfcontributions
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/deviatingawfcontributions
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/deviatingawfcontributions/{deviatingAwfContributionId}
@required {deviatingAwfContributionId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/deviatingawfcontributions/{deviatingAwfContributionId}
@required {deviatingAwfContributionId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/deviatingawfcontributions/{deviatingAwfContributionId}
@required {deviatingAwfContributionId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/pensionbenefits
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/pensionbenefits
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/pensionbenefits/{pensionBenefitId}
@required {pensionBenefitId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/pensionbenefits/{pensionBenefitId}
@required {pensionBenefitId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/pensionbenefits/{pensionBenefitId}
@required {pensionBenefitId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/deviatinghourlywages
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/deviatinghourlywages
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/deviatinghourlywages/{deviatingHourlyWageId}
@required {deviatingHourlyWageId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/deviatinghourlywages/{deviatingHourlyWageId}
@required {deviatingHourlyWageId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/deviatinghourlywages/{deviatingHourlyWageId}
@required {deviatingHourlyWageId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/benefitsInKind
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/benefitsInKind
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/benefitsinkind/{benefitInKindId}
@required {benefitInKindId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/benefitsinkind/{benefitInKindId}
@required {benefitInKindId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/benefitsinkind/{benefitInKindId}
@required {benefitInKindId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/customnotifications
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/customnotifications
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/customnotifications/{customNotificationId}
@required {customNotificationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/customnotifications/{customNotificationId}
@required {customNotificationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/customnotifications/{customNotificationId}
@required {customNotificationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/customfields
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/customfields
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/customfields/{employmentCustomFieldId}
@required {employmentCustomFieldId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/customfields/{employmentCustomFieldId}
@required {employmentCustomFieldId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/customfields/{employmentCustomFieldId}
@required {employmentCustomFieldId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/otherPayrollVariables
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/otherPayrollVariables
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/otherPayrollVariables/{otherPayrollVariablesId}
@required {otherPayrollVariablesId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/otherPayrollVariables/{otherPayrollVariablesId}
@required {otherPayrollVariablesId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/otherPayrollVariables/{otherPayrollVariablesId}
@required {otherPayrollVariablesId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/socialsecurityconfigurations
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/socialsecurityconfigurations
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/socialsecurityconfigurations/{socialSecurityConfigurationId}
@required {socialSecurityConfigurationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/socialsecurityconfigurations/{socialSecurityConfigurationId}
@required {socialSecurityConfigurationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/socialsecurityconfigurations/{socialSecurityConfigurationId}
@required {socialSecurityConfigurationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/socialsecuritybenefits
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/socialsecuritybenefits
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/socialsecuritybenefits/{socialSecurityBenefitId}
@required {socialSecurityBenefitId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/socialsecuritybenefits/{socialSecurityBenefitId}
@required {socialSecurityBenefitId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/socialsecuritybenefits/{socialSecurityBenefitId}
@required {socialSecurityBenefitId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/healthcareinsuranceactconfigurations
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/healthcareinsuranceactconfigurations
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/healthcareinsuranceactconfigurations/{healthcareInsuranceActConfigurationId}
@required {healthcareInsuranceActConfigurationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/healthcareinsuranceactconfigurations/{healthcareInsuranceActConfigurationId}
@required {healthcareInsuranceActConfigurationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/healthcareinsuranceactconfigurations/{healthcareInsuranceActConfigurationId}
@required {healthcareInsuranceActConfigurationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/wachtgeld
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/wachtgeld
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/wachtgeld/{wachtgeldId}
@required {wachtgeldId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/wachtgeld/{wachtgeldId}
@required {wachtgeldId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/wachtgeld/{wachtgeldId}
@required {wachtgeldId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/contacts
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/children
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/citizenservicenumbers
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/customfields
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/partners
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/customfields
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/paymentinformationsepa
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/actualorganizationalentities
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/actualwages
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/actualworkinghours
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualbenefitsanddeductions
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualemploymentfunds
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualabpfunds
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualfiscalproperties
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualhealthcareinsuranceactconfigurations
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualsocialsecurityconfigurations
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualsocialsecuritybenefits
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualdeviatingawfcontributions
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualbenefitsinkind
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualcompanycars
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualfiscalcompanycars
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualjournalallocations
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualbasesforcalculation
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualotherpayrollvariables
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualpaymentinformationnonsepa
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualbasesforemploymentfundcalculation
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualpensionbenefits
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualdeviatinghourlywages
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/actualcostperhour
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), includeEstimation: bool, filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group achmeainsurancecontracts
@endpoint GET /achmeainsurancecontracts
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /achmeainsurancecontracts/{achmeaInsuranceContractId}/insuredwagecalculationpercentages
@required {achmeaInsuranceContractId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/employees/{employeeId}/benifyurl
@required {employeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group users
@endpoint GET /users/yourcampus
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group qwoater
@endpoint GET /qwoater/employers
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/{employerId}/leavePolicies
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/leavePolicies
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/{employerId}/leavePolicies
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/leavePolicies/{leavePolicyId}
@required {leavePolicyId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/leavePolicies/{leavePolicyId}
@required {leavePolicyId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/leavePolicies/{leavePolicyId}
@required {leavePolicyId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/leavePolicies/{leavePolicyId}/agebasedleave
@required {leavePolicyId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/leavePolicies/{leavePolicyId}/agebasedleave
@required {leavePolicyId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/leavePolicies/agebasedleave/{ageBasedLeaveId}
@required {ageBasedLeaveId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/leavePolicies/agebasedleave/{ageBasedLeaveId}
@required {ageBasedLeaveId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/leavePolicies/agebasedleave/{ageBasedLeaveId}
@required {ageBasedLeaveId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/leavePolicies/{leavePolicyId}/yearsofservicebasedleave
@required {leavePolicyId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/leavePolicies/{leavePolicyId}/yearsofservicebasedleave
@required {leavePolicyId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/leavePolicies/yearsofservicebasedleave/{yearsOfServiceBasedLeaveId}
@required {yearsOfServiceBasedLeaveId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/leavePolicies/yearsofservicebasedleave/{yearsOfServiceBasedLeaveId}
@required {yearsOfServiceBasedLeaveId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/leavePolicies/yearsofservicebasedleave/{yearsOfServiceBasedLeaveId}
@required {yearsOfServiceBasedLeaveId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/leavePolicies/{leavePolicyId}/wagebasedleave
@required {leavePolicyId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/leavePolicies/{leavePolicyId}/wagebasedleave
@required {leavePolicyId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/leavePolicies/wagebasedleave/{wageBasedLeaveId}
@required {wageBasedLeaveId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/leavePolicies/wagebasedleave/{wageBasedLeaveId}
@required {wageBasedLeaveId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/leavePolicies/wagebasedleave/{wageBasedLeaveId}
@required {wageBasedLeaveId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/leavepolicies/{leavePolicyId}/employments
@required {leavePolicyId: str(uuid)}
@optional {orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/leavepolicies/{leavePolicyId}/employments
@required {leavePolicyId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/leavepolicies/{leavePolicyId}/employments/leave/accrual
@required {leavePolicyId: str(uuid)}
@optional {year: int(int32), month: int(int32), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/leavepolicies/{leavePolicyId}/employments/{employmentId}/leave/accrual"
@required {leavePolicyId: str(uuid), employmentId: str(uuid)}
@optional {year: int(int32), month: int(int32)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/leavepolicies/{leavePolicyId}/employments/leave/entitlement
@required {leavePolicyId: str(uuid)}
@optional {year: int(int32), month: int(int32), overridingEmploymentEndDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/leavepolicies/{leavePolicyId}/employments/{employmentId}/leave/entitlement"
@required {leavePolicyId: str(uuid), employmentId: str(uuid)}
@optional {year: int(int32), month: int(int32), overridingEmploymentEndDate: str(date)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/{employerId}/employees/employments/leave/entitlement
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/employments/{employmentId}/leave/entitlement"
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/leavePolicies
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/leavePolicies
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/leavePolicies/{leavePolicyId}
@required {leavePolicyId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/leavePolicies/{leavePolicyId}
@required {leavePolicyId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/leavePolicies/{leavePolicyId}
@required {leavePolicyId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/leavePolicies/{leavePolicyId}/agebasedleave
@required {leavePolicyId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/leavePolicies/{leavePolicyId}/agebasedleave
@required {leavePolicyId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/leavePolicies/agebasedleave/{ageBasedLeaveId}
@required {ageBasedLeaveId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/leavePolicies/agebasedleave/{ageBasedLeaveId}
@required {ageBasedLeaveId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/leavePolicies/agebasedleave/{ageBasedLeaveId}
@required {ageBasedLeaveId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/leavePolicies/{leavePolicyId}/yearsofservicebasedleave
@required {leavePolicyId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/leavePolicies/{leavePolicyId}/yearsofservicebasedleave
@required {leavePolicyId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/leavePolicies/yearsofservicebasedleave/{yearsOfServiceBasedLeaveId}
@required {yearsOfServiceBasedLeaveId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/leavePolicies/yearsofservicebasedleave/{yearsOfServiceBasedLeaveId}
@required {yearsOfServiceBasedLeaveId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/leavePolicies/yearsofservicebasedleave/{yearsOfServiceBasedLeaveId}
@required {yearsOfServiceBasedLeaveId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/leavePolicies/{leavePolicyId}/wagebasedleave
@required {leavePolicyId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/leavePolicies/{leavePolicyId}/wagebasedleave
@required {leavePolicyId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/leavePolicies/agebasedleave/{wageBasedLeaveId}
@required {wageBasedLeaveId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/leavePolicies/agebasedleave/{wageBasedLeaveId}
@required {wageBasedLeaveId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/leavePolicies/agebasedleave/{wageBasedLeaveId}
@required {wageBasedLeaveId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/leavetypes
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/leavetypes/{leaveTypeId}
@required {employerId: str(uuid), leaveTypeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/{employerId}/leavetypes/{leaveTypeId}
@required {employerId: str(uuid), leaveTypeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/leaverequests
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/employments/leaverequests
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/leaverequests/currentlyAvailableUnits
@required {leaveRequestIds: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/leave
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/leave
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/leave/{leaveId}
@required {leaveId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/leave/{leaveId}
@required {leaveId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/leave/{leaveId}
@required {leaveId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/leave/metadata
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/leave/defaults
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/leave/{leaveId}/metadata
@required {leaveId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/leave/proposedleavehours
@required {employmentId: str(uuid)}
@optional {startDate: str, endDate: str, filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/leave/proposedleavehours
@required {employerId: str(uuid)}
@optional {startDate: str, endDate: str, filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/leave/overview/{year}
@required {employmentId: str(uuid), year: int(int32)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/leaverequests
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/leaverequests
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/leaverequests/{leaveRequestId}
@required {leaveRequestId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/leaverequests/{leaveRequestId}
@required {leaveRequestId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/leavebalances
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/leavebalances
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), leaveType: [int], filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/leavebalances/worth
@required {employerId: str(uuid)}
@optional {referenceDate: str(date), leaveType: [int], filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/leavebalances/grouped
@required {employerId: str(uuid), groupBy: str(Department/Function)}
@optional {referenceDate: str(date), leaveType: [int], orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/leavepolicies
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/employments/{employmentId}/leavepolicies
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/{employerId}/import/leave"
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/import/leave"
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 413, 415, 500}

@endpoint POST /v2/providers/employers/{employerId}/leave
@required {employerId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollprocessoverview
@required {payrollAdministrationId: str(uuid), payrollPeriodIdStart: int(int32)}
@optional {payrollPeriodIdEnd: int(int32)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollruns
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}
@required {payrollrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}
@required {payrollrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/payrollruns
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/periodreadyforpayroll
@required {payrollAdministrationId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/payslips
@required {payrollrunId: str(uuid)}
@optional {sortOnField: str(employeeNumber/lastName/firstName)=employeeNumber, includeEmploymentsWithMijnLoketAccess: bool=true}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/defaultset
@required {payrollrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/paymentoverviews
@required {payrollrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/wagesheets
@required {payrollrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/sepafiles
@required {payrollrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/sepahashes
@required {payrollrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/sepafiles/{sepafileId}
@required {sepafileId: str(uuid), requestedExecutionDate: str(date)}
@optional {paymentType: str(Other/Salary)=Salary, batchBooking: str(BtchBookgExclude/BtchBookgTrue/BtchBookgFalse)=BtchBookgExclude}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/totalsepafile
@required {payrollrunId: str(uuid), requestedExecutionDate: str(date)}
@optional {paymentType: str(Other/Salary)=Salary, batchBooking: str(BtchBookgExclude/BtchBookgTrue/BtchBookgFalse)=BtchBookgExclude}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/runoverviews
@required {payrollrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/payrollcontrolregister
@required {payrollrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/journalentriesperdistributionunitoverviews
@required {payrollrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/errorsandwarnings
@required {payrollrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/nonsepafile
@required {payrollrunId: str(uuid), requestedExecutionDate: str(date)}
@optional {paymentReason: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollPeriodDataAuditTrail
@required {payrollAdministrationId: str(uuid), startDate: str, endDate: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/employmentPayrollDataAuditTrail
@required {payrollAdministrationId: str(uuid), startDate: str, endDate: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollperiods
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollperiods/minimized
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollperiods/{payrollPeriodId}/payrollresults
@required {payrollAdministrationId: str(uuid), payrollPeriodId: int(int32)}
@optional {payrollComponents: [int(int32)], payrollComponentSet: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollperiods/compare
@required {payrollAdministrationId: str(uuid), payrollPeriodId: int(int32)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/payrollresults/statistics/data
@required {employerId: str(uuid), startDate: str, endDate: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/payrollperiods/payrollcomponents/{payrollComponent}
@required {payrollAdministrationId: str(uuid), payrollPeriodIdStart: int(int32), payrollPeriodIdEnd: int(int32)}
@optional {payrollComponents: [int(int32)]}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollperiods/payrollresults/compare
@required {payrollPeriodIdToCompare: int(int32), payrollPeriodIdCompareTo: int(int32), payrollComponentId: int(int32), tableTariff: str(table/tariff/tableAndTariff), includeFromDeviationPercentage: num(double), sort: str(employerName/administrationName/clientNumber/administrationNumber/percentageDifference)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/results
@required {payrollrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/BalanceSheet
@required {payrollrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollresults
@required {payrollAdministrationId: str(uuid), payrollPeriodIdStart: int(int32), payrollPeriodIdEnd: int(int32)}
@optional {payrollComponentSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/payrollresults"
@required {payrollrunId: str(uuid)}
@optional {payrollComponentSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollperiods/payrollresults"
@required {payrollAdministrationId: str(uuid), payrollPeriodIdStart: int(int32), payrollPeriodIdEnd: int(int32)}
@optional {payrollComponentSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollperiods/payrollresults/grouped"
@required {payrollAdministrationId: str(uuid), payrollPeriodIdStart: int(int32), payrollPeriodIdEnd: int(int32)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /providers
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/logo
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/logo/{version}
@required {providerId: str(uuid), version: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/contactinformation
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group billing
@endpoint GET /billing/providers/{providerId}/billableitems
@required {startDate: str, endDate: str, providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/{providerId}/dashboard
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/logos
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/logos
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/logos/{logoId}
@required {logoId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/logos/{logoId}
@required {logoId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/logos/{logoId}
@required {logoId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/logos/{logoId}/logo
@required {logoId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/configuration
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/{providerId}/configuration
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/{providerId}/configuration/payslip
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/{providerId}/configuration/payslip
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/{providerId}/configuration/payslip/logo
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/{providerId}/configuration/payslip/logo
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/configuration/payslip/logo
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/notificationsettings
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/{providerId}/notificationsettings
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/groupclassifications
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/groupclassifications
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/groupclassifications/{groupClassificationId}
@required {groupClassificationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/groupclassifications/{groupClassificationId}
@required {groupClassificationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/workrelatedcostsutilization
@required {year: int(int32), sort: str(employerName/administrationName/clientNumber/administrationNumber/percentageUtilization)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group qwoatermicroservice
@endpoint GET /qwoatermicroservice/providers/employers/dossier/usage
@optional {referenceDate: str(date)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /qwoatermicroservice/providers/employers/signature/usage
@required {startDate: str, endDate: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/{providerId}/authorizationsets
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/authorizationsets
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/authorizationsets/{authorizationSetId}
@required {authorizationSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/authorizationsets/{authorizationSetId}
@required {authorizationSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/authorizationsets/{authorizationSetId}
@required {authorizationSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/modulesets
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/modulesets
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/modulesets/{moduleSetId}
@required {moduleSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/modulesets/{moduleSetId}
@required {moduleSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/modulesets/{moduleSetId}
@required {moduleSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/moduleset
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/{employerId}/moduleset
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/notificationsets
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/notificationsets
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/notificationsets/{notificationSetId}
@required {notificationSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/notificationsets/{notificationSetId}
@required {notificationSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/notificationsets/{notificationSetId}
@required {notificationSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/payrollruns/status
@required {payrollPeriodId: int(int32)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/payrolltaxreturns/status"
@required {payrollPeriodId: int(int32)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/pensiondeclaration/status
@required {payrollPeriodId: int(int32)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group year
@endpoint GET /year/providers/employers/payrolladministrations/years/{year}/status
@required {year: int(int32)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/journalruns
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalruns/{journalrunId}
@required {journalrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/journalruns/{journalrunId}
@required {journalrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/journalruns/initiate
@required {payrollAdministrationId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/journalruns/{journalrunId}/undo
@required {journalrunId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/journalruns/recalculate
@required {payrollrunId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalruns/{journalrunId}/results
@required {journalrunId: str(uuid)}
@optional {consolidate: str(BasedOnLedgerAccountConfiguration/Always/Never)=BasedOnLedgerAccountConfiguration}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/journalruns/cumulativeresults
@required {payrollAdministrationId: str(uuid), startPeriod: int, endPeriod: int}
@optional {consolidate: str(BasedOnLedgerAccountConfiguration/Always/Never)=BasedOnLedgerAccountConfiguration}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalruns/{journalrunId}/report
@required {journalrunId: str(uuid)}
@optional {consolidate: str(BasedOnLedgerAccountConfiguration/Always/Never)=BasedOnLedgerAccountConfiguration}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalruns/{journalrunId}/runoverview
@required {journalrunId: str(uuid), reportJournalNumber: int(int32), reportVoucherNumber: int(int32), reportYear: int(int32), reportPeriodNumber: int(int32), reportDate: str(date)}
@optional {reportDescription: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalruns/{journalrunId}/runoverviewperemployment
@required {journalrunId: str(uuid), reportJournalNumber: int(int32), reportVoucherNumber: int(int32), reportYear: int(int32), reportPeriodNumber: int(int32), reportDate: str(date)}
@optional {reportDescription: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalruns/{journalrunId}/exportAuditTrail
@required {journalrunId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalruns/{journalrunId}/errors
@required {journalrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/journalruns/{journalrunId}/send
@required {journalrunId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 409, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/journalruns/{journalrunId}/download
@required {journalrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/journalConfigurations
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/journalConfigurations
@required {payrollAdministrationId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalConfigurations/{journalConfigurationId}
@required {journalConfigurationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/payrolladministrations/journalConfigurations/{journalConfigurationId}
@required {journalConfigurationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/payrolladministrations/journalConfigurations/{journalConfigurationId}
@required {journalConfigurationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalConfigurations/{journalConfigurationId}/journalApplication
@required {journalConfigurationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/journalConfigurations/{journalConfigurationId}/journalApplication
@required {journalConfigurationId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/journalConfigurations/{journalConfigurationId}/journalApplication
@required {journalConfigurationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/payrolladministrations/journalConfigurations/{journalConfigurationId}/journalApplication
@required {journalConfigurationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/journalProfiles
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/journalProfiles
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/journalProfiles/{journalProfileId}
@required {journalProfileId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/journalProfiles/{journalProfileId}
@required {journalProfileId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/journalProfiles/{journalProfileId}
@required {journalProfileId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/journalProfiles/{journalProfileId}/ledgerAccounts
@required {journalProfileId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/journalProfiles/{journalProfileId}/ledgerAccounts
@required {journalProfileId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/journalProfiles/ledgerAccounts/{ledgerAccountId}
@required {ledgerAccountId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/journalProfiles/ledgerAccounts/{ledgerAccountId}
@required {ledgerAccountId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/journalProfiles/ledgerAccounts/{ledgerAccountId}
@required {ledgerAccountId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/journalProfiles/{journalProfileId}/ledgerAccountToPayrollComponentLinks"
@required {journalProfileId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/journalProfiles/{journalProfileId}/ledgerAccountToPayrollComponentLinks"
@required {journalProfileId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/journalProfiles/ledgerAccountToPayrollComponentLinks/{ledgerAccountToPayrollComponentLinkId}
@required {ledgerAccountToPayrollComponentLinkId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/journalProfiles/ledgerAccountToPayrollComponentLinks/{ledgerAccountToPayrollComponentLinkId}
@required {ledgerAccountToPayrollComponentLinkId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/journalProfiles/ledgerAccountToPayrollComponentLinks/{ledgerAccountToPayrollComponentLinkId}
@required {ledgerAccountToPayrollComponentLinkId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/journalProfiles/{journalProfileId}/costCenters
@required {journalProfileId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/journalProfiles/{journalProfileId}/costCenters
@required {journalProfileId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/journalProfiles/costCenters/{costCenterId}
@required {costCenterId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/journalProfiles/costCenters/{costCenterId}
@required {costCenterId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/journalProfiles/costCenters/{costCenterId}
@required {costCenterId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/journalProfiles/{journalProfileId}/costUnits
@required {journalProfileId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/journalProfiles/{journalProfileId}/costUnits
@required {journalProfileId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/journalProfiles/costUnits/{costUnitId}
@required {costUnitId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/journalProfiles/costUnits/{costUnitId}
@required {costUnitId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/journalProfiles/costUnits/{costUnitId}
@required {costUnitId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/journalprofiles/{journalProfileId}/CostCenterCostUnitMatrix
@required {journalProfileId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/journalprofiles/{journalProfileId}/CostCenterCostUnitMatrix
@required {journalProfileId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/journalProfiles
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalProfiles/{journalProfileId}
@required {journalProfileId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/journalProfiles/{journalProfileId}
@required {journalProfileId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalProfiles/{journalProfileId}/ledgerAccounts
@required {journalProfileId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/journalProfiles/{journalProfileId}/ledgerAccounts
@required {journalProfileId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalProfiles/ledgerAccounts/{ledgerAccountId}
@required {ledgerAccountId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/journalProfiles/ledgerAccounts/{ledgerAccountId}
@required {ledgerAccountId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/payrolladministrations/journalProfiles/ledgerAccounts/{ledgerAccountId}
@required {ledgerAccountId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalProfiles/{journalProfileId}/ledgerAccountToPayrollComponentLinks
@required {journalProfileId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/journalProfiles/{journalProfileId}/ledgerAccountToPayrollComponentLinks
@required {payrollAdministrationId: str(uuid), journalProfileId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalProfiles/{journalProfileId}/ledgerAccountToPayrollComponentLinks/metadata
@required {journalProfileId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalProfiles/ledgerAccountToPayrollComponentLinks/{ledgerAccountToPayrollComponentLinkId}
@required {ledgerAccountToPayrollComponentLinkId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/journalProfiles/ledgerAccountToPayrollComponentLinks/{ledgerAccountToPayrollComponentLinkId}
@required {ledgerAccountToPayrollComponentLinkId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/payrolladministrations/journalProfiles/ledgerAccountToPayrollComponentLinks/{ledgerAccountToPayrollComponentLinkId}
@required {ledgerAccountToPayrollComponentLinkId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalProfiles/{journalProfileId}/costCenters
@required {journalProfileId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/journalProfiles/{journalProfileId}/costCenters
@required {journalProfileId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalProfiles/costCenters/{costCenterId}
@required {costCenterId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/journalProfiles/costCenters/{costCenterId}
@required {costCenterId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/payrolladministrations/journalProfiles/costCenters/{costCenterId}
@required {costCenterId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalProfiles/{journalProfileId}/costUnits
@required {journalProfileId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/journalProfiles/{journalProfileId}/costUnits
@required {journalProfileId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalProfiles/costUnits/{costUnitId}
@required {costUnitId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/journalProfiles/costUnits/{costUnitId}
@required {costUnitId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/payrolladministrations/journalProfiles/costUnits/{costUnitId}
@required {costUnitId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/journalProfiles/{journalProfileId}/CostCenterCostUnitMatrix
@required {journalProfileId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/journalProfiles/{journalProfileId}/CostCenterCostUnitMatrix
@required {journalProfileId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/journalallocations
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/journalallocations
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/journalallocations/{journalAllocationId}
@required {journalAllocationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/journalallocations/{journalAllocationId}
@required {journalAllocationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/journalallocations/{journalAllocationId}
@required {journalAllocationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group user
@endpoint GET /user
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /user/{userId}
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /user/{userId}
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /user/photo
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /user/photo
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /user/photo
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group globalfilter
@endpoint GET /globalfilter/user/filtersettings/{employerId}
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /globalfilter/user/filtersettings/{employerId}
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/{providerId}/users
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/users
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/users/{userId}
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/users/{userId}
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/users/{userId}
@required {userId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/users/{userId}/access
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/users/invite
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/users/{userId}/invite
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/users/{userId}/authorizations
@required {userId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/users/{userId}/authorizations
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/users/{userId}/authorizationSet
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/users/{userId}/authorizationGroups
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/users/{userId}/authorizationGroups
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/users/{userId}/clients
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/authorizationgroups
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/authorizationgroups
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/authorizationgroups/{authorizationGroupId}
@required {authorizationGroupId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/authorizationgroups/{authorizationGroupId}
@required {authorizationGroupId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/authorizationgroups/{authorizationGroupId}
@required {authorizationGroupId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/authorizationgroups/{authorizationGroupId}/authorizations
@required {authorizationGroupId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/authorizationgroups/{authorizationGroupId}/authorizations
@required {authorizationGroupId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/authorizationgroups/{authorizationGroupId}/employers
@required {authorizationGroupId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/authorizationgroups/{authorizationGroupId}/employers
@required {authorizationGroupId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/authorizationgroups/{authorizationGroupId}/users
@required {authorizationGroupId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/authorizationgroups/{authorizationGroupId}/users
@required {authorizationGroupId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/employers/{employerId}/authorizationGroups
@required {providerId: str(uuid), employerId: str(uuid)}
@optional {includeAddEmployerWizardInformation: bool=false, filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/{providerId}/employers/{employerId}/authorizationGroups
@required {providerId: str(uuid), employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group users
@endpoint GET /users/integrations
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/users/{userId}/integrations
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/users/{userId}/integrations/{applicationId}
@required {userId: str(uuid), applicationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/users/{userId}/integrations/{applicationId}
@required {userId: str(uuid), applicationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/users/{userId}/integrations/{applicationId}/logo
@required {userId: str(uuid), applicationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/users/{userId}/integrations
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/users/{userId}/integrations/{applicationId}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/users/{userId}/integrations/{applicationId}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/users/{userId}/integrations/{applicationId}/logo
@required {userId: str(uuid), applicationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group users
@endpoint GET /users/clients
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/users/{userId}/clients
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group users
@endpoint GET /users/connectedApplications
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /users/connectedApplications
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /users/connectedApplications/initiate
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /users/connectedApplications/refresh
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /users/connectedApplications/{connectedApplicationId}
@required {connectedApplicationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/users/{userId}/connectedApplications
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/users/{userId}/connectedApplications/initiate
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/users/{userId}/connectedApplications/refresh
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/users/connectedApplications/{connectedApplicationId}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/users
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/users
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/users/{userId}/access
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/users/invite
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/users/{userId}/invite
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/users/{userId}
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/users/{userId}
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/users/{userId}
@required {userId: str(uuid)}
@optional {transferNotificationsTo: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/users/{userId}/informationForDelete
@required {userId: str(uuid), employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/{employerId}/users/{userId}
@required {employerId: str(uuid), userId: str(uuid)}
@optional {transferNotificationsTo: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/employers/users
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/users/{userId}/employers
@required {userId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/users/departments
@required {employerId: str(uuid)}
@optional {orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/{employerId}/users/{userId}/departments
@required {employerId: str(uuid), userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/users/{userId}/notificationsettings
@required {userId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/users/{userId}/notificationsettings
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/users/{userId}/notificationset
@required {userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/users/{userId}/authorizations
@required {employerId: str(uuid), userId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/{employerId}/users/{userId}/authorizations
@required {employerId: str(uuid), userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/users/{userId}/authorizationSet
@required {employerId: str(uuid), userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/users/link
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/recommendedactions
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/users/{userId}/employee
@required {employerId: str(uuid), userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/{employerId}/users/{userId}/employee
@required {employerId: str(uuid), userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/{providerId}/userResponsibilities
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/userResponsibilities
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/{providerId}/userResponsibilities/{userResponsibilityId}
@required {userResponsibilityId: str(uuid), providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/{employerId}/userResponsibilities
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/userResponsibilities/{userResponsibilityId}/users
@required {userResponsibilityId: str(uuid), employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/{employerId}/userResponsibilities/{userResponsibilityId}/users
@required {userResponsibilityId: str(uuid), employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/users/{userId}/userResponsibilities
@required {employerId: str(uuid), userId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/{employerId}/users/{userId}/userResponsibilities
@required {employerId: str(uuid), userId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/dashboardLicenses
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/{employerId}/dashboardLicenses
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/{providerId}/externaltenants
@required {providerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/externaltenants
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/users/{providerUserId}/configuredexternaltenant
@required {providerUserId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/users/{providerUserId}/configuredexternaltenant
@required {providerUserId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/users/{employerUserId}/configuredexternaltenant
@required {employerUserId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/users/{employerUserId}/configuredexternaltenant
@required {employerUserId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/payslips
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/payslips/{year}
@required {employmentId: str(uuid), year: int(int32)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/payslips/{payrollrunId}
@required {employmentId: str(uuid), payrollrunId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/payrollperiodresults/year/{year}
@required {employmentId: str(uuid), year: int(int32)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/payslips/summary/{payrollPeriodId}
@required {employmentId: str(uuid), payrollPeriodId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/wagesheet/{year}
@required {employmentId: str(uuid), year: int(int32)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/yearendstatements
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/yearendstatements/{year}
@required {employmentId: str(uuid), year: int(int32)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/yearendstatements
@required {payrollAdministrationId: str(uuid)}
@optional {includeEmploymentsWithMijnLoketAccess: bool=true, filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/yearendstatements/{year}
@required {payrollAdministrationId: str(uuid), year: int(int32)}
@optional {includeEmployeeSelfService: bool}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrolltaxreturns
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/payrolltaxreturns
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrolltaxreturns/{payrolltaxreturnId}/overview
@required {payrolltaxreturnId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrolltaxreturns/{payrolltaxreturnId}/message
@required {payrolltaxreturnId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrolltaxreturns/{payrolltaxreturnId}/sepafile
@required {payrollAdministrationId: str(uuid), payrolltaxreturnId: str(uuid), requestedExecutionDate: str(date)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrolltaxreturns/{payrolltaxreturnId}/sepahash
@required {payrolltaxreturnId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrolltaxreturns/{payrolltaxreturnId}
@required {payrolltaxreturnId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrolltaxreturns/{payrolltaxreturnId}/ideal
@required {payrolltaxreturnId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrolltaxreturns/{payrolltaxreturnId}/idealPaymentStatus
@required {payrolltaxreturnId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrolltaxreturns/{payrolltaxreturnId}/report
@required {payrolltaxreturnId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/payrolltaxreturns/{payrolltaxreturnId}/sendresponsemessage
@required {payrolltaxreturnId: str(uuid)}
@optional {responseMessageFile: str}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/payrolltaxreturns/{messageReference}
@required {messageReference: str, action: str(confirm/cancel)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/payrolltaxreturns/{messageReference}/sendresponsemessagebymessagereference
@required {messageReference: str}
@optional {responseMessageFile: str}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrolltaxreturns/initiate
@required {payrollAdministrationId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrolltaxreturns/initiateForPreviousYear
@required {payrollAdministrationId: str(uuid)}
@optional {X-ValidateOnly: bool}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrolltaxreturns/initiateAnnual
@required {payrollAdministrationId: str(uuid)}
@optional {X-ValidateOnly: bool}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/payrolltaxreturns
@required {payrollPeriodId: int(int32)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/payrolltaxreturns
@required {payrollPeriodId: int(int32)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/payrolltaxreturns/{payrolltaxreturnId}/undo
@required {payrolltaxreturnId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrolltaxreturns/withdrawIncomeRelationshipNumber
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/payrolltaxreturns/{payrolltaxreturnId}/resend
@required {payrolltaxreturnId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group locationservices
@endpoint GET /locationservices/address
@required {postalCode: str, houseNumber: int}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group address
@endpoint GET /address/search
@required {query: str}
@optional {lat: num(double), lon: num(double), top: int(int32)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group route
@endpoint GET /route/calculate
@required {query: str, routeType: str(fastest/shortest)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group aowDate
@endpoint GET /aowDate
@required {dateOfBirth: str(date)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group chamberofcommerce
@endpoint GET /chamberofcommerce/{chamberOfCommerceNumber}/companyinformation
@required {chamberOfCommerceNumber: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/{employerId}/datanewbusinesstoken
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group datanewbusiness
@endpoint GET /datanewbusiness/token
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /datanewbusiness/functions
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/{employerId}/employees/employments/calendar/availablehours
@required {employerId: str(uuid), startDate: str(date), endDate: str(date)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/calendar/leave
@required {employerId: str(uuid), startDate: str(date), endDate: str(date)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/calendar/leaverequests
@required {employerId: str(uuid), startDate: str(date), endDate: str(date)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/calendar/revokeleaverequests
@required {employerId: str(uuid), startDate: str(date), endDate: str(date)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/calendar/absences
@required {employerId: str(uuid), startDate: str(date), endDate: str(date)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/teamCalendar
@required {employmentId: str(uuid), startDate: str(date), endDate: str(date)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/personalCalendar
@required {employmentId: str(uuid), startDate: str(date), endDate: str(date)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employmenttemplates
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/employmenttemplates
@required {employerId: str(uuid)}
@optional {X-ValidateOnly: bool}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employmenttemplates/{employmenttemplateId}
@required {employmenttemplateId: str(uuid)}
@optional {X-ValidateOnly: bool}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employmenttemplates/{employmenttemplateId}
@required {employmenttemplateId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/declarations
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/employments/declarations/review
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/employments/declarations/process
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/declarations/{declarationId}/attachment
@required {declarationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/declarations/{declarationId}/attachment
@required {declarationId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/declarations/withattachment
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/declarations/withattachment
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group qwoatermicroservice
@endpoint GET /qwoatermicroservice/providers/employers/employees/employments/declarations/withattachment
@required {declarationIds: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollperiods/initialise
@required {payrollAdministrationId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollruns/initiate
@required {payrollAdministrationId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollruns/{payrollPeriodId}/initiationvalues
@required {payrollAdministrationId: str(uuid), payrollPeriodId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/payrollruns
@required {payrollPeriodId: int(int32)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/payrollruns
@required {payrollPeriodId: int(int32)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/undo
@required {payrollrunId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/transitioncompensation/calculate/defaults
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/transitioncompensation/calculate
@required {employmentId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/documents
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/documents
@required {employmentId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/documents/{documentId}
@required {employmentId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/{employmentId}/documents/{documentId}
@required {employmentId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/{employmentId}/documents/{documentId}
@required {employmentId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/documents/{documentId}/audittrail
@required {documentId: str, employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/documents/{documentId}
@required {employerId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/{employerId}/documents/{documentId}
@required {employerId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/{employerId}/documents/{documentId}
@required {employerId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/{employerId}/documents
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/documents
@required {employerId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/documents/{documentId}/audittrail
@required {documentId: str, employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/conceptemployees/{conceptEmployeeId}/documents/{documentId}
@required {conceptEmployeeId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/conceptemployees/{conceptEmployeeId}/documents/{documentId}
@required {conceptEmployeeId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/conceptemployees/{conceptEmployeeId}/documents/{documentId}
@required {conceptEmployeeId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/conceptemployees/{conceptEmployeeId}/documents
@required {conceptEmployeeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/conceptemployees/{conceptEmployeeId}/documents
@required {conceptEmployeeId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/conceptemployees/{conceptEmployeeId}/documents/{documentId}/audittrail
@required {documentId: str, conceptEmployeeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/conceptemployees/{conceptEmployeeId}/dossier"
@required {conceptEmployeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/conceptemployees/{conceptEmployeeId}/dossier"
@required {conceptEmployeeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/documenttemplates/{documentId}
@required {employerId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/{employerId}/documenttemplates/{documentId}
@required {employerId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/{employerId}/documenttemplates/{documentId}
@required {employerId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/{employerId}/documenttemplates
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/documenttemplates
@required {employerId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/documenttemplates/{documentId}/generatedocument/preview
@required {employmentId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/documenttemplates/{documentId}/generatedocument
@required {employmentId: str(uuid), documentId: str}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/conceptemployees/{conceptEmployeeId}/documenttemplates/{documentId}/generatedocument/preview
@required {conceptEmployeeId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/conceptemployees/{conceptEmployeeId}/documenttemplates/{documentId}/generatedocument
@required {conceptEmployeeId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/documenttemplates/{documentId}/generatedocuments
@required {employerId: str(uuid), documentId: str}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/signature/report
@required {employerId: str(uuid), startDate: str(date), endDate: str(date)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/documents/{documentId}/signature/initiate
@required {employmentId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/documents/{documentId}/signature
@required {employmentId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/{employmentId}/documents/{documentId}/signature
@required {employmentId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/documents/{documentId}/signature/report
@required {employmentId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/conceptemployees/{conceptEmployeeId}/documents/{documentId}/signature/initiate
@required {conceptEmployeeId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/conceptemployees/{conceptEmployeeId}/documents/{documentId}/signature
@required {conceptEmployeeId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/conceptemployees/{conceptEmployeeId}/documents/{documentId}/signature
@required {conceptEmployeeId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/conceptemployees/{conceptEmployeeId}/documents/{documentId}/signature/report
@required {conceptEmployeeId: str(uuid), documentId: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/documents/authorizations
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/{employerId}/documents/authorizations
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint POST /v2/providers/employers/{employerId}/documents/completedossier/initiate
@required {employerId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/{employerId}/documents/completedossier
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/providers/employers/{employerId}/dossier/report
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/apgpensiondeclarations
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/apgpensiondeclarations/{apgPensionDeclarationId}
@required {apgPensionDeclarationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/apgpensiondeclarations/{apgPensionDeclarationId}
@required {apgPensionDeclarationId: str(uuid), action: str(confirm/cancel)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/apgpensiondeclarations/{apgPensionDeclarationId}/overview
@required {apgPensionDeclarationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/apgpensiondeclarations/{apgPensionDeclarationId}/message
@required {apgPensionDeclarationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/apgpensiondeclarations/initiate
@required {payrollAdministrationId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/apgpensiondeclarations/initiateForPreviousYear
@required {payrollAdministrationId: str(uuid)}
@optional {X-ValidateOnly: bool}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/apgpensiondeclarations/{apgPensionDeclarationId}/undo
@required {apgPensionDeclarationId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/upapensiondeclarations
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/externalparties/{externalPartyKey}/upapensiondeclarations/initiateforpreviousyear
@required {payrollAdministrationId: str(uuid), externalPartyKey: int(int32)}
@optional {X-ValidateOnly: bool}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/upapensiondeclarations/{upaPensionDeclarationId}
@required {upaPensionDeclarationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/upapensiondeclarations/{upaPensionDeclarationId}
@required {upaPensionDeclarationId: str(uuid), action: str(confirm/cancel)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/upapensiondeclarations/{upaPensionDeclarationId}/undo
@required {upaPensionDeclarationId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/upapensiondeclarations/{upaPensionDeclarationId}/message
@required {upaPensionDeclarationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/externalparties/{externalPartyKey}/upapensiondeclarations/initiate
@required {payrollAdministrationId: str(uuid), externalPartyKey: int(int32)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/pensiondeclarations
@required {payrollPeriodId: int(int32)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/pensiondeclarations
@required {payrollPeriodId: int(int32)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/ExternalPartyIdentifications
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/ExternalPartyIdentifications
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/ExternalPartyIdentifications/{externalPartyIdentificationId}
@required {externalPartyIdentificationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/ExternalPartyIdentifications/{externalPartyIdentificationId}
@required {externalPartyIdentificationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/ExternalPartyIdentifications/{externalPartyIdentificationId}
@required {externalPartyIdentificationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrollAdministrations/{payrollAdministrationId}/ExternalPartyIdentifications"
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrollAdministrations/{payrollAdministrationId}/ExternalPartyIdentifications"
@required {payrollAdministrationId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrollAdministrations/ExternalPartyIdentifications/{externalPartyIdentificationId}
@required {externalPartyIdentificationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/payrollAdministrations/ExternalPartyIdentifications/{externalPartyIdentificationId}
@required {externalPartyIdentificationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/payrollAdministrations/ExternalPartyIdentifications/{externalPartyIdentificationId}
@required {externalPartyIdentificationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/pawwdeclarations
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/pawwdeclarations/initiate
@required {payrollAdministrationId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/pawwdeclarations/{pawwDeclarationId}
@required {pawwDeclarationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrolladministrations/pawwdeclarations/{pawwDeclarationId}
@required {pawwDeclarationId: str(uuid), action: str(confirm/cancel)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/pawwdeclarations/{pawwDeclarationId}/message
@required {pawwDeclarationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/pawwdeclarations/{pawwDeclarationId}/undo"
@required {pawwDeclarationId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/pensionWageStatement/Stipp/initiationvalues
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/pensionWageStatement/Stipp/payrollRuns
@required {process: str(Delete/Initiate), payrollAdministrationId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/pensionWageStatement/Stipp
@required {referenceDate: str(date), payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/pensionWageStatement/Stipp
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/pensionWageStatement/Stipp
@required {reportYear: int, payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/pensionWageStatement/Pggm/initiationvalues
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/pensionWageStatement/Pggm/payrollRuns
@required {process: str(Delete/Initiate), payrollAdministrationId: str(uuid)}
@optional {referenceDate: str(date), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/pensionWageStatement/Pggm
@required {referenceDate: str(date), payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/pensionWageStatement/Pggm
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/pensionWageStatement/Pggm
@required {reportYear: int, payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/users/downloadrequests
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/users/downloadrequests
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/users/downloadrequests/{downloadRequestId}
@required {downloadRequestId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/users/downloadrequests/{downloadRequestId}
@required {downloadRequestId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/users/downloadrequests/{downloadRequestId}/file
@required {downloadRequestId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/notes
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/notes
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/notes/{noteId}
@required {noteId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/notes/{noteId}
@required {noteId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/notes/{noteId}
@required {noteId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/{employeeId}/notes
@required {employeeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/{employeeId}/notes
@required {employeeId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/notes/{noteId}
@required {noteId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/notes/{noteId}
@required {noteId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/notes/{noteId}
@required {noteId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/notes
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/conceptemployees/{conceptEmployeeId}/notes
@required {conceptEmployeeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/conceptemployees/{conceptEmployeeId}/notes
@required {conceptEmployeeId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/conceptemployees/notes/{noteId}
@required {noteId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/conceptemployees/notes/{noteId}
@required {noteId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/conceptemployees/notes/{noteId}
@required {noteId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/notes
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/employees/employments/{employmentId}/notes
@required {employmentId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/employees/employments/notes/{noteId}
@required {noteId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/employees/employments/notes/{noteId}
@required {noteId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/employees/employments/notes/{noteId}
@required {noteId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/notes
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/notes
@required {payrollrunId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/payrollruns/{payrollrunId}/notes
@required {payrollrunId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/payrollruns/notes/{noteId}
@required {noteId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/payrolladministrations/payrollruns/notes/{noteId}
@required {noteId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/payrolladministrations/payrollruns/notes/{noteId}
@required {noteId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollruns/notes
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/lastmodifiedversionnumbers
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/lastmodifiedversionnumbers
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/emailtemplates
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/emailtemplates/{emailTemplateId}
@required {providerId: str(uuid), emailTemplateId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/{providerId}/emailtemplates/{emailTemplateId}
@required {providerId: str(uuid), emailTemplateId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/{providerId}/emailtemplates/{emailTemplateId}
@required {providerId: str(uuid), emailTemplateId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/emailtemplates
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/emailtemplates/{emailTemplateId}
@required {employerId: str(uuid), emailTemplateId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/{employerId}/emailtemplates/{emailTemplateId}
@required {employerId: str(uuid), emailTemplateId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/{employerId}/emailtemplates/{emailTemplateId}
@required {employerId: str(uuid), emailTemplateId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/eventnotificationconfigurations
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/eventnotificationconfigurations/{eventTypeId}
@required {payrollAdministrationId: str(uuid), eventTypeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/eventnotificationconfigurations/{eventTypeId}
@required {payrollAdministrationId: str(uuid), eventTypeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/eventnotificationconfigurations/{eventTypeId}
@required {payrollAdministrationId: str(uuid), eventTypeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/eventnotificationconfigurations
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/eventnotificationconfigurations/{eventTypeId}
@required {providerId: str(uuid), eventTypeId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/{providerId}/eventnotificationconfigurations/{eventTypeId}
@required {providerId: str(uuid), eventTypeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/{providerId}/eventnotificationconfigurations/{eventTypeId}
@required {providerId: str(uuid), eventTypeId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group applications
@endpoint GET /applications/{applicationId}/authorizations
@required {applicationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /applications/{applicationId}/logo
@required {applicationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/{employerId}/applications
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/applications/{applicationId}/users
@required {employerId: str(uuid), applicationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/applications/{applicationId}/registerInterest"
@required {employerId: str(uuid), applicationId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/auditTrail/employerData
@required {employerId: str(uuid), startDate: str, endDate: str}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/auditTrail/employeeData
@required {employerId: str(uuid), startDate: str, endDate: str}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/auditTrail/PayrollPeriodData
@required {payrollAdministrationId: str(uuid)}
@optional {startDate: str, endDate: str, payrollPeriodId: int(int32), filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group applicationset
@endpoint GET /applicationset/providers/employers/{employerId}/applicationsets
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /applicationset/providers/employers/{employerId}/applicationsets
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /applicationset/providers/employers/applicationsets/{applicationSetId}
@required {applicationSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /applicationset/providers/employers/applicationsets/{applicationSetId}
@required {applicationSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /applicationset/providers/{providerId}/applicationsets
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /applicationset/providers/{providerId}/applicationsets
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /applicationset/providers/applicationsets/{applicationSetId}
@required {applicationSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /applicationset/providers/applicationsets/{applicationSetId}
@required {applicationSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /applicationset/users/{userId}/applicationsets
@required {userId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /applicationset/users/{userId}/applicationsets
@required {userId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /applicationset/users/applicationsets/{applicationSetId}
@required {applicationSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /applicationset/users/applicationsets/{applicationSetId}
@required {applicationSetId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /applicationset/applicationsets/general
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group providers
@endpoint GET /v2/providers/employers/employees/employments/{employmentId}/payrollSimulatorData
@required {employmentId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/{providerId}/emailidentities
@required {providerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/emailidentities
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/emailidentities/{emailIdentityId}
@required {emailIdentityId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/emailidentities/{emailIdentityId}/sendtestemail
@required {emailIdentityId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/{providerId}/emailidentities/verify
@required {providerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/emailidentities
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/emailidentities
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint DELETE /v2/providers/employers/emailidentities/{emailIdentityId}
@required {emailIdentityId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/emailidentities/{emailIdentityId}/sendtestemail
@required {emailIdentityId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/emailidentities/verify
@required {employerId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/conceptemployees/import/{payrollAdministrationId}
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 413, 415, 500}

@endpoint POST /v2/providers/employers/payrollAdministrations/{payrollAdministrationId}/import/employees
@required {payrollAdministrationId: str(uuid), year: int, period: int, payslipType: int}
@returns(200)
@errors {400, 401, 403, 404, 413, 415, 500}

@endpoint GET /v2/providers/employers/{employerId}/employees/employments/WageProposals
@required {employerId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/employees/employments/WageProposals
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PATCH /v2/providers/employers/payrollAdministrations/{payrollAdministrationId}/mdvNotifications
@required {payrollAdministrationId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/{employerId}/proforma/initialize
@required {employerId: str(uuid)}
@returns(202)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/{employerId}/proforma
@required {employerId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/workRelatedCostsSchemeFinancials
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/workRelatedCostsSchemeFinancials
@required {payrollAdministrationId: str(uuid), journalProfileId: str(uuid)}
@returns(201)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/workRelatedCostsSchemeFinancials/{workRelatedCostsSchemeFinancialId}
@required {workRelatedCostsSchemeFinancialId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v2/providers/employers/payrolladministrations/workRelatedCostsSchemeFinancials/{workRelatedCostsSchemeFinancialId}
@required {workRelatedCostsSchemeFinancialId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint DELETE /v2/providers/employers/payrolladministrations/workRelatedCostsSchemeFinancials/{workRelatedCostsSchemeFinancialId}
@required {workRelatedCostsSchemeFinancialId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/workRelatedCostsSchemeMatrix
@required {payrollAdministrationId: str(uuid)}
@optional {filter: str, orderBy: str, pageNumber: int(int32)=1, pageSize: int(int32)=250}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v2/providers/employers/payrolladministrations/{payrollAdministrationId}/workRelatedCostsSchemeReport
@required {payrollAdministrationId: str(uuid), reportYear: int}
@optional {payrollComponentSet: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group provider
@endpoint GET /provider/providers/{providerId}/employers/modules
@required {providerId: str(uuid), modules: [str]}
@optional {moduleIds: [str(uuid)]}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /provider/providers/{providerId}/payrollAdministrations/YearEndStatements
@required {providerId: str(uuid), reportYear: int, referenceDate: str(date)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /provider/providers/{providerId}/payrollAdministrations/Payslips
@required {providerId: str(uuid), startDate: str, endDate: str}
@optional {testYear: bool}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /provider/providers/{providerId}/payrollAdministrations/employmentTurnover
@required {providerId: str(uuid), startDate: str, endDate: str}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@group payrolltaxreturn
@endpoint GET /payrolltaxreturn/providers/employers/payrolladministrations/payrolltaxreturns/{payrollTaxReturnId}/report
@required {payrollTaxReturnId: str(uuid)}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endgroup

@end