> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/marketplace-apps/sevdesk.md).

# sevdesk

Überblick über den bestätigten Testumfang der sevdesk-Integration für ONE LOOP und die Voraussetzungen für einen sicheren Test.

Die sevdesk-Integration verbindet einen ONE LOOP Standort mit sevdesk und erweitert Workflows um buchhaltungsnahe Dokumente und Ereignisse.

{% hint style="warning" %}
**Aktueller Status: Testversion.** Die Integration ist technisch als Test-App registriert. Nutze sie erst produktiv, wenn der Funktionsumfang, die Zugänge und der vollständige Testablauf für deinen Standort bestätigt wurden.
{% endhint %}

## Was im Testumfang vorgesehen ist

| Bereich    | Funktion                      | Zweck                                                                           |
| ---------- | ----------------------------- | ------------------------------------------------------------------------------- |
| Dokumente  | Rechnung erstellen            | Einen Rechnungsprozess aus einem Workflow heraus anstoßen                       |
| Dokumente  | Angebot erstellen             | Ein Angebot aus einem Kontakt-, Termin- oder Vertriebsprozess erzeugen          |
| Dokumente  | Auftragsbestätigung erstellen | Eine Auftragsbestätigung aus einem passenden Angebot ableiten                   |
| Dokumente  | Gutschrift erstellen          | Eine Gutschrift auf Basis eines Abrechnungs- oder Rückerstattungsfalls erzeugen |
| Ereignisse | Rechnungszahlung empfangen    | Bei einer verarbeiteten Rechnungszahlung einen Workflow starten                 |
| Ereignisse | Angebotsstatus geändert       | Auf eine Änderung im Status eines Angebots reagieren                            |

## So ist die Integration gedacht

Ein Workflow in ONE LOOP gibt den Anlass vor – etwa eine Zahlung, eine Verkaufschance oder ein bestätigter Vorgang. Die sevdesk-Action erhält die dafür freigegebenen Kontakt-, Positions- und Dokumentdaten und erstellt den Beleg im verbundenen Fachsystem.

Nach erfolgreicher Verarbeitung soll der Workflow die relevanten Ergebniswerte nutzen können, zum Beispiel Dokumentnummer, Betrag, Status und PDF. Ereignisse aus sevdesk funktionieren in die andere Richtung: Sie liefern den Anlass und die aktuellen Daten für einen Workflow in ONE LOOP.

## Was vor einem produktiven Einsatz geprüft werden muss

Die vorhandene Testintegration erfordert noch eine vollständige fachliche und technische Validierung. Vor einer produktiven Freigabe müssen insbesondere geprüft werden:

1. Verbindung und Berechtigungen des richtigen sevdesk-Kontos.
2. Vollständige Kontakt- und Adresszuordnung.
3. Positions-, Mengen-, Preis- und Steuerübernahme.
4. Erstellung, Finalisierung und PDF-Abruf jedes Dokumenttyps.
5. Zahlungsziel bei Rechnungen.
6. Steuerübernahme bei Gutschriften.
7. Erkennung von Teil- und Schlusszahlungen.
8. Erkennung echter Angebotsstatuswechsel.
9. Verhalten bei technischen Wiederholungen und Fehlern.

## Sicher testen

Teste immer in einem klar abgegrenzten ONE LOOP Standort und mit nachvollziehbaren Testdaten:

1. Verbindung einrichten und Status prüfen.
2. Einen Testkontakt mit vollständigen Rechnungsdaten anlegen.
3. Einen einzelnen Dokumenttyp testen.
4. Beleg, Beträge, Steuerdarstellung und PDF in sevdesk prüfen.
5. Workflow-Ausführung und Ergebnisvariablen in ONE LOOP prüfen.
6. Erst danach den nächsten Dokumenttyp oder Trigger testen.

## Was diese Seite bewusst noch nicht verspricht

Solange die Testvalidierung nicht abgeschlossen ist, beschreibt diese Seite keinen allgemeinen Produktivumfang und keine verbindliche Automatisierung für besondere Steuerfälle. Verfügbarkeiten und genaue Einrichtungsanleitungen werden ergänzt, sobald sie im Test bestätigt sind.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://one-loop.gitbook.io/help/marketplace-apps/sevdesk.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.