paywise for sevdesk
paywise reads from sevdesk and never writes back. Nothing in your bookkeeping is
changed, cancelled or marked as paid.
Before you start
- A sevdesk account with API access.
- A paywise account.
- At least one completed, open invoice in sevdesk.
- No active DATEV import may exist for your paywise company. Deactivate it under DATEV Einstellungen → Gefahrenzone → Integration deaktivieren before connecting sevdesk.
What paywise reads
The API token is used read-only.
Finding your sevdesk API token
Inside paywise this guide is available at any time via „Was ist das?“ (what is this?) on the sevdesk page.1
Sign in to sevdesk
Sign in to your sevdesk account at my.sevdesk.de.
2
Open the API section
In the menu, go to Erweiterungen → API (Extensions → API).
3
Reveal the token
Click Einblenden (show) to display the API token.
4
Copy the token
Copy the key to your clipboard.
1. Connect sevdesk
1
Open the connection page
2
Paste the token
Paste the key into the API-Token field. The API Basis-URL is pre-filled
with
https://my.sevdesk.de/api/v1 and normally needs no change.3
Accept the terms and test
Tick Ich akzeptiere die Nutzungsbedingungen (I accept the terms of use) and
choose API-Token testen (test API token).paywise verifies the token directly with sevdesk. If the check succeeds, the
connection is saved immediately.
2. Submit invoices for collection
1
Open the invoice picker
On the sevdesk page in paywise, choose Rechnungen einreichen.
2
Pick the invoices
paywise lists your open invoices live from sevdesk — with invoice number,
customer, invoice date, due date, total and open amount.paywise derives the due date from the invoice date plus the payment term
stored in sevdesk. Nothing needs to be configured in paywise for this.
3
Check the debtor data
Name and address come from the sevdesk contact, the invoice PDF is attached
automatically. Review and correct anything missing.
4
Review the reminders
Reminders you created in sevdesk for the invoice are imported automatically —
with reminder date, payment deadline and, where charged, the dunning fee of the
respective dunning level. If you dunned outside sevdesk, add that by hand here.
5
Send the order
Confirm how collection should start, answer the legal questions, accept the terms
and choose Auftrag absenden.
Invoices that cannot be submitted
- Drafts and unfinished invoices. paywise reads only completed sevdesk invoices.
- Incomplete recipient details. paywise imports the invoice as an editable draft. Complete the name and address in paywise before submitting the order.
- Already submitted invoices are shown as Eingereicht.
Mahnservice: importing invoices continuously
This integration feeds more than the one-off collection handover — it can also supply the paywise Mahnservice, the pre-collection dunning service. paywise then fetches your open invoices regularly and sends payment reminders on your behalf, before a case becomes a collection matter. You set the Mahnservice up at app.paywise.de/mahnservice/.Prerequisites
All of the following must be in place before the recurring sync starts:- An active sevdesk connection with a valid API token.
- A Mahnservice subscription and the accepted Mahnservice terms.
- A decided import scope — you determine once which invoices should be taken over.
What paywise checks before every reminder
1
Regular sync
paywise fetches your open invoices from sevdesk at fixed intervals. Newly opened
invoices are picked up automatically.
2
Status check immediately before sending
Right before a reminder goes out, paywise queries the current invoice status in
sevdesk once more. If the invoice has been paid or cancelled in the meantime, no
reminder is sent.
3
When in doubt, nothing is sent
If the status cannot be established beyond doubt — because sevdesk is temporarily
unreachable, for instance — paywise holds the reminder back. That is deliberate: a
reminder sent late is better than one sent to somebody who has already paid.
3. Disconnect
On the sevdesk page, choose Verbindung löschen (delete connection) and confirm with Löschen. paywise removes the stored token and stops reading invoices. Orders you already submitted are unaffected. paywise pauses running dunning processes that depend on this connection. You can resume them after reconnecting.Troubleshooting
„Der API-Token konnte nicht verifiziert werden“
„Der API-Token konnte nicht verifiziert werden“
Check that you copied the full token (no leading or trailing spaces) and that the
API base URL is unchanged.
„Ihr API-Token ist nicht mehr gültig“
„Ihr API-Token ist nicht mehr gültig“
The token was reset or revoked in sevdesk. Fetch a current token under
Erweiterungen → API and store it again.
The invoice list is empty
The invoice list is empty
paywise shows only completed, open invoices. Drafts do not appear. Check the
invoice status in sevdesk.
The open amount is wrong
The open amount is wrong
paywise subtracts payments recorded in sevdesk from the gross amount. A payment
not yet assigned to the invoice in sevdesk does not show up here. Assign it in
sevdesk and reload the list.
Another integration is already active
Another integration is already active
Another import source conflicts with sevdesk. If the message names a DATEV
import, deactivate it; disconnect any other integration named there. Then try
again.
