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 | Српски

Употреба

Конфигурација (config)

ibkr-porez config

Креирање или измена личних података и подешавања приступа IBKR-у.

Биће вам затражено:

  • IBKR Flex Token: Преузимање токена ↗
  • IBKR Query ID: Креирање Flex Query-а ↗
  • Personal ID: ЈМБГ / ЕБС
  • Full Name: Име и Презиме
  • Address: Адреса пребивалишта
  • City Code: Троцифрени код општине. Пример: 223 (Нови Сад). Код можете наћи у шифарнику (видети колону “Шифра”). Такође доступан у падајућем менију на порталу еПорези.
  • Phone: Телефон
  • Email: Email
  • Data Directory: Апсолутна путања до фолдера са фајловима података (transactions.json, declarations.json, rates.json, итд.). Подразумевано: ibkr-porez-data у фолдеру апликације.
  • Output Folder: Апсолутна путања до фолдера за чување фајлова из команди sync, export, export-flex, report. Подразумевано: фолдер Downloads вашег система.

Преузимање података (fetch)

ibkr-porez fetch

Преузима најновије податке са IBKR и синхронизује курсеве са НБС (Народна банка Србије).

Чува их у локално складиште.

Увоз историјских података (import)

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

Учитавање историје трансакција старије од 365 дана, која се не може преузети путем Flex Query-а (fetch).

Да бисте креирали фајл са трансакцијама на порталу Interactive Brokers погледајте Извоз пуне историје ↗

⚠️ Не заборавите да покренете fetch након import како би апликација додала максимум детаља бар за последњу годину у мање детаљне податке учитане из CSV-а.

Логика синхронизације (import + fetch)

При учитавању података из CSV-а (import) и Flex Query-а (fetch), систем даје приоритет потпунијим Flex Query подацима:

  • Подаци Flex Query-а (fetch) су извор истине. Они преписују CSV податке за било које подударне датуме.
  • Ако се запис Flex Query-а семантички поклапа са CSV записом (Датум, Тикер, Цена, Количина), то се рачуна као ажурирање (замена званичним ID-ем).
  • Ако се структура података разликује (нпр. сплит налози у Flex Query-у против “спојеног” записа у CSV-у), стари CSV запис се уклања, а нови Flex Query записи се додају.
  • Потпуно идентични записи се прескачу.

Синхронизација података и креирање пријава (sync)

ibkr-porez sync

Ради све исто што и fetch:

  • Преузима најновије трансакције са IBKR путем Flex Query-а
  • Синхронизује курсеве валута са НБС

Након тога креира све потребне пријаве за последњих 45 дана (ако већ нису креиране).

Затим можете Управљати креираним пријавама.

💡 Ако сте покренули sync први пут и она је креирала пријаве које сте већ подали пре почетка коришћења апликације, можете брзо да их све означите као плаћене и уклоните из излаза list:

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

Приказ статистике (stat)

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

Приказује:

  • Примљене дивиденде (у РСД)
  • Број продаја (порески догађаји)
  • Процену реализованог P/L (Капитална добит) (у РСД)
  • Детаљну поделу по тикерима или месецима (при коришћењу филтера)

Генерисање пореског извештаја (report)

ibkr-porez report

Ако не наведете тип извештаја и период, подразумевано се генерише ППДГ-3Р за последње пуно полугодиште

  • Креира ppdg3r_XXXX_HY.xml у Output Folder
  • Увезите овај фајл на портал Пореске управе Србије (еПорези)
  • Ручно отпремите фајл из Документ потврде у Тачку 8

Да бисте изабрали други тип пријаве или временски период погледајте документацију

ibkr-porez report --help

Управљање пријавама

Након креирања пријава путем команде sync можете их прегледати, мењати статус и извозити за отпремање на порески портал.

Списак пријава (list)

Приказује списак свих пријава са могућношћу филтрирања по статусу.

# Прикажи активне пријаве (подразумевано):
# draft + submitted + pending
ibkr-porez list

# Прикажи све пријаве
ibkr-porez list --all

# Филтер по статусу
ibkr-porez list --status draft
ibkr-porez list --status submitted
ibkr-porez list --status pending
ibkr-porez list --status finalized

# Само ID пријава (за коришћење у цевима)
ibkr-porez list --ids-only
ibkr-porez list --status draft -1

Пример коришћења у linux-стилу:

# Поднети све нацрте
ibkr-porez list --status draft -1 | ibkr-porez submit

Преглед детаља пријаве (show)

Приказује детаљне информације о одређеној пријави.

ibkr-porez show <declaration_id>

Приказује:

  • Тип пријаве (ППДГ-3Р или ПП ОПО)
  • Период пријаве
  • Статус (нацрт, поднета, на чекању, завршена)
  • Детаље трансакција и прорачуна
  • Приложене фајлове

Подношење пријаве (submit)

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

Означава пријаву као поднету (увезену на порески портал).

Понашање зависи од типа пријаве:

  • PPDG-3R након submit прелази у статус pending (чека решење пореске управе о износу пореза).
  • PP OPO након submit:
    • прелази у submitted ако постоји порез за плаћање;
    • прелази директно у finalized ако је порез 0.

Плаћање пријаве (pay)

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

Означава пријаву као завршену (finalized) и чува датум плаћања.

Опција --tax омогућава да одмах забележите износ пореза током плаћања, без посебног корака assess.

Након тога ће нестати са списка приказаног list (без --all)

Евиденција износа по решењу пореске (assess)

# Забележи званичан износ пореза из решења
ibkr-porez assess <declaration_id> --tax-due 1234.56

# Забележи износ и одмах означи као већ плаћено
ibkr-porez assess <declaration_id> --tax-due 1234.56 --paid

Команда је најважнија за PPDG-3R, где износ пореза одређује пореска управа након подношења пријаве.

Шта команда ради:

  • уписује званичан износ пореза у метаподатке пријаве;
  • са --paid одмах пребацује пријаву у finalized;
  • без --paid:
    • ако је износ већи од нуле, пријава остаје активна (submitted) за накнадно плаћање;
    • ако је износ нула, пријава прелази у finalized.

Извоз пријаве (export)

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

Копира XML и све приложене фајлове (attach) у Output Folder или у каталог наведен у параметрима.

Повратак статуса пријаве (revert)

# Вратити на нацрт (подразумевано)
ibkr-porez revert <id> [<id> ...]

# Вратити на поднету
ibkr-porez revert <id> [<id> ...] --to submitted

Враћа статус пријаве.

Приложавање фајла уз пријаву (attach)

# Приложити фајл
ibkr-porez attach <declaration_id> /path/to/file.pdf

# Обрисати приложени фајл
ibkr-porez attach <declaration_id> <file_id> --delete
ibkr-porez attach <declaration_id> --delete --file-id <file_id>

Приложава фајл уз пријаву или уклања приложени фајл из складишта пријава.

За чување у складишту пријава користи се само име фајла (путања се одбацује), тако да имена морају бити јединствена - иначе ће фајл са истим именом преписати раније учитан фајл са истим именом чак и из друге путање

💡 Приложени фајлови се копирају заједно са XML пријаве током извоза (export)

Извоз 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 -  # Излаз у stdout (за цеви)

Извоз XML фајла Flex Query добијеног током fetch или sync на наведени датум.

Пример коришћења у linux-стилу:

ibkr-porez export-flex 2025-01-15 | ibkr-porez import