node-sped-nfe 1.0.0

package/README.md

@@ -0,0 +1,75 @@
+# 📦 Biblioteca de Emissão de NF-e (Modelos 55 e 65)
+
+Seja bem-vindo(a) à **Biblioteca de Emissão de NF-e** — sua parceira definitiva para integrar **emissão de Nota Fiscal Eletrônica modelo 55 (NF-e)** e **modelo 65 (NFC-e)** em aplicações modernas, com simplicidade, robustez e total conformidade com a legislação brasileira! 🇧🇷🚀
+
+<div align="center">
+
+📣 **Participe da comunidade!**  
+💬 Tire dúvidas, compartilhe experiências e colabore com outros desenvolvedores!
+
+👉 [Grupo de Discussão no Google Groups](https://groups.google.com/g/node-sped-nfe)
+
+</div>
+
+---
+
+## ✨ Por que usar esta biblioteca?
+
+- ✅ **Simples de integrar** — fácil de configurar e começar a emitir em minutos.
+- 🔒 **Segura por padrão** — validação de schema, assinatura digital e envio via WS.
+- ⚡ **Alta performance** — ideal para ambientes de alto volume.
+- 🧩 **Flexível** — suporte a múltiplos ambientes (homologação e produção).
+- 📚 **Documentação clara** — explicações, exemplos e dicas práticas.
+
+---
+
+## 🧾 O que são NF-e modelo 55 e 65?
+
+| Modelo | Tipo                         | Uso principal                                 |
+|--------|------------------------------|-----------------------------------------------|
+| 55     | Nota Fiscal Eletrônica       | Vendas B2B, movimentações fiscais entre CNPJs |
+| 65     | Nota Fiscal de Consumidor    | Vendas B2C em ponto de venda (PDV)            |
+
+---
+
+## 📌 Requisitos
+
+Para garantir o funcionamento correto da biblioteca, certifique-se de que os seguintes requisitos estejam atendidos:
+
+### 🔧 Ambiente
+
+- **Node.js** `v22.14.0` (versão testada e recomendada)
+- **xmllint** `2.9.3` (utilizado para validação dos XMLs gerados)
+
+### 🖥 Instalação do `xmllint`
+
+#### 🔵 Windows
+
+1. Baixe o pacote do libxml para Windows:
+   - [Download libxml2 para Windows (64bit)](http://xmlsoft.org/sources/win32/64bit/)
+
+2. Extraia o conteúdo em um diretório acessível.
+
+3. Declaração uma das opção:
+    ( ) Declaração de variavel no sistema.
+        Adicione o caminho do executável (`xmllint.exe`) à variável de ambiente `PATH` do windows.
+    ( ) Ao declarar Tools({..., xmllint: 'diretorio/bin/xmllint.exe'}, ...) no proprio codigo.
+
+#### 🐧 Linux (Debian/Ubuntu)
+
+Execute o comando abaixo para instalar via APT:
+
+```bash
+sudo apt -y install libxml2-utils
+```
+
+---
+
+## 🚀 Começando
+
+### 1. Instalação
+
+```bash
+npm install node-sped-nfe
+# ou
+yarn add node-sped-nfe

package/docs/README.md

@@ -0,0 +1,49 @@
+# 🚀 Bem-vindo à jornada de emissão de NF-e!
+
+Aqui começa sua aventura pelo mundo fiscal brasileiro!  
+Abaixo você encontrará todos os passos necessários para emitir suas Notas Fiscais Eletrônicas (NF-e) com sucesso e tranquilidade. 💡
+
+---
+
+## 📦 Requisitos
+
+Antes de começar, verifique se seu ambiente está preparado:
+
+- ✅ **Node.js** `v22.14.0` (versão testada e recomendada)
+- ✅ **xmllint / libxml**  
+  Utilizado para validação e assinatura de XML.  
+  📚 Guia de instalação e uso:  
+  👉 [Assinar XML com xmllint](https://github.com/kalmonv/node-sped-nfe/blob/main/docs/xmllint.md)
+
+---
+
+## 🧭 Passo a passo
+
+Siga os passos abaixo na ordem para garantir uma emissão completa e válida:
+
+1. 🧾 **Criação do XML da NF-e**  
+   Gere corretamente seu XML com base nas regras da SEFAZ.  
+   👉 [Documentação](https://github.com/kalmonv/node-sped-nfe/blob/main/docs/xml.md)
+
+2. ✍️ **Assinar o XML**  
+   Assine digitalmente o XML com seu certificado A1.  
+   👉 [Como assinar](https://github.com/kalmonv/node-sped-nfe/blob/main/docs/assinar_xml.md)
+
+3. 📡 **Enviar para a SEFAZ**  
+   Transmita o XML assinado para a SEFAZ e obtenha o protocolo.  
+   👉 [Envio e retorno](https://github.com/kalmonv/node-sped-nfe/blob/main/docs/sefaz.md)
+
+4. 📬 **Entendendo as respostas da SEFAZ**  
+   Interprete corretamente os códigos e status da resposta da SEFAZ.  
+   👉 [Tabela de status](https://github.com/kalmonv/node-sped-nfe/blob/main/docs/sefaz_status.md)
+
+---
+
+## ✨ Pronto para emitir?
+
+Com esses passos em mãos, você está oficialmente preparado para integrar a emissão de NF-e na sua aplicação!  
+Se algo não funcionar, revise os links, verifique as dependências e conte com a comunidade. 😉
+
+---
+
+💙 Feito com dedicação para desenvolvedores que enfrentam a selva do SPED todos os dias.