Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

English | Русский | Українська | Srpski | Српски

Upotreba

Brzi start

Ako želite brzo da kreirate konkretnu prijavu:

  1. Podesite podatke (config) ↗ — jednom pri prvom pokretanju
  2. Preuzmite najnovije podatke (fetch) ↗
  3. Kreirajte izveštaj (report) ↗
  4. Otpremite kreirani XML na portal ePorezi (sekcija PPDG-3R)

Za automatsko dobijanje svih prijava i praćenje njihovih statusa — koristite sync umesto koraka 2–3.

Konfiguracija (config)

ibkr-porez config

Kreiranje ili izmena ličnih podataka i podešavanja pristupa IBKR-u.

Biće vam zatraženo:

  • IBKR Flex Token: Preuzimanje tokena ↗
  • IBKR Query ID: Kreiranje Flex Query-a ↗
  • Personal ID: JMBG / EBS
  • Full Name: Ime i Prezime
  • Address: Adresa prebivališta
  • City Code: Trocefrni kod opštine. Primer: 223 (Novi Sad). Kod možete naći u šifarniku (videti kolonu “Šifra”). Takođe dostupan u padajućem meniju na portalu ePorezi.
  • Phone: Telefon
  • Email: Email
  • Data Directory: Apsolutna putanja do foldera sa fajlovima podataka (transactions.json, declarations.json, rates.json, itd.). Podrazumevano: ibkr-porez-data u folderu aplikacije.
  • Output Folder: Apsolutna putanja do foldera za čuvanje fajlova iz komandi sync, export, export-flex, report. Podrazumevano: folder Downloads vašeg sistema.

Preuzimanje podataka (fetch)

ibkr-porez fetch

Preuzima najnovije podatke sa IBKR i sinhronizuje kurseve sa NBS (Narodna banka Srbije).

Čuva ih u lokalno skladište.

Uvoz istorijskih podataka (import)

ibkr-porez import /path/to/activity_statement.csv

Učitavanje istorije transakcija starije od 365 dana, koja se ne može preuzeti putem Flex Query-a (fetch).

Da biste kreirali fajl sa transakcijama na portalu Interactive Brokers pogledajte Izvoz pune istorije ↗

⚠️ Ne zaboravite da pokrenete fetch nakon import kako bi aplikacija dodala maksimum detalja bar za poslednju godinu u manje detaljne podatke učitane iz CSV-a.

Logika sinhronizacije (import + fetch)

Pri učitavanju podataka iz CSV-a (import) i Flex Query-a (fetch), sistem daje prioritet potpunijim Flex Query podacima:

  • Podaci Flex Query-a (fetch) su izvor istine. Oni prepisuju CSV podatke za bilo koje podudarne datume.
  • Ako se zapis Flex Query-a semantički poklapa sa CSV zapisom (Datum, Tiker, Cena, Količina), to se računa kao ažuriranje (zamena zvaničnim ID-em).
  • Ako se struktura podataka razlikuje (npr. split nalozi u Flex Query-u protiv “spojenog” zapisa u CSV-u), stari CSV zapis se uklanja, a novi Flex Query zapisi se dodaju.
  • Potpuno identični zapisi se preskaču.

Sinhronizacija podataka i kreiranje prijava (sync)

ibkr-porez sync

Radi sve isto što i fetch:

  • Preuzima najnovije transakcije sa IBKR putem Flex Query-a
  • Sinhronizuje kurseve valuta sa NBS

Nakon toga kreira sve potrebne prijave za poslednjih 45 dana (ako već nisu kreirane).

Prihod koji stigne u aplikaciju sa zakašnjenjem — posle neuspele veze, zbog kursa koji nedostaje ili prosto zato što ga je IBKR prijavio nekoliko dana kasnije — biće obuhvaćen sledećim sync-om dok je njegov datum još unutar tih 45 dana. Ne postoji oznaka „sinhronizovano do ovog dana”, pa zakasneli podaci nikada ne bivaju preskočeni.

Stariji prihod aplikacija ne prijavljuje na sopstvenu inicijativu: rok za podnošenje je prošao, pa je podnošenje vaša odluka. Zatražite ga izričito, proširivanjem prozora:

# prijavi neprijavljen prihod poslednjih 400 dana
ibkr-porez sync --lookback 400

💡 Ako veza sa IBKR-om ne uspe, sync i dalje kreira prijave iz već lokalno sačuvanih transakcija i ispisuje upozorenje; komanda se završava uspešno, a u GUI-ju se ponovni pokušaji za svežim podacima nastavljaju automatski u sledećem ciklusu.

Zatim možete Upravljati kreiranim prijavama.

💡 Ako ste pokrenuli sync prvi put i ona je kreirala prijave koje ste već podali pre početka korišćenja aplikacije, možete brzo da ih sve označite kao plaćene i uklonite iz izlaza list:

ibkr-porez list --status submitted -1 | ibkr-porez pay

Sinhronizacija iz preuzetog XML fajla (sync --file)

Ako IBKR API privremeno nije dostupan, možete ručno preuzeti Flex Query XML sa IBKR sajta i koristiti ga:

ibkr-porez sync --file /path/to/report.xml

Radi sve isto što i sync — čuva transakcije, kreira sve potrebne prijave — ali čita podatke iz lokalnog fajla umesto pozivanja IBKR API-ja.

Pogledajte kako preuzeti Flex Query XML ↗.

U GUI-u, ista opcija dostupna je u meniju ☰ kao Sync from Flex Query XML….

Izmenjene prijave

Porez plaćen u inostranstvu na jednu raspodelu nije konačan. Nakon zatvaranja godine američki fond prijavljuje brokeru konačan poreski karakter prošlogodišnjih raspodela, pa broker storniran porez koji je zadržao — uobičajen slučaj je ETF na trezorske zapise čija se raspodela pokaže kao dividenda kamatnog karaktera — i zadržava iznova ako novi karakter to nalaže. To se dešava od nekoliko nedelja do otprilike petnaest meseci nakon isplate.

Kada se iznosi na kojima počiva već kreirana PP OPO prijava promene, sledeći sync kreira izmenjenu prijavu. To je obična prijava u svakom pogledu: pojavljuje se u list, dobija sopstveni XML u izlaznom folderu, podnosi se i plaća kao svaka druga. Ispod linije o kreiranoj prijavi sync ispisuje datum ostvarivanja prihoda i broj originala — ono po čemu se original pronalazi u tabeli ePorezi.

Izmenjenu prijavu treba podneti: ona zamenjuje prvobitnu. Ako je broj originala zabeležen preko submit --number, već je u dokumentu; u suprotnom ga upisujete na ePorezi, pronalazeći original po datumu ostvarivanja prihoda.

Poređenje se radi u valuti prihoda, pa promenjen kurs nikada ne dovodi do izmenjene prijave. Takve promene sync traži do 1. januara prethodne godine, bez obzira na prozor za kreiranje novih prijava.

Prikaz statistike (stat)

ibkr-porez stat --year 2025
ibkr-porez stat --ticker AAPL
ibkr-porez stat --month 2025-01

Prikazuje:

  • Primljene dividende (u RSD)
  • Broj prodaja (poreski događaji)
  • Procenu realizovanog P/L (Kapitalna dobit) (u RSD)
  • Detaljnu podelu po tikerima ili mesecima (pri korišćenju filtera)

Generisanje poreskog izveštaja (report)

ibkr-porez report

Ako ne navedete tip izveštaja i period, podrazumevano se generiše PPDG-3R za poslednje puno polugodište

  • Kreira ppdg3r_XXXX_HY.xml u Output Folder
  • Uvezite ovaj fajl na portal Poreske uprave Srbije (ePorezi)
  • Ručno otpremite fajl iz Dokument potvrde u Tačku 8

Da biste izabrali drugi tip prijave ili vremenski period pogledajte dokumentaciju

ibkr-porez report --help

PP OPO za period (report --type income)

# prihod tekućeg meseca do danas
ibkr-porez report --type income

# izričito zadat period
ibkr-porez report --type income --start 2025-07-01 --end 2025-12-31

Upisuje u izlazni folder po jedan PP OPO XML za svaku grupu prihoda i ne radi ništa više: prijava se pri tome ne evidentira, pa se ti fajlovi ne pojavljuju u list, ne porede se sa onim što je sync već kreirao i nikada ne dovode do izmenjenih prijava. Prijave koje nameravate da vodite kreira sync.

Grupa za koju porez po odbitku još nije stigao se ne upisuje. Umesto fajla komanda ispisuje od kog datuma će biti prijavljena: porez se obično knjiži u roku od nekoliko dana od prihoda, a dokument sa priznanjem koje broker još nije doračunao vredi sačekati. Nakon tog datuma grupa se upisuje sa nultim priznanjem i punih 15% za uplatu — upravo to podnosite ako porez nikada ne stigne.

--force to čekanje ne skraćuje. Znači samo „generiši sa približnim podacima“: gde Narodna banka nema kurs za datum, koristi se najbliži iz keša, a gde nedostaju podaci o praznicima za godinu, rok dospeća se računa samo po radnim danima.

Upravljanje prijavama

Nakon kreiranja prijava putem komande sync možete ih pregledati, menjati status i izvoziti za otpremanje na poreski portal.

Spisak prijava (list)

Prikazuje spisak svih prijava sa mogućnošću filtriranja po statusu.

# Prikaži aktivne prijave (podrazumevano):
# draft + submitted + pending
ibkr-porez list

# Prikaži sve prijave
ibkr-porez list --all

# Filter po statusu
ibkr-porez list --status draft
ibkr-porez list --status submitted
ibkr-porez list --status pending
ibkr-porez list --status finalized

# Samo ID prijava (za korišćenje u cevima)
ibkr-porez list --ids-only
ibkr-porez list --status draft -1

Primer korišćenja u linux-stilu:

# Podneti sve nacrte
ibkr-porez list --status draft -1 | ibkr-porez submit

Pregled detalja prijave (show)

Prikazuje detaljne informacije o određenoj prijavi.

ibkr-porez show <declaration_id>

Prikazuje:

  • Tip prijave (PPDG-3R ili PP OPO)
  • Period prijave
  • Status (nacrt, podneta, na čekanju, završena)
  • Detalje transakcija i proračuna
  • Za PPDG-3R: dobitak/gubitak priznat od strane poreske uprave pored izračunatih vrednosti, iskorišćeni prenos kapitalnih gubitaka (početno/ iskorišćeno/korigovano/krajnje stanje) i iz kojih “tranši” je iskorišćen
  • Priložene fajlove

Podnošenje prijave (submit)

ibkr-porez submit <id> [<id> ...]

# zabeležiti broj koji je poreski portal dodelio prijavi
ibkr-porez submit <id> --number 1234567890

Označava prijavu kao podnetu (uvezenu na poreski portal).

Ponašanje zavisi od tipa prijave:

  • PPDG-3R nakon submit prelazi u status pending (čeka rešenje poreske uprave o iznosu poreza).
  • PP OPO nakon submit:
    • prelazi u submitted ako postoji porez za plaćanje;
    • prelazi direktno u finalized ako je porez 0.

--number beleži broj prijave na poreskom portalu — od 1 do 19 cifara, za jednu prijavu odjednom. Ako prijava kasnije bude izmenjena, izmenjena prijava nosi taj broj da bi poreska znala koju prijavu zamenjuje. Bez njega se izmenjena prijava svejedno kreira, a broj upisujete na ePorezi.

U GUI-u, dugme Submit otvara dijalog potvrde sa istim opcionim poljem.

Plaćanje prijave (pay)

ibkr-porez pay <id> [<id> ...]
ibkr-porez pay <id> --tax 1234.56

Označava prijavu kao završenu (finalized) i čuva datum plaćanja.

Opcija --tax omogućava da odmah zabeležite iznos poreza tokom plaćanja, bez posebnog koraka assess.

Nakon toga će nestati sa spiska prikazanog list (bez --all)

Evidencija iznosa po rešenju poreske (assess)

# Zabeleži zvaničan iznos poreza iz rešenja
ibkr-porez assess <declaration_id> --tax 1234.56

# Zabeleži iznos i odmah označi kao već plaćeno
ibkr-porez assess <declaration_id> --tax 1234.56 --paid

# Zabeleži gubitak priznat od strane poreske uprave (samo za PPDG-3R)
ibkr-porez assess <declaration_id> --loss 50000.00 \
    --reference "RES-123/2025" --date 2025-09-01

# Zabeleži dobitak priznat od strane poreske uprave (samo za PPDG-3R)
ibkr-porez assess <declaration_id> --gain 12000.00

Komanda je najvažnija za PPDG-3R, gde iznos poreza, kao i priznati kapitalni dobitak/gubitak, određuje poreska uprava nakon podnošenja prijave.

Šta komanda radi:

  • upisuje zvaničan iznos poreza u metapodatke prijave (--tax);
  • sa --paid odmah prebacuje prijavu u finalized;
  • bez --paid:
    • ako je iznos veći od nule, prijava ostaje aktivna (submitted) za naknadno plaćanje;
    • ako je iznos nula, prijava prelazi u finalized.

Mora biti navedena bar jedna od opcija: --tax, --gain, --loss.

--gain i --loss su dostupni samo za PPDG-3R i upisuju kapitalni dobitak/gubitak priznat od strane poreske uprave — čuvaju se pored izračunatih vrednosti aplikacije i mogu se razlikovati od njih (zbog CPI korekcija ili metodologije poreske uprave). Jedno rešenje ne može istovremeno priznati i dobitak i gubitak.

--reference, --date i --notes su podaci o rešenju (broj, datum, napomene). Prikazuju se u show, a za priznati gubitak broj i datum rešenja se dodatno upisuju u deo 7 budućih PPDG-3R prijava (vidi prenos kapitalnih gubitaka), pa ih vredi evidentirati.

Ako rešenje priznaje gubitak (--loss veći od nule), kreira se (ili ažurira) zapis u registru prenosa kapitalnih gubitaka. Prenos se uvek zasniva na gubitku priznatom od strane poreske uprave, a ne na izračunatom.

⚠️ Nakon što je preneti gubitak makar delimično iskorišćen u jednoj od narednih prijava, priznati gubitak se više ne može menjati putem assess — komanda će vratiti grešku.

Prenos kapitalnih gubitaka (carryforward)

ibkr-porez carryforward

Prikazuje listu svih “tranši” (vintages) kapitalnih gubitaka priznatih od strane poreske uprave, dostupnih za prenos u buduće periode:

  • prijavu-izvor i period za koji je gubitak priznat;
  • priznat i preostali (neiskorišćeni) iznos;
  • poresku godinu nakon koje prenos ističe (gubitak se može preneti najviše 5 godina unapred);
  • status: Active (može se koristiti), Exhausted (potpuno iskorišćen), Expired (istekao rok).

Ista lista je dostupna u GUI-ju u meniju ☰ → Capital loss carryforward….

Svaka PPDG-3R prijava kreirana putem sync automatski umanjuje izračunatu poresku osnovicu koristeći raspoložive prenose (od starijih ka novijim periodima), dok se osnovica ne svede na nulu ili se prenosi ne iscrpe. Pregled report-a prikazuje iskorišćeni i preostali iznos prenosa nakon toga. Iznos se odbija iz registra samo jednom — prilikom čuvanja prijave; ponovni sync za isti period ga ne odbija ponovo.

Preneti gubici se takođe prijavljuju u samoj prijavi: u PPDG-3R XML-u se popunjava deo 7 („Kapitalni gubici“) — po jedan red za svaki aktivan prenos, sa brojem i datumom rešenja poreske uprave (7.2/7.3) i preostalim iznosom gubitka (7.4). Konačni Osnovica i PorezZaUplatu u XML-u takođe uzimaju u obzir primenjeni prenos. Prijavljivanje gubitka u delu 7 je obaveza samog poreskog obveznika — bez toga ga poreska uprava neće primeniti u rešenju.

Broj i datum rešenja se uzimaju iz assess (--reference i --date). Ako nisu evidentirani, polja 7.2/7.3 u XML-u ostaju prazna, a report ispisuje upozorenje — evidentirajte ih kroz assess i ponovo generišite izveštaj, ili popunite ta polja ručno na portalu.

Izvoz prijave (export)

ibkr-porez export <declaration_id>
ibkr-porez export <declaration_id> -o /path/to/output

Kopira XML i sve priložene fajlove (attach) u Output Folder ili u katalog naveden u parametrima.

Povratak statusa prijave (revert)

# Vratiti na nacrt (podrazumevano)
ibkr-porez revert <id> [<id> ...]

# Vratiti na podnetu
ibkr-porez revert <id> [<id> ...] --to submitted

Vraća status prijave.

Brisanje prijave (delete)

# Pregled plana (ništa se ne menja)
ibkr-porez delete <id>

# Obriši prijavu
ibkr-porez delete <id> --yes

# Dozvoli brisanje prijave koja nije nacrt
ibkr-porez delete <id> --yes --force

Briše prijavu i poništava njen uticaj na knjigu prenosa: prenos gubitka koji je iskoristila vraća se izvornim „tranšama”, a njena sopstvena tranša priznatog gubitka (napravljena preko assess) se uklanja. Ako ste je obrisali da biste ispravili grešku, zatim pokrenite sync da ponovo napravite period iz sačuvanih transakcija — do PP OPO prijave čiji je datum prihoda stariji od 45 dana dopire sync --lookback N.

Bez --yes samo ispisuje šta bi bilo obrisano. --force je neophodan za brisanje prijave koja nije nacrt. Može se obrisati samo najnoviji PPDG-3R — brisanje starijeg ostavilo bi „viseći” prenos kod kasnijih prijava; PP OPO prijave se mogu brisati u bilo kom trenutku.

Tako se ispravlja i priznati gubitak prethodne prijave koji je kasnija već iskoristila: obrišite kasniju prijavu (oslobađajući prenos), ponovo pokrenite assess na ranijoj, pa sync za ponovno pravljenje.

U GUI-ju je ista radnja dostupna dugmetom Delete u redu prijave: otvara dijalog za potvrdu (umesto --yes) sa poljem Force za prijave koje nisu nacrt.

Priložavanje fajla uz prijavu (attach)

# Priložiti fajl
ibkr-porez attach <declaration_id> /path/to/file.pdf

# Obrisati priloženi fajl
ibkr-porez attach <declaration_id> <file_id> --delete
ibkr-porez attach <declaration_id> --delete --file-id <file_id>

Priložava fajl uz prijavu ili uklanja priloženi fajl iz skladišta prijava.

Za čuvanje u skladištu prijava koristi se samo ime fajla (putanja se odbacuje), tako da imena moraju biti jedinstvena - inače će fajl sa istim imenom prepisati ranije učitan fajl sa istim imenom čak i iz druge putanje

💡 Priloženi fajlovi se kopiraju zajedno sa XML prijave tokom izvoza (export)

Izvoz Flex Query (export-flex)

ibkr-porez export-flex 2025-01-15
ibkr-porez export-flex 2025-01-15 -o /path/to/output.xml
ibkr-porez export-flex 2025-01-15 -o -  # Izlaz u stdout (za cevi)

Izvoz XML fajla Flex Query dobijenog tokom fetch ili sync na navedeni datum.

Primer korišćenja u linux-stilu:

ibkr-porez export-flex 2025-01-15 | ibkr-porez sync --file -