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.
Quanto do meu DAS é ICMS?
from decimal import Decimal
from simples_nacional import Anexo, Tributo, aliquota_efetiva, das_devido, das_por_tributo
ap = aliquota_efetiva(Decimal("1200000"), Anexo.II)
das_devido(Decimal("100000"), ap) # Decimal('9325.00')
partes = das_por_tributo(Decimal("100000"), ap)
partes[Tributo.ICMS] # Decimal('2984.00')
partes[Tributo.CPP] # Decimal('3496.88')
partes[Tributo.PIS] + partes[Tributo.COFINS] # Decimal('1305.50')
Essa última soma é a que sai do DAS quando a receita é monofásica. Sem a repartição, só se pode dizer que algo sai; com ela, quanto.
Cada parcela é arredondada a centavos, então a soma pode divergir de das_devido em alguns centavos. O total a recolher é o de das_devido; as parcelas servem para atribuição e relatório.
Carga total, não alíquota
RBT12 de R$ 1 milhão, receita mensal de R$ 80 mil, folha de R$ 30 mil:
| Anexo | Alíquota do DAS | CPP por fora | Carga total |
|---|---|---|---|
| III | 12,44% | — | 12,44% |
| IV | 10,02% | R$ 6.300 | 17,90% |
from simples_nacional import comparar_anexos
for c in comparar_anexos(Decimal("1000000"), Decimal("80000"), folha=Decimal("30000")):
print(c.anexo.value, c.aliquota_efetiva_pct, c.cpp_fora_do_das, c.carga_total)
O Anexo IV parece 2,4 pontos mais barato que o III e é 5,5 pontos mais caro. A inversão é de 7,9 pontos, e some inteira de uma comparação feita por alíquota.
Quanto dá para recuperar
from simples_nacional import Anexo, Competencia, indebito_por_segregacao
meses = [
Competencia(2026, m, Decimal("900000"),
receita_sem_regime_especial=Decimal("20000"),
receita_monofasica_e_com_icms_st=Decimal("60000"))
for m in range(1, 13)
]
r = indebito_por_segregacao(meses, Anexo.I)
r.recuperavel # Decimal('28929.60')
r.prescrito # o que passou dos cinco anos
r.data_de_corte
Prazo do art. 168 do CTN, cinco anos contados do pagamento indevido. A contagem usa o vencimento do DAS como referência; quem pagou em atraso conta da data efetiva. Pedido administrativo não interrompe o prazo.
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.
A armadilha do Anexo IV
from simples_nacional import Anexo, aliquota_efetiva, carga_fora_do_das
rbt12 = Decimal("1000000")
aliquota_efetiva(rbt12, Anexo.III).aliquota_arredondada # Decimal('12.44')
aliquota_efetiva(rbt12, Anexo.IV).aliquota_arredondada # Decimal('10.02') parece melhor
carga_fora_do_das(Anexo.III) # ()
carga_fora_do_das(Anexo.IV) # (ItemForaDoDAS(tributo='CPP', efeito=ACRESCENTA, ...),)
O DAS do Anexo IV não abrange a contribuição patronal: são 20% sobre a folha, mais RAT de 1% a 3%, recolhidos à parte. Comparar anexos pela alíquota efetiva subestima a carga de quem tem folha.
Segregação de receitas: a direção depende da cadeia
from simples_nacional import PosicaoNaCadeia, carga_fora_do_das
# cervejaria: é ela quem recolhe o concentrado
carga_fora_do_das(
Anexo.II, receita_monofasica=True, receita_com_icms_st=True, posicao=PosicaoNaCadeia.PRODUTOR
)
# PIS/COFINS: ACRESCENTA · ICMS-ST: ACRESCENTA
# bar que revende a mesma cerveja: já foi tributada antes
carga_fora_do_das(
Anexo.I, receita_monofasica=True, receita_com_icms_st=True, posicao=PosicaoNaCadeia.REVENDEDOR
)
# PIS/COFINS: REDUZ · ICMS-ST: REDUZ
Mesmo produto, lados opostos da cadeia, efeitos opostos. Para quem revende, não segregar é pagar a mais — e o indébito é recuperável. É essa a razão de existir a indústria de recuperação de PIS/COFINS monofásico.
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
- 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 de faixa estão em tabelas.py e as de repartição em reparticao.py, ambas como transcrição da lei. Os testes as comparam com uma segunda transcrição independente — se divergirem, o teste quebra. A repartição tem ainda uma validação que erro de transcrição quase sempre dispara: os percentuais de cada faixa somam exatamente 100%.
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.4.0.tar.gz.
File metadata
- Download URL: simples_nacional_complexo-0.4.0.tar.gz
- Upload date:
- Size: 28.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 |
157ec6287d34a08a333b0faff727ce25aae0c7cb409f12280349ecfda3bcf9e9
|
|
| MD5 |
a86363181b6010c4f2ba555e44c5636c
|
|
| BLAKE2b-256 |
067a38a20875af8f02e7ebe1641d6b01ea1bf045abc5ed81f31784910b0cd41a
|
Provenance
The following attestation bundles were made for simples_nacional_complexo-0.4.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.4.0.tar.gz -
Subject digest:
157ec6287d34a08a333b0faff727ce25aae0c7cb409f12280349ecfda3bcf9e9 - Sigstore transparency entry: 2700221601
- Sigstore integration time:
-
Permalink:
vitorantoniazzi/simples-nacional@58e6c4f51d5c0f62d4c030111e0c45a7ae84c96b -
Branch / Tag:
refs/tags/v0.4.0 - Owner: https://github.com/vitorantoniazzi
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@58e6c4f51d5c0f62d4c030111e0c45a7ae84c96b -
Trigger Event:
release
-
Statement type:
File details
Details for the file simples_nacional_complexo-0.4.0-py3-none-any.whl.
File metadata
- Download URL: simples_nacional_complexo-0.4.0-py3-none-any.whl
- Upload date:
- Size: 23.5 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 |
9369b3ebc2614deee9413777ede28f87319c8c03c7bfa28503756663c874576f
|
|
| MD5 |
2f0ec49d5ec4bf4d2665ca888bcdf1a0
|
|
| BLAKE2b-256 |
dd398ce8ec4610d8a279ba5f69029fd3e0abbb15583e70bbdfd2f47c3a602102
|
Provenance
The following attestation bundles were made for simples_nacional_complexo-0.4.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.4.0-py3-none-any.whl -
Subject digest:
9369b3ebc2614deee9413777ede28f87319c8c03c7bfa28503756663c874576f - Sigstore transparency entry: 2700221789
- Sigstore integration time:
-
Permalink:
vitorantoniazzi/simples-nacional@58e6c4f51d5c0f62d4c030111e0c45a7ae84c96b -
Branch / Tag:
refs/tags/v0.4.0 - Owner: https://github.com/vitorantoniazzi
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@58e6c4f51d5c0f62d4c030111e0c45a7ae84c96b -
Trigger Event:
release
-
Statement type: