Carga NFe

Objetivo principal

Agente Node.js instalado nas máquinas do cliente que faz a ponte entre o ERP Integral (PDV/fiscal local) e os tramitadores fiscais da Avanço (TNFE/NovoTNFE e Novo Avanço). Monitora diretórios locais em busca de arquivos posicionais gerados pelo ERP (NF-e, cancelamento, inutilização, cupons, etc.), envia esse conteúdo para a API do tramitador configurado e, no sentido inverso, baixa XML/DANFE, NF-e destinadas, inutilizações e configurações de promoção, gravando-os de volta para o ERP consumir.

Principais tecnologias

Node.js (7/8/11 conforme etapa) / chokidar / superagent / async / cron / dblite (SQLite) / winston / forever-monitor / Java (jar para NF-e offline e DANFE) / NSSM (serviço Windows)

Principais funcionalidades

• Envio de NF-e: monitora arquivos .nfe, monta o JSON da nota e envia ao tramitador ativo, disparando download de DANFE/XML de retorno
• Cancelamento de NF-e: monitora arquivos .pcn e envia o pedido de cancelamento, gravando o retorno em .rcn
• Inutilização de numeração: monitora arquivos .pin e consulta periodicamente inutilizações homologadas
• Conciliação de chaves: monitora arquivos .con e envia consultas de conciliação ao tramitador
• Consulta de cupom fiscal: monitora arquivos .cac e envia consultas de arquivo de cupom, gravando retorno em .rca
• Manifestação do destinatário: monitora arquivos .mnf e envia manifestações de NF-e via carga
• EFD-Reinf: monitora arquivos .reinf, envia eventos ao tramitador e consulta periodicamente o processamento
• NF-e destinadas: consulta periodicamente NF-e recebidas de terceiros e grava os XML localmente
• Processamento de cupons fiscais: mantém banco SQLite local, valida cupons e envia ao Novo Avanço, com suporte a reprocessamento
• Promoções Scanntech: consulta configuração e promoções vigentes por loja e grava arquivos posicionais para o PDV/ECF

Principais integrações

• TNFE / NovoTNFE: API REST do tramitador legado, autenticada por apikey/token, usada para envio e consulta de NF-e, cancelamentos, inutilizações, DANFE, manifestação e Reinf
• Novo Avanço: API REST do tramitador mais novo, autenticada via Bearer token, usada para processamento de NF-e, manifestação, inutilização, Reinf, consulta de comandos pendentes e processamento de cupons
• Scanntech: configuração e promoções por loja, consumidas de forma mediada pelo backend Novo Avanço
• SEFAZ (indireto): tabelas de webservices por UF/modelo e lógica de contingência, usadas pelo módulo de emissão offline
• Atualização automática via S3: download periódico de pacotes de atualização (zip) e versão a partir de bucket na Amazon S3
• ERP Integral local: sistema de PDV/fiscal do cliente que gera os arquivos posicionais consumidos e recebe os retornos processados