Tool-Übersicht, Fassung 2026-10-10

Diese Fassung ergänzt die Werkzeuge vom 09.10.2026. Sie verwendet weiterhin die Anlage „MCP-Verbindungen“ aus dem Rechtspaket 2026-10-09-v1. Nach deren Abschnitt 2.3 ist für den erweiterten Werkzeug- und Datenumfang eine neue Freigabe nötig; die Anlage selbst bleibt unverändert.

Bestehende Verbindungen behalten ihren bisherigen Umfang. Sie sehen keine Auftragsbestätigungen und erhalten weder deren neue Werkzeuge noch stillschweigend Schreibrechte. Du entscheidest bei der erneuten Verbindung, ob du zusätzlich Schreibzugriff erlaubst.

Lesen und PDF-DownloadLink zu diesem Abschnitt kopieren

Auch eine neue Verbindung mit ausschließlich mcp:read darf Rechnungen, Angebote, Auftragsbestätigungen und deren Entwürfe lesen: search_sales_documents, get_sales_document, check_sales_draft, preview_sales_document und download_sales_document. Die Vorschau und heruntergeladene PDFs enthalten alle gedruckten Angaben, auch Anschriften und Bankdaten. Lesen verändert und versendet nichts. Ein reiner Lesezugriff erhält keinen Token zum Finalisieren.

download_sales_document erwartet die Entwurf-ID id; bei mehreren Unternehmen zusätzlich company. Es liefert das gespeicherte Original-PDF eines ausgestellten Dokuments oder ein PDF mit Entwurfskennzeichnung.

• Bis 48 KiB steht die vollständige PDF-Datei als eingebettete Ressource im Ergebnis (attached: true).
• Größere PDFs werden vollständig in Abschnitten mit höchstens 48 KiB übertragen: dataBase64 decodieren und die Bytes in Reihenfolge von offset zusammensetzen. nextOffset bezeichnet den nächsten Aufruf; dabei den ersten sha256 als expectedSHA256 mitsenden.
• Ohne nextOffset ist die Datei vollständig. Vor dem Speichern Gesamtlänge size und SHA-256 prüfen. Bei verändertem Inhalt bricht der Abruf ab; dann neu bei Offset 0 beginnen. Obergrenze: 30 MiB.

Es gibt keine öffentlichen oder anonymen Downloadlinks. Jeder Abschnitt prüft erneut die Verbindung und das Unternehmen. Es wird keine E-Mail verschickt.

Optionaler AB-Ablauf mit SchreibzugriffLink zu diesem Abschnitt kopieren

1. Finalisiertes Angebot mit get_sales_document lesen.
2. derive_sales_document mit id des Angebotsentwurfs, targetKind: "order_confirmation", seinem exakten expectedUpdatedAt und einem neuen idempotencyKey aufrufen.
3. Den AB-Entwurf bei Bedarf mit update_sales_draft ändern und mit preview_sales_document zeigen.
4. Nur wenn du diese Fassung nach der Vorschau finalisieren möchtest, finalize_sales_draft mit dem unveränderten PreviewToken, Versionswert, Käufer und Bruttobetrag aufrufen.
5. Die fertige AB besitzt eine eigene Nummer und ein unveränderliches PDF. Sie erzeugt keine Buchung, kein E-Rechnungs-XML und keinen Versand.
6. Für eine Rechnung ausdrücklich derive_sales_document mit der finalen AB als Quelle und targetKind: "invoice" verwenden. Der bestehende Rechnungsablauf übernimmt danach Prüfung und Finalisierung.

copy_sales_document mit toInvoice: true bleibt unverändert: Es erstellt die Rechnung weiterhin aus dem Angebot. Eine AB ist keine Pflicht. Eine Änderung der AB wird niemals still in einen bestehenden Rechnungsentwurf übernommen. Pro Verkaufsvorgang bleibt höchstens eine Rechnung möglich; ein Konflikt verweist auf den vorhandenen Entwurf.

Ein noch offener AB-Entwurf kann auf deinen Wunsch mit delete_order_confirmation_draft verworfen werden. Das Werkzeug verlangt seine ID, den exakten expectedUpdatedAt und einen idempotencyKey. Finale ABs, Angebote und Rechnungen sind darüber nicht löschbar. Es gibt in diesem Modul weder Kundenzusage noch Versandvermerke.

Versions- und WiederholungsregelnLink zu diesem Abschnitt kopieren

Schreibaktionen verwenden dieselben Rechte, Transaktionen, Idempotenz- und Versionsprüfungen wie die App und die Company API. Einen Schlüssel nur für die identische Wiederholung verwenden. Versionskonflikte verlangen erneutes Lesen und Prüfen; niemals automatisch den Versionswert ersetzen. Die Vorschau zum Finalisieren gilt 15 Minuten und ist an die konkrete Verbindung und den gedruckten Inhalt gebunden.