Potpuna API referenca

Ova se stranica izrađuje iz mjerodavnog OpenAPI ugovora. Otvorite pojedini odjeljak samo kada vam treba; nijedan parametar ili polje tijela zahtjeva nije prepušteno nagađanju.

Osnovna adresa: https://iiproxy.sekkun.co

Preuzmi OpenAPI 3.1 YAML

Dostupnost i autentikacija

`GET /public/v1/ping`

Provjera dostupnosti Public API-ja

Potrebne ovlasti: Javna ruta

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Usluga je dostupna.	—

`POST /oauth2/token`

Zamjena vjerodajnica klijenta za pristupni token

Potrebne ovlasti: HTTP Basic (client_id + client_secret)

Tijelo zahtjeva

`application/x-www-form-urlencoded`

Polje	Vrsta	Pravila	Značenje
`grant_type`	string	`obvezno; = client_credentials`	Mora biti client_credentials.
`scope`	string	`neobvezno`	Razmacima odvojen podskup ovlasti dodijeljenih klijentu.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Pristupni token.	application/json
`401`	Zaštitna ili validacijska pogreška.	application/json

`POST /public/v1/oauth2/token`

Verzionirana ruta za dohvat pristupnog tokena

Potrebne ovlasti: HTTP Basic (client_id + client_secret)

Tijelo zahtjeva

`application/x-www-form-urlencoded`

Polje	Vrsta	Pravila	Značenje
`grant_type`	string	`obvezno; = client_credentials`	Mora biti client_credentials.
`scope`	string	`neobvezno`	Razmacima odvojen podskup ovlasti dodijeljenih klijentu.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Pristupni token.	application/json
`401`	Zaštitna ili validacijska pogreška.	application/json

Izlazni računi

`GET /public/v1/outgoing-invoices`

Popis izlaznih računa organizacije vezane uz vjerodajnicu

Potrebne ovlasti: invoices:read

Parametri upita

Polje	Vrsta	Pravila	Značenje
`status`	string	`neobvezno`	Jedinstveni status dokumenta.
`documentNumber`	string	`neobvezno`	Filtrira prema broju dokumenta ili njegovu dijelu.
`from`	string (date)	`neobvezno`	Početni datum izdavanja, uključivo.
`to`	string (date)	`neobvezno`	Završni datum izdavanja, uključivo.
`limit`	integer	`neobvezno; zadano: 1000; ≥ 1`	Najveći broj rezultata.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Popis računa.	application/json

`POST /public/v1/outgoing-invoices`

Izrada nacrta iz strukturiranih podataka ili izvornog UBL-a

Potrebne ovlasti: invoices:draft

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Idempotency-Key`	string	`obvezno; min 16; max 100`	Jedinstveni ključ sigurnog ponavljanja zahtjeva.
`IIProxy-Auto-Issue`	boolean	`neobvezno`	Vrijednost true stvara nacrt i odmah pokreće izdavanje.
`IIProxy-Delivery-Channel`	string	`neobvezno; AS4 · FISCALIZATION_ONLY`	Traženi kanal dostave za izravni XML.

Tijelo zahtjeva

`application/json` - inačica 1

Polje	Vrsta	Pravila	Značenje
`documentNumber`	string	`neobvezno`	Broj dokumenta; uz ručno numeriranje mora biti zadan.
`numberMode`	string	`neobvezno; AUTO · MANUAL; zadano: AUTO`	Automatsko ili ručno numeriranje.
`issueDate`	string (date)	`obvezno`	Datum izdavanja u obliku GGGG-MM-DD.
`deliveryDate`	string (date)	`obvezno`	Datum isporuke u obliku GGGG-MM-DD.
`dueDate`	string \| null (date)	`neobvezno`	Datum dospijeća ili null kada nije primjenjiv.
`currency`	string	`neobvezno; zadano: EUR; min 3; max 3`	Troslovna oznaka valute prema ISO 4217.
`documentType`	string	`neobvezno; Invoice · CreditNote · AdvanceInvoice; zadano: Invoice`	Poslovna vrsta dokumenta.
`paymentModel`	string	`neobvezno; DUE · ADVANCE_AND_BALANCE · ONSITE · ADVANCE_DECLARATION; zadano: DUE`	Pravila dospijeća, naplate i predujma.
`deliveryChannel`	string	`neobvezno; AS4 · FISCALIZATION_ONLY; zadano: AS4`	Traženi kanal dostave.
`supplier`	object	`neobvezno`	Neobvezna potvrda vlasništva; podatke izdavatelja određuje vjerodajnica.
`supplier.oib`	string	`neobvezno; pattern: ^[0-9]{11}$`	OIB od točno 11 znamenaka.
`customer`	object	`obvezno`	Podaci primatelja računa.
`customer.partnerId`	string (uuid)	`neobvezno`	Identifikator partnera u matičnim podacima sustava Klik Račun.
`customer.partnerCode`	string	`neobvezno`	Šifra partnera.
`customer.name`	string	`obvezno`	Naziv.
`customer.fullName`	string	`neobvezno`	Puni pravni naziv.
`customer.shortName`	string	`neobvezno`	Skraćeni naziv.
`customer.oib`	string	`obvezno; pattern: ^[0-9]{11}$`	OIB od točno 11 znamenaka.
`customer.endpointScheme`	string	`neobvezno; zadano: 9934; max 16`	Shema elektroničke adrese.
`customer.countryCode`	string	`neobvezno; zadano: HR; min 2; max 2`	Dvoslovna oznaka države prema ISO 3166-1.
`customer.vatId`	string	`neobvezno`	PDV identifikacijski broj.
`customer.city`	string	`neobvezno`	Grad.
`customer.postalCode`	string	`neobvezno`	Poštanski broj.
`customer.streetAddress`	string	`neobvezno`	Ulica i kućni broj.
`customer.additionalAddress`	string	`neobvezno`	Dodatni redak adrese.
`customer.addressDetails`	string	`neobvezno`	Dodatne pojedinosti adrese.
`customer.county`	string	`neobvezno`	Županija ili regija.
`customer.contactEmail`	string (email)	`neobvezno`	Adresa e-pošte za kontakt.
`lines`	array [object]	`obvezno; min 1`	Najmanje jedna stavka računa.
`lines.articleId`	string (uuid)	`neobvezno`	Identifikator artikla u matičnim podacima sustava Klik Račun.
`lines.code`	string	`neobvezno`	Šifra.
`lines.name`	string	`obvezno`	Naziv.
`lines.quantity`	number	`obvezno; > 0`	Pozitivna količina.
`lines.unitCode`	string	`neobvezno; zadano: EA; max 16`	UNECE oznaka mjerne jedinice.
`lines.unitPrice`	number	`obvezno; ≥ 0`	Neto jedinična cijena prije PDV-a.
`lines.taxCode`	string	`obvezno`	Šifra poreza u matičnim podacima sustava Klik Račun.
`lines.taxRate`	number	`obvezno; ≥ 0`	Primijenjena stopa PDV-a u postotku.
`lines.ublTaxCategory`	string	`neobvezno; zadano: S; max 16`	Porezna kategorija prema EN 16931/UBL-u.
`lines.ublHrTaxCategory`	string	`neobvezno`	Oznaka hrvatske proširene porezne kategorije.
`lines.taxCategoryCode`	string	`neobvezno`	Šifra porezne kategorije u sustavu Klik Račun.
`lines.classification`	object	`obvezno`	KPD klasifikacija stavke.
`lines.classification.value`	string	`obvezno`	Vrijednost KPD klasifikacije.
`lines.classification.schemeId`	string	`neobvezno; = CG; zadano: CG`	Oznaka KPD sheme; mora biti CG.
`lines.classification.schemeVersionId`	string	`neobvezno`	Inačica KPD sheme.
`lines.salesAccountId`	string (uuid)	`neobvezno`	Identifikator konta prihoda.
`additionalTaxes`	array [object]	`neobvezno`	Dodatni hrvatski porezi i naknade.
`additionalTaxes.code`	string	`obvezno`	Šifra.
`additionalTaxes.description`	string	`obvezno`	Opis.
`additionalTaxes.hrCategory`	string	`obvezno; HR:PP · HR:PPMV · HR:POVNAK · HR:N`	Hrvatska kategorija dodatnog poreza.
`additionalTaxes.taxableAmount`	number	`obvezno; ≥ 0`	Porezna osnovica.
`additionalTaxes.rate`	number	`obvezno; ≥ 0`	Porezna stopa u postotku.
`notes`	array [string]	`neobvezno`	Napomene na računu.
`paymentInstructions`	object	`neobvezno`	Upute za plaćanje prikazane na računu.
`paymentInstructions.meansCode`	string	`neobvezno; zadano: 30; pattern: ^(?:[0-9]{1,3}\|ZZZ)$`	Oznaka načina plaćanja prema UNCL 4461.
`paymentInstructions.iban`	string	`neobvezno`	IBAN primatelja plaćanja.
`paymentInstructions.bic`	string	`neobvezno`	BIC banke primatelja.
`paymentInstructions.accountName`	string	`neobvezno`	Naziv računa primatelja.
`paymentInstructions.paymentReference`	string	`neobvezno`	Poziv na broj ili druga oznaka plaćanja.
`paymentInstructions.model`	string	`neobvezno; pattern: ^HR[0-9]{2}$`	Hrvatski model poziva na broj u obliku HRxx.
`paymentInstructions.purposeCode`	string	`neobvezno`	Oznaka namjene plaćanja.
`paymentInstructions.description`	string	`neobvezno`	Opis.
`paymentInstructions.terms`	string	`neobvezno`	Uvjeti plaćanja.
`paymentProfileId`	string (uuid)	`neobvezno`	Identifikator aktivnog profila plaćanja; njegove upute imaju prednost pred paymentInstructions.
`initialPayments`	array [object]	`neobvezno`	Uplate evidentirane pri izradi dokumenta.
`initialPayments.methodCode`	string	`obvezno`	Oznaka načina plaćanja.
`initialPayments.paymentDate`	string (date)	`obvezno`	Datum uplate u obliku GGGG-MM-DD.
`initialPayments.amount`	number	`obvezno; > 0`	Pozitivan novčani iznos u valuti računa.
`initialPayments.referenceNumber`	string	`neobvezno`	Bankovna, procesorska ili interna oznaka transakcije.
`initialPayments.note`	string	`neobvezno`	Neobvezna napomena.
`stagedReferences`	array [object]	`neobvezno`	Poslovne reference i prilozi koji se dodaju pri izradi nacrta.
`stagedReferences.referenceKind`	string	`obvezno; RECURRING_CONTRACT · BUYER_CONTRACT · SALES_ORDER · PURCHASE_ORDER · DESPATCH · RECEIPT · TENDER · OFFER · SUPPORTING_DOCUMENT · BUYER_REFERENCE · PROJECT · INVOICED_OBJECT · BUYER_COST_CENTER · PREVIOUS_INVOICE`	Vrsta poslovne ili dokumentne reference.
`stagedReferences.inputMode`	string	`neobvezno; MANUAL · SYSTEM`	Ručni unos ili odabir zapisa iz sustava Klik Račun.
`stagedReferences.internalEntityId`	string (uuid)	`neobvezno`	Identifikator zapisa odabranog u sustavu Klik Račun.
`stagedReferences.documentNumber`	string	`neobvezno`	Broj dokumenta; uz ručno numeriranje mora biti zadan.
`stagedReferences.documentDate`	string (date)	`neobvezno`	Datum referenciranog dokumenta.
`stagedReferences.description`	string	`neobvezno`	Opis.
`stagedReferences.externalUrl`	string (uri)	`neobvezno`	Vanjska poveznica na prateći dokument.
`stagedReferences.attachment`	object	`neobvezno`	Ugrađeni prilog.
`stagedReferences.attachment.name`	string	`obvezno`	Naziv.
`stagedReferences.attachment.type`	string	`obvezno`	Vrsta sadržaja priloga.
`stagedReferences.attachment.data`	string (byte)	`obvezno`	Sadržaj priloga kodiran u Base64 obliku.
`stagedReferences.attachment.size`	integer	`neobvezno; ≥ 0`	Dekodirana veličina priloga u bajtovima.
`salesAccountId`	string (uuid)	`neobvezno`	Identifikator konta prihoda.
`splitSalesAccounts`	boolean	`neobvezno; zadano: false`	Ako je true, svaka stavka mora imati vlastiti salesAccountId.
`issue`	boolean	`neobvezno; zadano: false`	Ako je true, nakon izrade odmah pokreće zaštićeno izdavanje.
`advanceApplications`	array [object]	`neobvezno`	Predujmovi koji se rezerviraju i koriste prije izdavanja.
`advanceApplications.sourceInvoiceId`	string (uuid)	`neobvezno`	Identifikator prihvaćenog predujma u sustavu Klik Račun.
`advanceApplications.documentNumber`	string	`neobvezno`	Broj dokumenta; uz ručno numeriranje mora biti zadan.
`advanceApplications.issueDate`	string (date)	`neobvezno`	Datum izdavanja u obliku GGGG-MM-DD.
`advanceApplications.amount`	number	`obvezno; > 0`	Pozitivan novčani iznos u valuti računa.

`application/json` - inačica 2

Polje	Vrsta	Pravila	Značenje
`format`	string	`obvezno; = UBL`	Mora biti UBL.
`ublXml`	string	`obvezno`	Cijeli samostalni UBL XML dokument.
`salesAccountId`	string (uuid)	`neobvezno`	Identifikator konta prihoda.
`deliveryChannel`	string	`neobvezno; AS4 · FISCALIZATION_ONLY`	Traženi kanal dostave.
`issue`	boolean	`neobvezno`	Ako je true, nakon izrade odmah pokreće zaštićeno izdavanje.
`advanceApplications`	array [object]	`neobvezno`	Predujmovi koji se rezerviraju i koriste prije izdavanja.
`advanceApplications.sourceInvoiceId`	string (uuid)	`neobvezno`	Identifikator prihvaćenog predujma u sustavu Klik Račun.
`advanceApplications.documentNumber`	string	`neobvezno`	Broj dokumenta; uz ručno numeriranje mora biti zadan.
`advanceApplications.issueDate`	string (date)	`neobvezno`	Datum izdavanja u obliku GGGG-MM-DD.
`advanceApplications.amount`	number	`obvezno; > 0`	Pozitivan novčani iznos u valuti računa.

`application/xml`

Pošaljite cijeli samostalni UBL 2.1/HR-CIUS Invoice ili CreditNote XML dokument. Ne šalje se FIS poruka Porezne uprave.

`text/xml`

Pošaljite cijeli samostalni UBL 2.1/HR-CIUS Invoice ili CreditNote XML dokument. Ne šalje se FIS poruka Porezne uprave.

`application/ubl+xml`

Pošaljite cijeli samostalni UBL 2.1/HR-CIUS Invoice ili CreditNote XML dokument. Ne šalje se FIS poruka Porezne uprave.

Odgovori

Status	Opis	Vrsta sadržaja
`201`	Račun.	application/json
`202`	Račun je izrađen, a izdavanje je stavljeno u red čekanja.	application/json
`422`	Zaštitna ili validacijska pogreška.	application/json

`GET /public/v1/outgoing-invoices/{invoiceId}`

Dohvat izlaznog računa

Potrebne ovlasti: invoices:read

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`invoiceId`	string (uuid)	`obvezno`	Identifikator izlaznog računa u sustavu Klik Račun.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Račun.	application/json
`404`	Zaštitna ili validacijska pogreška.	application/json

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

Promjena strukturiranog nacrta

Potrebne ovlasti: invoices:draft

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`invoiceId`	string (uuid)	`obvezno`	Identifikator izlaznog računa u sustavu Klik Račun.

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Idempotency-Key`	string	`obvezno; min 16; max 100`	Jedinstveni ključ sigurnog ponavljanja zahtjeva.

Tijelo zahtjeva

`application/json`

Polje	Vrsta	Pravila	Značenje
`documentNumber`	string	`neobvezno`	Broj dokumenta; uz ručno numeriranje mora biti zadan.
`numberMode`	string	`neobvezno; AUTO · MANUAL; zadano: AUTO`	Automatsko ili ručno numeriranje.
`issueDate`	string (date)	`obvezno`	Datum izdavanja u obliku GGGG-MM-DD.
`deliveryDate`	string (date)	`obvezno`	Datum isporuke u obliku GGGG-MM-DD.
`dueDate`	string \| null (date)	`neobvezno`	Datum dospijeća ili null kada nije primjenjiv.
`currency`	string	`neobvezno; zadano: EUR; min 3; max 3`	Troslovna oznaka valute prema ISO 4217.
`documentType`	string	`neobvezno; Invoice · CreditNote · AdvanceInvoice; zadano: Invoice`	Poslovna vrsta dokumenta.
`paymentModel`	string	`neobvezno; DUE · ADVANCE_AND_BALANCE · ONSITE · ADVANCE_DECLARATION; zadano: DUE`	Pravila dospijeća, naplate i predujma.
`deliveryChannel`	string	`neobvezno; AS4 · FISCALIZATION_ONLY; zadano: AS4`	Traženi kanal dostave.
`supplier`	object	`neobvezno`	Neobvezna potvrda vlasništva; podatke izdavatelja određuje vjerodajnica.
`supplier.oib`	string	`neobvezno; pattern: ^[0-9]{11}$`	OIB od točno 11 znamenaka.
`customer`	object	`obvezno`	Podaci primatelja računa.
`customer.partnerId`	string (uuid)	`neobvezno`	Identifikator partnera u matičnim podacima sustava Klik Račun.
`customer.partnerCode`	string	`neobvezno`	Šifra partnera.
`customer.name`	string	`obvezno`	Naziv.
`customer.fullName`	string	`neobvezno`	Puni pravni naziv.
`customer.shortName`	string	`neobvezno`	Skraćeni naziv.
`customer.oib`	string	`obvezno; pattern: ^[0-9]{11}$`	OIB od točno 11 znamenaka.
`customer.endpointScheme`	string	`neobvezno; zadano: 9934; max 16`	Shema elektroničke adrese.
`customer.countryCode`	string	`neobvezno; zadano: HR; min 2; max 2`	Dvoslovna oznaka države prema ISO 3166-1.
`customer.vatId`	string	`neobvezno`	PDV identifikacijski broj.
`customer.city`	string	`neobvezno`	Grad.
`customer.postalCode`	string	`neobvezno`	Poštanski broj.
`customer.streetAddress`	string	`neobvezno`	Ulica i kućni broj.
`customer.additionalAddress`	string	`neobvezno`	Dodatni redak adrese.
`customer.addressDetails`	string	`neobvezno`	Dodatne pojedinosti adrese.
`customer.county`	string	`neobvezno`	Županija ili regija.
`customer.contactEmail`	string (email)	`neobvezno`	Adresa e-pošte za kontakt.
`lines`	array [object]	`obvezno; min 1`	Najmanje jedna stavka računa.
`lines.articleId`	string (uuid)	`neobvezno`	Identifikator artikla u matičnim podacima sustava Klik Račun.
`lines.code`	string	`neobvezno`	Šifra.
`lines.name`	string	`obvezno`	Naziv.
`lines.quantity`	number	`obvezno; > 0`	Pozitivna količina.
`lines.unitCode`	string	`neobvezno; zadano: EA; max 16`	UNECE oznaka mjerne jedinice.
`lines.unitPrice`	number	`obvezno; ≥ 0`	Neto jedinična cijena prije PDV-a.
`lines.taxCode`	string	`obvezno`	Šifra poreza u matičnim podacima sustava Klik Račun.
`lines.taxRate`	number	`obvezno; ≥ 0`	Primijenjena stopa PDV-a u postotku.
`lines.ublTaxCategory`	string	`neobvezno; zadano: S; max 16`	Porezna kategorija prema EN 16931/UBL-u.
`lines.ublHrTaxCategory`	string	`neobvezno`	Oznaka hrvatske proširene porezne kategorije.
`lines.taxCategoryCode`	string	`neobvezno`	Šifra porezne kategorije u sustavu Klik Račun.
`lines.classification`	object	`obvezno`	KPD klasifikacija stavke.
`lines.classification.value`	string	`obvezno`	Vrijednost KPD klasifikacije.
`lines.classification.schemeId`	string	`neobvezno; = CG; zadano: CG`	Oznaka KPD sheme; mora biti CG.
`lines.classification.schemeVersionId`	string	`neobvezno`	Inačica KPD sheme.
`lines.salesAccountId`	string (uuid)	`neobvezno`	Identifikator konta prihoda.
`additionalTaxes`	array [object]	`neobvezno`	Dodatni hrvatski porezi i naknade.
`additionalTaxes.code`	string	`obvezno`	Šifra.
`additionalTaxes.description`	string	`obvezno`	Opis.
`additionalTaxes.hrCategory`	string	`obvezno; HR:PP · HR:PPMV · HR:POVNAK · HR:N`	Hrvatska kategorija dodatnog poreza.
`additionalTaxes.taxableAmount`	number	`obvezno; ≥ 0`	Porezna osnovica.
`additionalTaxes.rate`	number	`obvezno; ≥ 0`	Porezna stopa u postotku.
`notes`	array [string]	`neobvezno`	Napomene na računu.
`paymentInstructions`	object	`neobvezno`	Upute za plaćanje prikazane na računu.
`paymentInstructions.meansCode`	string	`neobvezno; zadano: 30; pattern: ^(?:[0-9]{1,3}\|ZZZ)$`	Oznaka načina plaćanja prema UNCL 4461.
`paymentInstructions.iban`	string	`neobvezno`	IBAN primatelja plaćanja.
`paymentInstructions.bic`	string	`neobvezno`	BIC banke primatelja.
`paymentInstructions.accountName`	string	`neobvezno`	Naziv računa primatelja.
`paymentInstructions.paymentReference`	string	`neobvezno`	Poziv na broj ili druga oznaka plaćanja.
`paymentInstructions.model`	string	`neobvezno; pattern: ^HR[0-9]{2}$`	Hrvatski model poziva na broj u obliku HRxx.
`paymentInstructions.purposeCode`	string	`neobvezno`	Oznaka namjene plaćanja.
`paymentInstructions.description`	string	`neobvezno`	Opis.
`paymentInstructions.terms`	string	`neobvezno`	Uvjeti plaćanja.
`paymentProfileId`	string (uuid)	`neobvezno`	Identifikator aktivnog profila plaćanja; njegove upute imaju prednost pred paymentInstructions.
`initialPayments`	array [object]	`neobvezno`	Uplate evidentirane pri izradi dokumenta.
`initialPayments.methodCode`	string	`obvezno`	Oznaka načina plaćanja.
`initialPayments.paymentDate`	string (date)	`obvezno`	Datum uplate u obliku GGGG-MM-DD.
`initialPayments.amount`	number	`obvezno; > 0`	Pozitivan novčani iznos u valuti računa.
`initialPayments.referenceNumber`	string	`neobvezno`	Bankovna, procesorska ili interna oznaka transakcije.
`initialPayments.note`	string	`neobvezno`	Neobvezna napomena.
`stagedReferences`	array [object]	`neobvezno`	Poslovne reference i prilozi koji se dodaju pri izradi nacrta.
`stagedReferences.referenceKind`	string	`obvezno; RECURRING_CONTRACT · BUYER_CONTRACT · SALES_ORDER · PURCHASE_ORDER · DESPATCH · RECEIPT · TENDER · OFFER · SUPPORTING_DOCUMENT · BUYER_REFERENCE · PROJECT · INVOICED_OBJECT · BUYER_COST_CENTER · PREVIOUS_INVOICE`	Vrsta poslovne ili dokumentne reference.
`stagedReferences.inputMode`	string	`neobvezno; MANUAL · SYSTEM`	Ručni unos ili odabir zapisa iz sustava Klik Račun.
`stagedReferences.internalEntityId`	string (uuid)	`neobvezno`	Identifikator zapisa odabranog u sustavu Klik Račun.
`stagedReferences.documentNumber`	string	`neobvezno`	Broj dokumenta; uz ručno numeriranje mora biti zadan.
`stagedReferences.documentDate`	string (date)	`neobvezno`	Datum referenciranog dokumenta.
`stagedReferences.description`	string	`neobvezno`	Opis.
`stagedReferences.externalUrl`	string (uri)	`neobvezno`	Vanjska poveznica na prateći dokument.
`stagedReferences.attachment`	object	`neobvezno`	Ugrađeni prilog.
`stagedReferences.attachment.name`	string	`obvezno`	Naziv.
`stagedReferences.attachment.type`	string	`obvezno`	Vrsta sadržaja priloga.
`stagedReferences.attachment.data`	string (byte)	`obvezno`	Sadržaj priloga kodiran u Base64 obliku.
`stagedReferences.attachment.size`	integer	`neobvezno; ≥ 0`	Dekodirana veličina priloga u bajtovima.
`salesAccountId`	string (uuid)	`neobvezno`	Identifikator konta prihoda.
`splitSalesAccounts`	boolean	`neobvezno; zadano: false`	Ako je true, svaka stavka mora imati vlastiti salesAccountId.
`issue`	boolean	`neobvezno; zadano: false`	Ako je true, nakon izrade odmah pokreće zaštićeno izdavanje.
`advanceApplications`	array [object]	`neobvezno`	Predujmovi koji se rezerviraju i koriste prije izdavanja.
`advanceApplications.sourceInvoiceId`	string (uuid)	`neobvezno`	Identifikator prihvaćenog predujma u sustavu Klik Račun.
`advanceApplications.documentNumber`	string	`neobvezno`	Broj dokumenta; uz ručno numeriranje mora biti zadan.
`advanceApplications.issueDate`	string (date)	`neobvezno`	Datum izdavanja u obliku GGGG-MM-DD.
`advanceApplications.amount`	number	`obvezno; > 0`	Pozitivan novčani iznos u valuti računa.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Račun.	application/json
`409`	Zaštitna ili validacijska pogreška.	application/json

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

Provjera efektivnog UBL-a bez izdavanja

Potrebne ovlasti: invoices:issue

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`invoiceId`	string (uuid)	`obvezno`	Identifikator izlaznog računa u sustavu Klik Račun.

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Idempotency-Key`	string	`obvezno; min 16; max 100`	Jedinstveni ključ sigurnog ponavljanja zahtjeva.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Provjera je uspješna.	application/json
`422`	Zaštitna ili validacijska pogreška.	application/json

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

Pokretanje zaštićenog izdavanja i slanja

Potrebne ovlasti: invoices:issue

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`invoiceId`	string (uuid)	`obvezno`	Identifikator izlaznog računa u sustavu Klik Račun.

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Idempotency-Key`	string	`obvezno; min 16; max 100`	Jedinstveni ključ sigurnog ponavljanja zahtjeva.

Odgovori

Status	Opis	Vrsta sadržaja
`202`	Asinkrona operacija.	application/json

`GET /public/v1/outgoing-invoices/{invoiceId}/status`

Dohvat jedinstvenog i raščlanjenih statusa računa

Potrebne ovlasti: invoices:read

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`invoiceId`	string (uuid)	`obvezno`	Identifikator izlaznog računa u sustavu Klik Račun.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Status računa.	application/json

`GET /public/v1/outgoing-invoices/{invoiceId}/extract-xml/ubl`

Preuzimanje UBL-a koji se koristi za izdavanje

Potrebne ovlasti: invoices:read

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`invoiceId`	string (uuid)	`obvezno`	Identifikator izlaznog računa u sustavu Klik Račun.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	UBL Invoice ili CreditNote.	application/xml

Poništenja, ispravci i predujmovi

`POST /public/v1/outgoing-invoices/{invoiceId}/reverse`

Izrada zaštićenog potpunog poništenja

Potrebne ovlasti: invoices:reverse

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`invoiceId`	string (uuid)	`obvezno`	Identifikator izlaznog računa u sustavu Klik Račun.

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Idempotency-Key`	string	`obvezno; min 16; max 100`	Jedinstveni ključ sigurnog ponavljanja zahtjeva.

Tijelo zahtjeva

`application/json`

Polje	Vrsta	Pravila	Značenje
`reason`	string	`obvezno`	Obvezno obrazloženje radnje.
`issueDate`	string (date)	`neobvezno`	Datum izdavanja u obliku GGGG-MM-DD.
`documentNumber`	string	`neobvezno`	Broj dokumenta; uz ručno numeriranje mora biti zadan.
`numberMode`	string	`neobvezno; AUTO · MANUAL`	Automatsko ili ručno numeriranje.
`issue`	boolean	`neobvezno; zadano: true`	Ako je true, nakon izrade odmah pokreće zaštićeno izdavanje.

Odgovori

Status	Opis	Vrsta sadržaja
`201`	Izrađeni dokumenti ispravka i neobvezna operacija izdavanja.	application/json
`202`	Izrađeni dokumenti ispravka i neobvezna operacija izdavanja.	application/json

`POST /public/v1/outgoing-invoices/{invoiceId}/correct/preview`

Izračun i spremanje kratkotrajnog plana ispravka

Potrebne ovlasti: invoices:correct

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`invoiceId`	string (uuid)	`obvezno`	Identifikator izlaznog računa u sustavu Klik Račun.

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Idempotency-Key`	string	`obvezno; min 16; max 100`	Jedinstveni ključ sigurnog ponavljanja zahtjeva.
`IIProxy-Correction-Reason`	string	`neobvezno; max 2000`	Obrazloženje ispravka pri izravnom XML unosu.

Tijelo zahtjeva

`application/json` - inačica 1

Polje	Vrsta	Pravila	Značenje
`issueDate`	string (date)	`obvezno`	Datum izdavanja u obliku GGGG-MM-DD.
`reason`	string	`obvezno`	Obvezno obrazloženje radnje.
`target`	object	`obvezno`	Željeno novo stanje strukturiranog računa.
`target.documentNumber`	string	`neobvezno`	Broj dokumenta; uz ručno numeriranje mora biti zadan.
`target.numberMode`	string	`neobvezno; AUTO · MANUAL; zadano: AUTO`	Automatsko ili ručno numeriranje.
`target.issueDate`	string (date)	`obvezno`	Datum izdavanja u obliku GGGG-MM-DD.
`target.deliveryDate`	string (date)	`obvezno`	Datum isporuke u obliku GGGG-MM-DD.
`target.dueDate`	string \| null (date)	`neobvezno`	Datum dospijeća ili null kada nije primjenjiv.
`target.currency`	string	`neobvezno; zadano: EUR; min 3; max 3`	Troslovna oznaka valute prema ISO 4217.
`target.documentType`	string	`neobvezno; Invoice · CreditNote · AdvanceInvoice; zadano: Invoice`	Poslovna vrsta dokumenta.
`target.paymentModel`	string	`neobvezno; DUE · ADVANCE_AND_BALANCE · ONSITE · ADVANCE_DECLARATION; zadano: DUE`	Pravila dospijeća, naplate i predujma.
`target.deliveryChannel`	string	`neobvezno; AS4 · FISCALIZATION_ONLY; zadano: AS4`	Traženi kanal dostave.
`target.supplier`	object	`neobvezno`	Neobvezna potvrda vlasništva; podatke izdavatelja određuje vjerodajnica.
`target.supplier.oib`	string	`neobvezno; pattern: ^[0-9]{11}$`	OIB od točno 11 znamenaka.
`target.customer`	object	`obvezno`	Podaci primatelja računa.
`target.customer.partnerId`	string (uuid)	`neobvezno`	Identifikator partnera u matičnim podacima sustava Klik Račun.
`target.customer.partnerCode`	string	`neobvezno`	Šifra partnera.
`target.customer.name`	string	`obvezno`	Naziv.
`target.customer.fullName`	string	`neobvezno`	Puni pravni naziv.
`target.customer.shortName`	string	`neobvezno`	Skraćeni naziv.
`target.customer.oib`	string	`obvezno; pattern: ^[0-9]{11}$`	OIB od točno 11 znamenaka.
`target.customer.endpointScheme`	string	`neobvezno; zadano: 9934; max 16`	Shema elektroničke adrese.
`target.customer.countryCode`	string	`neobvezno; zadano: HR; min 2; max 2`	Dvoslovna oznaka države prema ISO 3166-1.
`target.customer.vatId`	string	`neobvezno`	PDV identifikacijski broj.
`target.customer.city`	string	`neobvezno`	Grad.
`target.customer.postalCode`	string	`neobvezno`	Poštanski broj.
`target.customer.streetAddress`	string	`neobvezno`	Ulica i kućni broj.
`target.customer.additionalAddress`	string	`neobvezno`	Dodatni redak adrese.
`target.customer.addressDetails`	string	`neobvezno`	Dodatne pojedinosti adrese.
`target.customer.county`	string	`neobvezno`	Županija ili regija.
`target.customer.contactEmail`	string (email)	`neobvezno`	Adresa e-pošte za kontakt.
`target.lines`	array [object]	`obvezno; min 1`	Najmanje jedna stavka računa.
`target.lines.articleId`	string (uuid)	`neobvezno`	Identifikator artikla u matičnim podacima sustava Klik Račun.
`target.lines.code`	string	`neobvezno`	Šifra.
`target.lines.name`	string	`obvezno`	Naziv.
`target.lines.quantity`	number	`obvezno; > 0`	Pozitivna količina.
`target.lines.unitCode`	string	`neobvezno; zadano: EA; max 16`	UNECE oznaka mjerne jedinice.
`target.lines.unitPrice`	number	`obvezno; ≥ 0`	Neto jedinična cijena prije PDV-a.
`target.lines.taxCode`	string	`obvezno`	Šifra poreza u matičnim podacima sustava Klik Račun.
`target.lines.taxRate`	number	`obvezno; ≥ 0`	Primijenjena stopa PDV-a u postotku.
`target.lines.ublTaxCategory`	string	`neobvezno; zadano: S; max 16`	Porezna kategorija prema EN 16931/UBL-u.
`target.lines.ublHrTaxCategory`	string	`neobvezno`	Oznaka hrvatske proširene porezne kategorije.
`target.lines.taxCategoryCode`	string	`neobvezno`	Šifra porezne kategorije u sustavu Klik Račun.
`target.lines.classification`	object	`obvezno`	KPD klasifikacija stavke.
`target.lines.classification.value`	string	`obvezno`	Vrijednost KPD klasifikacije.
`target.lines.classification.schemeId`	string	`neobvezno; = CG; zadano: CG`	Oznaka KPD sheme; mora biti CG.
`target.lines.classification.schemeVersionId`	string	`neobvezno`	Inačica KPD sheme.
`target.lines.salesAccountId`	string (uuid)	`neobvezno`	Identifikator konta prihoda.
`target.additionalTaxes`	array [object]	`neobvezno`	Dodatni hrvatski porezi i naknade.
`target.additionalTaxes.code`	string	`obvezno`	Šifra.
`target.additionalTaxes.description`	string	`obvezno`	Opis.
`target.additionalTaxes.hrCategory`	string	`obvezno; HR:PP · HR:PPMV · HR:POVNAK · HR:N`	Hrvatska kategorija dodatnog poreza.
`target.additionalTaxes.taxableAmount`	number	`obvezno; ≥ 0`	Porezna osnovica.
`target.additionalTaxes.rate`	number	`obvezno; ≥ 0`	Porezna stopa u postotku.
`target.notes`	array [string]	`neobvezno`	Napomene na računu.
`target.paymentInstructions`	object	`neobvezno`	Upute za plaćanje prikazane na računu.
`target.paymentInstructions.meansCode`	string	`neobvezno; zadano: 30; pattern: ^(?:[0-9]{1,3}\|ZZZ)$`	Oznaka načina plaćanja prema UNCL 4461.
`target.paymentInstructions.iban`	string	`neobvezno`	IBAN primatelja plaćanja.
`target.paymentInstructions.bic`	string	`neobvezno`	BIC banke primatelja.
`target.paymentInstructions.accountName`	string	`neobvezno`	Naziv računa primatelja.
`target.paymentInstructions.paymentReference`	string	`neobvezno`	Poziv na broj ili druga oznaka plaćanja.
`target.paymentInstructions.model`	string	`neobvezno; pattern: ^HR[0-9]{2}$`	Hrvatski model poziva na broj u obliku HRxx.
`target.paymentInstructions.purposeCode`	string	`neobvezno`	Oznaka namjene plaćanja.
`target.paymentInstructions.description`	string	`neobvezno`	Opis.
`target.paymentInstructions.terms`	string	`neobvezno`	Uvjeti plaćanja.
`target.paymentProfileId`	string (uuid)	`neobvezno`	Identifikator aktivnog profila plaćanja; njegove upute imaju prednost pred paymentInstructions.
`target.initialPayments`	array [object]	`neobvezno`	Uplate evidentirane pri izradi dokumenta.
`target.initialPayments.methodCode`	string	`obvezno`	Oznaka načina plaćanja.
`target.initialPayments.paymentDate`	string (date)	`obvezno`	Datum uplate u obliku GGGG-MM-DD.
`target.initialPayments.amount`	number	`obvezno; > 0`	Pozitivan novčani iznos u valuti računa.
`target.initialPayments.referenceNumber`	string	`neobvezno`	Bankovna, procesorska ili interna oznaka transakcije.
`target.initialPayments.note`	string	`neobvezno`	Neobvezna napomena.
`target.stagedReferences`	array [object]	`neobvezno`	Poslovne reference i prilozi koji se dodaju pri izradi nacrta.
`target.stagedReferences.referenceKind`	string	`obvezno; RECURRING_CONTRACT · BUYER_CONTRACT · SALES_ORDER · PURCHASE_ORDER · DESPATCH · RECEIPT · TENDER · OFFER · SUPPORTING_DOCUMENT · BUYER_REFERENCE · PROJECT · INVOICED_OBJECT · BUYER_COST_CENTER · PREVIOUS_INVOICE`	Vrsta poslovne ili dokumentne reference.
`target.stagedReferences.inputMode`	string	`neobvezno; MANUAL · SYSTEM`	Ručni unos ili odabir zapisa iz sustava Klik Račun.
`target.stagedReferences.internalEntityId`	string (uuid)	`neobvezno`	Identifikator zapisa odabranog u sustavu Klik Račun.
`target.stagedReferences.documentNumber`	string	`neobvezno`	Broj dokumenta; uz ručno numeriranje mora biti zadan.
`target.stagedReferences.documentDate`	string (date)	`neobvezno`	Datum referenciranog dokumenta.
`target.stagedReferences.description`	string	`neobvezno`	Opis.
`target.stagedReferences.externalUrl`	string (uri)	`neobvezno`	Vanjska poveznica na prateći dokument.
`target.stagedReferences.attachment`	object	`neobvezno`	Ugrađeni prilog.
`target.stagedReferences.attachment.name`	string	`obvezno`	Naziv.
`target.stagedReferences.attachment.type`	string	`obvezno`	Vrsta sadržaja priloga.
`target.stagedReferences.attachment.data`	string (byte)	`obvezno`	Sadržaj priloga kodiran u Base64 obliku.
`target.stagedReferences.attachment.size`	integer	`neobvezno; ≥ 0`	Dekodirana veličina priloga u bajtovima.
`target.salesAccountId`	string (uuid)	`neobvezno`	Identifikator konta prihoda.
`target.splitSalesAccounts`	boolean	`neobvezno; zadano: false`	Ako je true, svaka stavka mora imati vlastiti salesAccountId.
`target.issue`	boolean	`neobvezno; zadano: false`	Ako je true, nakon izrade odmah pokreće zaštićeno izdavanje.
`target.advanceApplications`	array [object]	`neobvezno`	Predujmovi koji se rezerviraju i koriste prije izdavanja.
`target.advanceApplications.sourceInvoiceId`	string (uuid)	`neobvezno`	Identifikator prihvaćenog predujma u sustavu Klik Račun.
`target.advanceApplications.documentNumber`	string	`neobvezno`	Broj dokumenta; uz ručno numeriranje mora biti zadan.
`target.advanceApplications.issueDate`	string (date)	`neobvezno`	Datum izdavanja u obliku GGGG-MM-DD.
`target.advanceApplications.amount`	number	`obvezno; > 0`	Pozitivan novčani iznos u valuti računa.
`documentNumber`	string	`neobvezno`	Broj dokumenta; uz ručno numeriranje mora biti zadan.
`numberMode`	string	`neobvezno; AUTO · MANUAL`	Automatsko ili ručno numeriranje.

`application/json` - inačica 2

Polje	Vrsta	Pravila	Značenje
`format`	string	`obvezno; = UBL`	Mora biti UBL.
`ublXml`	string	`obvezno`	Cijeli samostalni UBL XML dokument.
`salesAccountId`	string (uuid)	`neobvezno`	Identifikator konta prihoda.
`deliveryChannel`	string	`neobvezno; AS4 · FISCALIZATION_ONLY`	Traženi kanal dostave.
`issue`	boolean	`neobvezno`	Ako je true, nakon izrade odmah pokreće zaštićeno izdavanje.
`advanceApplications`	array [object]	`neobvezno`	Predujmovi koji se rezerviraju i koriste prije izdavanja.
`advanceApplications.sourceInvoiceId`	string (uuid)	`neobvezno`	Identifikator prihvaćenog predujma u sustavu Klik Račun.
`advanceApplications.documentNumber`	string	`neobvezno`	Broj dokumenta; uz ručno numeriranje mora biti zadan.
`advanceApplications.issueDate`	string (date)	`neobvezno`	Datum izdavanja u obliku GGGG-MM-DD.
`advanceApplications.amount`	number	`obvezno; > 0`	Pozitivan novčani iznos u valuti računa.
`reason`	string	`obvezno`	Obvezno obrazloženje radnje.

`application/xml`

Pošaljite cijeli samostalni UBL 2.1/HR-CIUS Invoice ili CreditNote XML dokument. Ne šalje se FIS poruka Porezne uprave.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Zaštićeni plan ispravka.	application/json

`POST /public/v1/outgoing-invoices/{invoiceId}/correct`

Jednokratna potvrda plana ispravka

Potrebne ovlasti: invoices:correct

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`invoiceId`	string (uuid)	`obvezno`	Identifikator izlaznog računa u sustavu Klik Račun.

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Idempotency-Key`	string	`obvezno; min 16; max 100`	Jedinstveni ključ sigurnog ponavljanja zahtjeva.

Tijelo zahtjeva

`application/json`

Polje	Vrsta	Pravila	Značenje
`planId`	string (uuid)	`obvezno`	Identifikator kratkotrajnog plana ispravka.
`issue`	boolean	`neobvezno; zadano: true`	Ako je true, nakon izrade odmah pokreće zaštićeno izdavanje.

Odgovori

Status	Opis	Vrsta sadržaja
`201`	Izrađeni dokumenti ispravka i neobvezna operacija izdavanja.	application/json
`202`	Izrađeni dokumenti ispravka i neobvezna operacija izdavanja.	application/json

`POST /public/v1/outgoing-invoices/{invoiceId}/advance-applications`

Rezervacija prihvaćenog predujma za nacrt

Potrebne ovlasti: advances:write

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`invoiceId`	string (uuid)	`obvezno`	Identifikator izlaznog računa u sustavu Klik Račun.

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Idempotency-Key`	string	`obvezno; min 16; max 100`	Jedinstveni ključ sigurnog ponavljanja zahtjeva.

Tijelo zahtjeva

`application/json`

Polje	Vrsta	Pravila	Značenje
`sourceInvoiceId`	string (uuid)	`neobvezno`	Identifikator prihvaćenog predujma u sustavu Klik Račun.
`documentNumber`	string	`neobvezno`	Broj dokumenta; uz ručno numeriranje mora biti zadan.
`issueDate`	string (date)	`neobvezno`	Datum izdavanja u obliku GGGG-MM-DD.
`amount`	number	`obvezno; > 0`	Pozitivan novčani iznos u valuti računa.

Odgovori

Status	Opis	Vrsta sadržaja
`201`	Primjena predujma je rezervirana.	—

`DELETE /public/v1/outgoing-invoices/{invoiceId}/advance-applications/{applicationId}`

Otpuštanje rezervacije predujma

Potrebne ovlasti: advances:write

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`invoiceId`	string (uuid)	`obvezno`	Identifikator izlaznog računa u sustavu Klik Račun.
`applicationId`	string (uuid)	`obvezno`	Identifikator rezervacije predujma.

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Idempotency-Key`	string	`obvezno; min 16; max 100`	Jedinstveni ključ sigurnog ponavljanja zahtjeva.

Odgovori

Status	Opis	Vrsta sadržaja
`204`	Rezervacija je otpuštena.	—

Uplate izlaznih računa

`GET /public/v1/outgoing-invoices/{invoiceId}/payments`

Dohvat evidentiranih uplata i podmirenja izlaznog računa

Potrebne ovlasti: payments:read

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`invoiceId`	string (uuid)	`obvezno`	Identifikator izlaznog računa u sustavu Klik Račun.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Uplate i stanje podmirenja.	—

`POST /public/v1/outgoing-invoices/{invoiceId}/payments`

Evidentiranje uplate izlaznog računa

Potrebne ovlasti: payments:write

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`invoiceId`	string (uuid)	`obvezno`	Identifikator izlaznog računa u sustavu Klik Račun.

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Idempotency-Key`	string	`obvezno; min 16; max 100`	Jedinstveni ključ sigurnog ponavljanja zahtjeva.

Tijelo zahtjeva

`application/json`

Polje	Vrsta	Pravila	Značenje
`methodCode`	string	`obvezno`	Oznaka načina plaćanja.
`paymentDate`	string (date)	`obvezno`	Datum uplate u obliku GGGG-MM-DD.
`amount`	number	`obvezno; > 0`	Pozitivan novčani iznos u valuti računa.
`referenceNumber`	string	`neobvezno`	Bankovna, procesorska ili interna oznaka transakcije.
`note`	string	`neobvezno`	Neobvezna napomena.

Odgovori

Status	Opis	Vrsta sadržaja
`201`	Uplata je evidentirana.	—

`POST /public/v1/outgoing-invoices/{invoiceId}/payments/{paymentId}/void`

Poništenje evidentirane uplate izlaznog računa

Potrebne ovlasti: payments:write

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`invoiceId`	string (uuid)	`obvezno`	Identifikator izlaznog računa u sustavu Klik Račun.
`paymentId`	string (uuid)	`obvezno`	Identifikator evidentirane uplate.

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Idempotency-Key`	string	`obvezno; min 16; max 100`	Jedinstveni ključ sigurnog ponavljanja zahtjeva.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Uplata je poništena.	—

Ulazni računi i njihove uplate

`GET /public/v1/incoming-invoices`

Popis ulaznih računa organizacije

Potrebne ovlasti: incoming:read

Parametri upita

Polje	Vrsta	Pravila	Značenje
`status`	string	`neobvezno`	Jedinstveni status dokumenta.
`documentNumber`	string	`neobvezno`	Filtrira prema broju dokumenta ili njegovu dijelu.
`from`	string (date)	`neobvezno`	Početni datum izdavanja, uključivo.
`to`	string (date)	`neobvezno`	Završni datum izdavanja, uključivo.
`limit`	integer	`neobvezno; zadano: 1000; ≥ 1`	Najveći broj rezultata.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Popis ulaznih računa.	—

`GET /public/v1/incoming-invoices/{documentKey}`

Dohvat ulaznog računa

Potrebne ovlasti: incoming:read

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`documentKey`	string	`obvezno; min 1; max 1000`	Jedinstveni ključ ulaznog dokumenta.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Ulazni račun.	—
`404`	Zaštitna ili validacijska pogreška.	application/json

`GET /public/v1/incoming-invoices/{documentKey}/extract-xml/ubl`

Preuzimanje sačuvanog UBL-a ulaznog računa

Potrebne ovlasti: incoming:read

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`documentKey`	string	`obvezno; min 1; max 1000`	Jedinstveni ključ ulaznog dokumenta.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Ulazni UBL Invoice ili CreditNote.	application/xml

`GET /public/v1/incoming-invoices/{documentKey}/process-status`

Dohvat izvedenog poslovnog statusa primatelja

Potrebne ovlasti: incoming:read

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`documentKey`	string	`obvezno; min 1; max 1000`	Jedinstveni ključ ulaznog dokumenta.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Poslovni status primatelja.	application/json

`POST /public/v1/incoming-invoices/{documentKey}/approve`

Evidentiranje poslovnog odobrenja primatelja

Potrebne ovlasti: incoming:respond

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`documentKey`	string	`obvezno; min 1; max 1000`	Jedinstveni ključ ulaznog dokumenta.

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Idempotency-Key`	string	`obvezno; min 16; max 100`	Jedinstveni ključ sigurnog ponavljanja zahtjeva.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Odobreno.	—

`POST /public/v1/incoming-invoices/{documentKey}/reject`

Provjera i slanje odbijanja primatelja

Potrebne ovlasti: incoming:respond

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`documentKey`	string	`obvezno; min 1; max 1000`	Jedinstveni ključ ulaznog dokumenta.

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Idempotency-Key`	string	`obvezno; min 16; max 100`	Jedinstveni ključ sigurnog ponavljanja zahtjeva.

Tijelo zahtjeva

`application/json`

Polje	Vrsta	Pravila	Značenje
`rejectionDate`	string (date)	`obvezno`	Datum odbijanja u obliku GGGG-MM-DD.
`reasonType`	string	`obvezno; N · U · O`	Zakonska vrsta razloga odbijanja.
`reason`	string	`obvezno; min 1; max 2000`	Obvezno obrazloženje radnje.

Odgovori

Status	Opis	Vrsta sadržaja
`202`	Odbijanje je poslano.	—

`GET /public/v1/incoming-invoices/{documentKey}/payments`

Dohvat uplata i podmirenja ulaznog računa

Potrebne ovlasti: payments:read

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`documentKey`	string	`obvezno; min 1; max 1000`	Jedinstveni ključ ulaznog dokumenta.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Uplate ulaznog računa i stanje podmirenja.	—

`POST /public/v1/incoming-invoices/{documentKey}/payments`

Evidentiranje uplate ulaznog računa

Potrebne ovlasti: payments:write

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`documentKey`	string	`obvezno; min 1; max 1000`	Jedinstveni ključ ulaznog dokumenta.

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Idempotency-Key`	string	`obvezno; min 16; max 100`	Jedinstveni ključ sigurnog ponavljanja zahtjeva.

Tijelo zahtjeva

`application/json`

Polje	Vrsta	Pravila	Značenje
`methodCode`	string	`obvezno`	Oznaka načina plaćanja.
`paymentDate`	string (date)	`obvezno`	Datum uplate u obliku GGGG-MM-DD.
`amount`	number	`obvezno; > 0`	Pozitivan novčani iznos u valuti računa.
`referenceNumber`	string	`neobvezno`	Bankovna, procesorska ili interna oznaka transakcije.
`note`	string	`neobvezno`	Neobvezna napomena.

Odgovori

Status	Opis	Vrsta sadržaja
`201`	Uplata ulaznog računa je evidentirana.	—

`POST /public/v1/incoming-invoices/{documentKey}/payments/{paymentId}/void`

Poništenje evidentirane uplate ulaznog računa

Potrebne ovlasti: payments:write

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`documentKey`	string	`obvezno; min 1; max 1000`	Jedinstveni ključ ulaznog dokumenta.
`paymentId`	string (uuid)	`obvezno`	Identifikator evidentirane uplate.

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Idempotency-Key`	string	`obvezno; min 16; max 100`	Jedinstveni ključ sigurnog ponavljanja zahtjeva.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Uplata ulaznog računa je poništena.	—

Asinkrone operacije

`GET /public/v1/events`

GET /public/v1/events

Potrebne ovlasti: events:read

Zaglavlja zahtjeva

Polje	Vrsta	Pravila	Značenje
`Last-Event-ID`	string	`neobvezno; min 1; max 512`	Vrijednost definirana ugovorom API-ja.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Odgovor prema ugovoru API-ja.	text/event-stream
`400`	Zaštitna ili validacijska pogreška.	application/json
`401`	Zaštitna ili validacijska pogreška.	application/json
`403`	Zaštitna ili validacijska pogreška.	application/json

`GET /public/v1/operations/{operationId}`

Dohvat asinkrone operacije klijenta

Potrebne ovlasti: invoices:read

Parametri putanje

Polje	Vrsta	Pravila	Značenje
`operationId`	string (uuid)	`obvezno`	Identifikator asinkrone operacije.

Odgovori

Status	Opis	Vrsta sadržaja
`200`	Asinkrona operacija.	application/json
`404`	Zaštitna ili validacijska pogreška.	application/json

Dostupnost i autentikacija​

GET /public/v1/ping​

POST /oauth2/token​

application/x-www-form-urlencoded​

POST /public/v1/oauth2/token​

application/x-www-form-urlencoded​

Izlazni računi​

GET /public/v1/outgoing-invoices​

POST /public/v1/outgoing-invoices​

application/json - inačica 1​

application/json - inačica 2​

application/xml​

text/xml​

application/ubl+xml​

GET /public/v1/outgoing-invoices/{invoiceId}​

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

application/json​

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

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

GET /public/v1/outgoing-invoices/{invoiceId}/status​

GET /public/v1/outgoing-invoices/{invoiceId}/extract-xml/ubl​

Poništenja, ispravci i predujmovi​

POST /public/v1/outgoing-invoices/{invoiceId}/reverse​

application/json​

POST /public/v1/outgoing-invoices/{invoiceId}/correct/preview​

application/json - inačica 1​

application/json - inačica 2​

application/xml​

POST /public/v1/outgoing-invoices/{invoiceId}/correct​

application/json​

POST /public/v1/outgoing-invoices/{invoiceId}/advance-applications​

application/json​

DELETE /public/v1/outgoing-invoices/{invoiceId}/advance-applications/{applicationId}​

Uplate izlaznih računa​

GET /public/v1/outgoing-invoices/{invoiceId}/payments​

POST /public/v1/outgoing-invoices/{invoiceId}/payments​

application/json​

POST /public/v1/outgoing-invoices/{invoiceId}/payments/{paymentId}/void​

Ulazni računi i njihove uplate​

GET /public/v1/incoming-invoices​

GET /public/v1/incoming-invoices/{documentKey}​

GET /public/v1/incoming-invoices/{documentKey}/extract-xml/ubl​

GET /public/v1/incoming-invoices/{documentKey}/process-status​

POST /public/v1/incoming-invoices/{documentKey}/approve​

POST /public/v1/incoming-invoices/{documentKey}/reject​

application/json​

GET /public/v1/incoming-invoices/{documentKey}/payments​

POST /public/v1/incoming-invoices/{documentKey}/payments​

application/json​

POST /public/v1/incoming-invoices/{documentKey}/payments/{paymentId}/void​

Asinkrone operacije​

GET /public/v1/events​

GET /public/v1/operations/{operationId}​

Dostupnost i autentikacija

`GET /public/v1/ping`

`POST /oauth2/token`

`application/x-www-form-urlencoded`

`POST /public/v1/oauth2/token`

`application/x-www-form-urlencoded`

Izlazni računi

`GET /public/v1/outgoing-invoices`

`POST /public/v1/outgoing-invoices`

`application/json` - inačica 1

`application/json` - inačica 2

`application/xml`

`text/xml`

`application/ubl+xml`

`GET /public/v1/outgoing-invoices/{invoiceId}`

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

`application/json`

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

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

`GET /public/v1/outgoing-invoices/{invoiceId}/status`

`GET /public/v1/outgoing-invoices/{invoiceId}/extract-xml/ubl`

Poništenja, ispravci i predujmovi

`POST /public/v1/outgoing-invoices/{invoiceId}/reverse`

`application/json`

`POST /public/v1/outgoing-invoices/{invoiceId}/correct/preview`

`application/json` - inačica 1

`application/json` - inačica 2

`application/xml`

`POST /public/v1/outgoing-invoices/{invoiceId}/correct`

`application/json`

`POST /public/v1/outgoing-invoices/{invoiceId}/advance-applications`

`application/json`

`DELETE /public/v1/outgoing-invoices/{invoiceId}/advance-applications/{applicationId}`

Uplate izlaznih računa

`GET /public/v1/outgoing-invoices/{invoiceId}/payments`

`POST /public/v1/outgoing-invoices/{invoiceId}/payments`

`application/json`

`POST /public/v1/outgoing-invoices/{invoiceId}/payments/{paymentId}/void`

Ulazni računi i njihove uplate

`GET /public/v1/incoming-invoices`

`GET /public/v1/incoming-invoices/{documentKey}`

`GET /public/v1/incoming-invoices/{documentKey}/extract-xml/ubl`

`GET /public/v1/incoming-invoices/{documentKey}/process-status`

`POST /public/v1/incoming-invoices/{documentKey}/approve`

`POST /public/v1/incoming-invoices/{documentKey}/reject`

`application/json`

`GET /public/v1/incoming-invoices/{documentKey}/payments`

`POST /public/v1/incoming-invoices/{documentKey}/payments`

`application/json`

`POST /public/v1/incoming-invoices/{documentKey}/payments/{paymentId}/void`

Asinkrone operacije

`GET /public/v1/events`

`GET /public/v1/operations/{operationId}`