Angebot als Vorschau
preview_offerPreview an Angebot, Kostenvoranschlag or Auftragsbestätigung for the connected facturo account; the user sees it as a card. The first call creates an Entwurf the user also sees at facturo.at, later calls with draft_id change it: pass only what changes, the rest stays. Call it again after every change the user asks for; finalize_offer needs the review_hash of the card the user confirmed. For an Auftragsbestätigung pass source_offer_number; items, client, VAT and texts come from the source and can be overridden. The result lists what is still missing.
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": "preview_offer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | No | ||
| client | No | The invoice recipient. The name is required for the first preview of a draft; the real invoice needs the address. | |
| draft_id | No | Handle from an earlier preview_offer result; pass it to change that draft instead of starting a new one. | |
| fusstext | No | Text below the totals; defaults to the account's standard text | |
| kopftext | No | Text above the items; defaults to the account's standard text | |
| vat_rate | No | Percent for tax_exempt 'show', default 20 | |
| client_id | No | A client of the connected account (from search_clients) instead of client. | |
| offer_date | No | YYYY-MM-DD, default today | |
| tax_exempt | No | 'show' prints USt at vat_rate, 'exempt' prints no USt (Kleinunternehmer, reverse charge). Leave it out to take the account's usual setting for this client; the result names what was applied. | |
| discount_type | No | Gesamtrabatt on the whole document, deducted as its own line below the items (VAT is computed on the reduced amount). 'percentage' = discount_value is a percent of the net item total, 'fixed' = discount_value is an EUR amount (in the draft's price mode). Requires discount_value. Set it when the user grants a discount/Nachlass/Aktionscode on the whole invoice or offer; never bill a discount as a negative item. 'none' clears a discount set earlier. Not available on an Anzahlungsrechnung (the deposit share replaces it); a Storno inherits the cancelled invoice's discount automatically. | |
| document_type | No | 'angebot' (default), 'kostenvoranschlag' or 'auftragsbestaetigung'. An Auftragsbestätigung confirms an accepted Angebot/KV: pass source_offer_number and the draft is prefilled from it. | |
| validity_date | No | YYYY-MM-DD, default offer_date + 30 days | |
| discount_value | No | Decimal as string: the percent ('25') or EUR amount ('100') per discount_type. Must be above 0, a percentage at most 100. | |
| reference_lines | No | Reference lines under the address, one per line | |
| signature_block | No | Auftragsbestätigung only: 'Ort, Datum' and 'Unterschrift Auftraggeber' lines under the closing text so the customer can countersign. Default true; set false only when the user wants no signature lines. Ignored on an Angebot or Kostenvoranschlag. | |
| prices_include_vat | No | Unit prices are gross (default false, net) | |
| source_offer_number | No | Number of the finalized Angebot/KV an Auftragsbestätigung confirms (from get_recent_offers). | |
| discount_description | No | Label printed on the discount line, e.g. 'Rabatt' (default), 'Rabatt Aktionscode START25', 'Treuebonus'. The percentage or amount is printed next to it automatically, so leave it out of the label. |