PHPackages nfse-nacional/nfse-php - 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. nfse-nacional/nfse-php ActiveLibrary nfse-nacional/nfse-php ====================== This is my package nfse v1.18.0-beta(1mo ago)1271.2kā†“28.6%28[1 PRs](https://github.com/nfse-nacional/nfse-php/pulls)MITPHPPHP ^8.1CI passing Since Dec 31Pushed 2mo ago5 watchersCompare [ Source](https://github.com/nfse-nacional/nfse-php)[ Packagist](https://packagist.org/packages/nfse-nacional/nfse-php)[ Docs](https://github.com/nfse-nacional/nfse-php)[ RSS](/packages/nfse-nacional-nfse-php/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (28)Versions (33)Used By (0) šŸš€ NFS-e Nacional PHP SDK ======================== [](#-nfs-e-nacional-php-sdk) [![Latest Version on Packagist](https://camo.githubusercontent.com/96349b43cb0b179cc9a396f5ea2a09bff3a08a47a225fa863a56709f334c6ac4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6673652d6e6163696f6e616c2f6e6673652d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfse-nacional/nfse-php)[![Coverage](https://camo.githubusercontent.com/273d3179bb8daec3e9c5c718d3e7c60d97855b2cb4e5ca0ba18e78c2d63da922/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f6e6673652d6e6163696f6e616c2f6e6673652d7068702f6d61696e3f7374796c653d666c61742d737175617265)](https://codecov.io/gh/nfse-nacional/nfse-php)[![Total Downloads](https://camo.githubusercontent.com/fe7eadd38960a9af27ac0224211ba39c9818b0d50372cec9ea67881de25b3d4f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6673652d6e6163696f6e616c2f6e6673652d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfse-nacional/nfse-php) A maneira mais moderna e eficiente de integrar PHP com a NFS-e Nacional. šŸ“¦ InstalaĆ§Ć£o ------------ [](#-instalaĆ§Ć£o) ``` composer require nfse-nacional/nfse-php ``` šŸ› ļø Uso dos ServiƧos ------------------- [](#ļø-uso-dos-serviƧos) O pacote expƵe dois serviƧos principais atravĆ©s da `NfseContext`: **ContribuinteService** (para emissores) e **MunicipioService** (para prefeituras). ### ConfiguraĆ§Ć£o Inicial [](#configuraĆ§Ć£o-inicial) ``` use Nfse\Nfse; use Nfse\Http\NfseContext; use Nfse\Enums\TipoAmbiente; $context = new NfseContext( ambiente: TipoAmbiente::Homologacao, certificatePath: '/path/to/certificate.pfx', certificatePassword: 'password' ); $nfse = new Nfse($context); ``` ### šŸ¢ ContribuinteService [](#-contribuinteservice) Focado nas necessidades de empresas que emitem notas. ``` $service = $nfse->contribuinte(); // Principais MĆ©todos: // 1. Emitir NFS-e $nfseData = $service->emitir($dps); // Retorna NfseData // 2. Consultar NFS-e $nfseData = $service->consultar('CHAVE_ACESSO'); // 3. Baixar Documentos (Notas recebidas/emitidas) $docs = $service->baixarDfe(nsu: 100); // 4. Outros mĆ©todos Ćŗteis $service->consultarDps('ID_DPS'); $service->downloadDanfse('CHAVE_ACESSO'); // Retorna PDF binĆ”rio $service->registrarEvento('CHAVE_ACESSO', $xmlEvento); // Ex: Cancelamento $service->consultarParametrosConvenio('CODIGO_MUNICIPIO'); ``` ### šŸ›ļø MunicipioService [](#ļø-municipioservice) Focado nas necessidades de prefeituras e Ć³rgĆ£os gestores. ``` $service = $nfse->municipio(); // Principais MĆ©todos: // 1. Baixar ArrecadaĆ§Ć£o e Notas $docs = $service->baixarDfe(nsu: 100, tipoNSU: 'GERAL'); // 2. Consulta Cadastral (CNC) $dados = $service->consultarContribuinte('CPF_CNPJ'); // 3. ParĆ¢metros e ConfiguraƧƵes $params = $service->consultarParametrosConvenio('CODIGO_MUNICIPIO'); $aliquotas = $service->consultarAliquota('COD_MUN', 'COD_SERV', 'COMPETENCIA'); ``` šŸ“ Exemplo de DPS (DeclaraĆ§Ć£o de PrestaĆ§Ć£o de ServiƧo) ----------------------------------------------------- [](#-exemplo-de-dps-declaraĆ§Ć£o-de-prestaĆ§Ć£o-de-serviƧo) Abaixo, um exemplo completo de como montar o objeto DPS para emissĆ£o. ``` use Nfse\Dto\Nfse\DpsData; use Nfse\Support\IdGenerator; // Gerar ID Ćŗnico para a DPS $idDps = IdGenerator::generateDpsId('12345678000199', '3550308', '1', '1001'); $dps = new DpsData([ '@attributes' => ['versao' => '1.00'], 'infDPS' => [ '@attributes' => ['Id' => $idDps], 'tpAmb' => 2, // 1-ProduĆ§Ć£o, 2-HomologaĆ§Ć£o 'dhEmi' => date('Y-m-d\TH:i:s'), 'verAplic' => '1.0.0', 'serie' => '1', 'nDPS' => '1001', 'dCompet' => date('Y-m-d'), 'tpEmit' => 1, // 1-Prestador 'cLocEmi' => '3550308', // CĆ³digo IBGE MunicĆ­pio 'prest' => [ 'CNPJ' => '12345678000199' ], 'toma' => [ 'CPF' => '11122233344', 'xNome' => 'Cliente Exemplo' ], 'serv' => [ 'locPrest' => [ 'cLocPrestacao' => '3550308' ], 'cServ' => [ 'cTribNac' => '01.01', // CĆ³digo TributaĆ§Ć£o Nacional 'xDescServ' => 'Desenvolvimento de Software' ] ], 'valores' => [ 'vServPrest' => [ 'vReceb' => 1000.00, 'vServ' => 1000.00 ], 'trib' => [ 'tribMun' => [ 'tribISSQN' => 1, // 1-TributĆ”vel 'tpRetISSQN' => 2, // 1-Retido, 2-NĆ£o Retido 'pAliq' => 5.00 ] ] ] ] ]); // Emitir $nfse->contribuinte()->emitir($dps); ``` šŸ“š DocumentaĆ§Ć£o Completa ----------------------- [](#-documentaĆ§Ć£o-completa) Para detalhes profundos sobre cada DTO e configuraƧƵes avanƧadas, visite nossa [DocumentaĆ§Ć£o Oficial](https://nfse-php.netlify.app/). License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 48 ā€” FairBetter than 94% of packages Maintenance86 Actively maintained with recent releases Popularity38 Limited adoption so far Community22 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 93.1% 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 ~2 days Total 29 Last Release 58d ago Major Versions v0.2.0-beta ā†’ v1.0.0-beta2026-01-02 PHP version history (3 changes)v0.1.0-betaPHP ^8.4 v1.10.0-betaPHP ^8.2 v1.12.0-betaPHP ^8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/8ef934abfc0e93bb150f57a7a8826d29b04829e3e60d62358e87d42705d4be21?d=identicon)[a21ns1g4ts](/maintainers/a21ns1g4ts) --- Top Contributors [![a21ns1g4ts](https://avatars.githubusercontent.com/u/11599205?v=4)](https://github.com/a21ns1g4ts "a21ns1g4ts (122 commits)")[![AlanRezende](https://avatars.githubusercontent.com/u/7322595?v=4)](https://github.com/AlanRezende "AlanRezende (2 commits)")[![josuearaujomoreira](https://avatars.githubusercontent.com/u/66573553?v=4)](https://github.com/josuearaujomoreira "josuearaujomoreira (2 commits)")[![flavio89](https://avatars.githubusercontent.com/u/64870322?v=4)](https://github.com/flavio89 "flavio89 (1 commits)")[![Joao-Bittencourt](https://avatars.githubusercontent.com/u/24395717?v=4)](https://github.com/Joao-Bittencourt "Joao-Bittencourt (1 commits)")[![wagnercrosa](https://avatars.githubusercontent.com/u/11972961?v=4)](https://github.com/wagnercrosa "wagnercrosa (1 commits)")[![andrevabo](https://avatars.githubusercontent.com/u/1074177?v=4)](https://github.com/andrevabo "andrevabo (1 commits)")[![BrunoMichael](https://avatars.githubusercontent.com/u/23379795?v=4)](https://github.com/BrunoMichael "BrunoMichael (1 commits)") --- Tags nfsenfse-contribuintenfse-meinfse-municipionfse-nacionalnfse-padrao-nacionalnfse-sdknfse-webservicenfse-xmlnfse ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/nfse-nacional-nfse-php/health.svg) ``` [![Health](https://phpackages.com/badges/nfse-nacional-nfse-php/health.svg)](https://phpackages.com/packages/nfse-nacional-nfse-php) ``` ### Alternatives [neuron-core/neuron-ai The PHP Agentic Framework. 1.8k245.3k20](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php TencentCloudApi php sdk 3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[tecnospeedsa/plugnotas Pacote para utilizaĆ§Ć£o do Plugnotas em PHP 2226.6k](/packages/tecnospeedsa-plugnotas)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 255.2k](/packages/aedart-athenaeum) PHPackages Ā© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)