Brzi start

Brzi start

Tipičan flow nakon uspješnog plaćanja na vašem sistemu (e-commerce, booking):

  1. Kreiraj draft
  2. Fiskalizuj (asinhrono — 202 Accepted)
  3. Poll status dok nije Fiscalized (ili Failed / Offline)

Način plaćanja: za B2C online naplatu ličnom karticom koristite typeOfInvoice: "Cash" + paymentMethod: "CARD". NonCash + CARD ne prolazi validaciju. Detalji: Načini plaćanja.

EFI kodovi (ENU, maintainer, …) idu u admin panel — ne u API payload. Vidi Gotovinski računi.

Gotovinski depozit: pri fiscalize za Cash draft API automatski registruje INITIAL depozit (0.00).

1. Kreiraj draft

Primjer: B2C e-commerce, kupac platio karticom (usluga već naplaćena):

curl -X POST "https://api.fiskalmn.me/api/invoices/draft" \
  -H "Authorization: Bearer fk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "Invoice",
    "orderNumber": 0,
    "typeOfInvoice": "Cash",
    "paymentMethod": "CARD",
    "paymentDeadline": "2026-07-28T23:59:59Z",
    "buyer": {
      "idType": "TIN",
      "idNumber": "12345678",
      "name": "Ime Prezime",
      "address": "Ulica 1",
      "city": "Podgorica",
      "country": "MNE"
    },
    "items": [
      {
        "name": "Rezervacija sobe",
        "code": "ROOM-101",
        "unit": "kom",
        "unitPrice": 50.00,
        "quantity": 1,
        "vat": { "rate": 21 }
      }
    ],
    "note": "Narudžba #ORD-1001"
  }'

Za B2B bezgotovinsku (firma, virman): "typeOfInvoice": "NonCash", "paymentMethod": "ACCOUNT". Za B2B + poslovna kartica: "paymentMethod": "BUSINESSCARD".

Odgovor sadrži id draft računa.

orderNumber: 0 — sistem rezerviše sljedeći slobodan redni broj ako je 0 / nije eksplicitno potreban.

2. Fiskalizuj

curl -X POST "https://api.fiskalmn.me/api/invoices/{id}/fiscalize" \
  -H "Authorization: Bearer fk_live_YOUR_KEY"

Odgovor: 202 Accepted, status Pending.

3. Poll status

curl -X GET "https://api.fiskalmn.me/api/invoices/{id}" \
  -H "Authorization: Bearer fk_live_YOUR_KEY"

Kad je status = Fiscalized, koristite:

  • iic, fic, invoiceNumber
  • PDF: GET /api/invoices/{id}/pdf

Preporučeni interval pollinga: 1–2 s, max ~30–60 s, sa exponential backoff.

Storno / ispravka

Fiskalizovani račun se ne briše. Šaljete novi dokument type: "Corrective" sa original.id = IIC originala; za storno stavke imaju negativnu količinu i negativnu cijenu.

Detalji i primjeri: Storno i korektivni.

Gotovina (POS)

Za gotovinske račune postoji one-shot endpoint:

POST /api/invoices/cash/create-and-print

Detalji u Endpointi.

AutentifikacijaEndpointi