Payload

Tijelo za POST /api/invoices/draft (glavna polja).

Ne šaljete u payload: EFI kodove (software, BU, ENU, operator, maintainer), sertifikat — to je u admin panelu firme.

Detaljna pravila za typeOfInvoice + paymentMethod: Načini plaćanja. Gotovinski tok: Gotovinski računi. Storno i ispravka: Storno i korektivni.

Osnovna struktura

Primjer B2C e-commerce (kupac platio ličnom karticom — gotovinski račun):

{
  "type": "Invoice",
  "orderNumber": 0,
  "typeOfInvoice": "Cash",
  "paymentMethod": "CARD",
  "paymentDeadline": "2026-07-28T23:59:59Z",
  "buyer": { },
  "items": [ ],
  "note": "Opciona napomena",
  "discountAmount": null,
  "operatorName": "API"
}

Primjer B2B bezgotovinske (virman):

{
  "type": "Invoice",
  "orderNumber": 0,
  "typeOfInvoice": "NonCash",
  "paymentMethod": "ACCOUNT",
  "paymentDeadline": "2026-07-28T23:59:59Z",
  "buyer": { },
  "items": [ ]
}

Polja

Polje	Obavezno	Opis
`type`	da	Tip dokumenta: `Invoice`, `Corrective`, `Advance`, …
`orderNumber`	da	Redni broj; `0` = sistem dodjeljuje
`typeOfInvoice`	da	`Cash` ili `NonCash`
`paymentMethod`	da	Mora biti dozvoljen za izabrani `typeOfInvoice` — vidi Načini plaćanja
`paymentDeadline`	da	ISO-8601 datum; za već plaćene narudžbe = datum plaćanja
`items`	da	Lista stavki (min 1)
`buyer`	ne	Podaci kupca (preporučeno za B2B)
`note`	ne	Napomena / broj narudžbe
`discountAmount`	ne	Popust na nivou računa (bez PDV-a)
`operatorName`	ne	Ime koje se prikazuje na računu (API nema UI operatora)
`advancePaymentIic`	uslovno	Obavezno za ADVANCE / SVOUCHER plaćanja
`original`	uslovno	Obavezno za `type: "Corrective"` — `{ id: IIC, issuedAt }` originalnog računa. Vidi Storno i korektivni.

Stavka (`items[]`)

Polje	Opis
`name`	Naziv (obavezno)
`code`	Šifra artikla (opciono)
`unit`	Jedinica mjere
`unitPrice`	Jedinična cijena. Na storno/korektivnom povratu ide u minus zajedno sa `quantity`.
`quantity`	Količina
`vat.rate`	Stopa PDV-a (npr. 21, 7, 0)
`rebatePercentage`	Rabat % (opciono)
`rebateReducingBase`	Da li rabat smanjuje osnovicu

Kupac (`buyer`)

Polje	Opis
`idType`	Tip ID-a (npr. `TIN`)
`idNumber`	PIB / broj
`name`	Naziv
`address`	Adresa
`city`	Grad
`country`	Država (`MNE`)

Tipovi plaćanja (kratko)

Kod	Tip računa	Napomena
`CARD`	samo `Cash`	Kartica fizičkog lica (B2C e-commerce)
`BUSINESSCARD`	`Cash` ili `NonCash`	Poslovna kartica
`ACCOUNT`	samo `NonCash`	Virman
`BANKNOTE`	samo `Cash`	Gotovina
`FACTORING`, `ORDER`, `ADVANCE`, `OTHER`	`NonCash`	Bezgotovinska plaćanja

CARD na NonCash vraća 400 — to nije podržano specifikacijom. Za online naplatu ličnom karticom koristite Cash + CARD.

Puna tabela i e-commerce primjeri: Načini plaćanja.

Endpointi Načini plaćanja