As a Paraguay tax resident (having a Tax ID) you have to file VATs (form 211) once a month and sometimes even the summary of receipts (even if you never claimed any). This script files all necessary taxes for you (in case of VAT it files 0 guarani tax).
⚠️ ** Don't use the script if your VAT is not 0!
Feel free to support me if you find this helfpul. Thank you!
You need these two packages to parse json and html: jq
, xmllint
Install brew first if you haven't done so already.
Now install jq
:
brew install jq
xmllint
is installed by default on MacOS Ventura (and perhaps older).
Update repo and install the packages:
sudo apt update && sudo apt install jq libxml2-utils
Install the packages:
sudo dnf install jq libxml2
Go to a directory of your choice and clone the repo:
git clone https://github.com/stitch-05/file-taxes-paraguay.git && cd file-taxes-paraguay
Either fill in your login information (USERNAME
and PASSWORD
) in .env
or create .env.local
and add those parameters there.
./file-taxes.sh
It may take up to a minute for the script to finish because of random pauses between each request. Let it finish.
You can use cron to run the script automatically on the 2nd day of each month at 3am of your local time.
Open crontab for editing:
crontab -e
and add the following:
0 3 2 * * /home/<user>/<path to script/file-taxes.sh >/dev/null 2>&1
Receive a notification everytime the script fails or succeeds to file VAT.
To use Pushover as your notification service, create your pushover token and add the following to .env
or .env.local
:
NOTIFICATION_SERVICE="pushover"
PUSHOVER_TOKEN=<your pushover token>
PUSHOVER_USER=<your pushover user>
To use Signal as your notification service, install signal-cli (beyond the scope of this tutorial) and add the following to .env
or .env.local
:
NOTIFICATION_SERVICE="signal"
SIGNAL_NUMBER=<your signal phone number>
If you run into any issues with the script, please make the script more verbose by changing WGET_OUTPUT
in .env
to the following and running the script again:
WGET_OUTPUT="-O-"
The 2 most common issues are SSL issues related to the old server certificate and login captcha.
If wget
outputs an SSL error, you have several options of trying to fix it none of which can be covered in detail as they vary based on the OS version.
Your best bet is uncommenting the following line in .env
and running the script again:
WGET_FLAGS="--secure-protocol tlsv1"
If it doesn't help, you will have to play with the flag (google is your friend).
Other option is to lower your SSL security sesttings in /etc/ssl/openssl.cnf
which is NOT RECOMMENDED! Again, it depends on the version of your OS and openssl library.
You may be required to solve captcha. The script is currently unable of doing so but you can get around this issue by solving it in the browser first and running the script again. You will see a captcha related error in the console with the link to where you can solve it first.
If you see a "no pending actions" message then it most likely means there's no form to fill out. Keep the script running in a cron and it will fill out known tax forms as soon as they are available.
I spent a lot of time figuring out Paraguay's tax portal (kudos to Paraguay gov for making it fairly hard to automatize) and making it work.
If you find this script helpful, your Bitcoin or Monero donation is very much appreciated:
bc1qxwuj3rty9krmtaf6tvah6cktkaktfgx0jagtva
87D74aNPpJs6cfJJStv9yj7LYaAW4oJcQX1YqzpvaGokYd2dhMeYzhPNHBrBUdzKrvW9LyFkL2xVBTrhT9rpNocAAH1Z2Qt