Skip to main content

​
paywise for Billomat

Billomat
Connect your Billomat account to paywise and hand open and overdue invoices to collection in a few clicks. The invoice PDF, customer data and recorded partial payments come along automatically — as do the reminders you sent from Billomat, including dunning fees.
paywise reads from Billomat and never writes back. Nothing in your bookkeeping is changed, cancelled or marked as paid.

​
Before you start

Billomat API access requires the Business plan or above. On the Professional plan no API key can be created.
  • A Billomat account on the Business plan or above.
  • Your Billomat ID and an API key (see below).
  • A paywise account.
  • No active DATEV import may exist for your paywise company. Deactivate it under DATEV Einstellungen → Gefahrenzone → Integration deaktivieren before connecting Billomat.

​
What paywise reads

The API key is used read-only.

​
Finding the Billomat ID and API key

Inside paywise this guide is available at any time via Anleitung öffnen (open guide) on the Billomat page. Your Billomat ID is in the address of your Billomat account: for https://muster.billomat.net it is muster. Create the API key like this:
1

Open settings

In Billomat, click the gear icon Einstellungen (Settings).
2

Open users

Under Administration, open Nutzer (Users).
3

Edit the user

On the desired user, click bearbeiten (edit) at the top right.
4

Enable API access

Under API Zugriff, tick aktivieren? (enable?).
5

Show and copy the key

Click API-Schlüssel anzeigen (show API key) and copy it.
6

Save

You must click Speichern (Save) — without saving the key is not active.

​
1. Connect Billomat

1

Open the connection page

Go to app.paywise.de/connect/billomat/.
2

Enter the Billomat ID

In Billomat-ID, enter only the name — without https://, without .billomat.net and without slashes.
3

Paste the API key

Paste the copied key into API-Schlüssel.
4

Connect

Choose Verbinden (connect). Connecting accepts the terms of use for the Billomat integration.
Once connected, the page shows Billomat ist verbunden with your Billomat ID and the last characters of the stored key.
Optional: your own request quota. If you register your own app (e.g. “paywise”) in Billomat under Einstellungen → Administration → Apps, the integration gets its own request quota instead of sharing one with your other integrations. Enter the App-ID and App-Secret when connecting — or leave both fields empty.

​
2. Submit invoices for collection

1

Open the invoice picker

On the Billomat page in paywise, choose Rechnungen einreichen.
2

Pick the invoices

paywise lists your open and overdue invoices live from Billomat — with invoice number, customer, invoice date, due date, total and open amount.The due date comes straight from Billomat; paywise calculates nothing here. The open amount already accounts for recorded partial payments.
3

Check the debtor data

Name and address come from the Billomat customer, the invoice PDF is attached automatically. Review and correct anything missing.
4

Review the reminders

Reminders already sent for the invoice are imported automatically — with date, deadline, amount, reminder PDF and, where Billomat flags it as such, the dunning fee. If you dunned outside Billomat, 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

paywise decides collectability itself rather than trusting the Billomat status alone:
  • Invoices with no open amount. An invoice is offered only if its Billomat status is open or overdue and an open amount greater than zero remains. That is deliberate: a fully paid invoice keeps the status overdue in Billomat if the payment was not booked with “mark invoice as paid”.
  • Drafts and cancelled 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.

​
3. Disconnect

On the Billomat page, choose Verbindung trennen and confirm. paywise deletes the stored API key and stops reading invoices from Billomat. Orders you already submitted are unaffected.
The key itself stays valid in Billomat. Resetting or disabling API access in Billomat does not invalidate it. Contact Billomat support if the key must be invalidated completely.

​
Troubleshooting

Check the name in your Billomat address. Enter only the name — without https://, without .billomat.net and without slashes.
Check that API access was enabled and saved in Billomat. Without clicking Speichern the key is not active.
Check both values in Billomat under Einstellungen → Administration → Apps — or leave the fields empty. Your own app is optional.
Billomat limits requests per account and time window. Try again in a few minutes. If it happens often, register your own app in Billomat and store the App-ID and App-Secret — the integration then gets its own quota.
Check whether the payment is assigned to the invoice in Billomat. paywise decides on the open amount, not on the status.

​
Questions

Write to [email protected].