Jednou z nejsilnějších vlastností PSB je multi-channel doručování: prostřednictvím jediné API integrace dosáhnete příjemce na Peppol, dalších nákupních sítích a e-mailem. PSB automaticky zvolí nejlepší kanál, ale směrování můžete ovládat i sami.

Standardně PSB směruje všechny faktury přes Peppol. Systém zkontroluje, zda je příjemce registrován na Peppol, a odešle fakturu přes síť Peppol. Pokud příjemce není na Peppol registrován, aktivuje se fallback.

Konfigurací více hooků s Send* topiky můžete aktivovat další kanály:

PSB vybírá kanál na základě pořadí priorit:

1. Hooky na úrovni PartyId mají přednost před hooky na úrovni prostředí; pokud jste pro konkrétního příjemce nastavili kanál, tento kanál se vždy použije
2. Specifické topiky mají přednost před wildcardy; hook pro InvoiceSent má přednost před wildcard hookem
3. Pokud více hooků s filtry odpovídá stejnému topiku: vyhrává nejdelší filtr (podle počtu znaků) -- například filtr s další klauzulí && vyhrává nad kratším filtrem bez této klauzule
4. Při stejné prioritě: hook-id jako rozhodující faktor (alfanumericky -- celéčíselné ID jsou před textem, například: 1 < 02 < 10 < dico < peppol)

Před odesláním faktury si můžete přes queryRecipientParty ověřit, který kanál PSB použije. Existují dva endpointy, jeden na typ dokumentu:

POST /api/v1/{partyId}/salesInvoice/queryRecipientParty
POST /api/v1/{partyId}/purchaseOrder/queryRecipientParty

Tělo přijímá jednoduché pole ["0106:12345678"] nebo objekt s meta atributy { "partyIds": [...], "metaAttributes": {...} }. Volitelné parametry dotazu: ?preferredDocumentTypeId, ?includeOptions, ?documentFamily (pouze u varianty purchaseOrder).

Odpověď zobrazí vybraný kanál a dostupné alternativy.

V též volání queryRecipientParty smí být na schéma/kód agentury (např. 0106, 0190, 0208, 9944) uveden nejvýše jeden identifikátor. Více identifikátorů v různých schématech ve stejném volání je povoleno.

Při porušení pravidla PSB odpoVí:

EConnect.Psb.Models.EConnectException: 'Duplicate id agencies {code} requested.'

kde {code} je kód agentury bez úvodní nuly (schéma 0208 → 208). Chcete-li testovat více kandidátů v rámci stejného schématu, proveďte samostatná volání API -- jedno na kandidáta.

Pro pokročilé vyhledávání včetně URL Access Pointu a certifikátu je k dispozici endpoint Peppol:

GET /api/v1/peppol/deliveryOption?partyIds=...&documentFamily=...&isCredit=...&documentTypeIds=...&preferredDocumentTypeId=...

Odpověď obsahuje partyId, documentTypeId, processId, protocol (As2/As4), url a certificate.

V některých případech chcete automatický výběr kanálu obejít. To je možné pomocí parametru ?channel={hookId} u send endpointů:

POST /api/v1/{partyId}/salesInvoice/send?channel=hook-123-abc

Tím donutíte PSB použít konkrétní kanál (hook) bez ohledu na automatický výběr.

Častou kombinací je Peppol hook s e-mail hookem jako fallback. Prostřednictvím conditional output topics Peppol hook při chybách doručení (HTTP 400, 404 nebo 500) publikuje topic Send*Fallback, na který naslouchá e-mail hook. Pokud tentýž e-mail hook naslouchá také explicitně na Send* (navíc k Send*Fallback), automaticky se zobrazí jako kanál peppol-fallback v odpovědi queryRecipientParty. To umožňuje volajícímu kódu explicitně zvolit kanál přes ?channel=peppol-fallback na send endpointech, což je užitečné pro scénáře, kde se Peppol záměrně přeskakuje.

eConnect automaticky transformuje UBL faktury do formátu cXML, který Coupa očekává. Propojení vyžaduje:

1. Váš klient si vytvoří účty v testovacím a produkčním prostředí Coupa CSP
2. Přijímající strana vytvoří Shared Secret
3. TechSupport nakonfiguruje připojení v PSB

Propojení s Ariba funguje s obchodními vztahy 1 na 1, na rozdíl od otevřené sítě Peppol:

1. Dodavatel sdílí své AN-ID s kupujícím
2. SAP může při vyšším objemu vyžadovat placené předplatné
3. Testovací prostředí používá AN-ID s příponou "-T"

eConnect transformuje UBL fakturu do cXML a doručí ji příjemci Ariba, stejným způsobem jako u transformace Coupa výše. Proces onboardingu probíhá takto:

1. Zaregistrujete se u SAP Business Network.
2. Domluvíte se s příjemcem, jakým způsobem chce cXML přijímat, a na základě toho vyplníte onboardingový formulář eConnect.
3. Na základě formuláře eConnect naváže spojení s příjemcem, nejprve přes testovací síť, poté ostrou.

Práh předplatného SAP: pro automatizované odesílání/přijímání cXML přes vlastní ERP systém (prostřednictvím eConnect) je vyžadována minimálně úroveň předplatného SAP Silver (Enterprise). Tato úroveň pokrývá objemy 25 až 99 dokumentů ročně.

PSB automaticky konvertuje mezi všemi běžnými formáty e-faktur. Pokud odešlete fakturu ve formátu NLCIUS, ale příjemce očekává XRechnung, PSB dokument automaticky transformuje. Funguje to pro všechny podporované standardy: BIS Billing, NLCIUS, PINT, XRechnung, Svefaktura, ebInterface, DICO, SETU a další.

Transformace je dostupná od balíčku 10K.

PSB podporuje transformaci v obou směrech mezi SI 2.0 a SALES005:

• SI 2.0 → SALES005
• SALES005 → SI 2.0

Důležité: faktury SALES005 nesmí být odeslány přes Peppol. Odesílání SALES005 vyžaduje e-mailové připojení. Multi-channel tořeší: odesíláte přednostně přes Peppol, s automatickým fallbackem na e-mail, když je potřeba.

Při odesílání přes e-mail, SFTP nebo HTTPS endpoint můžete zadat targetFormat. PSB pak transformuje fakturu za běhu do požadovaného formátu. Klient, který chce převést UBL fakturu do SALES005, zadá při stažení nebo odeslání targetDocumentTypeId -- faktura je pak automaticky transformována.

Peppol nepodporuje targetFormat (SALES005 přes Peppol není povolen). Na všech ostatních kanálech -- e-mail, SFTP, HTTPS -- je targetFormat dostupný.

Multi-channel delivery není standardně součástí základní služby a musí být dojednána zvlášť jako samostatná služba/konfigurace. Kontaktujte TechSupport pro možnosti dostupné ve vaší situaci.

Velká společnost odesílá faktury:

• Nizozemským klientům → Peppol (automaticky)
• Společnostem ve stavebním sektoru → DICO (specifický hook podle partyId)
• Nadnárodní společnosti na Coupa → Coupa (specifický hook)
• Malým dodavatelům bez sítě → e-mail fallback
• Uživatelé platformy Collabrr → Collabrr (automaticky přes ID Collabrr)

Všechny faktury se odesílají přes stejné API (POST /api/v1/{partyId}/salesInvoice/send). PSB se u každé faktury postará o správné směrování, správný formát a správný kanál.

Potřebujete pomoc s nastavením multi-channel doručování? Kontaktujte TechSupport.