Koppelen met andere software

Waar we vandaag staan

Je planning kun je in je eigen agenda zetten, en je gegevens kun je als Excel-bestand in en uit de app halen. Een directe koppeling met een boekhoudpakket is er nog niet. We zeggen dat liever hardop dan dat je het na aanmelden ontdekt.

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.

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.