Rechnungsvorschau
rvg_preview_invoiceZeigt eine Rechnung als Entwurf, bevor sie ausgestellt wird. Rufe es für jede Rechnung zuerst, vor rvg_create_invoice. Kanzleidaten kommen aus den Einstellungen; fehlen sie, nennt es die Antwort. Dasselbe Layout wie rvg_create_invoice mit dem Wasserzeichen „ENTWURF“ und der voraussichtlichen Rechnungsnummer. Mit dem Tarif ONYST RVG mit Briefvorlage, Logo und Texten der Kanzlei, ohne ihn im Standardlayout ohne Logo, auch ohne Kanzlei; bei mehreren Kanzleien ohne Vorzugs-Kanzlei lehnt es ab. Ausgestellt, vergeben oder gespeichert wird nichts; der Entwurf zählt als eine Rechen-Anfrage. Eingabe wie bei rvg_create_invoice. Bei Änderungswünschen (etwa „ergänze die Postpauschale“) rufe es mit den geänderten Angaben erneut auf. Ausgestellt wird erst, wenn der Nutzer es will — in Hosts mit Ansichten über den Knopf „Rechnung ausstellen“ der Vorschau, sonst mit rvg_create_invoice. preview (eigenes Argument neben request, nicht darin): widget (Vorgabe) zeigt die Seiten in der Ansicht und gibt dir eine Zusammenfassung; pdf hängt das Entwurfs-PDF als Ressource an, image die erste Seite als Bild — beides kostet Kontext, nimm es nur, wenn der Host keine Ansichten zeigt; arbeitest du ohne Ansichten (etwa in Claude Code oder als Agent), nimm gleich beim ersten Aufruf pdf. Mit dem eigenen ONYST-Konto oder einem API-Schlüssel mit vollem Umfang: Suche den Empfänger zuerst mit rvg_recipients_search und übergib seine id als empfaengerId. Die Antwort nennt unter addressBook, ob der Empfänger neu ist oder vom Adressbuch abweicht; biete danach an, ihn zu speichern bzw. zu aktualisieren (rvg_recipient_save) — nie ungefragt. Ebenso nennt firmProfile, welche Angaben aus kanzlei in den Kanzleidaten fehlen oder abweichen; biete an, sie mit rvg_firm_profile_update zu speichern — nie ungefragt. Als PDF sagt hint, wenn die Rechnung auch als E-Rechnung ginge, und firmProfile mit status e-rechnung, was ihr dafür fehlt; biete sie dann einmal an. Ob der Nutzer diese Rechnung schon ausgestellt hat (etwa über den Knopf der Ansicht), sagt dir dieses Werkzeug: Mit denselben Angaben nennt hint dann die vergebene Nummer — stell sie nicht noch einmal aus. Unter rueckfragen stehen Positionen, die typischerweise fehlen — frag den Nutzer (zeigt die Ansicht sie mit Antwortknöpfen, nenn nur ihre Zahl), statt sie selbst zu ergänzen, außer er hat sie ausgeschlossen („ohne Auslagen“ schließt Nr. 7002 ein, „nur …“). Keine Fragen ohne Anlass. Frag nicht im selben Zug, ob du ausstellen sollst, solange eine Rückfrage offen ist; stelle erst aus, wenn sie beantwortet sind. Meldet das Ergebnis, dass die Ansicht die Rückfragen mit Antwortknöpfen zeigt, frag nicht im Text danach: Nenn nur, wie viele offen sind — der Nutzer beantwortet sie dort. Hat der Nutzer eine Rückfrage verneint, trag ihren code, in der Gesamtrechnung mit pfad, in rueckfragenVerneint ein; sie kommt dann nicht wieder. Den Entwurf zeigst du trotzdem gleich, wenn der Nutzer die Rechnung will — er stellt nichts aus —, und fragst dazu, außer nach den Rückfragen mit Antwortknöpfen in der Ansicht. Mehrere Angelegenheiten: je Angelegenheit ein Entwurf, request nimmt eine Berechnung. Rechnungsdatum (heute), Leistungszeitraum und Zahlungsziel erfragst du dafür nicht. Nenn nur Beträge aus dem Ergebnis: keine Umsatzsteuer aufschlagen, keine Brutto-, Teil- oder Differenzsummen und keinen Betrag „effektiv nach Anrechnung“; fehlt einer, ruf erneut auf (etwa mit ustPflichtig oder für eine andere Variante) oder nenn ihn nicht. Antworte knapp: Summe zuerst, Positionen nur mit Nummer und Betrag, ohne Rechenweg. Was das Gespräch beantwortet, frag nicht; sonst je Rückfrage ein Satz.
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": {
"request": "<request>"
},
"name": "rvg_preview_invoice"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| preview | No | Wie die Vorschau ankommt (neben request, nicht darin): widget (Seiten in der Ansicht des Hosts, Vorgabe), pdf (Entwurfs-PDF als Ressource) oder image (erste Seite als Bild). | |
| request | Yes | Die Rechnung wie bei rvg_create_invoice: Berechnung, Empfänger, Rechnungsangaben. | |
| rueckfragenVerneint | No | Rückfragen, die der Nutzer verneint hat (eigenes Argument neben request, nicht darin); sie fehlen dann im Ergebnis. Gib die Liste in jedem weiteren Aufruf wieder mit. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| net | Yes | ||
| vat | Yes | ||
| hint | Yes | ||
| gross | Yes | ||
| applied | No | ||
| preview | Yes | ||
| amountDue | No | ||
| pageCount | No | ||
| positions | Yes | ||
| deductions | No | ||
| addressBook | No | ||
| firmProfile | No | ||
| rueckfragen | No | ||
| expectedNumber | No | ||
| numberFromSeries | Yes |