Temps de travail : feuilles de temps et import badgeuse

Qorha assure le décompte du temps de travail : feuilles de temps hebdomadaires, validation avant paie, import des pointages de votre badgeuse (fichier CSV ou API) et signalement des écarts par rapport au contrat.

Feuilles de temps

Où : fiche du salarié → onglet Temps

• Saisissez les heures travaillées de la semaine, jour par jour, ainsi que les heures supplémentaires.
• Une fois vérifiée, la feuille est validée : elle devient définitive et alimente la page Paie du mois. Tant qu'elle n'est pas validée, elle reste modifiable (brouillon).

Attention : une semaine validée est figée. Ni la saisie manuelle ni un import badgeuse ne peuvent l'écraser — c'est une protection volontaire pour la paie.

Matricule badgeuse

Où : fiche du salarié → onglet Infos → champ « Matricule badgeuse »

Pour rapprocher les pointages de vos salariés, renseignez sur chaque fiche le matricule utilisé par votre badgeuse (unique au sein de votre organisation). La colonne optionnelle matricule_badgeuse de l'import CSV salariés permet de le remplir en masse.

Import des pointages (CSV)

Où : Gestion de l'application → onglet Intégrations → Import badgeuse

L'import fonctionne avec n'importe quelle badgeuse capable d'exporter un CSV, grâce à un mapping de colonnes mémorisé :

1. Dépôt du fichier CSV exporté de votre badgeuse.
2. Mapping des colonnes : indiquez quelle colonne contient le matricule, la date, les heures de début/fin (ou le total d'heures), le séparateur et le format de date. « Mémoriser ce mappage » est coché par défaut : les imports suivants seront préconfigurés.
3. Aperçu avec anomalies : matricule inconnu, chevauchement, journée de plus de 24 h, jour déjà validé… tout est signalé avant l'écriture.
4. Confirmation : les pointages alimentent les feuilles de temps, jour par jour, avec la source « badgeuse ».

Règles appliquées :

• une semaine validée n'est jamais écrasée (l'anomalie est signalée ligne par ligne) ;
• un jour saisi manuellement est remplacé uniquement sur une feuille en brouillon, et le remplacement est signalé dans le rapport ;
• les écarts par rapport à l'horaire contractuel (heures par semaine du dernier contrat) sont signalés ;
• chaque import est tracé dans le journal d'audit avec ses compteurs.

Badgeuse connectée (API)

Si votre badgeuse sait pousser des données en HTTP, utilisez l'endpoint POST /api/v1/clockings (scope clockings: write) : pointage unitaire ou par lot (500 maximum), avec un rapport imported / rejected / replaced / gaps en réponse. Voir le guide API et la spécification sur /api/doc.

Jours fériés

Les jours fériés français sont connus de Qorha et surlignés dans le calendrier et les grilles. Ils sont exclus automatiquement du décompte des jours ouvrés des absences, avec prise en charge du droit local Alsace-Moselle si activé dans les paramètres de convention.