Skip to content
Changelog

Report a bug

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}

See How connections work for access and permissions, or browse all integrations.