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:
- Click on Settings
- Go to Subcontractor Webservices (bottom right)
- 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
- 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:
- Click on Skills / equipment
- Click + to add criteria
- 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
- You assign a job to a subcontractor
- It is sent to their system (REST API or via Cadulis)
- They schedule it on their teams
- They close the job
- You automatically retrieve the report, closure status, etc.
Best Practices
- 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.
Recommended Next Step
To automate the sending of jobs to your subcontractors based on business rules:
- Failed closure
- Rescheduling
- Critical intervention
👉 See the Advanced Triggers
guide