Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/mkrcah/souhrnne-hlaseni

Generuj souhrnné hlášení VIES z faktur ve Fakturoidu pro OSVČ v ČR
https://github.com/mkrcah/souhrnne-hlaseni

fakturoid fakturoid-api jinja2

Last synced: 6 days ago
JSON representation

Generuj souhrnné hlášení VIES z faktur ve Fakturoidu pro OSVČ v ČR

Awesome Lists containing this project

README

        

# Souhrnné hlášení VIES z Fakturoid

Generate XML with "souhrne hlaseni" for a given month
based on invoices from [Fakturoid](https://www.fakturoid.cz/).

The Python script fetches invoices with [Fakturoid v2 API](https://fakturoid.docs.apiary.io)
and generates an XML report which can be [uploaded to
Ministry of Finance]( https://adisspr.mfcr.cz/dpr/adis/idpr_epo/epo2/uvod/vstup_expert.faces)

## Features
- summing up 2+ invoices for the same client
- generating lines for multiple clients
- proper numerical rounding of the line total
- exits if no invoices found

## NOT supported
- using supply code ("kod plneni") other than 3
- having more than 21 clients, leading to multipage report
- credit notes

### How to run

1. Clone the repo
2. Copy the YAML file and fill it with your details
3. Install & run the tool with:

```shell
$ pip3 install -r requirements.txt
$ export DPHSH_FAKTUROID_EMAIL=''
$ export DPHSH_FAKTUROID_SLUG=''
$ export DPHSH_FAKTUROID_API_KEY=''
$ python3 main.py --help
$ python3 main.py --year 2021 --month 3 --path-to-static-details=./my-static-data.yml > dphsh-2021-03.xml
```

## Example output

```xml






```

## Using with fzf

You can also run the script wrapped with [fzf](https://github.com/junegunn/fzf) to select the month:

```shell
$ ./run-with-fzf.sh
```