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

> Veröffentlichen Sie Vertragsplatzierungen aus Spott in Timesheet Portal, damit Timesheets, Lohnabrechnung und Rechnungsstellung dort laufen, und sehen Sie die Timesheets wieder auf der Platzierung.

**Timesheet Portal** ist eine Pay-and-Bill-Plattform für Personalvermittlungen. Sie wickelt
die Timesheets, die Rechnungsstellung und die Zahlungen für Ihre vermittelten Contractors ab.

Die Integration **sendet eine Vertragsplatzierung in einem Schritt aus Spott an Timesheet
Portal**: den Kunden, den Ansprechpartner, der die Timesheets freigibt, den Kandidaten, den
Berater, die Details der Platzierung und die Sätze. Niemand tippt die Platzierung erneut ein.
Die Timesheets, die Ihre Contractors anschließend in Timesheet Portal einreichen, **kommen auf
die Platzierung in Spott zurück**, sodass Sie sehen, was gearbeitet wurde, ohne sich in einem
zweiten System anzumelden.

Mit der Integration können Sie:

* **Ihr Timesheet Portal-Konto einmalig verbinden**, für den gesamten Workspace.
* **Eine Vertragsplatzierung veröffentlichen**, direkt aus dem Platzierungsdatensatz, und sie
  später **aktualisieren**.
* **Die Angaben zu Kunde, Ansprechpartner, Kandidat, Berater, Platzierung und Sätzen prüfen
  und ergänzen**, bevor sie gesendet werden.
* **Die Timesheets** aus Timesheet Portal auf dem Tab **Timesheets** der Platzierung **sehen**.

Timesheet Portal steht neben [RSM InTime](https://docs.spott.io/de/docs/integrations/rsm-intime.md). Ein Workspace kann
beide verbinden und eine Platzierung in einem der beiden oder in beiden veröffentlichen.

## Timesheet Portal verbinden

Ein Administrator verbindet Timesheet Portal einmalig für den gesamten Workspace. Dafür
brauchen Sie zuerst API-Zugangsdaten aus Timesheet Portal, angelegt für einen Benutzer mit der
Rolle **System Administrator** dort.

### Die API-Zugangsdaten in Timesheet Portal anlegen

1. Gehen Sie in Timesheet Portal zu **Settings → Account → API**.
2. Klicken Sie auf der Registerkarte **Private applications** auf **+ New application**.
3. Geben Sie ihr einen Namen, zum Beispiel *Spott*, wählen Sie einen System Administrator als
   **API user**, achten Sie darauf, dass sie auf **Enabled** steht, und klicken Sie auf
   **Save**.
4. Kopieren Sie die **Client ID**. Klicken Sie dann auf **Click to show secret** und kopieren
   Sie das **Client secret**.

![Eine private Anwendung in den API-Einstellungen von Timesheet Portal, mit dem API user, dem Schalter Enabled, der Client ID und der Schaltfläche 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)

### In Spott verbinden

1. Gehen Sie zu **Settings → Integrations** und wählen Sie **Timesheet Portal**.
2. Klicken Sie auf **Enable**. Der Dialog **Connect Timesheet Portal** öffnet sich.
3. Füllen Sie aus:
   * **Account name**: die Subdomain Ihrer Timesheet Portal-URL. Wenn Sie sich unter
     `acme.timesheetportal.com` anmelden, ist das `acme`. Nur Buchstaben, Ziffern und
     Bindestriche.
   * **Client ID** und **Client Secret**: die Zugangsdaten, die Sie gerade kopiert haben.
4. Klicken Sie auf **Connect**.

![Der Dialog Connect Timesheet Portal mit den Feldern Account name, Client ID und 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 prüft die Zugangsdaten gegen Ihr Konto und speichert sie für den Workspace. Die Zeile
**Workspace** zeigt dann **Connected**. Sind die Angaben falsch, sehen Sie "Could not
connect Timesheet Portal. Check the account name and credentials and try again."

Ein Workspace verbindet ein Timesheet Portal-Konto. Um das Konto zu wechseln, wählen Sie im
Menü der Zeile **Workspace** den Eintrag **Disconnect Timesheet Portal** und verbinden Sie
dann erneut.

> [!NOTE]
>
> Nur Workspace-Administratoren können diese Integration verbinden oder trennen.
> Platzierungen veröffentlichen kann jeder, der Platzierungen bearbeiten darf.

## Eine Platzierung veröffentlichen

Nur **Vertragsplatzierungen** lassen sich veröffentlichen, einschließlich ihrer
Verlängerungen. Contingent- und Retained-Platzierungen haben keine Timesheets, deshalb
erscheint die Option dort nicht.

Prüfen Sie vorher zwei Dinge an der Platzierung:

* **Sie hat eine Rate Card.** Ohne sie ist **Publish to Timesheet Portal** ausgegraut. Wählen
  Sie im selben Menü **Create rate card**, siehe [eine Rate Card einrichten](https://docs.spott.io/de/docs/placements/timesheets.md#1-eine-rate-card-einrichten).
* **Jeder Satz hat einen Pay Code, der in Timesheet Portal existiert.** Die Codes finden Sie in
  Timesheet Portal unter **Settings → Timesheets → Rates & Units**, zum Beispiel `STD` oder
  `OT1`. Wählen Sie mit **Edit rate card** auf jedem Satz den passenden **Pay code**.

### Veröffentlichung starten

1. Öffnen Sie die Vertragsplatzierung.
2. Klicken Sie auf das Menü **⋮** oben rechts im Block **Placement**.
3. Wählen Sie **Publish to Timesheet Portal**.

![Das Platzierungsmenü mit Publish to Timesheet Portal unter 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)

### Formular ausfüllen

Das Formular hat sechs Registerkarten. Spott füllt alles aus, was es bereits weiß. Arbeiten
Sie sie mit **Review next tab** und **Previous tab** ab, oder klicken Sie auf eine
Registerkarte, um direkt dorthin zu springen. Ist ein Pflichtfeld leer, zeigt das Formular
**Field is required** und bringt Sie zur ersten Registerkarte mit einer Lücke.

| Registerkarte | Inhalt |
| - | - |
| **Company** | Der Kunde: Name, Handelsregisternummer, Steuernummer, Rechnungs-E-Mail, Buchungscode, Währung und Rechnungsadresse |
| **Contact** | Die Person beim Kunden, die die **Timesheets** für diese Platzierung **freigibt**. Timesheet Portal speichert sie als Approver |
| **Candidate** | Der Contractor: Name, E-Mail, Beschäftigungsart, Berufsbezeichnung, Mobilnummer, Eintrittsdatum, Geburtsdatum, Adresse und Währung. Die Firmenangaben sind nur nötig, wenn der Contractor über seine eigene Firma abrechnet |
| **Consultant** | Der Berater auf der Platzierung |
| **Placement** | Die Beschreibung, das Startdatum, das Enddatum oder **Ongoing**, die Bestellnummer und der Kostenstellencode, dazu die Timesheet-Frequenz, die Rechnungsfrequenz und der IR35-Status |
| **Rates** | Die Sätze aus der Rate Card der Platzierung: Name, Rate Code, Pay Rate und Charge Rate |

Ein Ansprechpartner und ein Berater sind immer Pflicht, ebenso die Beschreibung und das
Startdatum der Platzierung. Für die Timesheet-Frequenz, die Rechnungsfrequenz und den
IR35-Status lassen Sie **Use the Timesheet Portal default** stehen, es sei denn, diese
Platzierung weicht ab.

Die Registerkarte **Rates** ist schreibgeschützt: "These rates come from the placement's rate
card. Edit the rate card to change what is published." Eine Rate Card kann höchstens **20**
Sätze senden, und jeder Rate Code darf darauf nur einmal vorkommen.

![Die Registerkarte Rates des Formulars Publish to Timesheet Portal, mit Name, Rate Code, Pay Rate und Charge Rate des Satzes](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)

### Neue und verknüpfte Datensätze

Beim ersten Veröffentlichen **legt** Spott den Kunden, den Ansprechpartner, den Kandidaten und
den Berater in Timesheet Portal **an** und verknüpft jeden mit seinem Spott-Datensatz. Spätere
Platzierungen für dieselben Personen nutzen diese Verknüpfung wieder, sodass sie nicht doppelt
angelegt werden.

Spott ordnet Datensätze, die es in Timesheet Portal bereits gibt, **nicht** zu, weder über
Name noch über E-Mail noch auf anderem Weg. Jeder Kunde, Ansprechpartner, Kandidat und Berater,
den Sie zum ersten Mal veröffentlichen, wird in Timesheet Portal als **neuer Datensatz**
angelegt, auch wenn dasselbe Unternehmen oder dieselbe Person dort schon vorhanden ist. Um einen
bestehenden Timesheet Portal-Datensatz weiterzuverwenden, wenden Sie sich vor dem
Veröffentlichen an den Support.

Ein bereits verknüpfter Datensatz wird aus Spott **nicht aktualisiert**. Seine Registerkarte
weist darauf hin und bittet Sie, ihn stattdessen in Timesheet Portal zu bearbeiten.

### Veröffentlichen

Klicken Sie auf der Registerkarte **Rates** auf **Publish**. Spott bestätigt mit "Placement
published to Timesheet Portal", und die Platzierung existiert in Timesheet Portal, verknüpft
mit ihrem Kunden, Approver, Contractor und Berater.

Ab dann zeigt das Menü stattdessen **Update in Timesheet Portal**. Damit übertragen Sie
spätere Änderungen, zum Beispiel neue Sätze. Es aktualisiert dieselbe Platzierung in
Timesheet Portal, statt eine weitere anzulegen. Die Platzierung selbst zeigt kein Badge und
keinen Link zu Timesheet Portal; am Menüeintrag erkennen Sie, dass sie veröffentlicht wurde.

## Wie es weitergeht

* **Timesheets** werden in Timesheet Portal ausgefüllt und freigegeben. Etwa einmal pro
  Stunde holt Spott sie ab und zeigt sie auf dem Tab **Timesheets** der Platzierung, mit ihrem
  Status: **Draft**, **Submitted**, **Approved**, **Rejected** oder **Void**. Sie lassen sich nur in Timesheet
  Portal ändern. Spott kennzeichnet sie nicht als schreibgeschützt, lehnt eine Änderung aber ab:
  Beim Speichern erhalten Sie eine allgemeine Fehlermeldung.
* **Die Rechnungsstellung** läuft in Timesheet Portal. Timesheets aus Timesheet Portal lassen
  sich nicht aus Spott abrechnen, sodass dieselben Stunden nie doppelt berechnet werden.
  Rechnungen, die Sie in Timesheet Portal erstellen, erscheinen nicht in Spott.

## Fehlerbehebung

| Meldung | Was zu tun ist |
| - | - |
| **The Rate Code … could not be found** | Ein Pay Code auf der Rate Card existiert in Timesheet Portal nicht. Prüfen Sie dort **Settings → Timesheets → Rates & Units**, korrigieren Sie den Code mit **Edit rate card** und veröffentlichen Sie erneut |
| **This placement needs a rate card before it can be published to Timesheet Portal** | Legen Sie zuerst eine Rate Card auf der Platzierung an |
| **The rate card uses the code … more than once** | Geben Sie jeder Satzzeile einen eigenen Code |
| **The rate card has … rates, but Timesheet Portal accepts at most 20** | Entfernen Sie Sätze, bis höchstens 20 übrig sind |
| **The … linked to Timesheet Portal no longer exists there** | Der verknüpfte Datensatz wurde in Timesheet Portal gelöscht. Wenden Sie sich an den Support, um die Verknüpfung zu entfernen oder zu ersetzen |
| **That Timesheet Portal … is already linked to another Spott record** | Zwei Spott-Datensätze verweisen auf denselben Timesheet Portal-Datensatz. Wenden Sie sich an den Support, um die Verknüpfung zu korrigieren |
| **Timesheet Portal rejected the stored connection** | Die gespeicherten Zugangsdaten funktionieren nicht mehr. Trennen Sie die Verbindung und verbinden Sie erneut mit neuen Zugangsdaten |
| **Timesheet Portal is temporarily unavailable** oder **is rate limiting requests** | Warten Sie einen Moment und versuchen Sie es erneut |
| **Another Timesheet Portal publish is already in progress** | Jemand veröffentlicht gerade gleichzeitig. Versuchen Sie es erneut, sobald das abgeschlossen ist |

## Häufige Fragen

* **Wer kann die Integration verbinden?** Ein Workspace-Administrator, unter
  **Settings → Integrations**.
* **Was ist mein Account name?** Die Subdomain Ihrer Timesheet Portal-URL: `acme` für
  `acme.timesheetportal.com`.
* **Warum ist Publish to Timesheet Portal ausgegraut?** Die Platzierung hat noch keine Rate
  Card.
* **Warum gibt es Publish to Timesheet Portal überhaupt nicht?** Die Platzierung ist keine
  Vertragsplatzierung, oder Timesheet Portal ist für den Workspace nicht verbunden.
* **Muss ich jede Platzierung veröffentlichen?** Ja. Nur Platzierungen, die Sie
  veröffentlichen, werden gesendet. Nichts geht automatisch an Timesheet Portal.
* **Kann ich Timesheets aus Timesheet Portal aus Spott abrechnen?** Nein. Rechnen Sie sie in
  Timesheet Portal ab, damit dieselben Stunden nicht doppelt berechnet werden.


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