Entwurf prüfenVom Auftrag zum kontrollierten Entwurf.
Lass deinen Agenten zuerst fehlende Kunden-, Positions- und Datumsangaben klären. Nach dem Anlegen liest er den Beleg erneut und gleicht Empfängeranschrift, Rabatt, Steuern und Summen mit deinem Auftrag ab. Die Antwort enthält mit reviewPath einen Link zur Belegansicht in Saldenwerk.
Bei Rechnungsentwürfen nennt preflight.issues fehlende oder widersprüchliche Angaben mit code, path, message und reviewPath zur passenden Bearbeitungsseite. Die Rechnungsansicht zeigt dieselben Hinweise. preflight.checksPassed bestätigt nur diese Vorprüfung; Finalisierung und Dateivalidierung folgen erst danach. Die Vorprüfung vergibt keine Nummer. Angebote und abgeschlossene Rechnungen enthalten preflight: null.
customerSource unterscheidet aktuelle Empfängerdaten im Entwurf (current) von den beim Abschluss gespeicherten Angaben (snapshot). Spätere Änderungen an der Kundenakte ändern den historischen Empfänger nicht. Nicht gespeicherte Kontaktdaten bleiben leer. Bei unavailable ist customer leer; prüfe dann das Originaldokument. Aktuelle Kontaktdaten lassen sich separat über customers_get lesen.
Dort kannst du den Entwurf bearbeiten. Positionen enthalten auch Einheitencode und Steuerbefreiungsgrund. Unbekannte Eingabefelder werden abgewiesen; unterstützt werden EUR und bei Rechnungen ein einzelnes Leistungsdatum. Der Agent kann Entwürfe mit den Update-Werkzeugen korrigieren. Abschließen und Versand erfolgen nicht über MCP. In der Rechnungsansicht kannst du finalisieren und eine fehlgeschlagene Dateierzeugung erneut starten.
Für jeden neuen Beleg übergibt der Agent eine einmal erzeugte UUID als idempotencyKey. Bei einer Wiederholung mit denselben Angaben und demselben Schlüssel wird derselbe Beleg zurückgegeben; meta.replayed zeigt die Wiederholung an. Andere Angaben zum selben Schlüssel werden als Konflikt abgewiesen.
Für Korrekturen verwendet er id, die zuletzt gelesene revision als expectedRevision und ein changes-Objekt. Nur angegebene Felder werden geändert; items ersetzt alle Positionen. Bei revision_conflict muss er den Entwurf neu lesen und die Änderung prüfen. Eine leere Zeichenfolge löscht Notiz oder Käuferreferenz. Entwürfe mit zugeordneten Angebots- oder Bestellpositionen werden in Saldenwerk bearbeitet.
Der Scope mcp:documents:write erlaubt Anlegen und Korrigieren. Die Erweiterung setzt die Migration 20260927140000 und den zugehörigen App-Stand voraus. Bestehende Clients müssen den neuen Pflichtwert idempotencyKey ergänzen.