Koppelen met andere software

Waar we vandaag staan

Werk je met Moneybird, dan kun je een geaccepteerde offerte als conceptfactuur in je eigen administratie laten zetten. Je planning kun je in je eigen agenda zetten, en je gegevens kun je als Excel-bestand in en uit de app halen. Met andere boekhoudpakketten is er nog geen directe koppeling. We zeggen dat liever hardop dan dat je het na aanmelden ontdekt.

Je offerte als factuur in Moneybird

Accepteert een klant je offerte, dan zetten we de factuur als concept klaar in je Moneybird-administratie. Dezelfde regels, dezelfde aantallen, dezelfde btw-tarieven. Versturen doe je zelf in Moneybird, op het moment dat het werk gedaan is — een offerte accepteren is tenslotte nog geen geleverde inspectie.

De koppeling zit vanaf Solo, omdat hij op offertes werkt.

1. Open NovaDirect in je browser op novadirect.nl. Koppelen gaat via Moneybird zelf, en die omweg eindigt in de browser — niet in de app. Eenmaal gekoppeld werkt het overal, ook in de app.
2. Ga naar Instellingen en kies Koppelingen. Alleen de accounteigenaar ziet dit onderdeel.
3. Klik op Verbinden met Moneybird. Je komt bij Moneybird uit en geeft daar toestemming; daarna sta je weer in NovaDirect.
4. Klaar. Heb je meerdere administraties, kies dan met Andere administratie kiezen in welke de facturen terechtkomen.

Wij vragen alleen het recht om verkoopfacturen en contacten te beheren. Bij je bank, je aangiftes of je uren komen we niet.

Staat je opdrachtgever nog niet in Moneybird, dan maken we hem aan met de gegevens van de offerte. Bestaat hij al — we zoeken op e-mailadres en anders op exacte bedrijfsnaam — dan gebruiken we dat contact.

Wil je niet dat het automatisch gaat, zet dan het vinkje Zet automatisch een conceptfactuur klaar uit. Je kunt het dan per offerte doen met de knop Factuur klaarzetten, die bij een geaccepteerde offerte in de zijbalk staat.

Ging er iets mis — bijvoorbeeld omdat je de toegang in Moneybird had ingetrokken — dan zie je dat bij de offerte staan, met diezelfde knop om het opnieuw te proberen. Er komt nooit een tweede factuur: staat er al een concept voor die offerte, dan blijft het bij die ene.

Loskoppelen doe je in hetzelfde scherm. Het klaarzetten stopt dan direct. De toestemming zelf haal je weg in Moneybird onder Instellingen → Koppelingen; dat kunnen wij niet voor je doen.

Je planning in Google, Outlook of Apple

Je maakt één webadres aan waarop je agenda zich abonneert. Je afspraken uit de planning en je ingeplande inspecties verschijnen dan vanzelf in je agenda, en verschuiven mee als je ze in NovaDirect verzet.

1. Ga naar Instellingen en kies Koppelingen.
2. Klik op Adres voor mijn planning maken. Ben je accounteigenaar, dan kun je ook een adres maken voor de planning van het hele bedrijf.
3. Kopieer het adres dat verschijnt. Je ziet het maar één keer: we bewaren er geen kopie van. Raak je het kwijt, maak dan een nieuw adres aan — het oude vervalt dan meteen.
4. Plak het adres in je agenda. In Google Agenda via Andere agenda's → Via URL toevoegen, in Outlook via Agenda toevoegen → Abonneren via internet, in Apple Agenda via Archief → Nieuw agenda-abonnement.

Het abonnement werkt één kant op: wat je in je agenda wijzigt, verandert niets in NovaDirect. En je agenda bepaalt zelf hoe vaak hij zo'n adres ophaalt — dat kan enkele uren duren. Daar hebben wij geen invloed op, dus reken er niet op dat een afspraak die je net verzette er direct in staat.

Werkt het abonnement? Op dezelfde pagina zie je wanneer je agenda het adres voor het laatst heeft opgehaald. Staat daar dat het nog niet is opgehaald, dan is het abonnement nog niet aangekomen.

Wil je het adres niet meer gebruiken, klik dan op Intrekken. Het stopt dan direct met werken, ook in agenda's waar het al in staat.

Gegevens eruit halen

Ga naar Exports in het menu. Je kiest een periode, eventueel een opdrachtgever, inspecteur of inspectietype, en downloadt een Excel-werkboek. Meetwaarden staan daarin als getal en datums als datum, dus je kunt er direct op filteren en sorteren of er een draaitabel van maken.

Er zijn werkboeken voor je bevindingen, je metingen, je objecten en — op de plannen die dat bevatten — een assetregister, een gebrekenlijst en een managementrapportage over al je inspecties.

Gegevens erin krijgen

Opdrachtgevers, componenten en objecten lees je in bulk in vanuit Excel of CSV. Je koppelt daarbij zelf de kolommen uit jouw bestand aan de velden in NovaDirect, dus je hoeft je export niet eerst om te bouwen. Zie Overstappen vanuit een ander pakket.

Je eigen systeem laten meelezen (API)

Heb je een Solo-abonnement of hoger, dan kun je je gegevens uitlezen met een eigen sleutel. Je haalt er inspecties, opdrachtgevers, planning en offertes mee op — handig als je zelf een overzicht, een dashboard of een koppeling wilt bouwen.

1. Ga naar Instellingen en kies Koppelingen. Alleen de accounteigenaar ziet dit onderdeel: een sleutel geeft toegang tot de gegevens van je hele organisatie.
2. Geef de sleutel een naam waaraan je later herkent waar hij voor is, en vink aan wat hij mag lezen.
3. Kopieer de sleutel. Net als bij het agenda-adres zie je hem maar één keer.

Stuur de sleutel mee als Authorization: Bearer-kop. Een voorbeeld dat controleert of je sleutel werkt:

curl -H "Authorization: Bearer nd_live_..." https://novadirect.nl/api/v1/me

De volledige beschrijving van de API staat op /api/v1/openapi.json. Die kun je in de meeste ontwikkelgereedschappen rechtstreeks inladen.

Drie dingen om te weten voordat je begint:

• Gebruik een sleutel alleen op een server. In een website of app is hij voor iedereen leesbaar. Vermoed je dat een sleutel gelekt is, trek hem dan in — dat werkt direct, en je ziet in het overzicht wanneer hij voor het laatst is gebruikt.
• Bladeren gaat met een cursor, niet met paginanummers. Je krijgt bij elk antwoord een next_cursor terug die je meegeeft bij het volgende verzoek. Met paginanummers zou je records overslaan zodra er tijdens het bladeren iets bijkomt.
• Er geldt een limiet van 120 verzoeken per minuut per sleutel. Zit je eroverheen, dan krijg je een foutmelding met een Retry-After-kop die zegt hoe lang je moet wachten. Haal alleen op wat is gewijzigd met updated_since, dan kom je er zelden aan.

Heb je Team of hoger, dan kun je ook afspraken inplannen vanuit je eigen systeem. Dat is de route waarmee het planningspakket van een opdrachtgever werkorders bij je neerzet: zij bouwen de brug, jij hoeft alleen een sleutel met het recht planning:write aan te maken. Zelf inspecties aanmaken via de API kan nog niet.

Bericht krijgen zodra er iets gebeurt (webhooks)

In plaats van blijven vragen of er al iets nieuws is, kun je NovaDirect een bericht laten sturen naar je eigen systeem. Bijvoorbeeld zodra een inspectie is afgerond of een opdrachtgever een offerte accepteert. Webhooks zitten in Team en hoger.

1. Ga naar Instellingen en kies Koppelingen.
2. Vul bij Nieuwe webhook het https-adres in waar wij naartoe mogen posten.
3. Vink aan waarover je bericht wilt. Standaard staan Inspectie afgerond en Offerte geaccepteerd aan.
4. Bewaar het ondertekengeheim dat verschijnt. Je kunt het later opnieuw opvragen bij de webhook.

Wij sturen een POST met JSON in deze vorm:

{ "id": "…", "type": "inspection.completed", "occurred_at": "2026-09-17T10:00:00.000Z", "data": { … } }

Het data-blok is precies wat de API op dezelfde plek teruggeeft, dus je hoeft maar één vorm te kennen.

Controleer de handtekening

Iedereen kan een bericht naar jouw adres sturen. Daarom ondertekenen wij elk bericht, en hoor je dat te controleren voordat je er iets mee doet. Bij elk verzoek sturen we deze koppen mee:

• X-NovaDirect-Signature — de handtekening, als sha256=…
• X-NovaDirect-Timestamp — het tijdstip van versturen, in seconden
• X-NovaDirect-Event — welke gebeurtenis het is
• X-NovaDirect-Delivery — het nummer van deze bezorging, ook zichtbaar in het bezorglog
• X-NovaDirect-Attempt — de hoeveelste poging dit is

De handtekening is een HMAC-SHA256 over de tekst tijdstempel, een punt, en de ruwe body, met jouw geheim als sleutel. Bereken hem zelf en vergelijk. Weiger een bericht dat ouder is dan vijf minuten, ook als de handtekening klopt: anders kan iemand die een bericht onderschepte het later opnieuw afspelen.

Let op dat je de ruwe body gebruikt, niet de JSON die je framework er al van heeft gemaakt. Eén spatie verschil en de handtekening klopt niet meer.

Wat je moet teruggeven

Antwoord met een statuscode in de 200-reeks zodra je het bericht hebt aangenomen. Doe het zware werk daarna; wij wachten maximaal tien seconden.

• Een 5xx of een time-out proberen we opnieuw, met oplopende tussenpozen tot maximaal een dag. Na zeven pogingen stoppen we.
• Een 4xx proberen we niet opnieuw: die zegt dat je het bericht inhoudelijk afkeurt, en dan verandert herhalen niets. Uitzonderingen zijn 408 en 429 — die lezen we als "nu even niet".
• Een 410 zetten we uit als "dit adres bestaat niet meer"; de webhook gaat dan uit.
• Een omleiding volgen we niet en proberen we niet opnieuw: een adres dat vandaag omleidt, doet dat morgen ook. Geef het juiste adres op.

Gaat er twintig keer op rij iets mis, dan zetten we de webhook uit. Je kunt hem weer aanzetten in hetzelfde scherm.

Zakt je abonnement terug naar een plan zonder webhooks, dan stoppen de berichten. Je endpoints blijven staan en werken weer zodra je upgradet.

Wij kunnen hetzelfde bericht in zeldzame gevallen twee keer bezorgen. Gebruik daarom het id uit de body om te onthouden wat je al hebt verwerkt.

Uitproberen en nakijken

Met Test sturen zet je een testbericht in de rij. Dat gaat langs precies dezelfde weg als een echte gebeurtenis, dus als de test aankomt, komt de rest ook aan.

Onder Bezorglog zie je per bericht wat er is gebeurd: de status, het antwoord van je server, hoe lang het duurde en de hoeveelste poging het was. Een mislukte bezorging kun je daar met één klik opnieuw in de rij zetten — handig als je server eruit lag en je niet op de volgende gebeurtenis wilt wachten.

Bepaal mee wat we als eerste bouwen

We bouwen koppelingen met boekhoud- en agendapakketten. Welke als eerste komt, bepalen de inspecteurs die ons vertellen wat ze gebruiken — wij hebben geen andere manier om dat te weten.

1. Ga naar Instellingen en kies Koppelingen.
2. Zoek het pakket dat je gebruikt in de lijst.
3. Klik op Ik gebruik dit.

Meer hoef je niet te doen; je hoeft ons niets te mailen en er komt niemand bellen. Staat jouw pakket er niet bij, gebruik dan Feedback geven in het menu, dan zetten we het erbij zodat anderen het ook kunnen aanvinken.

De lijst staat ook openbaar op de koppelingenpagina, met per pakket of het al beschikbaar is.

Wat "nog niet beschikbaar" betekent

Alles in de lijst draagt een label. Staat er Nog niet beschikbaar, dan kun je het niet aanzetten en beloven we ook geen datum. Pas als er Beschikbaar staat, staat er in hetzelfde scherm een knop om de koppeling in te schakelen.