Odoo - Geodynamics

Verbind Odoo met GeoDynamics (IntelliTracer), het track & trace en klokplatform: voertuigen worden automatisch in GeoDynamics geplaatst, en afwezigheden die in het veld zijn geregistreerd, stromen rechtstreeks terug naar Odoo Tijd Vrij.

Gebouwd voor Odoo 19.0. Breidt de apps Werknemers, Tijd Vrij en Vloot uit.

Eenmaal instellen, veilig draaien

De integratie houdt Staging en Productie volledig gescheiden, elk met zijn eigen API-adres, toegangstoken en modus. Een enkele instelling bepaalt welke omgeving actief is, zodat er geen risico is dat een staging-instantie per ongeluk productiegegevens of referenties aanraakt.

• Mock- of Live-modus — Mock-modus retourneert realistische voorbeeldreacties voor elke actie, zodat de volledige synchronisatieflow in ontwikkeling kan worden getest zonder ooit de echte GeoDynamics API aan te roepen.
• Testverbinding knop — controleert de verbinding met een echte geauthenticeerde aanvraag en rapporteert in gewone taal of het werkte, en waarom als dat niet het geval was.
• Duidelijke foutmeldingen — ongeldige tokens, ontbrekende machtigingen, verkeerde eindpunten en snelheidslimieten worden allemaal gerapporteerd met een leesbare uitleg in plaats van een ruwe foutcode, inclusief hoe lang te wachten als GeoDynamics om een pauze vraagt.
• Toegangstokens zijn beschermd — opgeslagen als gemaskeerde velden, alleen zichtbaar voor beheerders, en nooit geschreven naar logs of meldingen.

Werknemers, automatisch gesynchroniseerd

Elke werknemer heeft een speciale GeoDynamics-sectie (alleen zichtbaar voor HR-managers) die toont of synchronisatie is ingeschakeld, de gekoppelde externe ID, en de laatste keer dat het succesvol is gesynchroniseerd.

Alleen werknemers die gemarkeerd zijn voor synchronisatie worden ooit naar GeoDynamics gestuurd — naam, code, werk e-mail, telefoon en thuisadres waar beschikbaar. Als er al een overeenkomend persoon in GeoDynamics bestaat, herkent de integratie hen automatisch aan de hand van e-mail of telefoonnummer in plaats van een duplicaat te creëren, en koppelt eenvoudig de twee records samen. Voortaan werkt elke synchronisatie gewoon dat bestaande profiel bij.

Synchronisatie kan op aanvraag plaatsvinden vanuit het bestand van een werknemer, in bulk voor het hele team, of automatisch volgens een schema.

Voertuigen, op dezelfde manier voorzien

Bedrijfsvoertuigen volgen hetzelfde patroon: een inschakelvlag, een externe referentie en een status die je in één oogopslag kunt controleren. Naam, code en kenteken of VIN worden bij de eerste synchronisatie naar GeoDynamics gestuurd en daarna up-to-date gehouden — opnieuw met zowel een handmatige optie per voertuig als een bulk/geplande optie voor de hele vloot. Bestaande voertuigverbindingen worden automatisch bewaard bij upgrades, zodat er niets handmatig opnieuw hoeft te worden gekoppeld.

Afwezigheden, terugstromend naar Odoo

GeoDynamics wordt behandeld als de bron van waarheid voor verlof: afwezigheden die daar zijn geregistreerd worden in Odoo getrokken, nooit andersom.

• Alleen werknemers die zijn ingeschakeld voor synchronisatie en al zijn gekoppeld aan een GeoDynamics-profiel worden opgenomen.
• De integratie kijkt terug over een configureerbaar venster (30 dagen standaard) zodat historische afwezigheden de eerste keer dat het draait worden vastgelegd, niet alleen nieuwe die naar voren komen.
• Een configuratietabel koppelt elke GeoDynamics-afwezigheidscode aan het bijbehorende Odoo-verloftype. Afwezigheden zonder bijpassend type worden overgeslagen en geregistreerd als een waarschuwing in plaats van fouten te veroorzaken, en hetzelfde geldt voor afwezigheden die behoren tot een werknemer die niet kan worden gekoppeld.
• Elke geïmporteerde afwezigheid heeft een verwijzing naar zijn GeoDynamics-record, zodat het opnieuw uitvoeren van de synchronisatie dezelfde verlofperiode bijwerkt in plaats van deze te dupliceren — en als er niets daadwerkelijk is veranderd, wordt er niets aangeraakt, waardoor de prestaties hoog blijven bij herhaalde uitvoeringen.
• Omdat GeoDynamics deze afwezigheden al heeft goedgekeurd, komen ze al gevalideerd in Odoo aan, waardoor de gebruikelijke goedkeuringsstappen worden overgeslagen.
• Duur wordt berekend op basis van de werkelijke werkagenda van elke werknemer, zodat een volledige werkdag altijd telt als een volledige dag vrij — correct omgaand met lunchpauzes, deeltijdschema's en niet-standaard rotaties. Dagen die geen werkdagen zijn voor die werknemer (feestdagen bijvoorbeeld) worden correct geregistreerd als nul uren.

Gebouwd om ongezien en veilig te draaien

Drie geplande taken — één voor werknemers, voertuigen en afwezigheden — draaien standaard elke 15 minuten, waarbij werknemers en voertuigen altijd synchroniseren voordat de afwezigheden worden verwerkt.

Niets draait totdat het opzettelijk wordt ingeschakeld: elke omgeving heeft zijn eigen aan/uit-instelling, en elk van de drie synchronisatietypen heeft daarbovenop zijn eigen schakelaar. Alles wordt vanaf het begin uitgeschakeld geleverd. Handmatige "Synchroniseer nu"-knoppen zijn ook beschikbaar in Instellingen en geven duidelijk aan hoeveel records zijn gesynchroniseerd, hoeveel zijn mislukt en of een synchronisatie is overgeslagen omdat deze was uitgeschakeld.

Volledige zichtbaarheid wanneer er iets moet worden gecontroleerd

Elke synchronisatie schrijft een logregel die vastlegt wat er is gebeurd, in welke richting, welke werknemer, voertuig of verlof het beïnvloedde, en — als er iets misging — waarom, samen met een preview van de verzonden gegevens. Om het overzichtelijk te houden, worden afwezigheden die geen wijzigingen nodig hadden niet individueel gelogd.

Bovendien laat elke geplande run een samenvattingsrecord achter — aangemaakt, bijgewerkt, onveranderd en foutentellingen — zelfs wanneer er niets is veranderd, zodat het altijd mogelijk is om te bevestigen dat een synchronisatie daadwerkelijk heeft plaatsgevonden. Als een individueel record faalt, wordt het gemarkeerd en gaat de rest van de run door in plaats van helemaal te stoppen.

Loggegevens worden gedurende een configureerbare periode bewaard (90 dagen standaard, of onbeperkt indien gewenst) en automatisch opgeschoond.

Toegang, georganiseerd per rol

Twee toegangslevels houden de zaken veilig: een Manager rol met volledige toegang tot de configuratie en gegevens van de integratie, en een alleen-lezen User rol voor dagelijkse zichtbaarheid in logs en instellingen. Toegangstokens zijn alleen zichtbaar voor Managers. Alles bevindt zich onder een speciaal GeoDynamics-menu — logs, synchronisatiegeschiedenis en configuratie — plus een samenvattingspaneel in Algemene Instellingen.

Grondig getest

De integratie wordt gedekt door een geautomatiseerde testsuite die de API-verbinding en de foutafhandeling, het synchroniseren van werknemers en voertuigen (inclusief duplicaatmatching), het synchroniseren van afwezigheid in elke uitkomst (aangemaakt, bijgewerkt, onveranderd, niet-overeenkomend), duurcalculaties over verschillende werkkalenderscenario's en logopschoning omvat.