> 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/auftragsbestatigung-erstellen.md).

# Auftragsbestätigung erstellen

Die Action **Create Order Confirmation** erstellt aus einem akzeptierten Lexware-Angebot eine finalisierte Auftragsbestätigung.

> **Teststatus:** Implementiert, aber noch nicht als allgemein verfügbar bestätigt. Zuerst nur mit kontrollierten Testvorgängen verwenden.

## Wann diese Action passt

Direkt nach dem Trigger Angebotsstatus geändert mit dem Filterwert `accepted`.

```
Angebotsstatus geändert: accepted
        ↓
Auftragsbestätigung erstellen
        ↓
Interne Weiterverarbeitung mit Nummer oder PDF
```

Die Action liest das Angebot in Lexware Office erneut. Nur ein akzeptiertes Angebot des aktuellen Kontakts darf weiterverarbeitet werden. Positionen, Beträge und Steuer kommen aus der Dokumentkette und werden nicht frei neu erfasst.

## Alle sichtbaren Felder

| Feld / Referenz                              | Pflicht                                | Werte / Format                                                  | Bedeutung                                                                              |
| -------------------------------------------- | -------------------------------------- | --------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| Accepted quotation ID / `quotationId`        | Ja                                     | UUID aus dem Trigger                                            | Im Variablen-Picker **Quotation ID** aus dem Trigger auswählen.                        |
| Document details / `documentDetailsMode`     | Ja                                     | `lexware_default` oder `custom`; Standard `lexware_default`     | Legt fest, ob Dokumenttexte die Lexware-Standardwerte verwenden oder angepasst werden. |
| Delivery text / `deliveryTermsMode`          | Ja                                     | `lexware_default`, `custom`, `none`; Standard `lexware_default` | Steuert nur die gedruckte Lieferzeile. `none` unterdrückt sie ausdrücklich.            |
| Title / `title`                              | Sichtbar bei `custom`                  | Text bis 25 Zeichen                                             | Optionaler eigener Titel.                                                              |
| Introduction / `introduction`                | Sichtbar bei `custom`                  | Text bis 2.000 Zeichen                                          | Optionale Einleitung.                                                                  |
| Remark / `remark`                            | Sichtbar bei `custom`                  | Text bis 2.000 Zeichen                                          | Optionale Bemerkung.                                                                   |
| Payment term in days / `paymentTermDuration` | Sichtbar bei `custom`                  | Ganze Zahl von `0` bis `3650`                                   | `0` bedeutet sofort, `14` bedeutet 14 Tage.                                            |
| Custom delivery text / `deliveryTerms`       | Pflicht bei `deliveryTermsMode=custom` | Text bis 255 Zeichen                                            | Ersetzt die Lieferzeile vollständig.                                                   |

Versteckte oder alte Feldwerte werden ignoriert, wenn du ausdrücklich Standardwerte oder keine Lieferzeile wählst.

## Payload-Beispiel

```json
{
  "data": {
    "quotationId": "66196c43-bfee-4af3-8335-d610367059db",
    "documentDetailsMode": "custom",
    "deliveryTermsMode": "custom",
    "title": "Auftragsbestätigung",
    "introduction": "Vielen Dank für Ihren Auftrag.",
    "paymentTermDuration": "14",
    "deliveryTerms": "Lieferung nach Vereinbarung."
  },
  "extras": {
    "locationId": "location_example_123",
    "contactId": "contact_example_123",
    "executionId": "execution_example_123"
  },
  "meta": {
    "key": "one_loop_lexware_create_order_confirmation"
  }
}
```

## Alle Ausgabevariablen

| Variable                                                                        | Bedeutung im Workflow                              |
| ------------------------------------------------------------------------------- | -------------------------------------------------- |
| `success`, `status`                                                             | Vollständiger Erfolg und Ergebnisstatus.           |
| `errorCode`, `errorMessage`, `retryable`, `warnings`                            | Fehler- und Hinweiswerte.                          |
| `sourceMode`                                                                    | Immer `quotation`.                                 |
| `sourceReferenceType`, `sourceReferenceId`                                      | Immer Angebotsquelle und ihre Kennung.             |
| `lexwareContactId`, `customerMatchMethod`, `customerCreated`, `customerUpdated` | Kontaktauflösung für diesen Lauf.                  |
| `quotationId`                                                                   | Ursprungsangebot in Lexware Office.                |
| `orderConfirmationId`                                                           | Lexware-Kennung der Auftragsbestätigung.           |
| `orderConfirmationNumber`                                                       | Sichtbare Nummer.                                  |
| `orderConfirmationStatus`                                                       | Status der Auftragsbestätigung.                    |
| `voucherDate`, `currency`, `netAmount`, `taxAmount`, `grossAmount`              | Finale Belegdaten.                                 |
| `officialDocumentMimeType`, `officialDocumentFileName`                          | Typ und Name des offiziellen Dokuments.            |
| `orderConfirmationDocumentId`                                                   | Kennung der PDF-Kopie am Kontakt.                  |
| `orderConfirmationFileUrl`                                                      | URL der PDF-Kopie für Folgeschritte.               |
| `orderConfirmationFileName`, `orderConfirmationMimeType`                        | Dateiname und Typ dieser Kopie.                    |
| `contactDocumentStatus`                                                         | Bei vollständigem Erfolg `uploaded`.               |
| `lexwareViewUrl`                                                                | Interner Lexware-Link; nicht öffentlich versenden. |

## Wiederholungen

Die Angebots-ID ist der dauerhafte fachliche Schlüssel. Wiederholte oder parallele Läufe erzeugen nicht blind eine zweite Auftragsbestätigung. Die bereits zugehörige Auftragsbestätigung wird wiederverwendet.