Company endpoints

Get Company (GET /companies/{companyId})

The company response now includes:

• identificationNumber — the company’s official identifier (e.g. SIRET in France, CIF in Spain)
• address, city, and postalCode — company location details, now available on the global endpoint for all supported countries

DE and IT were removed as possible country values as PayFit don't support these countries anymore.

Get Company (France) (GET /companies-fr/{companyId})

• siren and siret are deprecated. Use identificationNumber instead (siren corresponds to the first 9 characters of identificationNumber).

Added

• Added workingTimeModality field to French contract endpoints (/companies/{companyId}/contracts-fr and /companies/{companyId}/contracts-fr/{contractId}). This field is only returned when the contracts:time-information:read scope is present.
• Added support for employeeIsExempted on the French health insurance affiliation endpoint (PUT /companies/{companyId}/contracts-fr/{contractId}/health-insurance) to mark an employee as exempted.

Until now, activating an integration or a customer API token with the accounting:read permission only triggered the generation of accountingV2 documents after the next payroll.

From now on, when this permission is enabled, the system will also generate all available accountingV2 documents for the past 24 months for French entities — providing immediate historical data access.

Until now, only validated absences were returned by our endpoint GET absences. Good news ! We now return all absences regardless of their status.

By default, only approved absences will be returned, but you can override this behaviour by setting the status filter in the query to only retrieves absences you're interested by. You can also retrieve all absences by setting the status parameter to all.

It means you'll now be able to retrieve absences that are awaiting confirmation, or that were cancelled.

You'll find a comprehensive description in the endpoint documentation.

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.