> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to sevDesk

The sevDesk connector lets your AI agent act in each user's sevDesk account. Each user connects their own sevDesk API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

**Authentication:** API Key
**Categories:** Accounting & Finance
**Tools:** 60: 26 read, 28 write, 6 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=SEVDESK)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the sevDesk connection

   In **AgentKit > Connections**, create a sevDesk connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'sevdesk'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize sevDesk:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'sevdesk_check_account_transactions_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "sevdesk"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize sevDesk:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="sevdesk_check_account_transactions_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their sevDesk credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'sevdesk_check_account_balance_get',
  toolInput: {
    check_account_id: 5001,
    date: '<date>',
  },
  connector: 'sevdesk',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="sevdesk_check_account_balance_get",
    tool_input={
        "check_account_id": 5001,
        "date": "<date>",
    },
    connection_name="sevdesk",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `sevdesk_check_account_balance_get`

Get Check Account Balance · Read-only

Get a check account's balance at a date, summing all transactions up to the end of that day.
Returns objects with the balance.
Use sevdesk_check_account_balance_get to reconcile an account.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `check_account_id` (`integer`, required): ID of check account. Example: 5001.
- `date` (`string`, required): Date to compute the balance for, as YYYY-MM-DD; transactions up to 23:59:59 that day count. Example: 2026-12-31.

Example input: `{"check_account_id":5001,"date":"<date>"}`

### `sevdesk_check_account_transactions_list`

List Check Account Transactions · Read-only

List bank and cash transactions, filtered by check account, booking state, purpose, date range, payee or direction.
Returns objects[] of transactions with id, valueDate, amount, paymtPurpose, payeePayerName and status.
Use sevdesk_check_account_transactions_list to find a transaction to link when booking an invoice or voucher.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `check_account_id` (`integer`, optional): Only transactions on this check account ID. Example: 5001.
- `count_all` (`boolean`, optional): Set to true to include the total number of matching records in the response. Example: true.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
- `end_date` (`string`, optional): Only retrieve transactions up to this date. Example: 2026-12-31.
- `is_booked` (`boolean`, optional): Only retrieve booked transactions. Example: false.
- `limit` (`integer`, optional): Maximum number of entries to return, 1 to 1000. Example: 100.
- `offset` (`integer`, optional): Number of entries to skip before returning results, for paging. Example: 0.
- `only_credit` (`boolean`, optional): Only retrieve credit transactions. Example: true.
- `only_debit` (`boolean`, optional): Only retrieve debit transactions. Example: false.
- `payee_payer_name` (`string`, optional): Only retrieve transactions with this payee / payer. Example: Acme GmbH.
- `paymt_purpose` (`string`, optional): Only retrieve transactions with this payment purpose. Example: RE-1001.
- `start_date` (`string`, optional): Only retrieve transactions from this date on. Example: 2026-12-01.

Example input: `{}`

### `sevdesk_check_accounts_list`

List Check Accounts · Read-only

List check accounts (bank accounts, cash registers and clearing accounts).
Returns objects[] with id, name, type, iban, currency and status.
Use sevdesk_check_accounts_list to find the check account ID needed for bookings and transactions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `count_all` (`boolean`, optional): Set to true to include the total number of matching records in the response. Example: true.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
- `limit` (`integer`, optional): Maximum number of entries to return, 1 to 1000. Example: 100.
- `offset` (`integer`, optional): Number of entries to skip before returning results, for paging. Example: 0.

Example input: `{}`

### `sevdesk_communication_way_keys_list`

List Communication Way Keys · Read-only

List the labels a communication way can have, such as Private, Work, Fax, Mobile or Office.
Returns objects[] with id and name.
Use it to get the key ID for sevdesk_communication_way_create.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `sevdesk_communication_ways_list`

List Communication Ways · Read-only

List email addresses, phone numbers and websites of contacts, optionally for one contact or type.
Returns objects[] with id, contact, type, value, key and main.
Use sevdesk_communication_ways_list to read a contact's email or phone.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, optional): Only return records for this contact ID. Example: 12345.
- `count_all` (`boolean`, optional): Set to true to include the total number of matching records in the response. Example: true.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
- `limit` (`integer`, optional): Maximum number of entries to return, 1 to 1000. Example: 100.
- `main` (`string`, optional): Define if you only want the main communication way. Example: 0. One of: `0`, `1`.
- `offset` (`integer`, optional): Number of entries to skip before returning results, for paging. Example: 0.
- `type` (`string`, optional): Type of the communication ways you want to get. Example: PHONE. One of: `PHONE`, `EMAIL`, `WEB`, `MOBILE`.

Example input: `{}`

### `sevdesk_contact_addresses_list`

List Contact Addresses · Read-only

List all contact addresses.
Returns objects[] of addresses with id, contact, street, zip, city, country and category.
Use sevdesk_contact_addresses_list to find an address ID for sevdesk_contact_address_update or sevdesk_contact_address_delete.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `count_all` (`boolean`, optional): Set to true to include the total number of matching records in the response. Example: true.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
- `limit` (`integer`, optional): Maximum number of entries to return, 1 to 1000. Example: 100.
- `offset` (`integer`, optional): Number of entries to skip before returning results, for paging. Example: 0.

Example input: `{}`

### `sevdesk_contact_get`

Get Contact · Read-only

Get one contact by ID.
Returns objects[] with the contact's name, customerNumber, category, status, tax and bank details.
Use sevdesk_contact_get when you have the ID. Use sevdesk_contacts_list to find it.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, required): ID of contact to return. Example: 12345.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.

Example input: `{"contact_id":12345}`

### `sevdesk_contact_next_customer_number_get`

Get Next Customer Number · Read-only

Get the next free customer number.
Returns objects with the customer number string.
Use before sevdesk_contact_create to give a new contact a unique customer number.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `sevdesk_contacts_find_by_custom_field`

Find Contacts by Custom Field · Read-only

Find contacts whose custom field has a given value.
Returns objects[] of matching contacts.
Use sevdesk_contacts_find_by_custom_field to look a contact up by a value you store in a custom field, such as an external ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `custom_field_name` (`string`, required): Name of the contact custom field (ContactCustomFieldSetting) to check. Example: External ID.
- `value` (`string`, required): Custom field value to match. Example: CRM-4711.

Example input: `{"custom_field_name":"<custom_field_name>","value":"<value>"}`

### `sevdesk_contacts_list`

List Contacts · Read-only

List contacts (organizations and persons), optionally filtered by customer number.
Returns objects[] of contacts with id, name or surename/familyname, customerNumber, category and status.
Use sevdesk_contacts_list to browse or page. Use sevdesk_contact_get for one contact by ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `count_all` (`boolean`, optional): Set to true to include the total number of matching records in the response. Example: true.
- `customer_number` (`string`, optional): Retrieve all contacts with this customer number. Example: 1001.
- `depth` (`string`, optional): Which contacts to return: 0 for organizations only (default), 1 for organizations and persons. Example: 1. One of: `0`, `1`.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
- `limit` (`integer`, optional): Maximum number of entries to return, 1 to 1000. Example: 100.
- `offset` (`integer`, optional): Number of entries to skip before returning results, for paging. Example: 0.

Example input: `{}`

### `sevdesk_credit_note_get`

Get Credit Note · Read-only

Get one credit note by ID.
Returns objects[] with the credit note header, contact, dates, status and sums.
Use sevdesk_credit_note_get when you have the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `credit_note_id` (`integer`, required): ID of creditNote to return. Example: 300001.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.

Example input: `{"credit_note_id":300001}`

### `sevdesk_credit_notes_list`

List Credit Notes · Read-only

List credit notes, filtered by status, number, date range or contact.
Returns objects[] of credit notes with id, creditNoteNumber, contact, creditNoteDate, status and sums.
Use sevdesk_credit_notes_list to browse. Use sevdesk_credit_note_get for one credit note.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, optional): Only return records for this contact ID. Example: 12345.
- `count_all` (`boolean`, optional): Set to true to include the total number of matching records in the response. Example: true.
- `credit_note_number` (`string`, optional): Retrieve all CreditNotes with this creditNote number. Example: GU-1001.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
- `end_date` (`integer`, optional): Only records dated on or before this Unix timestamp (seconds). Example: 1767225599.
- `limit` (`integer`, optional): Maximum number of entries to return, 1 to 1000. Example: 100.
- `offset` (`integer`, optional): Number of entries to skip before returning results, for paging. Example: 0.
- `start_date` (`integer`, optional): Only records dated on or after this Unix timestamp (seconds). Example: 1735689600.
- `status` (`string`, optional): Credit note status: 100 draft, 200 open, 300 rejected, 500 accepted, 750 partially paid, 1000 paid. Example: 100. One of: `100`, `200`, `300`, `500`, `750`, `1000`.

Example input: `{}`

### `sevdesk_invoice_get`

Get Invoice · Read-only

Get one invoice by ID.
Returns objects[] with the invoice header, contact, dates, status, tax settings and sums.
Use sevdesk_invoice_get for invoice details. Use sevdesk_invoice_positions_get for its line items.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`integer`, required): ID of invoice to return. Example: 100001.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.

Example input: `{"invoice_id":100001}`

### `sevdesk_invoice_partially_paid_check`

Check Invoice Partially Paid · Read-only

Check whether an invoice is partially paid.
Returns objects true or false; a fully paid invoice returns false.
Use sevdesk_invoice_partially_paid_check before booking the remaining amount.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`integer`, required): ID of invoice to return. Example: 100001.

Example input: `{"invoice_id":100001}`

### `sevdesk_invoice_pdf_get`

Get Invoice PDF · Read-only

Get an invoice's PDF as base64 content with its filename and MIME type.
Returns objects with filename, mimeType, content and base64Encoded.
Use sevdesk_invoice_pdf_get to retrieve the document file.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`integer`, required): ID of invoice from which you want the pdf. Example: 100001.
- `download` (`boolean`, optional): Set to true to get the PDF content. Example: true.
- `prevent_send_by` (`boolean`, optional): Set to true so fetching the PDF does not mark the invoice as sent. Example: true.

Example input: `{"invoice_id":100001}`

### `sevdesk_invoice_positions_get`

Get Invoice Positions · Read-only

List the line items of an invoice.
Returns objects[] of positions with name, quantity, price, unity, taxRate and sums.
Use sevdesk_invoice_positions_get after sevdesk_invoice_get to see what was billed.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`integer`, required): ID of invoice to return the positions. Example: 100001.
- `embed` (`array`, optional): Comma-separated nested resources to expand, for example part. Example: part.
- `limit` (`integer`, optional): limits the number of entries returned. Example: 100.
- `offset` (`integer`, optional): set the index where the returned entries start. Example: 0.

Example input: `{"invoice_id":100001}`

### `sevdesk_invoices_list`

List Invoices · Read-only

List invoices, filtered by status, number, date range or contact.
Returns objects[] of invoices with id, invoiceNumber, contact, invoiceDate, status, sumNet, sumGross and currency.
Use sevdesk_invoices_list to browse or search. Use sevdesk_invoice_get for one invoice.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, optional): Only return records for this contact ID. Example: 12345.
- `count_all` (`boolean`, optional): Set to true to include the total number of matching records in the response. Example: true.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
- `end_date` (`integer`, optional): Only records dated on or before this Unix timestamp (seconds). Example: 1767225599.
- `invoice_number` (`string`, optional): Retrieve all invoices with this invoice number. Example: RE-1001.
- `limit` (`integer`, optional): Maximum number of entries to return, 1 to 1000. Example: 100.
- `offset` (`integer`, optional): Number of entries to skip before returning results, for paging. Example: 0.
- `start_date` (`integer`, optional): Only records dated on or after this Unix timestamp (seconds). Example: 1735689600.
- `status` (`number`, optional): Invoice status: 50 deactivated recurring, 100 draft, 200 open or due, 1000 paid. Example: 200. One of: `100`, `200`, `1000`.

Example input: `{}`

### `sevdesk_order_get`

Get Order · Read-only

Get one order by ID.
Returns objects[] with the order header, type, contact, dates, status and sums.
Use sevdesk_order_get for order details. Use sevdesk_order_positions_get for its line items.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_id` (`integer`, required): ID of order to return. Example: 200001.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.

Example input: `{"order_id":200001}`

### `sevdesk_order_positions_get`

Get Order Positions · Read-only

List the line items of an order.
Returns objects[] of positions with name, quantity, price, unity, taxRate and sums.
Use sevdesk_order_positions_get after sevdesk_order_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_id` (`integer`, required): ID of order to return the positions. Example: 200001.
- `embed` (`array`, optional): Comma-separated nested resources to expand, for example part. Example: part.
- `limit` (`integer`, optional): limits the number of entries returned. Example: 100.
- `offset` (`integer`, optional): set the index where the returned entries start. Example: 0.

Example input: `{"order_id":200001}`

### `sevdesk_orders_list`

List Orders · Read-only

List orders (offers, order confirmations and delivery notes), filtered by status, number, date range or contact.
Returns objects[] of orders with id, orderNumber, orderType, contact, orderDate, status and sums.
Use sevdesk_orders_list to browse. Use sevdesk_order_get for one order.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, optional): Only return records for this contact ID. Example: 12345.
- `count_all` (`boolean`, optional): Set to true to include the total number of matching records in the response. Example: true.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
- `end_date` (`integer`, optional): Only records dated on or before this Unix timestamp (seconds). Example: 1767225599.
- `limit` (`integer`, optional): Maximum number of entries to return, 1 to 1000. Example: 100.
- `offset` (`integer`, optional): Number of entries to skip before returning results, for paging. Example: 0.
- `order_number` (`string`, optional): Retrieve all orders with this order number. Example: AN-1001.
- `start_date` (`integer`, optional): Only records dated on or after this Unix timestamp (seconds). Example: 1735689600.
- `status` (`integer`, optional): Order status: 100 draft, 200 delivered, 300 rejected, 500 accepted, 750 partially calculated, 1000 calculated. Example: 200. One of: `100`, `200`, `300`, `500`, `750`, `1000`.

Example input: `{}`

### `sevdesk_part_get`

Get Part · Read-only

Get one inventory part by ID.
Returns objects[] with the part's name, number, prices, stock and tax rate.
Use sevdesk_part_get when you have the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `part_id` (`integer`, required): ID of part to return. Example: 5001.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.

Example input: `{"part_id":5001}`

### `sevdesk_part_stock_get`

Get Part Stock · Read-only

Get the current stock amount of a part.
Returns objects with the stock number.
Use sevdesk_part_stock_get to check availability.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `part_id` (`integer`, required): ID of part for which you want the current stock. Example: 5001.

Example input: `{"part_id":5001}`

### `sevdesk_parts_list`

List Parts · Read-only

List inventory parts (products and services), optionally by part number or name.
Returns objects[] of parts with id, name, partNumber, price, stock, unity and taxRate.
Use sevdesk_parts_list to find a part for invoice positions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `count_all` (`boolean`, optional): Set to true to include the total number of matching records in the response. Example: true.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
- `limit` (`integer`, optional): Maximum number of entries to return, 1 to 1000. Example: 100.
- `name` (`string`, optional): Retrieve all parts with this name. Example: Consulting hour.
- `offset` (`integer`, optional): Number of entries to skip before returning results, for paging. Example: 0.
- `part_number` (`string`, optional): Retrieve all parts with this part number. Example: P-100.

Example input: `{}`

### `sevdesk_tags_list`

List Tags · Read-only

List tags, optionally by ID or name.
Returns objects[] with id and name.
Use sevdesk_tags_list to find an existing tag before tagging a document with sevdesk_tag_create.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `count_all` (`boolean`, optional): Set to true to include the total number of matching records in the response. Example: true.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
- `id` (`number`, optional): Only the tag with this ID. Example: 101.
- `limit` (`integer`, optional): Maximum number of entries to return, 1 to 1000. Example: 100.
- `name` (`string`, optional): Name of the Tag. Example: VIP.
- `offset` (`integer`, optional): Number of entries to skip before returning results, for paging. Example: 0.

Example input: `{}`

### `sevdesk_voucher_get`

Get Voucher · Read-only

Get one voucher by ID.
Returns objects[] with the voucher's date, supplier, description, status, tax settings and sums.
Use sevdesk_voucher_get when you have the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `voucher_id` (`integer`, required): ID of voucher to return. Example: 400001.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.

Example input: `{"voucher_id":400001}`

### `sevdesk_vouchers_list`

List Vouchers · Read-only

List vouchers (receipts for income and expenses), filtered by status, credit or debit, description, date range or contact.
Returns objects[] of vouchers with id, voucherDate, supplierName, description, status, creditDebit and sums.
Use sevdesk_vouchers_list to browse. Use sevdesk_voucher_get for one voucher.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, optional): Only return records for this contact ID. Example: 12345.
- `count_all` (`boolean`, optional): Set to true to include the total number of matching records in the response. Example: true.
- `credit_debit` (`string`, optional): C for income (credit) vouchers, D for expense (debit) vouchers. Example: D. One of: `C`, `D`.
- `description_like` (`string`, optional): Retrieve all vouchers with a description like this. Example: Printer.
- `embed` (`string`, optional): Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
- `end_date` (`integer`, optional): Only records dated on or before this Unix timestamp (seconds). Example: 1767225599.
- `limit` (`integer`, optional): Maximum number of entries to return, 1 to 1000. Example: 100.
- `offset` (`integer`, optional): Number of entries to skip before returning results, for paging. Example: 0.
- `start_date` (`integer`, optional): Only records dated on or after this Unix timestamp (seconds). Example: 1735689600.
- `status` (`number`, optional): Voucher status: 50 draft, 100 unpaid, 1000 paid. Example: 100. One of: `50`, `100`, `1000`.

Example input: `{}`

### `sevdesk_check_account_transaction_create`

Create Check Account Transaction · Write

Create a transaction on a check account, typically a file-import (CSV) or clearing account.
Returns objects with the new transaction.
Use sevdesk_check_account_transaction_create to record a payment that sevdesk did not import from the bank.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `amount` (`number`, required): Amount; negative for outgoing payments. Example: 119.5.
- `check_account_id` (`integer`, required): ID of the check account the transaction belongs to. Example: 5001.
- `payee_payer_name` (`string`, required): Name of the other party. Example: Acme GmbH.
- `status` (`integer`, required): Transaction status: 100 created, 200 linked, 300 private, 400 booked. Example: 100. One of: `100`, `200`, `300`, `400`.
- `value_date` (`string`, required): Date the check account transaction was booked. Example: 2026-12-01.
- `entry_date` (`string`, optional): Date the check account transaction was imported. Example: 2026-12-01.
- `payee_payer_acct_no` (`string`, optional): IBAN or account number of the other party. Example: DE89370400440532013000.
- `payee_payer_bank_code` (`string`, optional): BIC or bank code of the other party. Example: COBADEFFXXX.
- `paymt_purpose` (`string`, optional): The purpose of the transaction. Example: RE-1001.

Example input: `{"amount":119.5,"check_account_id":5001,"payee_payer_name":"<payee_payer_name>","status":100,"value_date":"<value_date>"}`

### `sevdesk_communication_way_create`

Create Communication Way · Write

Add an email address, phone number, mobile number or website to a contact.
Returns objects with the new communication way.
Use sevdesk_communication_way_create after sevdesk_contact_create. Get key IDs from sevdesk_communication_way_keys_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `key_id` (`integer`, required): ID of the CommunicationWayKey (label such as Private, Work or Office). Get IDs from sevdesk_communication_way_keys_list. Example: 2.
- `type` (`string`, required): Type of the communication way. Example: EMAIL. One of: `EMAIL`, `PHONE`, `WEB`, `MOBILE`.
- `value` (`string`, required): The value of the communication way. For example the phone number, e-mail address or website. Example: info@acme.example.
- `contact_id` (`integer`, optional): ID of the contact the communication way belongs to. Example: 12345.
- `main` (`boolean`, optional): Defines whether the communication way is the main communication way for the contact. Example: true.

Example input: `{"key_id":2,"type":"EMAIL","value":"<value>"}`

### `sevdesk_communication_way_update`

Update Communication Way · Write

Update a communication way; only the fields you send change.
Returns objects with the updated communication way.
Use sevdesk_communication_way_update to change an email address or phone number.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `communication_way_id` (`integer`, required): ID of CommunicationWay to update. Example: 4001.
- `contact_id` (`integer`, optional): ID of the contact the communication way belongs to. Example: 12345.
- `key_id` (`integer`, optional): ID of the CommunicationWayKey. Get IDs from sevdesk_communication_way_keys_list. Example: 2.
- `main` (`boolean`, optional): Defines whether the communication way is the main communication way for the contact. Example: true.
- `type` (`string`, optional): Type of the communication way. Example: EMAIL. One of: `EMAIL`, `PHONE`, `WEB`, `MOBILE`.
- `value` (`string`, optional): The value of the communication way. For example the phone number, e-mail address or website. Example: billing@acme.example.

Example input: `{"communication_way_id":4001}`

### `sevdesk_contact_address_create`

Create Contact Address · Write

Add a postal address to a contact.
Returns objects with the new address.
Use sevdesk_contact_address_create after sevdesk_contact_create.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `category_id` (`integer`, required): ID of the address Category: 47 for work, 48 for home, 49 for invoice address, 50 for delivery address. Example: 47.
- `contact_id` (`integer`, required): ID of the contact the address belongs to. Example: 12345.
- `country_id` (`integer`, required): ID of the StaticCountry, for example 1 for Germany. GET /StaticCountry in sevdesk lists all countries. Example: 1.
- `city` (`string`, optional): City name. Example: Offenburg.
- `name` (`string`, optional): Name in address. Example: Acme GmbH.
- `name2` (`string`, optional): Second name in address. Example: Accounts payable.
- `name3` (`string`, optional): Third name in address. Example: Building B.
- `name4` (`string`, optional): Fourth name in address. Example: 3rd floor.
- `street` (`string`, optional): Street name. Example: Musterstrasse 1.
- `zip` (`string`, optional): Zib code. Example: 77656.

Example input: `{"category_id":47,"contact_id":12345,"country_id":1}`

### `sevdesk_contact_address_update`

Update Contact Address · Write

Update a contact address; only the fields you send change.
Returns objects with the updated address.
Use sevdesk_contact_address_update to fix a street, city, zip or country.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_address_id` (`integer`, required): ID of the contact address to update. Example: 3001.
- `category_id` (`integer`, optional): ID of the address Category: 47 for work, 48 for home, 49 for invoice address, 50 for delivery address. Example: 47.
- `city` (`string`, optional): City name. Example: Offenburg.
- `contact_id` (`integer`, optional): ID of the contact the address belongs to. Example: 12345.
- `country_id` (`integer`, optional): ID of the StaticCountry, for example 1 for Germany. Example: 1.
- `name` (`string`, optional): Name in address. Example: Acme GmbH.
- `name2` (`string`, optional): Second name in address. Example: Accounts payable.
- `name3` (`string`, optional): Third name in address. Example: Building B.
- `name4` (`string`, optional): Fourth name in address. Example: 3rd floor.
- `street` (`string`, optional): Street name. Example: Musterstrasse 1.
- `zip` (`string`, optional): Zib code. Example: 77656.

Example input: `{"contact_address_id":3001}`

### `sevdesk_contact_create`

Create Contact · Write

Create a contact: an organization (set name) or a person (set surename and familyname).
Returns objects with the new contact's id and fields.
Use sevdesk_contact_create to add a customer or supplier, then sevdesk_contact_address_create and sevdesk_communication_way_create for its address, email and phone.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `category_id` (`integer`, required): ID of the contact Category: 3 for customer, 2 for supplier, 4 for partner, 28 for prospect customer. Example: 3.
- `academic_title` (`string`, optional): A academic title for the contact. Not to be used for organizations. Example: Prof.
- `bank_account` (`string`, optional): Bank account number (IBAN) of the contact. Example: DE89370400440532013000.
- `bank_number` (`string`, optional): Bank number of the bank used by the contact. Example: 37040044.
- `birthday` (`string`, optional): Birthday of the contact. Not to be used for organizations. Example: 1980-05-17.
- `buyer_reference` (`string`, optional): Buyer reference of the contact. Example: 04011000-12345-34.
- `customer_number` (`string`, optional): The customer number. Example: 1001.
- `default_cashback_percent` (`number`, optional): Percentage of the invoice sum the contact gets back if he paid invoices in time. Example: 2.
- `default_cashback_time` (`integer`, optional): Absolute time in days which the contact has to pay his invoices and subsequently get a cashback. Example: 10.
- `default_discount_amount` (`number`, optional): The default discount the contact gets for every invoice. Depending on defaultDiscountPercentage attribute, in percent or absolute value. Example: 5.
- `default_discount_percentage` (`boolean`, optional): Defines if the discount is a percentage (true) or an absolute value (false). Example: true.
- `default_time_to_pay` (`integer`, optional): The payment goal in days which is set for every invoice of the contact. Example: 14.
- `description` (`string`, optional): A description for the contact. Example: Key account.
- `exempt_vat` (`boolean`, optional): Defines if the contact is freed from paying vat. Example: true.
- `familyname` (`string`, optional): The last name of the contact. Not to be used for organizations. Example: Mustermann.
- `gender` (`string`, optional): Gender of the contact. Not to be used for organizations. Example: w.
- `government_agency` (`boolean`, optional): Defines whether the contact is a government agency (true) or not (false). Example: false.
- `name` (`string`, optional): Organization name. Set this for an organization and leave the person name fields empty. Example: Acme GmbH.
- `name2` (`string`, optional): Second name of the contact. Not to be used for organizations. Example: Erika.
- `parent_id` (`integer`, optional): ID of the Contact. The parent contact to which this contact belongs. Must be an organization. Example: 12000.
- `status` (`integer`, optional): Contact status: 100 for lead, 500 for pending, 1000 for active. Example: 1000.
- `surename` (`string`, optional): First name of a person contact (sevdesk spells this field surename). Leave name empty for a person. Example: Erika.
- `tax_number` (`string`, optional): The tax number of the contact. Example: 12/345/67890.
- `tax_office` (`string`, optional): The tax office of the contact (only for greek customers). Example: Athens.
- `titel` (`string`, optional): A non-academic title for the contact. Not to be used for organizations. Example: Dr.
- `vat_number` (`string`, optional): Vat number of the contact. Example: DE123456789.

Example input: `{"category_id":3}`

### `sevdesk_contact_update`

Update Contact · Write

Update a contact; only the fields you send change.
Returns objects with the updated contact.
Use sevdesk_contact_update to change a contact's name, status, category, tax or bank details.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, required): ID of contact to update. Example: 12345.
- `academic_title` (`string`, optional): A academic title for the contact. Not to be used for organizations. Example: Prof.
- `bank_account` (`string`, optional): Bank account number (IBAN) of the contact. Example: DE89370400440532013000.
- `bank_number` (`string`, optional): Bank number of the bank used by the contact. Example: 37040044.
- `birthday` (`string`, optional): Birthday of the contact. Not to be used for organizations. Example: 1980-05-17.
- `buyer_reference` (`string`, optional): Buyer reference of the contact. Example: 04011000-12345-34.
- `category_id` (`integer`, optional): ID of the contact Category: 3 for customer, 2 for supplier, 4 for partner, 28 for prospect customer. Example: 3.
- `customer_number` (`string`, optional): The customer number. Example: 1001.
- `default_cashback_percent` (`number`, optional): Percentage of the invoice sum the contact gets back if he paid invoices in time. Example: 2.
- `default_cashback_time` (`integer`, optional): Absolute time in days which the contact has to pay his invoices and subsequently get a cashback. Example: 10.
- `default_discount_amount` (`number`, optional): The default discount the contact gets for every invoice. Depending on defaultDiscountPercentage attribute, in percent or absolute value. Example: 5.
- `default_discount_percentage` (`boolean`, optional): Defines if the discount is a percentage (true) or an absolute value (false). Example: true.
- `default_time_to_pay` (`integer`, optional): The payment goal in days which is set for every invoice of the contact. Example: 14.
- `description` (`string`, optional): A description for the contact. Example: Key account.
- `exempt_vat` (`boolean`, optional): Defines if the contact is freed from paying vat. Example: true.
- `familyname` (`string`, optional): The last name of the contact. Not to be used for organizations. Example: Mustermann.
- `gender` (`string`, optional): Gender of the contact. Not to be used for organizations. Example: w.
- `government_agency` (`boolean`, optional): Defines whether the contact is a government agency (true) or not (false). Example: false.
- `name` (`string`, optional): The organization name. Be aware that the type of contact will depend on this attribute. If it holds a value, the contact will be regarded as an organization. Example: Acme GmbH.
- `name2` (`string`, optional): Second name of the contact. Not to be used for organizations. Example: Erika.
- `parent_id` (`integer`, optional): ID of the None. The parent contact to which this contact belongs. Must be an organization. Example: 12000.
- `status` (`integer`, optional): Contact status: 100 for lead, 500 for pending, 1000 for active. Example: 1000.
- `surename` (`string`, optional): First name of a person contact (sevdesk spells this field surename). Example: Erika.
- `tax_number` (`string`, optional): The tax number of the contact. Example: 12/345/67890.
- `tax_office` (`string`, optional): The tax office of the contact (only for greek customers). Example: Athens.
- `titel` (`string`, optional): A non-academic title for the contact. Not to be used for organizations. Example: Dr.
- `vat_number` (`string`, optional): Vat number of the contact. Example: DE123456789.

Example input: `{"contact_id":12345}`

### `sevdesk_credit_note_book_amount`

Book Credit Note Payment · Write

Book a payout against a credit note on a check account.
Returns objects with the booking.
Use sevdesk_credit_note_book_amount to mark a credit note as paid out.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `amount` (`number`, required): Amount to book; may be a partial amount. Example: 119.5.
- `check_account_id` (`integer`, required): ID of the CheckAccount. The check account on which should be booked. Example: 5001.
- `credit_note_id` (`integer`, required): ID of credit note to book. Example: 300001.
- `date` (`integer`, required): Booking date as a Unix timestamp (seconds), usually today. Example: 1767225600.
- `type` (`string`, required): Booking type: FULL_PAYMENT (book the full amount), N (normal partial payment), CB (cash discount), CF (currency fluctuation), O (other reduction), OF (other reduction as fee) or MTC (monetary transit). Example: FULL_PAYMENT. One of: `FULL_PAYMENT`, `N`, `CB`, `CF`, `O`, `OF`, `MTC`.
- `check_account_transaction_id` (`integer`, optional): ID of the CheckAccountTransaction. The check account transaction on which should be booked. The transaction will be linked to the credit note. When the check account is type online, you must provider a transaction; other types will create the transaction. Example: 90001.
- `create_feed` (`boolean`, optional): Determines if a feed is created for the booking process. Example: true.

Example input: `{"amount":119.5,"check_account_id":5001,"credit_note_id":300001,"date":1767225600,"type":"FULL_PAYMENT"}`

### `sevdesk_credit_note_create`

Create Credit Note · Write

Create a credit note with its line items, or update one when creditNote.id is set.
Returns objects with creditNote and creditNotePos.
Use sevdesk_credit_note_create for a free-standing credit note. Use sevdesk_credit_note_create_from_invoice to credit an existing invoice.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `credit_note` (`object`, required): The credit note model. It needs objectName CreditNote, mapAll true, creditNoteNumber, contact and contactPerson references, creditNoteDate, deliveryDate, status (100 draft), header, addressCountry, taxRate, taxRule or taxType, taxText, bookingCategory (for example UNDERACHIEVEMENT), invoiceType and currency. Example: {"objectName": "CreditNote", "mapAll": true, "creditNoteNumber": "GU-1001", "contact": {"id": 12345, "objectName": "Contact"}, "contactPerson": {"id": 777, "objectName": "SevUser"}, "creditNoteDate": "01.12.2026", "deliveryDate": "01.12.2026", "status": "100", "header": "Credit note GU-1001", "addressCountry": {"id": 1, "objectName": "StaticCountry"}, "taxRate": 0, "taxRule": {"id": "1", "objectName": "TaxRule"}, "taxText": "Umsatzsteuer 19%", "taxType": "default", "bookingCategory": "UNDERACHIEVEMENT", "invoiceType": "GU", "currency": "EUR"}.
- `credit_note_pos_save` (`array`, required): Line items to add. Each needs objectName CreditNotePos, mapAll true, quantity, unity and taxRate, plus usually name and price. Example: [{"objectName": "CreditNotePos", "mapAll": true, "quantity": 1, "price": 50, "name": "Refund", "unity": {"id": 1, "objectName": "Unity"}, "taxRate": 19}].
- `credit_note_pos_delete` (`object`, optional): Line items to delete when updating, as {id, objectName CreditNotePos}. Example: {"id": 7771, "objectName": "CreditNotePos"}.

Example input: `{"credit_note":{},"credit_note_pos_save":[{"objectName":"CreditNotePos","mapAll":true,"quantity":1,"price":50,"name":"Refund","unity":{"id":1,"objectName":"Unity"},"taxRate":19}]}`

### `sevdesk_credit_note_create_from_invoice`

Create Credit Note from Invoice · Write

Create a credit note that credits an existing invoice.
Returns objects with the new credit note and its positions.
Use sevdesk_credit_note_create_from_invoice to refund or correct an invoice.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `invoice_id` (`integer`, required): ID of the invoice to credit. Example: 100001.

Example input: `{"invoice_id":100001}`

### `sevdesk_credit_note_send_via_email`

Send Credit Note via Email · Write

Email a credit note to the customer and mark it as sent.
Returns objects with the sent email details.
Use sevdesk_credit_note_send_via_email to deliver a credit note.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `credit_note_id` (`integer`, required): ID of credit note to be sent via email. Example: 300001.
- `subject` (`string`, required): Email subject. Example: Your invoice RE-1001.
- `text` (`string`, required): Email body; HTML is allowed. Example: Dear customer, please find attached your document.
- `to_email` (`string`, required): Recipient email address. Example: customer@example.com.
- `bcc_email` (`string`, optional): Comma-separated BCC email addresses. Example: archive@example.com.
- `cc_email` (`string`, optional): Comma-separated CC email addresses. Example: accounting@example.com.
- `copy` (`boolean`, optional): Set to true to also send a copy to yourself. Example: false.

Example input: `{"credit_note_id":300001,"subject":"<subject>","text":"<text>","to_email":"<to_email>"}`

### `sevdesk_invoice_book_amount`

Book Invoice Payment · Write

Book a payment against an invoice on a check account, optionally linked to a bank transaction.
Returns objects with the booking (CheckAccountTransactionLog).
Use sevdesk_invoice_book_amount to mark an invoice fully or partly paid.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `amount` (`number`, required): Amount to book; may be a partial amount. Example: 119.5.
- `check_account_id` (`integer`, required): ID of the CheckAccount. The check account on which should be booked. Example: 5001.
- `date` (`integer`, required): Booking date as a Unix timestamp (seconds), usually today. Example: 1767225600.
- `invoice_id` (`integer`, required): ID of invoice to book. Example: 100001.
- `type` (`string`, required): Booking type: FULL_PAYMENT (book the full amount), N (normal partial payment), CB (cash discount), CF (currency fluctuation), O (other reduction), OF (other reduction as fee) or MTC (monetary transit). Example: FULL_PAYMENT. One of: `FULL_PAYMENT`, `N`, `CB`, `CF`, `O`, `OF`, `MTC`.
- `check_account_transaction_id` (`integer`, optional): ID of the CheckAccountTransaction. The check account transaction on which should be booked. The transaction will be linked to the invoice. When the check account is type online, you must provider a transaction; other types will create the transaction. Example: 90001.
- `create_feed` (`boolean`, optional): Determines if a feed is created for the booking process. Example: true.

Example input: `{"amount":119.5,"check_account_id":5001,"date":1767225600,"invoice_id":100001,"type":"FULL_PAYMENT"}`

### `sevdesk_invoice_create`

Create Invoice · Write

Create an invoice (or update one when invoice.id is set) together with its line items and discounts.
Returns objects with invoice and invoicePos.
Use sevdesk_invoice_create to draft an invoice; send it with sevdesk_invoice_send_via_email.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `invoice` (`object`, required): The invoice model. It needs objectName Invoice, mapAll true, the contact and contactPerson (a SevUser) references, invoiceDate (dd.mm.yyyy or timestamp), discount, addressCountry, status (100 for draft), taxRate, taxRule (sevdesk-Update 2.0) or taxType, taxText, invoiceType (RE for a normal invoice) and currency. Example: {"objectName": "Invoice", "mapAll": true, "contact": {"id": 12345, "objectName": "Contact"}, "contactPerson": {"id": 777, "objectName": "SevUser"}, "invoiceDate": "01.12.2026", "discount": 0, "addressCountry": {"id": 1, "objectName": "StaticCountry"}, "status": "100", "taxRate": 0, "taxRule": {"id": "1", "objectName": "TaxRule"}, "taxText": "Umsatzsteuer 19%", "taxType": "default", "invoiceType": "RE", "currency": "EUR"}.
- `invoice_pos_save` (`array`, required): Line items to add. Each needs objectName InvoicePos, mapAll true, quantity, unity (unit reference), taxRate and a price, plus usually a name. Example: [{"objectName": "InvoicePos", "mapAll": true, "quantity": 1, "price": 100, "name": "Consulting", "unity": {"id": 1, "objectName": "Unity"}, "taxRate": 19}].
- `discount_save` (`array`, optional): Discounts to add. Each has discount true, text, percentage (true for percent, false for an amount), value, objectName Discounts and mapAll true. Example: [{"discount": true, "text": "Loyalty", "percentage": true, "value": 5, "objectName": "Discounts", "mapAll": true}].
- `filename` (`string`, optional): Filename of a previously uploaded file to attach. Example: invoice-attachment.pdf.
- `invoice_pos_delete` (`object`, optional): Line items to delete when updating an invoice, as {id, objectName InvoicePos} references. Example: {"id": 5551, "objectName": "InvoicePos"}.

Example input: `{"invoice":{},"invoice_pos_save":[{"objectName":"InvoicePos","mapAll":true,"quantity":1,"price":100,"name":"Consulting","unity":{"id":1,"objectName":"Unity"},"taxRate":19}]}`

### `sevdesk_invoice_create_from_order`

Create Invoice from Order · Write

Create an invoice from an order (offer or order confirmation), optionally as a partial or final invoice.
Returns objects with the new invoice.
Use sevdesk_invoice_create_from_order to bill an accepted order instead of retyping its positions.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `order_id` (`integer`, required): ID of the order to invoice. Example: 200001.
- `amount` (`number`, optional): Amount already paid or to bill for a partial invoice, interpreted according to type. Example: 500.
- `partial_type` (`string`, optional): Invoice type: RE final invoice, TR partial invoice, AR down-payment invoice. Example: RE. One of: `RE`, `TR`, `AR`.
- `type` (`string`, optional): How amount is given: percentage, net or gross. Example: percentage. One of: `percentage`, `net`, `gross`.

Example input: `{"order_id":200001}`

### `sevdesk_invoice_mark_sent`

Mark Invoice as Sent · Write

Mark an invoice as sent by print, post, email or PDF download without sending anything.
Returns objects with the updated invoice.
Use sevdesk_invoice_mark_sent when you delivered the invoice outside sevdesk. Use sevdesk_invoice_send_via_email to email it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`integer`, required): ID of invoice to mark as sent. Example: 100001.
- `send_draft` (`boolean`, required): Set to true to create an internal draft without changing the status. Example: false.
- `send_type` (`string`, required): How the invoice was sent: VPR print, VP postal, VM email, VPDF PDF download. Example: VM. One of: `VPR`, `VP`, `VM`, `VPDF`.

Example input: `{"invoice_id":100001,"send_draft":true,"send_type":"VPR"}`

### `sevdesk_invoice_reminder_create`

Create Invoice Reminder · Write

Create a payment reminder (dunning) for an invoice.
Returns objects with the new reminder invoice.
Use sevdesk_invoice_reminder_create for an overdue invoice; send the reminder with sevdesk_invoice_send_via_email.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `invoice_id` (`integer`, required): ID of the invoice to remind about. Example: 100001.

Example input: `{"invoice_id":100001}`

### `sevdesk_invoice_reset_to_draft`

Reset Invoice to Draft · Write

Reset an open invoice back to draft so it can be edited.
Returns objects with the updated invoice.
Use sevdesk_invoice_reset_to_draft before changing an invoice that was marked sent. Not possible once enshrined.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`integer`, required): ID of the invoice to reset. Example: 100001.

Example input: `{"invoice_id":100001}`

### `sevdesk_invoice_reset_to_open`

Reset Invoice to Open · Write

Reset a paid invoice to open; linked transactions are unlinked.
Returns objects with the updated invoice.
Use sevdesk_invoice_reset_to_open to undo a payment booking. Not possible once the invoice is enshrined.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`integer`, required): ID of the invoice to reset. Example: 100001.

Example input: `{"invoice_id":100001}`

### `sevdesk_invoice_send_via_email`

Send Invoice via Email · Write

Email an invoice to the customer with its PDF attached and mark it as sent.
Returns objects with the sent email details.
Use sevdesk_invoice_send_via_email to deliver an invoice. After sending, the invoice can no longer be edited.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `invoice_id` (`integer`, required): ID of invoice to be sent via email. Example: 100001.
- `subject` (`string`, required): Email subject. Example: Your invoice RE-1001.
- `text` (`string`, required): Email body; HTML is allowed. Example: Dear customer, please find attached your document.
- `to_email` (`string`, required): Recipient email address. Example: customer@example.com.
- `additional_attachments` (`string`, optional): Comma-separated IDs of other sevdesk documents to attach. Example: 1234,5678.
- `bcc_email` (`string`, optional): Comma-separated BCC email addresses. Example: archive@example.com.
- `cc_email` (`string`, optional): Comma-separated CC email addresses. Example: accounting@example.com.
- `copy` (`boolean`, optional): Set to true to also send a copy to yourself. Example: false.
- `send_xml` (`boolean`, optional): Set to true to attach the e-invoice XML instead of the PDF. Example: false.

Example input: `{"invoice_id":100001,"subject":"<subject>","text":"<text>","to_email":"<to_email>"}`

### `sevdesk_order_create`

Create Order · Write

Create an order (offer AN, order confirmation AB or delivery note LI) with its line items, or update one when order.id is set.
Returns objects with order and orderPos.
Use sevdesk_order_create to draft an offer; turn it into an invoice with sevdesk_invoice_create_from_order.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `order` (`object`, required): The order model. It needs objectName Order, mapAll true, orderNumber, contact and contactPerson references, orderDate, status (100 draft), header, addressCountry, taxRate, taxRule or taxType, taxText, currency, version (0) and orderType (AN offer, AB confirmation, LI delivery note). Example: {"objectName": "Order", "mapAll": true, "orderNumber": "AN-1001", "contact": {"id": 12345, "objectName": "Contact"}, "contactPerson": {"id": 777, "objectName": "SevUser"}, "orderDate": "01.12.2026", "status": 100, "header": "Offer AN-1001", "addressCountry": {"id": 1, "objectName": "StaticCountry"}, "taxRate": 0, "taxRule": {"id": "1", "objectName": "TaxRule"}, "taxText": "Umsatzsteuer 19%", "taxType": "default", "orderType": "AN", "currency": "EUR", "version": 0}.
- `order_pos_save` (`array`, required): Line items to add. Each needs quantity, unity (unit reference) and taxRate, plus usually name and price. Example: [{"objectName": "OrderPos", "mapAll": true, "quantity": 2, "price": 50, "name": "Workshop hours", "unity": {"id": 1, "objectName": "Unity"}, "taxRate": 19}].
- `order_pos_delete` (`object`, optional): Line items to delete when updating, as {id, objectName OrderPos}. Example: {"id": 6661, "objectName": "OrderPos"}.

Example input: `{"order":{},"order_pos_save":[{"objectName":"OrderPos","mapAll":true,"quantity":2,"price":50,"name":"Workshop hours","unity":{"id":1,"objectName":"Unity"},"taxRate":19}]}`

### `sevdesk_order_send_via_email`

Send Order via Email · Write

Email an order (offer, confirmation or delivery note) to the customer and mark it as sent.
Returns objects with the sent email details.
Use sevdesk_order_send_via_email to deliver an offer. After sending, the order can no longer be edited.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `order_id` (`integer`, required): ID of order to be sent via email. Example: 200001.
- `subject` (`string`, required): Email subject. Example: Your invoice RE-1001.
- `text` (`string`, required): Email body; HTML is allowed. Example: Dear customer, please find attached your document.
- `to_email` (`string`, required): Recipient email address. Example: customer@example.com.
- `additional_attachments` (`string`, optional): Comma-separated IDs of other sevdesk documents to attach. Example: 1234,5678.
- `bcc_email` (`string`, optional): Comma-separated BCC email addresses. Example: archive@example.com.
- `cc_email` (`string`, optional): Comma-separated CC email addresses. Example: accounting@example.com.
- `copy` (`boolean`, optional): Set to true to also send a copy to yourself. Example: false.

Example input: `{"order_id":200001,"subject":"<subject>","text":"<text>","to_email":"<to_email>"}`

### `sevdesk_order_update`

Update Order · Write

Update an order's header fields; only the fields you send change.
Returns objects with the updated order.
Use sevdesk_order_update to change status, texts, dates or terms. Use sevdesk_order_create with order.id to change line items.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_id` (`integer`, required): ID of order to update. Example: 200001.
- `address` (`string`, optional): Complete address of the recipient including name, street, city, zip and country. Line breaks can be used and will be displayed on the invoice pdf. Example: Acme GmbH
Musterstrasse 1
77656 Offenburg.
- `address_country_id` (`integer`, optional): ID of the StaticCountry of the address. Example: 1.
- `contact_id` (`integer`, optional): ID of the contact the order is for. Example: 12345.
- `contact_person_id` (`integer`, optional): ID of the SevUser who is the contact person. Example: 777.
- `currency` (`string`, optional): Currency used in the order. Needs to be currency code according to ISO-4217. Example: EUR.
- `customer_internal_note` (`string`, optional): Internal note of the customer. Contains data entered into field 'Referenz/Bestellnummer'. Example: PO-7781.
- `delivery_terms` (`string`, optional): Delivery terms of the order. Example: Delivery within 2 weeks.
- `foot_text` (`string`, optional): Certain html tags can be used here to format your text. Example: Valid for 30 days.
- `head_text` (`string`, optional): Certain html tags can be used here to format your text. Example: Thank you for your request.
- `header` (`string`, optional): Normally consist of prefix plus the order number. Example: Offer AN-1001.
- `order_date` (`string`, optional): Needs to be provided as timestamp or dd.mm.yyyy. Example: 01.12.2026.
- `order_number` (`string`, optional): The order number. Example: AN-1001.
- `order_type` (`string`, optional): Type of the order. For more information on the different types, check this. Example: AN. One of: `AN`, `AB`, `LI`.
- `payment_terms` (`string`, optional): Payment terms of the order. Example: 14 days net.
- `send_date` (`string`, optional): The date the order was sent to the customer. Example: 01.12.2026.
- `send_type` (`string`, optional): Type which was used to send the order. IMPORTANT: Please refer to the order section of the * API-Overview to understand how this attribute can be used before using it! Example: VM. One of: `VPR`, `VPDF`, `VM`, `VP`.
- `show_net` (`boolean`, optional): If true, the net amount of each position will be shown on the order. Otherwise gross amount. Example: true.
- `small_settlement` (`boolean`, optional): Defines if the client uses the small settlement scheme. If yes, the order must not contain any vat. Example: false.
- `status` (`integer`, optional): Order status: 100 draft, 200 delivered, 300 rejected, 500 accepted, 750 partially calculated, 1000 calculated. Example: 200. One of: `100`, `200`, `300`, `500`, `750`, `1000`.
- `tax_rule_id` (`integer`, optional): ID of the TaxRule (sevdesk-Update 2.0), for example 1 for taxable sales in Germany. Example: 1.
- `tax_text` (`string`, optional): A common tax text would be 'Umsatzsteuer 19%'. Example: Umsatzsteuer 19%.
- `version` (`integer`, optional): Version of the order. Can be used if you have multiple drafts for the same order. Should start with 0. Example: 0.

Example input: `{"order_id":200001}`

### `sevdesk_part_create`

Create Part · Write

Create an inventory part (product or service).
Returns objects with the new part.
Use sevdesk_part_create to add a product you sell; reference it in invoice positions.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the part. Example: Consulting hour.
- `part_number` (`string`, required): The part number. Example: P-100.
- `stock` (`number`, required): The stock of the part. Example: 0.
- `tax_rate` (`number`, required): Tax rate of the part. Example: 19.
- `unity_id` (`integer`, required): ID of the Unity the part is measured in, for example 1 for piece (Stk) or 9 for hour. Example: 1.
- `category_id` (`integer`, optional): ID of the part Category. Example: 16.
- `internal_comment` (`string`, optional): An internal comment for the part. Does not appear on invoices and orders. Example: Standard rate.
- `price_gross` (`number`, optional): Gross price for which the part is sold. Example: 119.
- `price_net` (`number`, optional): Net price for which the part is sold. Example: 100.
- `price_purchase` (`number`, optional): Purchase price of the part. Example: 60.
- `status` (`integer`, optional): Part status: 50 inactive, 100 active. Example: 100. One of: `50`, `100`.
- `stock_enabled` (`boolean`, optional): Defines if the stock should be enabled. Example: false.
- `text` (`string`, optional): A text describing the part. Example: One hour of consulting.

Example input: `{"name":"<name>","part_number":"<part_number>","stock":0,"tax_rate":19,"unity_id":1}`

### `sevdesk_part_update`

Update Part · Write

Update an inventory part; only the fields you send change.
Returns objects with the updated part.
Use sevdesk_part_update to change a price, stock or name.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `part_id` (`integer`, required): ID of part to update. Example: 5001.
- `category_id` (`integer`, optional): ID of the part Category. Example: 16.
- `internal_comment` (`string`, optional): An internal comment for the part. Does not appear on invoices and orders. Example: Standard rate.
- `name` (`string`, optional): Name of the part. Example: Consulting hour.
- `part_number` (`string`, optional): The part number. Example: P-100.
- `price_gross` (`number`, optional): Gross price for which the part is sold. Example: 119.
- `price_net` (`number`, optional): Net price for which the part is sold. Example: 100.
- `price_purchase` (`number`, optional): Purchase price of the part. Example: 60.
- `status` (`integer`, optional): Part status: 50 inactive, 100 active. Example: 100. One of: `50`, `100`.
- `stock` (`number`, optional): The stock of the part. Example: 10.
- `stock_enabled` (`boolean`, optional): Defines if the stock should be enabled. Example: true.
- `tax_rate` (`number`, optional): Tax rate of the part. Example: 19.
- `text` (`string`, optional): A text describing the part. Example: One hour of consulting.
- `unity_id` (`integer`, optional): ID of the Unity the part is measured in. Example: 1.

Example input: `{"part_id":5001}`

### `sevdesk_tag_create`

Create Tag · Write

Tag an invoice, order, voucher or credit note, creating the tag if it does not exist.
Returns objects with the tag relation.
Use sevdesk_tag_create to label a document.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Tag name. Example: VIP.
- `object_id` (`integer`, required): ID of the document to tag. Example: 100001.
- `object_name` (`string`, required): Type of the document to tag. Example: Invoice. One of: `Invoice`, `Voucher`, `Order`, `CreditNote`.

Example input: `{"name":"<name>","object_id":100001,"object_name":"Invoice"}`

### `sevdesk_voucher_book_amount`

Book Voucher Payment · Write

Book a payment against a voucher on a check account, optionally linked to a bank transaction.
Returns objects with the booking.
Use sevdesk_voucher_book_amount to mark a receipt fully or partly paid.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `amount` (`number`, required): Amount to book; may be a partial amount. Example: 119.5.
- `check_account_id` (`integer`, required): ID of the CheckAccount. The check account on which should be booked. Example: 5001.
- `date` (`string`, required): Booking date, for example 2026-12-01. Example: 2026-12-01.
- `type` (`string`, required): Booking type: FULL_PAYMENT (book the full amount), N (normal partial payment), CB (cash discount), CF (currency fluctuation), O (other reduction), OF (other reduction as fee) or MTC (monetary transit). Example: FULL_PAYMENT. One of: `FULL_PAYMENT`, `N`, `CB`, `CF`, `O`, `OF`, `MTC`.
- `voucher_id` (`integer`, required): ID of voucher to book. Example: 400001.
- `check_account_transaction_id` (`integer`, optional): ID of the CheckAccountTransaction. The check account transaction on which should be booked. The transaction will be linked to the voucher. Providing a transaction is required for online checkaccounts (like you would select an existing transaction in the UI). You should not provide a transaction for other account types, the transaction will be created automatically. Example: 90001.
- `create_feed` (`boolean`, optional): Determines if a feed is created for the booking process. Example: true.

Example input: `{"amount":119.5,"check_account_id":5001,"date":"<date>","type":"FULL_PAYMENT","voucher_id":400001}`

### `sevdesk_voucher_create`

Create Voucher · Write

Create a voucher (income or expense receipt) with its positions, or update one when voucher.id is set.
Returns objects with voucher and voucherPos.
Use sevdesk_voucher_create to record a supplier bill or other receipt.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `voucher` (`object`, required): The voucher model. It needs objectName Voucher, mapAll true, status (50 draft), taxRule or taxType, creditDebit (C income, D expense) and voucherType (VOU normal, RV recurring), plus usually voucherDate, supplierName or supplier, description and currency. Example: {"objectName": "Voucher", "mapAll": true, "voucherDate": "01.12.2026", "supplierName": "Office Supplies GmbH", "description": "Printer paper", "status": 50, "taxRule": {"id": "9", "objectName": "TaxRule"}, "taxType": "default", "creditDebit": "D", "voucherType": "VOU", "currency": "EUR"}.
- `voucher_pos_save` (`array`, required): Positions to add. Each needs objectName VoucherPos, mapAll true, accountDatev (or accountingType) reference, taxRate, net (true if sums are net) and sumNet or sumGross. Example: [{"objectName": "VoucherPos", "mapAll": true, "accountDatev": {"id": 4400, "objectName": "AccountDatev"}, "taxRate": 19, "net": false, "sumGross": 119, "comment": "Printer paper"}].
- `filename` (`string`, optional): Filename of a previously uploaded receipt file to attach. Example: receipt.pdf.
- `voucher_pos_delete` (`object`, optional): Positions to delete when updating, as {id, objectName VoucherPos}. Example: {"id": 8881, "objectName": "VoucherPos"}.

Example input: `{"voucher":{},"voucher_pos_save":[{"objectName":"VoucherPos","mapAll":true,"accountDatev":{"id":4400,"objectName":"AccountDatev"},"taxRate":19,"net":false,"sumGross":119,"comment":"Printer paper"}]}`

### `sevdesk_voucher_update`

Update Voucher · Write

Update a voucher's header fields; only the fields you send change.
Returns objects with the updated voucher.
Use sevdesk_voucher_update to change description, dates or supplier. Use sevdesk_voucher_create with voucher.id to change positions.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `voucher_id` (`integer`, required): ID of voucher to update. Example: 400001.
- `cost_centre_id` (`integer`, optional): ID of the cost centre. Example: 11.
- `credit_debit` (`string`, optional): Defines if your voucher is a credit (C) or debit (D). Example: D. One of: `C`, `D`.
- `currency` (`string`, optional): specifies which currency the voucher should have. Attention: If the currency differs from the default currency stored in the account, then either the "propertyForeignCurrencyDeadline" or "propertyExchangeRate" parameter must be specified. If both parameters are specified, then the "propertyForeignCurrencyDeadline" parameter is preferred. Example: EUR.
- `delivery_date` (`string`, optional): Needs to be provided as timestamp or dd.mm.yyyy. Example: 01.12.2026.
- `delivery_date_until` (`string`, optional): Needs to be provided as timestamp or dd.mm.yyyy. Example: 05.12.2026.
- `description` (`string`, optional): The description of the voucher. Essentially the voucher number. Example: Printer paper.
- `pay_date` (`string`, optional): Needs to be timestamp or dd.mm.yyyy. Example: 15.12.2026.
- `payment_deadline` (`string`, optional): Payment deadline of the voucher. Example: 31.12.2026.
- `status` (`number`, optional): Voucher status: 50 draft, 100 unpaid, 1000 paid. Example: 100.
- `supplier_id` (`integer`, optional): ID of the supplier contact. Example: 12345.
- `supplier_name` (`string`, optional): The supplier name. The value you provide here will determine what supplier name is shown for the voucher in case you did not provide a supplier. Example: Office Supplies GmbH.
- `tax_rule_id` (`integer`, optional): ID of the TaxRule (sevdesk-Update 2.0). Example: 9.
- `voucher_date` (`string`, optional): Needs to be provided as timestamp or dd.mm.yyyy. Example: 01.12.2026.
- `voucher_type` (`string`, optional): Type of the voucher. For more information on the different types, check this. Example: VOU. One of: `VOU`, `RV`.

Example input: `{"voucher_id":400001}`

### `sevdesk_communication_way_delete`

Delete Communication Way · Destructive

Delete a communication way.
Returns objects [null] on success.
Use sevdesk_communication_way_delete to remove an email address or phone number from a contact.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `communication_way_id` (`integer`, required): Id of communication way resource to delete. Example: 4001.

Example input: `{"communication_way_id":4001}`

### `sevdesk_contact_address_delete`

Delete Contact Address · Destructive

Delete a contact address.
Returns objects [null] on success.
Use sevdesk_contact_address_delete to remove an outdated address.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `contact_address_id` (`integer`, required): Id of contact address resource to delete. Example: 3001.

Example input: `{"contact_address_id":3001}`

### `sevdesk_contact_delete`

Delete Contact · Destructive

Delete a contact permanently.
Returns objects [null] on success.
Use sevdesk_contact_delete only for contacts with no invoices, orders or vouchers.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, required): Id of contact resource to delete. Example: 12345.

Example input: `{"contact_id":12345}`

### `sevdesk_credit_note_delete`

Delete Credit Note · Destructive

Delete a credit note.
Returns objects [null] on success.
Use sevdesk_credit_note_delete to remove a draft credit note.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `credit_note_id` (`integer`, required): Id of creditNote resource to delete. Example: 300001.

Example input: `{"credit_note_id":300001}`

### `sevdesk_invoice_cancel`

Cancel Invoice · Destructive

Cancel an invoice by creating a cancellation invoice that offsets it.
Returns objects with the cancellation invoice.
Use sevdesk_invoice_cancel for an invoice that was already sent; a draft can just be changed.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `invoice_id` (`integer`, required): ID of invoice to be cancelled. Example: 100001.

Example input: `{"invoice_id":100001}`

### `sevdesk_order_delete`

Delete Order · Destructive

Delete an order.
Returns objects [null] on success.
Use sevdesk_order_delete to remove a draft offer or order.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `order_id` (`integer`, required): Id of order resource to delete. Example: 200001.

Example input: `{"order_id":200001}`

## Related

Other Accounting & Finance connectors ([all 82](/agentkit/connectors/?category=accounting-finance)):

- [QuickBooks](/agentkit/connectors/quickbooks/): Scalekit connector, OAuth, 117 tools
- [Xero](/agentkit/connectors/xero/): Scalekit connector, OAuth, 94 tools
- [Stripe](/agentkit/connectors/stripe/): Scalekit connector, Access token, 178 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
