add "IRS jovem" source

Motivation

The tool often references links that were used to backup the logic. Some of them are articles, some are official Portuguese documents. I propose we create a manual with examples on how the tool performs calculations.

This is useful for multiple people:

• users of the tool that want to understand what's going on behind the scenes.
• code contributors that need to understand the business logic before contributing. This includes myself, since I often forget what's going on, and have to go over multiple articles again to get a full picture of what the tool is trying to achieve.
• anyone interested in understanding how taxes work for freelancers.

How

To stay on vue environment, I suggest we use vitepress, where the docs are actually just a bunch of markdown files and it's simple to integrate with an existing vue project. But I'm open to other suggestions.

Ideas on content

• go through multiple scenarios and show how the calculations are made. Use markdown extensions when necessary (like math)
• explain edge cases and the tool assumptions
• illustrate that with links to the tool - this depends on this issue to pass parameters through URL parameters

Congrats on the project! 👏🏻

There are 2 things missing tho if you want to make it even more complete:

• "Programa Regressar" (only 50% of your revenue counts for IRS, although it still counts 100% for SS)
• Portugal (continental), Azores, and Madeira have different IRS taxes which impact the simulation

Isn't the IRS exempt from payment under a certain yearly amount (mínimo de existência)?

E.g. for 2023 it was 10 640 € and for 2024 it's 11 480 €.

I can work on the project and make a pull request, though I want to be sure I'm making the right analysis.

Segundo a segurança social os trabalhadores independentes podem decidir contribuir entre -25% até +25% sem qualquer prejuízo.

Era interessante poder configurar isto no simulador.

Fonte:

No momento da declaração trimestral, os Trabalhadores Independentes, podem optar pela fixação de
um rendimento superior ou inferior até 25%, esta opção é efetuada em intervalos de 5% (5%, 10%,
15%, 20%, 25%) àquele que resultar dos valores declarados, sem prejuízo dos limites previstos [mínimo
de 20,00€ e máximo de 12xIAS (5.318,40€, valor em 2022), com exceção dos Trabalhadores
Independentes. que acumulam atividade profissional por conta de outrem e que contribuam pelo valor
do Rendimento Relevante Remanescente.

Excelente trabalho.

I would find it easier to start working on this codebase if it had a simple docker-compose.yaml.

The local setup would only be (assuming docker is already installed):

docker-compose up --build

Let me know if this is something interesting to you, and I can create a PR ;)

The score is pretty low - 59% 😭

https://freetools.seobility.net/en/seocheck/check?url=https%3A%2F%2Ffreelancept.fmacedo.com%2F&crawltype=1

Bug description

On certain page size, the numeric values get split over multiple lines, making it weird to read.

example:

Since we pass simluation parameters through the URL, We can also store this data in local storage, where the user can set a name for each of the scenarios. The user could then, on the same browser, load some previously saved simulation. Something like:

const simulation = {
    name: "rendimento liquido em 2023",
    parameters: {
         income: 50000,
         incomeFrequency: 'year',
         currentTaxRankYear: 2023,
         ...
    };
};

The result could be something like this (just a mockup, not a restrict UI design):

edit: this is ready for dev

When editing the expenses value, if you decrease to zero the IRS tax is properly computed.

However, manually setting it to zero with the keyboard will lead to an incorrect IRS tax.

There is this "Taxa adicional de solidariedade/Additional solidarity fee".
A rate of 2.5% applies to taxable income above 80.000 € and 5% above 250.000 €.

Source: Portal Finanças

PS.: The issue is far from critical, this is not a common case. In 2021 less than 20K people met this criteria, unfortunately. Público

Acabo de fazer a minha primeira declaração trimestral de SS e o cálculo final foi diferente do resultado desse app.
O cálculo da SS é bem simples:

Valor Bruto * 0.7 ( 70% para prestação de serviços) * 1 à 0.75 (0% - 25% de ajuste) * 0.214 (21.4% Taxa para trabalhadores independentes)

Não sei porque, mas o cálculo do app não coincide com este.

Thanks for this awesome tool!

The IRS tax table has been updated this year (2023).

You can check the official tax table here(page 153/154):
https://app.parlamento.pt/webutils/docs/doc.pdf?path=6148523063484d364c793968636d356c6443397a6158526c63793959566b786c5a79394562324e31625756756447397a5357357059326c6864476c32595338354e6a51304e474e6a4d7930305a4451794c5451784e6a59744f44526a4f43316b4d4441314d44566a4e7a59784d3259755a47396a&fich=96444cc3-4d42-4166-84c8-d00505c7613f.doc&Inline=true

I think it makes sense to update this, I could take care of it if we think this makes sense to update

if the person is adept of the RNH (20%) , and in the first year is Recibo Verde, theres no need for Seguridade social

Em relação as pessoas que teem de justificar 15% de despesas afetas a atividade, mesmo que uma pessoa só consiga justificar 5%, apenas a diferença que faltar justificar será acrescido ao rendimento tributável (https://www.montepio.org/ei/pessoal/impostos/regime-simplificado-como-funciona-a-justificacao-de-despesas/). Penso que seria interessante para o utilizador poder definir uma aproximação da percentagem de despesas afetas a atividade em vez de ser binário 😄

Ótimo trabalho! Aprendi bastante!

Add NHR variation depending on CAE/CIRS of the primary activity

Currently the tool can simulate multiple scenarios. It would be useful that those could be shared. I propose we add a way of passing those through URL parameters. For example:

https://freelancept.fmacedo.com?income=50000&incomeFrequency=year&currentTaxRankYear=2023&...

This would then fill the corresponding values in the store and therefore render the tool with this choices.

Please add the possibility to select the first two years with discounts. First year is 50% and second year is 25% (in IRS)

It would be nice to update the tax ranks to the 2024 table but maybe to have it so people can select which year they want to simulate.

What are your thoughts on this? (posting this here since there's not a discussions tab)

Bug description

TLDR: all SwitchButtons labels are "atteched" to the first SwitchButton.

There are 4 SwitchButtons, each one with its own label.
If you click on the first SwitchButton label text, that switch is toggled (as expected).
But if you toggle the 2nd, 3rd or 4th labels, only the first one gets toggled.

(This project is very well done. Congrats!)

Description

The value on "How much can you justify as professional related expenses?" Changes automatically if I modify the income.
I think it would be nicer to keep that value if it was manually changed by me.

Use case:

I want to fix that value (eg: to 0€) and experiment different scenarios with different income values.

Suggestion

If the expenses value is manually changed, do not change it automatically.
Also add a "reset" (⟲ | refresh) button right next to it, in order to go back to the current behavior.

Open to make changes

If you think this is a useful feature, I could try to implement and create a PR. but only if you think that is useful.

The project should have eslint and prettier, makes contributing easier and keeps everything safe and formatted equally for everyone

Add tests setup and some unit tests, so it's clear what each piece of functionality does for everyone. The most important part (more prone to errors) is the store getters and actions. Here are the docs:

https://pinia.vuejs.org/cookbook/testing.html

There is an error on Taxable income when How much can you justify as professional related expenses is zero.

Great Work. Thanks

The project must be updated to the latest version of Vite to avoid some peerDependency problems

• v3 -> v4
• v4 -> v5

I don't think there will be any major barriers to making these upgrades

Para trabalhadores independentes na categoria "outros prestadores de serviços" em vez dos tradicionais 75%, só 35% dos rendimentos é que são taxable, mudando drasticamente o resultado das simulações.

Podia ser útil ter ou um selector de actividade ou de coeficiente. Mais informação aqui:
https://www.centralgestcloud.com/blog/artigo/22/regime-simplificado-irs-o-que-e

Alguns trabalhadores independentes remote enquadram-se nesta categoria.

The taxable salary will depend on your expenses. You are not taking that into account. Only 75% of the income is taxable.

Thank you for this great simulator!

During the first year of activity, when the exemption of the SS payments is applied, shouldn't the specific deductions (e.g. 4 104.00€) be zero? Not sure but I have the impression that SS payments do not count towards these expenses.