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

• Nota Técnica 2026.002 v1.11 - Publicada em 01/10/2026
• Nota Técnica 2026.010 v1.00 - Publicada em 01/10/2026
• Nota Técnica 2023.002 v1.02 - Publicada em 27/10/2026
• Nota Técnica 2026.008 v1.01 - Publicada em 30/10/2026
• Nota Técnica 2026.007 v1.11 - Publicada em 30/10/2026
• Nota Técnica 2026.006 v1.01 - Publicada em 30/10/2026
• Nota Técnica 2026.005 v1.00 - Publicada em 30/10/2026
• Nota Técnica 2025.002 v1.53 - Publicada em 30/10/2026
• Schema XSD PL_010g (26/10/2026)

Estados atendidos

NFe (modelo 55) TODOS

NFCe (modelo 65) Todos

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, PSR-2 e PSR-4. 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 para acompanhar o desenvolvimento e participar das discussões e tirar dúvidas!

Install

Este pacote está listado no Packgist foi desenvolvido para uso do Composer, 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

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

Para outras ações necessárias ao SPED, podem ser usados (opcionalmente) outros pacotes, como:

• sped-da Geração dos documentos impressos (DANFE, DACTE, etc.)
• sped-mail Envio de email com as notas e outros documentos fiscais
• sped-ibpt Consulta dos impostos aproximados na venda a consumidor
• sped-gnre Geração do GNRE
• posprint Impressão de documentos em impressoras térmicas POS

Como eu faço uso desta biblioteca no meu projeto?

Primeiro, esta biblioteca 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 biblioteca você precisará trabalhar com NAMESPACES pois trabalhamos 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();

Acknowledgments

• A todos os colegas que colaboram de alguma forma com o desenvolvimento contínuo desta biblioteca.

Documentation

O processo de documentação ainda está no inicio, mas já existem alguns documentos úteis.

Documentação

Para tirar suas duvidas não inicie uma ISSUE, mas se inscreva no grupo do google NFePHP.

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 e o Código de Conduta para maiores detalhes.

Etapas para contribuir com Código

1. Faça um fork do projeto em sua conta no GitHub
2. Baixe a biblioteca na sua maquina de desenvolvimento a partir do seu próprio fork
3. Execute o composer install na raiz do projeto (prefira usar o PHP 8.2 ou 8.3)
4. Crie uma relação com o projeto original usando o git, com isso criará um bloco denominado "upstream" com uma cópia do projeto original

git remote add upstream [email protected]:nfephp-org/sped-nfe.git

1. Antes de começar a codar sobre sua cópia sempre sincronize o projeto com o repositório principal

git fetch upstream
git merge upstream/master
git push

1. Agora pode codar sobre sua cópia da biblioteca
2. Ao terminar, sempre teste suas alterações para garantir o funcionamento, para isso recomendo criar uma pasta denominada "local" na raiz, e esta pasta não será enviada ao repositório, então poderá ter dados sensíveis.
3. Sempre, antes de fazer envio ao seu repositório execute os comandos abaixo, a partir de raiz do projeto na sua maquina:

composer phpcbf
composer phpcs
composer stan
composer test

1. Se nenhum erro for indicado pos esses testes, pode enviar ao seu repositório, lá serão executados os comandos do GitHub Actions
2. Se passar nos testes, pode fazer um pull request para o projeto original.
3. Se o PR for aceito, não esqueça de repetir os comandos do passo 5.

Change log

Acompanhe o CHANGELOG para maiores informações sobre as alterações recentes.

Testing

Todos os testes são desenvolvidos para operar com o PHPUNIT

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

Roberto L. Machado (owner and developer)

License

Este pacote está diponibilizado sob LGPLv3 ou MIT License (MIT). Leia Arquivo de Licença para maiores informações.