search

lealhugui / node-dfe

Geração/integração de NF-e/NFC-e para node.js
MIT License
255 stars 98 forks source link

Sobre integração com a Sefaz #73

Open elvitin opened 8 months ago

elvitin commented 8 months ago

Minha duvida é, onde aprender todo o fluxo da nota fiscal eletrônica? o que o governo espera que um sistema envie para a Sefaz? como entender tributações/impostos, para que serve cada atributo etc, sem precisar ser um contador formado? Como entender Cancelamento, Carta de Correção e Inutilização e demais itens?

Sei que tem os documentos da Sefaz, mas parece ser tão complexo e confuso, são vários documentos com várias versões, alguns com centenas de páginas... Parece ser tão complexo para um mero mortal, que fica difícil despertar a vontade de colaborar nesse projeto open source.

O que acha de criar um Awesome Nota Fiscal Eletrônica para isso?

Obs.: Programo a um bom tempo já.

RenatoGuarilhaCMCorp commented 8 months ago

Vou colocar aqui meus 10 centavos.

Desenvolvo obrigações fiscais há muito tempo.

A gente não precisa e não quer ser contador formado para atuar nesses desenvolvimentos.

O projeto de nota fiscal eletrônica (NFe principalmente) é um dos poucos projetos Nacionais que tem uma certa unicidade de comportamento entre os diversos entes federativos (UF), que resolveram se unir para propor uma solução única.

A documentação é extensa, mas pelo menos é completa. Quem lida com notas de serviço também sabe o quanto é raro.

O fluxo de comunicação é documentado também, assim como os valores possíveis são documentados nos arquivos XSD disponibilizados para cada mensagem de envio e retorno dos diversos endpoints das SEFAZ (secretarias de fazenda dos estados).

http://www.nfe.fazenda.gov.br/portal/listaSubMenu.aspx?Id=04BIflQt1aY=

Aqui no link acima, tem bastante informação sobre. Os maiores problemas não documentados que eu achei foram relacionados a CIFRAS e protocolos dos servidores onde a aplicação roda, essas paradas de Infra que eu não domino muito, mas que influenciam como a comunicação vai acontecer entre os dois lados.

Tem alguns portais de ferramentas em outras linguagens, open source ou não, que documentam bastante coisa e já me salvaram algumas vezes:

https://flexdocs.net/guiaNFe/

https://www.projetoacbr.com.br/forum/forum/4-acbrnfe/

No mais, tenho a seguinte filosofia: fazemos o desenvolvimento das estruturas de dados e a comunicação entre a aplicação que usa a ferramenta e as SEFAZ, mas os dados são de responsabilidade do usuário, só precisamos garantir que passa nas validações de SCHEMA. O framework de DFe não deve atuar na modificação/tratamento de dados, isso é atribuição das aplicações que vão usá-lo.

Espero ter contribuído.

elvitin commented 8 months ago

Ajudou d+, muito obrigado Sim, tenho ciência de que tem tudo lá documentado, o problema que eu vejo, é ser em PDF, e sem versionamento como a gente ve nas doc online hoje em dia. E aí fica difícil linkar em trechos do código, onde está a informação. Me parece que está um pouco espalhada de mais, enfim.

Eu estava pensando em refazer a biblioteca node-mde Só que aplicando alguns princípios de design, arquitetura limpa e código limpo. Além de uma DOC decente pra quem não sabe por onde começar.

Acha uma boa? Detalhe, sem fins lucrativos.