Gotovinski računi

Tok integracije

POST /api/invoices/draft      (typeOfInvoice: "Cash")
POST /api/invoices/{id}/fiscalize

Alternativa (jedan korak):

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

Šta šaljete u API

Šaljete	Ne šaljete
Podatke računa (`items`, `buyer`, `paymentMethod`, …)	EFI kodove (software, BU, ENU, operator, maintainer)
`typeOfInvoice: "Cash"`	Sertifikat
`Authorization: Bearer fk_test_...` ili `fk_live_...`

EFI kodovi i sertifikat su u Fiskal MN admin panelu firme. API ih automatski koristi prema tipu API ključa.

API ključ	EFI kodovi iz admina
`fk_test_...`	Test Software / BU / ENU / Operator / Maintainer
`fk_live_...`	Software / BU / ENU / Operator / Maintainer

B2C e-commerce (lična kartica)

{
  "type": "Invoice",
  "orderNumber": 0,
  "typeOfInvoice": "Cash",
  "paymentMethod": "CARD",
  "paymentDeadline": "2026-08-13T00:00:00Z",
  "buyer": {
    "idType": "TIN",
    "idNumber": "12345678",
    "name": "Ime Prezime",
    "address": "Ulica 1",
    "city": "Podgorica",
    "country": "MNE"
  },
  "items": [{
    "name": "Usluga",
    "code": "SVC-001",
    "unit": "kom",
    "unitPrice": 25.00,
    "quantity": 1,
    "vat": { "rate": 21 }
  }]
}

Zatim: POST /api/invoices/{id}/fiscalize (bez body-a).

Više kombinacija paymentMethod: Načini plaćanja.

INITIAL depozit

Pri fiscalize gotovinskog računa API automatski registruje INITIAL depozit (0.00) prije slanja na EFI.

Važi i za POST /api/invoices/cash/create-and-print
EFI Code=56 (već registrovan danas) — nastavlja se fiskalizacija
Ručni poziv obično nije potreban

Onboarding (samo ako fiskalizacija ne prolazi)

Registracija ENU

POST /api/tcr/register
Authorization: Bearer fk_test_...
Content-Type: application/json
 
{}

Prazan body je dovoljan ako su kodovi u adminu.

Početni depozit (ručno)

POST /api/cashdeposit/initial
Authorization: Bearer fk_test_...
Content-Type: application/json
 
{ "cashAmount": 0 }

EFI greške

EFI kod	Rješenje
53	`POST /api/tcr/register` sa `{}`, provjeri ENU u adminu
56	INITIAL već registrovan danas — nastavi
58	Ponovi `fiscalize` ili `POST /api/cashdeposit/initial`
11	Pogrešan ENU u adminu ili TCR nije aktivan

Greška pri fiskalizaciji:

{
  "error": "...",
  "code": "INITIAL_DEPOSIT_FAILED",
  "tcrCode": "..."
}

Primjer (curl)

1. Draft

curl -s -X POST "https://api.fiskalmn.me/api/invoices/draft" \
  -H "Authorization: Bearer fk_test_VAŠ_KLJUČ" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "Invoice",
    "orderNumber": 0,
    "typeOfInvoice": "Cash",
    "paymentMethod": "CARD",
    "paymentDeadline": "2026-08-13T00:00:00Z",
    "items": [{
      "name": "Test",
      "code": "T1",
      "unit": "kom",
      "unitPrice": 10.00,
      "quantity": 1,
      "vat": { "rate": 0 }
    }]
  }'

2. Fiskalizacija

curl -s -X POST "https://api.fiskalmn.me/api/invoices/{id}/fiscalize" \
  -H "Authorization: Bearer fk_test_VAŠ_KLJUČ"

Očekivano: status: "Fiscalized" (ili 202 + poll).

3. PDF

curl -s -o racun.pdf "https://api.fiskalmn.me/api/invoices/{id}/pdf" \
  -H "Authorization: Bearer fk_test_VAŠ_KLJUČ"

Checklist

Provjera
API ključ: `fk_test_` za test, `fk_live_` za produkciju
Sertifikat uploadovan u adminu
EFI kodovi popunjeni (uključujući Maintainer)
`typeOfInvoice: "Cash"`, `paymentMethod: "CARD"` za B2C

Storno gotovinskog: type: "Corrective" + original — Storno i korektivni.

Načini plaćanja Storno i korektivni