Документация по сервису 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).
Возможно, перед генерацией вкладка с сервисом была открыта достаточно давно (иногда до нескольких дней назад) и с тех не обновлялась. Это может привести к рассинхронизации серверного кода и кода, загруженного в браузер пользователя.
Проверьте в почте папку спам или раздел промоакции.