node-sped-nfe/README.md

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 legi

# 📦 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)

![npm](https://img.shields.io/npm/dw/node-sped-nfe)

</div>


## 📦 Instalação
<div align="center">
<a href="https://www.npmjs.com/package/node-sped-nfe">
  NPM: <strong>node-sped-nfe</strong>
</a>
</div>

```bash
npm install node-sped-nfe
```

---


## ✨ 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)            |

---


## 📌 Informações
Toda a documentação completa com guias, exemplos, status SEFAZ e muito mais está disponível aqui:
<div align="center">
<a href="https://github.com/kalmonv/node-sped-nfe/tree/main/docs">
  🧾 <strong>Documentação oficial no GitHub</strong>
</a>
</div>

## ✅ Funcionalidades Implementadas
| Funcionalidade                         | Status |
|-----------------------------------------|--------|
| Emissão de NF-e modelo 55               | ✅     |
| Emissão de NFC-e modelo 65              | ✅     |
| Consulta Status do Serviço SEFAZ       | ✅     |
| Consulta Situação de NF-e/NFC-e         | ✅     |
| Consulta NF-e/NFC-e emitidas contra (DistNFe)  | ✅     |
| Download NF-e/NFC-e emitidas contra (DistNFe)  | ✅     |
| Cancelamento de NFe/NFCe emitida (110111) | ✅ |
| Carta correção de NFe/NFCe emitida (110110) | ✅ |
| Manifestação de Destinatário - Ciência da Operação (210210) | ✅ |
| Manifestação de Destinatário - Confirmação da Operação (210200) | ✅ |
| Manifestação de Destinatário - Desconhecimento da Operação (210220) | ✅ |
| Manifestação de Destinatário - Operação Não Realizada (210240) | ✅ |

## 📄 XML para DANFE (PDF)
Esta biblioteca permite a conversão de arquivos XML em documentos PDF, com suporte para execução tanto no backend quanto no frontend.
<div align="center">
<a href="https://www.npmjs.com/package/node-sped-pdf">
  🧾 <strong>node-sped-pdf</strong>
</a>
</div>