Popis i pretraga zaprimljenih računa
- U sandboxu
Od 0.35.0. Isti parametri i odgovor kao kod GET /invoices, samo za zaprimljene račune; state je
received, validated ili validation_failed. Ključ klijenta vidi račune svojeg klijenta; operater račune svih klijenata ili
jednog klijenta pomoću client.
apiKeyAuthorizationBearer <token>Ključ pošaljite kao bearer token: Authorization: Bearer <your-api-key>. Poziv za stanje usluge jedini je poziv za koji nije potreban ključ.
q?stringlength <= 100route?array<>state?array<>client?string^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$received_from?stringdatereceived_to?stringdatesort?string"newest""newest""oldest"page?integer1 <= value1page_size?integer252550100200Jedna stranica podudaranja.
application/json- response
data*array<>total*integerpage*integerpage_size*integercounts_by_state*curl -X GET "https://example.com/received" \ -H "Authorization: Bearer <your-api-key>"{ "data": [ { "id": "string", "invoice_ref": "string", "invoice_number": "string", "route": "PEPPOL", "client": "string", "environment": "sandbox", "state": "received", "direction": "in", "rail_id": "string", "document_sha256": "string", "duplicate_of": "string", "links": { "self": "string", "events": "string" }, "errors": [ { "code": "string" } ], "documents": [ { "kind": "received-xml", "sha256": "string", "href": "string" } ], "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ], "total": 0, "page": 0, "page_size": 0, "counts_by_state": { "property1": 0, "property2": 0 }}Popis statusnih događaja jednog zaprimljenog računa GET
Od 0.35.0. Isti događaji koje isporučuje webhook, redom po slijedu, svaki s direction in.
Predaj račun koji je klijent zaprimio putem kanala POST
Od 0.35.0 (17. listopada 2026.). Tijelo je XML točno onako kako ga je kanal isporučio (UBL, CII ili FA(3)); ništa se ne mijenja i ništa se ne šalje. Datoteka se prvo pohranjuje, zapečaćena ključem podataka klijenta, jer je po zakonu već zaprimljena; zatim je provjeravaju validatori samog kanala, kao kod slanja prosljeđivanjem, a rezultat stiže kao statusni događaj (received, zatim validated ili validation_failed, s direction: in) na webhook klijenta i na GET /received/{id}/events. Datoteka koja ne prođe pravila čuva se i ima stanje validation_failed s pogreškama; nikad se ne odbacuje. Datoteka koja nije račun za čuvanje odbija se s 422 i ništa se ne pohranjuje, kao na POST /invoices/xml: DOCTYPE (EI-XML-DTD, nikad se ne parsira), XML koji nije ispravno oblikovan (EI-XML-SYNTAX) ili dokument koji nije račun poznat kanalu (EI-XML-TYPE). Provjera koja se nije mogla pokrenuti (validator nije dostupan) ponavlja se, a nakon zadnjeg ponavljanja račun ide na popis za obradu i ostaje u stanju received. Klijent predaje najviše 120 dokumenata u minuti i 2.000 na dan, bez obzira na ključ koji koristi (429, ne čuva se pod Idempotency-Key). Datoteka se vraća kao preuzimanje (Content-Disposition: attachment). Jedan dokument kanala jedan je zaprimljeni račun klijenta: po rail_id kada je naveden, po SHA-256 datoteke kada nije. Isti dokument ponovno vraća 202 s duplicate_of; isti rail_id s drugim bajtovima vraća 409 received-id-conflict i ništa se ne pohranjuje. Zaprimljeni računi čuvaju se odvojeno od računa koje klijent šalje: nisu u GET /invoices, nizu, metrikama ni mjesečnom izvješću i nikad ne blokiraju slanje iste datoteke. Zaprimljeni račun briše se s razdobljem čuvanja klijenta kada na njemu više ništa nije otvoreno (njegova provjera je završena ili je osoba obradila njegov redak za obradu) i nalazi se u izvozu klijenta pod received/. Opseg submit; ključ klijenta djeluje samo za vlastitog klijenta.