Odovzdanie faktúry, ktorú klient prijal cez kanál

Od 0.35.0 (17. okt. 2026). Telo je XML presne tak, ako ho kanál doručil (UBL, CII alebo FA(3)); nič sa nemení a nič sa neodosiela. Súbor sa najprv uloží, zapečatený dátovým kľúčom klienta, pretože podľa práva je už prijatý; potom ho skontrolujú validátory kanála, ako pri priamom odovzdaní, a výsledok príde ako stavová udalosť (received, potom validated alebo validation_failed, s direction: in) na webhook klienta a na GET /received/{id}/events. Súbor, ktorý nespĺňa pravidlá, sa uchová a má stav validation_failed s chybami; nikdy sa nezahodí. Súbor, ktorý nie je faktúrou na uchovanie, sa odmietne s 422 a nič sa neuloží, ako pri POST /invoices/xml: DOCTYPE (EI-XML-DTD, nikdy sa nespracúva), XML, ktoré nie je dobre utvorené (EI-XML-SYNTAX), alebo dokument, ktorý nie je faktúrou známou kanálu (EI-XML-TYPE). Kontrola, ktorú sa nepodarilo spustiť (validátor nedostupný), sa zopakuje a po poslednom pokuse faktúra skončí v zozname na riešenie a zostane received. Klient odovzdá najviac 120 dokumentov za minútu a 2 000 za deň, bez ohľadu na kľúč (429, neukladá sa pod Idempotency-Key). Súbor sa vráti ako stiahnutie (Content-Disposition: attachment).

Jeden dokument kanála je pre klienta jedna prijatá faktúra: podľa rail_id, ak je uvedené, inak podľa SHA-256 súboru. Ten istý dokument znova odpovie 202 s duplicate_of; rovnaké rail_id s inými bajtmi odpovie 409 received-id-conflict a nič sa neuloží. Prijaté faktúry sú oddelené od faktúr, ktoré klient odosiela: nie sú v GET /invoices, v číselnom rade, v metrikách ani v mesačnom prehľade a nikdy neblokujú odoslanie toho istého súboru. Prijatá faktúra sa maže spolu s retenciou klienta, keď na nej nie je nič otvorené (jej kontrola skončila alebo jej riadok na riešenie vybavila osoba), a je v exporte klienta pod received/. Rozsah submit; kľúč klienta koná len za vlastného klienta.