Zur Freigabe einreichen
approval_submitReicht einen Brief zur menschlichen Freigabe ein: prüft Pflichtangaben, Empfänger, AVV und Limits, erstellt die finale PDF, berechnet den Preis, reserviert die Kosten und legt eine Freigabe in der Warteschlange an. Sie wartet auf die Entscheidung eines Menschen, auch mit Autopilot. Die eingebettete Karte ist Vorschau und Freigabe. PDF-Link und Brieftext stehen zusätzlich im Ergebnis, für reine Textansichten. Mit approval:self_approve zeigt die Karte Freigeben und Ablehnen. In allen anderen Fällen führt sie ins angemeldete Portal. Mit dryRun bleiben Guthaben und Warteschlange unberührt, und die Antwort enthält die Liste checks (jede Prüfung mit passed, failed oder skipped). EN: Submits a letter for human approval: checks mandatory details, recipient, data processing agreement and limits, creates the final PDF, calculates the price, reserves the cost and adds an approval to the queue. It waits for a person's decision, also with autopilot. The embedded card is the preview and approval. The PDF link and letter text are also in the result, for text-only views. With approval:self_approve, the card shows Approve and Reject. In every other case it opens the signed-in portal. With dryRun, the balance and queue remain untouched, and the answer contains the checks list (each gate with passed, failed or skipped).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "approval_submit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| color | No | Ohne Angabe wird die Farbe automatisch erkannt. EN: If omitted, colour is detected automatically. | |
| dryRun | No | ||
| reason | No | Kurzer Grund für die Freigabe, den die prüfende Person auf der Karte liest. EN: Short reason for the approval, shown to the reviewer on the card. | |
| content | No | ||
| express | No | ||
| subject | No | ||
| auditTag | No | ||
| letterId | No | Bestehender Entwurf. Alternativ kommt der Brief inline. EN: Existing draft. The letter can come inline instead. | |
| reasoning | No | ||
| presetName | No | ||
| templateId | No | ||
| scheduledAt | No | ||
| signatureId | No | ||
| approvalMode | No | ||
| deliveryType | No | Standard standard. EN: Defaults to standard. | |
| maxCostEuros | No | Maximalbetrag in Euro. Liegt der Preis darüber, wird abgebrochen. EN: Maximum amount in euros. If the price is above it, the call is aborted. | |
| recipientZip | No | ||
| clientOrderId | No | Idempotenzschlüssel. Ein erneuter Aufruf mit demselben Wert liefert dieselbe Freigabe, statt ein zweites Mal einzureichen. Der Präfix 'approval:' ist reserviert. EN: Idempotency key. A repeat call with the same value returns the same approval instead of submitting a second time. The 'approval:' prefix is reserved. | |
| recipientCity | No | ||
| recipientName | No | ||
| mandantennummer | No | ||
| recipientStreet | No | ||
| senderAddressId | No | ||
| senderProfileId | No | ||
| includeSignature | No | ||
| recipientCompany | No | ||
| recipientCountry | No | ISO-3166-alpha-2, Standard DE. EN: ISO 3166-1 alpha-2, defaults to DE. | |
| requesterContext | No | Zusatzkontext zur einreichenden Person oder zum Anlass. EN: Additional context about the submitter or the occasion. | |
| recipientAddressId | No | Eine gespeicherte Adresse aus dem Adressbuch (address_list) als Empfänger, an Stelle der Felder recipientName bis recipientCountry. EN: A saved address from the address book (address_list) as the recipient, in place of the fields recipientName to recipientCountry. | |
| recipientHouseNumber | No |