Skip to main content

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

simples_nacional_complexo-0.4.0.tar.gz (28.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

simples_nacional_complexo-0.4.0-py3-none-any.whl (23.5 kB view details)

Uploaded Python 3

File details

Details for the file simples_nacional_complexo-0.4.0.tar.gz.

File metadata

File hashes

Hashes for simples_nacional_complexo-0.4.0.tar.gz
Algorithm Hash digest
SHA256 157ec6287d34a08a333b0faff727ce25aae0c7cb409f12280349ecfda3bcf9e9
MD5 a86363181b6010c4f2ba555e44c5636c
BLAKE2b-256 067a38a20875af8f02e7ebe1641d6b01ea1bf045abc5ed81f31784910b0cd41a

See more details on using hashes here.

Provenance

The following attestation bundles were made for simples_nacional_complexo-0.4.0.tar.gz:

Publisher: release.yml on vitorantoniazzi/simples-nacional

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file simples_nacional_complexo-0.4.0-py3-none-any.whl.

File metadata

File hashes

Hashes for simples_nacional_complexo-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9369b3ebc2614deee9413777ede28f87319c8c03c7bfa28503756663c874576f
MD5 2f0ec49d5ec4bf4d2665ca888bcdf1a0
BLAKE2b-256 dd398ce8ec4610d8a279ba5f69029fd3e0abbb15583e70bbdfd2f47c3a602102

See more details on using hashes here.

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

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 files

0.3.0

2 files

0.2.0

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page