Una delle caratteristiche più potenti della PSB è la consegna multi-channel: tramite un'unica integrazione API si raggiungono destinatari su Peppol, altre reti di procurement e via e-mail. La PSB sceglie automaticamente il canale migliore, ma è possibile gestire il routing anche manualmente.

Di default la PSB instrada tutte le fatture tramite Peppol. Il sistema verifica se il destinatario è registrato su Peppol e invia la fattura tramite la rete Peppol. Se il destinatario non è su Peppol, entra in funzione il fallback.

Configurando più hook con topic Send*, si possono attivare canali aggiuntivi:

La PSB seleziona il canale in base a un ordine di priorità:

1. Hook a livello di PartyId hanno precedenza sugli hook a livello di environment; se per un destinatario specifico è stato configurato un canale, viene sempre utilizzato quello
2. Topic specifici hanno precedenza sui wildcard; un hook per InvoiceSent ha precedenza su un hook wildcard
3. Se più hook con filtri corrispondono allo stesso topic: vince il filtro più lungo (per numero di caratteri) -- ad esempio, un filtro con una clausola && aggiuntiva vince su un filtro più corto senza quella clausola
4. A parità di priorità: hook-id come criterio di spareggio (alfanumerico -- gli ID interi precedono il testo, ad esempio: 1 < 02 < 10 < dico < peppol)

Prima di inviare una fattura, è possibile verificare tramite queryRecipientParty quale canale verrà utilizzato dalla PSB. Esistono due endpoint, uno per tipo di documento:

POST /api/v1/{partyId}/salesInvoice/queryRecipientParty
POST /api/v1/{partyId}/purchaseOrder/queryRecipientParty

Il corpo accetta un semplice array ["0106:12345678"] o un oggetto con attributi meta { "partyIds": [...], "metaAttributes": {...} }. Parametri di query opzionali: ?preferredDocumentTypeId, ?includeOptions, ?documentFamily (solo nella variante purchaseOrder).

La risposta mostra il canale selezionato e le alternative disponibili. Regola di validazione: nella stessa chiamata queryRecipientParty può essere incluso al massimo un identificatore per schema/codice agenzia (es. 0106, 0190, 0208, 9944). Più identificatori in schemi diversi nella stessa chiamata sono consentiti. In caso di violazione, la PSB risponde con EConnect.Psb.Models.EConnectException: 'Duplicate id agencies {code} requested.' dove {code} è il codice agenzia senza zero iniziale (schema 0208 → 208). Per testare più candidati all'interno dello stesso schema, effettuare chiamate API separate -- una per candidato. Per ricerche avanzate incluse URL dell'Access Point e certificato, utilizzare l'endpoint Peppol: GET /api/v1/peppol/deliveryOption?partyIds=...&documentFamily=...&isCredit=...&documentTypeIds=...&preferredDocumentTypeId=... La risposta contiene partyId, documentTypeId, processId, protocol (As2/As4), url e certificate.

In alcuni casi si desidera sovrascrivere la selezione automatica del canale. Questo è possibile con il parametro query ?channel={hookId} negli endpoint di invio:

POST /api/v1/{partyId}/salesInvoice/send?channel=hook-123-abc

Questo forza la PSB a utilizzare il canale (hook) specifico, indipendentemente dalla selezione automatica.

eConnect trasforma automaticamente le fatture UBL nel formato cXML previsto da Coupa. Il collegamento richiede:

1. Il cliente crea gli account sull'ambiente test e live di Coupa CSP
2. La parte ricevente crea un Shared Secret
3. TechSupport configura la connessione nella PSB

Il collegamento Ariba funziona con relazioni commerciali 1-a-1, diversamente dalla rete aperta Peppol:

1. Il fornitore condivide il proprio AN-ID con l'acquirente
2. SAP può richiedere un abbonamento a pagamento per volumi più alti
3. L'ambiente di test utilizza un AN-ID con suffisso "-T"

eConnect trasforma una fattura UBL in cXML e la consegna al destinatario Ariba, allo stesso modo della trasformazione Coupa descritta sopra. Il processo di onboarding si svolge come segue:

1. Ci si registra presso il SAP Business Network.
2. Ci si accorda con il destinatario su come desidera ricevere il cXML e si compila di conseguenza il modulo di onboarding eConnect.
3. Sulla base del modulo, eConnect stabilisce la connessione con il destinatario, prima tramite la rete di test, poi in produzione. Soglia di abbonamento SAP: per l'invio/la ricezione automatizzati di cXML tramite il proprio pacchetto ERP (tramite eConnect) è richiesto un livello minimo di abbonamento SAP Silver (Enterprise). Questo livello copre volumi da 25 a 99 documenti all'anno.

La PSB converte automaticamente tra tutti i formati di e-fattura comuni. Se si invia una fattura in formato NLCIUS ma il destinatario si aspetta XRechnung, la PSB trasforma automaticamente il documento. Questo funziona per tutti gli standard supportati: BIS Billing, NLCIUS, PINT-SG (le altre varianti PINT sono in roadmap), XRechnung, Svefaktura, ebInterface, DICO, SETU e altri.

La trasformazione è disponibile a partire dal pacchetto 10K.

La PSB supporta la trasformazione in entrambe le direzioni tra SI 2.0 e SALES005:

• SI 2.0 → SALES005
• SALES005 → SI 2.0

Importante: le fatture SALES005 non possono essere inviate tramite Peppol. L’invio di SALES005 richiede una connessione e-mail. La consegna multi-channel gestisce questo: si invia principalmente tramite Peppol, con fallback automatico all’e-mail quando necessario.

Quando si invia tramite e-mail, SFTP o endpoint HTTPS, è possibile specificare un targetFormat. La PSB trasforma quindi la fattura al volo nel formato richiesto. Un cliente che desidera convertire una fattura UBL in SALES005 fornisce un targetDocumentTypeId al momento del download o dell’invio -- la fattura viene trasformata automaticamente.

Peppol non supporta targetFormat (SALES005 non è consentito via Peppol). Su tutti gli altri canali -- e-mail, SFTP, HTTPS -- targetFormat è disponibile.

La consegna multi-channel non è inclusa di default nel servizio base e deve essere acquistata separatamente come servizio/configurazione autonomo. Contattare TechSupport per le opzioni disponibili nella propria situazione.

Una grande azienda invia fatture a:

• Clienti olandesi: Peppol (automatico)
• Aziende del settore edile: DICO (hook specifico per partyId)
• Una multinazionale su un'altra rete: hook specifico per la rete
• Piccoli fornitori senza rete: fallback e-mail

Tutte le fatture vengono inviate tramite la stessa API (POST /api/v1/{partyId}/salesInvoice/send). La PSB gestisce per ogni fattura il routing corretto, il formato corretto e il canale corretto.

Serve assistenza per configurare la consegna multi-channel? Contattare TechSupport.