Collegare Cadulis a subappaltatori

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