> For the complete documentation index, see [llms.txt](https://knowledge.out-smart.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.out-smart.com/outsmart-knowledge-base/outsmart-knowledge-base-de/integrationen/integrationen/twinfield/twinfield-fehler-beheben.md).

# Twinfield-Fehler beheben

Verwende das Protokoll in den Twinfield-Einstellungen, um Importe, Exporte und Fehler zu prüfen.

Das Protokollfenster wird auf der rechten Seite der Einstellungsseite angezeigt.

{% stepper %}
{% step %}

### Öffnen Sie die Twinfield-Einstellungen

Gehen Sie zu **Einstellungen → Allgemein → Softwareintegrationen**.

Öffnen **Twinfield**.
{% endstep %}

{% step %}

### Prüfe das Protokollfenster

Überprüfe die neuesten Meldungen auf der rechten Seite.

Jeder Eintrag zeigt das Synchronisierungsergebnis.
{% endstep %}

{% step %}

### Öffnen Sie die Fehlerdetails

Klicke auf einen Eintrag mit dem orangefarbenen Fehlersymbol.

Lies dann die vollständige Meldung.
{% endstep %}

{% step %}

### Behebe die Ursache

Verwende die Fehlermeldung, um die fehlenden Daten oder die fehlende Einstellung zu identifizieren.
{% endstep %}

{% step %}

### Wiederholen Sie die Synchronisierung

Klicken Sie auf **Export (Aus)** oder das relevante Sync-Symbol.

Dadurch wird die fehlgeschlagene Aktion erneut versucht.
{% endstep %}
{% endstepper %}

### Erst die Schnellprüfungen

Prüfen Sie diese Punkte, bevor Sie tiefer einsteigen:

* die Twinfield-Verbindung ist noch aktiv
* der Kunde existiert in Twinfield oder kann exportiert werden
* die Materialien existieren in Twinfield als Artikel
* die Arbeitsperioden haben eine Stundenart
* die Arbeitsperioden haben einen Mitarbeiter
* der Arbeitsauftrag ist nicht auf Status festgefahren **99**

### Häufige Fehlermeldungen

<details>

<summary>Auf dem Arbeitsauftrag wurden keine Materialien gefunden, oder die Materialien existieren in Twinfield nicht</summary>

Der Arbeitsauftrag wurde als Rechnung exportiert.

Twinfield konnte die Materialien nicht als Artikel finden.

Stelle sicher, dass die Materialien in Twinfield existieren.

Oder importiere sie zuerst.

</details>

<details>

<summary>Kunde in Twinfield nicht gefunden</summary>

Der Kunde existiert in Twinfield nicht als Debitor.

Aktivieren Sie **Kontakte** unter **Optionen für Arbeitsaufträge**.

Oder legen Sie den Debitor zuerst in Twinfield an.

</details>

<details>

<summary>Fehler bei der Stundenbuchung — keine Stundenart gesetzt</summary>

Ein Arbeitszeitraum hat keine Stundenart.

Füge vor dem erneuten Export eine Stundenart hinzu.

</details>

<details>

<summary>Fehler bei der Stundenbuchung — kein Mitarbeiter gesetzt</summary>

Kein Mitarbeiter ist dem Arbeitszeitraum zugeordnet.

Lege in den Exporteinstellungen einen festen Mitarbeiter fest.

Oder weise dem Arbeitszeitraum einen Mitarbeiter zu.

</details>

<details>

<summary>Arbeitsauftrag auf Fehlerstatus (99) gesetzt</summary>

Der Export ist für diesen Arbeitsauftrag fehlgeschlagen.

Öffne die Fehlerdetails im Protokoll.

Behebe die Ursache.

Ändere dann den Arbeitsauftrags status und exportiere erneut.

</details>

<details>

<summary>Bei Mitarbeitern, Materialien oder Kontakten ist etwas schiefgelaufen</summary>

Es ist ein allgemeiner Importfehler aufgetreten.

Prüfe die Protokolldetails.

Führe dann erneut einen manuellen Import aus.

</details>

<details>

<summary>Verbindung abgelaufen oder Anmeldefehler</summary>

Das OAuth-Token ist abgelaufen.

Trenne die Integration.

Melde dich dann erneut über die Twinfield-Anmeldeseite an.

</details>

### Häufig gestellte Fragen

<details>

<summary>Wo finde ich das Synchronisierungsprotokoll?</summary>

Das Protokoll wird auf der rechten Seite der Twinfield-Einstellungsseite angezeigt.

Es zeigt die Zeit, die Meldung und die Fehlerdetails für jede Synchronisierung.

</details>

<details>

<summary>Ein Arbeitsauftrag hat Status 99. Wie behebe ich das?</summary>

Prüfe das Protokoll auf die Fehlerdetails.

Behebe zuerst das zugrunde liegende Problem.

Ändere dann den Arbeitsauftrags status in OutSmart und exportiere erneut.

</details>

<details>

<summary>Das Protokoll sagt, dass keine Arbeitsaufträge gefunden wurden. Ist das ein Fehler?</summary>

Nein.

Diese Meldung bedeutet, dass die Synchronisierung erfolgreich ausgeführt wurde.

Zu diesem Zeitpunkt gab es keine geeigneten Arbeitsaufträge.

</details>

<details>

<summary>Meine Verbindung funktioniert nicht mehr. Was soll ich tun?</summary>

Trenne Twinfield mit dem Ein/Aus-Symbol.

Melde dich dann erneut über die Twinfield-Anmeldeseite an.

</details>

<details>

<summary>Die Integration hat zuvor funktioniert, aber dann aufgehört. Was soll ich tun?</summary>

Prüfe zuerst das Protokoll auf Fehler.

Ein abgelaufenes Zugriffstoken ist eine häufige Ursache.

Verbinde die Integration bei Bedarf erneut.

</details>

### Verwandte Themen

* [**Twinfield**](/outsmart-knowledge-base/outsmart-knowledge-base-de/integrationen/integrationen/twinfield.md)
* [**Twinfield einrichten**](/outsmart-knowledge-base/outsmart-knowledge-base-de/integrationen/integrationen/twinfield/twinfield-einrichten.md)
* [**Twinfield-Exporte konfigurieren**](/outsmart-knowledge-base/outsmart-knowledge-base-de/integrationen/integrationen/twinfield/twinfield-exporte-konfigurieren.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://knowledge.out-smart.com/outsmart-knowledge-base/outsmart-knowledge-base-de/integrationen/integrationen/twinfield/twinfield-fehler-beheben.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
