8. Exercício prático – versão 1
8.1. O problema
A tabela acima permite-nos calcular o imposto no caso simplificado de um contribuinte que apenas tem o seu salário a declarar. Conforme indicado na nota (1), o imposto calculado desta forma é o imposto antes de três mecanismos:
- o limite do quociente familiar, que se aplica a rendimentos elevados;
- o crédito fiscal e a redução fiscal que se aplicam aos rendimentos baixos;
Assim, o cálculo do imposto envolve os seguintes passos [http://impotsurlerevenu.org/comprendre-le-calcul-de-l-impot/1217-calcul-de-l-impot-2019.php]:

Propomos escrever um programa para calcular o imposto de um contribuinte no caso simplificado de um contribuinte que tenha apenas o seu salário a declarar:
8.1.1. Cálculo do imposto bruto
O imposto bruto pode ser calculado da seguinte forma:
Primeiro, calculamos o número de quotas do contribuinte:
- Cada progenitor contribui com 1 quota;
- os dois primeiros filhos contribuem cada um com 1/2 quota;
- os filhos subsequentes contribuem, cada um, com uma ação:
O número de quotas é, portanto:
- nbParts=1+nbChildren*0,5+(nbChildren-2)*0,5 se o funcionário for solteiro;
- nbParts=2+nbChildren*0,5+(nbChildren-2)*0,5 se for casado;
- onde nbChildren é o número de filhos;
- calculamos o rendimento tributável R = 0,9 * S, em que S é o salário anual;
- O quociente familiar QF é calculado como QF = R / nbParts;
- Calculamos o imposto bruto I com base nos seguintes dados (2019):
9964 | 0 | 0 |
27 519 | 0,14 | 1.394,96 |
73.779 | 0,3 | 5.798 |
156 244 | 0,4 | 13 913,69 |
0 | 0,45 | 20163,45 |
Cada linha tem 3 campos: campo1, campo2, campo3. Para calcular o imposto I, procuramos a primeira linha em que QF <= campo1 e retiramos os valores dessa linha. Por exemplo, para um funcionário casado com dois filhos e um salário anual S de 50 000 euros:
Rendimento tributável: R=0,9*S=45 000
Número de quotas: nbParts=2+2*0,5=3
Quociente familiar: QF = 45 000 / 3 = 15 000
A primeira linha em que QF <= campo1 é a seguinte:
O Imposto I é então igual a 0,14*R – 1394,96*númeroDeAções=[0,14*45000-1394,96*3]=2115. O imposto é arredondado por defeito para o euro mais próximo.
Se a condição QF <= campo1 for verdadeira na primeira linha, então o imposto é zero.
Se QF for tal que a condição QF <= campo1 nunca seja satisfeita, então são utilizados os coeficientes da última linha. Aqui:
o que dá o imposto bruto I = 0,45*R – 20163,45*nbParts.
8.1.2. Limite do Quociente Familiar
Para determinar se o limite do quociente familiar (QF) se aplica, recalculamos o imposto bruto sem os filhos. Mais uma vez, para o trabalhador casado com dois filhos e um salário anual S de 50 000 euros:
Rendimento tributável: R = 0,9 * S = 45 000
Número de quotas: nbParts=2 (os filhos já não são contabilizados)
Quociente familiar: QF = 45 000 / 2 = 22 500
A primeira linha em que QF <= campo1 é a seguinte:
O Imposto I é, então, igual a 0,14*R – 1394,96*número de ações = [0,14*45 000 – 1394,96*2] = 3510.
Benefício máximo relacionado com filhos: 1551 * 2 = 3102 euros
Imposto mínimo: 3.510 – 3.102 = 408 euros
O imposto bruto com 3 escalões de imposto, já calculado em 2.115 euros, é superior ao imposto mínimo de 408 euros, pelo que o limite familiar não se aplica neste caso.
De um modo geral, o imposto bruto é superior a (imposto1, imposto2), em que:
- [imposto1]: é o imposto bruto calculado incluindo os filhos;
- [imposto2]: é o imposto bruto calculado sem filhos e reduzido pelo crédito máximo (aqui 1.551 euros por meia quota) relativo aos filhos;
8.1.3. Cálculo da redução

Continuando com o exemplo de um trabalhador casado com dois filhos e um salário anual S de 50 000 euros:
O imposto bruto (2.115) da etapa anterior é inferior a 2.627 euros para um casal (1.595 euros para uma pessoa solteira): a redução aplica-se, portanto. É calculada da seguinte forma:
desconto = limiar (casal = 1.970 / solteiro = 1.196) - 0,75 * imposto bruto
desconto = 1.970 – 0,75 * 2.115 = 383,75, arredondado para 384 euros.
Novo imposto bruto = 2.115 – 384 = 1.731 euros
8.1.4. Cálculo da redução fiscal

Abaixo de um determinado limiar, é aplicada uma redução de 20% ao imposto bruto resultante dos cálculos anteriores. Em 2019, os limiares são os seguintes:
- Solteiro: 21 037 euros;
- casal: 42 074 euros; (o valor de 37 968 utilizado no exemplo acima parece estar incorreto);
Este limiar é aumentado pelo valor: 3.797 * (número de meias-partes contribuídas pelos filhos).
Mais uma vez, para o trabalhador casado com dois filhos e um salário anual S de 50 000 euros:
- o seu rendimento tributável (45 000 euros) é inferior ao limiar (42 074 + 2 × 3 797) = 49 668 euros;
- tem, portanto, direito a uma redução de 20% no seu imposto: 1.731 * 0,2 = 346,2 euros, arredondado para 347 euros;
- o imposto bruto do contribuinte passa a ser: 1.731 – 347 = 1.384 euros;
8.1.5. Cálculo do imposto líquido
O nosso cálculo termina aqui: o imposto líquido a pagar será de 1 384 euros. Na realidade, o contribuinte poderá ter direito a outras deduções, nomeadamente por doações a organizações de interesse público ou geral.
8.1.6. Casos de rendimentos elevados
O nosso exemplo anterior aplica-se à maioria dos trabalhadores. No entanto, o cálculo do imposto difere para quem aufere rendimentos elevados.
8.1.6.1. Limite à redução de 10% sobre o rendimento anual
Na maioria dos casos, o rendimento tributável é calculado utilizando a fórmula: R = 0,9 × S, em que S é o salário anual. Isto é conhecido como a redução de 10%. Esta redução está limitada. Em 2019:
- não pode exceder 12 502 euros;
- não pode ser inferior a 437 euros;
Consideremos o caso de um trabalhador solteiro, sem filhos e com um salário anual de 200 000 euros:
- a redução de 10% é de 200 000 euros > 12 502 euros. Por conseguinte, o limite máximo é de 12 502 euros;
8.1.6.2. Limite do Quociente Familiar
Vamos considerar um caso em que se aplica o limite familiar descrito na secção |Limite do Quociente Familiar|. Tomemos o caso de um casal com três filhos e um rendimento anual de 100 000 euros. Vamos rever os passos do cálculo:
- a dedução de 10% é de 10 000 euros < 12 502 euros. O rendimento tributável R é, portanto, 100 000 - 10 000 = 90 000 euros;
- o casal tem nbParts = 2 + 0,5 × 2 + 1 = 4 quotas;
- o seu quociente familiar é, portanto, QF = R / nbParts = 90 000 / 4 = 22 500 euros;
- o seu imposto bruto I1 com filhos é I1 = 0,14 × 90 000 – 1 394,96 × 4 = 7 020 euros;
- o seu imposto bruto I2 sem filhos:
- QF = 90 000 / 2 = 45 000 euros;
- I2 = 0,3 × 90 000 – 5 798 × 2 = 15 404 euros;
- a regra do limite do quociente familiar estabelece que o benefício proporcionado pelos filhos não pode exceder (1.551 × 4 meias quotas) = 6.204 euros. No entanto, neste caso, é I2 – I1 = 15.404 – 7.020 = 8.384 euros, o que é superior a 6.204 euros;
- o imposto bruto é, portanto, recalculado como I3 = I2 - 6.204 = 15.404 - 6.204 = 9.200 euros;
Este casal não receberá nem crédito fiscal nem redução, e o seu imposto final será de 9 200 euros.
8.1.7. Dados oficiais
O cálculo dos impostos é complexo. Ao longo deste documento, os cálculos basear-se-ão nos seguintes exemplos. Os resultados provêm do simulador da administração fiscal |https://www3.impots.gouv.fr/simulateur/calcul_impot/2019/simplifie/index.htm|:
Contribuinte | Resultados oficiais | Resultados do algoritmo do documento |
Casal com 2 filhos e um rendimento anual de 55 555 euros | Imposto = 2.815 euros Taxa de imposto = 14% | Imposto = 2.814 euros Taxa de imposto = 14% |
Casal com 2 filhos e um rendimento anual de 50 000 euros ( ) | Imposto = 1 385 euros Crédito fiscal = 720 euros Redução = 0 euros Taxa de imposto = 14% | Imposto = 1.384 euros Desconto = 384 euros Crédito = 347 euros Taxa de imposto = 14% |
Casal com 3 filhos e um rendimento anual de 50 000 euros | Imposto = 0 euros Crédito fiscal = 384 euros Redução = 346 euros Taxa de imposto = 14% | Imposto = 0 euros Desconto = 720 euros Dedução = 0 euros Taxa de imposto = 14% |
Solteiro com 2 filhos e um rendimento anual de 100 000 euros | Imposto = 19 884 euros Crédito fiscal = 0 euros Dedução = 0 euros Taxa de imposto = 41% | Imposto = 19 884 euros Sobretaxa = 4.480 euros Desconto = 0 euros Redução = 0 euros Taxa de imposto = 41% |
Solteiro com 3 filhos e um rendimento anual de 100 000 euros | Imposto = 16 782 euros Crédito fiscal = 0 euros Dedução = 0 euros Taxa de imposto = 41% | Imposto = 16 782 euros Sobretaxa = 7.176 euros Desconto = 0 euros Redução = 0 euros Taxa de imposto = 41% |
Casal com 3 filhos e um rendimento anual de 100 000 euros | Imposto = 9.200 euros Crédito fiscal = 0 euros Dedução = 0 euros Taxa de imposto = 30% | Imposto = 9.200 euros Sobretaxa = 2.180 euros Desconto = 0 euros Redução = 0 euros Taxa de imposto = 30% |
Casal com 5 filhos e um rendimento anual de 100 000 euros | Imposto = 4.230 euros Crédito fiscal = 0 euros Dedução = 0 euros Taxa de imposto = 14% | Imposto = 4.230 € Desconto = 0 euros Dedução = 0 euros Taxa de imposto = 14% |
Solteiro, sem filhos e rendimento anual de 100 000 euros | Imposto = 22.986 euros Crédito fiscal = 0 euros Dedução = 0 euros Taxa de imposto = 41% | Imposto = 22 986 euros Sobretaxa = 0 euros Desconto = 0 euros Redução = 0 euros Taxa de imposto = 41% |
Casal com 2 filhos e um rendimento anual de 30 000 euros | Imposto = 0 euros Crédito fiscal = 0 euros Dedução = 0 euros Taxa de imposto = 0% | Imposto = 0 euros Desconto = 0 euros Redução = 0 euros Taxa de imposto = 0% |
Solteiro, sem filhos e com um rendimento anual de 200 000 euros | Imposto = 64 211 euros Crédito fiscal = 0 euros Dedução = 0 euros Taxa de imposto = 45% | Imposto = 64 210 euros Sobretaxa = 7.498 euros Desconto = 0 euros Redução = 0 euros Taxa de imposto = 45% |
Casal com 3 filhos e um rendimento anual de 200 000 euros | Imposto = 42 843 euros Crédito fiscal = 0 euros Dedução = 0 euros Taxa de imposto = 41% | Imposto = 42 842 euros Sobretaxa = 17 283 euros Desconto = 0 euros Redução = 0 euros Taxa de imposto = 41% |
No exemplo acima, a «sobretaxa» refere-se ao montante adicional pago pelos contribuintes com rendimentos elevados devido a dois fatores:
- o limite máximo de 10 % da dedução do rendimento anual;
- o limite máximo do abono de família;
Este indicador não pôde ser verificado porque o simulador da autoridade fiscal não o disponibiliza.
Podemos ver que o algoritmo do documento calcula sempre o montante correto do imposto, embora com uma margem de erro de 1 euro. Esta margem de erro resulta do arredondamento. Todos os montantes monetários são arredondados para o euro superior em alguns casos e para o euro inferior noutros. Como não estava familiarizado com as regras oficiais, os montantes monetários no algoritmo do documento foram arredondados:
- para o euro superior no caso de descontos e reduções;
- para baixo, para o euro mais próximo, no caso de sobretaxas e do imposto final;
Iremos desenvolver várias versões da aplicação de cálculo de impostos.
8.2. Versão 1

8.2.1. O script principal
Apresentamos um programa inicial onde:
- os dados necessários para calcular o imposto estão codificados no código como listas e constantes;
- os dados do contribuinte (casado, filhos, salário) estão armazenados num primeiro ficheiro de texto [taxpayersdata.txt];
- os resultados do cálculo do imposto (casado, filhos, salário, imposto) são armazenados num segundo ficheiro de texto [results.txt];
O script [v-01/main.py] é o seguinte:
Notas
- Linha 4: Utilizamos o módulo [impots.v01.modules.impôts_module_01]. Note-se que este caminho é relativo à raiz do projeto PyCharm;
- linha 10: o ficheiro [data/taxpayersdata.txt] tem o seguinte conteúdo:
Cada linha representa uma tupla de três elementos [casado/em união de facto ou não, número de filhos, salário anual em euros].
- Linha 12: o ficheiro onde serão colocados os resultados do cálculo de impostos para cada contribuinte do ficheiro [taxpayersdata.txt]. Terá o seguinte conteúdo:
- Linha 16: Recuperamos os dados dos contribuintes contidos em [taxpayersdata.txt]. Recuperamos uma lista de dicionários com as chaves [casado, filhos, salário], sendo que cada dicionário representa um contribuinte;
- linhas 17–25: O imposto para os contribuintes da lista [taxPayers] é calculado. É devolvida uma lista [results], em que cada elemento é, mais uma vez, um dicionário com as chaves [casado, filhos, salário, imposto, sobretaxa, desconto, redução, taxa];
- linha 27: a lista [results] é guardada no ficheiro [results.txt] no formato apresentado acima;
- linhas 28–32: Capturamos todas as exceções que possam ser lançadas pelo módulo [impots.v01.modules.impôts_module_01];
Vamos agora detalhar as três funções utilizadas pelo script [main]:
- [get_taxpayers_data]: para ler os dados dos contribuintes;
- [calcul_impôt]: para calcular os seus impostos;
- [record_results]: para guardar os resultados num ficheiro de texto;
Todas estas funções estão localizadas no módulo [impots.modules.impôts_module_01].
8.2.2. O módulo [impots.v01.shared.impôts_module_01]
As funções necessárias para o cálculo de impostos foram agrupadas no módulo [impots.v01.shared.impôts_module_01]:

- em [1]: definição das constantes de cálculo de impostos;
- em [2]: a lista de funções do módulo;
8.2.3. A função [get_taxpayers_data]
A função [get_taxpayers_data] é a seguinte:
Notas
- linha 7: [taxpayers_filename] é o nome do ficheiro a ser processado. A função devolve uma lista;
- linhas 18–24: o ciclo processa as linhas [married, children, salary] do ficheiro de texto;
- linha 20: os três elementos da linha são recuperados. Partimos do princípio de que a linha está sintaticamente correta, ou seja, que contém efetivamente os três elementos esperados;
- linha 22: é construído um dicionário com as chaves [married, children, salary], e este dicionário é adicionado à lista [taxPayers];
- linha 26: assim que o ficheiro tiver sido processado, a lista [taxPayers] é devolvida;
- Linhas 10–30: Note-se que não foi adicionada nenhuma cláusula [catch] ao bloco [try] na linha 10. A cláusula [catch] não é obrigatória. Na linha 27, foi adicionada uma cláusula [finally] para fechar o ficheiro de texto em todos os casos, ocorra ou não um erro;
- esta estrutura try/finally permite que uma potencial exceção escape (não há catch). Esta exceção propagar-se-á para o script principal [main], que irá parar e exibir a exceção (ver secção |O Script Principal|). Este mecanismo foi utilizado na maioria das funções do módulo;
8.2.4. A função [calcul_impôt]
A função [calcul_impôt] é a seguinte:
Notas
- linhas 6–8: escalões de imposto (ver secção |Cálculo do Imposto Bruto|);
- linhas 11–20: constantes para o cálculo do imposto;
- Note-se que os elementos inicializados nas linhas 5–20 serão globais para as funções que estamos prestes a descrever. São, portanto, conhecidos desde que a função que os utiliza não declare variáveis com os mesmos nomes;
- os valores nas linhas 5–20 mudam todos os anos. Aqui, são os valores de 2019;
- linha 25: a função [calculate_tax] recebe três parâmetros:
- [married]: sim/não, indica se o contribuinte é casado ou vive em união de facto;
- [children]: o número de filhos;
- [salary]: o seu salário anual em euros;
- linhas 31–33: cálculo do imposto tendo em conta os filhos;
- linhas 34–47: estas linhas implementam o limite máximo do quociente familiar (ver secção |Limite máximo do quociente familiar|);
- linhas 49–57: estas linhas calculam a taxa de imposto do contribuinte, bem como qualquer sobretaxa (ver secção |Casos de rendimentos elevados|);
- linhas 59–61: cálculo de qualquer crédito fiscal (ver secção |Cálculo do crédito fiscal|);
- linhas 62–64: cálculo de qualquer redução do imposto devido (ver secção |Cálculo da redução do imposto|);
O algoritmo é bastante complexo e não entraremos em mais detalhes do que os fornecidos nos comentários. O algoritmo implementa o método de cálculo do imposto conforme descrito na secção |O Problema|.
8.2.5. A função [calcul_tax_2]
A função [calcul_impôt] chama a seguinte função [calcul_impôt_2]:
Este algoritmo foi descrito na Secção 8.1.1.
8.2.6. A função [get_discount]
A função [get_discount] implementa o cálculo de qualquer desconto fiscal (secção |Cálculo do desconto|):
8.2.7. A função [get_reduction]
A função [get_reduction] implementa o cálculo de qualquer redução fiscal (secção |Cálculo da redução fiscal|):
8.2.8. A função [get_taxable_income]
A função [get_taxable_income] calcula o rendimento tributável com base no salário anual:
8.2.9. A função [record_results]
A função [record_results] guarda os resultados do cálculo do imposto num ficheiro de texto:
8.2.10. Os resultados
Como mencionado anteriormente, com o seguinte ficheiro de contribuintes [taxpayersdata.txt]:
O script [main.py] cria o seguinte ficheiro [results.txt]:
Estes resultados correspondem aos dados oficiais apresentados na secção |Dados Oficiais|.
Agora, vamos executar esta versão numa janela de console:
(venv) C:\Data\st-2020\dev\python\cours-2020\python3-flask-2020\impots\v01>python main.py
Traceback (most recent call last):
File "main.py", line 4, in <module>
from impots.v01.shared.impôts_module_01 import *
ModuleNotFoundError: No module named 'impots'
Encontramos um erro que já vimos antes: um em que um módulo não pode ser encontrado, neste caso o módulo [impots]. Lembre-se de que isto significa:
- o interpretador Python pesquisou os diretórios no Python Path um por um;
- em nenhum deles encontrou um diretório contendo um script [impots.py];
A versão [v02] irá fornecer uma solução para este problema.