simples-nacional
Cálculo do Simples Nacional a partir das tabelas legais. Sem dependências, tipado, e testado contra a lei em vez de contra si mesmo.
pip install simples-nacional-complexo
O pacote se instala como simples-nacional-complexo e se importa como simples_nacional. O sufixo existe porque simplesnacional no PyPI já pertence a outro projeto, de propósito diferente — e porque o nome diz a tese: a alíquota do Simples não conta a história toda.
Por que existe
A fórmula da alíquota efetiva é uma linha. O que dá errado está em volta dela: usar float para dinheiro, esquecer que o Fator R decide entre dois anexos com quase 10 pontos de diferença, tratar o RBT12 de uma empresa de três meses como se fosse anual, e assumir que a efetiva é a carga tributária total quando o setor recolhe ICMS-ST e IPI fora do DAS.
Esta biblioteca cuida dessas quatro coisas e recusa entrada ambígua em vez de arredondar em silêncio.
Uso
from decimal import Decimal
from simples_nacional import Anexo, aliquota_efetiva, das_devido
ap = aliquota_efetiva(Decimal("1200000"), Anexo.II)
ap.faixa.numero # 4
ap.aliquota_nominal # Decimal('11.20')
ap.aliquota_efetiva # Decimal('9.33')
das_devido(Decimal("100000"), ap) # Decimal('9330.00')
Fator R
Atividades do § 5º-I são tributadas pelo Anexo III quando a folha de doze meses representa 28% ou mais da receita, e pelo Anexo V abaixo disso. O limite é inclusivo no Anexo III.
from simples_nacional import anexo_por_fator_r, fator_r
fator_r(Decimal("28000"), Decimal("100000")) # Decimal('0.28')
anexo_por_fator_r(Decimal("28000"), Decimal("100000")) # Anexo.III
anexo_por_fator_r(Decimal("27999"), Decimal("100000")) # Anexo.V
Para uma empresa de serviços na faixa 3, isso é a diferença entre 13,5% e 19,5% nominais. Errar o Fator R custa mais que errar a fórmula.
Empresa com menos de treze meses
Não existe RBT12 real antes de doze meses fechados. O art. 18, § 2º manda proporcionalizar:
from simples_nacional import rbt12_proporcional
rbt12 = rbt12_proporcional(Decimal("90000"), meses_de_atividade=3) # Decimal('360000')
aliquota_efetiva(rbt12, Anexo.I).faixa.numero # 2
Quando o DAS não é a carga total
from simples_nacional import ressalvas_de
(r,) = ressalvas_de("bebidas_alcoolicas")
r.tributos_fora_do_das # ('ICMS-ST', 'IPI')
r.condicoes # produção própria no atacado, registro no MAPA, ...
r.fundamentos # ('LC 123/2006, art. 17, X, "c", ...', 'Resolução CGSN nº 140/2018, art. 12')
Uma microcervejaria no Anexo II com efetiva de 9% não tem carga de 9%: ICMS-ST e IPI são recolhidos fora do DAS. Modelar o negócio pela efetiva subestima o custo.
O degrau do sublimite
Atravessar R$ 3.600.000 reduz a alíquota efetiva do DAS. Em todos os cinco anexos:
| Anexo | No teto da 5ª faixa | Centavo seguinte |
|---|---|---|
| I | 11,875% | 8,500% |
| II | 12,325% | 10,000% |
| III | 17,510% | 15,000% |
| IV | 16,895% | 10,000% |
| V | 21,275% | 15,500% |
Não é erro de tabela. Acima do sublimite, ICMS e ISS deixam de ser recolhidos no DAS, então a alíquota da 6ª faixa cobre menos tributos que a da 5ª. A carga total não cai — ela se reparte, e o que sai do DAS passa a ser apurado fora.
Quem usa a efetiva como carga total conclui que faturar mais barateia o imposto. É por isso que Apuracao carrega icms_iss_fora_do_das: a queda vem sempre acompanhada da bandeira que a explica.
tests/test_aliquota.py fixa esse degrau como propriedade esperada, para que ninguém o "conserte" achando que é bug.
Sinalizações
Apuracao marca as duas fronteiras que mudam o regime, em vez de deixar passar:
| Campo | Significado |
|---|---|
icms_iss_fora_do_das |
RBT12 acima de R$ 3.600.000: ICMS e ISS saem do DAS |
acima_do_limite |
RBT12 acima de R$ 4.800.000: a empresa está fora do Simples |
Decimal, não float
Passar float levanta TypeError. Isso é deliberado:
aliquota_efetiva(180000.0, Anexo.II)
# TypeError: rbt12 recebeu float, que não representa dinheiro exatamente.
Aceite Decimal, int ou str.
O que não faz
- Repartição por tributo. Os anexos quebram o DAS em IRPJ, CSLL, PIS, COFINS, CPP, ICMS e ISS. Não está aqui ainda, porque são 210 percentuais e publicar tabela fiscal meio conferida é pior que não publicar. Planejado para a 0.2.
- Enquadramento de atividade. Descobrir o anexo de um CNAE é decisão contábil, não aritmética.
- Sublimite estadual. Alguns estados adotam sublimite próprio; aqui só o federal de R$ 3,6 mi.
Fonte das tabelas
Anexos I a V da LC 123/2006, na redação da LC 155/2016, vigente desde 01/01/2018. As tabelas estão em tabelas.py como transcrição da lei, e tests/test_tabelas.py as compara com uma segunda transcrição independente — se divergirem, o teste quebra.
Não é assessoria fiscal
Calcula o que a lei publica. Enquadramento, regime, obrigações acessórias e planejamento são decisões de contador.
Licença
MIT
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file simples_nacional_complexo-0.1.0.tar.gz.
File metadata
- Download URL: simples_nacional_complexo-0.1.0.tar.gz
- Upload date:
- Size: 13.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5bdeeddb47a29c3c751e47af8b01aa5f54172f53836b4a6618aff56d1e881658
|
|
| MD5 |
17a259def2473d2cedb0cf313025015e
|
|
| BLAKE2b-256 |
0e6e6050f6dcbc6c394a38792b75ec07752970c3d7967e5cb6129a1a0770caa0
|
Provenance
The following attestation bundles were made for simples_nacional_complexo-0.1.0.tar.gz:
Publisher:
release.yml on vitorantoniazzi/simples-nacional
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
simples_nacional_complexo-0.1.0.tar.gz -
Subject digest:
5bdeeddb47a29c3c751e47af8b01aa5f54172f53836b4a6618aff56d1e881658 - Sigstore transparency entry: 2690956685
- Sigstore integration time:
-
Permalink:
vitorantoniazzi/simples-nacional@fb539c57ae0cd909c346f55443678fb595e44b82 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/vitorantoniazzi
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@fb539c57ae0cd909c346f55443678fb595e44b82 -
Trigger Event:
release
-
Statement type:
File details
Details for the file simples_nacional_complexo-0.1.0-py3-none-any.whl.
File metadata
- Download URL: simples_nacional_complexo-0.1.0-py3-none-any.whl
- Upload date:
- Size: 11.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ebd7ee76aaede793fa73a1ddb7800727cf1ca1831a375abcaf8359e020dd7c01
|
|
| MD5 |
2b978c2189e4b2c705af31605b8d1457
|
|
| BLAKE2b-256 |
6e66a12efd914eca9c9b2d2e88530d75ac287229d03be59a7245523590b2135e
|
Provenance
The following attestation bundles were made for simples_nacional_complexo-0.1.0-py3-none-any.whl:
Publisher:
release.yml on vitorantoniazzi/simples-nacional
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
simples_nacional_complexo-0.1.0-py3-none-any.whl -
Subject digest:
ebd7ee76aaede793fa73a1ddb7800727cf1ca1831a375abcaf8359e020dd7c01 - Sigstore transparency entry: 2690957100
- Sigstore integration time:
-
Permalink:
vitorantoniazzi/simples-nacional@fb539c57ae0cd909c346f55443678fb595e44b82 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/vitorantoniazzi
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@fb539c57ae0cd909c346f55443678fb595e44b82 -
Trigger Event:
release
-
Statement type: