Jednou z najsilnejších vlastností PSB je multi-channel doručovanie: prostredníctvom jedinej API integrácie dosiahnete príjemcov na Peppol, ďalších obstarávacích sieťach a e-mailom. PSB automaticky zvolí najlepší kanál, ale smerovanie môžete ovládať aj sami.

Štandardne PSB smeruje všetky faktúry cez Peppol. Systém skontroluje, či je príjemca registrovaný na Peppol, a odošle faktúru cez sieť Peppol. Ak príjemca nie je na Peppol registrovaný, aktivuje sa fallback.

Konfiguráciou viacerých hookov s Send* topikmi môžete aktivovať ďalšie kanály:

PSB vyberá kanál na základe poradia priorít:

1. Hooky na úrovni PartyId majú prednosť pred hookmi na úrovni prostredia; ak ste pre konkrétneho príjemcu nastavili kanál, tento kanál sa vždy použije
2. Špecifické topiky majú prednosť pred wildcardmi; hook pre InvoiceSent má prednosť pred wildcard hookom
3. Ak viacero hookov s filtrami zodpovedá rovnakému topiku: vyhráva najdlhší filter (podľa počtu znakov) -- napríklad filter s ďalšou klauzulou && vyhráva nad kratším filtrom bez tejto klauzuly
4. Pri rovnakej priorite: hook-id ako rozhodujúci faktor (alfanumericky -- celéčíselné ID sú pred textom, napríklad: 1 < 02 < 10 < dico < peppol)

Pred odoslaním faktúry si môžete cez queryRecipientParty overiť, ktorý kanál PSB použije. Existujú dva endpointy, jeden na typ dokumentu:

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

Telo prijíma jednoduché pole ["0106:12345678"] alebo objekt s meta atribútmi { "partyIds": [...], "metaAttributes": {...} }. Volitelné parametre dopytu: ?preferredDocumentTypeId, ?includeOptions, ?documentFamily (len pri variante purchaseOrder).

Odpoveď zobrazí vybraný kanál a dostupné alternatívy.

V tom istom volání queryRecipientParty smí byť na schému/kód agentúry (napr. 0106, 0190, 0208, 9944) uvedený najvýše jeden identifikátor. Viac identifikátorov v rôznych schémach v rovnakom volání je povolených.

Pri porušení pravidla PSB odpovie:

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

kde {code} je kód agentúry bez úvodnej nuly (schéma 0208 → 208). Ak chcete testovať viac kandidátov v rámci rovnakej schémy, vykonajte samostatné volánia API -- jedno na kandidáta.

Pre pokročilé vyhľadávanie vrátane URL Access Pointu a certifikátu je k dispozícii endpoint Peppol:

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

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

V niektorých prípadoch chcete automatický výber kanála obísť. To je možné pomocou parametra ?channel={hookId} pri send endpointoch:

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

Tým donútite PSB použiť konkrétny kanál (hook) bez ohľadu na automatický výber.

Bežnou kombináciou je Peppol hook s e-mail hookom ako fallback. Cez conditional output topics Peppol hook pri chybách doručenia (HTTP 400, 404 alebo 500) publikuje topic Send*Fallback, na ktorý počúva e-mail hook. Keď ten istý e-mail hook počúva aj explicitne na Send* (okrem Send*Fallback), automaticky sa zobrazí ako kanál peppol-fallback v odpovedi queryRecipientParty. To umožňuje volajúcemu kódu explicitne zvoliť kanál cez ?channel=peppol-fallback na send endpointoch, čo je užitočné pri scenároch, kde sa Peppol zámerne obchádza.

eConnect automaticky transformuje UBL faktúry do formátu cXML, ktorý Coupa očakáva. Prepojenie vyžaduje:

1. Váš klient si vytvorí účty v testovacom a produkčnom prostredí Coupa CSP
2. Prijímajúca strana vytvorí Shared Secret
3. TechSupport nakonfiguruje pripojenie v PSB

Prepojenie s Ariba funguje s obchodnými vzťahmi 1 na 1, na rozdiel od otvorenej siete Peppol:

1. Dodávateľ zdieľa svoje AN-ID s kupujúcim
2. SAP môže pri vyššom objeme vyžadovať platené predplatné
3. Testovacie prostredie používa AN-ID s príponou "-T"

eConnect transformuje UBL faktúru do cXML a doručí ju príjemcovi Ariba, rovnakým spôsobom ako pri transformácii Coupa vyššie. Proces onboardingu prebieha takto:

1. Zaregistrujete sa v SAP Business Network.
2. Dohodnete sa s príjemcom, akým spôsobom chce prijímať cXML, a na základe toho vyplníte onboardingový formulár eConnect.
3. Na základe formulára eConnect nadväzuje spojenie s príjemcom, najprv cez testovaciu sieť, potom ostro.

Práh predplatného SAP: pre automatizované odosielanie/prijímanie cXML cez vlastný ERP systém (prostredníctvom eConnect) je potrebná minimálne úroveň predplatného SAP Silver (Enterprise). Táto úroveň pokrýva objemy 25 až 99 dokumentov ročne.

PSB automaticky konvertuje medzi všetkými bežnými formátmi e-faktúr. Ak odošlete faktúru vo formáte NLCIUS, ale príjemca očakáva XRechnung, PSB dokument automaticky transformuje. Funguje to pre všetky podporované štandardy: BIS Billing, NLCIUS, PINT, XRechnung, Svefaktura, ebInterface, DICO, SETU a ďalšie.

Transformácia je dostupná od balíka 10K.

PSB podporuje transformáciu v oboch smeroch medzi SI 2.0 a SALES005:

• SI 2.0 → SALES005
• SALES005 → SI 2.0

Dôležité: faktúry SALES005 nesmú byť odoslané cez Peppol. Odosielanie SALES005 vyžaduje e-mailové prepojenie. Multi-channel to rieši: odosielať prednostne cez Peppol, s automatickým fallbackom na e-mail v prípade potreby.

Pri odosielaní cez e-mail, SFTP alebo HTTPS endpoint môžete uviesť targetFormat. PSB potom transformuje faktúru za behu do požadovaného formátu. Klient, ktorý chce previesť UBL faktúru do SALES005, zadá pri stiahnutí alebo odoslaní targetDocumentTypeId -- faktúra je potom automaticky transformovaná.

Peppol nepodporuje targetFormat (SALES005 cez Peppol nie je povolený). Na všetkých ostatných kanáloch -- e-mail, SFTP, HTTPS -- je targetFormat dostupný.

Multi-channel delivery nie je štandardne súčasťou základnej služby a musí byť dojednávaná osobitne ako samostatná služba/konfigurácia. Kontaktujte TechSupport pre možnosti dostupné vo vašej situácii.

Veľká spoločnosť odosiela faktúry:

• Holandským klientom → Peppol (automaticky)
• Spoločnostiam v stavebnom sektore → DICO (špecifický hook podľa partyId)
• Nadnárodnej spoločnosti na Coupa → Coupa (špecifický hook)
• Malým dodávateľom bez siete → e-mail fallback
• Používatelia platformy Collabrr → Collabrr (automaticky cez ID Collabrr)

Všetky faktúry sa odosielajú cez rovnaké API (POST /api/v1/{partyId}/salesInvoice/send). PSB sa pri každej faktúre postará o správne smerovanie, správny formát a správny kanál.

Potrebujete pomoc s nastavením multi-channel doručovania? Kontaktujte TechSupport.