Sevdesk integration: operations for AI agents
Sevdesk connects to Type.com as an integration. This page lists the 153 operations documented for Claude and Codex in Type.com: 78 read, 27 write, 48 destructive.
About Sevdesk
sevDesk is an online accounting software designed for small businesses and freelancers, offering features like invoicing, expense management, and financial reporting.
Categories: Finance & Accounting
How to connect Sevdesk to Type.com
- Access
- Organization connection: one shared account for the workspace.
To add the connection, follow the steps in Space connections.
Documented operations
153 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.
153 operations listed.
Basics
- Read
Retrieve bookkeeping system version
To check if you already received the update to version 2.0 you can use this endpoint.
Check Account
- Read
Retrieve check accounts
Retrieve all check accounts
- Read
Find check account by ID
Retrieve an existing check account
- Read
Get the balance at a given date
Get the balance, calculated as the sum of all transactions sevdesk knows, up to and including the given date. Note that this balance does not have to be the actual bank account balance, e.g. if sevdesk did not import old transactions.
- Write
Create a new file import account
Creates a new banking account for file imports (CSV, MT940).
- Write
Create a new clearing account
Creates a new clearing account.
- Destructive
Update an existing check account
Update a check account
- Destructive
Deletes a check account
DELETE /CheckAccount/{checkAccountId}
Check Account Transaction
- Read
Retrieve transactions
Retrieve all transactions depending on the filters defined in the query.
- Read
Find check account transaction by ID
Retrieve an existing check account transaction
- Write
Create a new transaction
Creates a new transaction on a check account. This should only be used with check account type online, preferably for csv import accounts.
- Destructive
Update an existing check account transaction
Update a check account transaction
- Destructive
Deletes a check account transaction
DELETE /CheckAccountTransaction/{checkAccountTransactionId}
- Destructive
Enshrine
Sets the current date and time as a value for the property enshrined. This operation is only possible if the status is "Linked" ("status": "200") or higher. Linked invoices, credit notes or vouchers cannot be changed when the transaction is enshrined.
Private Transaction Rule
- Read
List existing rules
List all existing rules you defined for automated marking private transactions.
- Write
Create a new rule
Creates a new rule for marking private transactions automatically.
- Destructive
Delete the rule by id
DELETE /PrivateTransactionRule/{id}
Contact
- Read
Get next free customer number
Retrieves the next available customer number. Avoids duplicates.
- Read
Find contacts by custom field value
Returns an array of contacts having a certain custom field value set.
- Read
Check if a customer number is available
Checks if a given customer number is available or already used.
- Read
Retrieve contacts
There are a multitude of parameter which can be used to filter. A few of them are attached but for a complete list please check out this list
- Read
Find contact by ID
Returns a single contact
- Read
Get number of all items
Get number of all invoices, orders, etc. of a specified contact
- Write
Create a new contact
Creates a new contact. For adding addresses and communication ways, you will need to use the ContactAddress and CommunicationWay endpoints.
- Destructive
Update a existing contact
Update a contact
- Destructive
Deletes a contact
DELETE /Contact/{contactId}
Contact Address
- Read
Retrieve contact addresses
Retrieve all contact addresses
- Read
Find contact address by ID
Returns a single contact address
- Write
Create a new contact address
Creates a new contact address.
- Destructive
update a existing contact address
update a existing contact address.
- Destructive
Deletes a contact address
DELETE /ContactAddress/{contactAddressId}
Communication Way
- Read
Retrieve communication ways
Returns all communication ways which have been added up until now. Filters can be added.
- Read
Find communication way by ID
Returns a single communication way
- Read
Retrieve communication way keys
Returns all communication way keys.
- Write
Create a new contact communication way
Creates a new contact communication way.
- Destructive
Update a existing communication way
Update a communication way
- Destructive
Deletes a communication way
DELETE /CommunicationWay/{communicationWayId}
Accounting Contact
- Read
Retrieve accounting contact
Returns all accounting contact which have been added up until now. Filters can be added.
- Read
Find accounting contact by ID
Returns a single accounting contac
- Write
Create a new accounting contact
Creates a new accounting contact.
- Destructive
Update an existing accounting contact
Attention, updating an existing AccountingContact can lead to booking errors, especially in the DATEV export. Compatibility of sevdesk with DATEV is no longer guaranteed.
- Destructive
Deletes an accounting contact
Attention, deleting an existing AccountingContact can lead to booking errors, especially in the DATEV export. Compatibility of sevdesk with DATEV is no longer guaranteed.
Contact Field
- Read
Retrieve Placeholders
Retrieve all Placeholders
- Read
Retrieve contact fields
Retrieve all contact fields
- Read
Retrieve contact fields
Retrieve all contact fields
- Read
Retrieve contact field settings
Retrieve all contact field settings
- Read
Find contact field setting by ID
Returns a single contact field setting
- Read
Receive count reference
Receive count reference
- Write
Create contact field
Create contact field
- Write
Create contact field setting
Create contact field setting
- Destructive
Update a contact field
Update a contact field
- Destructive
delete a contact field
DELETE /ContactCustomField/{contactCustomFieldId}
- Destructive
Update contact field setting
Update an existing contact field setting
- Destructive
Deletes a contact field setting
DELETE /ContactCustomFieldSetting/{contactCustomFieldSettingId}
Credit Note
- Read
Retrieve CreditNote
There are a multitude of parameter which can be used to filter.
- Read
Find creditNote by ID
Returns a single creditNote
- Read
Send credit note by printing
Sending a credit note to end-customers is an important part of the bookkeeping process. Depending on the way you want to send the credit note, you need to use different endpoints. Let's start with just printing out the credit note, meaning we only need to render the pdf.
- Read
Retrieve pdf document of a credit note
Retrieves the pdf document of a credit note with additional metadata.
- Write
Create a new creditNote
The list of parameters starts with the credit note array. This array contains all required attributes for a complete credit note. Most of the attributes are covered in the credit note attribute list, there are only two parameters standing out, namely mapAll and objectName .
- Write
Creates a new creditNote from an invoice
Use this endpoint to create a new creditNote from an invoice.
- Write
Creates a new creditNote from a voucher
Not supported with sevdesk-Update 2.0 Use this endpoint to create a new creditNote from a voucher.
- Write
Send credit note via email
This endpoint sends the specified credit note to a customer via email. This will automatically mark the credit note as sent. Please note, that in production an credit note is not allowed to be changed after this happened!
- Destructive
Update an existing creditNote
Update a creditNote
- Destructive
Deletes an creditNote
DELETE /CreditNote/{creditNoteId}
- Destructive
Mark credit note as sent
Marks an credit note as sent by a chosen send type.
- Destructive
Enshrine
Sets the current date and time as a value for the property enshrined. This operation is only possible if the status is "Open" ("status": "200") or higher. Enshrined credit notes cannot be changed. This operation cannot be undone.
- Destructive
Book a credit note
Booking the credit note with a transaction is probably the most important part in the bookkeeping process. There are several ways on correctly booking a credit note, all by using the same endpoint.
- Destructive
Reset status to open
Resets the status "Open" ("status": "200"). Linked transactions will be unlinked. This is not possible if the credit note itself or one of its transactions (CheckAccountTransaction) is already enshrined.
- Destructive
Reset status to draft
Resets the status to "Draft" ("status": "100"). This is only possible if the credit note has the status "Open" ("status": "200"). If it has a higher status use CreditNote/{creditNoteId}/resetToOpen first.
Credit Note Pos
- Read
Retrieve creditNote positions
Retrieve all creditNote positions depending on the filters defined in the query.
Export
- Read
Start DATEV CSV ZIP export
Start an export that generates booking data in the DATEV format (CSV) Before you can perform the DATEV export, you first have to set the "accountingYearBegin". To do this, use the endpoint updateExportConfig .
- Read
Start DATEV XML ZIP export
Start an export that generates invoice data in the DATEV format (XML) Before you can perform the DATEV export, you first have to set the "accountingYearBegin". To do this, use the endpoint updateExportConfig .
- Read
Generate download hash
Generates an identifier to request the current export progress.
- Read
Get progress
Get the progress state of the export. You can use polling (request every few seconds) to get the current state.
- Read
Get job download info
When the export job has finished you can call this endpoint to get the download url.
- Read
Export invoice
Export all invoices as csv
- Read
Export Invoice as zip
Export all invoices as zip
- Read
Export creditNote
Export all credit notes as csv
- Read
Export voucher as zip
Export all vouchers as zip
- Read
Export transaction
Export all transactions as csv
- Read
Export voucher zip
export all vouchers as zip
- Read
Export contact
Contact export as csv
- Destructive
Update export config
Update export config to export DATEV
Part
- Read
Retrieve parts
Retrieve all parts in your sevdesk inventory according to the applied filters.
- Read
Find part by ID
Returns a single part
- Read
Get stock of a part
Returns the current stock amount of the given part.
- Write
Create a new part
Creates a part in your sevdesk inventory.
- Destructive
Update an existing part
Update a part
Invoice
- Read
Retrieve invoices
There are a multitude of parameter which can be used to filter. A few of them are attached but for a complete list please check out this list
- Read
Find invoice by ID
Returns a single invoice
- Read
Find invoice positions
Returns all positions of an invoice
- Read
Check if an invoice is already partially paid
Returns 'true' if the given invoice is partially paid - 'false' if it is not. Invoices which are completely paid are regarded as not partially paid.
- Read
Retrieve pdf document of an invoice
Retrieves the pdf document of an invoice with additional metadata.
- Read
Retrieve XML of an e-invoice
Retrieves the XML of an e-invoice
- Write
Create a new invoice
This endpoint offers you the following functionality. Create invoices together with positions and discounts Delete positions while adding new ones Delete or add discounts, or both at the same time Automatically fill the address of the supplied contact into the invoice address To…
- Write
Create invoice from order
Create an invoice from an order
- Write
Create invoice reminder
Create an reminder from an invoice
- Write
Render the pdf document of an invoice
Using this endpoint you can render the pdf document of an invoice. Use cases for this are the retrieval of the pdf location or the forceful re-render of a already sent invoice.
- Write
Send invoice via email
This endpoint sends the specified invoice to a customer via email. This will automatically mark the invoice as sent. Please note, that in production an invoice is not allowed to be changed after this happened!
- Destructive
Cancel an invoice / Create cancellation invoice
This endpoint will cancel the specified invoice therefor creating a cancellation invoice. The cancellation invoice will be automatically paid and the source invoices status will change to 'cancelled'.
- Destructive
Mark invoice as sent
Marks an invoice as sent by a chosen send type.
- Destructive
Enshrine
Sets the current date and time as a value for the property enshrined. This operation is only possible if the status is "Open" ("status": "200") or higher. Enshrined invoices cannot be changed. This operation cannot be undone.
- Destructive
Book an invoice
Booking the invoice with a transaction is probably the most important part in the bookkeeping process. There are several ways on correctly booking an invoice, all by using the same endpoint. for more information look here .
- Destructive
Reset status to open
Resets the status "Open" ("status": "200"). Linked transactions will be unlinked. This is not possible if the invoice itself or one of its transactions (CheckAccountTransaction) is already enshrined. This endpoint cannot be used to increase the status to "Open" ("status": "200").
- Destructive
Reset status to draft
Resets the status to "Draft" ("status": "100"). This is only possible if the invoice has the status "Open" ("status": "200"). If it has a higher status use Invoice/{invoiceId}/resetToOpen first. This endpoint cannot be used for recurring invoices ("invoiceType": "WKR").
Invoice Pos
- Read
Retrieve InvoicePos
There are a multitude of parameter which can be used to filter.
Layout
- Read
Retrieve letterpapers
Retrieve all letterpapers with Thumb
- Read
Retrieve templates
Retrieve all templates
- Destructive
Update an invoice template
Update an existing invoice template
- Destructive
Update an order template
Update an existing order template
- Destructive
Update an of credit note template
Update an existing of credit note template
Order
- Read
Retrieve orders
There are a multitude of parameter which can be used to filter. A few of them are attached but for a complete list please check out this list
- Read
Find order by ID
Returns a single order
- Read
Find order positions
Returns all positions of an order
- Read
Find order discounts
Returns all discounts of an order
- Read
Find related objects
Get related objects of a specified order
- Read
Retrieve pdf document of an order
Retrieves the pdf document of an order with additional metadata and commit the order.
- Write
Create a new order
Creates an order to which positions can be added later.
- Write
Send order via email
This endpoint sends the specified order to a customer via email. This will automatically mark the order as sent. Please note, that in production an order is not allowed to be changed after this happened!
- Write
Create packing list from order
Create packing list from order
- Write
Create contract note from order
Create contract note from order
- Destructive
Update an existing order
Update an order
- Destructive
Deletes an order
DELETE /Order/{orderId}
- Destructive
Mark order as sent
Marks an order as sent by a chosen send type.
Order Pos
- Read
Retrieve order positions
Retrieve all order positions depending on the filters defined in the query.
- Read
Find order position by ID
Returns a single order position
- Destructive
Update an existing order position
Update an order position
- Destructive
Deletes an order Position
DELETE /OrderPos/{orderPosId}
Voucher
- Read
Retrieve vouchers
There are a multitude of parameter which can be used to filter. A few of them are attached but for a complete list please check out this list
- Read
Find voucher by ID
Returns a single voucher
- Read
Get all account guides
You can use this endpoint to help you decide which accounts you can use when creating a voucher
- Read
Get guidance by account number
You can use this endpoint to get additional information about the account that you may want to use.
- Read
Get guidance by Tax Rule
You can use this endpoint to get additional information about the tax rule (for example, USTPFLUMSEINN) that you may want to use.
- Read
Get guidance for revenue accounts
Provides all possible combinations for revenue accounts to be used with revenue receipts/vouchers.
- Read
Get guidance for expense accounts
Provides all possible combinations for expense accounts to be used with expense receipts/vouchers.
- Write
Create a new voucher
Bundles the creation or updating of voucher and voucher position. The list of parameters starts with the voucher model. This contains all required attributes for a complete voucher.
- Write
Upload voucher file
To attach a document to a voucher, you will need to upload it first for later use. To do this, you can use this request. When you successfully uploaded the file, you will get a sevdesk internal filename in the response.
- Destructive
Update an existing voucher
Update a draft voucher using this method if you want to change simple values like the description. Complex changes like adding a position should use /Voucher/Factory/saveVoucher. You can not change the status using this endpoint.
- Destructive
Enshrine
Sets the current date and time as a value for the property enshrined. This operation is only possible if the status is "Open" ("status": "100") or higher. Enshrined vouchers cannot be changed. This operation cannot be undone.
- Destructive
Book a voucher
Booking the voucher with a transaction is probably the most important part in the bookkeeping process. There are several ways on correctly booking a voucher, all by using the same endpoint. Conveniently, the booking process is exactly the same as the process for invoices.
- Destructive
Reset status to open
Resets the status to "Open" ("status": "100"). Linked payments will be unlinked. Created asset depreciation will be reset. This is not possible if the voucher is already enshrined! This endpoint can not be used to increase the status from "Draft" to "Open".
- Destructive
Reset status to draft
Resets the status "Draft" ("status": "50"). Linked payments will be unlinked. Created asset depreciation will be reset. This is not possible if the voucher is already enshrined! You can only change the status from higher to lower ("Open" to "Draft").
Voucher Pos
- Read
Retrieve voucher positions
Retrieve all voucher positions depending on the filters defined in the query.
Report
- Read
Export invoice list
Export invoice list
- Read
Export order list
Export order list
- Read
Export contact list
Export contact list
- Read
Export voucher list
Export voucher list
Tag
- Read
Retrieve tags
Retrieve all tags
- Read
Find tag by ID
Returns a single tag
- Read
Retrieve tag relations
Retrieve all tag relations
- Write
Create a new tag
Create a new tag
- Destructive
Update tag
Update an existing tag
- Destructive
Deletes a tag
DELETE /Tag/{tagId}
No operations match.
See How connections work for access and permissions, or browse all integrations.