Configurer la livraison multi-channel

Configurer plusieurs canaux de livraison : Peppol, DICO, autres réseaux de procurement, fallback e-mail et priorités.

Questions fréquentes
Comment la PSB détermine-t-elle le canal à utiliser pour une facture ?

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).

Puis-je remplacer le canal sélectionné automatiquement ?

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.

Le multi-channel prend-il en charge d'autres types de documents que les factures ?

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.

Comment fonctionne le multi-channel ?

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 :

CanalConfigurationUtilisationPeppolPar défaut, toujours actifRoute principale pour tous les participants PeppolDICOHook avec topic DICOFactures du secteur de la construction via la norme DICOAutres réseauxHook avec configuration réseauOrganisations qui reçoivent via d'autres réseaux de procurement tels que Coupa ou SAP AribaFallback e-mailHook avec topic e-mailDestinataires non joignables via un réseauSFTPHook avec configuration SFTPSystèmes on-premise avec transfert de fichiersHTTPSHook avec configuration HTTPSSystèmes enterprise avec réception API directeCollabrrHook avec configuration CollabrrDocuments vers/depuis la plateforme Collabrr ; peut inclure une instruction d'envoi dans le même appel (ex. « envoyer via Peppol »). Utilise l'ID Collabrr (-0003:XC...) comme identifiant
Sélection automatique du canal

Le PSB sélectionne le canal selon un ordre de priorité :

  1. Les hooks au niveau PartyId ont la priorité sur les hooks au niveau environment. Si vous avez configuré un canal pour un destinataire spécifique, ce canal est toujours utilisé
  2. Les topics spécifiques ont la priorité sur les wildcards. Un hook pour InvoiceSent a la priorité sur un hook wildcard
  3. Si plusieurs hooks avec des filtres correspondent au même topic : le filtre le plus long (en nombre de caractères) gagne -- par exemple, un filtre avec une clause && supplémentaire gagne sur un filtre plus court sans cette clause
  4. En cas de priorité égale : le hook-id sert de tiebreaker (alphanumérique -- les ID entiers viennent avant le texte, par exemple : 1 < 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.

Règle de validation : un identifiant par schéma par appel

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.'

{code} est le code d’agence sans zéro de tête (schéma 0208208). 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.

Forcer un canal

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.

Configurer Coupa et Ariba
Coupa

eConnect transforme automatiquement les factures UBL au format cXML attendu par Coupa. La connexion requiert :

  1. Votre client crée des comptes sur les environnements de test et de production Coupa CSP
  2. La partie réceptrice crée un Shared Secret
  3. TechSupport configure la connexion dans le PSB
Ariba (SAP Business Network)

La connexion Ariba fonctionne avec des relations commerciales 1-à-1, contrairement au réseau ouvert Peppol :

  1. Le fournisseur partage son AN-ID avec l'acheteur
  2. SAP peut exiger un abonnement payant pour les volumes élevés
  3. L'environnement de test utilise un AN-ID avec le suffixe "-T"
Onboarding cXML via eConnect

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 :

  1. Vous vous inscrivez auprès du SAP Business Network.
  2. Vous convenez avec le destinataire de la manière dont il souhaite recevoir le cXML et remplissez le formulaire d'onboarding eConnect en conséquence.
  3. Sur la base du formulaire, eConnect établit la connexion avec le destinataire, d'abord via le réseau de test, puis en production.

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.

Transformation XML

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.

SI 2.0 et SALES005

La PSB supporte la transformation dans les deux sens entre SI 2.0 et SALES005 :

  • SI 2.0 → SALES005
  • SALES005 → SI 2.0

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.

Format cible sur tous les canaux sauf Peppol

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.

Disponibilité

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.

Scénario pratique

Une grande entreprise envoie des factures à :

  • Clients néerlandais → Peppol (automatique)
  • Entreprises du secteur de la construction → DICO (hook spécifique par partyId)
  • Une multinationale sur Coupa → Coupa (hook spécifique)
  • Petits fournisseurs sans réseau → fallback e-mail
  • Utilisateurs de la plateforme Collabrr → Collabrr (automatique via l'ID Collabrr)

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