Конвертиране на датата във формат за данъчната декларация и поставяне на валутните курсове в съседна колона

С тези скриптове отчасти се автоматизира обработката на данните за данъчната декларация.

Въвеждането на данните в данъчната декларация може да стане чрез nap-autopilot (захранва се с csv файлове с обработени данни).

Първо вкарваме данните в електронна таблица.

С различни методи проба-грешка се установява кой метод на копиране работи:

• Дали с copy/paste или селектиране и средния бутон (в Linux).
• С кой браузър да се отварят HTML справките за да работи коректно копирането.
• С кой браузър или програма за преглед на PDF да се отварят справките във формат PDF за да работи копирането от PDF.
• Дали първо да се копира в обикновен текстов редактор и после от там да се копира и постави (copy/paste) в електронната таблица.
• Как да се постави (paste) - дали да се избере нещо от менюто Paste Special или не.

В Interactive Brokers има възможност справката да е в CSV формат (освен HTML и PDF), което услеснява прехвърлянето на данни в електронна таблица.

Подводни камъни при четене на справките и грешни данни

При някои инвестиционни посредници справките в PDF формат не могат да се обработят даже и с изкуствен интелект. Например при TastyTrade - те дават машинно четими справки със закъснение (не съм ги проверявал дали са годни, но предишна година имаше грешна дата в една от машинно четимите им справки и затова внимавам).

Прочетете първо за подводните камъни при четенето на справки, има различни видове грешки в някои справки (вижте статията ми за Interactive Brokers и за попълването на данъчната декларация). Подробно обясних в цитираната статия защо смятам, че за данъчни цели (за изчисляване на печалбата от поскъпването) се взима trade date, а не settlement date.

Interactive Brokers съм ги хващал да слагат грешна дата в данъчната справка за дивидентите (обясних в коя справка е коректната дата в цитираните статии) и да не слагат някои от дивидентите в общата справка когато те са получени съвсем в края на годината (за да се видят трябва да се избере като крайна дата някой работен ден от януари следващата година - затова си вадя контролни справки с начална дата няколко дена преди началото на годината и няколко дена след края ѝ за да проверя дали има изпуснати данни).

Данни за валутните курсове със запълнени празнини

Файловете с имена, съдържащи "corrected" са коригирани така, че да включват валутните курсове за всички дни от годината. Когато има празнина се запълва с предходния публикуван валутен курс.

Освен, че са обработени със скрипта fill_gaps_in_currency_rates.py допълнително съм ги коригирал да нямат нули в края (trailing zeors) за да съвпадат с оригиналните данни. И махнах заглавната част, не помня защо.

Данните във файловете с имена, съдържащи "with_gaps", са получени от сайта на БНБ (липсват данни за някои дни, защото БНБ не дава валутен курс когато е почивен ден).

BNB_downloader.py - скрипт за теглене директно от сайта на БНБ

Ако се ползва този скрипт няма нужда от fill_gaps_in_currency_rates.py, защото освен че тегли данните директно от сайта на БНБ запълва и празнините.

Скриптът тегли датите от декември месец предната година и всички месеци от зададената година като ползва данните от миналата година за да запълни празнините в началото на януари.

Скриптът изчаква случаен интервал между 1 и 3 секудни преди всяко теглене за да не натоварва сайта на БНБ (да не се задейства някоя защита против претоварване).

Пример за теглене на валутните курсове за USD през 2024 година:

$ ./BNB_downloader.py USD 2024 USD_2024_corrected.csv
Preparing to download currency rates for USD from 01 December 2023 to 31 December 2023...
Sleeping for 1.511 seconds... Done sleeping.
Fetching data... Data fetched successfully.
Preparing to download currency rates for USD from 01 January 2024 to 31 January 2024...
Sleeping for 2.742 seconds... Done sleeping.
Fetching data... Data fetched successfully.
Preparing to download currency rates for USD from 01 February 2024 to 29 February 2024...
Sleeping for 2.550 seconds... Done sleeping.
Fetching data... Data fetched successfully.
Preparing to download currency rates for USD from 01 March 2024 to 31 March 2024...
Sleeping for 1.097 seconds... Done sleeping.
Fetching data... Data fetched successfully.
Preparing to download currency rates for USD from 01 April 2024 to 30 April 2024...
Sleeping for 1.589 seconds... Done sleeping.
Fetching data... Data fetched successfully.
Preparing to download currency rates for USD from 01 May 2024 to 31 May 2024...
Sleeping for 2.272 seconds... Done sleeping.
Fetching data... Data fetched successfully.
Preparing to download currency rates for USD from 01 June 2024 to 30 June 2024...
Sleeping for 1.522 seconds... Done sleeping.
Fetching data... Data fetched successfully.
Preparing to download currency rates for USD from 01 July 2024 to 31 July 2024...
Sleeping for 2.489 seconds... Done sleeping.
Fetching data... Data fetched successfully.
Preparing to download currency rates for USD from 01 August 2024 to 31 August 2024...
Sleeping for 2.168 seconds... Done sleeping.
Fetching data... Data fetched successfully.
Preparing to download currency rates for USD from 01 September 2024 to 30 September 2024...
Sleeping for 2.311 seconds... Done sleeping.
Fetching data... Data fetched successfully.
Preparing to download currency rates for USD from 01 October 2024 to 31 October 2024...
Sleeping for 1.560 seconds... Done sleeping.
Fetching data... Data fetched successfully.
Preparing to download currency rates for USD from 01 November 2024 to 30 November 2024...
Sleeping for 2.663 seconds... Done sleeping.
Fetching data... Data fetched successfully.
Preparing to download currency rates for USD from 01 December 2024 to 31 December 2024...
Sleeping for 1.896 seconds... Done sleeping.
Fetching data... Data fetched successfully.
Exchange rates for USD in 2024 saved to USD_2024_corrected.csv

Скриптът работи за USD, GBP, AUD, CHF, CAD. Обаче за някои валути като JPY изтегля валутния курс не за 1 валутна единица, а за различен брой (при JPY тегли валутния курс за 100 JPY).

Примерно ползване

$ ./convert_date_and_add_currency_rate.py USD_2023_corrected.csv input_file output_file.csv
Error: time data '' does not match format '%m/%d/%y'

Причината за грешката е, че последния ред от файла е празен. Иначе си работи нормално.

Данните на входа са във формата, който е ползван в справките от TastyTrade в PDF формат (от където преписвам ръчно в електронна таблица данните за доходите):

Примерни данни за input_file:

05/25/23
06/12/23
06/15/23
08/24/23
08/31/23
09/07/23
09/11/23
09/15/23
11/22/23
11/30/23
12/11/23

Последният ред е празен, което е грешка.

На изхода получаваме във файла output_file.csv:

Original Date,Converted Date,Currency Rate
05/25/23,25.05.2023,1.82192
06/12/23,12.06.2023,1.81684
06/15/23,15.06.2023,1.80777
08/24/23,24.08.2023,1.80427
08/31/23,31.08.2023,1.79962
09/07/23,07.09.2023,1.82617
09/11/23,11.09.2023,1.82379
09/15/23,15.09.2023,1.83508
11/22/23,22.11.2023,1.79253
11/30/23,30.11.2023,1.78925
12/11/23,11.12.2023,1.81819

Отваряме csv файла с програмата за електронни таблици и копираме цялата колона като внимаваме да не се получи разминаване. За по-сигурно може да копираме и трите колони и така ще имаме още една колона с датата (за по-лесна визуална проврка дали погрешка сме копирали данните по-нагоре или по-надолу).

Данните на входа от следващия пример са във формата, който е ползван в справките от Interactive Brokers в HTML формат (от където копирам в електронна таблица данните за доходите): месец/ден/година.

Примерни данни за input_file:

2023-01-03
2023-02-01
2023-03-10
2023-03-17
2023-03-31
2023-03-31
2023-04-03
2023-05-01
2023-06-12
2023-07-05
2023-08-01

На изхода получаваме във файла output_file.csv:

Original Date,Converted Date,Currency Rate
2023-01-03,03.01.2023,1.85475
2023-02-01,01.02.2023,1.79533
2023-03-10,10.03.2023,1.84756
2023-03-17,17.03.2023,1.84113
2023-03-31,31.03.2023,1.79846
2023-03-31,31.03.2023,1.79846
2023-04-03,03.04.2023,1.79929
2023-05-01,01.05.2023,1.7811
2023-06-12,12.06.2023,1.81684
2023-07-05,05.07.2023,1.7978
2023-08-01,01.08.2023,1.78289

Капани при обработката на данните

НАП работи с десетични точки, не десетични запетаи. Внимавайте във формата на числата.

Не забрайвяте във формулата за преизчисляване да сложите закръгляване до втория знак след десетичната точка - например =ROUND(A3*C3,2).

Подробно как трябва да се обработят данните за данъчната декларация:

• Отговори на въпроси за данъците и попълване на годишната данъчна декларация при инвестиции на финансовите пазари

За дивидентите и лихвите сравнително лесно може да се автоматизира целия процес (ако справките не са в някой неподходящ за машинна обработка PDF формат като на TastyTrade). Но за капиталовата печалба има усложнения с данъчните лотове и определяне коя продажба трябва да се включи в изчисленията и коя не трябва (липват данни в справките за това дали сделката е минала на регулиран пазар или не, трябва да се вадят данни и от сайта на ESMA за да се провери на кой сегмент от борсата е минала сделката и дали този сегмент е вписан като regulated market или не). Има усложнения с данъчните лотове и при данните за притежавани акции и дялове към 31 декември.

В справките на Degiro има данни за MIC кода на сегмента, през който е минала сделката. Такива данни няма в спраквите на Interactive Brokers. Освен това в справките от Interactive Brokers идентификаторите на борсите не са стандартни MIC кодове и се налага да се проверява в сайта на Interactive Brokers кой идентификатор на коя борса съответства. Правете разлика между MIC код на борса и MIC код на сегмент на борса.

Електронна таблица за изчисляване на доход в друга валута

Електронната таблица currency_conversion_calculator.ods работи с LibreOffice (тествах я с LibreOffice 24.8.3.2).

Предназначена е за прости изчисления (напр. доходи от лихви).

(За доходи от дивиденти смятам да направя отделна таблица, която да генерира директно csv за nap-autopilot. За доходи с код 508 не се сещам как може да се направи универсална таблица, само ако се продава един данъчен лот може да се ползва универсална таблица. Защото определянето на цена на придобиване е сложно когато се продава от повече от един данъчен лот и няма как изчисленията да станат на един ред за една продажба.)

Потребителят въвежда датата в желания от него формат (ползва се функцията на електронната таблица за форматиране на дата), трибуквения код на валутата (USD, EUR, GBP и т.н.) и сумата в тази валута. Таблицата автоматично взима правилния валутен курс и изчислява общата сума на дохода в лева.

След като потребителят въведе данните (преди да пусне макроса) трябва да изключи защитата от Tools -> Protect sheet.

Желателно е да изключвате защитата само след като сте приключили с въвеждането на данните (за да не се объркате да въведете данни там, където те ще се изгубят при пускане на макроса) и да я пускате след като макросът приключи.

Макросът се пуска от Tools -> Macros -> Run macro -> RUN_ME -> Run.

Ако не виждате RUN_ME (след като изберете Run macro от Library) отворете падащото меню от настоящия файл, отворете Standard и от него изберете Module 1.

След като приключи изпълнението на макроса ще излезе съобщение.

Във файла са вградени валутните курсове за няколко популярни валути. Може да добавите нова валута просто като добавите нов sheet със заглавие трибуквения код на валутата. Автоматичното изчисление няма да работи ако пропуснете да форматирате правилно колоните с датата и валутните курсове.