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.

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.

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.

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.

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.

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.

Una delle connessioni create tramite Connessione Rapida si chiama nella piattaforma connettore Email. Attenzione: nonostante il nome, funziona tramite chiavi di connessione e la connessione appartiene a Connessioni -- non viene inviata alcuna email. Non confonderlo con l'Email Receiver: si tratta di un'app con cui si ricevono autonomamente fatture via email sulla piattaforma. Il connettore Email fa l'opposto: reindirizza automaticamente le fatture ricevute tramite eConnect a un indirizzo email a scelta.

Oltre al connettore Email standard, esistono varianti che trasformano il documento ricevuto in un formato specifico (sempre SI 2.0, sempre BIS v3, sempre SI 1.2 o sempre SALES005 Fattura). L'impostazione è la stessa del connettore Email standard; eConnect si occupa della consegna nel formato scelto.

Come destinatario, è possibile creare un connettore Email per far reindirizzare automaticamente le fatture ricevute tramite eConnect a un indirizzo email specificato. Per impostazione predefinita viene inviato solo l'XML -- nessun PDF o altro allegato. Questo comportamento è determinato dal parametro excludeAdditionalAttachments:

• excludeAdditionalAttachments=true (predefinito): gli allegati aggiuntivi come un PDF non vengono inviati.
• excludeAdditionalAttachments=false: il PDF e altri eventuali allegati vengono inviati anch'essi.

Nel connettore Email standard (l'auto-hook Collabrr), questo parametro è impostato su true. Se si desidera ricevere anche il PDF, solo il Techsupport può modificarlo.

Attenzione dopo una modifica del Techsupport: se successivamente il cliente modifica autonomamente il connettore Email, tale modifica sovrascrive automaticamente la modifica del Techsupport. Il PDF verrà quindi nuovamente soppresso e non sarà più incluso. Non modificare il connettore da soli dopo la correzione.

Se invece si utilizza il mailhook nel PSB e si configura il connettore autonomamente, allora è possibile impostare questo parametro da soli -- si tratta di un percorso self-service separato e autonomo.

Questo reindirizzamento è un'alternativa adatta per un destinatario che non è (ancora) su Peppol ma desidera comunque recuperare automaticamente i dati della fattura o il documento PDF.

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.

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.

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.

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.

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.

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.