{"openapi":"3.1.0","info":{"title":"Fiskalizacijski servis","version":"1.0.0","description":"Fiskalizacija računa (Fiskalizacija 1, CIS) preko REST API-ja."},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"fsk_live_... ili fsk_test_..."}},"schemas":{}},"paths":{"/v1/invoices":{"post":{"summary":"Izdaj i fiskaliziraj račun","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["premises","device","operatorOib","paymentMethod","items","totals"],"properties":{"premises":{"type":"string","pattern":"^[0-9A-Za-z]{1,20}$","description":"Oznaka poslovnog prostora"},"device":{"type":"string","pattern":"^\\d{1,20}$","description":"Oznaka naplatnog uređaja"},"operatorOib":{"type":"string","pattern":"^\\d{11}$","description":"OIB (11 znamenki)"},"paymentMethod":{"anyOf":[{"type":"string","enum":["G"]},{"type":"string","enum":["K"]},{"type":"string","enum":["T"]},{"type":"string","enum":["O"]}],"description":"G gotovina, K kartice, T transakcijski račun, O ostalo"},"buyerOib":{"anyOf":[{"type":"string","pattern":"^\\d{11}$","description":"OIB (11 znamenki)"},{"type":"null"}]},"items":{"type":"array","items":{"type":"object","required":["name","quantity","unitPrice"],"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"quantity":{"type":"string","pattern":"^-?\\d{1,9}(\\.\\d{1,3})?$","examples":["1"]},"unitPrice":{"type":"string","pattern":"^-?\\d{1,12}(\\.\\d{1,4})?$","description":"Jedinična cijena bez PDV-a","examples":["100.00"]},"vatRate":{"anyOf":[{"type":"string","pattern":"^\\d{1,3}\\.\\d{2}$","examples":["25.00"]},{"type":"null"}]}},"additionalProperties":false},"minItems":1,"maxItems":500},"totals":{"type":"object","required":["total"],"properties":{"vat":{"type":"array","items":{"type":"object","required":["rate","base","amount"],"properties":{"rate":{"type":"string","pattern":"^\\d{1,3}\\.\\d{2}$","examples":["25.00"]},"base":{"type":"string","pattern":"^-?\\d{1,12}\\.\\d{2}$","description":"Iznos u eurima kao decimalni string s dvije decimale","examples":["125.00"]},"amount":{"type":"string","pattern":"^-?\\d{1,12}\\.\\d{2}$","description":"Iznos u eurima kao decimalni string s dvije decimale","examples":["125.00"]}},"additionalProperties":false},"maxItems":20},"total":{"type":"string","pattern":"^-?\\d{1,12}\\.\\d{2}$","description":"Iznos u eurima kao decimalni string s dvije decimale","examples":["125.00"]}},"additionalProperties":false},"metadata":{"anyOf":[{"type":"object","maxProperties":50,"description":"Slobodni podaci aplikacije; vraćaju se nepromijenjeni","additionalProperties":{}},{"type":"null"}]}},"additionalProperties":false,"description":"Broj računa dodjeljuje servis; polje za broj nije dopušteno."}}},"description":"Broj računa dodjeljuje servis; polje za broj nije dopušteno."},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"header","name":"idempotency-key","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["id","number","premises","device","year","sequenceNumber","issuedAt","zki","jir","status","nakDost","issuedWithoutJir","deliveryDeadline","fiscalizedAt","paymentMethod","operatorOib","buyerOib","items","totals","metadata","stornoOf","stornedBy","initiatedBy","lastError","createdAt","updatedAt","qrPayload","qrUrl","pdfUrl"],"properties":{"id":{"type":"string"},"number":{"type":"string","examples":["17/POSL1/1"]},"premises":{"type":"string"},"device":{"type":"string"},"year":{"type":"integer"},"sequenceNumber":{"type":"integer"},"issuedAt":{"type":"string","description":"ISO 8601"},"zki":{"type":"string"},"jir":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["sending"]},{"type":"string","enum":["fiscalized"]},{"type":"string","enum":["delayed"]},{"type":"string","enum":["rejected"]}]},"nakDost":{"type":"boolean"},"issuedWithoutJir":{"type":"boolean"},"deliveryDeadline":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalizedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentMethod":{"type":"string"},"operatorOib":{"type":"string"},"buyerOib":{"anyOf":[{"type":"string"},{"type":"null"}]},"items":{"type":"array","items":{"type":"object","required":["name","quantity","unitPrice","vatRate"],"properties":{"name":{"type":"string"},"quantity":{"type":"string"},"unitPrice":{"type":"string"},"vatRate":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"totals":{"type":"object","required":["vat","total"],"properties":{"vat":{"type":"array","items":{"type":"object","required":["rate","base","amount"],"properties":{"rate":{"type":"string"},"base":{"type":"string"},"amount":{"type":"string"}}}},"total":{"type":"string"}}},"metadata":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"stornoOf":{"anyOf":[{"type":"string"},{"type":"null"}]},"stornedBy":{"anyOf":[{"type":"string"},{"type":"null"}]},"initiatedBy":{"anyOf":[{"type":"string","enum":["app"]},{"type":"string","enum":["admin"]}],"description":"Tko je pokrenuo račun ili promjenu: aplikacija (API) ili administratorsko sučelje"},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","description":"ISO 8601"},"updatedAt":{"type":"string","description":"ISO 8601"},"qrPayload":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sadržaj QR koda (URL Porezne uprave) za aplikacije koje same crtaju račun","examples":["https://porezna.gov.hr/rn?jir=4f2d...&datv=20261113_1047&izn=12500"]},"qrUrl":{"type":"string"},"pdfUrl":{"type":"string"}}}}}},"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["id","number","premises","device","year","sequenceNumber","issuedAt","zki","jir","status","nakDost","issuedWithoutJir","deliveryDeadline","fiscalizedAt","paymentMethod","operatorOib","buyerOib","items","totals","metadata","stornoOf","stornedBy","initiatedBy","lastError","createdAt","updatedAt","qrPayload","qrUrl","pdfUrl"],"properties":{"id":{"type":"string"},"number":{"type":"string","examples":["17/POSL1/1"]},"premises":{"type":"string"},"device":{"type":"string"},"year":{"type":"integer"},"sequenceNumber":{"type":"integer"},"issuedAt":{"type":"string","description":"ISO 8601"},"zki":{"type":"string"},"jir":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["sending"]},{"type":"string","enum":["fiscalized"]},{"type":"string","enum":["delayed"]},{"type":"string","enum":["rejected"]}]},"nakDost":{"type":"boolean"},"issuedWithoutJir":{"type":"boolean"},"deliveryDeadline":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalizedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentMethod":{"type":"string"},"operatorOib":{"type":"string"},"buyerOib":{"anyOf":[{"type":"string"},{"type":"null"}]},"items":{"type":"array","items":{"type":"object","required":["name","quantity","unitPrice","vatRate"],"properties":{"name":{"type":"string"},"quantity":{"type":"string"},"unitPrice":{"type":"string"},"vatRate":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"totals":{"type":"object","required":["vat","total"],"properties":{"vat":{"type":"array","items":{"type":"object","required":["rate","base","amount"],"properties":{"rate":{"type":"string"},"base":{"type":"string"},"amount":{"type":"string"}}}},"total":{"type":"string"}}},"metadata":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"stornoOf":{"anyOf":[{"type":"string"},{"type":"null"}]},"stornedBy":{"anyOf":[{"type":"string"},{"type":"null"}]},"initiatedBy":{"anyOf":[{"type":"string","enum":["app"]},{"type":"string","enum":["admin"]}],"description":"Tko je pokrenuo račun ili promjenu: aplikacija (API) ili administratorsko sučelje"},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","description":"ISO 8601"},"updatedAt":{"type":"string","description":"ISO 8601"},"qrPayload":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sadržaj QR koda (URL Porezne uprave) za aplikacije koje same crtaju račun","examples":["https://porezna.gov.hr/rn?jir=4f2d...&datv=20261113_1047&izn=12500"]},"qrUrl":{"type":"string"},"pdfUrl":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}}},"get":{"summary":"Lista računa","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-11-13","in":"query","name":"from","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-11-13","in":"query","name":"to","required":false},{"schema":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["sending"]},{"type":"string","enum":["fiscalized"]},{"type":"string","enum":["delayed"]},{"type":"string","enum":["rejected"]}]},"in":"query","name":"status","required":false},{"schema":{"type":"string","pattern":"^[0-9A-Za-z]{1,20}$"},"in":"query","name":"premises","required":false},{"schema":{"type":"string","pattern":"^\\d{1,20}$"},"in":"query","name":"device","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"updatedSince","required":false,"description":"Samo računi promijenjeni nakon ovog trenutka, najstarija promjena prva. Za periodičnu provjeru stanja; preporučeno je preklapanje od nekoliko minuta."},{"schema":{"type":"string","maxLength":200},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","pattern":"^\\d{1,3}$"},"in":"query","name":"limit","required":false,"description":"1 do 200, zadano 50"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["items","nextCursor"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","number","premises","device","year","sequenceNumber","issuedAt","zki","jir","status","nakDost","issuedWithoutJir","deliveryDeadline","fiscalizedAt","paymentMethod","operatorOib","buyerOib","items","totals","metadata","stornoOf","stornedBy","initiatedBy","lastError","createdAt","updatedAt","qrPayload","qrUrl","pdfUrl"],"properties":{"id":{"type":"string"},"number":{"type":"string","examples":["17/POSL1/1"]},"premises":{"type":"string"},"device":{"type":"string"},"year":{"type":"integer"},"sequenceNumber":{"type":"integer"},"issuedAt":{"type":"string","description":"ISO 8601"},"zki":{"type":"string"},"jir":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["sending"]},{"type":"string","enum":["fiscalized"]},{"type":"string","enum":["delayed"]},{"type":"string","enum":["rejected"]}]},"nakDost":{"type":"boolean"},"issuedWithoutJir":{"type":"boolean"},"deliveryDeadline":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalizedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentMethod":{"type":"string"},"operatorOib":{"type":"string"},"buyerOib":{"anyOf":[{"type":"string"},{"type":"null"}]},"items":{"type":"array","items":{"type":"object","required":["name","quantity","unitPrice","vatRate"],"properties":{"name":{"type":"string"},"quantity":{"type":"string"},"unitPrice":{"type":"string"},"vatRate":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"totals":{"type":"object","required":["vat","total"],"properties":{"vat":{"type":"array","items":{"type":"object","required":["rate","base","amount"],"properties":{"rate":{"type":"string"},"base":{"type":"string"},"amount":{"type":"string"}}}},"total":{"type":"string"}}},"metadata":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"stornoOf":{"anyOf":[{"type":"string"},{"type":"null"}]},"stornedBy":{"anyOf":[{"type":"string"},{"type":"null"}]},"initiatedBy":{"anyOf":[{"type":"string","enum":["app"]},{"type":"string","enum":["admin"]}],"description":"Tko je pokrenuo račun ili promjenu: aplikacija (API) ili administratorsko sučelje"},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","description":"ISO 8601"},"updatedAt":{"type":"string","description":"ISO 8601"},"qrPayload":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sadržaj QR koda (URL Porezne uprave) za aplikacije koje same crtaju račun","examples":["https://porezna.gov.hr/rn?jir=4f2d...&datv=20261113_1047&izn=12500"]},"qrUrl":{"type":"string"},"pdfUrl":{"type":"string"}}}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}}}},"/v1/invoices/{id}":{"get":{"summary":"Stanje računa, pokušaji slanja i promjene","parameters":[{"schema":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"allOf":[{"type":"object","required":["id","number","premises","device","year","sequenceNumber","issuedAt","zki","jir","status","nakDost","issuedWithoutJir","deliveryDeadline","fiscalizedAt","paymentMethod","operatorOib","buyerOib","items","totals","metadata","stornoOf","stornedBy","initiatedBy","lastError","createdAt","updatedAt","qrPayload","qrUrl","pdfUrl"],"properties":{"id":{"type":"string"},"number":{"type":"string","examples":["17/POSL1/1"]},"premises":{"type":"string"},"device":{"type":"string"},"year":{"type":"integer"},"sequenceNumber":{"type":"integer"},"issuedAt":{"type":"string","description":"ISO 8601"},"zki":{"type":"string"},"jir":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["sending"]},{"type":"string","enum":["fiscalized"]},{"type":"string","enum":["delayed"]},{"type":"string","enum":["rejected"]}]},"nakDost":{"type":"boolean"},"issuedWithoutJir":{"type":"boolean"},"deliveryDeadline":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalizedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentMethod":{"type":"string"},"operatorOib":{"type":"string"},"buyerOib":{"anyOf":[{"type":"string"},{"type":"null"}]},"items":{"type":"array","items":{"type":"object","required":["name","quantity","unitPrice","vatRate"],"properties":{"name":{"type":"string"},"quantity":{"type":"string"},"unitPrice":{"type":"string"},"vatRate":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"totals":{"type":"object","required":["vat","total"],"properties":{"vat":{"type":"array","items":{"type":"object","required":["rate","base","amount"],"properties":{"rate":{"type":"string"},"base":{"type":"string"},"amount":{"type":"string"}}}},"total":{"type":"string"}}},"metadata":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"stornoOf":{"anyOf":[{"type":"string"},{"type":"null"}]},"stornedBy":{"anyOf":[{"type":"string"},{"type":"null"}]},"initiatedBy":{"anyOf":[{"type":"string","enum":["app"]},{"type":"string","enum":["admin"]}],"description":"Tko je pokrenuo račun ili promjenu: aplikacija (API) ili administratorsko sučelje"},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","description":"ISO 8601"},"updatedAt":{"type":"string","description":"ISO 8601"},"qrPayload":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sadržaj QR koda (URL Porezne uprave) za aplikacije koje same crtaju račun","examples":["https://porezna.gov.hr/rn?jir=4f2d...&datv=20261113_1047&izn=12500"]},"qrUrl":{"type":"string"},"pdfUrl":{"type":"string"}}},{"type":"object","required":["attempts","changes"],"properties":{"attempts":{"type":"array","items":{"type":"object","required":["id","message","changeId","nakDost","startedAt","finishedAt","httpStatus","success","errors","errorMessage","signatureValid"],"properties":{"id":{"type":"string"},"message":{"type":"string"},"changeId":{"anyOf":[{"type":"string"},{"type":"null"}]},"nakDost":{"type":"boolean"},"startedAt":{"type":"string","description":"ISO 8601"},"finishedAt":{"type":"string","description":"ISO 8601"},"httpStatus":{"anyOf":[{"type":"integer"},{"type":"null"}]},"success":{"type":"boolean"},"errors":{},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"signatureValid":{"anyOf":[{"type":"boolean"},{"type":"null"}]}}}},"changes":{"type":"array","items":{"type":"object","required":["id","invoiceId","kind","status","previous","new","createdAt","doneAt","lastError","initiatedBy"],"properties":{"id":{"type":"string"},"invoiceId":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["paymentMethod"]},{"type":"string","enum":["data"]}]},"status":{"type":"string"},"previous":{"type":"object","required":["paymentMethod","buyerOib"],"properties":{"paymentMethod":{"type":"string"},"buyerOib":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"new":{"type":"object","required":["paymentMethod","buyerOib"],"properties":{"paymentMethod":{"type":"string"},"buyerOib":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"createdAt":{"type":"string","description":"ISO 8601"},"doneAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"initiatedBy":{"anyOf":[{"type":"string","enum":["app"]},{"type":"string","enum":["admin"]}],"description":"Tko je pokrenuo račun ili promjenu: aplikacija (API) ili administratorsko sučelje"}}}}}}]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}}}},"/v1/invoices/{id}/storno":{"post":{"summary":"Storno računa (novi račun s negativnim iznosima)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"device":{"type":"string","pattern":"^\\d{1,20}$"},"operatorOib":{"type":"string","pattern":"^\\d{11}$","description":"OIB (11 znamenki)"},"paymentMethod":{"anyOf":[{"type":"string","enum":["G"]},{"type":"string","enum":["K"]},{"type":"string","enum":["T"]},{"type":"string","enum":["O"]}],"description":"G gotovina, K kartice, T transakcijski račun, O ostalo"},"metadata":{"anyOf":[{"type":"object","maxProperties":50,"description":"Slobodni podaci aplikacije; vraćaju se nepromijenjeni","additionalProperties":{}},{"type":"null"}]}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"in":"path","name":"id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"header","name":"idempotency-key","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["id","number","premises","device","year","sequenceNumber","issuedAt","zki","jir","status","nakDost","issuedWithoutJir","deliveryDeadline","fiscalizedAt","paymentMethod","operatorOib","buyerOib","items","totals","metadata","stornoOf","stornedBy","initiatedBy","lastError","createdAt","updatedAt","qrPayload","qrUrl","pdfUrl"],"properties":{"id":{"type":"string"},"number":{"type":"string","examples":["17/POSL1/1"]},"premises":{"type":"string"},"device":{"type":"string"},"year":{"type":"integer"},"sequenceNumber":{"type":"integer"},"issuedAt":{"type":"string","description":"ISO 8601"},"zki":{"type":"string"},"jir":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["sending"]},{"type":"string","enum":["fiscalized"]},{"type":"string","enum":["delayed"]},{"type":"string","enum":["rejected"]}]},"nakDost":{"type":"boolean"},"issuedWithoutJir":{"type":"boolean"},"deliveryDeadline":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalizedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentMethod":{"type":"string"},"operatorOib":{"type":"string"},"buyerOib":{"anyOf":[{"type":"string"},{"type":"null"}]},"items":{"type":"array","items":{"type":"object","required":["name","quantity","unitPrice","vatRate"],"properties":{"name":{"type":"string"},"quantity":{"type":"string"},"unitPrice":{"type":"string"},"vatRate":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"totals":{"type":"object","required":["vat","total"],"properties":{"vat":{"type":"array","items":{"type":"object","required":["rate","base","amount"],"properties":{"rate":{"type":"string"},"base":{"type":"string"},"amount":{"type":"string"}}}},"total":{"type":"string"}}},"metadata":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"stornoOf":{"anyOf":[{"type":"string"},{"type":"null"}]},"stornedBy":{"anyOf":[{"type":"string"},{"type":"null"}]},"initiatedBy":{"anyOf":[{"type":"string","enum":["app"]},{"type":"string","enum":["admin"]}],"description":"Tko je pokrenuo račun ili promjenu: aplikacija (API) ili administratorsko sučelje"},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","description":"ISO 8601"},"updatedAt":{"type":"string","description":"ISO 8601"},"qrPayload":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sadržaj QR koda (URL Porezne uprave) za aplikacije koje same crtaju račun","examples":["https://porezna.gov.hr/rn?jir=4f2d...&datv=20261113_1047&izn=12500"]},"qrUrl":{"type":"string"},"pdfUrl":{"type":"string"}}}}}},"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["id","number","premises","device","year","sequenceNumber","issuedAt","zki","jir","status","nakDost","issuedWithoutJir","deliveryDeadline","fiscalizedAt","paymentMethod","operatorOib","buyerOib","items","totals","metadata","stornoOf","stornedBy","initiatedBy","lastError","createdAt","updatedAt","qrPayload","qrUrl","pdfUrl"],"properties":{"id":{"type":"string"},"number":{"type":"string","examples":["17/POSL1/1"]},"premises":{"type":"string"},"device":{"type":"string"},"year":{"type":"integer"},"sequenceNumber":{"type":"integer"},"issuedAt":{"type":"string","description":"ISO 8601"},"zki":{"type":"string"},"jir":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["sending"]},{"type":"string","enum":["fiscalized"]},{"type":"string","enum":["delayed"]},{"type":"string","enum":["rejected"]}]},"nakDost":{"type":"boolean"},"issuedWithoutJir":{"type":"boolean"},"deliveryDeadline":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalizedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentMethod":{"type":"string"},"operatorOib":{"type":"string"},"buyerOib":{"anyOf":[{"type":"string"},{"type":"null"}]},"items":{"type":"array","items":{"type":"object","required":["name","quantity","unitPrice","vatRate"],"properties":{"name":{"type":"string"},"quantity":{"type":"string"},"unitPrice":{"type":"string"},"vatRate":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"totals":{"type":"object","required":["vat","total"],"properties":{"vat":{"type":"array","items":{"type":"object","required":["rate","base","amount"],"properties":{"rate":{"type":"string"},"base":{"type":"string"},"amount":{"type":"string"}}}},"total":{"type":"string"}}},"metadata":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"stornoOf":{"anyOf":[{"type":"string"},{"type":"null"}]},"stornedBy":{"anyOf":[{"type":"string"},{"type":"null"}]},"initiatedBy":{"anyOf":[{"type":"string","enum":["app"]},{"type":"string","enum":["admin"]}],"description":"Tko je pokrenuo račun ili promjenu: aplikacija (API) ili administratorsko sučelje"},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","description":"ISO 8601"},"updatedAt":{"type":"string","description":"ISO 8601"},"qrPayload":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sadržaj QR koda (URL Porezne uprave) za aplikacije koje same crtaju račun","examples":["https://porezna.gov.hr/rn?jir=4f2d...&datv=20261113_1047&izn=12500"]},"qrUrl":{"type":"string"},"pdfUrl":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}}}},"/v1/invoices/{id}/payment-method":{"post":{"summary":"Promjena načina plaćanja (isti dan)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["paymentMethod"],"properties":{"paymentMethod":{"anyOf":[{"type":"string","enum":["G"]},{"type":"string","enum":["K"]},{"type":"string","enum":["T"]},{"type":"string","enum":["O"]}],"description":"G gotovina, K kartice, T transakcijski račun, O ostalo"}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"in":"path","name":"id","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["id","invoiceId","kind","status","previous","new","createdAt","doneAt","lastError","initiatedBy"],"properties":{"id":{"type":"string"},"invoiceId":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["paymentMethod"]},{"type":"string","enum":["data"]}]},"status":{"type":"string"},"previous":{"type":"object","required":["paymentMethod","buyerOib"],"properties":{"paymentMethod":{"type":"string"},"buyerOib":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"new":{"type":"object","required":["paymentMethod","buyerOib"],"properties":{"paymentMethod":{"type":"string"},"buyerOib":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"createdAt":{"type":"string","description":"ISO 8601"},"doneAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"initiatedBy":{"anyOf":[{"type":"string","enum":["app"]},{"type":"string","enum":["admin"]}],"description":"Tko je pokrenuo račun ili promjenu: aplikacija (API) ili administratorsko sučelje"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}}}},"/v1/invoices/{id}/changes":{"post":{"summary":"Promjena načina plaćanja i/ili OIB-a kupca (isti dan)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"paymentMethod":{"anyOf":[{"type":"string","enum":["G"]},{"type":"string","enum":["K"]},{"type":"string","enum":["T"]},{"type":"string","enum":["O"]}],"description":"G gotovina, K kartice, T transakcijski račun, O ostalo"},"buyerOib":{"anyOf":[{"type":"string","pattern":"^\\d{11}$","description":"OIB (11 znamenki)"},{"type":"null"}],"description":"null briše OIB kupca"}},"additionalProperties":false,"minProperties":1}}}},"parameters":[{"schema":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"in":"path","name":"id","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["id","invoiceId","kind","status","previous","new","createdAt","doneAt","lastError","initiatedBy"],"properties":{"id":{"type":"string"},"invoiceId":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["paymentMethod"]},{"type":"string","enum":["data"]}]},"status":{"type":"string"},"previous":{"type":"object","required":["paymentMethod","buyerOib"],"properties":{"paymentMethod":{"type":"string"},"buyerOib":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"new":{"type":"object","required":["paymentMethod","buyerOib"],"properties":{"paymentMethod":{"type":"string"},"buyerOib":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"createdAt":{"type":"string","description":"ISO 8601"},"doneAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"initiatedBy":{"anyOf":[{"type":"string","enum":["app"]},{"type":"string","enum":["admin"]}],"description":"Tko je pokrenuo račun ili promjenu: aplikacija (API) ili administratorsko sučelje"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}}}},"/v1/invoices/{id}/qr.png":{"get":{"summary":"QR kod računa (PNG)","parameters":[{"schema":{"type":"string","pattern":"^\\d{1,4}$"},"in":"query","name":"size","required":false,"description":"Širina PNG-a u pikselima, 128 do 2048 (zadano 512)"},{"schema":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"QR kod","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}}}},"/v1/invoices/{id}/qr.svg":{"get":{"summary":"QR kod računa (SVG)","parameters":[{"schema":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"QR kod","content":{"image/svg+xml":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}}}},"/v1/invoices/{id}/pdf":{"get":{"summary":"PDF računa (A4 ili termalni 80 mm)","parameters":[{"schema":{"anyOf":[{"type":"string","enum":["a4"]},{"type":"string","enum":["receipt"]}]},"in":"query","name":"format","required":false,"description":"a4 ili receipt (termalni 80 mm); zadano prema postavkama tenanta"},{"schema":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"PDF računa kakav je izdan","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}}}},"/v1/premises":{"get":{"summary":"Poslovni prostori i naplatni uređaji tenanta","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","required":["premises","active","devices"],"properties":{"premises":{"type":"string"},"active":{"type":"boolean"},"devices":{"type":"array","items":{"type":"object","required":["device","active"],"properties":{"device":{"type":"string"},"active":{"type":"boolean"}}}}}}}}}}}}}}}},"security":[{"apiKey":[]}]}