> 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/billit/fehlerbehebung-fur-billit.md).

# Fehlerbehebung für Billit

Verwenden Sie das Protokoll in den Billit-Einstellungen, um Importe, Exporte und Fehler zu prüfen.

Klicken Sie auf einen Eintrag mit dem orangefarbenen Fehler-Symbol, um die vollständige Meldung zu öffnen.

{% stepper %}
{% step %}

### Öffnen Sie die Billit-Einstellungen

Gehen Sie zu **Einstellungen → Allgemein → Software-Integrationen**.

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

{% step %}

### Öffnen Sie das Protokoll

Sehen Sie sich das Protokollfeld auf der rechten Seite an.

Öffnen Sie dann den neuesten Warn- oder Fehler-Eintrag.
{% endstep %}

{% step %}

### Lesen Sie die vollständige Meldung

Verwenden Sie die vollständigen Fehlerdetails, um die genaue Ursache zu finden.

Prüfen Sie, welcher Datensatz oder welches Feld betroffen ist.
{% endstep %}

{% step %}

### Beheben Sie die Ursache und versuchen Sie es erneut

Nachdem Sie das Problem behoben haben, führen Sie **Arbeitsaufträge exportieren** oder **Synchronisieren** erneut aus.
{% endstep %}
{% endstepper %}

### Erst die Schnellprüfungen

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

* die Verbindung ist noch aktiv
* der Rechnungskunde ist mit Billit verknüpft
* der Lieferkunde ist mit Billit verknüpft
* der Arbeitsauftrag hat abrechenbare Materialzeilen
* der Arbeitsauftrag hat ein Start- und Enddatum
* jedes exportierte Material hat einen Produktcode

### Häufige Fehlermeldungen

<details>

<summary>Externe ID des Rechnungskunden fehlt</summary>

Der Rechnungskunde im Arbeitsauftrag ist nicht mit einem Billit-Kunden verknüpft.

Importieren Sie zuerst den Kunden aus Billit.

Oder stellen Sie sicher, dass der Kunde über die Billit-Synchronisierung erstellt wurde.

</details>

<details>

<summary>Externe ID des Lieferkunden fehlt</summary>

Der Lieferkunde im Arbeitsauftrag ist nicht mit einem Billit-Kunden verknüpft.

Importieren Sie zuerst den Lieferkunden aus Billit.

</details>

<details>

<summary>Material-Bestellzeilen sind ungültig</summary>

Der Arbeitsauftrag hat keine abrechenbaren Materialzeilen.

Fügen Sie mindestens ein abrechenbares Material hinzu, bevor Sie erneut exportieren.

</details>

<details>

<summary>Startdatum oder Enddatum des Arbeitsauftrags fehlt</summary>

Dem Arbeitsauftrag fehlt ein Start- oder Enddatum.

Legen Sie beide Daten im Arbeitsauftrag fest.

</details>

<details>

<summary>Material ist für den Export nicht gültig. Code-Feld fehlt</summary>

Ein Material im Arbeitsauftrag hat keinen Produktcode.

Öffnen Sie das Material in OutSmart und fügen Sie den Code hinzu.

</details>

<details>

<summary>Material existiert nicht in Billit</summary>

Der Materialcode existiert nicht in Billit.

Schalten Sie **Neue Materialien** wenn OutSmart es automatisch erstellen soll.

</details>

<details>

<summary>Produkt mit dieser Referenz existiert bereits in Billit</summary>

Billit hat bereits ein Produkt mit dieser Referenz.

Normalerweise ist keine Aktion erforderlich.

Wenn das Problem bestehen bleibt, prüfen Sie auf doppelte Produktcodes.

</details>

<details>

<summary>Beim Erstellen der Rechnung oder des Angebots ist ein Fehler aufgetreten</summary>

Billit hat beim Export einen Fehler zurückgegeben.

Öffnen Sie die vollständige Protokollmeldung und prüfen Sie, ob alle erforderlichen Felder des Arbeitsauftrags ausgefüllt sind.

</details>

<details>

<summary>Billit-Kunde kann aufgrund fehlender Felder nicht importiert werden</summary>

Dem Kunden fehlen in Billit erforderliche Daten.

Füllen Sie die Kundennummer, den Namen, die Straße, die Postleitzahl und die Stadt aus.

</details>

<details>

<summary>Billit-Produkt kann aufgrund fehlender Felder nicht importiert werden</summary>

Dem Produkt fehlt ein **Referenz** oder **Beschreibung**.

Füllen Sie beide Felder in Billit aus.

</details>

<details>

<summary>Beim Abrufen von Produkten aus Billit ist ein Fehler aufgetreten</summary>

OutSmart konnte keine Produkte aus Billit abrufen.

Prüfen Sie die vollständigen Protokolldetails.

Verbinden Sie die Integration erneut, wenn das Problem weiterhin auftritt.

</details>

<details>

<summary>API-Token abgelaufen. Authentifizieren Sie die Integration erneut</summary>

Das Billit-Zugriffstoken ist abgelaufen.

Verwenden Sie das Netzschalter-Symbol, um die Integration zu trennen.

Verbinden Sie sie dann erneut über die Billit-Login-Seite.

</details>

### Häufig gestellte Fragen

<details>

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

Öffnen Sie die Billit-Einstellungen.

Das Protokoll ist auf der rechten Seite sichtbar.

</details>

<details>

<summary>Sind „Nichts zu importieren“ oder „Nichts zu exportieren“ ein Fehler?</summary>

Nein.

Das bedeutet, dass die Synchronisierung ausgeführt wurde, aber keine neuen Daten verarbeitet werden mussten.

</details>

<details>

<summary>Die Integration hat vorher funktioniert und dann aufgehört. Was soll ich tun?</summary>

Prüfen Sie zuerst das Protokoll.

Eine häufige Ursache ist ein abgelaufenes Zugriffstoken.

Verbinden Sie die Integration bei Bedarf erneut.

</details>

<details>

<summary>Ein Arbeitsauftrag wurde erfolgreich exportiert, aber ich kann ihn in Billit nicht finden. Was soll ich tun?</summary>

Prüfen Sie das OutSmart-Protokoll auf die Billit-Bestell-ID.

Wenn Sie als Rechnung exportieren, prüfen Sie die Rechnungen in Billit.

Wenn Sie als Angebot exportieren, prüfen Sie die Angebote in Billit.

</details>

### Verwandte Themen

* [**Billit**](/outsmart-knowledge-base/outsmart-knowledge-base-de/integrationen/integrationen/billit.md)
* [**Billit einrichten**](/outsmart-knowledge-base/outsmart-knowledge-base-de/integrationen/integrationen/billit/billit-einrichten.md)
* [**Billit-Exporte konfigurieren**](/outsmart-knowledge-base/outsmart-knowledge-base-de/integrationen/integrationen/billit/billit-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/billit/fehlerbehebung-fur-billit.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.
