Non tutte le integrazioni avvengono tramite un collegamento API diretto. Per i sistemi che lavorano con lo scambio di file, la PSB offre l'integrazione SFTP. La PSB recupera periodicamente file dal proprio server SFTP (From SFTP) o deposita documenti ricevuti sul proprio server SFTP (To SFTP). Entrambi i flussi vengono configurati tramite hook SFTP.

È possibile creare una connessione SFTP tramite la piattaforma in Connessioni > Nuova connessione generica > SFTP Connector. Le chiavi di connessione generate sono necessarie successivamente per la configurazione dell'hook.

Con From SFTP la PSB recupera periodicamente file dal proprio server SFTP e li elabora come documenti. Utile quando il sistema sorgente esporta file in una cartella su un server SFTP, ad esempio fatture in formato UBL o XML.

From SFTP lavora con cinque cartelle sul server SFTP:

La PSB verifica ogni 15 minuti per impostazione predefinita se ci sono nuovi file nella readDirectory. Questo intervallo è configurabile.

Un hook From SFTP ha la seguente action:

sftp://gebruiker:wachtwoord@host:poort?readDirectory=/upload&pendingDirectory=/pending&duplicateDirectory=/duplicate&successDirectory=/success&errorDirectory=/error#md5-fingerprint

L'hook deve contenere anche un publishTopic che indica come devono essere elaborati i file recuperati, ad esempio SendInvoice per l'invio di fatture.

{
  "action": "sftp://user:pass@sftp.bedrijf.nl:22?readDirectory=/out&pendingDirectory=/out/pending&duplicateDirectory=/out/duplicate&successDirectory=/out/success&errorDirectory=/out/error#aa:bb:cc:dd:ee:ff",
  "topics": [],
  "publishTopics": ["SendInvoice"]
}

Ad ogni ciclo di polling la PSB verifica la readDirectory, sposta i file in pending, li elabora e successivamente li sposta in success o error. I file già elaborati vengono spostati nella duplicateDirectory.

Con To SFTP la PSB deposita automaticamente i documenti ricevuti sul proprio server SFTP. Ideale quando il sistema elabora file da una cartella anziché tramite un webhook API.

Per To SFTP è necessaria solo una inboxDirectory:

{
  "action": "sftp://user:pass@sftp.bedrijf.nl:22?dirs=/inbox#aa:bb:cc:dd:ee:ff",
  "topics": ["InvoiceReceived"]
}

Ogni documento ricevuto viene depositato come file nella inboxDirectory. Opzionalmente è possibile specificare un targetDocumentTypeId per far trasformare automaticamente i documenti in un formato specifico prima del deposito sul server SFTP.

Entrambi i flussi SFTP utilizzano un MD5 fingerprint per la verifica del server. Il fingerprint si trova dopo il simbolo # nell'action dell'hook e garantisce che la PSB si connetta solo al server SFTP corretto. Questo previene attacchi man-in-the-middle.

Il MD5 fingerprint del proprio server SFTP si trova nella configurazione del server o connettendosi tramite un client SFTP. Il formato è una serie di coppie esadecimali separate da due punti, ad esempio aa:bb:cc:dd:ee:ff:00:11:22:33:44:55:66:77:88:99.

Un'organizzazione che invia fatture dal proprio sistema ERP e desidera importare fatture ricevute:

1. Invio (From SFTP): il sistema ERP esporta fatture UBL in /sftp/outbox. La PSB le recupera ogni 15 minuti e le invia tramite Peppol.
2. Ricezione (To SFTP): la PSB deposita le fatture ricevute in /sftp/inbox. Il sistema ERP legge periodicamente la cartella e importa i documenti.

Entrambi i flussi operano indipendentemente l'uno dall'altro e possono essere configurati separatamente.

L'integrazione SFTP viene nella pratica molto utilizzata per collegamenti con Unit4 ERP CR ed ERP7, dove lo scambio file tramite cartella SFTP è il metodo standard per lo scambio di documenti di fatturazione.

Assicurarsi che l'utente SFTP abbia i diritti di scrittura su tutte le cartelle configurate. La PSB deve poter spostare file tra le cartelle. Verificare anche che il firewall del server SFTP consenta connessioni in entrata dagli indirizzi IP di eConnect.

L'intervallo di polling di 15 minuti è quello predefinito. Se è necessario un intervallo più breve o più lungo, contattare TechSupport.

Desidera saperne di più sullo scambio documenti tramite la PSB? Consultare la panoramica della consegna multi-channel o leggere come configurare i webhook per notifiche in tempo reale.