API para geração e comunicação das NFe com as SEFAZ autorizadoras
robmachado Merge pull request #571 from robmachado/master
[UPD] correção URI consulta NFCe PR
Latest commit 96ef525 Nov 14, 2018
Permalink
Failed to load latest commit information.
console/cacerts QR Jul 11, 2017
docs Merge pull request #563 from juizmill/doc-elem Oct 26, 2018
examples Implemetação de instruções Aug 6, 2018
schemes [UPD] Schemes com PL_009_V4 b de 02/07/18 Jul 12, 2018
src [UPD] Make:class ajuste para suportar emitente com CPF Nov 8, 2018
storage [UPD] correção URI consulta NFCe PR Nov 14, 2018
tests Merge pull request #555 from fmertins/20181002_webservices_test Oct 3, 2018
.coverall.yml [UPD] Ajustes providos por SensioLabsInsight Jan 21, 2016
.editorconfig [UPD] Transferencia de arquivos Jun 24, 2016
.gitattributes [UPD] Transferencia de arquivos Jun 24, 2016
.gitignore [UPD] fixtures Sep 6, 2018
.scrutinizer.yml [UPD] ajustes travis e scrutinizer Parser::class e Complements::class Oct 3, 2018
.sensiolabs.yml [upd] ajuste 5 Jan 22, 2016
.styleci.yml [UPD] Make Apr 8, 2018
.travis.yml [UPD] ajustes travis e scrutinizer Parser::class e Complements::class Oct 3, 2018
CHANGELOG.md Correção ortográfica arquivo CHANGELOG.md Oct 30, 2017
CONDUCT.md Correção ortográfica do arquivo CONDUCT.md Oct 30, 2017
CONTRIBUTING.md [UPD] README Apr 14, 2017
ISSUE_TEMPLATE.md correção erros de ortografia Apr 9, 2018
LICENSE.md [UPD] README Apr 14, 2017
README.md [UPD] README Oct 17, 2018
VERSION.txt [UPD] Ajustes Nov 4, 2016
bootstrap.php [upd] ajuste 4 Jan 22, 2016
composer.json [UPD] composer.json redução da versão do PHPSTAN para suportar PHP 7.0 Oct 3, 2018
phpunit.xml.dist Testes da classe Webservices e melhoria em Tools: Oct 2, 2018

README.md

SPED-NFE

Framework para geração e comunicação das NFe com as SEFAZ autorizadoras, e visa fornecer os meios para gerar, assinar e anviar os dados relativos ao projeto Sped NFe das SEFAZ.

Atende os layouts versão 3.10 e 4.0 da SEFAZ!**

NOVA Versão 4.0 do layout da SEFAZ ( NT_2016_002_v1.42 )

Ambiente SEFAZ de Homologação 4.0 (ambiente de teste das empresas): a partir de 20/11/2017;

Ambiente SEFAZ de Produção 4.0 : a partir de 04/12/17;

Desativação na SEFAZ da versão anterior 3.10: até 02/07/18.

NOVA VERSÃO 4.0 do layout para NFCe Manual técnico DANFCE

Existem alterações e padrões a serem adotados na impressão do DANFCE, deve ser revisto o sped-da

04/06/2018 - Início da homologação da versão 4.00 do XML para a NFC-e

02/07/2018 – Início da produção da versão 4.00 do XML para a NFC-e – início da concomitância com a versão 1.00 do QR Code (a versão 4.00 do XML da NFC-e aceitará as versões 1.00 e 2.00 do QR Code)

01/10/2018 – Desativação da versão 3.10 do XML para a NFC-e

01/10/2018 – Fim da concomitância com a versão 1.00 do QR Code (a versão 4.00 do XML da NFC-e aceitará somente a versão 2.00 do QR Code)

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.

Chat Build Status Coverage Status Quality Score

Latest Stable Version Latest Version on Packagist License Total Downloads

Issues Forks Stars

Estados atendidos

NFe (modelo 55) TODOS

NFCe (modelo 65) Todos, menos MG, CE e SC

  • MG inicia o projeto em 2018 (sem previsão)
  • No caso do CE ainda estamos no aguardo de mais esclarecimentos.(vai ?? não vai ??)
  • E SC não participa.

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 (recomendável PHP 7.2)
  • 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 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 linux.rlm@gmail.com

Este é um projeto totalmente OpenSource, para usá-lo, copia-lo e 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 de 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 continuo 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.