> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# sevdesk

> Manage contacts, invoices, vouchers, and receipt uploads in sevdesk bookkeeping

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key from `SEVDESK_API_KEY` is sent as the `Authorization` header.
* **Docs**: [https://api.sevdesk.de/](https://api.sevdesk.de/)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable          | Required | Description                                                                                                                                                                       |
| ----------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `SEVDESK_API_KEY` | Yes      | sevdesk API token (32-character hexadecimal string), found in your sevdesk user settings. Sent raw in the Authorization header without a prefix. [Docs](https://api.sevdesk.de/). |

## Setup

1. **Create a sevdesk account**: Sign up at [https://sevdesk.de](https://sevdesk.de) - a free trial account works for testing the API; there is no separate sandbox environment.
2. **Find your API token**: Log in to [https://my.sevdesk.de](https://my.sevdesk.de) and open Settings > Users. Every administrator has one API token, a 32-character hexadecimal string. Copy it and set it as SEVDESK\_API\_KEY.
3. **Verify access**: The token is sent as the raw value of the Authorization header on every request (no 'Bearer' prefix). Test with: curl [https://my.sevdesk.de/api/v1/Contact](https://my.sevdesk.de/api/v1/Contact) -H "Authorization: \<token>".

* sevdesk API tokens have an infinite lifetime and grant the full permissions of the user they belong to; rotate them from the user settings if leaked.
* The REST base URL is [https://my.sevdesk.de/api/v1](https://my.sevdesk.de/api/v1) (the docs are hosted at api.sevdesk.de).
* List responses wrap results in an 'objects' array; pagination uses limit and offset query parameters.
* The saveInvoice and saveVoucher factory endpoints require fully specified models: every embedded object needs objectName and mapAll fields, and references use \{ id, objectName } pairs.
* Voucher/Factory/uploadTempFile is a multipart/form-data upload; the returned internal filename is referenced in the 'filename' field when saving an invoice or voucher.

Provider API reference: [https://api.sevdesk.de/](https://api.sevdesk.de/)

## Tools

| Tool                | Access | Description                                                                                                                                                                           |
| ------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| List Contacts       | Read   | List sevdesk contacts (organizations and persons), e.g. to find a contact id before creating an invoice                                                                               |
| List Invoices       | Read   | List sevdesk invoices with optional status, number, date, and contact filters                                                                                                         |
| Get Invoice         | Read   | Retrieve a single sevdesk invoice by its id                                                                                                                                           |
| Create Invoice      | Write  | Create a sevdesk invoice with positions via the saveInvoice factory endpoint; create with status 100 for an editable draft                                                            |
| Upload Voucher File | Write  | Upload a receipt or invoice file to sevdesk; returns an internal filename that can be attached when creating a voucher                                                                |
| List Vouchers       | Read   | List sevdesk accounting vouchers (receipts) with optional status, type, date, and description filters                                                                                 |
| Create Voucher      | Write  | Create a bookable voucher (receipt) with positions via the saveVoucher factory endpoint - the step that turns a file staged with Upload Voucher File into an actual accounting record |
| Get Invoice PDF     | Read   | Retrieve the rendered PDF document of an invoice for sending or archiving                                                                                                             |
| Book Invoice Amount | Write  | Register a (partial) payment on an invoice and mark it paid when settled - closes the reconciliation loop after money arrives                                                         |

## Example prompts

* List my open sevdesk invoices and summarize who owes what.
* Upload this receipt to sevdesk so it can be booked as a voucher.
* Create a draft invoice in sevdesk for a customer; ask me for the positions first.