NFe-API
Bliblioteca para geração, transmissão e tratamento de eventos de notas fiscais eletrônicas
Essa biblioteca permite a geração, transmissão e tratamento de eventos de notas fiscais eletrônicas do Brasil
Vantagens
- Código bem estruturado e bem reaproveitado que permite a fácil manutenção
- Estrutura de código expansível para vários modelos de notas
- Fácil configuração e usabilidade (Só precisa implementar 2 classes para integração)
- Testes e cobertura de código que garantem melhor estabilidade
- Estrutura desvinculada do XML, atualizações quase não afetam em produção
Motivo do projeto
As biliotecas de código aberto encontradas até o momento (2016) não fornecem uma estrutura sólida e de fácil utilização/manutenção, dessa forma surgiu a necessidade de criar uma bilioteca capaz de gerar notas fiscais em diversos modelos e que seja de fácil utilização
Ideia do projeto
A ideia é criar uma bilioteca em que as entidades da nota sejam implementadas em classes separadas, cada uma gerando seu próprio nó XML, no final da geração todos os nós são unificados assim gerando o XML por completo, dessa forma fica fácil a manutenção pois parte da ideia da divisão e conquista
Instalação
Você precisará do Composer para instalar essa biblioteca.
Execute o comando abaixo na pasta do seu projeto
composer require mazinsw/nfe-apiManutenção
Atualizar tabelas IBPT
# linux
./utils/update_IBPT.shREM Windows
utils\update_IBPT.batDocumentação
Acesse aqui para ver a documentação
Colaboração no projeto
Para melhoria do projeto envie suas implementações por meio de um Pull request
Solução de problemas
Caso tenha problemas ao utilizar a biblioteca, acesse o grupo no Discord: https://discord.gg/XGU2Y77
Dependências
- PHP 7.3 ou superior
- Extensão openssl para assinatura da nota
- Extensão curl para envio da nota
Limitações
- Apenas o modelo NFC-e foi implementado e testado
- Só funciona com certificado digital modelo A1
- Não suporta duas versões da NF-e ao mesmo tempo
Licença
Por favor veja o arquivo de licença para mais informações.