Panoramica della Procurement Service Bus (PSB) API di eConnect: architettura, funzionalità e tipi di documenti.
La Procurement Service Bus (PSB) è il gateway API centrale di eConnect che consente di inviare, ricevere ed elaborare fatture elettroniche, ordini e altri documenti elettronici. La PSB collega il Suo software alla rete Peppol e ad altre reti di fatturazione elettronica tramite una moderna REST API protetta con OAuth2.
Che Lei sia un fornitore di software che desidera integrare la fatturazione elettronica, o un'organizzazione che vuole automatizzare i flussi documentali, la PSB offre l'infrastruttura per farlo in modo affidabile e scalabile.
La PSB è più di un semplice canale di invio. È una piattaforma completa per l'elaborazione di documenti elettronici, con funzionalità che coprono l'intero ciclo purchase-to-pay.
La fatturazione elettronica è il cuore del servizio. Tramite l'API può inviare fatture di vendita ai destinatari sulla rete Peppol e ricevere fatture d'acquisto dai fornitori. La PSB instrada automaticamente i documenti verso l'Access Point corretto e conferma la consegna con aggiornamenti di stato in tempo reale.
L'e-ordering va oltre la fatturazione. La PSB supporta l'invio e la ricezione di ordini, conferme d'ordine, modifiche e annullamenti. Per impostazione predefinita sono supportati solo gli ordini Peppol (Order Only e Advanced Ordering); i messaggi DICO (incluso il messaggio di manutenzione) sono disponibili dove applicabile e gli ordini Coupa (cXML) su richiesta. L'order-flip (conversione di un ordine in fattura con una singola azione) non è una funzione PSB; è disponibile esclusivamente sulla piattaforma Collabrr.
Il self-billing consente di creare e inviare fatture per conto di un fornitore. Questo è rilevante per le organizzazioni che emettono fatture d'acquisto sulla base di beni o servizi ricevuti.
La validazione offre un endpoint standalone con cui è possibile verificare la correttezza dei documenti XML senza inviarli. La Validate API riconosce automaticamente il formato del documento, lo testa rispetto agli artefatti più recenti e fornisce feedback dettagliato e multilingue per ogni regola di validazione.
La trasformazione converte i documenti da un formato di fatturazione elettronica a un altro. Il documento viene fornito nel formato prodotto dal proprio software e la PSB si occupa automaticamente della conversione verso il formato atteso dal destinatario. La PSB supporta più di 20 standard, tra cui UBL 2.1, NLCIUS, Peppol BIS Billing V3, PINT, CII, XRechnung, Factur-X/ZUGFeRD, FatturaPA, ebInterface, Svefaktura, e-FFF, OIOUBL, Finvoice, ISDOC e formati di settore come DICO, SETU e SEEF. Il formato viene rilevato automaticamente al momento dell'upload; non è necessario specificare quale formato si sta fornendo.
Validated Party Data (VPD) è un'API GraphQL che consente di interrogare e verificare i dati delle parti. Può controllare se un numero di Camera di Commercio, OIN o partita IVA corrisponde effettivamente a una determinata organizzazione, prima di inviare una fattura. In Control, la stessa funzionalità è nota con il nome commerciale Purple Pages.
Intelligent Document Recognition (IDR) converte le fatture PDF in XML strutturato tramite OCR e AI. L'IDR è controllabile direttamente tramite la PSB API, con livelli di qualità e priorità configurabili.
La PSB è costruita sul modello Actor in un cluster Microsoft Azure Service Fabric. Sebbene possa sembrare tecnico, i vantaggi sono concreti: i documenti vengono elaborati in parallelo su più server, senza attese reciproche. In caso di guasto di un server, l'elaborazione continua automaticamente su un altro nodo, senza perdita di dati.
In pratica, questo significa un tempo di elaborazione inferiore a 100 millisecondi per documento all'invio, una capacità comprovata di 200.000 messaggi all'ora e un uptime del 99,99% (oltre otto anni senza interruzioni non pianificate).
La PSB opera come Peppol Access Point con più Access Point nella configurazione standard. Il volume viene distribuito dinamicamente tramite code affidabili. Ogni tenant è logicamente isolato: è tecnicamente impossibile accedere ai documenti di un altro tenant. La PSB viene eseguita su Microsoft Azure (regioni Paesi Bassi e Irlanda); tutto il trattamento dei dati avviene all'interno dell'UE/SEE.
Con una singola integrazione API ottiene accesso a più reti. La PSB instrada automaticamente i documenti verso il canale corretto in base al destinatario.
La PSB è preparata per la direttiva europea ViDA (VAT in the Digital Age), che dal 1° luglio 2030 rende obbligatori i Digital Reporting Requirements (DRR) per le transazioni B2B transfrontaliere. All'invio di una fattura, la PSB genera automaticamente il riepilogo DRR sulla base dei dati della fattura e lo trasmette all'autorità fiscale competente. Come integratore non è necessario fare nulla di aggiuntivo: si invia la fattura tramite la normale API e la PSB si occupa della reportistica.
La PSB implementa a questo scopo il modello Peppol 5-corner, in cui l'Access Point gestisce la reportistica CTC (Continuous Transaction Controls) per conto del mittente. I messaggi di stato, gli evidence file e i messaggi di reportistica CTC sono inclusi nel prezzo del documento, senza costi aggiuntivi per messaggio.
La PSB funziona in modalità event-driven. Invece di effettuare polling periodico per verificare se ci sono nuovi documenti, può configurare dei webhook che notificano direttamente la Sua applicazione in caso di eventi rilevanti: una fattura ricevuta, una fattura consegnata con successo, un errore nell'invio, una Invoice Response dal destinatario.
Gli hook supportano più tipi di azione: webhook HTTPS, notifiche e-mail, push SFTP e persino elaborazione batch in cui i documenti vengono offerti periodicamente come archivio ZIP. Ogni tipo di hook è protetto con firme HMAC SHA256.
La PSB utilizza OAuth 2.0 per l'autenticazione, con supporto sia per il flusso Client Credentials che per il flusso Resource Owner Password Credentials. Tutte le comunicazioni avvengono tramite TLS 1.2 o superiore. Gli upload binari vengono automaticamente scansionati per virus e malware, e i documenti XML vengono validati secondo set di regole standard.
Ogni tenant opera in un ambiente logicamente isolato. La PSB elabora documenti per oltre 20.000 organizzazioni.
La PSB REST API (v1) è organizzata attorno ai seguenti gruppi di endpoint:
La documentazione completa degli endpoint con i formati di request e response è disponibile come Swagger UI interattiva. Il file swagger.json corrispondente può essere scaricato per generare codice client.
È pronto per iniziare? Gli articoli seguenti La aiuteranno nei primi passi, dalla richiesta di un account di test alla prima chiamata API.
La PSB offre endpoint per la fatturazione elettronica (invio e ricezione), e-ordering, self-billing, validazione, trasformazione, dati delle parti (VPD) e riconoscimento PDF (IDR). Con una singola integrazione API ottiene accesso a Peppol e ad altre reti di procurement come Coupa, Ariba e Tungsten.
La PSB elabora i documenti in meno di 100 millisecondi in fase di invio, con una capacità comprovata di 200.000 messaggi all'ora. L'uptime è del 99,99%, con oltre otto anni senza interruzioni non pianificate.
La PSB utilizza OAuth 2.0 per l'autenticazione, con supporto sia per il flusso Client Credentials che per il flusso Resource Owner Password Credentials. Tutte le comunicazioni avvengono tramite TLS 1.2 o superiore.
Si fornisce il formato prodotto dal proprio software. La PSB rileva automaticamente il formato del documento e lo trasforma nel formato atteso dal destinatario. Sono supportati più di 20 standard, tra cui UBL, NLCIUS, BIS Billing V3, PINT, CII, XRechnung, Factur-X, FatturaPA e formati di settore come DICO e SETU. Non è necessario preoccuparsi del formato del destinatario.
La PSB è ViDA-ready. All'invio di una fattura, la PSB genera automaticamente il riepilogo DRR (Digital Reporting Requirement) sulla base dei dati della fattura e lo trasmette all'autorità fiscale competente. Come integratore non è necessario fare nulla di aggiuntivo. I messaggi di stato, gli evidence file e i messaggi di reportistica CTC sono inclusi nel prezzo del documento.
Consulti la documentazione API interattiva