Connessioni software attive e integrazioni
Creare chiavi di connessione in eConnect

Creare chiavi di connessione (App Key e Secret), utilizzare la Connessione Rapida e revocare una connessione.

Per collegare il software contabile con eConnect, sono necessarie chiavi di connessione. Si tratta di una App Key e un Secret con cui il software comunica in modo sicuro con la piattaforma eConnect. Si creano in pochi passaggi.

Cosa sono le chiavi di connessione?

Le chiavi di connessione sono composte da due elementi:

  • App Key (detta anche Consumer Key): il codice identificativo della connessione
  • Secret (detto anche Consumer Secret): la password che protegge la connessione

Insieme formano le credenziali con cui il software può inviare e ricevere fatture tramite eConnect. Si tratti il Secret come una password, non lo si condivida pubblicamente.

Creare le chiavi
  1. Accedere a platform.econnect.eu.
  2. Andare in Il mio ambiente e selezionare l'organizzazione per cui si desidera configurare la connessione.
  3. Navigare verso Connessioni o Collegare software (a seconda della versione dell'abbonamento).
  4. Fare clic su Crea nuova connessione.
  5. Selezionare il pacchetto software dall'elenco.
  6. La piattaforma genera App Key e Secret. Copiarli immediatamente: il Secret viene mostrato una sola volta.

Inserire le chiavi nel software

Dopo la creazione, inserire le chiavi nel pacchetto software. La posizione esatta varia per pacchetto, ma generalmente segue questo schema:

  • Aprire le impostazioni o la configurazione del pacchetto software.
  • Cercare la sezione per e-fatturazione, eConnect o Peppol.
  • Incollare App Key e Secret nei campi previsti.
  • Salvare le impostazioni e testare la connessione.

Per alcuni pacchetti (come tramite Connessione Rapida), è possibile incollare le chiavi con CTRL+V in un'unica operazione nella finestra di connessione.

Connessione Rapida

Con la Connessione Rapida si inseriscono le chiavi in modo accelerato. Invece di copiare App Key e Secret separatamente, si apre una finestra di connessione in cui si incollano entrambe le chiavi contemporaneamente con CTRL+V.

  1. Creare chiavi di connessione (vedi sopra).
  2. Fare clic su Connessione Rapida accanto alla connessione creata.
  3. Si apre una nuova finestra. Premere CTRL+V: le chiavi vengono importate automaticamente.
  4. Selezionare l'amministrazione per cui si desidera recuperare le fatture.
  5. Inserire l'indirizzo e-mail collegato all'amministrazione nel pacchetto software (non l'indirizzo e-mail eConnect).
  6. Impostare facoltativamente una data di inizio.
  7. Scegliere se elaborare anche le fatture di vendita.
  8. Spuntare la conferma e fare clic su Applica.
Software supportato per Connessione Rapida
SoftwareDirezioneBaseconeRicezione (acquisto + vendita)Exact MultiversInvio + RicezioneWhiteVisionRicezione (acquisto + vendita)YukiRicezione (acquisto + vendita)RadarInvio

Suggerimento: l'indirizzo e-mail inserito nella Connessione Rapida deve essere l'indirizzo collegato all'amministrazione nel pacchetto software. Non utilizzare l'indirizzo e-mail dell'account eConnect.

Collegare più organizzazioni

Se si gestiscono più organizzazioni nel proprio ambiente, creare un set di chiavi di connessione separato per ogni organizzazione. L'App Key è unica per combinazione organizzazione-connessione. È possibile utilizzare la stessa chiave API per più organizzazioni all'interno dello stesso pacchetto software, ma l'identificativo specifico dell'organizzazione (come l'eConnect ID) deve essere impostato per ogni organizzazione.

Chiavi perse?

Se si è perso il Secret, non è possibile richiederne uno nuovo; è necessario creare un nuovo set di chiavi di connessione. Le vecchie chiavi diventano invalide. Non dimenticare di aggiornare le nuove chiavi anche nel software.

Sicurezza

Le chiavi di connessione forniscono accesso sicuro alla propria organizzazione eConnect. Tenere presente quanto segue:

  • Condividere le chiavi solo con la persona che configura la connessione.
  • Conservare il Secret in un luogo sicuro (gestore di password).
  • Se si sospetta che le chiavi siano state compromesse, crearne immediatamente di nuove.
Revocare una connessione

Si desidera passare a un altro metodo di connessione o smettere di usare un pacchetto software? Si può revocare la connessione.

  1. Accedere a platform.econnect.eu.
  2. Andare in Connessioni nell'organizzazione interessata.
  3. Fare clic sulla connessione che si desidera revocare.
  4. Fare clic su Revoca chiave.
  5. La connessione è ora inattiva.

Dopo la revoca, è possibile eliminare completamente la connessione: tornare alla panoramica, fare clic sui tre puntini accanto alla connessione revocata e scegliere Elimina connessione.

Revocare la connessione anche nel pacchetto software. Altrimenti il software continuerà a tentare di comunicare tramite le vecchie chiavi.

Ricollegarsi

Si desidera ricollegarsi? Creare un nuovo set di chiavi di connessione. Le vecchie chiavi non funzionano più dopo la revoca.

Attenzione: se si passa all'Autopilot, è necessario prima revocare la vecchia connessione. Due connessioni attive alla stessa amministrazione possono generare conflitti.

Cosa succede alle fatture?

La revoca non influisce sulle fatture già inviate o ricevute. Le nuove fatture non vengono più scambiate tramite la vecchia connessione. Le fatture pronte ma non recuperate possono essere recuperate successivamente ricollegandosi e utilizzando "Riproponi all'API".


Pronto a collegare il software? Scopra quale metodo di integrazione è adatto al Suo pacchetto.

Crei chiavi di connessione