sqginfo/sped-nfe

API para geração e comunicação da NFe e NFCe com as SEFAZ autorizadoras.

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., _(*1)

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., _(*2)

[][link-gitter] ![Coverage Status][ico-scrutinizer] , _(*3)

![License][ico-license] ![Total Downloads][ico-downloads], _(*4)

![Issues][ico-issues] ![Stars][ico-stars], _(*5)

Estados atendidos

NFe (modelo 55) TODOS

NFCe (modelo 65) Todos, menos SC

• SC ainda não participa (previsão de uso em 2020, com Gadget Fiscal tipo SAT@ECF de SP).

NFe com eCPF (emissor pessoa física)

Os estados de CE, PR e SP NÃO ACEITAM EMISSÃO com eCPF, _(*6)

AM e GO não foi possivel verificar por problemas na comunicação, _(*7)

Todos os demais estados (aparentemente) já aceitam emissão por eCPF, _(*8)

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., _(*9)

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!, _(*10)

Install

Este pacote está listado no Packgist foi desenvolvido para uso do Composer, portanto não será explicitada nenhuma alternativa de instalação., _(*11)

E deve ser instalado com:, _(*12)

composer require nfephp-org/sped-nfe

Ou ainda alterando o composer.json do seu aplicativo inserindo:, _(*13)

"require": {
    "nfephp-org/sped-nfe" : "^5.0"
}

Para utilizar o pacote em desenvolvimento (branch master) deve ser instalado com:, _(*14)

composer require nfephp-org/sped-nfe:dev-master

Ou ainda alterando o composer.json do seu aplicativo inserindo:, _(*15)

"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"., _(*16)

"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., _(*17)

• 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:, _(*18)

• 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:, _(*19)

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., _(*20)

Agora que você sabe que NAMESPACES é requerido, o uso correto para o exemplo acima seria:, _(*21)

// 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, _(*22)

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., _(*23)

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., _(*24)

, _(*25)

, _(*26)

Acknowledgments

• A todos os colegas que colaboram de alguma forma com o desenvolvimento continuo desta API.

	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., _(*27)

Documentação, _(*28)

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., _(*29)

Change log

Acompanhe o CHANGELOG para maiores informações sobre as alterações recentes., _(*30)

Testing

Todos os testes são desenvolvidos para operar com o PHPUNIT, _(*31)

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., _(*32)

Credits

Roberto L. Machado (owner and developer), _(*33)

License

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