Integrazioni
Introduzione
Retica permette di automatizzare completamente i flussi di lavoro, collegando la piattaforma direttamente ai tuoi server aziendali o ai tuoi software gestionali. Attraverso la sezione Integrazioni puoi configurare due diversi canali di comunicazione per importare i documenti d’origine ed esportare i dati estratti in totale autonomia.
Nel menu laterale, questa sezione si divide in due opzioni principali: Protocollo FTP e Chiavi API.
Protocollo FTP / FTPS / SFTP
Questa integrazione permette di collegare Retica a un server o a un computer remoto per abilitare lo scambio automatico di file, eliminando la necessità di caricare i documenti a mano

A. Configurazione dei parametri di rete
All’interno della pagina troverai due schede speculari che richiedono i dati del tuo server:
- Cartella di import: Il percorso in cui Retica andrà a prelevare i documenti da scansionare.
- Cartella di export: Il percorso in cui Retica depositerà i file di dati elaborati.
Per ciascuna cartella dovrai compilare i seguenti campi obbligatori:
- Host name: L’indirizzo del server (es. ftp.nomedominio.estensione o un IP pubblico).
- Porta: Il canale di comunicazione (es. 21 per FTP standard).
- Percorso: La directory esatta sul server (es. /Root/Documenti).
- Protocollo: Scegli dal menu a tendina tra FTP, FTPS o SFTP a seconda del livello di sicurezza del tuo server.
- Nome utente e Password: Le credenziali di accesso create sul tuo server per Retica.
B. Validazione e salvataggio
- Verifica in tempo reale: Dopo aver inserito i dati e cliccato su “Salva”, il sistema effettua un test di connessione. Se i parametri sono errati, un banner rosso in basso indicherà l’errore; se la connessione riesce, un banner verde confermerà il successo dell’operazione.
- Opzioni Avanzate del Modello: Una volta configurato il server nella sezione Integrazioni, potrai associare i percorsi ai tuoi modelli impostando la frequenza di lettura automatica e decidere se attivare la spunta “Elimina il file dopo l’importazione” per mantenere pulito il tuo spazio FTP.
Chiavi API
- Le chiavi API consentono alle applicazioni esterne (come il tuo software gestionale personalizzato o un CRM) di dialogare e interfacciarsi in modo sicuro con il tuo spazio di lavoro su Retica.
A. Creazione di una nuova chiave
- La piattaforma permette di generare e gestire fino a un massimo di 10 chiavi API contemporaneamente:
- Accedi alla scheda Chiavi API e clicca sul pulsante blu “Crea nuova chiave API” in alto a destra.
- Nel pop-up che compare, inserisci un Nome identificativo per ricordarti a quale software è associata (es. “Chiave Gestionale” o “Chiave API”) e clicca su “Crea chiave”.

B. Sicurezza e archiviazione
Subito dopo la creazione, Retica ti mostrerà una schermata di sicurezza fondamentale contenente la stringa segreta della chiave:
- ⚠️ Attenzione: Questa è l’UNICA volta in cui vedrai questa chiave a schermo. Conservala immediatamente in un posto sicuro, poiché per motivi di privacy il sistema non potrà in alcun modo recuperarla in futuro.
- Per poter chiudere la schermata, dovrai copiare il codice (tramite l’icona di copia rapida) e selezionare obbligatoriamente la casella di controllo: “Ho salvato questa chiave in modo sicuro”. Solo allora potrai cliccare sul pulsante “Vicina” (Chiudi).

C. Monitoraggio e rimozione
All’interno della tabella riepilogativa potrai monitorare l’elenco delle tue chiavi attive, verificando il loro nome, la data di creazione e la data dell’Ultimo utilizzo da parte del tuo software esterno.
Se una chiave non viene più utilizzata o è stata compromessa, puoi rimuoverla all’istante cliccando sull’icona del Cestino Rosso posizionata sulla destra.


