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.
- Tools
- 60
- What they doRead · write · destructive
- 26 · 28 · 626 read28 write6 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the sevDesk connection
In AgentKit > Connections, create a sevDesk connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'sevdesk'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'sevdesk_check_account_transactions_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "sevdesk"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="sevdesk_check_account_transactions_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their sevDesk credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolsevdesk_check_account_balance_getGet a check account's balance at a date, summing all transactions up to the end of that day.Read-onlyGet Check Account Balance
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.
Inputs
check_account_idintegerrequired- ID of check account. Example: 5001.
datestringrequired- Date to compute the balance for, as YYYY-MM-DD; transactions up to 23:59:59 that day count. Example: 2026-12-31.
sevdesk_check_account_transactions_listList bank and cash transactions, filtered by check account, booking state, purpose, date range, payee or direction.Read-onlyList Check Account Transactions
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.
Inputs
check_account_idinteger- Only transactions on this check account ID. Example: 5001.
count_allboolean- Set to true to include the total number of matching records in the response. Example: true.
embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
end_datestring- Only retrieve transactions up to this date. Example: 2026-12-31.
is_bookedboolean- Only retrieve booked transactions. Example: false.
limitinteger- Maximum number of entries to return, 1 to 1000. Example: 100.
offsetinteger- Number of entries to skip before returning results, for paging. Example: 0.
only_creditboolean- Only retrieve credit transactions. Example: true.
only_debitboolean- Only retrieve debit transactions. Example: false.
payee_payer_namestring- Only retrieve transactions with this payee / payer. Example: Acme GmbH.
paymt_purposestring- Only retrieve transactions with this payment purpose. Example: RE-1001.
start_datestring- Only retrieve transactions from this date on. Example: 2026-12-01.
sevdesk_check_accounts_listList check accounts (bank accounts, cash registers and clearing accounts).Read-onlyList Check Accounts
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.
Inputs
count_allboolean- Set to true to include the total number of matching records in the response. Example: true.
embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
limitinteger- Maximum number of entries to return, 1 to 1000. Example: 100.
offsetinteger- Number of entries to skip before returning results, for paging. Example: 0.
sevdesk_communication_way_keys_listList the labels a communication way can have, such as Private, Work, Fax, Mobile or Office.Read-onlyList Communication Way Keys
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.
Inputs
This tool takes no inputs.
sevdesk_communication_ways_listList email addresses, phone numbers and websites of contacts, optionally for one contact or type.Read-onlyList Communication Ways
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.
Inputs
contact_idinteger- Only return records for this contact ID. Example: 12345.
count_allboolean- Set to true to include the total number of matching records in the response. Example: true.
embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
limitinteger- Maximum number of entries to return, 1 to 1000. Example: 100.
mainstring- Define if you only want the main communication way. Example: 0.one of
01 offsetinteger- Number of entries to skip before returning results, for paging. Example: 0.
typestring- Type of the communication ways you want to get. Example: PHONE.one of
PHONEEMAILWEBMOBILE
sevdesk_contact_addresses_listList all contact addresses.Read-onlyList Contact Addresses
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.
Inputs
count_allboolean- Set to true to include the total number of matching records in the response. Example: true.
embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
limitinteger- Maximum number of entries to return, 1 to 1000. Example: 100.
offsetinteger- Number of entries to skip before returning results, for paging. Example: 0.
sevdesk_contact_getGet one contact by ID.Read-onlyGet Contact
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.
Inputs
contact_idintegerrequired- ID of contact to return. Example: 12345.
embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
sevdesk_contact_next_customer_number_getGet the next free customer number.Read-onlyGet Next Customer Number
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.
Inputs
This tool takes no inputs.
sevdesk_contacts_find_by_custom_fieldFind contacts whose custom field has a given value.Read-onlyFind Contacts by Custom Field
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.
Inputs
custom_field_namestringrequired- Name of the contact custom field (ContactCustomFieldSetting) to check. Example: External ID.
valuestringrequired- Custom field value to match. Example: CRM-4711.
sevdesk_contacts_listList contacts (organizations and persons), optionally filtered by customer number.Read-onlyList Contacts
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.
Inputs
count_allboolean- Set to true to include the total number of matching records in the response. Example: true.
customer_numberstring- Retrieve all contacts with this customer number. Example: 1001.
depthstring- Which contacts to return: 0 for organizations only (default), 1 for organizations and persons. Example: 1.one of
01 embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
limitinteger- Maximum number of entries to return, 1 to 1000. Example: 100.
offsetinteger- Number of entries to skip before returning results, for paging. Example: 0.
sevdesk_credit_note_getGet one credit note by ID.Read-onlyGet Credit Note
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.
Inputs
credit_note_idintegerrequired- ID of creditNote to return. Example: 300001.
embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
sevdesk_credit_notes_listList credit notes, filtered by status, number, date range or contact.Read-onlyList Credit Notes
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.
Inputs
contact_idinteger- Only return records for this contact ID. Example: 12345.
count_allboolean- Set to true to include the total number of matching records in the response. Example: true.
credit_note_numberstring- Retrieve all CreditNotes with this creditNote number. Example: GU-1001.
embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
end_dateinteger- Only records dated on or before this Unix timestamp (seconds). Example: 1767225599.
limitinteger- Maximum number of entries to return, 1 to 1000. Example: 100.
offsetinteger- Number of entries to skip before returning results, for paging. Example: 0.
start_dateinteger- Only records dated on or after this Unix timestamp (seconds). Example: 1735689600.
statusstring- Credit note status: 100 draft, 200 open, 300 rejected, 500 accepted, 750 partially paid, 1000 paid. Example: 100.one of
1002003005007501000
sevdesk_invoice_getGet one invoice by ID.Read-onlyGet Invoice
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.
Inputs
invoice_idintegerrequired- ID of invoice to return. Example: 100001.
embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
sevdesk_invoice_partially_paid_checkCheck whether an invoice is partially paid.Read-onlyCheck Invoice Partially Paid
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.
Inputs
invoice_idintegerrequired- ID of invoice to return. Example: 100001.
sevdesk_invoice_pdf_getGet an invoice's PDF as base64 content with its filename and MIME type.Read-onlyGet Invoice PDF
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.
Inputs
invoice_idintegerrequired- ID of invoice from which you want the pdf. Example: 100001.
downloadboolean- Set to true to get the PDF content. Example: true.
prevent_send_byboolean- Set to true so fetching the PDF does not mark the invoice as sent. Example: true.
sevdesk_invoice_positions_getList the line items of an invoice.Read-onlyGet Invoice Positions
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.
Inputs
invoice_idintegerrequired- ID of invoice to return the positions. Example: 100001.
embedarray- Comma-separated nested resources to expand, for example part. Example: part.
limitinteger- limits the number of entries returned. Example: 100.
offsetinteger- set the index where the returned entries start. Example: 0.
sevdesk_invoices_listList invoices, filtered by status, number, date range or contact.Read-onlyList Invoices
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.
Inputs
contact_idinteger- Only return records for this contact ID. Example: 12345.
count_allboolean- Set to true to include the total number of matching records in the response. Example: true.
embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
end_dateinteger- Only records dated on or before this Unix timestamp (seconds). Example: 1767225599.
invoice_numberstring- Retrieve all invoices with this invoice number. Example: RE-1001.
limitinteger- Maximum number of entries to return, 1 to 1000. Example: 100.
offsetinteger- Number of entries to skip before returning results, for paging. Example: 0.
start_dateinteger- Only records dated on or after this Unix timestamp (seconds). Example: 1735689600.
statusnumber- Invoice status: 50 deactivated recurring, 100 draft, 200 open or due, 1000 paid. Example: 200.one of
1002001000
sevdesk_order_getGet one order by ID.Read-onlyGet Order
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.
Inputs
order_idintegerrequired- ID of order to return. Example: 200001.
embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
sevdesk_order_positions_getList the line items of an order.Read-onlyGet Order Positions
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.
Inputs
order_idintegerrequired- ID of order to return the positions. Example: 200001.
embedarray- Comma-separated nested resources to expand, for example part. Example: part.
limitinteger- limits the number of entries returned. Example: 100.
offsetinteger- set the index where the returned entries start. Example: 0.
sevdesk_orders_listList orders (offers, order confirmations and delivery notes), filtered by status, number, date range or contact.Read-onlyList Orders
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.
Inputs
contact_idinteger- Only return records for this contact ID. Example: 12345.
count_allboolean- Set to true to include the total number of matching records in the response. Example: true.
embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
end_dateinteger- Only records dated on or before this Unix timestamp (seconds). Example: 1767225599.
limitinteger- Maximum number of entries to return, 1 to 1000. Example: 100.
offsetinteger- Number of entries to skip before returning results, for paging. Example: 0.
order_numberstring- Retrieve all orders with this order number. Example: AN-1001.
start_dateinteger- Only records dated on or after this Unix timestamp (seconds). Example: 1735689600.
statusinteger- Order status: 100 draft, 200 delivered, 300 rejected, 500 accepted, 750 partially calculated, 1000 calculated. Example: 200.one of
1002003005007501000
sevdesk_part_getGet one inventory part by ID.Read-onlyGet Part
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.
Inputs
part_idintegerrequired- ID of part to return. Example: 5001.
embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
sevdesk_part_stock_getGet the current stock amount of a part.Read-onlyGet Part Stock
Get the current stock amount of a part. Returns objects with the stock number. Use sevdesk_part_stock_get to check availability.
Inputs
part_idintegerrequired- ID of part for which you want the current stock. Example: 5001.
sevdesk_parts_listList inventory parts (products and services), optionally by part number or name.Read-onlyList Parts
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.
Inputs
count_allboolean- Set to true to include the total number of matching records in the response. Example: true.
embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
limitinteger- Maximum number of entries to return, 1 to 1000. Example: 100.
namestring- Retrieve all parts with this name. Example: Consulting hour.
offsetinteger- Number of entries to skip before returning results, for paging. Example: 0.
part_numberstring- Retrieve all parts with this part number. Example: P-100.
sevdesk_voucher_getGet one voucher by ID.Read-onlyGet Voucher
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.
Inputs
voucher_idintegerrequired- ID of voucher to return. Example: 400001.
embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
sevdesk_vouchers_listList vouchers (receipts for income and expenses), filtered by status, credit or debit, description, date range or contact.Read-onlyList Vouchers
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.
Inputs
contact_idinteger- Only return records for this contact ID. Example: 12345.
count_allboolean- Set to true to include the total number of matching records in the response. Example: true.
credit_debitstring- C for income (credit) vouchers, D for expense (debit) vouchers. Example: D.one of
CD description_likestring- Retrieve all vouchers with a description like this. Example: Printer.
embedstring- Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
end_dateinteger- Only records dated on or before this Unix timestamp (seconds). Example: 1767225599.
limitinteger- Maximum number of entries to return, 1 to 1000. Example: 100.
offsetinteger- Number of entries to skip before returning results, for paging. Example: 0.
start_dateinteger- Only records dated on or after this Unix timestamp (seconds). Example: 1735689600.
statusnumber- Voucher status: 50 draft, 100 unpaid, 1000 paid. Example: 100.one of
501001000
sevdesk_check_account_transaction_createCreate a transaction on a check account, typically a file-import (CSV) or clearing account.WriteCreate Check Account Transaction
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.
Inputs
amountnumberrequired- Amount; negative for outgoing payments. Example: 119.5.
check_account_idintegerrequired- ID of the check account the transaction belongs to. Example: 5001.
payee_payer_namestringrequired- Name of the other party. Example: Acme GmbH.
statusintegerrequired- Transaction status: 100 created, 200 linked, 300 private, 400 booked. Example: 100.one of
100200300400 value_datestringrequired- Date the check account transaction was booked. Example: 2026-12-01.
entry_datestring- Date the check account transaction was imported. Example: 2026-12-01.
payee_payer_acct_nostring- IBAN or account number of the other party. Example: DE89370400440532013000.
payee_payer_bank_codestring- BIC or bank code of the other party. Example: COBADEFFXXX.
paymt_purposestring- The purpose of the transaction. Example: RE-1001.
sevdesk_communication_way_createAdd an email address, phone number, mobile number or website to a contact.WriteCreate Communication Way
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.
Inputs
key_idintegerrequired- ID of the CommunicationWayKey (label such as Private, Work or Office). Get IDs from sevdesk_communication_way_keys_list. Example: 2.
typestringrequired- Type of the communication way. Example: EMAIL.one of
EMAILPHONEWEBMOBILE valuestringrequired- The value of the communication way. For example the phone number, e-mail address or website. Example: info@acme.example.
contact_idinteger- ID of the contact the communication way belongs to. Example: 12345.
mainboolean- Defines whether the communication way is the main communication way for the contact. Example: true.
sevdesk_communication_way_updateUpdate a communication way; only the fields you send change.WriteUpdate Communication Way
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.
- Idempotent
Inputs
communication_way_idintegerrequired- ID of CommunicationWay to update. Example: 4001.
contact_idinteger- ID of the contact the communication way belongs to. Example: 12345.
key_idinteger- ID of the CommunicationWayKey. Get IDs from sevdesk_communication_way_keys_list. Example: 2.
mainboolean- Defines whether the communication way is the main communication way for the contact. Example: true.
typestring- Type of the communication way. Example: EMAIL.one of
EMAILPHONEWEBMOBILE valuestring- The value of the communication way. For example the phone number, e-mail address or website. Example: billing@acme.example.
sevdesk_contact_address_createAdd a postal address to a contact.WriteCreate Contact Address
Add a postal address to a contact. Returns objects with the new address. Use sevdesk_contact_address_create after sevdesk_contact_create.
Inputs
category_idintegerrequired- ID of the address Category: 47 for work, 48 for home, 49 for invoice address, 50 for delivery address. Example: 47.
contact_idintegerrequired- ID of the contact the address belongs to. Example: 12345.
country_idintegerrequired- ID of the StaticCountry, for example 1 for Germany. GET /StaticCountry in sevdesk lists all countries. Example: 1.
citystring- City name. Example: Offenburg.
namestring- Name in address. Example: Acme GmbH.
name2string- Second name in address. Example: Accounts payable.
name3string- Third name in address. Example: Building B.
name4string- Fourth name in address. Example: 3rd floor.
streetstring- Street name. Example: Musterstrasse 1.
zipstring- Zib code. Example: 77656.
sevdesk_contact_address_updateUpdate a contact address; only the fields you send change.WriteUpdate Contact Address
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.
- Idempotent
Inputs
contact_address_idintegerrequired- ID of the contact address to update. Example: 3001.
category_idinteger- ID of the address Category: 47 for work, 48 for home, 49 for invoice address, 50 for delivery address. Example: 47.
citystring- City name. Example: Offenburg.
contact_idinteger- ID of the contact the address belongs to. Example: 12345.
country_idinteger- ID of the StaticCountry, for example 1 for Germany. Example: 1.
namestring- Name in address. Example: Acme GmbH.
name2string- Second name in address. Example: Accounts payable.
name3string- Third name in address. Example: Building B.
name4string- Fourth name in address. Example: 3rd floor.
streetstring- Street name. Example: Musterstrasse 1.
zipstring- Zib code. Example: 77656.
sevdesk_contact_createCreate a contact: an organization (set name) or a person (set surename and familyname).WriteCreate Contact
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.
Inputs
category_idintegerrequired- ID of the contact Category: 3 for customer, 2 for supplier, 4 for partner, 28 for prospect customer. Example: 3.
academic_titlestring- A academic title for the contact. Not to be used for organizations. Example: Prof.
bank_accountstring- Bank account number (IBAN) of the contact. Example: DE89370400440532013000.
bank_numberstring- Bank number of the bank used by the contact. Example: 37040044.
birthdaystring- Birthday of the contact. Not to be used for organizations. Example: 1980-05-17.
buyer_referencestring- Buyer reference of the contact. Example: 04011000-12345-34.
customer_numberstring- The customer number. Example: 1001.
default_cashback_percentnumber- Percentage of the invoice sum the contact gets back if he paid invoices in time. Example: 2.
default_cashback_timeinteger- Absolute time in days which the contact has to pay his invoices and subsequently get a cashback. Example: 10.
default_discount_amountnumber- The default discount the contact gets for every invoice. Depending on defaultDiscountPercentage attribute, in percent or absolute value. Example: 5.
default_discount_percentageboolean- Defines if the discount is a percentage (true) or an absolute value (false). Example: true.
default_time_to_payinteger- The payment goal in days which is set for every invoice of the contact. Example: 14.
descriptionstring- A description for the contact. Example: Key account.
exempt_vatboolean- Defines if the contact is freed from paying vat. Example: true.
familynamestring- The last name of the contact. Not to be used for organizations. Example: Mustermann.
genderstring- Gender of the contact. Not to be used for organizations. Example: w.
government_agencyboolean- Defines whether the contact is a government agency (true) or not (false). Example: false.
namestring- Organization name. Set this for an organization and leave the person name fields empty. Example: Acme GmbH.
name2string- Second name of the contact. Not to be used for organizations. Example: Erika.
parent_idinteger- ID of the Contact. The parent contact to which this contact belongs. Must be an organization. Example: 12000.
statusinteger- Contact status: 100 for lead, 500 for pending, 1000 for active. Example: 1000.
surenamestring- First name of a person contact (sevdesk spells this field surename). Leave name empty for a person. Example: Erika.
tax_numberstring- The tax number of the contact. Example: 12/345/67890.
tax_officestring- The tax office of the contact (only for greek customers). Example: Athens.
titelstring- A non-academic title for the contact. Not to be used for organizations. Example: Dr.
vat_numberstring- Vat number of the contact. Example: DE123456789.
sevdesk_contact_updateUpdate a contact; only the fields you send change.WriteUpdate Contact
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.
- Idempotent
Inputs
contact_idintegerrequired- ID of contact to update. Example: 12345.
academic_titlestring- A academic title for the contact. Not to be used for organizations. Example: Prof.
bank_accountstring- Bank account number (IBAN) of the contact. Example: DE89370400440532013000.
bank_numberstring- Bank number of the bank used by the contact. Example: 37040044.
birthdaystring- Birthday of the contact. Not to be used for organizations. Example: 1980-05-17.
buyer_referencestring- Buyer reference of the contact. Example: 04011000-12345-34.
category_idinteger- ID of the contact Category: 3 for customer, 2 for supplier, 4 for partner, 28 for prospect customer. Example: 3.
customer_numberstring- The customer number. Example: 1001.
default_cashback_percentnumber- Percentage of the invoice sum the contact gets back if he paid invoices in time. Example: 2.
default_cashback_timeinteger- Absolute time in days which the contact has to pay his invoices and subsequently get a cashback. Example: 10.
default_discount_amountnumber- The default discount the contact gets for every invoice. Depending on defaultDiscountPercentage attribute, in percent or absolute value. Example: 5.
default_discount_percentageboolean- Defines if the discount is a percentage (true) or an absolute value (false). Example: true.
default_time_to_payinteger- The payment goal in days which is set for every invoice of the contact. Example: 14.
descriptionstring- A description for the contact. Example: Key account.
exempt_vatboolean- Defines if the contact is freed from paying vat. Example: true.
familynamestring- The last name of the contact. Not to be used for organizations. Example: Mustermann.
genderstring- Gender of the contact. Not to be used for organizations. Example: w.
government_agencyboolean- Defines whether the contact is a government agency (true) or not (false). Example: false.
namestring- 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.
name2string- Second name of the contact. Not to be used for organizations. Example: Erika.
parent_idinteger- ID of the None. The parent contact to which this contact belongs. Must be an organization. Example: 12000.
statusinteger- Contact status: 100 for lead, 500 for pending, 1000 for active. Example: 1000.
surenamestring- First name of a person contact (sevdesk spells this field surename). Example: Erika.
tax_numberstring- The tax number of the contact. Example: 12/345/67890.
tax_officestring- The tax office of the contact (only for greek customers). Example: Athens.
titelstring- A non-academic title for the contact. Not to be used for organizations. Example: Dr.
vat_numberstring- Vat number of the contact. Example: DE123456789.
sevdesk_credit_note_book_amountBook a payout against a credit note on a check account.WriteBook Credit Note Payment
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.
- Idempotent
Inputs
amountnumberrequired- Amount to book; may be a partial amount. Example: 119.5.
check_account_idintegerrequired- ID of the CheckAccount. The check account on which should be booked. Example: 5001.
credit_note_idintegerrequired- ID of credit note to book. Example: 300001.
dateintegerrequired- Booking date as a Unix timestamp (seconds), usually today. Example: 1767225600.
typestringrequired- 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_PAYMENTNCBCFOOFMTC check_account_transaction_idinteger- 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_feedboolean- Determines if a feed is created for the booking process. Example: true.
sevdesk_credit_note_createCreate a credit note with its line items, or update one when creditNote.id is set.WriteCreate Credit Note
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.
Inputs
credit_noteobjectrequired- 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_savearrayrequired- 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_deleteobject- Line items to delete when updating, as {id, objectName CreditNotePos}. Example: {"id": 7771, "objectName": "CreditNotePos"}.
sevdesk_credit_note_create_from_invoiceCreate a credit note that credits an existing invoice.WriteCreate Credit Note from Invoice
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.
Inputs
invoice_idintegerrequired- ID of the invoice to credit. Example: 100001.
sevdesk_credit_note_send_via_emailEmail a credit note to the customer and mark it as sent.WriteSend Credit Note via Email
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.
Inputs
credit_note_idintegerrequired- ID of credit note to be sent via email. Example: 300001.
subjectstringrequired- Email subject. Example: Your invoice RE-1001.
textstringrequired- Email body; HTML is allowed. Example: Dear customer, please find attached your document.
to_emailstringrequired- Recipient email address. Example: customer@example.com.
bcc_emailstring- Comma-separated BCC email addresses. Example: archive@example.com.
cc_emailstring- Comma-separated CC email addresses. Example: accounting@example.com.
copyboolean- Set to true to also send a copy to yourself. Example: false.
sevdesk_invoice_book_amountBook a payment against an invoice on a check account, optionally linked to a bank transaction.WriteBook Invoice Payment
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.
- Idempotent
Inputs
amountnumberrequired- Amount to book; may be a partial amount. Example: 119.5.
check_account_idintegerrequired- ID of the CheckAccount. The check account on which should be booked. Example: 5001.
dateintegerrequired- Booking date as a Unix timestamp (seconds), usually today. Example: 1767225600.
invoice_idintegerrequired- ID of invoice to book. Example: 100001.
typestringrequired- 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_PAYMENTNCBCFOOFMTC check_account_transaction_idinteger- 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_feedboolean- Determines if a feed is created for the booking process. Example: true.
sevdesk_invoice_createCreate an invoice (or update one when invoice.id is set) together with its line items and discounts.WriteCreate Invoice
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.
Inputs
invoiceobjectrequired- 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_savearrayrequired- 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_savearray- 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}].
filenamestring- Filename of a previously uploaded file to attach. Example: invoice-attachment.pdf.
invoice_pos_deleteobject- Line items to delete when updating an invoice, as {id, objectName InvoicePos} references. Example: {"id": 5551, "objectName": "InvoicePos"}.
sevdesk_invoice_create_from_orderCreate an invoice from an order (offer or order confirmation), optionally as a partial or final invoice.WriteCreate Invoice from Order
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.
Inputs
order_idintegerrequired- ID of the order to invoice. Example: 200001.
amountnumber- Amount already paid or to bill for a partial invoice, interpreted according to type. Example: 500.
partial_typestring- Invoice type: RE final invoice, TR partial invoice, AR down-payment invoice. Example: RE.one of
RETRAR typestring- How amount is given: percentage, net or gross. Example: percentage.one of
percentagenetgross
sevdesk_invoice_mark_sentMark an invoice as sent by print, post, email or PDF download without sending anything.WriteMark Invoice as Sent
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.
- Idempotent
Inputs
invoice_idintegerrequired- ID of invoice to mark as sent. Example: 100001.
send_draftbooleanrequired- Set to true to create an internal draft without changing the status. Example: false.
send_typestringrequired- How the invoice was sent: VPR print, VP postal, VM email, VPDF PDF download. Example: VM.one of
VPRVPVMVPDF
sevdesk_invoice_reminder_createCreate a payment reminder (dunning) for an invoice.WriteCreate Invoice Reminder
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.
Inputs
invoice_idintegerrequired- ID of the invoice to remind about. Example: 100001.
sevdesk_invoice_reset_to_draftReset an open invoice back to draft so it can be edited.WriteReset Invoice to Draft
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.
- Idempotent
Inputs
invoice_idintegerrequired- ID of the invoice to reset. Example: 100001.
sevdesk_invoice_reset_to_openReset a paid invoice to open; linked transactions are unlinked.WriteReset Invoice to Open
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.
- Idempotent
Inputs
invoice_idintegerrequired- ID of the invoice to reset. Example: 100001.
sevdesk_invoice_send_via_emailEmail an invoice to the customer with its PDF attached and mark it as sent.WriteSend Invoice via Email
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.
Inputs
invoice_idintegerrequired- ID of invoice to be sent via email. Example: 100001.
subjectstringrequired- Email subject. Example: Your invoice RE-1001.
textstringrequired- Email body; HTML is allowed. Example: Dear customer, please find attached your document.
to_emailstringrequired- Recipient email address. Example: customer@example.com.
additional_attachmentsstring- Comma-separated IDs of other sevdesk documents to attach. Example: 1234,5678.
bcc_emailstring- Comma-separated BCC email addresses. Example: archive@example.com.
cc_emailstring- Comma-separated CC email addresses. Example: accounting@example.com.
copyboolean- Set to true to also send a copy to yourself. Example: false.
send_xmlboolean- Set to true to attach the e-invoice XML instead of the PDF. Example: false.
sevdesk_order_createCreate an order (offer AN, order confirmation AB or delivery note LI) with its line items, or update one when order.id is set.WriteCreate Order
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.
Inputs
orderobjectrequired- 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_savearrayrequired- 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_deleteobject- Line items to delete when updating, as {id, objectName OrderPos}. Example: {"id": 6661, "objectName": "OrderPos"}.
sevdesk_order_send_via_emailEmail an order (offer, confirmation or delivery note) to the customer and mark it as sent.WriteSend Order via Email
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.
Inputs
order_idintegerrequired- ID of order to be sent via email. Example: 200001.
subjectstringrequired- Email subject. Example: Your invoice RE-1001.
textstringrequired- Email body; HTML is allowed. Example: Dear customer, please find attached your document.
to_emailstringrequired- Recipient email address. Example: customer@example.com.
additional_attachmentsstring- Comma-separated IDs of other sevdesk documents to attach. Example: 1234,5678.
bcc_emailstring- Comma-separated BCC email addresses. Example: archive@example.com.
cc_emailstring- Comma-separated CC email addresses. Example: accounting@example.com.
copyboolean- Set to true to also send a copy to yourself. Example: false.
sevdesk_order_updateUpdate an order's header fields; only the fields you send change.WriteUpdate Order
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.
- Idempotent
Inputs
order_idintegerrequired- ID of order to update. Example: 200001.
addressstring- 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_idinteger- ID of the StaticCountry of the address. Example: 1.
contact_idinteger- ID of the contact the order is for. Example: 12345.
contact_person_idinteger- ID of the SevUser who is the contact person. Example: 777.
currencystring- Currency used in the order. Needs to be currency code according to ISO-4217. Example: EUR.
customer_internal_notestring- Internal note of the customer. Contains data entered into field 'Referenz/Bestellnummer'. Example: PO-7781.
delivery_termsstring- Delivery terms of the order. Example: Delivery within 2 weeks.
foot_textstring- Certain html tags can be used here to format your text. Example: Valid for 30 days.
head_textstring- Certain html tags can be used here to format your text. Example: Thank you for your request.
headerstring- Normally consist of prefix plus the order number. Example: Offer AN-1001.
order_datestring- Needs to be provided as timestamp or dd.mm.yyyy. Example: 01.12.2026.
order_numberstring- The order number. Example: AN-1001.
order_typestring- Type of the order. For more information on the different types, check this. Example: AN.one of
ANABLI payment_termsstring- Payment terms of the order. Example: 14 days net.
send_datestring- The date the order was sent to the customer. Example: 01.12.2026.
send_typestring- 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
VPRVPDFVMVP show_netboolean- If true, the net amount of each position will be shown on the order. Otherwise gross amount. Example: true.
small_settlementboolean- Defines if the client uses the small settlement scheme. If yes, the order must not contain any vat. Example: false.
statusinteger- Order status: 100 draft, 200 delivered, 300 rejected, 500 accepted, 750 partially calculated, 1000 calculated. Example: 200.one of
1002003005007501000 tax_rule_idinteger- ID of the TaxRule (sevdesk-Update 2.0), for example 1 for taxable sales in Germany. Example: 1.
tax_textstring- A common tax text would be 'Umsatzsteuer 19%'. Example: Umsatzsteuer 19%.
versioninteger- Version of the order. Can be used if you have multiple drafts for the same order. Should start with 0. Example: 0.
sevdesk_part_createCreate an inventory part (product or service).WriteCreate Part
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.
Inputs
namestringrequired- Name of the part. Example: Consulting hour.
part_numberstringrequired- The part number. Example: P-100.
stocknumberrequired- The stock of the part. Example: 0.
tax_ratenumberrequired- Tax rate of the part. Example: 19.
unity_idintegerrequired- ID of the Unity the part is measured in, for example 1 for piece (Stk) or 9 for hour. Example: 1.
category_idinteger- ID of the part Category. Example: 16.
internal_commentstring- An internal comment for the part. Does not appear on invoices and orders. Example: Standard rate.
price_grossnumber- Gross price for which the part is sold. Example: 119.
price_netnumber- Net price for which the part is sold. Example: 100.
price_purchasenumber- Purchase price of the part. Example: 60.
statusinteger- Part status: 50 inactive, 100 active. Example: 100.one of
50100 stock_enabledboolean- Defines if the stock should be enabled. Example: false.
textstring- A text describing the part. Example: One hour of consulting.
sevdesk_part_updateUpdate an inventory part; only the fields you send change.WriteUpdate Part
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.
- Idempotent
Inputs
part_idintegerrequired- ID of part to update. Example: 5001.
category_idinteger- ID of the part Category. Example: 16.
internal_commentstring- An internal comment for the part. Does not appear on invoices and orders. Example: Standard rate.
namestring- Name of the part. Example: Consulting hour.
part_numberstring- The part number. Example: P-100.
price_grossnumber- Gross price for which the part is sold. Example: 119.
price_netnumber- Net price for which the part is sold. Example: 100.
price_purchasenumber- Purchase price of the part. Example: 60.
statusinteger- Part status: 50 inactive, 100 active. Example: 100.one of
50100 stocknumber- The stock of the part. Example: 10.
stock_enabledboolean- Defines if the stock should be enabled. Example: true.
tax_ratenumber- Tax rate of the part. Example: 19.
textstring- A text describing the part. Example: One hour of consulting.
unity_idinteger- ID of the Unity the part is measured in. Example: 1.
sevdesk_tag_createTag an invoice, order, voucher or credit note, creating the tag if it does not exist.WriteCreate Tag
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.
Inputs
namestringrequired- Tag name. Example: VIP.
object_idintegerrequired- ID of the document to tag. Example: 100001.
object_namestringrequired- Type of the document to tag. Example: Invoice.one of
InvoiceVoucherOrderCreditNote
sevdesk_voucher_book_amountBook a payment against a voucher on a check account, optionally linked to a bank transaction.WriteBook Voucher Payment
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.
- Idempotent
Inputs
amountnumberrequired- Amount to book; may be a partial amount. Example: 119.5.
check_account_idintegerrequired- ID of the CheckAccount. The check account on which should be booked. Example: 5001.
datestringrequired- Booking date, for example 2026-12-01. Example: 2026-12-01.
typestringrequired- 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_PAYMENTNCBCFOOFMTC voucher_idintegerrequired- ID of voucher to book. Example: 400001.
check_account_transaction_idinteger- 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_feedboolean- Determines if a feed is created for the booking process. Example: true.
sevdesk_voucher_createCreate a voucher (income or expense receipt) with its positions, or update one when voucher.id is set.WriteCreate Voucher
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.
Inputs
voucherobjectrequired- 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_savearrayrequired- 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"}].
filenamestring- Filename of a previously uploaded receipt file to attach. Example: receipt.pdf.
voucher_pos_deleteobject- Positions to delete when updating, as {id, objectName VoucherPos}. Example: {"id": 8881, "objectName": "VoucherPos"}.
sevdesk_voucher_updateUpdate a voucher's header fields; only the fields you send change.WriteUpdate Voucher
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.
- Idempotent
Inputs
voucher_idintegerrequired- ID of voucher to update. Example: 400001.
cost_centre_idinteger- ID of the cost centre. Example: 11.
credit_debitstring- Defines if your voucher is a credit (C) or debit (D). Example: D.one of
CD currencystring- 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_datestring- Needs to be provided as timestamp or dd.mm.yyyy. Example: 01.12.2026.
delivery_date_untilstring- Needs to be provided as timestamp or dd.mm.yyyy. Example: 05.12.2026.
descriptionstring- The description of the voucher. Essentially the voucher number. Example: Printer paper.
pay_datestring- Needs to be timestamp or dd.mm.yyyy. Example: 15.12.2026.
payment_deadlinestring- Payment deadline of the voucher. Example: 31.12.2026.
statusnumber- Voucher status: 50 draft, 100 unpaid, 1000 paid. Example: 100.
supplier_idinteger- ID of the supplier contact. Example: 12345.
supplier_namestring- 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_idinteger- ID of the TaxRule (sevdesk-Update 2.0). Example: 9.
voucher_datestring- Needs to be provided as timestamp or dd.mm.yyyy. Example: 01.12.2026.
voucher_typestring- Type of the voucher. For more information on the different types, check this. Example: VOU.one of
VOURV
sevdesk_communication_way_deleteDelete a communication way.DestructiveDelete Communication Way
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.
- Idempotent
Inputs
communication_way_idintegerrequired- Id of communication way resource to delete. Example: 4001.
sevdesk_contact_address_deleteDelete a contact address.DestructiveDelete Contact Address
Delete a contact address. Returns objects [null] on success. Use sevdesk_contact_address_delete to remove an outdated address.
- Idempotent
Inputs
contact_address_idintegerrequired- Id of contact address resource to delete. Example: 3001.
sevdesk_contact_deleteDelete a contact permanently.DestructiveDelete Contact
Delete a contact permanently. Returns objects [null] on success. Use sevdesk_contact_delete only for contacts with no invoices, orders or vouchers.
- Idempotent
Inputs
contact_idintegerrequired- Id of contact resource to delete. Example: 12345.
sevdesk_credit_note_deleteDelete a credit note.DestructiveDelete Credit Note
Delete a credit note. Returns objects [null] on success. Use sevdesk_credit_note_delete to remove a draft credit note.
- Idempotent
Inputs
credit_note_idintegerrequired- Id of creditNote resource to delete. Example: 300001.
sevdesk_invoice_cancelCancel an invoice by creating a cancellation invoice that offsets it.DestructiveCancel Invoice
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.
Inputs
invoice_idintegerrequired- ID of invoice to be cancelled. Example: 100001.
sevdesk_order_deleteDelete an order.DestructiveDelete Order
Delete an order. Returns objects [null] on success. Use sevdesk_order_delete to remove a draft offer or order.
- Idempotent
Inputs
order_idintegerrequired- Id of order resource to delete. Example: 200001.
No tools match.