Integrazioni

Introduzione

La sezione Integrazioni permette di collegare Retica ai sistemi aziendali per automatizzare lo scambio di documenti e dati.

Retica mette a disposizione due modalità:

• FTP, FTPS o SFTP: per prelevare automaticamente i documenti da elaborare e depositare i file contenenti i dati estratti.
• API: per collegare direttamente Retica a un gestionale, CRM o altro software aziendale.

Dal menu laterale puoi accedere alle sezioni Protocollo FTP e Chiavi API.

Protocollo FTP / FTPS / SFTP

L’integrazione FTP permette di scambiare automaticamente file tra Retica e un server aziendale, evitando il caricamento e il download manuale dei documenti.

Può essere utilizzata per:

• importare automaticamente i documenti da elaborare;
• esportare i file contenenti i dati estratti;
• gestire separatamente il percorso di importazione e quello di esportazione.

Cartella di importazione

La Cartella di importazione indica il percorso dal quale Retica deve prelevare i documenti da elaborare.

I file presenti nella cartella vengono acquisiti utilizzando il modello e la frequenza configurati nelle impostazioni del modello personalizzato.

Questa modalità è utile quando un gestionale o un altro software deposita automaticamente i documenti sul server aziendale.

Cartella di esportazione

La Cartella di esportazione indica il percorso nel quale Retica deve depositare i dati estratti.

In base alla configurazione scelta, Retica può esportare file in formato XLS, XLSX, CSV, XML o JSON. È inoltre possibile utilizzare un tracciato personalizzato compatibile con il gestionale aziendale.

Le cartelle di importazione ed esportazione possono utilizzare percorsi o configurazioni di connessione differenti.

Configurazione dei parametri di rete

Per configurare una cartella, compila i seguenti campi:

• Hostname: indirizzo del server FTP oppure IP pubblico.
• Porta: porta utilizzata dal server.
• Percorso: cartella dalla quale prelevare o nella quale depositare i file.
• Protocollo: FTP, FTPS oppure SFTP.
• Nome utente: utente autorizzato ad accedere al server.
• Password: password associata all’utente.

Utilizza credenziali con i permessi necessari per leggere o scrivere file nel percorso configurato.

Validazione e salvataggio

Dopo aver inserito i parametri, premi Salva.

Retica verifica automaticamente la connessione:

• un messaggio verde conferma che il collegamento è stato stabilito;
• un messaggio rosso segnala un errore nei parametri o nell’accesso al server.

Se la connessione non riesce, verifica hostname, porta, protocollo, credenziali, percorso e permessi dell’utente.

Associazione della cartella a un modello

La configurazione della connessione non avvia automaticamente l’importazione dei documenti.

Per completare il processo:

1. apri la sezione Modelli personalizzati;
2. seleziona il modello che deve elaborare i documenti;
3. apri le impostazioni avanzate;
4. associa la cartella FTP configurata;
5. imposta la frequenza di lettura automatica;
6. salva le modifiche.

Puoi inoltre attivare l’opzione Elimina il file dopo l’importazione. Quando è abilitata, Retica rimuove dal server il documento già acquisito, evitando che venga elaborato nuovamente.

⚠️ Attiva l’eliminazione solamente dopo aver verificato il corretto funzionamento del flusso e la presenza di eventuali copie di sicurezza.

Chiavi API

• Le API permettono a un software esterno di comunicare direttamente con Retica.

  Possono essere utilizzate, ad esempio, per:

  • inviare documenti da elaborare;
  • recuperare lo stato dell’elaborazione;
  • scaricare i dati estratti;
  • creare o aggiornare clienti, fornitori e articoli;
  • integrare Retica con un gestionale, CRM o applicativo personalizzato.

  La configurazione dell’integrazione deve essere effettuata da uno sviluppatore utilizzando la documentazione tecnica di Retica.

Creare una chiave API

• Per creare una nuova chiave:

  1. apri Integrazioni → Chiavi API;
  2. premi Crea nuova chiave API;
  3. inserisci un nome identificativo;
  4. premi Crea chiave.

  Utilizza un nome che permetta di riconoscere facilmente il software collegato, ad esempio Gestionale produzione oppure Integrazione CRM.

⚠️ È possibile gestire fino a un massimo di 10 chiavi API contemporaneamente.

Copiare e conservare la chiave

Subito dopo la creazione, Retica mostra il codice completo della chiave.

La chiave viene visualizzata una sola volta. Per conservarla:

1. copia il codice tramite l’apposita icona;
2. salvalo in un sistema sicuro;
3. seleziona la conferma Ho salvato questa chiave in modo sicuro;
4. chiudi la finestra.

Dopo la chiusura, la chiave completa non potrà più essere visualizzata o recuperata.