Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vladimir-aubrecht/statementparser

Idea behind the StatementParser is, that it would be nice to be able to process financial data from different kind of statements in automatized way. This is often pretty hard as brokers are giving these data only in form of xls/xlst/pdf or other format which is not directly processable and here comes StatmentParser.
https://github.com/vladimir-aubrecht/statementparser

broker czechia parsing taxes

Last synced: 4 months ago
JSON representation

Idea behind the StatementParser is, that it would be nice to be able to process financial data from different kind of statements in automatized way. This is often pretty hard as brokers are giving these data only in form of xls/xlst/pdf or other format which is not directly processable and here comes StatmentParser.

Awesome Lists containing this project

README

        

# StatementParser ![.NET Core](https://github.com/vladimir-aubrecht/StatementParser/workflows/.NET/badge.svg)

Idea behind the StatementParser is, that it would be nice to be able to process financial data from different kind of statements in automatized way.
This is often pretty hard as brokers are giving these data only in form of xls/xlst/pdf or other format which is not directly processable and here comes StatmentParser.

StatementParser is taking statement file from your broker on the input and converting it into preffered format.

# Usages
There are two ways how you can use the project:
- As a .Net Core library you can include parsing within your project.
- As multiplatform utility, you can directly use it to convert statement into other format.

## Library
```csharp
string filePath = "";
var parser = new TransactionParser();
IList result = parser.Parse(filePath);

// Result can be null in case no internal parser was able to parse input file.
if (result != null)
{
// Do something
}
```

## Utility
Plain text conversion:

``dotnet StatementParserCLI.dll ``

JSON conversion:

``dotnet StatementParserCLI.dll -j ``

XSLX (Excel) conversion:

``dotnet StatementParserCLI.dll -x ``

# Guarantees
Use on your own risk.
Official guidance is, verify all generated numbers manually. Currently there are no known bugs.

# Supported output formats
- JSON
- Plain text
- XSLX

# Supported file formats for brokers

|Type / Broker |Fidelity|Morgan Stanley|MetaTrader|FxChoice|Degiro |Lynx|Interactive Broker|Revolut |
|---------------------|--------|--------------|----------|--------|------------|----|------------------|--------------------------------------|
|Sale transactions | - | - |Htm |Htm | - | - | - | PnL Statement Pdf |
|Dividend transactions|Pdf |Pdf, Xls | - | - |Csv in Czech|Activity Statement or Summary Csv|Activity Statement or Summary Csv| PnL Statement Pdf |
|ESPP transactions |Pdf | - | - | - | - | - | - | - |
|Deposit transactions |Pdf |Pdf, Xls | - | - | - | - | - | - |

## Examples of how parsable statements looks like

### Fidelity Statement
![Fidelity Statement][Fidelity]

### FXChoice Statement
![FXChoice Statement][FXChoice]

### MorganStanley Statement
![MorganStanley Statement][MorganStanley]

### Lynx Statement
![Lynx Report tool][LynxReportTool]
![Lynx Statement][Lynx]

### Revolut Statement
![Revolut Statement][Revolut]

[Fidelity]: docs/Images/FidelityStatement.png
[FXChoice]: docs/Images/FXChoiceStatement.png
[MorganStanley]: docs/Images/MorganStanleyStatement.png
[LynxReportTool]: docs/Images/LynxReportTool.png
[Lynx]: docs/Images/LynxStatement.png
[Revolut]: docs/Images/RevolutStatement.png