PHPackages salvadorbba/tribcalc - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. salvadorbba/tribcalc ActiveLibrary[Utility & Helpers](/categories/utility) salvadorbba/tribcalc ==================== Biblioteca PHP para cálculos tributários brasileiros 1.0.5(1y ago)11931MITPHPPHP >=7.4 Since Jun 8Pushed 1y agoCompare [ Source](https://github.com/SALVADORBBA/tribcalc)[ Packagist](https://packagist.org/packages/salvadorbba/tribcalc)[ RSS](/packages/salvadorbba-tribcalc/feed)WikiDiscussions main Synced 3w ago READMEChangelogDependenciesVersions (7)Used By (0) TribCalc ======== [](#tribcalc) **TribCalc** é uma biblioteca PHP moderna desenvolvida para facilitar o **cálculo de tributos no Brasil**, como ICMS, ICMS-ST, DIFAL, FCP, IPI, IVA, e IBS, de forma prática e extensível. Ideal para desenvolvedores que precisam integrar regras fiscais em sistemas de ERP, emissão de NFe/NFCe, ou backends financeiros. 🚀 Instalação ------------ [](#-instalação) ### Via Composer [](#via-composer) ``` composer require salvadorbba/tribcalc:^1.0.2 ``` ### Uso no Adianti Framework [](#uso-no-adianti-framework) Para utilizar dentro de projetos Adianti, apenas adicione ao seu `composer.json` e chame a classe normalmente nos controles, formulários ou serviços REST. --- 💡 Como Usar ----------- [](#-como-usar) A biblioteca oferece duas classes principais: ### 📊 CalculadoraTributaria [](#-calculadoratributaria) #### ✅ 1. Usando o construtor diretamente [](#-1-usando-o-construtor-diretamente) ``` use TribCalc\CalculadoraTributaria; $calculadora = new CalculadoraTributaria( 1000.00, // valorProduto 'SP', // ufOrigem 'RJ', // ufDestino 0.00, // aliquotaRedBcIcms 30.00, // mvaAjustada 10.00, // aliquotaIpi 1.00, // aliquotaIbs 2.00, // aliquotaIva 2.00, // aliquotaFcp 100.00, // valorDesonerado 9, // motivoDesoneracao 3 // regime_tributario ); $resultados = $calculadora->exibirResultadosDetalhados(); ``` #### ✅ 2. Usando a factory `fromObject()` [](#-2-usando-a-factory-fromobject) ``` use TribCalc\CalculadoraTributaria; $dados = (object)[ 'valorProduto' => 1000.00, 'ufOrigem' => 'SP', 'ufDestino' => 'RJ', 'aliquotaRedBcIcms' => 0.00, 'mvaAjustada' => 30.00, 'aliquotaIpi' => 10.00, 'aliquotaIbs' => 1.00, 'aliquotaIva' => 2.00, 'aliquotaFcp' => 2.00, 'valorDesonerado' => 100.00, 'motivoDesoneracao' => 9, 'regime_tributario' => 3 ]; $calculadora = CalculadoraTributaria::fromObject($dados); $resultados = $calculadora->exibirResultadosDetalhados(); ``` ### 💰 RateioDocumentoFiscal [](#-rateiodocumentofiscal) Classe para calcular o rateio proporcional de valores (frete, seguro, desconto e outras despesas) entre itens. ``` use TribCalc\RateioDocumentoFiscal; // Criando array de itens (cada item deve ter valor_total) $itens = [ (object)['id' => 1, 'valor_total' => 200.00], (object)['id' => 2, 'valor_total' => 150.00], (object)['id' => 3, 'valor_total' => 150.00] ]; // Valores a serem rateados $valor_frete = 100.00; $valor_seguro = 50.00; $valor_desconto = 75.00; $valor_outras_despesas = 25.00; // Calculando o rateio $itens_rateados = RateioDocumentoFiscal::calcularRateio( $itens, $valor_frete, $valor_seguro, $valor_desconto, $valor_outras_despesas ); ``` --- 📌 Métodos Disponíveis --------------------- [](#-métodos-disponíveis) ### CalculadoraTributaria [](#calculadoratributaria) MétodoDescrição`exibirResultadosDetalhados()`Retorna todos os tributos calculados com base de cálculo, alíquotas e valores`exibirDadosObjeto()`Exibe dados de entrada e os resultados finais em formato JSON`calcularTributos()`Executa os cálculos e retorna os tributos calculados como objeto stdClass### RateioDocumentoFiscal [](#rateiodocumentofiscal) MétodoDescrição`calcularRateio()`Calcula o rateio proporcional de valores entre os itens--- 🔎 Códigos de Referência ----------------------- [](#-códigos-de-referência) ### Motivos de Desoneração (`motivoDesoneracao`) [](#motivos-de-desoneração-motivodesoneracao) CódigoDescrição1Táxi2Deficiente Físico3Produtor Agropecuário4Frotista/Locadora5Diplomático/Consular6Amazônia Ocidental7SUFRAMA8Venda a Órgãos Públicos9Outros### Regimes Tributários (`regime_tributario`) [](#regimes-tributários-regime_tributario) CódigoRegime Tributário1Simples Nacional2SN - Excesso Sublimite3Regime Normal4MEI--- 🤝 Contribuindo -------------- [](#-contribuindo) Quer contribuir com melhorias, novas fórmulas ou sugestões de otimização? Entre em contato com o mantenedor do projeto: 📧 **** --- 📄 Licença --------- [](#-licença) Este projeto está licenciado sob a licença MIT. Sinta-se livre para usar, modificar e distribuir conforme necessário. --- Desenvolvido com ❤️ para facilitar a vida de quem calcula tributos no Brasil. ### Health Score 30 — LowBetter than 62% of packages Maintenance48 Moderate activity, may be stable Popularity15 Limited adoption so far Community7 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 6 Last Release 381d ago PHP version history (2 changes)1.0.0PHP >=8.0 1.0.1PHP >=7.4 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/4417767?v=4)[Ajuda nunca foi tão fácil.](/maintainers/SALVADORBBA)[@SALVADORBBA](https://github.com/SALVADORBBA) --- Top Contributors [![SALVADORBBA](https://avatars.githubusercontent.com/u/4417767?v=4)](https://github.com/SALVADORBBA "SALVADORBBA (53 commits)") ### Embed Badge ![Health badge](/badges/salvadorbba-tribcalc/health.svg) ``` [![Health](https://phpackages.com/badges/salvadorbba-tribcalc/health.svg)](https://phpackages.com/packages/salvadorbba-tribcalc) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)