Austrian invoices and Angebote with every mandatory field under § 11 UStG, written in chat.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Save a new client of the connected facturo account. Only after search_clients found no match. Fill every field you know; ask the user for the address if it is missing (documents need it). A client with the same name (and street) already exists is returned instead of duplicated. For a client that only appears on one invoice, preview_invoice with a client object does this on its own.
Company or person name as printed on documents
EU VAT number, e.g. ATU12345678
Postal code
City
Email the documents go to
Phone number
Street and house number
Two-letter country code (AT, DE, CH, IT ...), default AT
Second address line (contact person, department, c/o)
Mobile number
Payment terms printed for this client, e.g. 'Zahlbar innerhalb von 14 Tagen'
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http facturo https://mcp.facturo.at/mcp
Save a new client of the connected facturo account. Only after search_clients found no match. Fill every field you know; ask the user for the address if it is missing (documents need it). A client with the same name (and street) already exists is returned instead of duplicated. For a client that only appears on one invoice, preview_invoice with a client object does this on its own.
| Argument | Type | Description |
|---|---|---|
| uid | string | EU VAT number, e.g. ATU12345678 |
| zip | string | Postal code |
| city | string | City |
| string | Email the documents go to | |
| phone | string | Phone number |
| street | string | Street and house number |
| country | string | Two-letter country code (AT, DE, CH, IT ...), default AT |
| name_line2 | string | Second address line (contact person, department, c/o) |
| client_name* | string | Company or person name as printed on documents |
| mobile_phone | string | Mobile number |
| payment_terms | string | Payment terms printed for this client, e.g. 'Zahlbar innerhalb von 14 Tagen' |
{
"type": "object",
"required": [
"client_name"
],
"properties": {
"uid": {
"type": "string",
"maxLength": 50,
"description": "EU VAT number, e.g. ATU12345678"
},
"zip": {
"type": "string",
"maxLength": 20,
"description": "Postal code"
},
"city": {
"type": "string",
"maxLength": 100,
"description": "City"
},
"email": {
"type": "string",
"maxLength": 255,
"description": "Email the documents go to"
},
"phone": {
"type": "string",
"maxLength": 50,
"description": "Phone number"
},
"street": {
"type": "string",
"maxLength": 255,
"description": "Street and house number"
},
"country": {
"type": "string",
"description": "Two-letter country code (AT, DE, CH, IT ...), default AT"
},
"name_line2": {
"type": "string",
"maxLength": 255,
"description": "Second address line (contact person, department, c/o)"
},
"client_name": {
"type": "string",
"maxLength": 255,
"description": "Company or person name as printed on documents"
},
"mobile_phone": {
"type": "string",
"maxLength": 50,
"description": "Mobile number"
},
"payment_terms": {
"type": "string",
"maxLength": 255,
"description": "Payment terms printed for this client, e.g. 'Zahlbar innerhalb von 14 Tagen'"
}
}
}Save a new product or service of the connected facturo account, e.g. 'leg das als Produkt an'. name, price and unit are required; ask for what is missing. A product with the same name is returned instead of duplicated; change that one with update_product. The product then shows in list_products and at facturo.at.
| Argument | Type | Description |
|---|---|---|
| name* | string | Name as it goes onto the invoice line, one line, e.g. 'Regiestunde' or 'Fliesen verlegen' |
| unit* | string | Unit the price is for, e.g. 'Std', 'Stk', 'm²', 'pauschal' |
| price* | string | Unit price in EUR as it goes onto the invoice line, e.g. '95', '95.50' or '95,50' |
| vat_rate | string | Optional own VAT rate in percent ('10', '13', '4,9'), only on accounts with per-line VAT rates. Empty string: the product follows the document's rate. |
| description | string | Optional standard specs (dimensions, scope, options). They prefill the item details whenever the product goes onto a line. |
{
"type": "object",
"required": [
"name",
"price",
"unit"
],
"properties": {
"name": {
"type": "string",
"maxLength": 255,
"description": "Name as it goes onto the invoice line, one line, e.g. 'Regiestunde' or 'Fliesen verlegen'"
},
"unit": {
"type": "string",
"maxLength": 50,
"description": "Unit the price is for, e.g. 'Std', 'Stk', 'm²', 'pauschal'"
},
"price": {
"type": "string",
"description": "Unit price in EUR as it goes onto the invoice line, e.g. '95', '95.50' or '95,50'"
},
"vat_rate": {
"type": "string",
"description": "Optional own VAT rate in percent ('10', '13', '4,9'), only on accounts with per-line VAT rates. Empty string: the product follows the document's rate."
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "Optional standard specs (dimensions, scope, options). They prefill the item details whenever the product goes onto a line."
}
}
}Drop a previewed draft (invoice or offer) the user no longer wants, including the Entwurf at facturo.at. Only after the user said so. A draft already turned into a document cannot be discarded; deleting invoices and offers happens in the facturo web app.
| Argument | Type | Description |
|---|---|---|
| draft_id* | string |
{
"type": "object",
"required": [
"draft_id"
],
"properties": {
"draft_id": {
"type": "string"
}
}
}Turn a previewed draft into the real invoice. Only call it after the user has seen the preview and explicitly said yes. Without a facturo account it returns a link to the final PDF (no watermark, the user's own invoice_number from the draft); nothing is stored for the user, they download and keep the PDF. With a connected account it allocates the number to the Entwurf the preview made. review_hash comes from the last preview_invoice result; a stale hash is refused. Fails with the missing fields when something mandatory is missing. Calling it again for the same draft returns the invoice already created. While the account has no invoice yet but this chat holds anonymous ones not imported, it answers import_first instead: call import_invoices, or repeat with skip_import=true if the user declined.
| Argument | Type | Description |
|---|---|---|
| draft_id* | string | |
| review_hash* | string | review_hash of the preview the user confirmed |
| skip_import | boolean | Create the invoice although anonymous invoices from this chat are not imported yet. Only after the user declined the import. |
{
"type": "object",
"required": [
"draft_id",
"review_hash"
],
"properties": {
"draft_id": {
"type": "string"
},
"review_hash": {
"type": "string",
"description": "review_hash of the preview the user confirmed"
},
"skip_import": {
"type": "boolean",
"description": "Create the invoice although anonymous invoices from this chat are not imported yet. Only after the user declined the import."
}
}
}Turn a previewed offer draft into the numbered Angebot, Kostenvoranschlag or Auftragsbestätigung. Only call it after the user has seen the preview and explicitly said yes. review_hash comes from the last preview_offer result; a stale hash is refused. Fails with the missing fields when something mandatory is missing. Calling it again for the same draft returns the document already created.
| Argument | Type | Description |
|---|---|---|
| draft_id* | string | |
| review_hash* | string | review_hash of the preview the user confirmed |
{
"type": "object",
"required": [
"draft_id",
"review_hash"
],
"properties": {
"draft_id": {
"type": "string"
},
"review_hash": {
"type": "string",
"description": "review_hash of the preview the user confirmed"
}
}
}Full details of one client (address, UID, email, phone, payment terms) by client_id. Use it to read the current values before update_client or when the user asks about a client's data.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}Return the company profile of the connected facturo account: name, address, UID, bank details and plan. Needs a connected account. Use it to check what the real invoice will carry as sender before creating one. Also the way to connect: when the user wants to link their facturo account or save invoices in facturo, call it.
No arguments.
{
"type": "object",
"properties": {}
}List the newest invoices of the connected facturo account with status (open, overdue, paid, cancelled with the Storno in cancelled_by, issued for a Storno or Gutschrift), totals, items, VAT mode, PDF links and when they were last emailed. Filter by client, text or status. Use it to answer 'what did I bill Huber' or 'what is still open', and to copy an earlier invoice ('the same as last time'): take items, vat_exemption_type, vat_rate, prices_include_vat and the discount fields from the row. The PDF links are for the user to open.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Default 10 |
| search | string | Matches invoice number, client name, reference lines or an item description |
| status | string | 'open' means not yet due |
| client_id | integer |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Default 10"
},
"search": {
"type": "string",
"description": "Matches invoice number, client name, reference lines or an item description"
},
"status": {
"enum": [
"open",
"overdue",
"paid"
],
"type": "string",
"description": "'open' means not yet due"
},
"client_id": {
"type": "integer"
}
}
}List the newest Angebote, Kostenvoranschläge and Auftragsbestätigungen of the connected facturo account with validity, totals, items, PDF links and when they were last emailed. Filter by client, document type or text. Use it to find the Angebot an Auftragsbestätigung confirms (source_offer_number) or to copy an earlier offer. Each row's status is open, accepted, declined, expired (past its validity) or issued (an Auftragsbestätigung). The PDF links are for the user to open.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Default 10 |
| search | string | Matches offer number, client name, reference lines or an item description |
| client_id | integer | |
| document_type | string |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Default 10"
},
"search": {
"type": "string",
"description": "Matches offer number, client name, reference lines or an item description"
},
"client_id": {
"type": "integer"
},
"document_type": {
"enum": [
"angebot",
"kostenvoranschlag",
"auftragsbestaetigung"
],
"type": "string"
}
}
}Store the invoices this chat created without an account (the PDFs from finalize_invoice) in the connected facturo account. They keep the user's own invoice numbers and facturo's numbering continues after the highest one. Only call it after the user said yes to the offer, ideally before the first invoice is created in the account so the sequence stays in order. An invoice already in the account is never stored twice.
| Argument | Type | Description |
|---|---|---|
| invoice_numbers | array | Only these numbers (from importable_invoices); default: all of them |
{
"type": "object",
"properties": {
"invoice_numbers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Only these numbers (from importable_invoices); default: all of them"
}
}
}List the saved products and services of the connected facturo account with their unit prices. Use the names and prices for items when the user refers to something they usually bill.
No arguments.
{
"type": "object",
"properties": {}
}Render an Austrian invoice as a watermarked preview. Works without a facturo account; with a connected account the preview is an Entwurf the user also sees at facturo.at, nothing is numbered or sent. The user sees the preview as a card in the chat after each call. A new draft needs client.name (or client_id with a connected account) and at least one item; later calls pass draft_id plus only the fields that change. Returns the draft_id, the totals, the review_hash that finalize_invoice needs, and 'missing': what the real invoice still needs. It works with only a client name and one position.
| Argument | Type | Description |
|---|---|---|
| items | array | |
| client | object | The invoice recipient. The name is required for the first preview of a draft; the real invoice needs the address. |
| issuer | object | The sender (the user's own business). Everything is optional for a preview; missing mandatory fields render as placeholders and are listed under 'missing'. With a connected account the profile there wins; only an account without a company profile yet takes these fields. |
| draft_id | string | Id of a draft from an earlier preview_invoice result. Pass it to change that draft instead of starting a new one: client and issuer merge field by field, every other field given replaces the old value, items replace the whole list. |
| due_date | string | YYYY-MM-DD; default invoice_date + payment_days |
Preview 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.
| Argument | Type | Description |
|---|---|---|
| items | array | |
| client | object | The invoice recipient. The name is required for the first preview of a draft; the real invoice needs the address. |
| draft_id | string | Handle from an earlier preview_offer result; pass it to change that draft instead of starting a new one. |
| fusstext | string | Text below the totals; defaults to the account's standard text |
| kopftext | string | Text above the items; defaults to the account's standard text |
| vat_rate | number | Percent for tax_exempt 'show', default 20 |
| client_id | integer | A client of the connected account (from search_clients) instead of client. |
Find clients of the connected facturo account by name (typos and partial names are fine) or city; an empty query lists everyone. Call it before previewing for a client that may already exist and pass the client_id to preview_invoice. 'match' is 'exact', 'candidates' (one candidate: use it and name it; several: ask the user which one), 'none' (a new client) or 'all'.
| Argument | Type | Description |
|---|---|---|
| query | string | Name, part of a name, or city |
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Name, part of a name, or city"
}
}
}Record the customer's answer on an Angebot or Kostenvoranschlag of the connected facturo account: accepted, declined, or open again when it was set by mistake. Same switch as at facturo.at; nothing is sent to the client and the document stays unchanged. It takes the offer_number from get_recent_offers, and the change can be undone the same way. Creating an invoice or an Auftragsbestätigung from an offer marks it accepted by itself; an Auftragsbestätigung has no status.
| Argument | Type | Description |
|---|---|---|
| status* | string | |
| offer_number* | string | From get_recent_offers or a finalize result, e.g. AN-2026-0012 |
{
"type": "object",
"required": [
"offer_number",
"status"
],
"properties": {
"status": {
"enum": [
"accepted",
"declined",
"open"
],
"type": "string"
},
"offer_number": {
"type": "string",
"description": "From get_recent_offers or a finalize result, e.g. AN-2026-0012"
}
}
}Change fields of a client of the connected facturo account. Pass ONLY the fields the user asked to change; omitted fields stay untouched, an empty string clears a field (not client_name or country). Read the change back to the user (old and new value) and wait for their OK first. A new UID is checked against VIES before it is saved. Documents already created keep the client data they were created with.
| Argument | Type | Description |
|---|---|---|
| uid | string | EU VAT number, e.g. ATU12345678 |
| zip | string | Postal code |
| city | string | City |
| string | Email the documents go to | |
| phone | string | Phone number |
| street | string | Street and house number |
| country | string | Two-letter country code (AT, DE, CH, IT ...), default AT |
| client_id* | integer | |
| name_line2 | string | Second address line (contact person, department, c/o) |
Change a saved product of the connected facturo account by its product_id from list_products, e.g. 'der Stundensatz ist jetzt 95 Euro'. Pass ONLY the fields the user asked to change; omitted fields stay, an empty string clears description or vat_rate. Read the change back to the user (old and new value) and wait for their OK first. Documents already created keep their prices; items you add from now on take the new values.
| Argument | Type | Description |
|---|---|---|
| name | string | Name as it goes onto the invoice line, one line, e.g. 'Regiestunde' or 'Fliesen verlegen' |
| unit | string | Unit the price is for, e.g. 'Std', 'Stk', 'm²', 'pauschal' |
| price | string | Unit price in EUR as it goes onto the invoice line, e.g. '95', '95.50' or '95,50' |
| vat_rate | string | Optional own VAT rate in percent ('10', '13', '4,9'), only on accounts with per-line VAT rates. Empty string: the product follows the document's rate. |
| product_id* | integer | |
| description | string | Optional standard specs (dimensions, scope, options). They prefill the item details whenever the product goes onto a line. |
{
"type": "object",
"required": [
"product_id"
],
"properties": {
"name": {
"type": "string",
"maxLength": 255,
"description": "Name as it goes onto the invoice line, one line, e.g. 'Regiestunde' or 'Fliesen verlegen'"
},
"unit": {
"type": "string",
"maxLength": 50,
"description": "Unit the price is for, e.g. 'Std', 'Stk', 'm²', 'pauschal'"
},
"price": {
"type": "string",
"description": "Unit price in EUR as it goes onto the invoice line, e.g. '95', '95.50' or '95,50'"
},
"vat_rate": {
"type": "string",
"description": "Optional own VAT rate in percent ('10', '13', '4,9'), only on accounts with per-line VAT rates. Empty string: the product follows the document's rate."
},
"product_id": {
"type": "integer"
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "Optional standard specs (dimensions, scope, options). They prefill the item details whenever the product goes onto a line."
}
}
}Change the company profile of the connected facturo account PERMANENTLY: sender address, UID, Firmenbuch data, default Zahlungsziel, document defaults (Kleinunternehmer, Honorarnote, EPC QR code), standard texts and the numbering start. Only for 'from now on' wishes; a one-off text or VAT mode for a single document goes into preview_invoice/preview_offer instead. Pass ONLY the fields the user asked to change; omitted fields stay, an empty string clears a text. Read the change back and wait for the user's OK first. Bank data and the logo are changed at facturo.at.
| Argument | Type | Description |
|---|---|---|
| uid | string | Own UID (ATU...), needed for reverse charge and EU documents; checked against VIES |
| zip | string | Postal code |
| city | string | City |
| dgnr | string | Dienstgebernummer |
| string | Contact email printed on documents | |
| phone | string | Contact phone printed on documents |
| street | string | Street and house number |
| fusstext | string | Standard text below the totals on invoices |
Check an EU VAT number (UID) against VIES, the EU register. Returns the status and, where the member state publishes it, the registered name and address. Use it when the user gives a UID or asks whether one is valid. Read-only; update_client and update_profile run the same check before saving.
| Argument | Type | Description |
|---|---|---|
| uid* | string | e.g. ATU12345678 or DE123456789 |
{
"type": "object",
"required": [
"uid"
],
"properties": {
"uid": {
"type": "string",
"description": "e.g. ATU12345678 or DE123456789"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 16, 2026.
| fusstext |
| string |
| Text below the totals; default: the account's standard text. A 'bereits bezahlt' remark goes here as 'Der Rechnungsbetrag wurde bereits bezahlt.' |
| kopftext | string | Text above the items; default: the account's standard text |
| vat_rate | number | VAT rate in percent (10 and 13 are the reduced Austrian rates). Omit to inherit: the client's last invoice's rate, else 20. |
| client_id | integer | Id of an existing client of the connected facturo account (from search_clients). Use it instead of 'client' whenever the client exists; needs a connected account. |
| invoice_date | string | YYYY-MM-DD, default today |
| invoice_type | string | 'honorarnote' for freelancers/Freiberufler who bill a Honorar; default 'normal' |
| payment_days | integer | Zahlungsziel in days, default 14; ignored when due_date is given |
| discount_type | string | 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. |
| discount_value | string | Decimal as string: the percent ('25') or EUR amount ('100') per discount_type. Must be above 0, a percentage at most 100. |
| invoice_number | string | Only without a connected account: the user's own invoice number, the next one in their sequence (e.g. '2026-014'). Ask the user for it, never invent one. A connected account numbers automatically. |
| reference_lines | string | Extra reference lines in the header, e.g. 'Projekt: Dach Huber' |
| prices_include_vat | boolean | Unit prices are gross (Brutto) amounts. Omit to inherit from the client's last invoice, else false. |
| service_period_end | string | YYYY-MM-DD, Leistungszeitraum end |
| vat_exemption_type | string | Omit unless the user named one: a connected preview then picks the account's treatment (Kleinunternehmer setting, the client's last invoice, the account's usual mode, else 20%) and reports it. '' forces regular VAT. 'small_business' = Kleinunternehmer (no VAT, §6 Abs 1 Z 27 UStG), 'construction' = Reverse Charge Bauleistungen (§19 Abs 1a), 'eu_service' / 'eu_goods' = innergemeinschaftlich, 'healthcare' = §6 Abs 1 Z 19. |
| discount_description | string | 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. |
| service_period_start | string | YYYY-MM-DD, Leistungszeitraum start; default invoice_date |
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"description",
"quantity",
"unit_price"
],
"properties": {
"unit": {
"type": "string",
"maxLength": 50,
"description": "e.g. 'Std', 'Stk', 'm2'; may be empty"
},
"quantity": {
"type": "string",
"description": "Decimal as string, e.g. '2' or '1.5'"
},
"vat_rate": {
"type": "number",
"description": "VAT rate in percent for THIS line, only on accounts with per-line rates (the tool says so if the account has none). Omit it for the document's vat_rate. A saved product with its own vat_rate gives its line that rate."
},
"product_id": {
"type": "integer",
"description": "Optional saved product id"
},
"unit_price": {
"type": "string",
"description": "Net unit price as decimal string"
},
"description": {
"type": "string",
"maxLength": 500,
"description": "Short single-line name of the item, e.g. 'Innenputz' or 'Regiestunden'. Renders as one line on the PDF - newlines are rejected; details go into ephemeral_description."
},
"ephemeral_description": {
"type": "string",
"maxLength": 2000,
"description": "Optional per-item details, printed small below the item name. Multi-line allowed. For hour/date breakdowns, material lists, work-scope detail, vehicle/object identifiers - anything specific to this line on this invoice. Detail for this one line only - never pack a whole position list into a single item's details. For a flat total with positions listed just for reference, create one item per position with unit_price '0' plus one priced Pauschale line."
}
}
},
"maxItems": 100,
"minItems": 1
},
"client": {
"type": "object",
"properties": {
"uid": {
"type": "string",
"maxLength": 50,
"description": "Client's VAT id (UID), e.g. ATU12345678"
},
"zip": {
"type": "string",
"maxLength": 20
},
"city": {
"type": "string",
"maxLength": 100
},
"name": {
"type": "string",
"maxLength": 255,
"description": "Company or person the invoice is addressed to"
},
"email": {
"type": "string",
"maxLength": 255
},
"street": {
"type": "string",
"maxLength": 255
},
"country": {
"type": "string",
"maxLength": 50,
"description": "ISO 3166-1 alpha-2, default AT"
},
"name_line2": {
"type": "string",
"maxLength": 255,
"description": "Second address line, e.g. contact person or department"
}
},
"description": "The invoice recipient. The name is required for the first preview of a draft; the real invoice needs the address."
},
"issuer": {
"type": "object",
"properties": {
"bic": {
"type": "string",
"maxLength": 20
},
"uid": {
"type": "string",
"maxLength": 50,
"description": "Own VAT id (UID)"
},
"zip": {
"type": "string",
"maxLength": 20
},
"city": {
"type": "string",
"maxLength": 100
},
"iban": {
"type": "string",
"maxLength": 50
},
"email": {
"type": "string",
"maxLength": 254
},
"phone": {
"type": "string",
"maxLength": 50
},
"street": {
"type": "string",
"maxLength": 255
},
"company_name": {
"type": "string",
"maxLength": 255
},
"bank_account_holder": {
"type": "string",
"maxLength": 70
}
},
"description": "The sender (the user's own business). Everything is optional for a preview; missing mandatory fields render as placeholders and are listed under 'missing'. With a connected account the profile there wins; only an account without a company profile yet takes these fields."
},
"draft_id": {
"type": "string",
"description": "Id of a draft from an earlier preview_invoice result. Pass it to change that draft instead of starting a new one: client and issuer merge field by field, every other field given replaces the old value, items replace the whole list."
},
"due_date": {
"type": "string",
"description": "YYYY-MM-DD; default invoice_date + payment_days"
},
"fusstext": {
"type": "string",
"maxLength": 5000,
"description": "Text below the totals; default: the account's standard text. A 'bereits bezahlt' remark goes here as 'Der Rechnungsbetrag wurde bereits bezahlt.'"
},
"kopftext": {
"type": "string",
"maxLength": 5000,
"description": "Text above the items; default: the account's standard text"
},
"vat_rate": {
"type": "number",
"description": "VAT rate in percent (10 and 13 are the reduced Austrian rates). Omit to inherit: the client's last invoice's rate, else 20."
},
"client_id": {
"type": "integer",
"description": "Id of an existing client of the connected facturo account (from search_clients). Use it instead of 'client' whenever the client exists; needs a connected account."
},
"invoice_date": {
"type": "string",
"description": "YYYY-MM-DD, default today"
},
"invoice_type": {
"enum": [
"normal",
"honorarnote"
],
"type": "string",
"description": "'honorarnote' for freelancers/Freiberufler who bill a Honorar; default 'normal'"
},
"payment_days": {
"type": "integer",
"description": "Zahlungsziel in days, default 14; ignored when due_date is given"
},
"discount_type": {
"enum": [
"none",
"percentage",
"fixed"
],
"type": "string",
"description": "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."
},
"discount_value": {
"type": "string",
"description": "Decimal as string: the percent ('25') or EUR amount ('100') per discount_type. Must be above 0, a percentage at most 100."
},
"invoice_number": {
"type": "string",
"maxLength": 50,
"description": "Only without a connected account: the user's own invoice number, the next one in their sequence (e.g. '2026-014'). Ask the user for it, never invent one. A connected account numbers automatically."
},
"reference_lines": {
"type": "string",
"maxLength": 500,
"description": "Extra reference lines in the header, e.g. 'Projekt: Dach Huber'"
},
"prices_include_vat": {
"type": "boolean",
"description": "Unit prices are gross (Brutto) amounts. Omit to inherit from the client's last invoice, else false."
},
"service_period_end": {
"type": "string",
"description": "YYYY-MM-DD, Leistungszeitraum end"
},
"vat_exemption_type": {
"enum": [
"",
"small_business",
"construction",
"eu_service",
"eu_goods",
"healthcare"
],
"type": "string",
"description": "Omit unless the user named one: a connected preview then picks the account's treatment (Kleinunternehmer setting, the client's last invoice, the account's usual mode, else 20%) and reports it. '' forces regular VAT. 'small_business' = Kleinunternehmer (no VAT, §6 Abs 1 Z 27 UStG), 'construction' = Reverse Charge Bauleistungen (§19 Abs 1a), 'eu_service' / 'eu_goods' = innergemeinschaftlich, 'healthcare' = §6 Abs 1 Z 19."
},
"discount_description": {
"type": "string",
"maxLength": 255,
"description": "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."
},
"service_period_start": {
"type": "string",
"description": "YYYY-MM-DD, Leistungszeitraum start; default invoice_date"
}
}
}| offer_date | string | YYYY-MM-DD, default today |
| tax_exempt | string | '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 | string | 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 | string | '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 | string | YYYY-MM-DD, default offer_date + 30 days |
| discount_value | string | Decimal as string: the percent ('25') or EUR amount ('100') per discount_type. Must be above 0, a percentage at most 100. |
| reference_lines | string | Reference lines under the address, one per line |
| signature_block | boolean | 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 | boolean | Unit prices are gross (default false, net) |
| source_offer_number | string | Number of the finalized Angebot/KV an Auftragsbestätigung confirms (from get_recent_offers). |
| discount_description | string | 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. |
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"description",
"quantity",
"unit_price"
],
"properties": {
"unit": {
"type": "string",
"maxLength": 50,
"description": "e.g. 'Std', 'Stk', 'm2'; may be empty"
},
"quantity": {
"type": "string",
"description": "Decimal as string, e.g. '2' or '1.5'"
},
"vat_rate": {
"type": "number",
"description": "VAT rate in percent for THIS line, only on accounts with per-line rates (the tool says so if the account has none). Omit it for the document's vat_rate. A saved product with its own vat_rate gives its line that rate."
},
"product_id": {
"type": "integer",
"description": "Optional saved product id"
},
"unit_price": {
"type": "string",
"description": "Net unit price as decimal string"
},
"description": {
"type": "string",
"maxLength": 500,
"description": "Short single-line name of the item, e.g. 'Innenputz' or 'Regiestunden'. Renders as one line on the PDF - newlines are rejected; details go into ephemeral_description."
},
"ephemeral_description": {
"type": "string",
"maxLength": 2000,
"description": "Optional per-item details, printed small below the item name. Multi-line allowed. For hour/date breakdowns, material lists, work-scope detail, vehicle/object identifiers - anything specific to this line on this invoice. Detail for this one line only - never pack a whole position list into a single item's details. For a flat total with positions listed just for reference, create one item per position with unit_price '0' plus one priced Pauschale line."
}
}
},
"maxItems": 100,
"minItems": 1
},
"client": {
"type": "object",
"properties": {
"uid": {
"type": "string",
"maxLength": 50,
"description": "Client's VAT id (UID), e.g. ATU12345678"
},
"zip": {
"type": "string",
"maxLength": 20
},
"city": {
"type": "string",
"maxLength": 100
},
"name": {
"type": "string",
"maxLength": 255,
"description": "Company or person the invoice is addressed to"
},
"email": {
"type": "string",
"maxLength": 255
},
"street": {
"type": "string",
"maxLength": 255
},
"country": {
"type": "string",
"maxLength": 50,
"description": "ISO 3166-1 alpha-2, default AT"
},
"name_line2": {
"type": "string",
"maxLength": 255,
"description": "Second address line, e.g. contact person or department"
}
},
"description": "The invoice recipient. The name is required for the first preview of a draft; the real invoice needs the address."
},
"draft_id": {
"type": "string",
"description": "Handle from an earlier preview_offer result; pass it to change that draft instead of starting a new one."
},
"fusstext": {
"type": "string",
"maxLength": 5000,
"description": "Text below the totals; defaults to the account's standard text"
},
"kopftext": {
"type": "string",
"maxLength": 5000,
"description": "Text above the items; defaults to the account's standard text"
},
"vat_rate": {
"type": "number",
"description": "Percent for tax_exempt 'show', default 20"
},
"client_id": {
"type": "integer",
"description": "A client of the connected account (from search_clients) instead of client."
},
"offer_date": {
"type": "string",
"description": "YYYY-MM-DD, default today"
},
"tax_exempt": {
"enum": [
"show",
"exempt"
],
"type": "string",
"description": "'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": {
"enum": [
"none",
"percentage",
"fixed"
],
"type": "string",
"description": "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": {
"enum": [
"angebot",
"kostenvoranschlag",
"auftragsbestaetigung"
],
"type": "string",
"description": "'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": {
"type": "string",
"description": "YYYY-MM-DD, default offer_date + 30 days"
},
"discount_value": {
"type": "string",
"description": "Decimal as string: the percent ('25') or EUR amount ('100') per discount_type. Must be above 0, a percentage at most 100."
},
"reference_lines": {
"type": "string",
"maxLength": 500,
"description": "Reference lines under the address, one per line"
},
"signature_block": {
"type": "boolean",
"description": "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": {
"type": "boolean",
"description": "Unit prices are gross (default false, net)"
},
"source_offer_number": {
"type": "string",
"description": "Number of the finalized Angebot/KV an Auftragsbestätigung confirms (from get_recent_offers)."
},
"discount_description": {
"type": "string",
"maxLength": 255,
"description": "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."
}
}
}| client_name | string | Company or person name as printed on documents |
| mobile_phone | string | Mobile number |
| payment_terms | string | Payment terms printed for this client, e.g. 'Zahlbar innerhalb von 14 Tagen' |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"uid": {
"type": "string",
"maxLength": 50,
"description": "EU VAT number, e.g. ATU12345678"
},
"zip": {
"type": "string",
"maxLength": 20,
"description": "Postal code"
},
"city": {
"type": "string",
"maxLength": 100,
"description": "City"
},
"email": {
"type": "string",
"maxLength": 255,
"description": "Email the documents go to"
},
"phone": {
"type": "string",
"maxLength": 50,
"description": "Phone number"
},
"street": {
"type": "string",
"maxLength": 255,
"description": "Street and house number"
},
"country": {
"type": "string",
"description": "Two-letter country code (AT, DE, CH, IT ...), default AT"
},
"client_id": {
"type": "integer"
},
"name_line2": {
"type": "string",
"maxLength": 255,
"description": "Second address line (contact person, department, c/o)"
},
"client_name": {
"type": "string",
"maxLength": 255,
"description": "Company or person name as printed on documents"
},
"mobile_phone": {
"type": "string",
"maxLength": 50,
"description": "Mobile number"
},
"payment_terms": {
"type": "string",
"maxLength": 255,
"description": "Payment terms printed for this client, e.g. 'Zahlbar innerhalb von 14 Tagen'"
}
}
}| kopftext | string | Standard text above the items on invoices |
| kv_fusstext | string | Standard text below the totals on Kostenvoranschläge |
| kv_kopftext | string | Standard text above the items on Kostenvoranschläge |
| company_name | string | Company name as printed on documents |
| offer_fusstext | string | Standard text below the totals on Angebote |
| offer_kopftext | string | Standard text above the items on Angebote |
| firmenbuchnummer | string | Firmenbuch number (FN ...) |
| show_epc_qr_code | boolean | Print the EPC payment QR code on invoices. Part of the paid plans, switching it on fails on a free plan. |
| firmenbuchgericht | string | Firmenbuch court |
| next_offer_number | integer | The number the next Angebot/KV/AB gets this year. Can only move up past the numbers already issued this year. |
| next_invoice_number | integer | The number the next invoice gets this year. Can only move up past the numbers already issued this year. |
| prefers_honorarnote | boolean | New invoices are Honorarnoten by default (freelancers, doctors) |
| default_payment_days | integer | Default Zahlungsziel in days for new invoices |
| email_default_text_offer | string | Default email body when sending Angebote |
| email_default_text_invoice | string | Default email body when sending invoices |
| kleinunternehmer_default_enabled | boolean | Kleinunternehmer: new documents show no USt by default (§ 6 Abs 1 Z 27 UStG) |
{
"type": "object",
"properties": {
"uid": {
"type": "string",
"description": "Own UID (ATU...), needed for reverse charge and EU documents; checked against VIES"
},
"zip": {
"type": "string",
"description": "Postal code"
},
"city": {
"type": "string",
"description": "City"
},
"dgnr": {
"type": "string",
"description": "Dienstgebernummer"
},
"email": {
"type": "string",
"description": "Contact email printed on documents"
},
"phone": {
"type": "string",
"description": "Contact phone printed on documents"
},
"street": {
"type": "string",
"description": "Street and house number"
},
"fusstext": {
"type": "string",
"description": "Standard text below the totals on invoices"
},
"kopftext": {
"type": "string",
"description": "Standard text above the items on invoices"
},
"kv_fusstext": {
"type": "string",
"description": "Standard text below the totals on Kostenvoranschläge"
},
"kv_kopftext": {
"type": "string",
"description": "Standard text above the items on Kostenvoranschläge"
},
"company_name": {
"type": "string",
"description": "Company name as printed on documents"
},
"offer_fusstext": {
"type": "string",
"description": "Standard text below the totals on Angebote"
},
"offer_kopftext": {
"type": "string",
"description": "Standard text above the items on Angebote"
},
"firmenbuchnummer": {
"type": "string",
"description": "Firmenbuch number (FN ...)"
},
"show_epc_qr_code": {
"type": "boolean",
"description": "Print the EPC payment QR code on invoices. Part of the paid plans, switching it on fails on a free plan."
},
"firmenbuchgericht": {
"type": "string",
"description": "Firmenbuch court"
},
"next_offer_number": {
"type": "integer",
"description": "The number the next Angebot/KV/AB gets this year. Can only move up past the numbers already issued this year."
},
"next_invoice_number": {
"type": "integer",
"description": "The number the next invoice gets this year. Can only move up past the numbers already issued this year."
},
"prefers_honorarnote": {
"type": "boolean",
"description": "New invoices are Honorarnoten by default (freelancers, doctors)"
},
"default_payment_days": {
"type": "integer",
"description": "Default Zahlungsziel in days for new invoices"
},
"email_default_text_offer": {
"type": "string",
"description": "Default email body when sending Angebote"
},
"email_default_text_invoice": {
"type": "string",
"description": "Default email body when sending invoices"
},
"kleinunternehmer_default_enabled": {
"type": "boolean",
"description": "Kleinunternehmer: new documents show no USt by default (§ 6 Abs 1 Z 27 UStG)"
}
}
}