Meerdere afleverkanalen instellen: Peppol, DICO, andere netwerken, e-mail fallback en prioriteiten.
Een van de krachtigste eigenschappen van de PSB is multi-channel levering: via één API-integratie bereik je ontvangers op Peppol, andere procurement-netwerken en per e-mail. De PSB kiest automatisch het beste kanaal, maar je kunt de routering ook zelf sturen.
Standaard routeert de PSB alle facturen via Peppol. Het systeem controleert of de ontvanger op Peppol is geregistreerd en stuurt de factuur via het Peppol-netwerk. Als de ontvanger niet op Peppol staat, treedt de fallback in werking.
Door meerdere hooks te configureren met Send*-topics, kun je aanvullende kanalen activeren:
-0003:XC...) als identifierDe PSB selecteert het kanaal op basis van een prioriteitsvolgorde:
InvoiceSent gaat voor een wildcard-hookVoordat je een factuur verstuurt, kun je via queryRecipientParty controleren welk kanaal de PSB zal gebruiken:
GET /api/v1/queryRecipientParty?identifier={schemeID}:{id}
De response toont het geselecteerde kanaal en de beschikbare alternatieven.
In sommige gevallen wil je het automatische kanaalselectie overrulen. Dat kan met de ?channel={hookId} queryparameter bij de send-endpoints:
POST /api/v1/{partyId}/salesInvoice/send?channel=hook-123-abc
Dit forceert de PSB om het specifieke kanaal (hook) te gebruiken, ongeacht de automatische selectie.
Een veelgebruikte combinatie is een Peppol-hook met een mail-hook als fallback. Via conditional output topics publiceert de Peppol-hook bij delivery-fouten (HTTP 400, 404 of 500) een Send*Fallback-topic, waarop de mail-hook luistert. Wanneer dezelfde mail-hook ook expliciet luistert op Send* (naast Send*Fallback), verschijnt deze automatisch als kanaal peppol-fallback in de queryRecipientParty-response. Daarmee kan de aanroepende code het kanaal expliciet kiezen via ?channel=peppol-fallback op de send-endpoints, wat handig is voor scenario's waarin Peppol bewust wordt overgeslagen.
eConnect transformeert UBL-facturen automatisch naar het cXML-formaat dat Coupa verwacht. De koppeling vereist:
De Ariba-koppeling werkt met 1-op-1 handelsrelaties, anders dan het open Peppol-netwerk:
De PSB converteert automatisch tussen alle gangbare e-factuurformaten. Als je een factuur in NLCIUS-formaat verstuurt maar de ontvanger XRechnung verwacht, transformeert de PSB het document automatisch. Dit werkt voor alle ondersteunde standaarden: BIS Billing, NLCIUS, PINT, XRechnung, Svefaktura, ebInterface, DICO, SETU en meer.
De transformatie is beschikbaar vanaf het 10K pakket.
Een groot bedrijf verstuurt facturen aan:
Alle facturen worden via dezelfde API verstuurd (POST /api/v1/{partyId}/salesInvoice/send). De PSB zorgt per factuur voor de juiste routering, het juiste format en het juiste kanaal.
De PSB selecteert het kanaal op basis van een prioriteitsvolgorde. PartyId-level hooks gaan voor op environment-level hooks, en specifieke topics gaan voor wildcards. Standaard routeert de PSB via Peppol. Als de ontvanger niet op Peppol staat, treedt de geconfigureerde fallback in werking (bijv. DICO, Coupa of e-mail).
Ja, met de ?channel={hookId} queryparameter bij de send-endpoints forceer je een specifiek kanaal. Dit overschrijft de automatische kanaalselectie. Je kunt vooraf via queryRecipientParty controleren welk kanaal de PSB zou selecteren en op basis daarvan beslissen of je wilt overrulen.
Ja, multi-channel routing werkt voor alle documenttypen die de PSB ondersteunt, zoals creditnota's, orders en order responses. Alle documenten worden via dezelfde API verstuurd en de PSB zorgt per document voor de juiste routering, het juiste formaat en het juiste kanaal.
Hulp nodig bij het instellen van multi-channel levering? Neem contact op met TechSupport.
Open de API-referentie