# Tool-Übersicht, Fassung 2026-10-10 (https://developer.bimetrics.de/mcp/tools/2026-10-10)

Optionale Auftragsbestätigungen, ausdrücklich gewählte Rechnungsquelle und vollständiger PDF-Download.

Diese Fassung ergänzt die [Werkzeuge vom 09.10.2026](/mcp/tools/2026-10-09). Sie verwendet weiterhin die Anlage „MCP-Verbindungen“ aus dem [Rechtspaket 2026-10-09-v1](https://bimetrics.de/rechtliches/2026-10-09-v1/avv#anlage-mcp-verbindungen). 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-Download

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 Schreibzugriff

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 Wiederholungsregeln

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.