tributus-engine 0.2.0__py3-none-any.whl

tributus_engine/interfaces/protocols.py

@@ -0,0 +1,124 @@
+from typing import Protocol
+from decimal import Decimal
+
+class ICbs(Protocol):
+    def valor_base_ibs_cbs(self) -> Decimal: ...
+    def aliquota_efetiva(self) -> Decimal: ...
+    def diferimento(self) -> Decimal: ...
+    def valor_cbs(self) -> Decimal: ...
+
+class ICofins01_02(Protocol):
+    def base_cofins(self) -> Decimal: ...
+    def valor_cofins(self) -> Decimal: ...
+
+class ICofins03(Protocol):
+    def valor_cofins(self) -> Decimal: ...
+
+class IFcp(Protocol):
+    def valor_fcp(self) -> Decimal: ...
+
+class IFcpDif(Protocol):
+    def valor_fcp_diferido(self) -> Decimal: ...
+
+class IFcpEfet(Protocol):
+    def valor_fcp_efetivo(self) -> Decimal: ...
+
+class IFcpST(Protocol):
+    def valor_fcp_st(self) -> Decimal: ...
+
+class IIbsUf(Protocol):
+    def valor_base_ibs_cbs(self) -> Decimal: ...
+    def aliquota_efetiva(self) -> Decimal: ...
+    def diferimento(self) -> Decimal: ...
+    def valor_ibs_uf(self) -> Decimal: ...
+
+class IIcms00(Protocol):
+    def base_icms_proprio(self) -> Decimal: ...
+    def valor_icms_proprio(self) -> Decimal: ...
+
+class IIcms10(Protocol):
+    def base_icms_proprio(self) -> Decimal: ...
+    def valor_icms_proprio(self) -> Decimal: ...
+    def base_icms_st(self) -> Decimal: ...
+    def valor_icms_st(self) -> Decimal: ...
+    def valor_icms_st_desonerado(self) -> Decimal: ...
+
+class IIcms101(Protocol):
+    def calcular_base_icms_proprio(self) -> Decimal: ...
+    def valor_credito_sn(self) -> Decimal: ...
+
+class IIcms20(Protocol):
+    def base_reduzida_icms_proprio(self) -> Decimal: ...
+    def valor_icms_proprio(self) -> Decimal: ...
+    def valor_icms_desonerado(self) -> Decimal: ...
+
+class IIcms201(Protocol):
+    def calcular_base_icms_proprio(self) -> Decimal: ...
+    def valor_icms_proprio(self) -> Decimal: ...
+    def valor_credito_sn(self) -> Decimal: ...
+    def base_icms_st(self) -> Decimal: ...
+    def valor_icms_st(self) -> Decimal: ...
+
+class IIcms202_203(Protocol):
+    def calcular_base_icms_proprio(self) -> Decimal: ...
+    def valor_icms_proprio(self) -> Decimal: ...
+    def base_icms_st(self) -> Decimal: ...
+    def valor_icms_st(self) -> Decimal: ...
+
+class IIcms30(Protocol):
+    def base_icms_proprio(self) -> Decimal: ...
+    def valor_icms_proprio(self) -> Decimal: ...
+    def base_icms_st(self) -> Decimal: ...
+    def valor_icms_st(self) -> Decimal: ...
+    def valor_icms_desonerado(self) -> Decimal: ...
+
+class IIcms51(Protocol):
+    def base_icms_proprio(self) -> Decimal: ...
+    def valor_icms_operacao(self) -> Decimal: ...
+    def valor_icms_diferido(self) -> Decimal: ...
+    def valor_icms_proprio(self) -> Decimal: ...
+
+class IIcms70(Protocol):
+    def base_icms_proprio(self) -> Decimal: ...
+    def valor_icms_proprio(self) -> Decimal: ...
+    def valor_icms_proprio_desonerado(self) -> Decimal: ...
+    def base_icms_st(self) -> Decimal: ...
+    def valor_icms_st(self) -> Decimal: ...
+    def valor_icms_st_desonerado(self) -> Decimal: ...
+
+class IIcms90(Protocol):
+    def calcular_base_icms_proprio(self) -> Decimal: ...
+    def calcular_base_reduzida_icms_proprio(self) -> Decimal: ...
+    def valor_icms_proprio(self) -> Decimal: ...
+    def valor_icms_proprio_base_reduzida(self) -> Decimal: ...
+    def valor_icms_proprio_desonerado(self) -> Decimal: ...
+    def calcular_base_icms_st(self) -> Decimal: ...
+    def calcular_base_reduzida_icms_st(self) -> Decimal: ...
+    def valor_icms_st(self) -> Decimal: ...
+    def valor_icms_st_base_reduzida(self) -> Decimal: ...
+    def valor_icms_st_desonerado(self) -> Decimal: ...
+
+class IIcms900(Protocol):
+    def calcular_base_icms_proprio(self) -> Decimal: ...
+    def calcular_base_reduzida_icms_proprio(self) -> Decimal: ...
+    def valor_icms_proprio(self) -> Decimal: ...
+    def valor_credito_sn(self) -> Decimal: ...
+    def valor_icms_proprio_base_reduzida(self) -> Decimal: ...
+    def calcular_base_icms_st(self) -> Decimal: ...
+    def calcular_base_reduzida_icms_st(self) -> Decimal: ...
+    def valor_icms_st(self) -> Decimal: ...
+    def valor_icms_st_base_reduzida(self) -> Decimal: ...
+
+class IIpi50AdValorem(Protocol):
+    def calcular_base_ipi(self) -> Decimal: ...
+    def valor_ipi(self) -> Decimal: ...
+
+class IIpiEspecifico(Protocol):
+    def valor_ipi(self) -> Decimal: ...
+
+class IPis01_02(Protocol):
+    def base_pis(self) -> Decimal: ...
+    def valor_pis(self) -> Decimal: ...
+
+class IPis03(Protocol):
+    def valor_pis(self) -> Decimal: ...

tributus_engine-0.2.0.dist-info/METADATA

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: tributus-engine
+Version: 0.2.0
+Summary: Tributus Engine - Brazilian Tax Engine and Calculator Library
+Author-email: Mackilem Van der Laan <mack.vdl@gmail.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pydantic>=2.13.4
+Requires-Dist: pytest>=9.0.3
+Requires-Dist: PyYAML>=6.0.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+
+# Tributus Engine (Pacote Python)
+
+Pacote Python da biblioteca Tributus Engine para calculo tributario brasileiro.
+
+## Instalacao
+
+```bash
+pip install .
+```
+
+## O que a biblioteca cobre
+
+- ICMS e CSTs principais
+- FCP e DIFAL
+- IPI
+- PIS e COFINS
+- IBS e CBS
+- Biblioteca de calculo tributario com metodo centralizado via payload JSON
+- Catalogo fiscal por NCM/CEST e UF
+
+## Casos de uso
+
+- Calculo fiscal em ERP
+- API REST de tributacao
+- Simulacao de impacto tributario por produto
+- Cenarios com aliquota manual para homologacao e testes
+
+## Uso Rapido
+
+### 1) Engine simplificada com payload dict
+
+```python
+from tributus_engine import TaxEngine
+
+engine = TaxEngine()
+
+payload = {
+    "operation": {
+        "operation_type": "sale",
+        "document_type": "nfe",
+        "operation_date": "2026-06-02",
+        "issuer_state": "SP",
+        "recipient_state": "RJ",
+        "issuer_country": "BR",
+        "recipient_country": "BR",
+        "consumer_final": True,
+        "taxpayer_icms": False,
+        "presence_indicator": "2"
+    },
+    "company": {
+        "tax_regime": "lucro_presumido",
+        "crt": "3",
+        "has_pis_credit": False,
+        "has_cofins_credit": False,
+        "suframa": False,
+        "taxpayer_icms": False,
+        "taxpayer_ibs": False
+    },
+    "customer": {
+        "state": "RJ",
+        "taxpayer_icms": False,
+        "consumer_final": True,
+        "suframa": False,
+        "taxpayer_ibs": False
+    },
+    "product": {
+        "ncm": "22030000",
+        "cest": "0300100",
+        "origin": "0",
+        "fiscal_category": "industrialized",
+        "import_content": 0.0,
+        "benefit_code": None,
+        "is_imported": False,
+        "has_st": True,
+        "has_monophase": False,
+        "is_fuel": False,
+        "is_medicine": False
+    },
+    "values": {
+        "quantity": "5",
+        "unit_price": "200.00",
+        "gross_value": "1000.00",
+        "discount_value": "100.00",
+        "freight_value": "50.00",
+        "insurance_value": "10.00",
+        "other_expenses": "20.00"
+    }
+}
+
+result = engine.calculate_from_dict(payload)
+print(result.to_dict())
+```
+
+### 2) Engine com taxas manuais (`taxes`)
+
+```python
+payload["taxes"] = {
+    "enabled": ["ipi", "icms", "fcp", "pis", "cofins", "ibs", "cbs"],
+    "rates": {
+        "icms": "17.00",
+        "pis": "1.20",
+        "cofins": "5.40",
+        "ibs": "16.00",
+        "cbs": "8.50"
+    },
+    "icms": {
+        "cst": "00",
+        "aliquota_icms_proprio": "17.00"
+    },
+    "ipi": {
+        "aliquota_ipi": "10.00"
+    },
+    "pis": {
+        "aliquota_pis": "1.20"
+    },
+    "cofins": {
+        "aliquota_cofins": "5.40"
+    }
+}
+
+result = engine.calculate_from_dict(payload)
+print(result.to_dict())
+```
+
+### 3) Estrutura de `taxes` suportada
+
+Campos principais aceitos no payload JSON:
+
+- `enabled`: lista dos tributos a calcular na sequencia centralizada.
+- `rates`: aliquotas simples por tributo quando nao houver configuracao mais especifica.
+- `ipi`: `aliquota_ipi` ou `mode: specific` + `aliquota_por_unidade`.
+- `icms`: `cst`, `aliquota_icms_proprio`, `aliquota_icms_st`, `mva`, `percentual_reducao`, `percentual_reducao_st`, `percentual_diferimento`, `percentual_credito_sn`, `include_ipi_in_base`.
+- `fcp`: `aliquota_fcp`, `aliquota_fcp_st`, `aliquota_diferimento_fcp`.
+- `pis`: `aliquota_pis` ou `mode: specific` + `aliquota_por_unidade`.
+- `cofins`: `aliquota_cofins` ou `mode: specific` + `aliquota_por_unidade`.
+- `ibs`: `aliquota_efetiva_percentual`, `percentual_diferimento`.
+- `cbs`: `aliquota_efetiva_percentual`, `percentual_diferimento`.
+
+O retorno consolidado expõe `taxes.{nome}.base`, `taxes.{nome}.rate`, `taxes.{nome}.amount` e `total`.
+
+### 4) Consulta de impostos/taxas por NCM/CEST para todas as UFs
+
+```python
+taxes_by_state = engine.list_taxes_for_sale_all_states_from_dict({
+    "product": {"ncm": "22030000", "cest": "0300100"}
+})
+
+print(taxes_by_state["SP"])
+print(taxes_by_state["RJ"])
+```
+
+## Modo de resolucao de taxas
+
+Prioridade da engine:
+
+1. `taxes` enviado no payload
+2. catalogo interno por NCM/CEST/UF
+3. fallback automatico do provider
+
+Na versao atual do metodo centralizado, o fluxo principal esperado e receber as incidencias e aliquotas no proprio JSON. Catalogo/provider continuam como extensoes futuras da superficie publica.
+
+## Desenvolvimento
+
+```bash
+python -m pip install -e .
+python -m pytest tests
+```

tributus_engine-0.2.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+tributus_engine/__init__.py,sha256=7AG7KRAJcGQ6ly19RBlLtP3o-Eu5jkxAvHUxA3xhwJk,130
+tributus_engine/engine.py,sha256=cLqUBG13YEwz03k9sFSc5wKcL2vpmlIRc3dH2A06E5Y,28679
+tributus_engine/implementations/__init__.py,sha256=j1-f7V9cr3JT_uTzySICsR8Zcrgk34lsRhBMJvff9o4,266
+tributus_engine/implementations/cofins.py,sha256=q_RXnZgc1PYssI8tak_NN6Mrq6kh0FLkWIIwJwsndt8,1758
+tributus_engine/implementations/ibs_cbs.py,sha256=no7aGE5HTxw67bWP8jcsGKSqhBKFuYqGaHtpG8vSz6M,3083
+tributus_engine/implementations/ipi.py,sha256=0QWmBnKOKFFxccNaVB4bRR1Z-Jy4eHaIs1j-PjSLxgY,1496
+tributus_engine/implementations/pis.py,sha256=_ajCtWLVVYU0dQt7vXkoPFeJkU_gi8u7BxIbQFIHhwk,1686
+tributus_engine/implementations/icms/__init__.py,sha256=V35Bz_uFYOzoXHhxUsdOkO30DKm6WEvUwvnawFUrbpk,386
+tributus_engine/implementations/icms/base.py,sha256=uVQer7Ki9OlUImh1Bi0OFrWr45_udwcEUkK4h5PTlwE,2770
+tributus_engine/implementations/icms/cst.py,sha256=V10pH4cugNkho9ZwTCI1_iedFFPBaHn9GHQp-tPXW8M,22253
+tributus_engine/implementations/icms/fcp.py,sha256=wSSFt_4at87iDZ8gQyhesvQgNo22Q1kApyKFgkB7U7g,1138
+tributus_engine/interfaces/__init__.py,sha256=6fB0mfefdy-QgOBYPveKa8MGuM7d0Ex45ISf8iGRUng,350
+tributus_engine/interfaces/protocols.py,sha256=6Jf9IER84HG_pY8Wnvn8IA9Xt_MbI1r1LyQNT1ensSI,4417
+tributus_engine-0.2.0.dist-info/METADATA,sha256=1KRgzkgQ0EJeAkzSKSUUOQ2Tzre7-mwqapjudXOUPmU,5054
+tributus_engine-0.2.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+tributus_engine-0.2.0.dist-info/top_level.txt,sha256=lelQoWyMaMvy-KscMO4rlmsLdc8mnEY2aD3aTN_kkyk,16
+tributus_engine-0.2.0.dist-info/RECORD,,

tributus_engine-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

tributus_engine-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+tributus_engine