PHPackages lucas-simoes/php-nfse - 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. lucas-simoes/php-nfse ActiveLibrary lucas-simoes/php-nfse ===================== API para geração e comunicação da NFSe com as Prefeituras. Este é um fork do projeto nfephp-org/sped-nfse que foi descontinuado 0.2(5y ago)572.3k↓100%51[4 PRs](https://github.com/lucas-simoes/php-nfse/pulls)Apache-2.0PHPPHP ~5.6|~7.0CI failing Since Sep 21Pushed 2y ago13 watchersCompare [ Source](https://github.com/lucas-simoes/php-nfse)[ Packagist](https://packagist.org/packages/lucas-simoes/php-nfse)[ Docs](https://github.com/lucas-simoes/php-nfse)[ RSS](/packages/lucas-simoes-php-nfse/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)Dependencies (5)Versions (3)Used By (0) php-nfse ======== [](#php-nfse) **Framework para a integração com os sistemas de Notas Fiscais Eletrônicas de Serviços das Prefeituras Municipais** *php-nfse* é um framework para geração dos RPS e comunicação das NFSe com as Prefeituras Municipais. *Este projeto é um fork do projeto original nfephp-org/sped-nfse que foi descontinuado.* NOTA IMPORTANTE - LEIA COM MUITA ATENÇÃO ======================================== [](#nota-importante---leia-com-muita-atenção) ### As prefeituras **mudam de modelo de NFSe e alteram seu layout livremente e até a forma de acesso aos webservices**, isso é um FATO !! [](#as-prefeituras-mudam-de-modelo-de-nfse-e-alteram-seu-layout-livremente-e-até-a-forma-de-acesso-aos-webservices-isso-é-um-fato-) ### Isso torna esse pacote IMENSAMENTE COMPLEXO, se comparado a outros similares. [](#isso-torna-esse-pacote-imensamente-complexo-se-comparado-a-outros-similares) > ### Outro detalhe muito importante que afeta pricipalmente o SEU APLICATIVO, que fará uso desse pacote, são os procedimentos diferenciados de cada Prefeitura em relação ao padrão adotado, como: > > [](#outro-detalhe-muito-importante-que-afeta-pricipalmente-o-seu-aplicativo-que-fará-uso-desse-pacote-são-os-procedimentos-diferenciados-de-cada-prefeitura-em-relação-ao-padrão-adotado-como) - campos diferentes (tamanho e estrutura) - operações não existentes, ou com funcionamento diferente - critérios de aceitabilidade dos dados diversos do padrão - etc. > ***Pois bem, isso significa que o SEU aplicativo deverá lidar com cada uma dessas particularidades municipio por municipio, e não apenas modelo a modelo.*** Não existe nenhum padrão nacional na definição dos WebServices, e os municipios podem alterar o layout do XML ou o provedor sem qualquer critério e isto pode causar sérios problemas de acesso e validação, pois podemos não ter condições de adequação desse framework, seja devido a alterações técnicas, seja pela imposição de prazos. Os usuários desse framework devem avaliar quais os riscos e quais são as responsabilidades que está assumindo ao oferecer o produto ao usuário final, que pode **PARAR DE FUNCIONAR A QUALQUER MOMENTO**, pois como dito anteriormente: **"NÃO TEMOS COMO GARANTIR O FUNCIONAMENTO CASO ACONTEÇA ALGUMA ALTERAÇÃO NO LEIAUTE DO XML OU NO WEBSERVICE DE RECEPÇÃO DO RPS", evidentemente faremos o possível para adequar, mas não temos como garantir que teremos sucesso no caso da NFSe** RECOMENDAÇÃO ------------ [](#recomendação) Apenas use esse framework se tiver conhecimentos suficientes para corrigir as falhas encontradas, caso contrario DESISTA e não INSISTA NISSO, pois provavelmente NÂO HAVERÁ NENHUM TIPO DE SUPORTE, gratuito ou mesmo PAGO. ***Você assume a responsabilidade por sua própria conta e risco.*** DEFINIÇÃO --------- [](#definição) A Nota Fiscal de Serviços Eletrônica - NFS-e é o documento fiscal de existência apenas digital que substituirá as tradicionais notas fiscais de serviços impressas. A NFSe, implantada pelas Secretarias Municipais de Finanças, será emitida e armazenada eletronicamente em programa de computador, com o objetivo de materializar os fatos geradores do ISSQN – Imposto Sobre Serviços de Qualquer Natureza, por meio do registro eletrônico das prestações de serviços sujeitas à tributação do ISSQN. Com a Nota Fiscal Eletrônica de Serviços você terá os seguintes benefícios: - Redução de custos - Redução de burocracia - Incentivo ao relacionamento entre tomador e prestador - Maior gerenciamento de notas emitidas e recebidas - Economia de tempo e segurança com documentos de arrecadação A emissão de NFSe depende de prévio cadastramento do emissor e da disponibilidade de certificado digital do tipo A1 (PKCS#12), emitido por certificadora no Brasil pertencente ao ICP-Brasil. PACOTE EM DESENVOLVIMENTO, não usável ainda !! ---------------------------------------------- [](#pacote-em-desenvolvimento-não-usável-ainda-) Padrões ------- [](#padrões) Existem muitos "padrões" diferentes para a emissão de NFSe, além disso, cada prefeitura pode fazer alterações no "padrão" escolhido, por isso, cada Prefeitura autorizadora deverá ser claramente identificada para que os códigos corretos sejam utilizados nas chamadas do framework. Isso eleva muito a complexidade desta API, e consequentemente sua manutenção. - Ábaco - ABRASF - Ágili - ArrecadaNet - Assessor Público - AWATAR - **BETHA - BETA-TESTS** - BOANF - BSIT-BR - Cecam - CENTI - Comunix - CONAM - Consist - COPLAN - DB NFSE - DEISS - DigiFred - **DSFNET - ALPHA-TESTS** - Dueto - DUETO 2.0 - E-Caucaia - e-Governe ISS - E-Nota Portal Público - e-Receita - E&L - eISS - Elotech - Equiplano - ETransparencia - FacilitaISS - FGMAISS - FINTELISS - FISS-LEX - Freire - GENERATIVA - GINFES - GLC Consultoria (Sumaré e Monte Mor) - Goiânia - Governa - Governa TXT - Governo Digital - Governo Eletrônico - INFISC - INFISC – Santiago - INFISC – Sapucaia - INFISC Farroupilha - **IPM - BETA-TESTS** - ISISS - ISS Intel - ISS On-line Supernova - ISS Online AEG - ISS Simples SPCONSIG - ISS4R - ISSE - **ISSNET - BETA-TESTS** - ISSNFe On-line - ISSWEB Camaçari - ISSWEB Fiorilli - JFISS Digital - JGBAIAO - Lençóis Paulista - Lexsom - Memory - Metrópolis - NF-Eletronica - NF-em - NFPSe - NFSE-ECIDADES - NFSeNET - NFWEB - Nota Blu - **Nota Carioca (derivação ABRASF) - em desenvolvimento** - Nota Natalense - **Nota Salvador (derivação ABRASF) - em desenvolvimento** - PMJP - PortalFacil - Prescon - Primax Online - **Prodam (NF Paulistana) - BETA-TESTS** - PRODATA - **Pública - BETA-TESTS** - RLZ - SAATRI - SEMFAZ - SH3 - SIAM - SIGCORP – TXT - SIGCORP BAURU - SIGCORP Ivaipora - SIGCORP Londrina - SIGCORP Rio Grande - SIGCORP São Gonçalo - **SIGISS - BETA-TESTS** - **SimplISS - Em desenvolvimento** - SJP - SMARAPD SIL Tecnologia - SMARAPD SIL Tecnologia WS - Solução Pública - System - Tecnos - Thema - Tinus - Tinus Upload - TIPLAN - Tributos Municipais - WEBISS Municipios atendidos pelo Framework ----------------------------------- [](#municipios-atendidos-pelo-framework) ### ABRASF (BETA-TESTS) [](#abrasf-beta-tests) - Salvador (BA) ABRASF (modificado) - Rio de Janeiro (RJ) ABRASF (modificado) - São José dos Campos (SP) GINFESv3 - Limeira (SP) ETransparencia - Itabira (MG) ABRASF (modificado) - São Jose dos Pinhais (PR) ABRASF (modificado) ### BETHA (ALPHA-TESTS) [](#betha-alpha-tests) - Cruzeiro do Sul (C) - Camaçari (BA) - Quirinópolis (GO) - Maracaju (MS) - Cornélio Procópio (PR) - Fazenda Rio Grande (PR) - Ortigueira (PR) - Paranavai (PR) Integrado - São Mateus do Sul (PR) - Resende (RJ) - Rio das Flores (RJ) - Gramado (RS) - Lagoa Vermelha (RS) - Palmeira das Missões (RS) - Três Passos (RS) - Biguaçu (SC) - Canoinhas (SC) - Criciúma (SC) - Curitibanos (SC) - Imbituba (SC) - Jaraguá do Sul (SC) - Joaçaba (SC) - Lages (SC) - Navegantes (SC) - São Lourenço do Oeste (SC) - São José (SC) - Schroeder (SC) - Gavião Peixoto (SP) - Guatapará (SP) - Jambeiro (SP) - Monte Alto (SP) - Orlândia (SP) ### DSFNET (ALPHA-TESTS) [](#dsfnet-alpha-tests) - Campinas (SP) - São Luis (MA) - Belem (PA) - Campo Grande - Sorocaba (SP) - Teresina (PI) - Uberlandia (MG) ### ISSNET (BETA-TESTS) [](#issnet-beta-tests) - Alta Floresta (MT) Nota: incompleto falta URL de produção - Anapolis (GO) Nota: incompleto falta URL de produção - Andradina (SP) Nota: incompleto falta URL de produção - Aparecida de Goiania (GO) Nota: incompleto falta URL de produção - Aparecida (SP) Nota: incompleto falta URL de produção - Araguaína (TO) Nota: incompleto falta URL de produção - Bonito (MS) Nota: incompleto falta URL de produção - Cascavel (PR) Nota: incompleto falta URL de produção - Cruz Alta (RS) Nota: incompleto falta URL de produção - Cuiaba (MT) - Dourados (MT) Nota: incompleto falta URL de produção - Itapetininga (SP) Nota: incompleto falta URL de produção - Jacareí (SP) Nota: incompleto falta URL de produção - Jaguariuna (SP) Nota: incompleto falta URL de produção - Juara (MT) Nota: incompleto falta URL de produção - Lorena (SP) Nota: incompleto falta URL de produção - Mantena (MG) Nota: incompleto falta URL de produção - Mogi das Cruzes (SP) Nota: incompleto falta URL de produção - Naviraí (MS) Nota: incompleto falta URL de produção - Nobres (MT) Nota: incompleto falta URL de produção - Nova Alvorada do Sul (MS) Nota: incompleto falta URL de produção - Nova Olimpia (MT) Nota: incompleto falta URL de produção - Novo Hamburgo (RS) Nota: incompleto falta URL de produção - Praia Grande (SP) Nota: incompleto falta URL de produção - Ribeirão Preto (SP) : ABRASF (modificado) - Rio Brilhante (MS) Nota: incompleto falta URL de produção - Santa Maria (RS) Nota: incompleto falta URL de produção - São Vicente (SP) Nota: incompleto falta URL de produção - Serrana (SP) Nota: incompleto falta URL de produção - Sidrolândia (MS) Nota: incompleto falta URL de produção - Sorriso (MT) Nota: incompleto falta URL de produção - Três Corações (MG) Nota: incompleto falta URL de produção - Várzea Grande (MT) Nota: incompleto falta URL de produção ### IPM (BETA-TESTS) [](#ipm-beta-tests) - COLOMBO (PR) ### PRODAM (BETA-TESTS) [](#prodam-beta-tests) - São Paulo (SP) Nota: não tem ambiente de testes ### Publica (BETA-TESTS) [](#publica-beta-tests) - Timóteo (MG) - Caçador (SC) Integrado - Chapecó (SC) - Itajaí (SC) ### SIGISS SigCorp (BETA-TESTS) [](#sigiss-sigcorp-beta-tests) - Londrina (PR) SIGISS SigCorp v1.03 - Governador Valadares (MG) Sigicorp ### Simpliss Em desenvolvimento [](#simpliss-em-desenvolvimento) - São Joao da Boa Vista (SP) Install ------- [](#install) Via Composer *Biblioteca em desenvolvimento* ``` $ composer require lucas-simoes/php-nfse:dev-master ``` Security -------- [](#security) Caso você encontre algum problema relativo a segurança, por favor envie um email diretamente aos mantenedores do pacote ao invés de abrir um ISSUE. ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity34 Limited adoption so far Community22 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 50% 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 ~60 days Total 2 Last Release 1995d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/49e455a8f8cc2e5318d88366b01f3ed23183f15d87086f857435a7c73d939147?d=identicon)[lucas-simoes](/maintainers/lucas-simoes) --- Top Contributors [![tiagofranco86](https://avatars.githubusercontent.com/u/31907788?v=4)](https://github.com/tiagofranco86 "tiagofranco86 (8 commits)")[![lucas-simoes](https://avatars.githubusercontent.com/u/54647352?v=4)](https://github.com/lucas-simoes "lucas-simoes (4 commits)")[![thalitasmaia](https://avatars.githubusercontent.com/u/49094844?v=4)](https://github.com/thalitasmaia "thalitasmaia (2 commits)")[![rafaels86](https://avatars.githubusercontent.com/u/5237827?v=4)](https://github.com/rafaels86 "rafaels86 (1 commits)")[![thiaged](https://avatars.githubusercontent.com/u/36929763?v=4)](https://github.com/thiaged "thiaged (1 commits)") --- Tags nfsenfephpsped ### Code Quality TestsPHPUnit Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/lucas-simoes-php-nfse/health.svg) ``` [![Health](https://phpackages.com/badges/lucas-simoes-php-nfse/health.svg)](https://phpackages.com/packages/lucas-simoes-php-nfse) ``` ### Alternatives [nfephp-org/sped-nfe API para geração e comunicação da NFe e NFCe com as SEFAZ autorizadoras. 1.4k1.4M10](/packages/nfephp-org-sped-nfe)[nfephp-org/sped-da sped-da contêm as classes para criação dos documentos auxiliares referidos no projeto Sped. 145806.7k8](/packages/nfephp-org-sped-da)[nfephp-org/sped-cte API para geração e comunicação da CTe com as SEFAZ autorizadoras. 113227.7k1](/packages/nfephp-org-sped-cte)[nfephp-org/sped-nfse-ginfes API para geração e comunicação de RPS e NFSe no padão Ginfes. 434.7k](/packages/nfephp-org-sped-nfse-ginfes)[nfephp-org/sped-mdfe API para geração e comunicação da MDFe com as SEFAZ autorizadoras. 50135.1k](/packages/nfephp-org-sped-mdfe)[nfephp-org/sped-gtin Classes for validation of GTIN codes. 17981.7k11](/packages/nfephp-org-sped-gtin) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)