-
Notifications
You must be signed in to change notification settings - Fork 537
Home
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.
- 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)
NOTA: Estas NT afetam principalmente o uso do TXT para conversão em XML, mesmo que os campos ainda não sejam exigidos.
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!
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"
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:
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();
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 [email protected]
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.
<span data-target="animated-image.imageContainer">
<img data-target="animated-image.replacedImage" alt="Doar com Paypal" class="AnimatedImagePlayer-animatedImage" src="https://camo.githubusercontent.com/8f55a46c20795d9ef6b57bc69da9c89646335da4b71a49c7f7c5e058ad84e736/68747470733a2f2f7777772e70617970616c6f626a656374732e636f6d2f70745f42522f42522f692f62746e2f62746e5f646f6e61746543435f4c472e676966" style="display: block; opacity: 1;">
</span></a>
</span></animated-image>
<span data-target="animated-image.imageContainer">
<img data-target="animated-image.replacedImage" alt="Doar PagSeguro" class="AnimatedImagePlayer-animatedImage" src="https://camo.githubusercontent.com/136dae6602e4db75908f7de8895c4bd9cbfd4c42afe0cc125031458d9193ecc1/68747470733a2f2f7374632e70616773656775726f2e756f6c2e636f6d2e62722f7075626c69632f696d672f626f746f65732f646f61636f65732f3132307835332d646f61722e676966" style="display: block; opacity: 1;">
</span></a>
</span></animated-image>
- A todos os colegas que colaboram de alguma forma com o desenvolvimento contínuo desta API.
| A JetBrains pelo fornecimento de uma licença do PHPStorm um dos melhores IDE para desenvolvimento em PHP. |
|---|
O processo de documentação ainda está no inicio, mas já existem alguns documentos úteis.
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.
Acompanhe o CHANGELOG para maiores informações sobre as alterações recentes.
Todos os testes são desenvolvidos para operar com o PHPUNIT
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.
Roberto L. Machado (owner and developer)
Este pacote está diponibilizado sob LGPLv3 ou MIT License (MIT). Leia Arquivo de Licença para maiores informações.
SPED-NFEBiblioteca 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
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)
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!!
Utilize o chat do Gitter para iniciar discussões específicas sobre o desenvolvimento deste pacote.
PHP Supported Version Actions Chat
Latest Stable Version Latest Version on Packagist License Total Downloads
Issues Forks Stars 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](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?
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
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 [email protected]
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 Doar PagSeguro Acknowledgments
A todos os colegas que colaboram de alguma forma com o desenvolvimento contínuo desta API.
JetBrains A JetBrains pelo fornecimento de uma licença do PHPStorm um dos melhores IDE para desenvolvimento em PHP. Documentation
O processo de documentação ainda está no inicio, mas já existem alguns documentos úteis.
Documentação 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. 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.