VERIFY

Checklist de Pendências e Backlog

Swagger UI
Backlog Técnico

Relatório de Verificações e Pendências

Anotações de correções de bugs, simulação de falhas e evolução do sistema.

Prioridade

Bugs Críticos e Ajustes de Dados

⚠️ Está "subindo" as NF-es para pastas erradas (chaves iniciadas em 76... não são clientes!).

Limpeza de Payload e Estruturas

  • Remover campos residuais de $oid no nfeProc (pagamentos, nItem e outros).
  • Falta de campos no detalhamento de impostos (DET): atualmente só possui ICMS, faltou IPI, PIS e COFINS (Valor de referência registrado: R$ 7.163,65).
  • Remover campos de senhas e dados sensíveis de certificados em empresa.certificados[privateKey e certificate] em todo o código fonte.

Testes de Ciclo de Vida da NF-e

  • Verificar/Testar: Emitir NF-e, destinatário dá ciência e depois é cancelada após 2 dias para conferir se marca como cancelada (se retorna novo procNFe ou apenas o evento de cancelamento).
  • Verificar/Testar: Emitir NF-e e cancelar (verificar se já vem com cSitNFe=3 - cancelada).
  • Carta de correção: vincular corretamente à NF-e e analisar como o evento é retornado.
Arquitetura

Demandas de APP-API e APP-WEB

🖥️ APP-WEB (Angular)

  • Verificar TokenRefresh: analisar comportamento por sessão, reinicialização do Angular ou criação de múltiplos tokens.
  • Implementar Impressão de PDF.
  • Exportação de arquivos em PDF e XML.
  • Verificar Situação da NF-e (conferir se retorna eventos e dados completos).

⚙️ APP-API & Logstash

  • Logs e simulação de falhas (Banco de dados, falhas em consultas DistDFe controlando sequência NSU, uploads inválidos).
  • Registrar logs de "Consultas" e/ou "Atividades" (sucesso ou falha).
  • Tratar paginação e repetição quando cStat == 138 (consultar iterativamente, ex: cliente Lajotek com mais de 50 notas em 90 dias).
  • Simular indisponibilidade e erros 500 nos WebServices da Receita Federal.
  • Consultar e atualizar situação da NF-e, além de abranger CTe, MDFe, NFCe e CFe-SAT.
  • Gerenciar rotinas de limpeza JWT (`onExpired` e `isRevoked` em `_helpers/jwt.js`).
Evolução

Vinculações, Automações e Projetos Futuros

Eventos e DistDFe

Ao adicionar uma NF-e ou DistDFe, buscar eventos existentes e atualizar a nota (incluir RES_EVENTOS e vincular com outros documentos como CTe e MDFe). Nota: Concorrência pesada descartada por ser custosa para múltiplos usuários. Tratar lotes na manifestação em caso de duplicidade e consultas ao Portal NFe.

Melhorias Próximas

  • Avisos automáticos em caso de cancelamento.
  • Filtro restrito apenas às empresas autorizadas para o usuário.
  • Deploy automatizado AWS - Laptop.

Roadmap Futuro

  • Consultas NFS-e e integrações (Bling, Mercado Livre, etc.).
  • Suporte a Certificado A3, SPED e TAX.
  • Cadastro de emitentes (logomarca, contatos) e compartilhamento de documentos.
  • Baixar documentos do destinatário via Certificado A1/A3 (inspiração em ferramentas como Arquivei).
Inspiração / Benchmark

Atualizações Recentes do Mercado (Ex: Meu Danfe)

No Site: Conversão ampliada para NFC-e, MDF-e, CT-e OS, BP-e, NFS-e e eventos de correção/cancelamento. Múltiplos formatos de DANFE (Completo, Simplificado, Etiqueta Térmica, Varejo).

Na Área do Cliente: Menu de layout de PDF customizável (papel, margens, fontes). Download em lote (.zip) de PDF, XML ou relatório CSV com filtros por empresa e certificado A1.

Na API: Novos endpoints para download de DANFE em múltiplos formatos e listagem de chaves com filtro por CNPJ para espelhamento sistêmico.