API Changelog

Biznis odpoveď na prijatý doklad (AP = akceptované, RE = zamietnuté) sa teraz odosiela ako plnohodnotný Invoice Response (urn:fdc:peppol.eu:poacc:trns:invoice_response:3) namiesto transportného MLS. Pre protistranu je to štandardná, korelovateľná odpoveď. Request aj response formát endpointu sa nemení; text v message teraz znie „Invoice Response … naplánovaný na odoslanie".

Transportné potvrdenie (MLS AB) posiela náš Access Point automaticky hneď pri prijatí dokladu – nie je to biznis odpoveď príjemcu. Použite AP alebo RE. Kódy IP/UQ/CA/PD zatiaľ vracajú 501 (bez zmeny). Rovnako POST /invoices/inbound/{id}/confirm teraz namiesto MLS odosiela Invoice Response AP/RE. Endpointy /documents/inbox/{id}/acknowledge a /inbound/documents/{id}/ack fungujú bez zmeny requestu: default AB = idempotentné potvrdenie prevzatia dokladu (bez sieťovej správy), AP/RE odošlú Invoice Response.

Ak protistrana odpovie na vami odoslaný doklad biznis Invoice Response-om s iným kódom než AB/AP/RE, stav sa korektne uloží a propaguje (status endpointy, inbox, webhook invoice.mls_status_changed). Predtým sa takáto odpoveď nespracovala.

Ak sa MLS (AB/RE) k prijatému dokladu nepodarí doručiť (výpadok SMP alebo AS4 protistrany), doručenie sa automaticky opakuje. Bez zmeny API kontraktu – zvyšuje spoľahlivosť potvrdení pre odosielateľov.

Opakovaný acknowledge už potvrdeného dokladu vracal 500 (SAPI-PROC-002, retryable: true) — klient rešpektujúci retryable tak retryoval donekonečna. Teraz vráti 200 ACKNOWLEDGED. Neexistujúci dokument zároveň vracia deklarovanú 404 (SAPI-NOT-001) namiesto 500.

Ak predchádzajúci pokus o POST /sapi/document/send skončil v stave FAILED, nový pokus s tým istým dokladom prejde čisto. Doklad, ktorý už bol úspešne odoslaný, vráti 409 (SAPI-CONF-001, resp. DUPLICATE_DOCUMENT v Enterprise API) so zrozumiteľnou správou – pre opravu vystavte doklad s novým číslom.

Po potvrdení cez /document/receive/{id}/acknowledge sa doklad presunie zo status=RECEIVED pod status=ACKNOWLEDGED. Predtým sa stav odvodzoval len zo sieťového MLS, takže potvrdený doklad sa vracal opakovane.

Opakované POST /sapi/document/send s tým istým Idempotency-Key (v rámci 24 h) už dokument neodošle znova – vráti pôvodnú odpoveď s hlavičkou Idempotency-Replayed: true. Bezpečné opakovanie po výpadku siete bez rizika duplicitnej PEPPOL transmisie.

Token sa dá obnoviť cez POST /sapi/auth/renew (rotácia refresh tokenu). Pole refresh_token berte ako voliteľné – pri client_credentials si access token kedykoľvek vyžiadate aj znova cez /auth/token.

Hlavička v POST /sapi/document/send akceptuje ľubovoľný unikátny reťazec (1–200 znakov), takže môžete použiť napríklad číslo faktúry. UUID naďalej platí.

Pri nenájdení účastníka vrátia GET /enterprise/peppol/participants/{scheme}/{id}, POST /enterprise/peppol/capabilities a GET /enterprise/company/lookup/{ico} s parametrom soft404=true HTTP 200 s found=false (bez parametra ostáva 404, ktoré tiež nesie found=false v tele).

POST /enterprise/documents/validate, /enterprise/public/validate a /enterprise/documents/preflight prijímajú JSON telo { "payload": "<XML>", "payloadFormat": "XML" } popri pôvodnom application/xml. Konzistentné so /document/send.