Automatically file taxes in Paraguay

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).

:warning: ** Don't use the script if your VAT is not 0!

The script also automatically updates your profile information which is usually requested once a year (in August).

Feel free to support me if you find this helfpul. Thank you!

1) Dependencies (choose one)

You need these two packages to parse json and html: jq, xmllint

1.1) Install on Mac

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).

1.2) Install on Debian based distros

Update repo and install the packages:

sudo apt update && sudo apt install jq libxml2-utils

1.3) Install on RedHat-based distros

Install the packages:

sudo dnf install jq libxml2

2) Basic Setup

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.

3) Run

./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.

4) Setup cron job (optional)

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

5) Receive Notifications (optional)

Receive a notification everytime the script fails or succeeds to file VAT.

5.1) Pushover

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>

5.2) Signal

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>

Common issues

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.

SSL

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.

Captcha

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.

No pending actions

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.

Support me

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, Monero or Litecoin donation is very much appreciated:

Donate Bitcoin

or

bc1qxwuj3rty9krmtaf6tvah6cktkaktfgx0jagtva

Donate Monero

87D74aNPpJs6cfJJStv9yj7LYaAW4oJcQX1YqzpvaGokYd2dhMeYzhPNHBrBUdzKrvW9LyFkL2xVBTrhT9rpNocAAH1Z2Qt

Donate Litecoin

ltc1qf0lferevscf4ag8vqck5n0nuvnnwdm0g6l9yfk

Thank you!