Documentatie van de software voor beheer, planning en optimalisatie van interventies

Cadulis verbinden met onderaannemers


Geef uw onderaannemers de middelen om efficiënt in te grijpen, zonder technische complexiteit

Of uw partners nu Cadulis gebruiken of hun eigen systeem, Cadulis stelt u in staat om:

  • Interventies te delen met onderaannemers
  • Direct te plannen op hun teams
  • In realtime hun afsluitingen, rapporten en statussen te ontvangen
  • Dit alles zonder uw gebruikers of interne gegevens bloot te stellen

Deze gids legt uit hoe u een onderaannemer-webservice configureert, geschikt voor zowel een interne onderaannemer (multi-BU) als een externe onderneming.


Gebruiksscenario

U wilt dat een partner (bijv. onderhoudsbedrijf):

  • Interventies ontvangt die uitgevoerd moeten worden
  • Deze plant op zijn eigen teams
  • Afsluitinformatie automatisch terugstuurt naar uw omgeving

En dit alles zonder toegang tot uw Cadulis-interface, noch integratie in uw interne organisatie.


Configuratiestappen

1. Toegang tot de configuratie

Via het zijmenu:

  1. Klik op Instellingen
  2. Ga naar Webservices onderaannemers (helemaal rechtsonder)
  3. Klik op Webservice onderaannemer aanmaken

Een introductiepagina herinnert u aan:

  • Wat de onderaannemer kan doen: ontvangen, plannen, afsluiten
  • Wat u beheert: configuratie, rendabiliteit, onafhankelijkheid

Klik op Webservice onderaannemer aanmaken om verder te gaan.


2. Kies het type verbinding

  • Toegangstype: REST Webservice
  • Selecteer de betreffende Business Unit
  • Klik op Aanmaken

3. Webservice instellen

Algemene informatie

  • Naam: duidelijk (bijv. “SAV Noord – leverancier X”)
  • Beschrijving: type activiteiten, frequentie…

Planningsassistent (indien van toepassing)

  • Beperk gelijktijdige interventies
  • Maximaal toegestane waarde
  • Relevantie gebruiken (routes, werktijden, enz.)
  • Assistent-URL: indien de onderaannemer een planning-API aanbiedt

Zonder assistent (fallback)

  • Vaste reistijd
  • Dagelijkse tijdsvenster
  • Lunchpauze (optioneel)
  • Afstand / duur gebruikt voor optimale keuzes

Toegangsrechten definiëren

Vink alleen de benodigde rechten aan:

  • Een interventie wijzigen of afsluiten
  • Informatie over afsluiting bekijken of wijzigen
  • Een klant aanmaken / wijzigen
  • Gebruik van de planningsassistent

Deze rechten bepalen wat u toestaat en wat u terugkrijgt (rapporten, afsluitingen, enz.)


Vaardigheden en materiaal

Voeg specifieke middelen toe:

  1. Klik op Vaardigheden / materiaal
  2. Klik op + om criteria toe te voegen
  3. Klik op Bevestigen

Hierdoor zal Cadulis geen activiteiten voorstellen aan ongeschikte onderaannemers.


Verwerking van ontvangen gegevens

In Ontvangen gegevens wijzigen, kies:

  • Geen wijziging
  • Initialiseren indien leeg
  • Bestaande Cadulis-gegevens vervangen

4. Afronden

  • Klik op Opslaan
  • De webservice is actief

Veelvoorkomend scenario

  1. U wijst een interventie toe aan een onderaannemer
  2. Deze wordt doorgestuurd naar zijn systeem (REST API of via Cadulis)
  3. Hij plant op zijn teams
  4. Hij sluit de interventie af
  5. U ontvangt automatisch rapport, afsluitstatus, enz.

Best practices

Optimaliseer uw onderaannemer-integraties

  • Maak één webservice per onderaannemer
  • Gebruik vaardigheden / materiaal voor een fijne filtering
  • Geef niet meer rechten dan nodig
  • Activeer de planningsassistent alleen indien relevant

Geef uw onderaannemers de middelen om efficiënt in te grijpen, zonder technische complexiteit

Of uw partners nu Cadulis gebruiken of hun eigen systeem, Cadulis stelt u in staat om:

  • Interventies te delen met onderaannemers
  • Direct te plannen op hun teams
  • In realtime hun afsluitingen, rapporten en statussen te ontvangen
  • Dit alles zonder uw gebruikers of interne gegevens bloot te stellen

Deze gids legt uit hoe u een onderaannemer-webservice configureert, geschikt voor zowel een interne onderaannemer (multi-BU) als een externe onderneming.


🔄 Bonus: Cadulis ↔ Cadulis connector

Als uw onderaannemer ook Cadulis gebruikt, is de koppeling nog eenvoudiger en krachtiger:

  • Aan onderaannemerszijde biedt Cadulis een inkomende API waarmee interventies automatisch ontvangen kunnen worden
  • Aan opdrachtgeverszijde gebruikt u een specifieke uitgaande onderaannemer-API om interventies te versturen, statussen te volgen en afsluitingen op te halen

🎯 Voordelen:

  • Geen specifieke ontwikkeling vereist als beide partijen Cadulis gebruiken
  • Native synchronisatie van interventies, statussen en rapporten
  • Beveiliging en traceerbaarheid gegarandeerd
  • Betere robuustheid dan maatwerk-API-koppelingen
  • Configuratie mogelijk aan beide zijden voor beschikbaarheid, planning, zichtbaarheid, enz.

Met deze connector kunt u onafhankelijke organisaties verbinden, terwijl elke partij de controle behoudt over zijn eigen omgeving en gebruikers.


Aanbevolen volgende stap

Automatisch versturen activeren

Om het automatisch versturen van interventies naar uw onderaannemers te automatiseren op basis van bedrijfsregels:

  • Afsluiting mislukt
  • Herplanning
  • Kritieke interventie

👉 Zie de gids Geavanceerde triggers