> ## 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

> Publiceer contractplaatsingen vanuit Spott naar Timesheet Portal, zodat timesheets, verloning en facturatie daar lopen, en zie de timesheets terug op de plaatsing.

**Timesheet Portal** is een pay- en billplatform voor rekruteringskantoren. Het beheert de
timesheets, facturatie en betalingen voor uw geplaatste contractors.

De integratie **stuurt een contractplaatsing in één keer van Spott naar Timesheet Portal**: de
klant, de contactpersoon die de timesheets goedkeurt, de kandidaat, de consultant, de details
van de plaatsing en de tarieven. Niemand typt de plaatsing opnieuw in. De timesheets die uw
contractors daarna in Timesheet Portal indienen, **komen terug op de plaatsing in Spott**, zodat
u ziet wat er gewerkt is zonder in een tweede systeem aan te melden.

Met de integratie kunt u:

* **Uw Timesheet Portal-account één keer koppelen** voor de hele workspace.
* **Een contractplaatsing publiceren**, rechtstreeks vanuit de plaatsing, en ze later
  **bijwerken**.
* **De gegevens van klant, contactpersoon, kandidaat, consultant, plaatsing en tarieven
  nakijken en aanvullen** voordat ze worden verstuurd.
* **De timesheets** uit Timesheet Portal **bekijken** op het tabblad **Timesheets** van de
  plaatsing.

Timesheet Portal bestaat naast [RSM InTime](https://docs.spott.io/nl/docs/integrations/rsm-intime.md). Een workspace kan
beide koppelen en een plaatsing naar een van beide of naar allebei publiceren.

## Timesheet Portal koppelen

Een beheerder koppelt Timesheet Portal één keer voor de hele workspace. U hebt eerst
API-gegevens uit Timesheet Portal nodig, aangemaakt voor een gebruiker met de rol **System
Administrator** daar.

### De API-gegevens aanmaken in Timesheet Portal

1. Ga in Timesheet Portal naar **Settings → Account → API**.
2. Klik op het tabblad **Private applications** op **+ New application**.
3. Geef de applicatie een naam, bijvoorbeeld *Spott*, kies een System Administrator als **API
   user**, zorg dat ze op **Enabled** staat en klik op **Save**.
4. Kopieer de **Client ID**. Klik daarna op **Click to show secret** en kopieer het **Client
   secret**.

![Een private application in de API-instellingen van Timesheet Portal, met de API user, de schakelaar Enabled, de Client ID en de knop 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)

### Koppelen in Spott

1. Ga naar **Settings → Integrations** en kies **Timesheet Portal**.
2. Klik op **Enable**. Het venster **Connect Timesheet Portal** opent.
3. Vul in:
   * **Account name**: het subdomein van uw Timesheet Portal-URL. Meldt u zich aan op
     `acme.timesheetportal.com`, dan is dat `acme`. Alleen letters, cijfers en koppeltekens.
   * **Client ID** en **Client Secret**: de gegevens die u net hebt gekopieerd.
4. Klik op **Connect**.

![Het venster Connect Timesheet Portal met de velden Account name, Client ID en 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 controleert de gegevens bij uw account en bewaart ze voor de workspace. De rij
**Workspace** staat dan op **Connected**. Kloppen de gegevens niet, dan ziet u "Could not
connect Timesheet Portal. Check the account name and credentials and try again."

Een workspace koppelt één Timesheet Portal-account. Om van account te wisselen, kiest u
**Disconnect Timesheet Portal** in het menu op de rij **Workspace** en koppelt u daarna
opnieuw.

> [!NOTE]
>
> Alleen beheerders van de workspace kunnen deze integratie koppelen of ontkoppelen.
> Plaatsingen publiceren kan iedereen die plaatsingen mag bewerken.

## Een plaatsing publiceren

Alleen **contractplaatsingen** kunnen worden gepubliceerd, inclusief hun verlengingen.
Contingent en retained plaatsingen hebben geen timesheets, dus daar verschijnt de optie niet.

Controleer eerst twee dingen op de plaatsing:

* **Ze heeft een rate card.** Zonder rate card is **Publish to Timesheet Portal** grijs. Kies
  **Create rate card** in hetzelfde menu, zie [een rate card instellen](https://docs.spott.io/nl/docs/placements/timesheets.md#1-een-rate-card-instellen).
* **Elk tarief heeft een pay code die in Timesheet Portal bestaat.** De codes staan in Timesheet
  Portal onder **Settings → Timesheets → Rates & Units**, bijvoorbeeld `STD` of `OT1`. Kies de
  overeenkomende **Pay code** op elk tarief met **Edit rate card**.

### De publicatie starten

1. Open de contractplaatsing.
2. Klik op het menu **⋮** rechtsboven in het blok **Placement**.
3. Kies **Publish to Timesheet Portal**.

![Het menu van de plaatsing met Publish to Timesheet Portal onder 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)

### Het formulier invullen

Het formulier heeft zes tabbladen. Spott vult alles in wat het al weet. Loop ze door met
**Review next tab** en **Previous tab**, of klik op een tabblad om er meteen naartoe te gaan.
Is een verplicht veld leeg, dan toont het formulier **Field is required** en brengt het u naar
het eerste tabblad met een lege plek.

| Tabblad | Wat het bevat |
| - | - |
| **Company** | De klant: naam, ondernemingsnummer, btw-nummer, facturatie-e-mail, boekhoudcode, valuta en facturatieadres |
| **Contact** | De persoon bij de klant die de **timesheets goedkeurt** voor deze plaatsing. Timesheet Portal bewaart die als approver |
| **Candidate** | De contractor: naam, e-mail, type tewerkstelling, functietitel, gsm-nummer, startdatum, geboortedatum, adres en valuta. De bedrijfsgegevens zijn alleen nodig wanneer de contractor via een eigen vennootschap factureert |
| **Consultant** | De consultant op de plaatsing |
| **Placement** | De omschrijving, startdatum, einddatum of **Ongoing**, bestelbonnummer en kostenplaatscode, plus de timesheetfrequentie, facturatiefrequentie en IR35-status |
| **Rates** | De tarieven uit de rate card van de plaatsing: naam, tariefcode, pay rate en charge rate |

Een contactpersoon en een consultant zijn altijd verplicht, net als de omschrijving en de
startdatum van de plaatsing. Laat voor de timesheetfrequentie, facturatiefrequentie en
IR35-status **Use the Timesheet Portal default** staan, tenzij deze plaatsing afwijkt.

Het tabblad **Rates** is alleen-lezen: "These rates come from the placement's rate card. Edit
the rate card to change what is published." Een rate card kan maximaal **20** tarieven
versturen, en elke tariefcode mag er maar één keer op staan.

![Het tabblad Rates van het formulier Publish to Timesheet Portal, met de naam, tariefcode, pay rate en charge rate van elk tarief](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)

### Nieuwe en gekoppelde records

De eerste keer dat u publiceert, **maakt** Spott de klant, contactpersoon, kandidaat en
consultant **aan** in Timesheet Portal en koppelt het elk ervan aan het record in Spott. Latere
plaatsingen voor dezelfde mensen gebruiken die koppeling opnieuw, zodat ze niet twee keer
worden aangemaakt.

Spott koppelt **geen** records die al in Timesheet Portal bestaan, niet op naam, niet op
e-mail en ook niet op een andere manier. Elke klant, contactpersoon, kandidaat en consultant die
u voor het eerst publiceert, wordt in Timesheet Portal als **nieuw record** aangemaakt, ook als
hetzelfde bedrijf of dezelfde persoon er al in staat. Wilt u een bestaand record in Timesheet
Portal hergebruiken, neem dan contact op met support voordat u publiceert.

Een record dat al gekoppeld is, wordt **niet bijgewerkt** vanuit Spott. Het tabblad meldt dat en
vraagt u het in Timesheet Portal aan te passen.

### Publiceren

Klik op **Publish** op het tabblad **Rates**. Spott bevestigt met "Placement published to
Timesheet Portal", en de plaatsing bestaat in Timesheet Portal, gekoppeld aan de klant, de
approver, de contractor en de consultant.

Vanaf dan toont het menu **Update in Timesheet Portal**. Gebruik dat om latere wijzigingen door
te sturen, bijvoorbeeld nieuwe tarieven. Het werkt dezelfde plaatsing in Timesheet Portal bij in
plaats van een nieuwe aan te maken. De plaatsing zelf toont geen badge of link naar Timesheet
Portal; aan het menu-item ziet u dat ze gepubliceerd is.

## Wat er daarna gebeurt

* **Timesheets** worden ingevuld en goedgekeurd in Timesheet Portal. Ongeveer één keer per uur
  haalt Spott ze op en toont ze op het tabblad **Timesheets** van de plaatsing, met hun status:
  **Draft**, **Submitted**, **Approved**, **Rejected** of **Void**. Ze kunnen alleen in Timesheet Portal
  worden gewijzigd. Spott markeert ze niet als alleen-lezen, maar weigert een wijziging: u krijgt
  een algemene foutmelding wanneer u opslaat.
* **Facturatie** loopt in Timesheet Portal. Timesheets die uit Timesheet Portal komen, kunnen
  niet vanuit Spott worden gefactureerd, zodat dezelfde uren nooit twee keer worden aangerekend.
  Facturen die u in Timesheet Portal aanmaakt, verschijnen niet in Spott.

## Problemen oplossen

| Melding | Wat u doet |
| - | - |
| **The Rate Code … could not be found** | Een pay code op de rate card bestaat niet in Timesheet Portal. Controleer daar **Settings → Timesheets → Rates & Units**, corrigeer de code met **Edit rate card** en publiceer opnieuw |
| **This placement needs a rate card before it can be published to Timesheet Portal** | Maak eerst een rate card aan op de plaatsing |
| **The rate card uses the code … more than once** | Geef elke tariefregel een eigen code |
| **The rate card has … rates, but Timesheet Portal accepts at most 20** | Verwijder tarieven tot er 20 of minder overblijven |
| **The … linked to Timesheet Portal no longer exists there** | Het gekoppelde record werd in Timesheet Portal verwijderd. Neem contact op met support om de koppeling te verwijderen of te vervangen |
| **That Timesheet Portal … is already linked to another Spott record** | Twee records in Spott verwijzen naar hetzelfde record in Timesheet Portal. Neem contact op met support om de koppeling te corrigeren |
| **Timesheet Portal rejected the stored connection** | De bewaarde gegevens werken niet meer. Ontkoppel en koppel opnieuw met nieuwe gegevens |
| **Timesheet Portal is temporarily unavailable** of **is rate limiting requests** | Wacht even en probeer het opnieuw |
| **Another Timesheet Portal publish is already in progress** | Iemand anders publiceert op hetzelfde moment. Probeer het opnieuw zodra dat klaar is |

## Veelgestelde vragen

* **Wie kan de integratie koppelen?** Een beheerder van de workspace, via
  **Settings → Integrations**.
* **Wat is mijn account name?** Het subdomein van uw Timesheet Portal-URL: `acme` voor
  `acme.timesheetportal.com`.
* **Waarom is Publish to Timesheet Portal grijs?** De plaatsing heeft nog geen rate card.
* **Waarom is er helemaal geen Publish to Timesheet Portal?** De plaatsing is geen
  contractplaatsing, of Timesheet Portal is niet gekoppeld voor de workspace.
* **Moet ik elke plaatsing publiceren?** Ja. Alleen plaatsingen die u publiceert, worden
  verstuurd. Er gaat niets automatisch naar Timesheet Portal.
* **Kan ik timesheets uit Timesheet Portal vanuit Spott factureren?** Nee. Factureer ze in
  Timesheet Portal, zodat dezelfde uren niet twee keer worden aangerekend.


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