Configuration

Connection page

Field	Meaning
Mode	Test (a second, trial sevDesk account) or Live. Each mode has its own token.
API token	Your personal sevDesk API token (32 characters). Stored encrypted, never shown again; leave empty to keep it. Generating a new token in sevDesk stops the old one: paste the new one here.
Test connection	Reads the bookkeeping version, the payment accounts and a suggestion for the contact person.

Mapping page

Field	Meaning
Tax rates	Rate sent per CS-Cart tax. Empty = the rate of the tax in the order. sevDesk accepts 0, 7 and 19 % for domestic and intra-community invoices.
Shipping rate	Optional fixed rate for the shipping line (default: the shipping tax of the order, else the main rate).
Payment account	Where payments (and refunds, if on) are booked. Only clearing (offline) and cash (register) accounts: bank accounts need real bank transactions in sevDesk.
Unit ID	sevDesk unit of every position (default 1).
Contact person	sevDesk user ID shown as contact person on invoices. Empty = the user of your latest sevDesk invoice.

Settings (Add-ons > sevDesk Accounting Sync)

Setting	Default	Meaning
Create the invoice when the order status becomes	Processed	Empty = only by hand (“Issue now”). Declined, failed, canceled and incomplete orders never get one.
Finalize the invoice (mark as sent)	On	Checks the draft total against the order, then moves it to Open and gives it its number. A different total stops before finalizing. Off: drafts that you finish in sevDesk.
Send the invoice to the customer from sevDesk	Off	sevDesk e-mails the invoice instead of only marking it sent.
Enshrine finalized documents	Off	sevDesk “festschreiben”; cannot be undone.
Small business (section 19 UStG)	Off	Every invoice uses tax rule 11 with 0 %.
Book payments in sevDesk	On	Books the payment when an invoiced order is Processed or Complete (needs a payment account on the Mapping page).
Book refunds in sevDesk	Off	Books finalized credit notes as paid out.
Refund status	Canceled	An order in this status gets a credit note for what is left on its invoice.
Credit notes for RMA returns	On	A completed return with refund gets a credit note for the returned items.
Order status when sevDesk shows the invoice paid	-	Moves Open / Backordered orders only.
EU business buyers with VAT ID, no VAT	3	3 intra-community supply (goods) or 21 reverse charge §18b (services).
Registered for One Stop Shop (OSS)	Off	On: every EU consumer order with VAT uses the OSS rule below, whatever the rate. Off: such orders need a German rate (0, 7, 19 %), other rates stop the job.
EU consumers at the destination rate	18	One Stop Shop rule: 18 goods, 19 electronic services, 20 other services.
Buyers outside the EU, no VAT	2	2 export (goods) or 17 not taxable in Germany (services).
Language of the invoice positions	German	Versand / Shipping, Art.-Nr. / SKU.
Payment term (days)	14	0 = your sevDesk default.
Head text	empty	Placeholders {order_id}, {date}.
Invoice download for customers	On	PDF button on the customer’s order page.
Do not sync orders before	empty	Needed before “Queue past orders”.
Permanently delete all invoice data on uninstall	Off	See Installation > Uninstall.

Cron

php admin.php --dispatch=kv_sevdesk.cron (or the secret URL shown in the settings) every 5 minutes. It sends queued work, retries failures with back-off and refreshes the state of open invoices.

Multi-Vendor

“Marketplace owner mode” on (default): all orders go to the owner’s sevDesk account. Off: each vendor opens Connection and Mapping in the vendor panel and connects their own sevDesk account; their orders are invoiced there.