SevDesk is accounting and invoicing software. The xTool integration connects to your SevDesk account to sync documents and invoice-related data.

Prerequisites

• A SevDesk account.
• An API key (token) for the SevDesk API.

Obtain the API key from SevDesk (e.g. Settings → API or Integrations). See the SevDesk documentation for the exact steps.

Configuration (web)

1. In the xTool web app, go to Integrations → SevDesk.
2. Enter your API key (required).
3. Save the configuration. Once saved, xTool can sync with SevDesk.
4. To disconnect, remove the configuration; sync will stop.

How It Works

Once connected, xTool will import unpaid invoices for contacts tagged xTool, bring them into xTool, and keep you updated in SevDesk using tags.

Tags used:

• xTool — contacts for which invoices are synced.
• xTool-Uploaded — invoice imported into xTool.
• xTool-Peppol-Sent — invoice successfully sent via Peppol.
• xTool-Peppol-Failed — Peppol send failed.

1. Generate Your API Token

Why: xTool needs the token to read and write invoices in your SevDesk account.

How: In SevDesk, go to Extensions → API, click Display, then copy the token shown.

2. Tag Your Peppol Contacts (xTool tag)

Why: xTool only syncs invoices for companies tagged xTool.

How:

• Go to Contacts and click the edit icon next to the contact you need.
• Switch to the Additional information tab, add the tag xTool, then save.

3. Create an E-Invoice

Why: xTool only imports unpaid invoices created for contacts tagged xTool.

How:

• Go to Invoices → New invoice.
• Select your xTool-tagged contact, enable E-Invoice, and save. The invoice will save as Draft — manually change its status to Unpaid.

4. Import and Tags in xTool

What happens: On its next sync, xTool fetches all unpaid invoices for xTool-tagged contacts and marks them in SevDesk with xTool-Uploaded.

When you send via xTool: the tag in SevDesk is replaced with xTool-Peppol-Sent on success or xTool-Peppol-Failed on error.

5. Re-export Any Invoice

Why: Sometimes you need to re-export an invoice you have already synced.

How: In SevDesk, remove all of these tags from the invoice: xTool-Uploaded, xTool-Peppol-Sent, and xTool-Peppol-Failed. On the next sync, xTool will treat it as new, import it again, and tag it xTool-Uploaded.

6. Retry Sending Failed Invoices

Why: If a Peppol send fails, you can retry.

How: In xTool, click Send by Peppol again. On success, xTool will automatically replace the SevDesk tag with xTool-Peppol-Sent.

After configuration

Once SevDesk is configured, xTool syncs document data with your SevDesk account according to the flow described above. Only one SevDesk configuration per organisation is allowed.

Errors and support

If configuration fails (e.g. invalid API key), the web app will show an error. Check the key and SevDesk API permissions. For help, see Support. For token and access details, see the SevDesk API documentation.