Payload

Payload

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

Osnovna struktura

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

Polja

PoljeObaveznoOpis
typedaTip dokumenta: Invoice, Corrective, Advance, …
orderNumberdaRedni broj; 0 = sistem dodjeljuje
typeOfInvoicedaCash ili NonCash
paymentMethoddaNpr. CARD, ACCOUNT, BANKNOTE, …
paymentDeadlinedaISO-8601 datum
itemsdaLista stavki (min 1)
buyernePodaci kupca (preporučeno za B2B)
noteneNapomena / broj narudžbe
discountAmountnePopust na nivou računa (bez PDV-a)
operatorNameneIme koje se prikazuje na računu (API nema UI operatora)
advancePaymentIicuslovnoObavezno za ADVANCE / SVOUCHER plaćanja

Stavka (items[])

PoljeOpis
nameNaziv (obavezno)
codeŠifra artikla (opciono)
unitJedinica mjere
unitPriceJedinična cijena
quantityKoličina
vat.rateStopa PDV-a (npr. 21, 7, 0)
rebatePercentageRabat % (opciono)
rebateReducingBaseDa li rabat smanjuje osnovicu

Kupac (buyer)

PoljeOpis
idTypeTip ID-a (npr. TIN)
idNumberPIB / broj
nameNaziv
addressAdresa
cityGrad
countryDržava (MNE)

Tipovi plaćanja

Vrijednosti se šalju kako očekuje poreski servis (XML enum), npr.:

  • BANKNOTE — gotovina
  • CARD — kartica
  • ACCOUNT — virman / račun
  • ORDER — …
  • ostalo prema specifikaciji (ADVANCE, SVOUCHER, …)

Za e-commerce online naplatu tipično: NonCash + CARD ili ACCOUNT.