Dohvati trenutno stanje računa
- U sandboxu
Jednostavnim riječima
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č.
id*stringID računa koji vraća poziv za predaju.
^inv_[A-Za-z0-9]{16,40}$Račun.
application/json- response
id*stringinvoice_ref*stringinvoice_number?stringroute*RouteKanal slanja za zemlju. Iste vrijednosti kao country_route u statusnim događajima.
"PEPPOL""PL-KSEF""RO-EFACTURA""FR-PA""DE-XRECHNUNG"environment*string"sandbox""production"state*InvoiceStateVlastito stanje usluge za račun. Statusni događaji prijavljuju životni ciklus vidljiv partneru;
queued i submitting unutarnji su koraci između validated i submitted. validation_failed znači da su službena pravila odbila dokument; od
0.18.4 provjera koja nije pokrenuta (KOSIT-RUN, EI-PDF-CHECK) ponavlja se, a zatim završava kao dead_letter s tom
šifrom. dead_letter zadržava svoj dokument, pa ista datoteka dobiva odgovor s duplicate_of; od 0.18.6
operater može otkazati onaj za koji nije upućen nijedan poziv kanalu, i tada datoteka može ponovno ići.
"received""source_error""validated""validation_failed""queued""submitting""submitted""ready""accepted""rejected""delivered""cancelled""dead_letter"legal_id?|KSeF broj, ANAF indeks učitavanja, ID dokumenta pristupne točke, ID računa francuske platforme.
buyer_status?string|nulldocument_sha256?|^[a-f0-9]{64}$attempts?array<>Ranije predaje istog invoice_ref (na primjer nakon odbijanja i ispravka).
errors?array<>documents?array<>created_at*stringdate-timeupdated_at*stringdate-timedeadline_at?stringOkvirni rok za ovaj račun, kao zadnji trenutak njegova zadnjeg dopuštenog dana u UTC-u (datumski dio čitajte kao taj dan): datum izdavanja plus pet radnih dana za Rumunjsku (e-Factura), sljedeći radni dan za Poljsku (KSeF offline24). Dani se broje od ponedjeljka do petka, a državni praznici ne primjenjuju se, pa stvarni rok može biti kasniji, nikad raniji; nije pravni savjet. Daje se u svakom stanju računa; ne kaže je li račun bio na vrijeme ili je kasnio. Prisutno samo za ta dva kanala i samo kada račun nosi datum izdavanja: POST /invoices s invoice.issue_date ili, od 0.19.2, UBL datoteka (cbc:IssueDate) ili FA(3) datoteka (Fa/P_1) poslana kao XML ili ostavljena u mapi. PDF ga ne nosi, a njegov izostanak ne znači da se nikakav rok ne primjenjuje. Od 0.19.1.
date-timecurl -X GET "https://example.com/invoices/inv_bd8bc8b276f38643f1c0f24f" \ -H "Authorization: Bearer <your-api-key>"{ "invoice_ref": "CAPTURE-JSON-1790961440", "environment": "sandbox", "document_sha256": "45f857890231e9bc6e73c1ec1e53bc01e7b030f84068b324bdd9ef42b88322bc", "route": "DE-XRECHNUNG", "updated_at": "2026-10-06T19:49:02.676Z", "documents": [ { "sha256": "45f857890231e9bc6e73c1ec1e53bc01e7b030f84068b324bdd9ef42b88322bc", "kind": "canonical", "href": "/invoices/inv_936a93e38de84e7b0a1d7681/documents/canonical" }, { "sha256": "ad122fe72dc6f04b2de6b6bbc01fcb7e46e33116b12e3bbb02a569cde3f10106", "kind": "manifest", "href": "/invoices/inv_936a93e38de84e7b0a1d7681/documents/manifest" }, { "sha256": "941fd5005aa03586a7bf23f3039c6d15e38220879d46690f9199a494e35fdc11", "kind": "validation-report", "href": "/invoices/inv_936a93e38de84e7b0a1d7681/documents/validation-report" }, { "sha256": "251a52fec3bdd44555a7396a1567d62c5ada3e3b7d002bb757d6b50e347c2e90", "kind": "xrechnung-ubl", "href": "/invoices/inv_936a93e38de84e7b0a1d7681/documents/xrechnung-ubl" } ], "client": "acme-srl", "created_at": "2026-10-06T19:49:01.621Z", "id": "inv_936a93e38de84e7b0a1d7681", "state": "ready", "invoice_number": "DOC-mux3dlqm"}Zaustavi račun koji još nije predan POST
Radi samo dok je račun u stanju received, validated ili queued. Od 0.18.3, kada je slanje pokušano, a njegov odgovor izgubljen (istek vremena ili 5xx), račun se prikazuje kao submitting, a otkazivanje vraća 409 send-in-progress, jer ga kanal možda već ima; radnik ga zaključuje kao submitted ili dead_letter. Kada ga kanal ima, storno je poslovni dokument (odobrenje ili KOR u Poljskoj), a ne API poziv. Od 0.18.5 otkazivanje računa koji je već otkazan vraća 200 s tim računom, pa je ponavljanje nakon izgubljenog odgovora sigurno. Od 0.18.6 ključ operatera može otkazati račun u stanju dead_letter kada za njega nikad nije upućen poziv kanalu: ništa ne može biti na kanalu, pa se isti dokument nakon toga može ponovno poslati. Kada je poziv upućen, odgovor je 409 dead-letter-reached-rail, jer slanje čiji je odgovor izgubljen možda jest tamo: prvo provjerite s kanalom. Ključ klijenta dobiva 409 dead-letter; odlučuje operater.
Preuzmi generirani dokument ili potvrdu kanala GET
Vrste: canonical (JSON onako kako je primljen), erp-export (izvoz iz ERP-a onako kako ga je ERP poslao), datoteka kako je poslana (ubl, cii, fa3, pdf), izrađeni dokument (xrechnung-ubl za Njemačku, inače ubl ili fa3), validation-report i manifest (SHA-256 bajtova koji idu kanalu i slojevi koji su ih provjerili). Četiri JSON vrste poslužuju se kao application/json. ETag je SHA-256.