> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spott.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Timesheet Portal

> Publiez vos placements en mission depuis Spott vers Timesheet Portal, pour que les feuilles de temps, la paie et la facturation s'y déroulent, et retrouvez les feuilles de temps sur le placement.

**Timesheet Portal** est une plateforme de paie et de facturation pour les agences de
recrutement. Elle gère les feuilles de temps, la facturation et les paiements de vos
intervenants placés.

L'intégration **envoie un placement en mission de Spott vers Timesheet Portal** en une seule
fois : le client, le contact qui approuve les feuilles de temps, le candidat, le consultant, les
détails du placement et les taux. Personne ne ressaisit le placement. Les feuilles de temps que
vos intervenants soumettent ensuite dans Timesheet Portal **reviennent sur le placement dans
Spott**, pour que vous voyiez ce qui a été travaillé sans vous connecter à un second système.

Avec l'intégration, vous pouvez :

* **Connecter votre compte Timesheet Portal une seule fois** pour tout l'espace de travail.
* **Publier un placement en mission** directement depuis la fiche du placement, et le **mettre
  à jour** plus tard.
* **Vérifier et compléter** les détails du client, du contact, du candidat, du consultant, du
  placement et des taux avant leur envoi.
* **Voir les feuilles de temps** de Timesheet Portal dans l'onglet **Timesheets** du placement.

Timesheet Portal coexiste avec [RSM InTime](https://docs.spott.io/fr/docs/integrations/rsm-intime.md). Un espace de
travail peut connecter les deux, et publier un placement vers l'un, l'autre ou les deux.

## Connecter Timesheet Portal

Un administrateur connecte Timesheet Portal une seule fois pour tout l'espace de travail. Il
vous faut d'abord des identifiants API de Timesheet Portal, créés pour un utilisateur
**System Administrator** dans cet outil.

### Créer les identifiants API dans Timesheet Portal

1. Dans Timesheet Portal, allez dans **Settings → Account → API**.
2. Dans l'onglet **Private applications**, cliquez sur **+ New application**.
3. Donnez-lui un nom, par exemple *Spott*, choisissez un System Administrator comme **API
   user**, vérifiez qu'elle est bien **Enabled**, puis cliquez sur **Save**.
4. Copiez le **Client ID**. Cliquez ensuite sur **Click to show secret** et copiez le **Client
   secret**.

![Une application privée dans les paramètres API de Timesheet Portal, avec l'API user, l'interrupteur Enabled, le Client ID et le bouton Click to show secret](https://mintcdn.com/spott-docs/l6JwVI3-rQeuJzjF/images/integrations/timesheet-portal-api-application.webp?fit=max\&auto=format\&n=l6JwVI3-rQeuJzjF\&q=85\&s=a8ced29a5d5bf9e129de925fadd161d7)

### Se connecter dans Spott

1. Allez dans **Settings → Integrations** et sélectionnez **Timesheet Portal**.
2. Cliquez sur **Enable**. La fenêtre **Connect Timesheet Portal** s'ouvre.
3. Renseignez :
   * **Account name** : le sous-domaine de votre URL Timesheet Portal. Si vous vous connectez
     sur `acme.timesheetportal.com`, c'est `acme`. Lettres, chiffres et traits d'union
     uniquement.
   * **Client ID** et **Client Secret** : les identifiants que vous venez de copier.
4. Cliquez sur **Connect**.

![La fenêtre Connect Timesheet Portal avec les champs Account name, Client ID et Client Secret](https://mintcdn.com/spott-docs/l6JwVI3-rQeuJzjF/images/integrations/timesheet-portal-connect.webp?fit=max\&auto=format\&n=l6JwVI3-rQeuJzjF\&q=85\&s=b3fd18961f99a1bb2607867ad8f38060)

Spott vérifie les identifiants auprès de votre compte et les enregistre pour l'espace de
travail. La ligne **Workspace** affiche alors **Connected**. Si les informations sont
erronées, vous voyez « Could not connect Timesheet Portal. Check the account name and
credentials and try again. »

Un espace de travail connecte un seul compte Timesheet Portal. Pour changer de compte,
choisissez **Disconnect Timesheet Portal** dans le menu de la ligne **Workspace**, puis
connectez-vous à nouveau.

> [!NOTE]
>
> Seuls les administrateurs de l'espace de travail peuvent connecter ou déconnecter cette
> intégration. La publication des placements est ouverte à toute personne autorisée à
> modifier les placements.

## Publier un placement

Seuls les placements **Contract** peuvent être publiés, y compris leurs prolongations. Les
placements Contingent et Retained n'ont pas de feuilles de temps : l'option n'y apparaît donc
pas.

Vérifiez d'abord deux choses sur le placement :

* **Il a une grille tarifaire.** Sans elle, **Publish to Timesheet Portal** est grisé.
  Choisissez **Create rate card** dans le même menu, voir
  [configurer une grille tarifaire](https://docs.spott.io/fr/docs/placements/timesheets.md#1-configurer-une-grille-tarifaire).
* **Chaque taux a un pay code qui existe dans Timesheet Portal.** Les codes se trouvent dans
  Timesheet Portal sous **Settings → Timesheets → Rates & Units**, par exemple `STD` ou `OT1`.
  Choisissez le **Pay code** correspondant sur chaque taux avec **Edit rate card**.

### Lancer la publication

1. Ouvrez le placement en mission.
2. Cliquez sur le menu **⋮** en haut à droite du bloc **Placement**.
3. Choisissez **Publish to Timesheet Portal**.

![Le menu du placement avec Publish to Timesheet Portal sous Publish to RSM InTime](https://mintcdn.com/spott-docs/l6JwVI3-rQeuJzjF/images/integrations/timesheet-portal-publish-menu.webp?fit=max\&auto=format\&n=l6JwVI3-rQeuJzjF\&q=85\&s=e73d634d1c6c74744ad2e518aa5eddf3)

### Remplir le formulaire

Le formulaire comporte six onglets. Spott remplit tout ce qu'il sait déjà. Parcourez-les avec
**Review next tab** et **Previous tab**, ou cliquez sur un onglet pour y accéder directement.
Lorsqu'un champ obligatoire est vide, le formulaire affiche **Field is required** et vous
amène au premier onglet incomplet.

| Onglet | Contenu |
| - | - |
| **Company** | Le client : nom, numéro d'immatriculation de l'entreprise, numéro fiscal, e-mail de facturation, code comptable, devise et adresse de facturation |
| **Contact** | La personne chez le client qui **approuve les feuilles de temps** de ce placement. Timesheet Portal l'enregistre comme approbateur |
| **Candidate** | L'intervenant : nom, e-mail, type d'emploi, intitulé de poste, mobile, date d'entrée, date de naissance, adresse et devise. Les informations de société ne sont nécessaires que si l'intervenant facture via sa propre société |
| **Consultant** | Le consultant responsable du placement |
| **Placement** | La description, la date de début, la date de fin ou **Ongoing**, le numéro de bon de commande et le code de centre de coûts, ainsi que la fréquence des feuilles de temps, la fréquence de facturation et le statut IR35 |
| **Rates** | Les taux de la grille tarifaire du placement : nom, code de taux, taux de paie et taux de facturation |

Un contact et un consultant sont toujours obligatoires, tout comme la description et la date
de début du placement. Pour la fréquence des feuilles de temps, la fréquence de facturation et
le statut IR35, laissez **Use the Timesheet Portal default**, sauf si ce placement est
différent.

L'onglet **Rates** est en lecture seule : « These rates come from the placement's rate card.
Edit the rate card to change what is published. » Une grille tarifaire peut envoyer au plus
**20** taux, et chaque code de taux ne peut y figurer qu'une seule fois.

![L'onglet Rates du formulaire Publish to Timesheet Portal, avec le nom du taux, le code de taux, le taux de paie et le taux de facturation](https://mintcdn.com/spott-docs/l6JwVI3-rQeuJzjF/images/integrations/timesheet-portal-rates-tab.webp?fit=max\&auto=format\&n=l6JwVI3-rQeuJzjF\&q=85\&s=66a2f494f5500cd89dea38c40ec8ae8b)

### Fiches nouvelles et fiches liées

À la première publication, Spott **crée** le client, le contact, le candidat et le consultant
dans Timesheet Portal et relie chacun à sa fiche Spott. Les placements suivants pour les mêmes
personnes réutilisent ce lien : ils ne sont donc pas créés deux fois.

Spott ne fait **pas** correspondre les fiches qui existent déjà dans Timesheet Portal, ni par
nom, ni par e-mail, ni autrement. Chaque client, contact, candidat et consultant que vous publiez
pour la première fois est créé comme **nouvelle fiche** dans Timesheet Portal, même si la même
entreprise ou la même personne y figure déjà. Pour réutiliser une fiche Timesheet Portal
existante, contactez le support avant de publier.

Une fiche déjà liée n'est **pas mise à jour** depuis Spott. Son onglet l'indique et vous invite
à la modifier plutôt dans Timesheet Portal.

### Publier

Cliquez sur **Publish** dans l'onglet **Rates**. Spott confirme avec « Placement published to
Timesheet Portal », et le placement existe dans Timesheet Portal, lié à son client, à son
approbateur, à son intervenant et à son consultant.

Dès lors, le menu affiche **Update in Timesheet Portal** à la place. Utilisez-le pour envoyer
les modifications ultérieures, par exemple de nouveaux taux. Il met à jour le même placement
dans Timesheet Portal au lieu d'en créer un autre. Le placement lui-même n'affiche ni badge ni
lien vers Timesheet Portal ; c'est l'option du menu qui vous indique qu'il a été publié.

## Et ensuite

* **Les feuilles de temps** sont remplies et approuvées dans Timesheet Portal. Environ une fois
  par heure, Spott les récupère et les affiche dans l'onglet **Timesheets** du placement, avec
  leur statut : **Draft**, **Submitted**, **Approved**, **Rejected** ou **Void**. Elles ne peuvent être modifiées que
  dans Timesheet Portal. Spott ne les signale pas comme étant en lecture seule, mais refuse toute
  modification : vous obtenez un message d'erreur général lors de l'enregistrement.
* **La facturation** se fait dans Timesheet Portal. Les feuilles de temps issues de Timesheet
  Portal ne peuvent pas être facturées depuis Spott, pour que les mêmes heures ne soient jamais
  facturées deux fois. Les factures que vous créez dans Timesheet Portal n'apparaissent pas
  dans Spott.

## Dépannage

| Message | Que faire |
| - | - |
| **The Rate Code … could not be found** | Un pay code de la grille tarifaire n'existe pas dans Timesheet Portal. Vérifiez **Settings → Timesheets → Rates & Units** dans cet outil, corrigez le code avec **Edit rate card** et publiez à nouveau |
| **This placement needs a rate card before it can be published to Timesheet Portal** | Créez d'abord une grille tarifaire sur le placement |
| **The rate card uses the code … more than once** | Donnez à chaque ligne de taux son propre code |
| **The rate card has … rates, but Timesheet Portal accepts at most 20** | Supprimez des taux jusqu'à n'en garder que 20 ou moins |
| **The … linked to Timesheet Portal no longer exists there** | La fiche liée a été supprimée dans Timesheet Portal. Contactez le support pour retirer ou remplacer le lien |
| **That Timesheet Portal … is already linked to another Spott record** | Deux fiches Spott pointent vers la même fiche Timesheet Portal. Contactez le support pour corriger le lien |
| **Timesheet Portal rejected the stored connection** | Les identifiants enregistrés ne fonctionnent plus. Déconnectez-vous et reconnectez-vous avec de nouveaux identifiants |
| **Timesheet Portal is temporarily unavailable** ou **is rate limiting requests** | Patientez un instant et réessayez |
| **Another Timesheet Portal publish is already in progress** | Quelqu'un publie au même moment. Réessayez une fois la publication terminée |

## Questions fréquentes

* **Qui peut connecter l'intégration ?** Un administrateur de l'espace de travail, depuis
  **Settings → Integrations**.
* **Quel est mon account name ?** Le sous-domaine de votre URL Timesheet Portal : `acme` pour
  `acme.timesheetportal.com`.
* **Pourquoi Publish to Timesheet Portal est-il grisé ?** Le placement n'a pas encore de
  grille tarifaire.
* **Pourquoi Publish to Timesheet Portal n'apparaît-il pas du tout ?** Le placement n'est pas
  un placement en mission, ou Timesheet Portal n'est pas connecté pour l'espace de travail.
* **Dois-je publier chaque placement ?** Oui. Seuls les placements que vous publiez sont
  envoyés. Rien ne part vers Timesheet Portal automatiquement.
* **Puis-je facturer les feuilles de temps de Timesheet Portal depuis Spott ?** Non.
  Facturez-les dans Timesheet Portal, ce qui évite de facturer deux fois les mêmes heures.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.