eP24

Simulátor integrácie ERP

Referenčný klient integrovaný na eP24.

Špecifikácia pre serverovú stranu (.md)Kontrakt, idempotencia, webhooky a pravidlá, ktoré musia platiť — pripravené ako vstup pre AI agenta alebo vývojára, ktorý stavia API.
Odoslanie faktúry
Prijatie faktúry

Prijaté faktúry chodia tou istou cestou ako doručovacie udalosti — na jeden endpoint, s tým istým podpisom. Vypnúť sa dajú prepínačom „Aj prijaté faktúry“ v eP24.

  1. ERP odovzdá jednu faktúru. Platné UBL XML plus hlavičku Idempotency-Key (UUID, ktoré si uložíte ku faktúre).
  2. eP24 všetko overí ešte pred prevzatím. Bezpečnosť XML, odosielateľa a jeho Peppol-aktiváciu, schematron, dosiahnuteľnosť príjemcu a krytie poplatku.
  3. 202 znamená prevzatú zodpovednosť. Uložte si documentId — synchrónna časť tým končí. Doručenie dobehne o sekundy až minúty neskôr.
  4. Akýkoľvek 4xx znamená odmietnutie. Vetvite podľa stabilného poľa code v tele odpovede, nie podľa textu.
  5. Faktúry prichádzajú tým istým webhookom. Keď eP24 dospracuje faktúru adresovanú vám, pošle inbox.document.received aj s celým UBL v tele udalosti. V simulátore ich uvidíte v paneli Webhook o doručení, sekcia Prijaté faktúry (inbox).
  6. O doručení sa dozviete dvoma spôsobmi. Buď ho používateľ sleduje v nástenke eP24, alebo si zaregistrujete webhook a eP24 pošle podpísanú udalosť outbox.document.delivered vtedy, keď faktúra naozaj dorazí k odberateľovi — prípadne outbox.document.failed, keď je odoslanie definitívne stratené. Ako ho prijať správne.

Podrobne v Príručke pre integráciu · webhook o doručení · úplný HTTP kontrakt na /api-docs

Požiadavka

Vytvorte ho v eP24: Peňaženka → API prístup → Nový token (Sandbox). Tokeny začínajú ep24api_test_ a zobrazia sa iba raz.

X-Requested-Delivery prijíma API len s hodnotou peppol; email vráti 400 email_delivery_unsupported (e-mailom sa faktúra dá poslať z webu eP24, nie cez API) a iná hodnota 400 bad_requested_delivery. X-Buyer-Email je záložná adresa pre človeka vo webe eP24 — sama doručenie nespustí a nepoužiteľná hodnota sa ticho zahodí. Prázdne pole sa neodošle vôbec, čo nie je to isté ako poslať prázdnu hlavičku; obe idú len k volaniu „Odoslať“, nie k validácii.

Odpoveď

Spustite „Validovať“ alebo „Odoslať“ a zobrazí sa komunikácia.