Il software utilizzato non è nell'elenco delle integrazioni preconfigurate, oppure si sta sviluppando un'applicazione che deve inviare e ricevere fatture tramite Peppol? Allora è possibile integrarsi direttamente con la Procurement Service Bus (PSB) di eConnect. La PSB è il sistema tecnico dietro tutte le connessioni eConnect, accessibile tramite psb.econnect.eu. La piattaforma eConnect (platform.econnect.eu) è l'interfaccia cliente dove, tra l'altro, si creano chiavi di connessione e si gestiscono le impostazioni. La PSB offre tre metodi di connessione: una moderna REST API, SFTP e HTTPS.

Il metodo più adatto dipende dall'architettura, dai requisiti di sicurezza e dal volume previsto. Per ciascun metodo, la documentazione tecnica è disponibile sul portale sviluppatori PSB.

Il metodo più utilizzato per le nuove integrazioni. La REST API della PSB offre endpoint per l'invio, la ricezione e la gestione di fatture, ordini e risposte. L'autenticazione avviene tramite OAuth2, con due flussi disponibili: Resource Owner Password Credentials e Client Credentials. I token vengono richiesti tramite POST /connect/token su identity.econnect.eu. Opzionalmente, è possibile includere un header Subscription-Key per l'accesso specifico per organizzazione.

Adatto per: applicazioni SaaS, applicazioni web, microservizi e architetture moderne.

Documentazione: PSB API & Swagger UI: documentazione API interattiva, specifica OpenAPI e Swagger Editor.

Scambio di file tramite una connessione SFTP sicura. La PSB supporta due flussi: From SFTP (recupero periodico di file dal server SFTP dell'utente) e To SFTP (invio di documenti al server dell'utente alla ricezione). Entrambi i flussi vengono configurati tramite hook SFTP nella PSB.

Adatto per: ambienti enterprise con elaborazione batch, sistemi ERP come SAP e Unit4 ERP CR.

Documentazione: PSB API & hooks: cercare SFTP-hooks negli endpoint Hook.

Una connessione HTTPS diretta per lo scambio di fatture. La PSB riceve documenti tramite HTTPS POST e li consegna tramite webhook o HTTPS inbound. Supporta IP-whitelisting e OAuth2.

Adatto per: integrazioni enterprise con requisiti di sicurezza specifici.

Documentazione: PSB API & webhooks: HTTPS inbound/outbound e configurazione webhook.

Tecnico: La PSB comunica internamente tramite il protocollo Peppol AS4 con altri Access Point. Non si tratta di un metodo di connessione che si sceglie come cliente; viene utilizzato automaticamente quando si inviano fatture tramite Peppol.

Per ogni integrazione con la PSB è necessario:

• Un account eConnect con almeno un abbonamento Professional per SFTP e HTTPS (le integrazioni su misura richiedono un abbonamento Enterprise)
• Credenziali OAuth2 (client_id e client_secret) per la REST API della PSB
• Per i protocolli enterprise: una subscription key tramite il reparto commerciale

Il modo più rapido per iniziare è tramite la REST API: aprire psb.econnect.eu, esplorare la Swagger UI e effettuare la prima chiamata API. Ulteriori informazioni nella sezione API & integrazione di questa documentazione.

Per integrazioni SFTP o HTTPS, è necessario contattare il reparto commerciale di eConnect per un colloquio di intake. Durante il colloquio vengono discussi i dettagli tecnici, il volume previsto e i requisiti di sicurezza. Le specifiche tecniche sono disponibili nella documentazione PSB API.

Suggerimento: Si sta costruendo un'integrazione per un pacchetto software utilizzato da più clienti? Si consiglia di contattare il team partner di eConnect. Come partner è possibile costruire l'integrazione una sola volta e renderla disponibile per tutti i clienti.

Pronti a iniziare? Apra la documentazione PSB API o legga la panoramica PSB per maggiori informazioni.