PHPackages upgestao/sped-nfe - 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. [API Development](/categories/api) 4. / 5. upgestao/sped-nfe ActiveLibrary[API Development](/categories/api) upgestao/sped-nfe ================= API para geração e comunicação da NFe e NFCe com as SEFAZ autorizadoras. - verão modificada para uso com php 7.2 v5.1.28(8mo ago)072LGPL-3.0-or-laterPHPPHP >= 7.0 Since Jul 17Pushed 3mo agoCompare [ Source](https://github.com/upgestao/sped-nfe)[ Packagist](https://packagist.org/packages/upgestao/sped-nfe)[ Docs](https://github.com/nfephp-org/sped-nfe)[ RSS](/packages/upgestao-sped-nfe/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (7)Versions (66)Used By (0) SPED-NFE ======== [](#sped-nfe) Biblioteca para geração e comunicação das NFe com as SEFAZ autorizadoras, e visa fornecer os meios para gerar, assinar e enviar os dados relativos ao projeto Sped NFe das SEFAZ. Atualizado ---------- [](#atualizado) - NT 2020.006 Intermediarios - NT 2020.007 Evento Ator Interessado na NFe - Transportador - NT 2021\_001 Evento de COMPROVANTE DE ENTREGA - NT 2021.004 v1.20 Regras de Validação e Novos Campos (válido em produção a partir de 16/05/2022) - NT 2023.001 v1.10 Criação e atualização de regras de validação para atender o regime de tributação monofásica do ICMS nas operações com combustíveis (válido a partir de 30/03/2023) - NT 2023.001 v1.20 Tributação Monofásica sobre Combustíveis (Homologação em 20/04/2023 e em produção em 01/05/2023) > **NOTA: Estas NT afetam principalmente o uso do TXT para conversão em XML, mesmo que os campos ainda não sejam exigidos.** TODO: A conversão com o PADRÃO SEBRAE ainda está incompleta!! ------------------------------------------------------------- [](#todo-a-conversão-com-o-padrão-sebrae-ainda-está-incompleta) *Utilize o chat do Gitter para iniciar discussões específicas sobre o desenvolvimento deste pacote.* [![PHP Supported Version](https://camo.githubusercontent.com/b81f3fb713c876c1c315539e9fdee10b96395a838e7e1a3acae9276659af76a3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6e66657068702d6f72672f737065642d6461)](https://camo.githubusercontent.com/b81f3fb713c876c1c315539e9fdee10b96395a838e7e1a3acae9276659af76a3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6e66657068702d6f72672f737065642d6461)[![Actions](https://github.com/nfephp-org/sped-nfe/actions/workflows/ci.yml/badge.svg)](https://github.com/nfephp-org/sped-nfe/actions/workflows/ci.yml/badge.svg)[![Chat](https://camo.githubusercontent.com/445d620f465679229fca473137bf37506a0bc714bfdc57a55948c4814980d679/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4749545445522d3425323075736572732532306f6e6c696e652d677265656e2e7376673f7374796c653d666c61742d737175617265)](https://gitter.im/nfephp-org/sped-nfe?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)[![codecov](https://camo.githubusercontent.com/bebfaa1aaee2522a6ec42547eb61df41267efce459bca746a915d10c31b2cb03/68747470733a2f2f636f6465636f762e696f2f67682f6e66657068702d6f72672f737065642d6e66652f6272616e63682f6d61737465722f67726170682f62616467652e7376673f746f6b656e3d55735a6e6a544e4b4b68)](https://codecov.io/gh/nfephp-org/sped-nfe) [![Latest Stable Version](https://camo.githubusercontent.com/9e9d3576b641b81910488b6ea9595d2f4e128a1c5f7934ee126f9a2d7bcc6756/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f737065642d6e66652f76657273696f6e)](https://packagist.org/packages/nfephp-org/sped-nfe)[![Latest Version on Packagist](https://camo.githubusercontent.com/65f8d62d2aee1aefad5363e202dc0a13d0fea7f7e99ebc983a581cd69f78c337/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e66657068702d6f72672f737065642d6e66652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-nfe)[![License](https://camo.githubusercontent.com/e0273385d246b6a90332d858facac88177613ea018b9a21e402ffad0d613f302/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f6e66657068702f6c6963656e73652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-nfe)[![Total Downloads](https://camo.githubusercontent.com/28f98b3485d41399f2ba0ae2796bb2227524001cdd1f383ddb79009ddc1c46af/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e66657068702d6f72672f737065642d6e66652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-nfe) [![Issues](https://camo.githubusercontent.com/f0cb60f3d731818d45f360745375b98c0b1bb5777eb3db91d797643360063317/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6e66657068702d6f72672f737065642d6e66652e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-nfe/issues)[![Forks](https://camo.githubusercontent.com/408efd3d0f2388831156582b3cd6c99753bd6aaa48364eb24df62d41e770c12e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6e66657068702d6f72672f737065642d6e66652e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-nfe/network)[![Stars](https://camo.githubusercontent.com/465da61151e0df2c773003e867fa7ed4c9d5ae97e2a3161255565c341427be24/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e66657068702d6f72672f737065642d6e66652e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-nfe/stargazers) Estados atendidos ----------------- [](#estados-atendidos) ### NFe (modelo 55) TODOS [](#nfe-modelo-55-todos) ### NFCe (modelo 65) Todos [](#nfce-modelo-65-todos) ### NFe com eCPF (emissor pessoa física) [](#nfe-com-ecpf-emissor-pessoa-física) > Os estados de **CE**, **PR** e **SP** **NÃO ACEITAM EMISSÃO com eCPF** > AM e GO não foi possivel verificar por problemas na comunicação > Todos os demais estados (aparentemente) já aceitam emissão por eCPF Este pacote é aderente com os [PSR-1](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-1-basic-coding-standard.md), [PSR-2](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md) e [PSR-4](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-4-autoloader.md). Se você observar negligências de conformidade, por favor envie um patch via pull request. Não deixe de se cadastrar no [grupo de discussão do NFePHP](http://groups.google.com/group/nfephp) para acompanhar o desenvolvimento e participar das discussões e tirar dúvidas! Install ------- [](#install) **Este pacote está listado no [Packgist](https://packagist.org/) foi desenvolvido para uso do [Composer](https://getcomposer.org/), portanto não será explicitada nenhuma alternativa de instalação.** *E deve ser instalado com:* ``` composer require nfephp-org/sped-nfe ``` Ou ainda alterando o composer.json do seu aplicativo inserindo: ``` "require": { "nfephp-org/sped-nfe" : "^5.0" } ``` *Para utilizar o pacote em desenvolvimento (branch master) deve ser instalado com:* ``` composer require nfephp-org/sped-nfe:dev-master ``` *Ou ainda alterando o composer.json do seu aplicativo inserindo:* ``` "require": { "nfephp-org/sped-nfe" : "dev-master" } ``` > NOTA: Ao utilizar este pacote na versão em desenvolvimento não se esqueça de alterar o composer.json da sua aplicação para aceitar pacotes em desenvolvimento, alterando a propriedade "minimum-stability" de "stable" para "dev". > > ``` > "minimum-stability": "dev" > ``` Requirements ------------ [](#requirements) Para que este pacote possa funcionar são necessários os seguintes requisitos do PHP e outros pacotes dos quais esse depende. - PHP 7.x (minimo PHP 7.4 veja sempre nos badges) - ext-curl - ext-dom - ext-json - ext-gd - ext-mbstring - ext-mcrypt - ext-openssl - ext-soap - ext-xml - ext-zip - [sped-common](https://github.com/nfephp-org/sped-common) > Para outras ações necessárias ao SPED, podem ser usados (opcionalmente) outros pacotes, como: > - [sped-da](https://github.com/nfephp-org/sped-da) Geração dos documentos impressos (DANFE, DACTE, etc.) > - [sped-mail](https://github.com/nfephp-org/sped-mail) Envio de email com as notas e outros documentos fiscais > - [sped-ibpt](https://github.com/nfephp-org/sped-ibpt) Consulta dos impostos aproximados na venda a consumidor > - [sped-gnre](https://github.com/nfephp-org/sped-gnre) Geração do GNRE > - [posprint](https://github.com/nfephp-org/posprint) Impressão de documentos em impressoras térmicas POS Como eu faço uso desta API no meu projeto? ------------------------------------------ [](#como-eu-faço-uso-desta-api-no-meu-projeto) Primeiro, esta API faz uso dos recursos mais atuais do PHP para classes e objetos, portanto abaixo vai um exemplo ERRADO de uso: ``` require 'sped-nfe/src/Make.php'; $nfe = new Make(); ``` Portanto, você deve primeiro entender que para usar esta API você precisará trabalhar com NAMESPACES pois esta API trabalha com NAMESPACES. Agora que você sabe que NAMESPACES é requerido, o uso correto para o exemplo acima seria: ``` // VENDOR_DIR = pasta vendor da sua instalação composer require VENDOR_DIR . 'autoload.php'; use NFePHP\NFe\Make; $nfe = new Make(); ``` Donations --------- [](#donations) **Estamos em busca de *doadores* e *patrocinadores* para ajudar a financiar parte do desenvolvimento deste pacote e de outros pacotes, aqueles que estiverem interessados por favor entrem em contato com o autor pelo email ** Este é um projeto totalmente *Open Source*, para usá-lo, copiá-lo ou modificá-lo você não paga absolutamente nada. Porém para continuarmos a mantê-lo de forma adequada é necessária alguma contribuição seja feita, seja auxiliando na codificação, na documentação, na realização de testes e identificação de falhas e BUGs. Mas também, caso você ache que qualquer informação obtida aqui, lhe foi útil e que isso vale algum dinheiro e está disposto a doar algo, sinta-se livre para enviar qualquer quantia, seja diretamente ao autor ou através do PayPal e do PagSeguro. [![Doar com Paypal](https://camo.githubusercontent.com/1c212254bf14c516a7571bbb8b8a1679967080453a6ba3a222491e973b6877dd/68747470733a2f2f7777772e70617970616c6f626a656374732e636f6d2f70745f42522f42522f692f62746e2f62746e5f646f6e61746543435f4c472e676966)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=linux%2erlm%40gmail%2ecom&lc=BR&item_name=NFePHP%20OpenSource%20API&item_number=nfephp¤cy_code=BRL&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest)[![Doar PagSeguro](https://camo.githubusercontent.com/789c6763eb296216070a1a12775066af41359ada763b8d99c678de486e3c504d/68747470733a2f2f7374632e70616773656775726f2e756f6c2e636f6d2e62722f7075626c69632f696d672f626f746f65732f646f61636f65732f3132307835332d646f61722e676966)](https://pag.ae/bkXPq4)Acknowledgments --------------- [](#acknowledgments) - A todos os colegas que colaboram de alguma forma com o desenvolvimento contínuo desta API. [![JetBrains](https://github.com/robmachado/sped-nfe/raw/master/docs/images/jetbrains.png)](https://www.jetbrains.com/?from=NFePHP)A JetBrains pelo fornecimento de uma licença do PHPStorm um dos melhores IDE para desenvolvimento em PHP.Documentation ------------- [](#documentation) O processo de documentação ainda está no inicio, mas já existem alguns documentos úteis. [Documentação](docs/Funcionalidades.md) Contributing ------------ [](#contributing) Para contribuir com correções de BUGS, melhoria no código, documentação, elaboração de testes ou qualquer outro auxílio técnico e de programação por favor observe o [CONTRIBUTING](CONTRIBUTING.md) e o [Código de Conduta](CONDUCT.md) para maiores detalhes. Change log ---------- [](#change-log) Acompanhe o [CHANGELOG](CHANGELOG.md) para maiores informações sobre as alterações recentes. Testing ------- [](#testing) Todos os testes são desenvolvidos para operar com o PHPUNIT 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. Credits ------- [](#credits) Roberto L. Machado (owner and developer) License ------- [](#license) Este pacote está diponibilizado sob LGPLv3 ou MIT License (MIT). Leia [Arquivo de Licença](LICENSE.md) para maiores informações. ### Health Score 46 — FairBetter than 93% of packages Maintenance77 Regular maintenance activity Popularity8 Limited adoption so far Community19 Small or concentrated contributor base Maturity72 Established project with proven stability Bus Factor1 Top contributor holds 83.8% 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 ~52 days Recently: every ~159 days Total 58 Last Release 247d ago Major Versions v4.1.x-dev → v5.0.1002020-03-12 PHP version history (3 changes)v4.1.x-devPHP ~5.5|~7.0 v5.0.100PHP >= 7.0 v5.1.0PHP >= 7.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/7e1ff2f20b008bc26f0568c613a7d7a9bfc46dfc0f576e2584534e765a8b942a?d=identicon)[upgestao](/maintainers/upgestao) --- Top Contributors [![robmachado](https://avatars.githubusercontent.com/u/1437008?v=4)](https://github.com/robmachado "robmachado (1352 commits)")[![gersonfs](https://avatars.githubusercontent.com/u/293154?v=4)](https://github.com/gersonfs "gersonfs (50 commits)")[![olavocneto](https://avatars.githubusercontent.com/u/568745?v=4)](https://github.com/olavocneto "olavocneto (40 commits)")[![eduardokum](https://avatars.githubusercontent.com/u/2566340?v=4)](https://github.com/eduardokum "eduardokum (30 commits)")[![lucianoconforto](https://avatars.githubusercontent.com/u/26275891?v=4)](https://github.com/lucianoconforto "lucianoconforto (14 commits)")[![smallsoft-gustavo](https://avatars.githubusercontent.com/u/77071812?v=4)](https://github.com/smallsoft-gustavo "smallsoft-gustavo (13 commits)")[![guimelaninho](https://avatars.githubusercontent.com/u/21234515?v=4)](https://github.com/guimelaninho "guimelaninho (13 commits)")[![lidani](https://avatars.githubusercontent.com/u/29063458?v=4)](https://github.com/lidani "lidani (10 commits)")[![NewtonMan](https://avatars.githubusercontent.com/u/4259752?v=4)](https://github.com/NewtonMan "NewtonMan (9 commits)")[![ogabrielsantos](https://avatars.githubusercontent.com/u/5789536?v=4)](https://github.com/ogabrielsantos "ogabrielsantos (7 commits)")[![thmrdev](https://avatars.githubusercontent.com/u/41805723?v=4)](https://github.com/thmrdev "thmrdev (6 commits)")[![joaoroyosilva](https://avatars.githubusercontent.com/u/6354258?v=4)](https://github.com/joaoroyosilva "joaoroyosilva (6 commits)")[![lpj145](https://avatars.githubusercontent.com/u/11980109?v=4)](https://github.com/lpj145 "lpj145 (5 commits)")[![victorvilella](https://avatars.githubusercontent.com/u/11229358?v=4)](https://github.com/victorvilella "victorvilella (5 commits)")[![abraaolevi](https://avatars.githubusercontent.com/u/502058?v=4)](https://github.com/abraaolevi "abraaolevi (4 commits)")[![dbemfica](https://avatars.githubusercontent.com/u/13237440?v=4)](https://github.com/dbemfica "dbemfica (4 commits)")[![f3lpz](https://avatars.githubusercontent.com/u/21207887?v=4)](https://github.com/f3lpz "f3lpz (4 commits)")[![guilherme-santos](https://avatars.githubusercontent.com/u/281564?v=4)](https://github.com/guilherme-santos "guilherme-santos (4 commits)")[![JotaVeUltra](https://avatars.githubusercontent.com/u/14026866?v=4)](https://github.com/JotaVeUltra "JotaVeUltra (4 commits)")[![marcuspmd](https://avatars.githubusercontent.com/u/1530934?v=4)](https://github.com/marcuspmd "marcuspmd (4 commits)") --- Tags nfenfephpspednfce ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP\_CodeSniffer Type Coverage Yes ### Embed Badge ![Health badge](/badges/upgestao-sped-nfe/health.svg) ``` [![Health](https://phpackages.com/badges/upgestao-sped-nfe/health.svg)](https://phpackages.com/packages/upgestao-sped-nfe) ``` ### 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-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)[nfephp-org/sped-efdreinf API para geração e comunicação dos eventos relativos ao projeto EFD-Reinf da Receita Federal do Brasil. 3013.0k](/packages/nfephp-org-sped-efdreinf) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)