-- title: "Multi-channel"layout: docstranslationKey: api/geavanceerd/multi-channeldescription: "Configurare più canali di consegna: Peppol, DICO, altre reti di procurement, fallback e-mail e priorità."keywords: - PSB multi-channel - canali multipli API - channel routing PSB - DICO canale PSB - fallback email API - priorità canale configurare - reti procurement integrazione eConnect - conversione UBL a DICO - BREEX ERP multi-channelseo_title: "Multi-channel: configurare più canali di consegna | eConnect"schema_type: HowTolast_updated: 2026-07-19last_reviewed: 2026-06-07show_chat: trueog_image: /images/og/docs-bouwen.png-- ## Domande frequenti::e-accordion-item{value="item-1" header="Come determina la PSB quale canale utilizzare per una fattura?"}La PSB seleziona il canale secondo un ordine di priorità. Gli hook a livello PartyId hanno la precedenza sugli hook a livello di ambiente, e i topic specifici hanno la precedenza sui wildcard. Per impostazione predefinita, la PSB instrada tramite Peppol. Se il destinatario non è su Peppol, entra in gioco il fallback configurato (es. DICO, Coupa o e-mail).::::e-accordion-item{value="item-2" header="Posso sovrascrivere il canale selezionato automaticamente?"}Sì, con il parametro di query ?channel={hookId} sugli endpoint di invio si forza un canale specifico. Questo sovrascrive la selezione automatica del canale. È possibile verificare in anticipo tramite queryRecipientParty quale canale selezionerebbe la PSB e decidere in base a ciò se si desidera sovrascriverlo.::::e-accordion-item{value="item-3" header="Il multi-channel supporta altri tipi di documento oltre alle fatture?"}Sì, il routing multi-channel funziona per tutti i tipi di documento supportati dalla PSB, come note di credito, ordini e risposte agli ordini. Tutti i documenti vengono inviati tramite la stessa API e la PSB gestisce il routing, il formato e il canale corretti per ogni documento.::-- # Configurare la consegna multi-channelUna 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.## Come funziona il multi-channel?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:| Canale | Configurazione | Utilizzo ||--------|---------------|----------|| Peppol | Default, sempre attivo | Route principale per tutti i partecipanti Peppol || DICO | Hook con topic DICO | Fatture del settore edile tramite lo standard di filiera DICO || Altre reti | Hook con configurazione rete | Organizzazioni che ricevono tramite altre reti di procurement come Coupa o Ariba || Fallback e-mail | Hook con topic e-mail | Destinatari non raggiungibili tramite una rete || SFTP | Hook con configurazione SFTP | Sistemi on-premise con trasferimento file || HTTPS | Hook con configurazione HTTPS | Sistemi enterprise con ricezione API diretta || Collabrr | Hook con configurazione Collabrr | Documenti da/verso la piattaforma Collabrr; può includere un'istruzione di invio nella stessa chiamata (es. «invia via Peppol»). Utilizza l'ID Collabrr (-0003:XC...) come identificatore |## Selezione automatica del canaleLa 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 quello2. Topic specifici hanno precedenza sui wildcard; un hook per InvoiceSent ha precedenza su un hook wildcard3. 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 clausola4. 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/queryRecipientPartyPOST /api/v1/{partyId}/purchaseOrder/queryRecipientPartyIl 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.## Forzare un canaleIn 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-abcQuesto forza la PSB a utilizzare il canale (hook) specifico, indipendentemente dalla selezione automatica.## Configurare Coupa e Ariba### CoupaeConnect 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 CSP2. La parte ricevente crea un Shared Secret3. TechSupport configura la connessione nella PSB### Ariba (SAP Business Network)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'acquirente2. SAP può richiedere un abbonamento a pagamento per volumi più alti3. L'ambiente di test utilizza un AN-ID con suffisso "-T"#### Onboarding cXML tramite eConnect 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.## Trasformazione XMLLa 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, XRechnung, Svefaktura, ebInterface, DICO, SETU e altri.La trasformazione è disponibile a partire dal pacchetto 10K.### SI 2.0 e SALES005La 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.### Formato target su tutti i canali tranne PeppolQuando 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.## Disponibilità 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.## Scenario praticoUna 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-mailTutte 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.::e-button{class="mt-4" to="https://psb.econnect.eu" variant="solid" color="accent" target="_blank"}Apri il riferimento API:::::docs-related{title="Correlati"}::docs-related-link{to="/it/docs/sviluppatori/api/hooks/configurare-webhooks" title="Configurare e proteggere i webhooks"}::::docs-related-link{to="/it/docs/sviluppatori/api/fatture/inviare-fattura" title="Inviare una fattura tramite l'API"}::::docs-related-link{to="/it/docs/sviluppatori/api/fondamenti/panoramica-api" title="Panoramica: la Procurement Service Bus (PSB)"}::::docs-related-link{to="/it/docs/sviluppatori/api/hooks/sftp" title="Integrazione SFTP: ricezione e invio di file"}::::docs-related-link{to="/it/docs/conoscenza/formati-di-documenti" title="Formati di documenti: UBL, CII e altro"}::::docs-related-link{to="/it/docs/prodotto/piattaforma/primi-passi/struttura-piattaforma" title="Struttura della piattaforma"}:::::