A TecnoSpeed oferece dois componentes distintos para emissão de Notas Fiscais de Serviço eletrônicas (NFS-e): o Componente NFSe 2.0 (V2) e o Componente NFSe Nacional.
Embora compartilhem métodos em comum, cada um possui estrutura própria, arquivos de integração diferentes e fluxos específicos.
Por essa razão, não foi possível unificar os dois componentes em um único pacote: o Componente Nacional possui um arquivo de comunicação mais detalhado e métodos exclusivos, enquanto o V2 centraliza diversos padrões municipais.
O ponto positivo é que ambos foram projetados para simplificar a integração: bastando instanciar o componente, configurar as propriedades e utilizar os métodos necessários para emissão, consulta, impressão e cancelamento das notas.
Principais mudanças técnicas e benefícios do Componente Nacional
NFSe 2.0 (V2): utiliza o TX2 do padrão único, voltado para diversos provedores municipais.
NFSe Nacional: utiliza o TX2 do padrão nacional (DPS), com campos adicionais obrigatórios para o ambiente unificado.
Certificado digital: Nacional exige certificado válido para todos os métodos, inclusive impressão.
| Método | V2 | Nacional | Observação / Diferença essencial |
|---|---|---|---|
| AtualizarArquivos | ✅ | ✅ | Mesmo propósito: baixar templates, esquemas, scripts. Não é necessário informar cidade. |
| Enviar | ✅ | ✅ |
Nacional possui apenas SUCESSO/ERRO no fluxo de envio, pois envio síncrono. |
| Consultar / ConsultarNFSe | ✅ (Consultar) |
✅ (ConsultarNFSe) |
Nomes diferentes; V2: usado quando EMPROCESSAMENTO. Nacional: consulta direta por chave. |
| ExportarImpressaoParaPDF | ✅ | ✅ | Nacional exige certificado válido para impressão/PDF. |
| Imprimir / VisualizarImpressao | ✅ | ✅ | Semântica similar; primeiro parâmetro NFSe, segundo RPS/DPS. Requisitos de impressora no Windows. |
| EnviarManifestacao | ❌ | ✅ | Apenas no Nacional (manifestação do prestador/tomador/intermediário). |
| ConsultarEventos | ❌ | ✅ | Nacional tem consultas de eventos/DF-e específicas (manifestação, cancelamento, substituição). |
| ConsultarNotasTomadas | ✅ | ✅ | O Componente Nacional possui o método ConsultarDistribuicaoDFe. |
| EnviarEmail | ✅ | ✅ | Ambos permitem envio de PDF/XML por e‑mail. |
| Métodos extras (ListarCertificados, SaveConfig...) | ✅ | ✅ | Pequenas diferenças de nome, verificar links úteis que detalhamos todos os métodos. |
Próximos passos recomendados
-
Técnico
Agendar reunião técnica com nossa equipe, caso sinta que ainda necessita de apoio após a leitura da documentação.
-
Equipe de evolução/implantação
Levantar prestadores/clientes impactados (ex.: Porto Alegre em outubro/2025).
Mapear comunicados recebidos de prefeituras (clientes e contadores devem colaborar).
-
ERP / Integração
-
Adequar o sistema para distinguir:
Clientes no ambiente nacional (Componente Nacional).
Clientes ainda no padrão local (Componente V2).
-
-
Estratégia de adaptação
Entendemos que, implementar todas as rotas, e fazer todo processo de uma só vez será um pouco complexo, por isso, definimos alguns pequenos passos para facilitar esse processo de adaptação.
Métodos mínimos para emissão nacional: envio, consulta, cancelamento e download de NFSe.
FAQ rápido
P: Posso usar o mesmo TX2 do V2 para o Nacional?
R: Não, o TX2 nacional (DPS) tem campos adicionais. Você precisa adaptar/gerar um TX2 específico para o Nacional.
P: Haverá algum custo extra na adesão do Componente Nacional?
R: Não, para clientes que já utilizam a V2, não haverá quaisquer custos extras para utilização do Componente Nacional.
P: Posso usar o Componente V2 e o Componente Nacional no mesmo ambiente?
R: Sim. Os dois componentes podem ser utilizados em um mesmo ambiente normalmente, sem haver qualquer tipo de conflito.
P: Não está aparecendo o Componente Nacional para efetuar download na minha central do cliente, o que fazer?
R: Neste caso, deve ser solicitado junto a consultoria chat, através do nosso chat ou e-mail, a liberação do Componente Nacional na central do cliente.
Em caso de dúvidas
Nossa equipe Comercial está disponível para apoiar no processo de adesão.
A Consultoria Técnica pode auxiliar em dúvidas sobre integração, migração e configuração.
Links úteis:
Guia Geral do Componente Nacional.
Arquivo de integração TX2 NFSe (Padrão Nacional)
Entendendo o fluxo ideal de emissão do componente NFSe Nacional
Exemplo de uso - Demos - Componente NFSe Nacional
Propriedades do componente NFSe Nacional
Lista de Métodos - Componente NFS-e Nacional
📖 Para mais informações, acesse a nossa FAQ da Reforma Tributária, com seção exclusiva sobre a NFSe Nacional.
Comentários
0 comentário
Por favor, entre para comentar.