Zistenie aktuálneho stavu faktúry
- V sandboxe
Jednoducho povedané
apiKeyAuthorizationBearer <token>Kľúč posielajte ako token typu Bearer: Authorization: Bearer <your-api-key>. Stav služby je jediné volanie, ktoré nevyžaduje kľúč.
id*stringID faktúry, ktoré vrátilo volanie na podanie.
^inv_[A-Za-z0-9]{16,40}$Faktúra.
application/json- response
id*stringinvoice_ref*stringinvoice_number?stringroute*RouteKanál krajiny. Rovnaké hodnoty ako country_route v stavových udalostiach.
"PEPPOL""PL-KSEF""RO-EFACTURA""FR-PA""DE-XRECHNUNG"environment*string"sandbox""production"state*InvoiceStateVlastný stav služby pre faktúru. Stavové udalosti hlásia životný cyklus viditeľný pre partnera;
queued a submitting sú vnútorné kroky medzi validated a submitted. validation_failed znamená, že oficiálne pravidlá dokument odmietli; od
0.18.4 sa kontrola, ktorá sa nespustila (KOSIT-RUN, EI-PDF-CHECK), opakuje a potom skončí ako dead_letter s týmto
kódom. dead_letter drží svoj dokument, takže ten istý súbor odpovie s duplicate_of; od 0.18.6 môže
operátor zrušiť faktúru, pre ktorú sa neuskutočnilo žiadne volanie kanála, a potom môže súbor ísť znova.
"received""source_error""validated""validation_failed""queued""submitting""submitted""ready""accepted""rejected""delivered""cancelled""dead_letter"legal_id?|Číslo KSeF, index nahratia do ANAF, ID dokumentu v prístupovom bode, ID faktúry vo francúzskej platforme.
buyer_status?string|nulldocument_sha256?|^[a-f0-9]{64}$attempts?array<>Skoršie podania tej istej invoice_ref (napríklad po odmietnutí a oprave).
errors?array<>documents?array<>created_at*stringdate-timeupdated_at*stringdate-timedeadline_at?stringOrientačný termín tejto faktúry, ako posledný okamih jej posledného povoleného dňa v UTC (dátumovú časť čítajte ako ten deň): dátum vystavenia plus päť pracovných dní pre Rumunsko (e-Factura), nasledujúci pracovný deň pre Poľsko (KSeF offline24). Dni sa počítajú od pondelka do piatka a sviatky sa neuplatňujú, takže skutočný termín môže byť neskôr, nikdy nie skôr; nie je to právna rada. Uvádza sa v každom stave faktúry; nehovorí, či bola faktúra včas alebo neskoro. Len pre tieto dva kanály a len keď faktúra nesie dátum vystavenia: POST /invoices s invoice.issue_date alebo od 0.19.2 súbor UBL (cbc:IssueDate) alebo súbor FA(3) (Fa/P_1) poslaný ako XML alebo vložený do priečinka. PDF žiadny nenesie a jeho absencia neznamená, že sa neuplatňuje žiadny termín. 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"}Zastavenie faktúry, ktorá ešte nebola podaná POST
Funguje len dovtedy, kým je faktúra received, validated alebo queued. Od 0.18.3, keď sa odoslanie skúsilo a jeho odpoveď sa stratila (časový limit alebo 5xx), faktúra je submitting a zrušenie odpovie 409 send-in-progress, pretože ju kanál môže mať; worker ju uzavrie ako submitted alebo dead_letter. Keď ju kanál má, zrušenie je obchodný doklad (dobropis alebo KOR v Poľsku), nie volanie API. Od 0.18.5 zrušenie faktúry, ktorá je už zrušená, odpovie 200 s ňou, takže opakovanie po stratenej odpovedi je bezpečné. Od 0.18.6 môže kľúč operátora zrušiť faktúru v dead_letter, ak sa pre ňu nikdy neuskutočnilo volanie kanála: nemôže byť na kanáli, takže ten istý dokument možno potom poslať znova. Ak sa volanie uskutočnilo, odpoveď je 409 dead-letter-reached-rail, pretože tam môže byť odoslanie, ktorého odpoveď sa stratila: najprv overte u kanála. Kľúč klienta dostane 409 dead-letter; rozhoduje operátor.
Stiahnutie vygenerovaného dokumentu alebo potvrdenia kanála GET
Druhy: canonical (JSON tak, ako prišiel), erp-export (export z ERP tak, ako ho poslalo ERP), súbor tak, ako bol odoslaný (ubl, cii, fa3, pdf), zostavený dokument (xrechnung-ubl pre Nemecko, inak ubl alebo fa3), validation-report a manifest (SHA-256 bajtov, ktoré idú na kanál, a vrstvy, ktoré ich skontrolovali). Štyri druhy JSON sa poskytujú ako application/json. ETag je SHA-256.