Add new fields on createCollaborator

New fields added to collaborator creation: birthInformation, personalPhoneNumber, numberOfChildren, and gender for enhanced employee records.

Enhancement

• Improved the ability to retrieve absences using a period filter, providing more flexible data queries.

Deletion

• Removed the managerContractId field from contract endpoints to streamline data and improve API consistency.

Fixes

• Fixed documentation for mealVoucher, clarifying that it is only available for France and updating the documentation accordingly.

Add POST - /companies/{companyId}/billing-declarations endpoint

New endpoint to allow specific partners to make declarations, enhancing partner capabilities. More info here.

Add new endpoints to create a collaborator with a contract

Add POST - /companies/{companyId}/collaborators endpoint

New endpoint to create a collaborator, simplifying the onboarding process. More info here.

Add POST - /companies/{companyId}/collaborators/{collaboratorId}/contracts endpoint

New endpoint to create a contract for a collaborator, required to fullfill the previously created collaborator. More info here.

Enhancement

• Add more information in the /introspect endpoint for customer with api token.

Fixes

• Fixed issue with the absences endpoint, where remote absence types were incorrectly included in the returned values but will not be returned in this endpoint.

Add GET - /companies/{companyId}/absences endpoint

New endpoint for time off to manage employee leave requests. Returns the absences of the company. This list is paginated. The output can be filtered given some fields like contractId. More info here.

Add GET - /companies/{companyId}/payment-files endpoint

New endpoint to retrieve payment file payroll of the company for a given month. More info here.

Fixes

• Fixed issue where the collaborator's manager information was missing.

Enhancement

• Improved Accounting v1 and v2 for France. Fixed incorrectly named columns and added more AxeAnalytique for better usability.
• Enhanced getCollaborators endpoint to allow searching by email address for more flexible data retrieval. More info here.

Add POST - /companies-fr/{companyId}/health-insurance-setup-sheets endpoint

New endpoint to create or update health insurance contracts for a company, using setup sheets (documents sent to "net-entreprises.fr"). Available only for France and specific partners. More info here.

Enhancement

• New scopes health-insurance:read & health-insurance:write introduced to enhance security for the new health insurance endpoint.
• Improved error logging during the OAuth2 flow to better capture invalid scopes and enhance troubleshooting.

Add new endpoints for accounting

Add GET - /companies/{companyId}/income-taxes-documents endpoint

New endpoint for tax income documents (UK only) to support regional compliance needs (P45, P60, P11D). More infor here.

Add GET - /companies/{companyId}/auto-enrolment-documents endpoint

New endpoint for company auto-enrolment documents (UK only). More info here.

Add GET - /companies/{companyId}/documents/{documentId} endpoint

New endpoint to retrieve a document by ID. More info here.

Add POST - /companies/{companyId}/contracts-fr/{contractId}/regularization endpoint

Sometimes, the affiliation of an employee was applied to late on Payfit. A regularization in app was requested to fix the issue. So we added a new endpoint to request regularisation on a contractId. More info here.

Enhancement

• Improved detection of email types for collaborators and contracts to enhance validation accuracy.
• Field healthInsuranceProrationMethod added to the getCompanyFR endpoint output for better clarity in proration rules. More info here.

Fixes

• Resolved an issue in Accounting v2 where file names were incorrectly assigned.
• Fixed missing columns in Accounting v2 for France to ensure accurate reporting.
• Corrected the archived status for health insurance affiliation on contract management.

Added GET - /companies/{companyId}/accounting-v2 endpoint

New Accounting Endpoint (v2) available for the UK and France, providing extended financial reporting.
More info here.

Enhancement

• Improved response times and reduced payload sizes for all collaborators endpoints.
• Enhanced stability to support high-volume requests.

Added /contracts/:id endpoint

For some use cases, rather than syncing all the contracts everyday and store all the information in your DB, you might want to directly fetch data from PayFit.

Until today, this was not possible. Now, it is, thanks to a new endpoint allowing to retrieve a single contract ! More info here and here

Added /contracts/time endpoint

We added a new endpoint that allows you to know, for a given pay period, how much time was worked for every contract.

More info here.

Added professional email for collaborators of French companies

Previously, only collaborators of GB companies had the possibility to know the professional email of collaborators. From now on, in French companies, it's also possible !

See the emails field of the /collaborators endpoint.

Added rate contribution on health insurance contracts

We added the rate contribution by employer and employee fields when requesting the health insurance contracts to identify configuration records for associating collaborators.

See the tauxCotisationPatronale and tauxCotisationSalariale field of the /health-insurance-contracts endpoint.

Added bank info fields

In the GET /collaborators and the GET /collaborator endpoint, we introduced the IBAN and BIC fields. Both fields require a newly created scope collaborators:bank-info:read.

Added matricule

The matricule field can be used as a helper in order to synchronise collaborators between PayFit and third party apps.