Документация по сервису FinParser

Здесь собраны все необходимые материалы для понимания и использования функционала FinParser, включая руководство пользователя, технические спецификации, примеры интеграции и ответы на часто задаваемые вопросы.

Часто задаваемые вопросы

В этом разделе вы найдете ответы на наиболее часто задаваемые вопросы о налогообложении инвестиций в России, включая описание правил, пошаговые инструкции и полезные советы для инвесторов.

До 50 операций на брокерском счете включительно считается Простой декларацией, цена 4000 руб. Все прочие 8000 руб.
В качестве операций учитываются получение дивидендов, купонов, процентов на остаток, а также совершение сделок, закрывающих позции. Так, закрытие длинных позиций продажей или коротких позиций покупкой считается сделкой, просто покупка длинных позиций – нет. Таким образом, расчет налогов для большинства индексных стратегий при пассивном инвестировании может быть оценен как “простая” декларация. Узнать учитываемое при расчете цены количество сделок можно и до оплаты. Достаточно просто зарегистрироваться и попробовать сгенерировать декларацию на основе вашего отчета. Вы получите расчетное количество сделок и стоимость для данного отчета.

Отчет о движении денежных средств оплачивается отдельно. Цена 1000 руб.

Во-первых, необходимо зарегистрироваться. Далее открываете главную страницу сервиса (finparser.com), в разделе Цены выбираете необходимое количество деклараций (простых или обычных в зависимости от количества сделок) и нажимаете на кнопку Оплатить.

Сервис предоставляет 3 вида форматов на основе файла отчета брокера (формат CSV):
• Excel – пояснительная записка с описанием расчетов.
• XML – файл электронной налоговой декларации, которую можно непосредственно загрузить на сайт nalog.ru
• DCX – файл для программы Декларация , (где Х – последняя цифра года, за коррый подается декларация, так файл декларации за 2020 год имеет расширение DCO, за 2019-й – DC9, за 2018 – DC8 и т.д.) с помощью которой можно ввести другие расходы и доходы, полученные вне брокерского счета, затем уже сгенерировать XML файл электронной налоговой декларации и уже его подать на nalog.ru
Алгоритм действий может быть следующим:
1. Получить отчет брокера (описание процедуры приведено в справочном руководстве).
2. Сгенерировать файл DCO через finparser.
3. Открыть его в программе Декларация.
4. Убедиться, что там есть сделки.
5. Дополнить своими данными (налоговые вычеты, прочие доходы, полученные вне брокерского счета и т.д.)
6. Нажать Декларация/экспорт в XML.
7. Полученный XML файл вместе с отчетом брокера в формате PDF (выгружается отдельно) и другими документами, подтверждающими доходы и расходы, загрузить на nalog.ru.

Interactive Brokers выгружает данные о дате и сумме открытия позиций, если позиция была частично или полностью закрыта в выгружаемом периоде, даже если она была открыта в предыдущие годы (поэтому не нужно прикладывать отчеты за все годы покупки).
Freedom Finance – информация об открытых позициях в отчете не содержит даты открытия позиции и размеров лотов. Это делает невозможным построение налоговой декларации на основе отчета за один налоговый год. Закрываемые в каждой конкретной сделке лоты могут быть получены только на основе анализа истории сделок. Таким образом, для расчета налоговой декларации для Freedom Finance, требуется информация за всю историю торгов, начиная с момента открытия счета (подробнее).

Для генерации налоговой декларации выбор диапазона дат будет зависеть от того будете ли вы включать опцию (T+) при расчете налогов (по умолчанию она включена). Если вы выбираете опцию (T+), то сделки по акциям, совершенные 30 декабря года, предыдущего отчетному, будут засчитаны 1 января отчетного года, а 31 декабря – 2 января. В свою очередь, сделки с ПФИ 31 декабря отчетного года попадут в следующий год.
Кроме того, следует иметь в виду, что дивиденды учитываются день в день, независимо от выбора настройки (Т+).

Таким образом для опции (T+) и для отчетного года, например, 2020, даты должны быть 30.12.2019 – 31.12.2020 включительно.

Для выключенной опции (Т+) и для отчетного года, например, 2020, даты должны быть 01.01.2020 – 31.12.2020 включительно.

В ряде случаев, именно эти даты выбрать невозможно, соответственно, необходимо выбирать ближайшие, охватывающие этот период. Если в итоге получается, что период превышает 365 дней (на сегодняйшний момент нельзя выгружать отчет на больший срок), то можно разбить на 2 отчета, чтобы при этом не было пересечения дат (например, первый отчет 30.12.2019 – 31.12.2019, затем второй 01.01.2020 – 31.12.2020). В этом
случае, в FinParser загружается 2 отчета.

Для генерации отчета о движении денежных средств в некоторых случаях может использоваться другой диапазон дат при выгрузке файлов.

Прежде всего, для каждого счета IB необходимо использовать только один файл отчета. Диапазон дат независимо от выбора опции (T+) должен быть в идеале, например, для 2020 налогового года 01.01.2020 – 31.12.2020. Если 01.01.2020 выбрать невозможно, то необходимо выбирать максимально близкую из доступных дат после этого числа, например 04.01.2020.

Если счет был открыт в год, за который подается налоговая декларация, в качестве начала периода необходимо выбрать самую раннюю из доступных для выбора дат.

В настоящий момент учитываются следующие виды сделок.

  • Для Interactive Brokers:
  • Дивиденды (выплаты по ETF) в том числе с учетом уже удержанных налогов
  • Закрытие длинных позиций
  • Закрытие коротких позиций
  • Сделки с опционами (в том числе с учетом экспирации)
  • Сделки с фьючерсами
  • Контракты на разницу (CFD)
  • Проценты на остаток
  • Купоны по облигациям
  • Комиссии брокера (за неактивность, подписку на рыночные данные и т.д.)
  • Варранты
  • Операции Forex
  • Корпоративные действия (выкупы, акции в качестве дивидендов, погашение облигаций)

Для Freedom Finance:

  • Дивиденды (выплаты по ETF) в том числе с учетом уже удержанных налогов
  • Закрытие длинных позиций
  • Закрытие коротких позиций
  • Сделки с ІРО
  • Купоны по облигациям

Список поддерживаемых в настоящий момент валют:

  • USD (Доллар США)
  • EUR (Евро)
  • GBP (Фунт стерлингов)
  • CHF (Швейцарский франк)
  • JPY (Иена)
  • RUB (Российский рубль)
  • DKK (Датская крона)
  • AUD (Австралийский доллар)
  • CAD (Канадский доллар)
  • HKD (Гонконгский доллар)
  • CZK (Чешская крона)
  • PLN (Польский злотый)
  • SEK (Шведская крона)
  • ZAR (Южноафриканский рэнд)
  • TRY (Турецкая лира)
  • SGD (Сингапурский доллар)
  • CNH (Китайский юань)
  • NOK (Норвежская крона)
  • NZD (Новозеландский доллар)
  • ILS (Новый израильский шекель)
  • MXN (Мексиканское песо)

Если в действительности вы совершали сделки, закрывающие позиции в течение отчетного периода, то это значит, что вы выгрузили отчет активностей (Activity report) вместо ожидаемого пользовательского отчета (Customer report). Данные отчеты по-разному представляют соверешнные сделки. Инструкция как получить ожидаемый формат приведена в соответствующем разделе справки → . К сожалению, вы не сможете теперь загрузить на сервис правильный отчет, т.к. оплата уже произошла для загруженного ранее отчета активностей.
Данная ситуация разрешается в частном порядке. Для этого напишите пожалуйста сообщение на почту поддержки support@finparser.com с указанием логина под которым вы зарегистрированы на finparser.com.

Если в отчете брокера, за декларируемый год содержится более 1000 расчетных сделок (сделок на закрытие позиций, дивидендов и т.д.), то при генерации файла для программы Декларация – формат DCX (например, для 2020 года это DCO), данная программа не сможет открыть полученный DCX файл и выдаст ошибку открытия файла “Неправильный формат файла декларации, возможно он поврежден” “. Это не ошибка записи в файл сервисом. Можно попробовать внести вручную 1001-ю сделку посредством самой программы Декларация и затем сохранить результат в DCX. При попытке его открытия возникнет та же самая ошибка.
Решение: использовать группировку сделок по дням. Все сделки по итогам каждого дня в году группируются в одну с указанием торгуемых инструментов. Таким образом, максимальное количество сделок с ценными бумагами не может превышать 365, аналогично с производными финансовыми инструментами.
Для этого необходимо установить переключатель “Сгруппировать по дням” в разделе “Дополнительные параметры расчета и комиссии” сервиса при генерации формата DCX.

Прежде всего, необходимо установить Wine.
Для Debian/Ubuntu:
sudo apt-get install wine
Для Fedora:
sudo dnf install wine
Для macOS:
brew cask install wine-stable
Вы можете скачать программу Декларация с официального сайта налоговой и установить ее, например, для 2020 года:
wine msiexec /i InsD2020.msi
Либо же, вы можете скачать уже распакованные заархивированные версии с данного сервиса:
• Декларация 2017
• Декларация 2018
• Декларация 2019
• Декларация 2020
Далее, необходимо разархивировать полученный архив, переключится в директорию с программой и выполнить команду (например, для декларации 2020):
LANG=ru_RU wine Decl2020.exe

Если после нажатии на кнопку “Сгенерировать отчеты” в ответ совсем ничего не происходит, ни ожидаемого результата, ни ошибки, то первое, что следует сделать – просто обновить окно браузера (по F5).
Возможно, перед генерацией вкладка с сервисом была открыта достаточно давно (иногда до нескольких дней назад) и с тех не обновлялась. Это может привести к рассинхронизации серверного кода и кода, загруженного в браузер пользователя.

Проверьте в почте папку спам или раздел промоакции.