Skip to main content

Izlazni računi

Izrada nacrta​

POST/public/v1/outgoing-invoices

Ruta prihvaća strukturirani JSON ili izvorni UBL. Bez issue: true rezultat je nacrt i vraća 201 Created. Automatsko izdavanje vraća 202 Accepted i zapis operacije.

Strukturirani unos preuzima sigurnije zadane vrijednosti iz profila API klijenta: dobavljača, operatora i zadani konto prodaje. Klijent ne može promijeniti organizaciju slanjem drugog OIB-a.

Promjena strukturiranog nacrta​

PATCH/public/v1/outgoing-invoices/{invoiceId}

Nacrt iz izvornog UBL-a ne može se mijenjati strukturiranim PATCH zahtjevom. Ako morate promijeniti izvorni XML, otkažite nacrt u vlastitom toku i izradite novi. Time se izbjegava nesklad između spremljenog XML-a i interne projekcije.

Validacija bez izdavanja​

POST/public/v1/outgoing-invoices/{invoiceId}/validate

Provodi exchange i fiskalizacijsku validaciju nad efektivnim UBL-om, ali ne šalje dokument.

{
  "valid": true,
  "sourceFormat": "RAW_UBL",
  "canonicalSha256": "4d5d..."
}

Izdavanje​

POST/public/v1/outgoing-invoices/{invoiceId}/issue

Klik Račun zatim:

  1. zaključava stanje podmirenja i lanac dokumenta;
  2. odabire autoritativnu rutu primatelja;
  3. ponovno validira stvarni UBL;
  4. provodi AS4 slanje ili evidentira nedokumentiranu dostavu;
  5. izvodi fiskalizaciju tek kada su ispunjeni preduvjeti dostave;
  6. sprema vanjske identifikatore i terminalni ishod.

Za AS4 se fiskalizacija ne proglašava završenom prije potvrđene dostave. Za FISCALIZATION_ONLY Klik Račun može autoritativno prebaciti tok na NON_AS4_REPORTING kada otkrivanje primatelja pokaže da AS4 nije raspoloživ.

Čitanje i filtriranje​

GET /public/v1/outgoing-invoices?status=ISSUED&from=2026-09-01&to=2026-09-30&limit=100
GET /public/v1/outgoing-invoices/{invoiceId}
GET /public/v1/outgoing-invoices/{invoiceId}/status
GET /public/v1/outgoing-invoices/{invoiceId}/extract-xml/ubl