The purpose of this page is to outline the CSV format requested by Sopht for importing the client's employee count into the solution (headcount). This number is used to define "relative KPIs" that adjust certain metrics per employee.
| Version | Date | Author | Description |
|---|---|---|---|
| v1.0 | 2024/05/24 | Réda Pengam | Initial version |
| v1.1 | 2024/10/12 | Réda Pengam | Sync with similar CSV docs |
| v1.2 | 2025/02/18 | Fumo Aristide | Details on CSV fields |
Character encoding: UTF-8 (without BOM)
The line separator is the character set CRLF: Carriage Return (carriage return) and Line Feed (line feed). The last line may or may not end with this separator.
The file must have a first "header" line reminding the names of the fields defined below.
Columns are separated by the character ,
Each value can be surrounded by double quotes “. If a value contains the character , it becomes necessary. If the “ character must appear inside a surrounded value, the character must be doubled.
For further details on the CSV format, see the RFC 4180.
You can remove optional columns altogether, or change the order of the columns, although the names of the columns must remain unchanged.
<aside> ℹ️
We process the data only once, so the data processed for a given date will not be modified later.
</aside>
The file name should follow this format: “headcount_information_YYYYMMDD.csv” :
headcount_information_20240524.csv