Beleg umwandeln
convert_sales_documentTarif: ab Pro (darunter antwortet die API mit plan_required).
Beleg umwandeln
Erzeugt den Folgebeleg: order_confirmation oder delivery_note (neuer Beleg in derselben Kette, Antwort SalesDocument) oder invoice (Rechnungsentwurf mit nächster RE-Nummer, Zahlungsziel aus dem Profil, Antwort Invoice, feuert invoice.created). Angebot → AB/Lieferschein/Rechnung, AB → Lieferschein/Rechnung, Lieferschein → Rechnung. Ab Pro: Angebot → Rechnung; jedes Weiterführen in eine oder aus einer Auftragsbestätigung bzw. einem Lieferschein ab Business (403 plan_required). Der Ausgangsbeleg rückt im Status weiter; der Rechnungsentwurf zählt ins Monatskontingent. Steht der Beleg unter § 19 UStG (Kleinunternehmer), die Rechnungsvorgaben des Kontos inzwischen auf Umsatzsteuer, weist die Rechnung Umsatzsteuer aus; price_basis legt fest, ob der Preis als Brutto gilt (gross, Vorgabe — der Gesamtbetrag bleibt) oder als netto zuzüglich USt (net). Scope invoices:draft. Ohne Idempotency-Key erzeugt jeder Aufruf einen weiteren Beleg.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "convert_sales_document"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Interne `id` des Belegs (UUID), nicht die Belegnummer. Zu einer Nummer (z. B. `AN-2026-0004`) liefert `GET /sales-documents?number=…` (MCP: `list_sales_documents` mit `number`) die `id`. | |
| body | No | JSON-Request-Body. | |
| _idempotency_key | No | Optional. Geht als Header `Idempotency-Key` an die API: derselbe Wert mit demselben Aufruf liefert 24 Stunden lang die erste Antwort zurück, statt den Vorgang zu wiederholen. Bei einem Wiederholversuch denselben Wert schicken. |