> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.robaws.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Hoe werkt de GeoDynamics integratie?

**GeoDynamics** is een software voor het traceren van voertuigen, materiaal en het registreren van het aantal gewerkte uren van je werknemers. Daarnaast ondersteunt GeoDynamics de CIAW en werfmelding die op een project moet gebeuren.

De **rechtstreekse koppeling** tussen GeoDynamics en Robaws biedt volgende mogelijkheden:

* [Projecten uit Robaws worden als nuttige plaats aangemaakt in GeoDynamics](#2-projecten-aanmaken-als-nuttige-plaatsen-in-geodynamics)
* [CIAW voor een project doorgeven aan GeoDynamics](#2-ciaw-voor-een-project-doorgeven-aan-geodynamics)
* [Nacalculatie importeren uit GeoDynamics](#2-nacalculatie-importeren-uit-geodynamics-naar-robaws)

||| Om gebruik te kunnen maken van de integratie met GeoDynamics, is een specifieke toegang als API gebruiker nodig bij GeoDynamics, die extra kosten met zich meebrengt.

||| Nacalculatie importeren uit GeoDynamics is betalend: je betaalt daarvoor een extra kost per maand. De actuele prijzen vind je op de [prijspagina van Robaws](https://robaws.com/nl-BE/prijs).

## Activeren van de koppeling

Om de koppeling met GeoDynamics te activeren ga je naar **instellingen > integraties > GeoDynamics.**
Om de koppeling te leggen, vul je volgende gegevens in:

| Instelling | Uitleg |
| ---- | ---- |
| Ingeschakeld | Zet de koppeling actief als je deze wenst te gebruiken |
| Bedrijf | Bedrijf die gekend is in GeoDynamics |
| Gebruikersnaam | Gebruikersnaam uit GeoDynamics, dit moet een specifieke API gebruikerslogin zijn. |
| Wachtwoord | Wachtwoord van GeoDynamics |

Deze bovenstaande instellingen zijn noodzakelijk om de koppeling te leggen met de integratie. Daarnaast zijn er nog enkele instellingen waarmee je de koppeling zelf kan instellen.

| Instelling | Uitleg |
| ---- | ---- |
| Projectnaam prefix | Via deze functie kan je bepalen welke prefix meegestuurd wordt naar GeoDynamics. Je kan hier gebruik maken van [vervangingscodes](https://support.robaws.com/nl/article/vervangingscodes-1he52l3/). |
| Project radius (in meter) | Dit is de radius van de geofence van de POI in GeoDynamics. |
| Synchroniseer enkel projecten met datum na | Hier kan je een datum ingeven vanaf wanneer de projecten naar GeoDynamics doorgestuurd mogen worden. Projecten voor deze datum zullen niet doorgestuurd worden. |
| CheckInAtWork notities | Check In At Work in GeoDynamics heeft een veld 'notities'. Via deze instelling kan je bepalen wat er in die notitie komt. Dit kan een vaste tekst zijn, of een tekst die je opmaakt door gebruik te maken van de vervangingscodes. |
| Projecten synchroniseren | Als je deze functie activeert, gaan we de projecten doorsturen naar Geo en worden deze gesynchroniseerd telkens een aanpassing in Robaws op project doorgevoerd werd. |
| CheckInAtWork | De CIAW die op de projecten geactiveerd is, wordt meegegeven naar GeoDynamics. |
| Actieve project statussen | Je kan bepalen welke projecten met welke statussen doorgestuurd worden naar GeoDynamics. Laat je dit leeg, dan worden **alle** projecten doorgestuurd. |
| Nacalculatie importeren | Met deze functie heb je de mogelijkheid om een nacalculatie uit GeoDynamics te importeren als werkbon in Robaws. Dit is een betalende optie. |
| Pause vanuit nacalculatie gebruiken | Als deze functie geactiveerd is, nemen we de pauze over die we binnen krijgen van GeoDynamics. Als deze uitstaat, is de pauze 0. |
| Fallback op kostenplaatscode | We raden aan om dit steeds aan te staan. Dit is een technische instelling. |
| Gebruik tijdsduur | GeoDynamics geeft ons start- en eindtijd en totale duurtijd door via de API. Indien deze functie geactiveerd is, zetten we de duurtijd van GeoDynamics op het aantal uur van de werkbon en de start- en eindtijd van GeoDynamics in de opmerking op de werkbon. Indien deze functie gedeactiveerd is, zetten we het start- en einduur van GeoDynamics op start- en einduur op de werkbon. |

## Projecten aanmaken als nuttige plaatsen in GeoDynamics

Om projecten te kunnen aanmaken als nuttige plaats in GeoDynamics is het belangrijk dat de instelling **'Projecten synchroniseren' **geactiveerd is. 
Je kan via de instellingen **'actieve project statussen' **en **'synchroniseer enkel projecten met datum na'** nog extra filteren op welke projecten specifiek doorgestuurd kunnen worden naar GeoDynamics.

Wanneer worden de projecten aangemaakt? Dit gebeurt op **volgende manieren**:

* Wanneer je een project aanmaakt in Robaws, zal dit project naar Geo doorgestuurd worden en daar aangemaakt worden als nuttige plaats. 
* Wanneer je een bestaand project aanpast in Robaws, zal de info van dit project naar Geo doorgestuurd en aangemaakt worden of aangepast worden als nuttige plaats.

Een nuttige plaats heeft minstens een **straat** en een **stad** nodig. Ontbreekt één van die twee op het projectadres, dan wordt de nuttige plaats niet aangemaakt en krijgt iedereen met beheerdersrechten de melding *'Project ... niet geregistreerd of geüpdatet in GeoDynamics'*, met daarin welk gegeven ontbreekt.

||| Robaws synchroniseert bij **elke wijziging** op het project, ook als het adres nog niet volledig is. Vul je een project pas later verder aan, dan kan je in de tussentijd dus zo'n melding krijgen. Gebruik **'actieve project statussen'** om te vermijden dat projecten die nog in opmaak zijn al doorgestuurd worden.

| Projecten met een datum vóór de datum bij **'synchroniseer enkel projecten met datum na'** worden gewoon overgeslagen. Daarvoor krijg je geen melding.

||| De planningnaam mag maximum 50 karakters bevatten om de nuttige plaats aan te maken in GeoDynamics.

## CIAW voor een project doorgeven aan GeoDynamics

Het project die met GeoDynamics gesynchroniseerd is, kan ook aangemaakt worden als **CIAW werf**.
Om een CIAW-werf aan te maken in GeoDynamics, moet er op het project **in Robaws voldaan zijn aan volgende zaken**:

* Het Werfnr. RSZ correct invullen
* CheckInAtWork staat op 'Ja'

## Nacalculatie importeren uit GeoDynamics naar Robaws

Het is mogelijk om de nacalculatie vanuit GeoDynamics naar Robaws te importeren. Dit wordt in Robaws geregistreerd als een **werkbon**.
Om hiervan gebruik te kunnen maken, doorloop je **eenmalig volgende stappen**:

1. **Neem contact op met GeoDynamics** via servicedesk@geodynamics.be. Vraag dat men de API-user die je reeds gebruikt voor GeoDynamics **voldoende rechten** geeft om de nacalculatie op te vragen. Indien je nog geen API-user hebt, zal men die voorzien.
2. De **kostenplaats van de nacalculatie** in GeoDynamics moet **ingesteld zijn op 'NP Naam'**. Dit kan je doen via config > templates > nacalculatie.
3. **Activeer de instellingen** in Robaws om de nacalculatie te kunnen importeren. Dit kan je doen via instellingen > integraties > GeoDynamics > 'Nacalculatie importeren'. 
4. **Koppel elke werknemer met de correcte GeoDynamics gebruiker**. Dit kan je doen in de werknemersfiche. Klik op het potloodje naast het veld 'GeoDynamics' en zoek de werknemer in jouw GeoDynamics omgeving. Klik daarna bij de juiste werknemer op 'koppelen'. Herhaal dit proces voor alle werknemers waarvoor je de nacalculatie wenst te importeren uit GeoDynamics.

||| Het gebruik van deze functie is betalend, zie de [prijspagina van Robaws](https://robaws.com/nl-BE/prijs).

Het importeren van de nacalculatie vanuit Geo naar Robaws kan op **2 manieren** gebeuren:

1. [Vanuit het overzichtsscherm van de werkbonnen](#6-nacalculatie-importeren-vanuit-werkbonnen)
2. [Vanuit een planningsitem](#6-nacalculatie-importeren-vanuit-planningsitem)

###### Nacalculatie importeren vanuit werkbonnen

Om de nacalculatie vanuit GeoDynamics te importeren vanuit de werkbonnen, **doorloop je volgende stappen**:
* Klik bovenaan in het overzicht van de werkbonnen op de actieknop 'importeren uit GeoDynamics'
* Geef een start- en einddatum in voor de periode van de nacalculatie die je wil importeren
* Filter op werknemers en project die geïmporteerd mogen worden indien van toepassing
* Klik op 'zoeken'

Nadat je bovenstaande stappen doorlopen hebt, krijg je een import voorstel en kan je ervoor kiezen om te importeren.
Van zodra je geïmporteerd hebt, wordt de nacalculatie aangemaakt als een werkbon per project waarop de gegevens uit GeoDynamics geregistreerd staan.

###### Nacalculatie importeren vanuit planningsitem

Om de nacalculatie vanuit GeoDynamics te importeren vanuit een planningsitem, **doorloop je volgende stappen**: 
* Open een planningsitem in de dagplanning
* Klik bovenaan in het planningsitem op de actieknop 'importeren uit GeoDynamics'
* De filters start- en einddatum, werknemers en projecten worden automatisch ingevuld op basis van de info van het planningsitem
* Klik op 'zoeken'

Nadat je bovenstaande stappen doorlopen hebt, krijg je een import voorstel en kan je ervoor kiezen om te importeren.
Van zodra je geïmporteerd hebt, wordt de nacalculatie aangemaakt als een werkbon per project waarop de gegevens uit GeoDynamics geregistreerd staan.

| Komt de info uit GeoDynamics niet binnen in Robaws?  Kijk dan de instellingen in GeoDynamics even na.