Configurer plusieurs canaux de livraison : Peppol, DICO, autres réseaux de procurement, fallback e-mail et priorités.
La PSB sélectionne le canal selon un ordre de priorité. Les hooks PartyId ont la priorité sur les hooks d'environnement, et les topics spécifiques ont la priorité sur les wildcards. Par défaut, la PSB route via Peppol. Si le destinataire n'est pas sur Peppol, le fallback configuré prend le relais (ex. DICO, Coupa ou e-mail).
Oui, avec le paramètre de requête ?channel={hookId} sur les endpoints d'envoi, vous forcez un canal spécifique. Cela remplace la sélection automatique de canal. Vous pouvez vérifier à l'avance via queryRecipientParty quel canal la PSB sélectionnerait et décider sur cette base si vous souhaitez remplacer.
Oui, le routage multi-channel fonctionne pour tous les types de documents pris en charge par la PSB, tels que les avoirs, les commandes et les réponses à des commandes. Tous les documents sont envoyés via la même API et la PSB gère le routage, le format et le canal corrects pour chaque document.
L'une des fonctionnalités les plus puissantes du PSB est la livraison multi-channel : via une seule intégration API, vous atteignez vos destinataires sur Peppol, d'autres réseaux de procurement et par e-mail. Le PSB choisit automatiquement le meilleur canal, mais vous pouvez également contrôler le routage vous-même.
Par défaut, le PSB achemine toutes les factures via Peppol. Le système vérifie si le destinataire est enregistré sur Peppol et envoie la facture via le réseau Peppol. Si le destinataire n'est pas enregistré sur Peppol, le fallback entre en action.
En configurant plusieurs hooks avec des topics Send*, vous pouvez activer des canaux supplémentaires :
-0003:XC...) comme identifiantLe PSB sélectionne le canal selon un ordre de priorité :
InvoiceSent a la priorité sur un hook wildcard&& supplémentaire gagne sur un filtre plus court sans cette clause1 < 02 < 10 < dico < peppol)Avant d'envoyer une facture, vous pouvez vérifier via queryRecipientParty quel canal le PSB utilisera. Il existe deux endpoints, un par type de document :
POST /api/v1/{partyId}/salesInvoice/queryRecipientParty
POST /api/v1/{partyId}/purchaseOrder/queryRecipientParty
Le corps accepte un tableau simple ["0106:12345678"] ou un objet avec des attributs méta { "partyIds": [...], "metaAttributes": {...} }. Paramètres de requête facultatifs : ?preferredDocumentTypeId, ?includeOptions, ?documentFamily (variante purchaseOrder uniquement).
La réponse affiche le canal sélectionné et les alternatives disponibles.
Dans le même appel queryRecipientParty, au plus un identifiant par schéma/code d’agence (par ex. 0106, 0190, 0208, 9944) peut être inclus. Plusieurs identifiants dans des schémas différents dans le même appel sont autorisés.
En cas de violation, le PSB répond par :
EConnect.Psb.Models.EConnectException: 'Duplicate id agencies {code} requested.'
où {code} est le code d’agence sans zéro de tête (schéma 0208 → 208). Pour tester plusieurs candidats dans le même schéma, effectuez des appels API séparés -- un par candidat.
Pour des recherches avancées incluant l’URL de l’Access Point et le certificat, utilisez l’endpoint Peppol :
GET /api/v1/peppol/deliveryOption?partyIds=...&documentFamily=...&isCredit=...&documentTypeIds=...&preferredDocumentTypeId=...
La réponse contient partyId, documentTypeId, processId, protocol (As2/As4), url et certificate.
Dans certains cas, vous souhaitez outrepasser la sélection automatique du canal. Cela est possible avec le paramètre de requête ?channel={hookId} sur les endpoints d'envoi :
POST /api/v1/{partyId}/salesInvoice/send?channel=hook-123-abc
Cela force le PSB à utiliser le canal (hook) spécifié, indépendamment de la sélection automatique.
eConnect transforme automatiquement les factures UBL au format cXML attendu par Coupa. La connexion requiert :
La connexion Ariba fonctionne avec des relations commerciales 1-à-1, contrairement au réseau ouvert Peppol :
eConnect transforme une facture UBL en cXML et la livre au destinataire Ariba, de la même manière que pour la transformation Coupa ci-dessus. Le processus d'onboarding se déroule comme suit :
Seuil d'abonnement SAP : pour l'envoi/la réception automatisé(e) de cXML via votre propre ERP (via eConnect), un niveau d'abonnement SAP minimum Silver (Enterprise) est requis. Ce niveau couvre des volumes de 25 à 99 documents par an.
Le PSB convertit automatiquement entre tous les formats courants de facturation électronique. Si vous envoyez une facture au format NLCIUS mais que le destinataire attend du XRechnung, le PSB transforme automatiquement le document. Cela fonctionne pour toutes les normes supportées : BIS Billing, NLCIUS, PINT, XRechnung, Svefaktura, ebInterface, DICO, SETU et plus encore.
La transformation est disponible à partir du forfait 10K.
La PSB supporte la transformation dans les deux sens entre SI 2.0 et SALES005 :
Important : les factures SALES005 ne doivent pas être envoyées via Peppol. L'envoi de SALES005 nécessite une connexion e-mail. La livraison multi-channel gère cela : vous envoyez en priorité via Peppol, avec bascule automatique vers l'e-mail si nécessaire.
Lors de l'envoi via e-mail, SFTP ou endpoint HTTPS, vous pouvez indiquer un targetFormat. La PSB transforme alors la facture à la volée dans le format souhaité. Un client qui souhaite convertir une facture UBL en SALES005 fournit un targetDocumentTypeId lors du téléchargement ou de l'envoi -- la facture est alors automatiquement transformée.
Peppol ne supporte pas le targetFormat (SALES005 n'est pas autorisé via Peppol). Sur tous les autres canaux -- e-mail, SFTP, HTTPS -- le targetFormat est disponible.
La livraison multi-channel n’est pas incluse par défaut dans le service de base et doit être souscrite séparément en tant que service/configuration indépendant. Contactez le TechSupport pour les options disponibles dans votre situation.
Une grande entreprise envoie des factures à :
Toutes les factures sont envoyées via la même API (POST /api/v1/{partyId}/salesInvoice/send). Le PSB assure pour chaque facture le bon routage, le bon format et le bon canal.
Besoin d'aide pour configurer la livraison multi-channel ? Contactez TechSupport.
Ouvrir la référence API