---

Consentite ai vostri subappaltatori di intervenire in modo efficace, senza complessità tecnica

Che i vostri partner utilizzino Cadulis o il loro proprio sistema, Cadulis vi permette di:

• Condividere interventi con i subappaltatori
• Pianificare direttamente sulle loro squadre
• Ricevere in tempo reale le loro chiusure, rapporti e stati
• Il tutto senza esporre i vostri utenti né i vostri dati interni

Questa guida vi spiega come configurare un webservice subappaltatore, adatto sia a un subappaltatore interno (multi-BU) che a un’azienda esterna.

---

Casi d’uso

Desiderate che un partner (es. società di manutenzione):

• Riceva interventi da eseguire
• Li pianifichi sulle proprie squadre
• Richiami automaticamente le informazioni di chiusura nel vostro ambiente

E tutto ciò senza accesso alla vostra interfaccia Cadulis, né integrazione nella vostra organizzazione interna.

---

Fasi di configurazione

1. Accedere alla configurazione

Dal menu laterale:

1. Cliccate su Impostazioni
2. Accedete a Webservices subappaltatori (in basso a destra)
3. Cliccate su Crea un webservice subappaltatore

Una pagina introduttiva vi ricorda:

• Cosa può fare il subappaltatore: ricevere, pianificare, chiudere
• Cosa controllate voi: configurazione, redditività, indipendenza

Cliccate su Crea un webservice subappaltatore per continuare.

---

2. Scegliere il tipo di connessione

• Tipo di accesso: Webservice REST
• Selezionate la Business Unit interessata
• Cliccate su Crea

---

3. Configurare il webservice

Informazioni generali

• Nome: esplicito (es. “SAV Nord – fornitore X”)
• Descrizione: tipo di attività, frequenza…

---

Assistente di pianificazione (se applicabile)

• Limitare gli interventi simultanei
• Valore massimo consentito
• Utilizzare la pertinenza (tragitti, orari, ecc.)
• URL assistente: se il subappaltatore espone una API di pianificazione

Senza assistente (fallback)

• Durata forfettaria del tragitto
• Fascia oraria giornaliera
• Pausa pranzo (facoltativa)
• Distanza / durata utilizzate per le scelte ottimali

---

Definire gli accessi autorizzati

Selezionate solo i permessi necessari:

• Modificare o chiudere un intervento
• Visualizzare o modificare le informazioni di chiusura
• Creare / modificare un cliente
• Utilizzo dell’assistente di pianificazione

Questi diritti definiscono ciò che autorizzate, e ciò che recupererete (rapporti, chiusure, ecc.)

---

Competenze e materiali

Aggiungete risorse specifiche:

1. Cliccate su Competenze / materiali
2. Cliccate su + per aggiungere i criteri
3. Cliccate su Conferma

Questo permette a Cadulis di non proporre attività ai subappaltatori non idonei.

---

Trattamento dei dati ricevuti

In Modifica dei dati ricevuti, scegliete:

• Nessuna modifica
• Inizializza se vuoto
• Sostituisci i dati Cadulis esistenti

---

4. Finalizzare

• Cliccate su Salva
• Il webservice è attivo

---

Scenario tipico

1. Assegnate un intervento a un subappaltatore
2. Viene trasmesso al suo sistema (API REST o tramite Cadulis)
3. Lo pianifica sulle proprie squadre
4. Chiude l’intervento
5. Recuperate automaticamente rapporto, stato di chiusura, ecc.

---

Buone pratiche

Consentite ai vostri subappaltatori di intervenire in modo efficace, senza complessità tecnica

Che i vostri partner utilizzino Cadulis o il loro proprio sistema, Cadulis vi permette di:

• Condividere interventi con i subappaltatori
• Pianificare direttamente sulle loro squadre
• Ricevere in tempo reale le loro chiusure, rapporti e stati
• Il tutto senza esporre i vostri utenti né i vostri dati interni

Questa guida vi spiega come configurare un webservice subappaltatore, adatto sia a un subappaltatore interno (multi-BU) che a un’azienda esterna.

---

🔄 Bonus: Connettore Cadulis ↔ Cadulis

Se anche il vostro subappaltatore utilizza Cadulis, la connessione è ancora più semplice e potente:

• Lato subappaltatore, Cadulis espone una API in ingresso che permette di ricevere automaticamente gli interventi trasmessi
• Lato committente, utilizzate una API in uscita subappaltatore dedicata per inviare gli interventi, seguire gli stati e recuperare le chiusure

🎯 Vantaggi:

• Nessuno sviluppo specifico richiesto se entrambe le parti utilizzano Cadulis
• Sincronizzazione nativa di interventi, stati e rapporti
• Sicurezza e tracciabilità garantite
• Maggiore resilienza rispetto a connessioni API su misura
• Configurazione possibile su entrambi i lati per impostazioni di disponibilità, pianificazione, visibilità ecc.

Questo connettore vi permette di collegare organizzazioni indipendenti, mantenendo ciascuno il controllo sul proprio ambiente e sui propri utenti.

---

Prossimo passo consigliato

---