Zaustavi račun koji još nije predan
- U sandboxu
Jednostavnim riječima
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.
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}$Idempotency-Key*stringJedinstveni ključ za svaki logički zahtjev (UUID je dovoljan). Čuva se onoliko dugo koliko se čuvaju podaci klijenta. S ključem operatera ne smije počinjati s client: (400), oblikom pod kojim se spremaju ključevi klijenata.
8 <= length <= 100Otkazano prije predaje, dead letter koji nikad nije stigao do kanala (ključ operatera) ili već otkazano.
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 POST "https://example.com/invoices/inv_bd8bc8b276f38643f1c0f24f/cancel" \ -H "Authorization: Bearer <your-api-key>" \ -H "Idempotency-Key: order-2026-0001"{ "invoice_ref": "FRESH-mux3dlqm-0", "environment": "sandbox", "document_sha256": "b341c81da6fe297787829a8c26fd4b25106b5b34e67482d38c1039651bbfed65", "route": "DE-XRECHNUNG", "updated_at": "2026-10-06T19:49:10.992Z", "client": "acme-srl", "created_at": "2026-10-06T19:49:10.816Z", "id": "inv_ae4d9834bf251353532fe5ee", "state": "cancelled", "invoice_number": "FRESH-mux3dlqm-0"}Pohrani pristupne podatke, šifrirano; vrijednost se nikad ne vraća POST
Proces pohranjuje pristupne podatke samo za vlastito okruženje. legal_entity veže jedne pristupne podatke uz ID prodavatelja za kojeg djeluju (PDV ID, NIP, SIREN ili ID tvrtke); oni bez oznake služe ostalim računima klijenta. Admin ključ klijenta pohranjuje samo za svojeg klijenta.
Dohvati trenutno stanje računa GET
Sljedeća