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:

De PSB selecteert het kanaal op basis van een prioriteitsvolgorde:

1. PartyId-level hooks gaan voor environment-level hooks, als je voor een specifieke ontvanger een kanaal hebt ingesteld, wordt dat kanaal altijd gebruikt
2. Specifieke topics gaan voor wildcards, een hook voor InvoiceSent gaat voor een wildcard-hook
3. Bij gelijke prioriteit: hook-id als tiebreaker

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

Bij Duitse ontvangers weet je niet altijd vooraf of de tegenpartij op Peppol staat, en of deze ZUGFeRD (B2B) dan wel XRechnung (B2G, verplicht voor Duitse overheidsinstellingen) per e-mail verwacht. Duitse overheidsinstellingen mogen geen ZUGFeRD ontvangen; die krijgen verplicht pure XRechnung-XML. Het ZUGFeRD-PDF-containerformaat gaat sowieso niet over Peppol.

Architectuur (3 hooks): één Peppol-hook met conditional output vangt HTTP 404 (ontvanger niet op Peppol) op en publiceert Send*Fallback. Twee mail-hooks luisteren op dat fallback-topic en leveren, afhankelijk van filter, ZUGFeRD of XRechnung per e-mail.

Peppol-hook (Send*) --404--> Send*Fallback
                              |
                 +------------+------------+
                 |                         |
     ZUGFeRD-email (DE)        XRechnung-email (DE + DE:LWID)

Hook 1 -- Peppol met conditional fallback

{
  "id": "peppol",
  "action": "peppol",
  "name": "peppol hook",
  "topics": ["Send*"],
  "output": [
    { "when": "404", "topic": "Send*Fallback" }
  ],
  "isActive": true
}

Optioneel ook 400/500 opnemen in output voor een breder Peppol-met-emailfallback-patroon. Bij een 404 publiceert deze hook Send*Fallback in plaats van het standaard Send*-resultaat.

Hook 2 -- ZUGFeRD via e-mail (B2B, standaard Duitse fallback)

• Topics: ["Send*Fallback", "Send*"] (ook op Send*, zodat het kanaal als peppol-fallback in queryRecipientParty verschijnt)
• Filter: receiver.contains("DE")
• targetDocumentTypeId forceert hybride ZUGFeRD/Factur-X (PDF/A-3 met embedded CII) voor verzending: econnect-docid::urn:peppol:doctype:pdf+xml##urn:cen.eu:en16931:2017#conformant#urn:econnect:germany:billing:Factur-X:1.0::D22B
• De ontvanger krijgt een leesbare PDF met machineleesbare XML. De bron-XML moet de PDF al embedded hebben, want de PSB genereert geen PDF on-demand.

Hook 3 -- XRechnung via e-mail (B2G, Duitse overheid)

• Topics: dezelfde ["Send*Fallback", "Send*"]
• Filter: receiver.contains("DE") && receiver.contains("DE:LWID")
• targetDocumentTypeId forceert pure XRechnung 3.0 UBL (geen PDF): urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0::2.1
• DE:LWID staat voor Leitweg-ID in de ontvanger-identifier (Peppol schemeID 0204).

Geen dubbele aflevering bij DE:LWID

Beide mail-hooks matchen op een overheidsontvanger, want een DE:LWID-identifier bevat ook DE. Bij meerdere hooks die op hetzelfde topic matchen, geeft de PSB voorrang aan het langste filter (op aantal karakters): het XRechnung-filter is langer en wint dus, waardoor de ZUGFeRD-hook niet wordt getriggerd voor overheidsontvangers. Je hoeft de filters daarom niet handmatig wederzijds exclusief te maken. Deze filter-lengte-regel komt bovenop de algemene prioriteitsvolgorde hierboven (partyId voor environment, specifiek topic voor wildcard, hook-id als tiebreaker).

Mailhook-parameters (fallbackEmail, includeAttachment, filename, templateId, standaardafzender noreply@econnect.email) staan beschreven in E-mail hooks configureren. Formaatdetails: Factur-X / ZUGFeRD en XRechnung.

eConnect transformeert UBL-facturen automatisch naar het cXML-formaat dat Coupa verwacht. De koppeling vereist:

1. Je klant maakt accounts aan op de Coupa CSP test- en live-omgeving
2. De ontvangende partij maakt een Shared Secret aan
3. TechSupport configureert de verbinding in de PSB

De Ariba-koppeling werkt met 1-op-1 handelsrelaties, anders dan het open Peppol-netwerk:

1. De leverancier deelt zijn AN-ID met de koper
2. SAP kan een betaald abonnement vereisen bij hoger volume
3. De testomgeving gebruikt een AN-ID met suffix "-T"

eConnect transformeert een UBL-factuur naar cXML en levert deze af bij de Ariba-ontvanger, op dezelfde manier als bij de Coupa-transformatie hierboven. Het onboardingtraject verloopt als volgt:

1. Je meldt je aan bij het SAP Business Network.
2. Je stemt met de ontvanger af hoe deze de cXML wil ontvangen en vult op basis daarvan het eConnect-onboardingsformulier in.
3. eConnect legt op basis van het formulier de verbinding met de ontvanger, eerst via het testnetwerk, daarna live.

Abonnementsdrempel SAP: voor geautomatiseerde verzending/ontvangst van cXML via je eigen ERP-pakket (via eConnect) is minimaal SAP-abonnementsniveau Silver (Enterprise) vereist. Dit niveau dekt volumes van 25 tot 99 documenten per jaar.

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:

• Nederlandse klanten → Peppol (automatisch)
• Bouwsectorbedrijven → DICO (specifieke hook per partyId)
• Een multinational op een ander procurement-netwerk → specifieke hook
• Kleine leveranciers zonder netwerk → e-mail fallback
• Collabrr-platformgebruikers → Collabrr (automatisch via Collabrr ID)

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.

Hulp nodig bij het instellen van multi-channel levering? Neem contact op met TechSupport.