Koppelingen
Rentstuff kan facturen en klanten automatisch naar MoneyBird pushen (boekhouding) en verzendlabels aanmaken via PostNL. Dit scherm (Instellingen → Koppelingen) is waar je beide instelt.
Beknopt
MoneyBird koppel je met de knop Koppel met MoneyBird: je logt in bij MoneyBird, geeft Rentstuff toestemming en kiest daarna je administratie uit een lijst. Je hoeft geen token te knippen en plakken. Rentstuff vraagt alleen het recht Verkoopfacturen (sales_invoices).
Liever een persoonlijke API-token? Dat kan nog steeds, zie Alternatief: persoonlijke API-token.
Koppelen met MoneyBird
- Ga naar Instellingen → Koppelingen.
- Klik bij MoneyBird op Koppel met MoneyBird. Je gaat naar MoneyBird.
- Log in bij MoneyBird (als dat nog niet zo is) en geef Rentstuff toestemming.
- Je komt vanzelf terug in het Koppelingen-scherm, met de melding Gekoppeld met MoneyBird. De koppeling staat dan aan.
- Kies je administratie uit de lijst. Heb je er maar één, dan staat die al geselecteerd.
- Klik op Opslaan.
Daarna kun je met Test verbinding de btw-tarieven en omzetrekeningen ophalen en koppelen, zie hieronder.
- Opnieuw koppelen — bijvoorbeeld als je een andere MoneyBird-gebruiker wilt gebruiken. Je gekozen administratie en instellingen blijven staan.
- Loskoppelen — Rentstuff trekt de toestemming in bij MoneyBird en zet de koppeling uit. Je instellingen blijven bewaard, zodat je later zonder opnieuw kiezen weer kunt koppelen.
- Trek je de toegang in MoneyBird zelf in, dan meldt Rentstuff bij de volgende factuur of verbindingstest "De koppeling met MoneyBird is ongeldig of ingetrokken … Koppel opnieuw". Klik dan op Opnieuw koppelen.
Die blijft gewoon werken. Klik je op Koppel met MoneyBird, dan vervangt de koppeling de token.
Alternatief: persoonlijke API-token
Zie je de knop Koppel met MoneyBird niet, of wil je liever zelf een token aanmaken? Klik in het Koppelingen-scherm op Liever een persoonlijke API-token? en maak de token zo aan:
- Klik in het Koppelingen-scherm op Open MoneyBird en log in. Je komt op de pagina om een nieuwe applicatie te maken (
moneybird.com/user/applications/new); kies daar een persoonlijke API-token. Via je administratie kan het ook: kies linksboven je administratie en ga naar Instellingen → Externe applicaties → API token aanmaken. - Geef de token een naam, bijvoorbeeld Rentstuff.
- Vink alleen "Verkoopfacturen" aan (
sales_invoicesin de MoneyBird-documentatie). Dit ene recht dekt ook het opzoeken/aanmaken van contacten, het opvragen van btw-tarieven en grootboekrekeningen, en het boeken van externe facturen met bijlage — meer vinkjes zijn niet nodig. - Bevestig en kopieer de gegenereerde token.
Dan staat het formulier op een externe (OAuth-)applicatie. Die heb je niet nodig: dat is voor softwaremakers, en Rentstuff heeft zijn eigen applicatie al bij MoneyBird geregistreerd. Kies de persoonlijke API-token, gebruik Koppel met MoneyBird, of maak de token bij Externe applicaties in de instellingen van je administratie.
MoneyBird toont de token maar één keer. Plak 'm direct in Rentstuff; de token wordt versleuteld opgeslagen en is daarna nergens (ook niet in Rentstuff) nog leesbaar terug te zien.
Token instellen in Rentstuff
- Ga naar Instellingen → Koppelingen.
- Zet MoneyBird inschakelen aan.
- Plak de token in het veld API-token.
- Klik op Test verbinding. Rentstuff test de zojuist geplakte token direct — je hoeft niet eerst op Opslaan te klikken.
- Kies je administratie uit de lijst die verschijnt (zie hieronder).
- Klik op Opslaan om alles in één keer te bewaren.
Administratie kiezen
Na een geslaagde verbindingstest toont het scherm een keuzelijst met de administraties die de token ziet (naam + id), in plaats van het administratie-id met de hand over te typen. Heeft de token toegang tot precies één administratie, dan wordt die automatisch voorgeselecteerd.
- Een al opgeslagen administratie blijft geselecteerd zolang die in de lijst voorkomt.
- Laadt de lijst niet, of wil je het id toch zelf intypen? Gebruik "Id handmatig invoeren" — het vrije tekstveld blijft altijd beschikbaar als terugvaloptie.
- Kies je een administratie uit de lijst, klik dan op Opslaan om zowel de token als de gekozen administratie te bewaren (dat hoeft maar één keer, ook al heb je nog niet eerder opgeslagen).
Verbindingstest
Test verbinding werkt met de token die op dat moment in het tokenveld staat — ook als die nog niet is opgeslagen. Is er ook al een administratie gekozen (uit de lijst of handmatig ingevuld), dan wordt die eveneens meegetest, ook als de keuze nog niet is opgeslagen. Rentstuff doorloopt de volgende stappen:
- Token geldig? Een lege of ongeldige token geeft direct een leesbare foutmelding (en de administratielijst blijft leeg).
- Administraties ophalen — voedt de keuzelijst hierboven.
- Is er al een administratie opgeslagen, dan test Rentstuff ook:
- of de token bij de btw-tarieven van die administratie kan;
- of de token bij de contactenlijst van die administratie kan (zonder een contact aan te maken);
- of de token bij de grootboekrekeningen kan — die lijst verschijnt dan om uit te kiezen (voor de algemene omzetrekening en de koppeling per productcategorie/product, zie Omzetrekening).
Mist de token een recht, dan meldt Rentstuff dat per stap, bijvoorbeeld: "De token werkt, maar mist het recht Verkoopfacturen (sales_invoices) (nodig voor btw-tarieven). Maak een nieuwe token aan met dat vinkje aan." Los dit op door in MoneyBird een nieuwe token met het juiste vinkje aan te maken (zie Alternatief: persoonlijke API-token) en die opnieuw op te slaan.
De verbindingstest maakt nooit een factuur of contact aan in MoneyBird — hij leest alleen.
Wanneer gaat een factuur naar MoneyBird?
Pas als de factuur verstuurd is: met Markeer als verzonden of Stuur per e-mail op de factuur. Dat geldt voor elke factuur — ook een maandfactuur, een schadefactuur en een creditnota — en voor beide keuzes hieronder.
- Een concept blijft helemaal in Rentstuff. Je kunt het nog verwijderen en opnieuw aanmaken; MoneyBird merkt daar niets van.
- Een factuur die al in MoneyBird staat, wordt nooit opnieuw aangeboden, ook niet als je hem nog een keer mailt.
- De koppeling moet aan staan op het moment dat je de factuur verstuurt.
- Bij het versturen wordt de factuurdatum de verzenddatum (de vervaldatum schuift mee met dezelfde termijn). MoneyBird krijgt dus de verzenddatum als factuurdatum, niet de datum waarop het concept is aangemaakt.
Voor deze wijziging ging een factuur al bij het aanmaken naar MoneyBird, dus ook als concept. Zo'n concept staat al in MoneyBird en wordt bij het versturen niet nog eens aangeboden. Verwijder je zo'n concept in Rentstuff, verwijder de factuur dan ook zelf in MoneyBird.
Waar een factuur in MoneyBird staat, zie je op de factuur zelf: zie MoneyBird-status op de factuur.
Verkoopfactuur of externe factuur
Onder Factuur in MoneyBird kies je hoe een Rentstuff-factuur in MoneyBird terechtkomt:
- Verkoopfactuur (standaard) — De factuur komt in MoneyBird als verkoopfactuur. Versturen doe je vanuit Rentstuff. MoneyBird maakt er een eigen verkoopfactuur van, met een eigen factuurnummer; het Rentstuff-factuurnummer staat bij referentie. MoneyBird mailt de klant niet: Rentstuff zet de factuur in MoneyBird op handmatig verstuurd.
- Externe factuur — de factuur uit Rentstuff wordt in MoneyBird geboekt, met de PDF erbij. MoneyBird maakt geen eigen factuur: het boekt de Rentstuff-factuur (factuurnummer, factuurdatum en vervaldatum uit Rentstuff) op het contact van de klant en hangt de Rentstuff-PDF eraan, precies de PDF die de klant krijgt.
In beide gevallen staan aantal, dagen en huurperiode in de regels, bijvoorbeeld Portofoon Motorola DP4400 — 6 st × 5 dagen (28-09-2026 t/m 02-10-2026). MoneyBird rekent met aantal × prijs; bij een dagprijs is het aantal daarom stuks × dagen (hier 30) en de prijs de dagprijs. Regelkorting staat in de omschrijving, en het regelbedrag in MoneyBird is op de cent gelijk aan dat in Rentstuff.
Bij grote aantallen (stuks × dagen boven de 100, vaak bij een maandfactuur, bijvoorbeeld 4 st × 30 dagen met korting) zie je in MoneyBird soms 1 × het regelbedrag in plaats van 120 × de dagprijs. MoneyBird rekent met hooguit een paar decimalen in de prijs; met aantal 1 komt het bedrag precies op de cent uit. Het echte aantal en de dagen staan dan in de omschrijving (4 st × 30 dagen …); de bedragen en de btw kloppen.
Omzet over de huurperiode
Bij huurregels geeft Rentstuff de huurperiode ook door als periode van de regel. MoneyBird spreidt de omzet dan over die periode in de winst-en-verliesrekening: een huur van 28-09-2026 t/m 02-10-2026 telt deels in september en deels in oktober.
- Het is dezelfde periode als in de omschrijving: de eigen periode van de regel, anders die van de factuur. De periode van de factuur ligt vast bij het aanmaken; een latere wijziging van de order verandert hem niet.
- Een maandfactuur spreidt over de gefactureerde maand.
- Een creditnota spreidt (negatief) over de periode van de factuur die hij crediteert.
- Verkoop, diensten (zoals bezorging) en losse regels hebben geen periode; die omzet valt op de factuurdatum.
Omzetrekening
Elke factuurregel boekt in MoneyBird op een omzetrekening. Rentstuff bepaalt die per regel, in deze volgorde:
- de omzetrekening op het product (product bewerken → sectie Boekhouding), als die er is;
- anders de omzetrekening van de productcategorie van het product; heeft een subcategorie zelf geen koppeling, dan die van de bovenliggende categorie (en zo verder omhoog);
- anders de algemene omzetrekening hieronder.
Een doorbelaste schaderegel volgt niet de categorie van het product, maar de aparte instelling Omzetrekening voor schade; staat die leeg, dan geldt ook daar de algemene omzetrekening. Een regel zonder product (een vrije regel op de factuur) krijgt altijd de algemene omzetrekening.
Algemene omzetrekening — de standaardrekening, in te stellen via Test verbinding:
- Klik op Test verbinding. Rentstuff haalt de omzetrekeningen uit MoneyBird op (bij een lange lijst met een zoekveld).
- Kies de algemene omzetrekening en klik op Opslaan.
De algemene omzetrekening geldt voor beide facturatiewijzen. Bij Externe factuur is ze verplicht (zonder rekening kun je niet opslaan); bij Verkoopfactuur is ze optioneel — staat ze leeg, dan stuurt Rentstuff bij een regel zonder product- of categorie-koppeling geen omzetrekening mee en gebruikt MoneyBird zijn eigen standaardrekening.
Omzetrekening per productcategorie — het blok verschijnt, net als de btw-lijst hieronder, pas na een geslaagde Test verbinding (de rekeningenlijst komt uit die test). Het toont de categorieboom (een subcategorie ingesprongen met ›) met per categorie een keuzelijst; de standaardoptie is "Volgt '<bovenliggende categorie>'" voor een subcategorie, of "Algemeen (<naam>)" voor een hoofdcategorie. Onder de boom staat de rij Omzetrekening voor schade, met dezelfde standaardoptie "Algemeen".
Omzetrekening op het product — overschrijft de categorie voor dat ene product. Zie Producten beheren → Boekhouding.
Bestaat een gekozen omzetrekening niet meer in MoneyBird, of is ze niet actief, dan boekt Rentstuff de factuur niet — zelfde principe als bij een ontbrekend btw-tarief hieronder. De melding op de factuur noemt de rekening en waar de koppeling vandaan komt, bijvoorbeeld "Niet gelukt: Omzetrekening '1234567' voor product 'Portofoon Motorola DP4400' bestaat niet meer in MoneyBird — pas de koppeling aan." Pas de koppeling aan (product, categorie of algemeen) en kies daarna op de factuur Opnieuw naar MoneyBird.
Wat er gebeurt met facturen die al in MoneyBird staan
De keuze geldt voor facturen die je na het opslaan verstuurt. Facturen die al in MoneyBird staan, blijven zoals ze zijn en worden niet opnieuw aangeboden. Creditnota's volgen dezelfde keuze: bij Externe factuur wordt een creditnota een externe factuur met negatieve regels.
Lukt het uploaden van de PDF een keer niet (bijvoorbeeld omdat MoneyBird even onbereikbaar is), dan staat de factuur wél al geboekt. Rentstuff probeert alleen de PDF later opnieuw, bij de dagelijkse controle. De factuur zelf wordt nooit dubbel geboekt. Weigert MoneyBird de PDF blijvend (bijvoorbeeld omdat het bestand te groot is, of omdat de factuur in MoneyBird is verwijderd), dan stopt Rentstuff met proberen. Met Opnieuw naar MoneyBird op de factuur probeer je alleen de PDF weer, bijvoorbeeld nadat je de administratie hebt gecorrigeerd.
Btw-tarieven in MoneyBird
Rentstuff rekent de btw per tarief over het totaal van de factuur en rondt één keer af, net als MoneyBird (zie Facturen & betalingen). Twee regels van € 12,50 tegen 21% geven in allebei € 5,25 btw.
Rentstuff kiest per regel het MoneyBird-verkooptarief met hetzelfde percentage als de btw-categorie. Maar MoneyBird heeft vaak meer tarieven met hetzelfde percentage, zoals 0% btw en btw verlegd. Na een geslaagde verbindingstest toont het scherm daarom per btw-categorie welke MoneyBird-tarieven erbij passen:
- Automatisch — het MoneyBird-tarief met dat percentage, als er precies één is.
- Staat er een waarschuwing bij een categorie (MoneyBird heeft meer tarieven van 0%), kies dan zelf het juiste tarief en sla op. Rentstuff raadt niet: zonder keuze gaat een factuur met zo'n regel niet naar MoneyBird ("Niet gelukt: Er zijn meerdere MoneyBird-tarieven van 0% — koppel het juiste bij Instellingen → Koppelingen."). Met de verkeerde keuze komt de omzet in de verkeerde rubriek van de btw-aangifte (bijvoorbeeld btw verlegd in plaats van vrijgesteld). Een regel van € 0 houdt de factuur niet tegen.
- Staat er Geen MoneyBird-tarief van …%, voeg dat tarief dan in MoneyBird toe vóór je facturen verstuurt.
Een koppeling geldt alleen voor een tarief met hetzelfde percentage. Facturen van vóór deze instelling worden op percentage gekoppeld.
Heeft een regel geen MoneyBird-tarief met hetzelfde percentage, of kan Rentstuff de btw-tarieven op dat moment niet uit MoneyBird ophalen, dan boekt Rentstuff de factuur niet: liever geen factuur in MoneyBird dan een factuur met een ander btw-bedrag. De reden staat op de factuur, bijvoorbeeld "Niet gelukt: Geen MoneyBird-btw-tarief van 9% — koppel het bij Instellingen → Koppelingen." Koppel het tarief en kies daarna op de factuur Opnieuw naar MoneyBird. Controleer daarom vooraf met Test verbinding of er bij elke btw-categorie een tarief staat.
Twee categorieën met hetzelfde percentage
Koppel je twee btw-categorieën met hetzelfde percentage aan verschillende MoneyBird-tarieven (bijvoorbeeld twee tarieven van 21%), dan rekent Rentstuff ze samen als één groep en MoneyBird apart. Het btw-bedrag kan dan een cent verschillen. Rentstuff vergelijkt na het boeken de totalen in MoneyBird (excl., btw en incl.) met de factuur. Een verschil staat als oranje melding op de factuur ("Bedrag in MoneyBird wijkt af: …"); de factuur blijft gekoppeld en wordt niet opnieuw geboekt. Koppel zulke categorieën daarom bij voorkeur aan hetzelfde MoneyBird-tarief. Bij 0% maakt het niets uit.
Dezelfde melding kan verschijnen bij facturen van vóór de btw-wijziging (btw per regel afgerond, zie Facturen & betalingen) en bij de creditnota's daarvan: MoneyBird rekent de btw per tarief over het totaal en kan dan een cent afwijken. Rentstuff houdt de bedragen van de factuur aan; pas zo nodig in MoneyBird een cent aan.
MoneyBird-status op de factuur
Staat de MoneyBird-koppeling aan, dan zie je op elke factuur onder Factuurgegevens een regel MoneyBird:
| Melding | Betekenis |
|---|---|
| Nog niet naar MoneyBird (concept) | De factuur is een concept. Hij gaat naar MoneyBird zodra je hem verstuurt. |
| Nog niet naar MoneyBird | De factuur is verstuurd toen de koppeling uit stond. Met de knop Naar MoneyBird sturen zet je hem er alsnog in. |
| Wordt naar MoneyBird gestuurd | Rentstuff is ermee bezig. Ververs de factuur na een minuut. |
| In MoneyBird als verkoopfactuur / als externe factuur | De factuur staat in MoneyBird. Met Bekijk in MoneyBird open je hem daar. |
| Niet gelukt: … | De factuur staat niet in MoneyBird. De reden staat erachter. |
| In MoneyBird als externe factuur, zonder PDF-bijlage | De factuur staat erin, maar MoneyBird weigerde de PDF (bijvoorbeeld door een verkeerde administratie). |
| Oranje: Bedrag in MoneyBird wijkt af: … | Het totaal in MoneyBird verschilt een cent van de factuur, zie Twee categorieën met hetzelfde percentage. |
In de facturenlijst staat een klein oranje waarschuwingsteken achter het factuurnummer als het naar MoneyBird sturen niet gelukt is.
Opnieuw naar MoneyBird
Bij Niet gelukt, bij een PDF-bijlage die niet gelukt is en bij zonder PDF-bijlage staat op de factuur de knop Opnieuw naar MoneyBird. Je ziet hem alleen als je facturen mag bewerken. Gebruik hem als je de oorzaak hebt opgelost, bijvoorbeeld:
- na het koppelen of toevoegen van een btw-tarief ("Geen MoneyBird-btw-tarief van 9%");
- nadat MoneyBird weer bereikbaar is, of na een nieuwe token;
- na het corrigeren van de administratie of de grootboekrekening.
Rentstuff boekt een factuur die het zelf naar MoneyBird stuurde nooit twee keer. Staat hij al in MoneyBird, dan probeert de knop alleen nog de PDF-bijlage. Vóór elke eerste boeking zoekt Rentstuff in MoneyBird op het factuurnummer, bij de verkoopfacturen én bij de externe facturen van de klant (rond de factuurdatum). Vindt het de factuur, dan koppelt het die in plaats van een nieuwe te maken. Zo komt ook een factuur die de boekhouder of de oude Booqable-koppeling al had geboekt er niet dubbel in. Zo'n gevonden factuur laat Rentstuff verder ongemoeid: geen PDF-bijlage en niet opnieuw registreren. Wat Rentstuff niet op factuurnummer kan terugvinden (bijvoorbeeld een factuur die in MoneyBird een ander nummer heeft), kan het niet herkennen.
Liep het aanmaken onduidelijk af (MoneyBird reageerde niet op tijd of gaf een storing), dan zie je "Niet gelukt: Onduidelijk of MoneyBird de factuur heeft aangemaakt …". De volgende poging wacht dan een minuut en zoekt eerst op het factuurnummer: MoneyBird kan de factuur net later hebben vastgelegd.
Een verstuurde factuur die nog nooit naar MoneyBird ging (Nog niet naar MoneyBird, bijvoorbeeld omdat de koppeling toen uit stond, of een factuur uit de oude administratie), krijgt op dezelfde plek de knop Naar MoneyBird sturen. Die werkt hetzelfde (ook alleen met bewerkrecht), maar vraagt eerst: "Staat deze factuur al in MoneyBird? Rentstuff zoekt eerst op factuurnummer en koppelt dan in plaats van opnieuw te boeken."
Controle vóór het boeken
Rentstuff rekent vóór het boeken na wat MoneyBird van de regels maakt (per btw-tarief het bedrag en de btw) en vergelijkt dat met de factuur. Past het niet, dan boekt Rentstuff de factuur niet. Dat gebeurt vooral bij facturen uit de oude administratie (Booqable) met een regel van 0% en toch btw: "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." Boek zo'n factuur zelf in MoneyBird. Facturen van vóór de btw-wijziging (btw per regel afgerond) mogen een cent per tarief afwijken; die worden gewoon geboekt.
Een creditnota gaat pas naar MoneyBird als de factuur die hij crediteert daar al staat. Anders zie je "Niet gelukt: De originele factuur staat nog niet in MoneyBird — stuur die eerst opnieuw." Kies dan eerst op de originele factuur Opnieuw naar MoneyBird, en daarna op de creditnota.
Synchronisatie-instellingen
- Contacten synchroniseren — stuurt het volledige klantprofiel (adres, e-mail, btw-nummer) mee bij het aanmaken van een MoneyBird-contact.
- Betalingen ophalen — registreert betalingen die in MoneyBird zijn geboekt automatisch op de bijbehorende Rentstuff-factuur.
PostNL
Voor verzendlabels via PostNL vul je klantcode, klantnummer en API-key in hetzelfde scherm in. De API-key maak je aan in Mijn PostNL Zakelijk onder Mijn account → API Management. Daar krijg je twee keys: een voor de sandbox en een voor productie. Zie ook Instellingen → Koppelingen voor de sandbox-schakelaar (testomgeving, geen echte labels) en het optionele retourlabel.
- Foutmelding over de API-key (HTTP 401): controleer of de key bij de gekozen omgeving hoort. Een sandbox-key werkt alleen met de sandbox-schakelaar aan, een productie-key alleen met de schakelaar uit.
- Huisnummer verplicht: PostNL heeft straat en huisnummer los nodig. Rentstuff haalt het huisnummer uit het straatveld; staat er geen huisnummer in, dan wordt er geen label gemaakt en zie je welk adres je moet aanvullen.
- Waarschuwing na het aanmaken: kent PostNL een adres niet, dan is het label wel gemaakt en aangemeld. Controleer het adres voordat je het pakket verstuurt.
- Retourlabel: dit is een los label dat je bij het pakket stopt. De retourperiode is 35 dagen en gaat in zodra het label is aangemaakt, dus niet pas bij aflevering. Hou daar rekening mee bij langere huurperiodes. Lukt het retourlabel niet, dan blijft het verzendlabel gewoon staan en krijg je daarvan een melding.