> 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/lexware-office/workflow-actions.md).

# Workflow Actions

Actions sind Workflow-Schritte, die ein Dokument in Lexware Office erstellen oder aus einem bestehenden Dokument weiterführen.

> **Teststatus:** Der beschriebene Funktionsumfang ist implementiert. Die allgemeine Verfügbarkeit ist noch nicht bestätigt; nutze ihn bis dahin nur kontrolliert mit Testdaten.

## Verfügbare Actions

| Action                        | Wann verwenden?                                           | Wichtigste Ausgabe                                    |
| ----------------------------- | --------------------------------------------------------- | ----------------------------------------------------- |
| Rechnung erstellen            | Nach Zahlung, mit Produkten oder eigenen Positionsfeldern | `invoiceNumber`, `invoiceFileUrl`                     |
| Angebot erstellen             | Für Anfragen oder Vertriebsprozesse                       | `quotationNumber`, `quotationFileUrl`                 |
| Auftragsbestätigung erstellen | Direkt nach einem akzeptierten Angebot                    | `orderConfirmationNumber`, `orderConfirmationFileUrl` |
| Gutschrift erstellen          | Direkt nach einer erfolgreichen Rückerstattung            | `creditNoteNumber`, `creditNoteFileUrl`               |

## Gemeinsamer Ablauf

Alle Dokument-Actions prüfen zuerst Verbindung, Kontakt, Pflichtfelder und die fachlich passenden Beträge. Danach wird der Beleg erstellt, aus Lexware Office zurückgelesen, als offizielles PDF geladen und im Kontakt gespeichert. Erst danach antwortet die Action erfolgreich.

## Gemeinsame Ausgabevariablen

| Variable                                                           | Bedeutung                                           | Typische Verwendung                               |
| ------------------------------------------------------------------ | --------------------------------------------------- | ------------------------------------------------- |
| `success`                                                          | `true` nur bei vollständigem Erfolg                 | IF/ELSE direkt nach der Action                    |
| `status`                                                           | Fachlicher Ergebnisstatus                           | Protokoll oder Verzweigung                        |
| `errorCode`, `errorMessage`                                        | Fehlerkennung und verständliche Meldung             | Interne Warnung oder Support-Fall                 |
| `retryable`                                                        | Kennzeichnet einen möglichen vorübergehenden Fehler | Nicht blind wiederholen; Ursache prüfen           |
| `warnings`                                                         | Liste zusätzlicher Hinweise                         | Interne Prüfung                                   |
| `sourceMode`, `sourceReferenceType`, `sourceReferenceId`           | Verwendete Datenquelle und ihre Kennung             | Nachvollziehbarkeit im Workflow                   |
| `lexwareContactId`                                                 | Verwendeter Lexware-Kontakt                         | Interne Zuordnung                                 |
| `voucherDate`, `currency`, `netAmount`, `taxAmount`, `grossAmount` | Final zurückgelesene Belegdaten                     | Nachricht, Kontaktfeld oder weiteres System       |
| `officialDocumentFileName`, `officialDocumentMimeType`             | Name und Typ des offiziellen Dokuments              | Dokumentenprüfung                                 |
| `contactDocumentStatus`                                            | Bei vollständigem Erfolg `uploaded`                 | Vor der Weitergabe der Datei prüfen               |
| `lexwareViewUrl`                                                   | Interner Link in Lexware Office                     | Nur intern verwenden, nicht als öffentlicher Link |

Wähle Ausgaben immer über den Variablen-Picker derselben Action-Instanz. Die Detailseiten enthalten die action-spezifischen Felder und vollständige Beispiele.