Documentation

Connect Cadulis to subcontractors


Empower Your Subcontractors to Operate Efficiently, Without Technical Complexity

Whether your partners use Cadulis or their own system, Cadulis enables you to:

  • Share jobs with subcontractors
  • Schedule directly on their teams
  • Receive their closures, reports, and statuses in real time
  • All this without exposing your users or internal data

This guide explains how to configure a subcontractor webservice, suitable for both an internal subcontractor (multi-BU) and an external company.


Use Case

You want a partner (e.g., a maintenance company) to:

  • Receive jobs to perform
  • Schedule them on their own teams
  • Automatically send back closure information to your environment

All this, without access to your Cadulis interface or integration into your internal organization.


Configuration Steps

1. Access the Configuration

From the side menu:

  1. Click on Settings
  2. Go to Subcontractor Webservices (bottom right)
  3. Click on Create a subcontractor webservice

An intro page reminds you:

  • What the subcontractor can do: receive, schedule, close
  • What you control: configuration, profitability, independence

Click Create a subcontractor webservice to continue.


2. Choose the Connection Type

  • Access type: REST Webservice
  • Select the relevant Business Unit
  • Click Create

3. Configure the Webservice

General Information

  • Name: clear and explicit (e.g., “SAV Nord – provider X”)
  • Description: type of activities, frequency, etc.

Scheduling Assistant (if applicable)

  • Limit simultaneous jobs
  • Maximum allowed value
  • Use relevance (routes, schedules, etc.)
  • Assistant URL: if the subcontractor exposes a planning API

Without Assistant (fallback)

  • Flat travel time
  • Day time range
  • Lunch break (optional)
  • Distance / duration used for optimal choices

Define Authorized Access

Tick only the necessary permissions:

  • Modify or close a job
  • View or edit closure information
  • Create / edit a customer
  • Use the scheduling assistant

These rights define what you authorize and what you will retrieve (reports, closures, etc.)


Skills and Equipment

Add specific resources:

  1. Click on Skills / equipment
  2. Click + to add criteria
  3. Click Validate

This allows Cadulis to avoid proposing jobs to unsuitable subcontractors.


Processing Received Data

In Edit received data, choose:

  • No modification
  • Initialize if empty
  • Replace existing Cadulis data

4. Finalize

  • Click Save
  • The webservice is active

Typical Scenario

  1. You assign a job to a subcontractor
  2. It is sent to their system (REST API or via Cadulis)
  3. They schedule it on their teams
  4. They close the job
  5. You automatically retrieve the report, closure status, etc.

Best Practices

Optimize Your Subcontractor Integrations

  • Create one webservice per subcontractor
  • Use skills / equipment for precise filtering
  • Do not grant more rights than necessary
  • Enable the scheduling assistant only if relevant

Empower Your Subcontractors to Operate Efficiently, Without Technical Complexity

Whether your partners use Cadulis or their own system, Cadulis enables you to:

  • Share jobs with subcontractors
  • Schedule directly on their teams
  • Receive their closures, reports, and statuses in real time
  • All this without exposing your users or internal data

This guide explains how to configure a subcontractor webservice, suitable for both an internal subcontractor (multi-BU) and an external company.


🔄 Bonus: Cadulis ↔ Cadulis Connector

If your subcontractor also uses Cadulis, the connection is even simpler and more powerful:

  • On the subcontractor side, Cadulis exposes an incoming API that allows them to automatically receive assigned jobs
  • On the ordering party side, you use a dedicated outgoing subcontractor API to send jobs, track statuses, and retrieve closures

🎯 Benefits:

  • No specific development required if both parties use Cadulis
  • Native synchronization of jobs, statuses, and reports
  • Security and traceability ensured
  • More resilient than custom API connections
  • Configuration possible on both sides for availability, scheduling, visibility settings, etc.

This connector allows you to link independent organizations, while each party retains control over their environment and users.


Automatic Sending Trigger

To automate the sending of jobs to your subcontractors based on business rules:

  • Failed closure
  • Rescheduling
  • Critical intervention

👉 See the Advanced Triggers guide