Integrations
Rentstuff can automatically push invoices and customers to MoneyBird (accounting) and create shipping labels via PostNL. This screen (Settings → Integrations) is where you set up both.
Quick Overview
You connect MoneyBird with the Connect with MoneyBird button: you log in to MoneyBird, give Rentstuff permission and then pick your administration from a list. No copy-pasting a token. Rentstuff only asks for the Sales invoices (sales_invoices) right.
Prefer a personal API token? That still works, see Alternative: personal API token.
Connecting with MoneyBird
- Go to Settings → Integrations.
- Under MoneyBird, click Connect with MoneyBird. You are taken to MoneyBird.
- Log in to MoneyBird (if you aren't already) and give Rentstuff permission.
- You return to the Integrations screen automatically, with the message Connected to MoneyBird. The integration is then switched on.
- Pick your administration from the list. If you have only one, it is already selected.
- Click Save.
After that, use Test connection to load and map the VAT rates and revenue accounts, see below.
- Reconnect — for example to use a different MoneyBird user. Your chosen administration and settings stay as they are.
- Disconnect — Rentstuff revokes its permission at MoneyBird and switches the integration off. Your settings are kept, so you can reconnect later without choosing again.
- If you revoke access in MoneyBird yourself, Rentstuff reports "The connection with MoneyBird is invalid or revoked … Reconnect" at the next invoice or connection test. Click Reconnect.
It keeps working. Clicking Connect with MoneyBird replaces the token with the connection.
Alternative: personal API token
Don't see the Connect with MoneyBird button, or prefer to create a token yourself? In the Integrations screen, click Prefer a personal API token? and create the token like this:
- In the Integrations screen, click Open MoneyBird and log in. You land on the page for creating a new application (
moneybird.com/user/applications/new); choose a personal API token there. You can also go through your administration: select it in the top left and go to Settings → External applications → Create API token. - Give the token a name, for example Rentstuff.
- Check only "Sales invoices" (
sales_invoicesin the MoneyBird documentation). This single right also covers looking up/creating contacts, reading VAT rates and ledger accounts, and booking external invoices with an attachment — no other checkboxes are needed. - Confirm and copy the generated token.
Then the form is set to an external (OAuth) application. You don't need it: that is for software vendors, and Rentstuff has already registered its own application with MoneyBird. Choose the personal API token, use Connect with MoneyBird, or create the token under External applications in your administration's settings.
MoneyBird shows the token only once. Paste it straight into Rentstuff; it is stored encrypted and cannot be read back afterwards — not even by Rentstuff itself.
Setting the token in Rentstuff
- Go to Settings → Integrations.
- Turn on Enable MoneyBird.
- Paste the token into the API token field.
- Click Test connection. Rentstuff tests the token you just pasted right away — you don't need to click Save first.
- Pick your administration from the list that appears (see below).
- Click Save to store everything in one go.
Choosing an administration
After a successful connection test, the screen shows a list of the administrations the token can see (name + id), instead of typing the administration id by hand. If the token has access to exactly one administration, it is preselected automatically.
- An already-saved administration stays selected as long as it appears in the list.
- If the list doesn't load, or you prefer to type the id yourself, use "Enter id manually" — the free-text field always remains available as a fallback.
- Once you've picked an administration from the list, click Save to store both the token and the chosen administration (that's needed only once, even if you hadn't saved before).
Connection test
Test connection works with whatever token is currently in the token field — even if it hasn't been saved yet. If an administration has also already been picked (from the list or typed manually), that is tested too, even if the choice hasn't been saved yet. Rentstuff runs through the following steps:
- Is the token valid? An empty or invalid token gives a readable error right away (and the administration list stays empty).
- Fetch administrations — feeds the list above.
- If an administration is already saved, Rentstuff also tests:
- whether the token can reach that administration's VAT rates;
- whether the token can reach that administration's contacts (without creating a contact);
- whether the token can reach the ledger accounts — that list then appears to pick from (for the general revenue account and the per-product-category/product mapping, see Revenue account).
If the token is missing a right, Rentstuff reports this per step, for example: "The token works, but is missing the Sales invoices (sales_invoices) right (needed for VAT rates). Create a new token with that box checked." Fix this by creating a new token in MoneyBird with the correct box checked (see Alternative: personal API token) and saving it again.
The connection test never creates an invoice or contact in MoneyBird — it only reads.
When does an invoice go to MoneyBird?
Only once the invoice has been sent: with Mark as sent or Send by email on the invoice. This applies to every invoice — including a monthly invoice, a damage invoice and a credit note — and to both choices below.
- A draft stays entirely in Rentstuff. You can still delete it and create it again; MoneyBird is not affected.
- An invoice that is already in MoneyBird is never offered again, not even if you email it once more.
- The integration must be enabled at the moment you send the invoice.
- When the invoice is sent, the invoice date becomes the sending date (the due date moves along with the same term). MoneyBird therefore gets the sending date as the invoice date, not the date on which the draft was created.
Before this change an invoice went to MoneyBird as soon as it was created, so also as a draft. Such a draft is already in MoneyBird and is not offered again when you send it. If you delete such a draft in Rentstuff, delete the invoice in MoneyBird yourself as well.
You can see where an invoice stands in MoneyBird on the invoice itself: see MoneyBird status on the invoice.
Sales invoice or external invoice
Under Invoice in MoneyBird you choose how a Rentstuff invoice ends up in MoneyBird:
- Sales invoice (default) — The invoice goes into MoneyBird as a sales invoice. You send it from Rentstuff. MoneyBird makes its own sales invoice with its own invoice number; the Rentstuff invoice number is in the reference. MoneyBird does not email the customer: Rentstuff marks the invoice in MoneyBird as sent manually.
- External invoice — the invoice from Rentstuff is booked in MoneyBird, with the PDF attached. MoneyBird does not make an invoice of its own: it books the Rentstuff invoice (invoice number, invoice date and due date from Rentstuff) on the customer's contact and attaches the Rentstuff PDF — exactly the PDF the customer receives.
Either way, the lines show quantity, days and rental period, for example Portofoon Motorola DP4400 — 6 st × 5 dagen (28-09-2026 t/m 02-10-2026) (the line text is in Dutch). MoneyBird calculates quantity × price; for a day price the quantity is therefore pieces × days (30 here) and the price the day price. A line discount is named in the description, and the line amount in MoneyBird equals the Rentstuff line amount to the cent.
With large quantities (pieces × days above 100, often on a monthly invoice, for example 4 pcs × 30 days with a discount) MoneyBird sometimes shows 1 × the line amount instead of 120 × the day price. MoneyBird uses only a few decimals in the price; with quantity 1 the amount comes out exactly to the cent. The real quantity and days are then in the description (4 st × 30 dagen …); the amounts and the VAT are correct.
Revenue over the rental period
For rental lines, Rentstuff also passes the rental period on as the line's period. MoneyBird then spreads the revenue over that period in the profit and loss statement: a rental from 28-09-2026 to 02-10-2026 counts partly in September and partly in October.
- It is the same period as in the description: the line's own period, otherwise the invoice's. The invoice's period is fixed when the invoice is created; a later change to the order does not change it.
- A monthly invoice spreads over the billed month.
- A credit note spreads (negatively) over the period of the invoice it credits.
- Sales, services (such as delivery) and loose lines have no period; that revenue falls on the invoice date.
Revenue account
Every invoice line books in MoneyBird on a revenue account. Rentstuff works out which one, per line, in this order:
- the revenue account on the product (edit product → Bookkeeping section), if set;
- otherwise the revenue account of the product's category; if a subcategory has no mapping of its own, the one of the category above it (and so on upwards);
- otherwise the general revenue account below.
A charged-through damage line does not follow the product's category, but the separate Revenue account for damage setting; if that is empty, the general revenue account applies there too. A line without a product (a free line on the invoice) always gets the general revenue account.
General revenue account — the default account, set via Test connection:
- Click Test connection. Rentstuff fetches the revenue accounts from MoneyBird (with a search field for a long list).
- Pick the general revenue account and click Save.
The general revenue account applies to both invoicing modes. With External invoice it is required (you cannot save without one); with Sales invoice it is optional — if it's left empty, Rentstuff sends no revenue account for a line without a product or category mapping, and MoneyBird uses its own default account.
Revenue account per product category — this block appears, like the VAT list below, only after a successful Test connection (the account list comes from that test). It shows the category tree (a subcategory indented with ›) with a picker per category; the default option is "Follows '<parent category>'" for a subcategory, or "General (<name>)" for a top-level category. Below the tree is the Revenue account for damage row, with the same "General" default.
Revenue account on the product — overrides the category for that one product. See Managing products → Bookkeeping.
If a chosen revenue account no longer exists in MoneyBird, or is no longer active, Rentstuff does not book the invoice — same principle as a missing VAT rate below. The message on the invoice names the account and where the mapping comes from, for example "Failed: Revenue account '1234567' for product 'Portofoon Motorola DP4400' no longer exists in MoneyBird — update the mapping." Fix the mapping (product, category or general) and then choose Opnieuw naar MoneyBird (send to MoneyBird again) on the invoice.
What happens to invoices already in MoneyBird
The choice applies to invoices you send after saving. Invoices already in MoneyBird stay as they are and are not offered again. Credit notes follow the same choice: with External invoice, a credit note becomes an external invoice with negative lines.
If uploading the PDF fails once (for example because MoneyBird is briefly unreachable), the invoice is already booked. Rentstuff retries only the PDF later, during the daily check. The invoice itself is never booked twice. If MoneyBird refuses the PDF for good (for example because the file is too large, or because the invoice was deleted in MoneyBird), Rentstuff stops trying. With Opnieuw naar MoneyBird (send to MoneyBird again) on the invoice you retry only the PDF, for example after correcting the administration.
VAT rates in MoneyBird
Rentstuff calculates VAT per rate over the invoice total and rounds once, just like MoneyBird (see Invoices & Payments). Two lines of € 12.50 at 21% give € 5.25 VAT in both.
For each line, Rentstuff picks the MoneyBird sales rate with the same percentage as the VAT category. But MoneyBird often has several rates with the same percentage, such as 0% btw and btw verlegd (reverse charge). After a successful connection test, the screen therefore shows, per VAT category, which MoneyBird rates fit:
- Automatic — the MoneyBird rate with that percentage, if there is exactly one.
- If a category shows a warning (MoneyBird has several 0% rates), pick the right rate yourself and save. Rentstuff does not guess: without a choice an invoice with such a line does not go to MoneyBird ("Niet gelukt: Er zijn meerdere MoneyBird-tarieven van 0% — koppel het juiste bij Instellingen → Koppelingen.", there are several 0% rates in MoneyBird — map the right one). With the wrong choice the revenue ends up in the wrong box of the VAT return (for example reverse charge instead of exempt). A line of € 0 does not block the invoice.
- If it says No MoneyBird rate of …%, add that rate in MoneyBird before you send invoices.
A mapping only applies to a rate with the same percentage. Invoices from before this setting are matched on percentage.
If a line has no MoneyBird rate with the same percentage, or Rentstuff cannot fetch the VAT rates from MoneyBird at that moment, Rentstuff does not book the invoice: better no invoice in MoneyBird than one with a different VAT amount. The reason is shown on the invoice, for example "Niet gelukt: Geen MoneyBird-btw-tarief van 9% — koppel het bij Instellingen → Koppelingen." Map the rate and then choose Opnieuw naar MoneyBird (send to MoneyBird again) on the invoice. So check beforehand with Test connection that every VAT category has a rate.
Two categories with the same percentage
If you map two VAT categories with the same percentage to different MoneyBird rates (for example two 21% rates), Rentstuff calculates them together as one group and MoneyBird separately. The VAT amount can then differ by a cent. After booking, Rentstuff compares the totals in MoneyBird (excl., VAT and incl.) with the invoice. A difference is shown as an orange message on the invoice ("Bedrag in MoneyBird wijkt af: …"); the invoice stays linked and is not booked again. So preferably map such categories to the same MoneyBird rate. At 0% it makes no difference.
The same message can appear for invoices from before the VAT change (VAT rounded per line, see Invoices & Payments) and their credit notes: MoneyBird calculates VAT per rate over the total and can then differ by a cent. Rentstuff keeps the invoice amounts; adjust the cent in MoneyBird if needed.
MoneyBird status on the invoice
When the MoneyBird integration is enabled, every invoice shows a MoneyBird line under Invoice details (the messages are in Dutch):
| Message | Meaning |
|---|---|
| Nog niet naar MoneyBird (concept) | Not in MoneyBird yet: the invoice is a draft. It goes to MoneyBird as soon as you send it. |
| Nog niet naar MoneyBird | The invoice was sent while the integration was off. The button Naar MoneyBird sturen (send to MoneyBird) puts it there after all. |
| Wordt naar MoneyBird gestuurd | Being sent: Rentstuff is working on it. Refresh the invoice after a minute. |
| In MoneyBird als verkoopfactuur / als externe factuur | In MoneyBird as a sales invoice / external invoice. Bekijk in MoneyBird opens it there. |
| Niet gelukt: … | Failed: the invoice is not in MoneyBird. The reason follows. |
| In MoneyBird als externe factuur, zonder PDF-bijlage | The invoice is in MoneyBird, but MoneyBird refused the PDF (for example because of a wrong administration). |
| Orange: Bedrag in MoneyBird wijkt af: … | The total in MoneyBird differs by a cent from the invoice, see Two categories with the same percentage. |
In the invoice list, a small orange warning sign after the invoice number shows that sending to MoneyBird failed.
Send to MoneyBird again
With Niet gelukt, with a PDF attachment that failed, and with zonder PDF-bijlage, the invoice shows the button Opnieuw naar MoneyBird (send to MoneyBird again). You only see it if you may edit invoices. Use it once you have fixed the cause, for example:
- after mapping or adding a VAT rate ("Geen MoneyBird-btw-tarief van 9%");
- once MoneyBird is reachable again, or after a new token;
- after correcting the administration or the revenue account.
Rentstuff never books an invoice that it sent to MoneyBird itself twice. If it is already in MoneyBird, the button only retries the PDF attachment. Before every first booking, Rentstuff searches MoneyBird for the invoice number, among the sales invoices and among the customer's external invoices (around the invoice date). If it finds the invoice, it links it instead of creating a new one. So an invoice that the accountant or the old Booqable integration had already booked does not end up in MoneyBird twice either. Rentstuff leaves such a found invoice alone: no PDF attachment and no new registration. What Rentstuff cannot find by invoice number (for example an invoice with a different number in MoneyBird), it cannot recognise.
If creating the invoice ended unclearly (MoneyBird did not respond in time or had an outage), you see "Niet gelukt: Onduidelijk of MoneyBird de factuur heeft aangemaakt …" (unclear whether MoneyBird created the invoice). The next attempt then waits a minute and first searches by invoice number: MoneyBird may have stored the invoice slightly later.
A sent invoice that never went to MoneyBird (Nog niet naar MoneyBird, for example because the integration was off at the time, or an invoice from the old administration) gets the button Naar MoneyBird sturen (send to MoneyBird) in the same place. It works the same way (also only with edit rights), but asks first: "Staat deze factuur al in MoneyBird? Rentstuff zoekt eerst op factuurnummer en koppelt dan in plaats van opnieuw te boeken." (Is this invoice already in MoneyBird? Rentstuff searches by invoice number first and then links instead of booking again.)
Check before booking
Before booking, Rentstuff recalculates what MoneyBird will make of the lines (the amount and VAT per VAT rate) and compares that with the invoice. If it does not match, Rentstuff does not book the invoice. This mainly happens with invoices from the old administration (Booqable) with a 0% line that still has VAT: "Niet gelukt: De btw op deze factuur past niet bij de tarieven in MoneyBird (bv. een geïmporteerde factuur met 0% en toch btw) — boek hem handmatig. MoneyBird zou € 0,00 btw boeken, de factuur heeft € 21,00." (the VAT on this invoice does not fit the rates in MoneyBird — book it manually). Book such an invoice yourself in MoneyBird. Invoices from before the VAT change (VAT rounded per line) may differ by a cent per rate; those are booked as usual.
A credit note only goes to MoneyBird once the invoice it credits is there. Otherwise you see "Niet gelukt: De originele factuur staat nog niet in MoneyBird — stuur die eerst opnieuw." Then first choose Opnieuw naar MoneyBird on the original invoice, and then on the credit note.
Sync settings
- Sync contacts — sends the full customer profile (address, email, VAT number) along when creating a MoneyBird contact.
- Fetch payments — automatically records payments booked in MoneyBird on the matching Rentstuff invoice.
PostNL
For PostNL shipping labels, enter the customer code, customer number and API key in the same screen. You create the API key in Mijn PostNL Zakelijk under My Account → API Management, which gives you two keys: one for the sandbox and one for production. See also Settings → Integrations for the sandbox toggle (test environment, no real labels) and the optional return label.
- Error about the API key (HTTP 401): check that the key belongs to the selected environment. A sandbox key only works with the sandbox toggle on, a production key only with the toggle off.
- House number required: PostNL needs the street and house number separately. Rentstuff takes the house number from the street field; if there is none, no label is created and you see which address to complete.
- Warning after creating a label: if PostNL does not recognise an address, the label is still created and announced. Check the address before you send the parcel.
- Return label: this is a separate label you put in the parcel. The return period is 35 days and starts when the label is created, not on delivery. Keep this in mind for longer rental periods. If the return label fails, the shipping label stays in place and you get a message about it.