@treeunfe/nfe

Biblioteca NF-e 4.00 (modelo 55) para Treeunfe DFe — webservices SOAP SEFAZ.

Funcionalidades

| Operação | Método adapter | Status | |----------|----------------|--------| | Status do serviço | ConsultaStatusServico() | Implementado | | Autorização | Autorizacao(nfe) | Implementado | | Consulta protocolo | ConsultaProtocolo(chNFe) | Implementado | | Consulta cadastro | ConsultaCadastro(data) | Implementado | | Consulta GTIN | ConsultaGTIN(data) | Implementado | | Distribuição DFe | DistribuicaoDFe* | Implementado | | Inutilização | Inutilizacao(data) | Implementado | | Cancelamento (110111) | Cancelamento(data) | Implementado | | Carta de correção (110110) | CartaDeCorrecao(data) | Implementado | | EPEC (110140) | EventoPrevioDeEmissaoEmContingencia(data) | Implementado | | Eventos manifestação | CienciaDaOperacao, ConfirmacaoDaOperacao, etc. | Implementado | | DANFE PDF | GerarDanfe(props) | Implementado | | DACCe PDF | GerarDacce(props) | Implementado | | DANFE etiqueta (NT 2020.004) | GerarDanfeEtiqueta(props) | Implementado |

Início rápido

O adapter recebe a configuração diretamente no construtor — não é necessário TreeunfeDFeService nem LoadEnvironment().

import { NFe } from '@treeunfe/nfe';
import path from 'path';

const client = new NFe({
  ambiente: 2, // 1 = Produção | 2 = Homologação
  versaoDF: '4.00',
  UF: 'PR',
  pathCertificado: path.resolve('certificado.pfx'),
  senhaCertificado: 'sua_senha',
  useForSchemaValidation: 'validateSchemaJsBased',
  connection: { timeout: 30_000 },
  log: { exibirLogNoConsole: true, armazenarLogs: true, pathLogs: 'tmp/Logs/NFe' },
});

const status = await client.ConsultaStatusServico();
const autorizado = await client.Autorizacao(layoutNFe);
await client.GerarDanfe({
  data: { NFe: layoutNFe, protNFe },
  outputPath: 'tmp/DANFe/minha-nfe.pdf',
});

Documentação de referência

XSDs em runtime: packages/shared/resources/schemas/nfe/

Consulte portais oficiais SEFAZ para MOC NF-e, Anexo II (DANFE) e Notas Técnicas.

Exemplo / testes

pnpm test:nfe                              # script interativo na raiz
NFE_EMITIR=1 pnpm test:nfe                 # autorização
NFE_CCE=1 pnpm test:nfe                    # CC-e
NFE_CANCEL=1 pnpm test:nfe                 # cancelamento
NFE_DIST=1 pnpm test:nfe                   # distribuição ultNSU

Fixtures: examples/NFe/

Notas

• Autorização usa NFeAutorizacao4 (lote síncrono ou assíncrono conforme UF)
• Eventos usam RecepcaoEvento4 (XML sem compactação)
• DANFE: a chave é extraída de infNFe.Id — não passe chave separadamente